本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add --allow-build=@linxin666/dsh-particle-theme github:ningbainb/deepseek-harness-desktop#path:packages/dsh-particle-theme

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
• 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
• 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
• Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
• 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会替换我正在用的 DSH 皮肤吗？

不会。它只挂载一张独立的全屏画布在界面下方运行，不替换或修改你已经选用的皮肤。

启用后会拖慢性能吗？

插件有自适应帧耗时降级逻辑，连续慢帧会逐步降低粒子数量，连续快帧再恢复；画布硬件像素比上限 1.5，页面隐藏时暂停渲染。

在输入框或弹窗里会干扰内容吗？

不会。画布始终 pointer-events: none，输入框获得焦点、对话框打开时，控制器会自动切换到更安静的页面档位以保证文字对比度。

系统偏好「减少动态效果」会怎样？

检测到 prefers-reduced-motion: reduce 后，控制器进入 reduced 档位，动画基本静止，只显示稀疏静态画面。

设置项能改什么？

在「设置 > 插件配置 > 鲸鱼粒子主题」里可调整：是否启用、场景（目前只接受内置 whale）、粒子密度、透明度、运动速度。

怎么卸载？

用 dsh plugin --profile web remove 卸载本包，并按官方 profile 机制移除 bundle 依赖即可，不需要手动清理本地数据，因为本插件不写本地存储。

模型延迟、Token 消耗会增加吗？

不会。本插件仅在浏览器端渲染粒子，不增加系统提示词、不调用网络、不接入模型流程。

想要别的粒子场景怎么办？

客户端导出 ParticleThemeRegistry 与 ParticleThemeDefinition，新场景只需注册唯一 ID 并返回 update/dispose 实现，控制器会自动接管生命周期；设置 schema 的 theme 字段需要由新场景包扩展。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.7（peer/devDependencies 中 SDK 包版本要求）
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则