dsh-desktop-pet

English | 中文

dsh-desktop-pet 是 deepseek-harness 的一个可选桌面伴侣插件。它用一个小动画宠物作为环境状态指示器：harness 空闲时宠物放松，模型推理时"思考"，执行工具时"工作"，等待输入时"求关注"，一轮任务结束时庆祝（或皱眉）。

它不是第二个聊天界面，不是任务管理器，也不是完整的桌面应用。它是一个状态指示器。

• 插件优先：就是一个普通的 deepseek-harness 插件——没有独立启动的守护进程、浏览器或桌面应用。
• 零网络：所有资源随插件发布；无遥测、无 CDN、无远程服务。
• 零额外 LLM 成本：事件 → 状态的解析完全确定，不额外调用模型。
• 运行时发现宠物：assets/pets/ 下的宠物在启动时自动发现，添加宠物就是放进一个文件夹——无需重新构建。

---

安装

插件是一个同时包含宿主半（宠物窗口）和客户端半（设置卡片）的 Cordis 组合包。dsh plugin add 会安装它，并因清单里声明了 dsh.bundle 而自动把它加入 profile 的 bundle 列表。

从 npm 安装

dsh plugin --profile  add dsh-desktop-pet

从本地目录安装

直接从插件源码目录安装（profile 会把它作为 link: 依赖保留）：

dsh plugin --profile  add /path/to/dsh-desktop-pet

Windows 下示例：

dsh plugin --profile web add D:/deepseek-pet

也可以在插件目录内执行 dsh plugin --profile add .。

从 tarball 安装

先打包，再安装 tarball：

npm pack
dsh plugin --profile  add /path/to/dsh-desktop-pet-0.1.0.tgz

从 Git 仓库安装

dsh plugin --profile  add github:sereinmono/dsh-desktop-pet

如果仓库未提交构建产物，请配置 prepare 脚本，让 dsh plugin add 在安装时构建插件。

运行

dsh --profile 

如果你是从 harness 仓库源码运行，请在 harness 仓库目录内把上面的命令加上 pnpm 前缀——即执行 pnpm dsh plugin ... 与 pnpm dsh ...。

设置卡片需要 harness 暴露 desktop-pet 设置命名空间（通过其 WEB_SETTINGS_NAMESPACES 白名单）；宠物窗口本身不依赖该白名单。

启用 / 停用

把插件配置里的 enabled 设为 false，或从 profile 中移除该 bundle。此时插件仍会加载但不显示任何东西；完全移除它对 Harness 正常运行毫无影响。

---

添加宠物

宠物是遵循固定精灵图格式的普通文件夹。专属指南里介绍了三种常见的获取方式，每种都配有可复制的 prompt 和手动步骤：