前言¶
DeepSeek Harness 的插件生态日益丰富，宠物类插件大多聚焦于状态镜像或单一养成。缺少一个将“遭遇-捕捉-图鉴-队伍”完整循环融入工作流的插件。dsh-wildmon 正是为此而生，它利用工作流中的回合、工具调用和报错作为惊动草丛的触发点，让收集变得顺理成章。
核心功能¶
dsh-wildmon 是一个基于工作流的随机遭遇收集插件。它没有独立的游戏循环，而是将收集行为直接绑定在真实工作流之上。主要特性包括：
- 随机遭遇机制：基于回合完成、消息接收、工具调用结果、报错事件等触发随机遭遇。
- 图鉴与队伍系统：包含 28 格图鉴与 6 只队伍系统。捕到的前 6 只自动入队，1 号位的“气场”会让该小灵的栖息地遭遇率提升 1.5 倍。
- 栖息地系统：不同工作方式对应不同栖息地，如常野原、锻造窟、墨书林、故障岭、夜阈。
- 经济与养成：提供捕灵球经济系统，包含异色个体（1/64 概率）。
- 队伍管理：支持队伍管理与交换。
安装与启用¶
通过官方命令安装插件。
dsh plugin --profile web add github:swaylq/dsh-wildmon
安装后，在任意会话中使用以下命令开始旅程。
/mon start
选定同伴并领走 8 颗捕灵球后，正常工作即可。每个回合、每条消息、每次工具调用、每次报错都有几率惊动草丛。
典型用法¶
插件提供以下命令：
/mon：查看状态。若有遭遇显示遭遇卡（立绘、稀有度、剩余停留），若无则显示状态卡。/mon start：选择御三家开始旅程。/mon throw：对当前遭遇投出 1 颗捕灵球。/mon run：从对峙中撤退。/mon dex：查看图鉴。捕获为 ●，目击为 ◐，未知为 ○。/mon team：查看队伍与盒子。/mon swap <甲> <乙>：换位。队内重排或队伍与盒子交换。/mon name <编号> <名字>：给小灵起名。/mon story：查看旅程大事记。/mon about：查看机制说明。
正常工作会触发遭遇，使用 /mon 查看当前状态。
运行机制¶
插件通过监听 DSH 的事件来运作，不注册工具，不写入会话事件，不消耗模型 Token。
- 存档位置：
$DSH_HOME/wildmon/state.json。 - 共享机制：同机所有 profile 共享一份图鉴。
- 遭遇触发：主要基于
agent/turn-stopping、agent/inbox/claimed、tools/result、agent/error等事件。概率与门槛不可配置。 - 无主动通知：遭遇不会主动通知，需使用
/mon查看。
信任立场¶
- 读取：只读自己的存档文件，不读取代码或会话内容。
- 写入：只写入
$DSH_HOME/wildmon/state.json。 - 网络：无网络请求。
- 模型可见面：无。零 token 开销。
适用场景与注意¶
此插件适合希望在开发过程中增加收集乐趣的用户。需注意：
- 遭遇不主动通知，需定期查看。
- 概率与门槛不可配置，图鉴与存档绑定了固定数值。
- 安装前请检查源码与许可证（MIT）。
总结¶
dsh-wildmon 填补了 DSH 生态中“收集”这一块的空白。它通过零开销的方式，将工作流的波动转化为收集的动力。所有 28 只小灵的命名与立绘均为原创，与官方 IP 无关。
