dsh-decision-review

dsh-decision-review 主模型继续拍板，第二个模型只提供复核意见。 把“独立复核”做成 DeepSeek Harness 里的一个工具，而不是替模型做决定。

简体中文 · English [!NOTE] 这是一个 DSH bundle，安装后默认 mode: off，不会产生任何调用。要真正启用，需要一个兼容 POST /v1/decision 的复核服务，并显式配置 model 与 baseUrl。 为什么做这个插件

让同一个模型先产出结论再自我复核，往往只是重复一遍它的理由。独立复核的价值在于“第二意见”：复核方只看到问题、主模型的预选、证据与约束，不参与原始推理，也不掌握工具权限。

主模型必须先形成 primaryChoice，插件才发起复核。复核返回的建议会连同置信度一起回到主模型手里，采纳、保留还是询问用户，仍由主模型决定。

核心能力 复核协议

复核端点是结构化决策接口，不是 OpenAI 兼容的聊天接口：

请求体只有三个顶层字段：{ model, state, questions }。 probabilities 只透传给主模型参考，不参与判定。baseUrl 是网关根地址，插件自己拼接路径；已经以 /v1 或端点路径结尾的地址会在启动时被拒绝。 安装

配置 失败码 日志与诊断

复核事件经宿主 logger（名称 decision-review）输出，同时由插件注册的 exporter 逐行写到 stderr： exporter 的 levels 显式声明为 { 'decision-review': 2, default: -1 }：不声明时 cordis 按 INFO 阈值过滤，warn 会被丢弃；default: -1 保证其他插件的日志不会经这里输出。宿主未提供 ctx.logger.exporter 时自动跳过，其它功能不受影响。 成功、失败、入参被拒各写一行；字段与 logger 事件相同，不含请求内容、候选描述或凭据。 每次复核生成一个 W3C traceparent 随请求发出，日志记 traceId。超时时上游没有返回响应，没有 HTTP 状态可查，traceId 是到网关侧对账的唯一凭据。网关若回传 x-platform-trace-id / x-trace-context-status，分别记为 platformTraceId / traceContextStatus：与 traceId 一致且状态不为 generated，说明网关采纳了该 trace。 失败行带 stage：request 表示还没拿到响应头（连接、排队、模型推理都在这一段），response_body 表示已拿到响应头、正在读响应体；拿到响应头时另记 headersMs，超时另记 timeoutMs，网络层失败另记错误类名 errorName 与错误码 errorCode（如 ECONNRESET），不记 message。 入参被拒（rejected）带 field（如 options[1].description）与 actualType（如 undefined / object），只是固定字段路径与类型名；返回给主模型的文本也附上字段路径，便于修正后重试。 DSH 不按 parameters 校验入参，但宿主钩子、审批、guard 会在 execute 之前拒绝调用，execute 抛出的非入参异常与返回值校验失败也不经过复核日志。插件订阅 tools/result，对本工具每个 isError 回执补写一行 warn decision review tool failed：stage 为 before_execute / execute / after_execute，errorCode 取自错误信息的 code，summary 是错误文本首行（去掉 Error: 前缀，最多 200 字符，疑似凭据整行替换为 [redacted]）。 外层进程只需逐行读取 stderr 并按 DECISION_REVIEW 前缀识别即可收集这些事件。 安全边界 复核方不获得任何工具、文件、网络或审批权限。 权限提升、用户确认、写操作

开发与验证

路线图 [x] 三档模式与置信度分层 [x] 结构化失败码与日志脱敏 [x] stderr 逐行日志、traceparent 追踪与失败阶段区分 [x] 可配置决策点白名单 [x] bundle 安装形式 [ ] npm 发布 [ ] 复核服务的最小参考实现 许可证

MIT