前言¶

DSH 的插件机制允许在 harness 中挂接辅助行为。dsh-digipet 是一个 DSH 插件，它把真实工作回合、消息、工具调用和报错转化为宠物经验，并按系谱分支进化。它的边界明确：不注册工具、不写会话事件，零 token 且模型不可见。下面介绍它的用途、安装、命令和限制。

这是什么¶

swaylq/dsh-digipet 是一个在 DeepSeek Harness 中孵化的“数码兽”插件。它监听事件，按规则增加 XP；宠物从数码蛋到究极体，并沿龙、贤者、圣翼、病毒等系谱分支进化。

仓库目录为 swaylq/dsh-digipet，许可证为 MIT。package.json 要求：

node >=20

核心能力¶

经验来源¶

下面四个事件是插件监听的事件点：

agent/turn-stopping
agent/inbox/claimed
tools/result
agent/error

插件按规则增加 XP。事件只表示“发生了什么类型的事”，不读取用户代码或会话内容。

进化线¶

宠物生命周期从数码蛋到究极体。进化可以沿龙、贤者、圣翼、病毒等系谱分支。触发进化仪式的命令是：

/pet evolve

模型不可见¶

插件不注册工具，不调用 agent.inject()，不写会话事件：

agent.inject()

它对每一次模型请求的贡献是零字节。

状态落盘¶

存档写入：

$DSH_HOME/digipet/state.json

写盘采用临时文件、fsync、原子 rename，并按 1.5 秒节流落盘：

fsync
rename

防刷与迁移¶

当饱食度大于 90% 时，经验收益降到 15%，作为防刷机制。支持 0.1.x 旧存档在下次启动时自动无损迁移。

信任边界¶

插件无网络访问，只读自己的存档文件，只写自己的 state.json。它不否决、不改写、不延迟真实流程。

安装与启用¶

README 给出的安装命令使用 --profile web：

dsh plugin --profile web add github:swaylq/dsh-digipet

执行后重启 dsh，然后在任意会话中执行：

/pet hatch

典型用法¶

常用命令如下：

/pet
/pet hatch
/pet evolve
/pet name <名字>
/pet dex
/pet story
/pet about

• /pet：查看立绘、XP、饱食度、心情、四维属性和累计吞食。
• /pet hatch：孵蛋。
• /pet evolve：触发进化仪式。
• /pet name <名字>：给宠物起名。
• /pet dex：查看图鉴，未见过的形态显示为 ???。
• /pet story：查看一生的大事记。
• /pet about：查看机制说明与信任立场。

适用场景与注意¶

适合在 DSH 会话中使用插件辅助记录工作事件，并通过 /pet、/pet dex 等命令查看状态与图鉴的开发者。插件以当前 dsh 进程权限运行，安装前应检查源码、package.json 和 MIT 许可证，并确认 --profile web 示例是否符合目标环境。

需要注意：

• 一个 DSH home 一只宠物，同机的所有 profile、会话、子 agent 共享它。
• 多个 dsh 进程同时跑时，存档为后写者胜。
• 工具分类依赖名称正则启发，第三方工具命名奇怪时会被当成中性饲料。
• 进化门槛与食谱不可配置。
• 会话流里的折叠行会把立绘拍平成一行，需要点开卡片查看完整版。
• “数码宝贝 / Digimon”是万代南梦宫商标，本项目与其无任何关联。

结尾¶

dsh-digipet 把真实工作回合、消息、工具调用和报错变成可观察的宠物经验，同时保持零 token 和模型不可见。仓库地址：

https://github.com/swaylq/dsh-digipet