swaylq/dsh-digipet

蛋壳裂开了 ——

    ▗▄▚▚▄▖
   ▐ ◉  ◉ ▌
    ▝▚▄▄▞▘  。o

✨ 数码蛋 进化为 比特泡 Bitpop（幼年期Ⅰ）
「一颗刚立了 flag 的比特，还不知道自己要变成什么。」

30 秒上手

dsh plugin --profile web add github:swaylq/dsh-digipet
# 重启 dsh，然后在任意会话里：
/pet hatch

然后正常干活就行。每个完成的回合 +5 XP、你每条消息 +2、每次工具调用 +3、连报错都 +4。/pet 随时看它，/pet evolve 见证进化仪式。

它会变成什么，取决于你怎么干活

生命周期完整对齐初代育成机的正统结构：数码蛋 → 幼年期Ⅰ → 幼年期Ⅱ → 成长期 → 成熟期 → 完全体 → 究极体。从成长期起，每次进化都重新读一遍「这一阶段你实际怎么干活」来选系谱：

3 个共通幼年形态 + 4 条系谱 × 4 阶段 + 3 个隐藏形态 = 22 格图鉴。系谱不锁死 —— 上一阶段是龙、这一阶段疯狂报错，它就转职病毒系谱。你的宠物最终长成什么样，就是你这段时间工作方式的镜子。

至于那三个隐藏形态，图鉴里只有一句谣传：

「谣传：吃撑的时候进化，会出事。」

初代玩家都知道这句话什么意思。有的错误能被爱救赎，有的错误会层层堆叠、越滚越高，最终成为某种祖传的存在（立绘的最后一行是 // 别动。）。

命令

从 0.1.x 升级：旧存档（海洋生物图鉴）会在下次启动时自动无损迁移 —— 阶段、经验、四维、图鉴、大事记全部保留，历史形态一并映射到新图鉴。

为什么做这个

DSH 生态已经有二十多个桌宠插件（whale-girl、各家鲸鱼、Clippy、Live2D……），它们几乎都是状态镜像：agent 在思考，宠物做思考动作；任务完成，宠物欢呼。做得最深的 whale-girl 有资历等级和称号，但形象不会变，而且只活在 Web GUI 里。

没有一个是养成：没有孵化、没有阶段进化、没有「你的工作方式决定它长成什么」。dsh-digipet 补的是这一格 —— 初代育成机式的成长循环，宿主是你的 harness，饲料是你的真实工作。

吃撑了会犯困（饱食度 > 90% 时经验收益降到 15%），睡一会儿消化掉再继续吃 —— 这是天然的防刷机制。但老玩家都知道：撑着肚子的时候，千万别按进化。

原理

整个插件是四个事件监听 + 一个斜杠命令：

进化门槛 30 / 120 / 500 / 1800 / 6000 / 16000 XP。进化时取这一阶段窗口内的最高属性定系谱，窗口随进化清零。存档在 $DSH_HOME/digipet/state.json，写盘走「临时文件 + fsync + 原子 rename」（与官方 JSON 存储后端同款），事件再密集也只按 1.5 秒节流落盘一次。

关键不变量：模型可见即已记录 —— 而这个插件干脆什么都不让模型看见。 不注册工具（工具 schema 是每轮固定 token 税）、不 agent.inject()、不写会话事件。宠物只活在命令结果卡里，对每一次模型请求的贡献是零字节。

信任立场

• 读：只读它自己的存档文件。不读你的代码、不读会话内容 —— 事件监听里只用到「发生了什么类型的事」，消息与工具的具体内容从不落存档。
• 写：只写 $DSH_HOME/digipet/state.json。
• 网络：无。
• 模型可见面：无。零 token 开销，KV cache 不受任何影响。
• 故障半径：所有监听器包在 try/catch 里，命令处理器有自己的错误兜底 —— 宠物摔了一跤不会波及你的工作。挂载的事件全是通知型（emit/serial），本插件从不否决、不改写、不延迟任何真实流程。

已知限制

• 一个 DSH home 一只宠物，同机的所有 profile、会话、子 agent 共享它、一起喂它（这是特性也是限制）。
• 多个 dsh 进程同时跑时，存档是「后写者胜」—— 与官方 JSON 后端同样的单进程立场。
• 工具分类靠名字的正则启发（write/edit/shell → 锻造；read/grep/search → 学识），第三方工具起了奇怪的名字就会被当成中性饲料。
• 会话流里的折叠行会把立绘拍平成一行 —— 点开卡片看完整版（DSH 的工具行同款交互）。
• 进化门槛与食谱不可配置：改了数字，图鉴和存档就没有共同语言了。

验证记录

在 dsh 0.1.0-rc.6（macOS，web profile）上真机验证：

1. dsh plugin --profile web add <本仓库> 安装，--dump-config 出现 digipet 层；
2. dsh web 启动无异常；
3. 真浏览器里 /pet hatch → 蛋卡渲染（等宽、换行保留）→ 真实事件喂到 30 XP → /pet evolve 破壳出比特泡；
4. 无 API key 时发普通消息，模型请求失败但事件是真的 —— 存档数字与食谱逐项吻合；
5. 造一份 0.1.x 旧存档（故障系成长期）重启加载：自动迁移为新图鉴对应形态，名字、四维、大事记全部保留；
6. 42 个单元 / 集成测试（node --test），覆盖纯逻辑层、假 ctx 集成、迷途进化三连与迁移。

致敬与边界

形态设计致敬初代 V-pet 与经典养成游戏的进化线传统（骨盔恐龙、机械改造、圣翼、网络病毒、照顾失误的那只泥）。「数码宝贝 / Digimon」是万代南梦宫的商标，本项目与其无任何关联；全部命名、立绘、文案均为原创，不包含任何官方素材。

许可

MIT