前言¶
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
