采集钩子桥 xyzzing/dsh-minder-hooks

dsh-minder-hooks

一个面向 DeepSeek Harness（dsh）的采集优先钩子桥接插件。它把 dsh 助手的动作——每次会话启动、工具调用、工具调用前检查——记录到你自己机器上的本地 JSONL 文件；装了 minder 时，还会运行完整的 minder 监督钩子。

数据不会发往任何地方。这个包里没有网络代码。

你会得到什么

| 未安装 minder | 已安装 minder |
| 每个钩子事件脱敏后追加到 ~/.local/state/dsh-minder-hooks/events.jsonl | minder 的完整钩子集：故障发现、升级上下文、二次意见预算——外加 minder 自己的证据存储 |

插件会自动选择（模式 auto）：如果在 ~/.local/share/minder/dsh/hooks.json 找到 minder 的钩子配置，就挂载 minder 的钩子；否则挂载仅采集的钩子。你可以在配置档补丁里用 configPath 选项强制指定其中一种。

安装

dsh plugin --profile <your-profile> add dsh-minder-hooks

在包发布到 npm 之前，请从本仓库安装：

dsh plugin --profile <your-profile> add github:xyzzing/dsh-minder-hooks

dsh plugin 命令会把包安装到配置档，并加入配置档的 bundle 列表。卸载时，从配置档的 package.json 里删掉对应 bundle，再在配置档目录里运行 pnpm remove dsh-minder-hooks（或者用添加时同样的方式删掉插件目录条目）。

想确认采集是否生效，在该配置档里跑任意任务，然后查看存储：

tail -3 ~/.local/state/dsh-minder-hooks/events.jsonl

具体存了什么

每行一个 JSON 对象：一个时间戳，加上 dsh 交过来的钩子事件（工具名、输入摘要、会话标识）。键名类似 key、token、secret、password、authorization 的值，会在写入前替换成 [redacted]。文件到 10 MiB 轮转（保留一代 .old）。采集钩子始终以 0 退出，且从不打印：采集坏了绝不能弄坏它监视的会话，空 stdout 也意味着 harness 不会把采集误当成建议。

事件出现在哪里（以及哪里不会出现）

- 在无头运行（dsh --profile X "task"）中，会话启动钩子会触发；工具阶段钩子（PreToolUse / PostToolUse）不会——这条 dsh 线上的无头模式不发出智能体事件。
- 在 web 宿主上，三个阶段钩子都会触发。minder 自己的钩子在生产环境跑的就是同一套契约。
- 工具阶段钩子在 dsh 的文件沙箱内运行，那里只有会话工作区可写。钩子写不了状态目录时，事件会落到会话工作区里的 dsh-minder-hooks.jsonl，而不是丢失。
- 钩子进程的环境由 dsh 控制：按钩子设置的环境变量不会传播。要迁移存储位置，请编辑渲染后的状态目录下的 hooks.json。

插件挂载失败时

某些 dsh 版本上（在 0.1.5-rc.2 的 web host 上观察到），带 cordis inject 导出的包入口可能静默挂载失败。如果你的会话没有生成捕获文件，用本包自带的文件入口兜底方案：

1. 把 bridge-loader.mjs 复制到配置档目录（和 cordis.patch.yml 放在一起）。
2. 在配置档的 cordis.patch.yml 里，把按插件名插入的那段换成：

- insert:
- name: ./bridge-loader.mjs
config:
defaultTimeoutMs: 600000

minder 自己用的也是同样的写法。

配合 minder 使用

minder（https://github.com/xyzzing/minder）是 AI 助手的监督器：它观察助手做的工作，有证据时升级重试，为二次意见做预算，并保留只追加的记录。安装 minder 后，本插件从只捕获升级为完整监督，插件本身不用改——插件会检测 minder 的钩子配置并挂载它。卸载 minder 后，插件自动退回只捕获模式。

许可证

MIT。