swaylq/dsh-wildmon

dsh-wildmon · 野生小灵

你的真实工作就是草丛 —— 回合、工具、报错都会惊动它，野生小灵随机冒头，扔球捕捉，集满图鉴。

你写代码，锻造窟里有动静；你查资料，墨书林有影子掠过；你天天报错 —— 恭喜，故障岭的稀有种只认你这种人。还有一只传说小灵，只应深夜的报错声。

中文 | English

野生的 绒电鼠 Volttuft 出现了！◈ 少见 · 常野原

  ⟋⟍  ⟋⟍
  (⚡ᴥ⚡)
  c(   )ɔ
    ⌁⌁

图鉴里还没有它的记录。
它大约还会停留 10 分钟
球 ×9 —— /mon throw 投球 · /mon run 撤退

30 秒上手

dsh plugin --profile web add github:swaylq/dsh-wildmon
# 重启 dsh，然后在任意会话里：
/mon start

选一只御三家气质的同伴、领 8 颗捕灵球，然后正常干活就行。每个回合、每条消息、每次工具调用、每次报错都有几率惊动草丛；越久没遇到，几率越高（保底机制）。/mon 看一眼草丛 —— 野生小灵只等你 10 分钟；/mon throw 扔球，越稀有越难抓，连续脱手会越投越准，但它也可能跑掉。

集齐 28 格图鉴、带一支 6 只的队伍：捕到的前 6 只自动入队，1 号位的「气场」让它老家的遭遇率 ×1.5，/mon swap 随时换阵。异色个体存在，概率 1/64。

栖息地：工作方式决定你遇见谁

栖息地	惊动它的事	住着谁
🌾 常野原	消息、回合、叫不出名字的工具	绒绒虫、点点雀、绒电鼠……
⚒️ 锻造窟	写文件、跑命令	锤头蟹、齿轮獾、熔芯蜥……
📚 墨书林	读代码、查资料	书签蛾、索引鸮、典藏龙……
👾 故障岭	工具失败、agent 报错	碎屏蛙、栈迹蜈、惊叹魟……
🌙 夜阈	00:00–05:59 的任何动静	月痕猫、枕梦貘、星屑水母

外加御三家（没选的两只会在野外出没）和 3 只传说小灵：一只每 250 个回合浮出水面一次；一只只应深夜的报错声；最后一只，只肯见集齐前 25 格的收藏家。图鉴里它们只有谣传。

球的经济：出发 8 颗，每完成一个回合 +1（上限 30），抓到图鉴里已有的小灵会把球换回来（+2）—— 所以重复遭遇也不亏。

为什么做这个

DSH 生态的宠物赛道已经不少：二十多个桌宠是状态镜像（agent 思考宠物就做思考动作），dsh-digipet 补上了养成（一只宠物吃工作长大、分支进化）。

但收集这一格还是空的：没有遭遇、没有捕捉、没有「为了集齐图鉴而期待下一次报错」。2026-08 检索 dsh-plugin 话题（2800+ 仓库）与四个精选列表，pokemon / pokedex / 捕捉 / gacha 全部零命中。dsh-wildmon 补的就是这一格 —— 把捕捉收集游戏的完整循环（遭遇 → 捕捉 → 图鉴 → 队伍）架在你的真实工作流上。

和 digipet 是互补而非替代：digipet 是一只宠物的深度养成，wildmon 是一群小灵的广度收集。两个插件同装共存（不同命令、不同存档）。若 /mon 与别的插件撞名，在 profile patch 里改 config.command。

命令

命令	作用
/mon	看草丛：有遭遇显示遭遇卡（立绘、稀有度、剩余停留），没有显示状态卡
/mon start	选御三家开始旅程（不带参数看三只候选）
/mon throw	对当前遭遇投出 1 颗捕灵球
/mon run	从对峙中撤退
/mon dex	图鉴：捕获 ● / 目击 ◐ / 未知 ○，传说只给谣传
/mon team	队伍与盒子（编号供 swap / name 用）
/mon swap <甲> <乙>	换位：队内重排，或队伍↔盒子交换（1 号位是带头）
/mon name <编号> <名字>	给捕到的小灵起名（16 字以内）
/mon story	旅程大事记
/mon about	机制说明与信任立场

原理

整个插件是四个事件监听 + 一个斜杠命令，监听器只掷骰子：

挂载点	基础遭遇率
agent/turn-stopping（回合完成，顺带 +1 球）	9%
agent/inbox/claimed（你的消息）	5%
tools/result（按工具名分入锻造窟/墨书林/常野原；失败算故障岭）	6% / 失败 16%
agent/error	20%

在此之上：每个没出货的事件 +0.8%（上限 +25%），带头小灵的老家 ×1.5，深夜 70% 概率改抽夜阈池。捕捉判定 = 稀有度基础成功率（65% / 45% / 28% / 12%）+ 每次脱手 +12%，封顶 95%；脱手后小灵有稀有度对应的逃跑率。所有数字都写在 core.js 顶部的常量里。

存档在 $DSH_HOME/wildmon/state.json，写盘走「临时文件 + fsync + 原子 rename」（与官方 JSON 存储后端同款），事件再密集也只按 1.5 秒节流落盘一次。

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

信任立场

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

已知限制

• 一个 DSH home 一份图鉴，同机的所有 profile、会话、子 agent 共享一片草丛（这是特性也是限制）。
• 多个 dsh 进程同时跑时，存档是「后写者胜」—— 与官方 JSON 后端同样的单进程立场。
• 遭遇不会主动通知你（零模型可见面的代价），得 /mon 去看 —— 好在小灵会等 10 分钟，错过的会记在 story 里。
• 工具分类靠名字的正则启发，第三方工具起了奇怪的名字就归常野原。
• 夜阈按机器本地时间算 00:00–05:59；出差调时区，夜行小灵跟着你倒时差。
• 概率与门槛不可配置：改了数字，图鉴和存档就没有共同语言了。

验证记录

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

1. dsh plugin --profile web add <本仓库> 安装，--dump-config 出现 wildmon 层；
2. dsh web 启动无异常；
3. 真浏览器里 /mon start 选同伴 → 出发卡渲染（等宽、换行保留）；
4. 无 API key 连发 6 条普通消息 —— 模型请求全部失败，但 inbox/claimed 与 agent/error 是真事件：存档记录 messages:6, mishaps:6，保底涨到 10 后第 6 轮真的刷出了 碎屏蛙（报错事件 → 故障岭，与食谱一致）；
5. /mon throw 第一球脱手（卡片提示「已投 1 球」）、第二球捕获 —— 队伍 2/6、图鉴 2/28、球 ×6 = 8 − 2 投，存档与事件逐项对账吻合；
6. 实测注记：rc.6 下 MISSING_CREDENTIAL 失败回合不触发 agent/turn-stopping，所以「每回合 +1 球」的补给未在真机观察到（需要能成功完成的回合），该路径由单元测试覆盖；
7. 61 个单元 / 集成测试（node --test），覆盖纯逻辑、渲染、存档与假 ctx 集成。

致敬与边界

玩法致敬捕捉收集类游戏的传统（草丛遭遇、投球摇三下、图鉴、御三家、电气鼠、异色）。「Pokémon / 宝可梦 / 精灵宝可梦」是任天堂 / Creatures / Game Freak 的商标，本项目与其无任何关联；全部 28 只小灵的命名、立绘、文案均为原创，不包含任何官方名称、角色或素材。捕灵球是个会摇的球，但它属于所有热爱收集的人。

许可

MIT