@michengai/dsh-codex-pet

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

<p align="center">

<img src="assets/branding/dsh-codex-pet-banner.png" alt="DSH Codex Pet" width="100%">

</p>

<div align="center">

DSH Codex Pet

让宠物陪你处理 DeepSeek Harness 任务

[English](README.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)






</div>

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.5、0.2.2-rc.1。更早的宿主和 0.2.1 的 alpha 会被版本门拒绝，插件不会运行；本机宠物配置和自定义宠物不会因此删除。

功能概览

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

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

界面预览

多会话提醒

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

<p align="center">

<img src="assets/screenshots/pet-notifications.png" alt="宠物与两条运行中的任务通知" width="403">

</p>

宠物设置

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

会话内陪伴

在 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.5、0.2.2-rc.1。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](LICENSE)。随包宠物图集来源于 OpenAI Codex，不属于本项目授予的 Apache-2.0 许可范围，详见 [NOTICE](NOTICE)。