前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在处理复杂任务或高权限操作时，单纯依赖模型自身的自我修正往往不够稳健。dsh-audit-mode 是 DeepSeek Harness 的第五种模式，预设 ID 为 audit。它引入了独立、持久化的 Codex 审计机制，并将代码审查与人工审批的补救流程结合在一起，作为 DSH 的安全网。
核心功能¶
该插件为 DSH 增加了一个独立运行的审计角色，具备以下能力：
* 独立持久化审计：审计状态独立于主会话，记录在侧车文件中。
* 人工确认的补救循环：对于关键或警告级别的审计结果，需要用户批准后才能执行补救。
* 多后端支持：支持配置 Codex、Claude Code 或 DSH 自身的 LLM 运行时作为审查者。
* 安全暂停：在发生连续失败或严重错误时，会自动暂停会话。
* 双端控制：提供 TUI 和 Web 两种控制界面，用于查看审计状态和执行补救。
安装与启用¶
安装过程通过 pnpm 在当前 DSH 配置文件目录下执行。
- 进入 web 配置目录（TUI 目录同样适用此模式）：
cd ~/.dsh/profiles/web
- 安装插件包：
pnpm add dsh-audit-mode@github:yhfgyyf/dsh-audit-mode
（推荐同时安装 `dsh-progressive-tools` 以获得更好的工具发现支持）
- 修改
package.json，在dsh.profile.bundles中添加该插件：
{
"dsh": {
"profile": {
"bundles": [
"dsh-audit-mode"
]
}
}
}
- 重启 DSH 配置文件以加载插件。
配置审查者¶
默认情况下，插件使用 Codex 作为审查者。如果需要更改审查后端或模型配置，需编辑 cordis.patch.yml。
默认配置¶
- id: audit-bundle
config:
reviewer: codex
binary: codex
args: [app-server, --stdio]
models:
summarizer: { model: gpt-5.6-luna, effort: medium }
auditor: { model: gpt-5.6-sol, effort: max }
使用 Claude Code¶
- id: audit-bundle
config:
reviewer: claude-code
claudeBinary: claude
claudeArgs: []
models:
summarizer: { model: haiku, effort: medium }
auditor: { model: opus, effort: max }
使用 DSH LLM 运行时¶
- id: audit-bundle
config:
reviewer: dsh
dshProvider: deepseek-official
models:
summarizer: { model: deepseek-v4-flash, effort: off }
auditor: { model: deepseek-v4-flash, effort: high }
常用命令¶
在 audit 预设模式下，可以使用以下命令控制审计流程：
* /audit status：查看当前轮次、频率间隔、最后一次裁决和暂停状态。
* /audit now：强制立即执行一次审计（不受常规频率限制）。
* /audit history：从侧车文件中读取最近的审计历史记录。
* /audit accept [audit-id]：批准最新的或指定 ID 的补救方案。批准后，模型将加载相应的技能并执行修复。
* /audit resume：从非关键审查失败或手动暂停中恢复会话。
行为与状态¶
- 频率控制：首次审计至少需要两步且间隔 60 秒；随后的审计每 3 步或 3 分钟执行一次，最小间隔仍为 60 秒。异常情况会在下一个安全边界触发审计。
- 警告 vs 关键：警告不会暂停主 Agent，用户可以执行或编辑修复方案；关键警告会暂停主 Agent 和当前 Goal，批准后立即开始修复，并临时暴露 Codis 工具。
- 失败处理：如果审查者连续三次失败（不可达、超时或格式错误），会话将因
failures原因暂停。 - 最终审计：当会话结束或通过 Remote API 发起
final: true的审计时，会进行一次全量对齐审计（包含目标、边界规则和最近摘要）。
前端与终端控制¶
- Web 界面：插件在 Web 侧注册了 Remote API 和 Dock 组件。审计条带显示在
conversation.input.dock（顺序 5），位于 Todo 和 Goal 之间。可通过 API/api/audit/snapshot和/api/audit/watch(SSE) 获取快照和实时更新。 - 终端界面 (TUI)：
dsh-tui-app会渲染一个独立的状态块。a：直接执行提议的补救方案。e：将补救方案载入编辑器，回车执行，Esc 取消。c：在暂停状态下复制反馈内容。r：恢复非关键审查暂停。Esc/Ctrl+C：停止当前工作。
注意事项¶
- 版本要求：该插件目前支持 DSH 0.1.3-alpha.2 版本。
- 权限与安全：插件以当前 DSH 进程的权限运行。安装前请检查源码。
- 数据持久化：审计状态以 JSON 格式写入侧车文件 (
${DSH_HOME:-~/.dsh}/audit/sidecars/<sessionId>.json)。
总结¶
dsh-audit-mode 为 DeepSeek Harness 提供了一个结构化的安全审查层。通过配置 Codex 或其他 LLM 作为审计员，并配合人工审批流程，可以在保持 Agent 自主性的同时，显著降低代码生成和工具调用的风险。
- 目录页: yhfgyyf/dsh-guardian-mode
- GitHub: yhfgyyf/dsh-audit-mode
