Codex 宠物 MichengAI/dsh-codex-pet

DSH Codex Pet

让宠物陪你处理 DeepSeek Harness 任务

English · 更新日志 · Apache-2.0

DSH Codex Pet 是社区维护的 DeepSeek Harness（DSH）宠物插件，并非 OpenAI 或 DeepSeek AI 官方产品。1.0.1 起支持 DSH 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3。更早的宿主和 0.2.1 的 alpha 会被版本门拒绝，插件不会运行；本机宠物配置和自定义宠物不会因此删除。

功能概览

让宠物陪你处理 DSH 任务，随时查看会话进展和待处理请求。你可以选择内置宠物，也可以通过 Skill 创建自己的伙伴。

- 9 只内置宠物：在宠物设置中选择伙伴、调整大小，资源随插件本地打包。
- 页内陪伴：在 DSH 网页中陪伴工作；桌面浮窗需要使用支持宠物功能的桌面端。
- 多会话动态：查看运行中、完成、错误和待处理请求；没有通知时只显示宠物。
- 就近处理任务：从通知打开对应会话、停止当前轮次，或处理支持的审批、问题和计划请求。
- 按需安静：关闭单条提醒不会停止任务；通过菜单或设置收起、恢复宠物。
- 创建自己的伙伴：在设置中描述宠物，通过随包 hatch-pet Skill 发起独立 DSH 创建任务。
- 轻量互动：拖动移动、双击跳跃、右键打开宠物菜单。

界面预览

多会话提醒

宠物旁集中展示运行中的任务，可分别打开会话、停止当前轮次或关闭提醒。

宠物设置

选择 9 只内置宠物、打开自定义宠物目录，并调整宠物大小。

宠物库与外观设置

会话内陪伴

在 DSH 中继续工作，宠物和任务通知显示在页面角落。

DSH 会话中的宠物与任务通知

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

| 插件 | 你可以用它做什么 |
| Codex UI | 整理项目与会话、搜索任务、跳转对话轮次 |
| Agency Agents | 按任务选择并召唤专业角色 |
| Skills Manager | 统一查找、启停、创建和导入本机技能 |
| Archive Manager | 搜索、恢复或清理已归档会话 |
| IM Connect | 从消息平台下任务、收回复 |
| Automation | 按计划执行任务，查看每次运行的结果 |
| BTW | 在当前上下文中临时旁问，不打断主任务 |
| Simplify | 用 /simplify 整理 Git 改动范围内的代码 |
| PUA | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
| Code Review | 用 /review 发起独立 Agent 代码审查，在当前会话接收报告 |
| Codex Pet | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |

安装

支持的 DeepSeek Harness 版本：0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3。0.2.0 之前的宿主（包括此前支持的 0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-rc.1、0.1.7-rc.2）以及 0.2.1-alpha.1 至 0.2.1-alpha.5 会被版本门拒绝，插件不会运行。仍在使用这些宿主时，请安装 @michengai/dsh-codex-pet@0.1.19，不要装 @latest。版本门只拒绝加载，不删除 DSH_HOME/codex-pet 里的宠物选择、位置和自定义宠物。需要可用的 dsh 命令。以下示例使用 web profile，请按实际环境替换。

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts

安装后重启 DSH，再打开 设置 → 宠物。

使用

打开 设置 → 宠物，也可从宠物右键菜单打开设置。

| 目标 | 操作 |
| 选择伙伴 | 在设置中选择宠物并调整大小。 |
| 移动与互动 | 拖动宠物移动，双击跳跃。 |
| 查看任务动态 | 阅读通知气泡；多个任务需要关注时展开列表。 |
| 继续会话 | 点击通知或回复按钮，打开对应的 DSH 任务。 |
| 处理请求 | 展开请求详情，处理支持的审批、问题或计划。 |
| 停止任务轮次 | 点击对应运行中通知的停止按钮。 |
| 关闭提醒 | 点击通知关闭按钮，任务仍继续运行。 |
| 收起或恢复宠物 | 使用右键菜单或宠物设置。 |

宠物承担通知和待处理操作。新建会话、输入后续消息仍在 DSH 主界面完成。

创建自定义宠物

1. 打开宠物设置，点击 + 图标，描述想要的伙伴。
2. 点击 在 DSH 中创建，插件会打开独立任务并发送随包 Skill 指令。
3. 在该任务中查看进展，创建使用 DSH 当前配置的模型和图像工具。
4. 宠物文件生成并保存后，刷新宠物库并选择新伙伴。

创建宠物需要先在 DSH 中配置图像生成工具。

更新与卸载

在 设置 → 宠物 → 检查更新 中更新。若当前环境不支持在线安装，可复制界面提供的更新命令。等待正在运行的任务结束后操作，完成后按提示重启 DSH。

卸载命令：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh plugin --profile web remove @michengai/dsh-codex-pet

自定义宠物默认保存在用户目录的 .dsh/codex-pet/pets 下，可从宠物设置打开。设置了 DSH_HOME 时使用该目录下的 codex-pet/pets。卸载插件会保留这些文件与配置。

参与开发

本地开发、测试与发布流程见 开发与验证指南。GitHub 与 npm 都包含可直接运行的 lib；修改源码后，提交前运行 npm run build。

许可证

原创插件代码采用 Apache License 2.0。随包宠物图集来源于 OpenAI Codex，不属于本项目授予的 Apache-2.0 许可范围，详见 NOTICE。