前言¶
在 DeepSeek Harness（DSH）里跑智能体时，常见几类摩擦：模型在内部思考里只给结论，你看不见目标理解、方案取舍和风险；思考、权限说明和汇报中英混杂；靠 AGENTS.md 或每次口头叮嘱约束风格，换会话、上下文压缩或上游预设替换后规则悄悄失效，往往要到出问题时才发现。
下面介绍的是社区维护者 ROBOHAPPYIY 发布的 bundle 插件 dsh-zh-review-guard（分类：工作流）。它在每个会话装配系统提示词时被调用，以常驻 section 注入规则，并可选同步到 $DSH_HOME/AGENTS.md，目标是把「内部思考用户可审阅」和「面向用户的说明用简体中文」变成可观测、可复用的机制，而不是依赖单次会话里的口头约定。
这是什么¶
dsh-zh-review-guard 是 DSH 的 bundle 插件：装配系统提示词时注入名为 zh-review-guard 的规则段，不受上下文压缩影响（主通道走官方 system-prompt/assemble 注入点）。规则正文集中在 lib/index.js 的 RULES_TEXT；AGENTS.md 默认同源写入精简兜底版（前 2 条），避免两处文案漂移，也不为同一条规则每轮付两份 token。
仓库：https://github.com/ROBOHAPPYIY/dsh-zh-review-guard
目录页：https://www.skillhub.cn/plugins/ROBOHAPPYIY/dsh-zh-review-guard
许可证：MIT；当前 Release 示例版本 v0.2.2；运行要求 Node ≥22，DSH ≥0.0.1-rc；零第三方依赖。
核心功能¶
注入的七条基线规则¶
插件向系统提示词注入的规则要点如下（完整措辞以仓库为准）：
- 内部思考（reasoning / thinking）一律使用简体中文。
- 内部思考视为用户可见、需审阅：给结论前写清目标理解、方案取舍、为何选 A 不选 B、风险与不确定之处、尚未解决的问题。
- 需用户拍板或复核处，明确写出「这是需要你确认的点」。
- 面向用户的说明、汇报、提问、交付说明一律简体中文；代码、命令、路径、专有名词保留原文。
- 申请系统级权限或不可逆操作前，用简体中文说明要做什么、为何需要、影响范围、是否可回退。
- 报告结论附证据（命令、输出、文件路径与行号）；先查证再动手，能从代码库或本机查到的客观事实不要反问用户。
- 能回退的下一步直接做并汇报；只有属于用户的选择才停下来问。
双通道，保证规则常驻¶
| 通道 | 机制 | 抗压缩 |
|---|---|---|
| 主 | system-prompt/assemble 注入 section { name: 'zh-review-guard', order: 4, text: … }，同名段就地替换 |
是 |
| 备 | 规则同步到 $DSH_HOME/AGENTS.md（默认可精简兜底），由 @deepseek-ai/dsh-agent-instructions 在会话首个 pre-step 作持久基线 |
是 |
部分会话预设会在首轮整体替换 sections，主通道段可能被丢掉；备通道走 AGENTS.md 基线，首轮仍可能有规则。手写的 AGENTS.md 默认不会被覆盖；仅在文件不存在/为空、或内容与插件记录的哈希一致、或全文已是本插件文本等条件下才会写入，覆盖前可备份到 zh-review-guard/backups/。
可观测性¶
装完后不必猜「有没有生效」：
$DSH_HOME/zh-review-guard/status.json：装配次数、替换次数、错误计数、agentsFile与rules状态等。$DSH_HOME/zh-review-guard/assemblies.jsonl：每次装配一行记录。$DSH_HOME/zh-review-guard/health.json：主通道心跳，用于判断主通道是否被上游改死。
安装与启用¶
前提：本机已安装 DSH，命令行 dsh --version 有输出。安装后需重启 DSH App（profile 的 bundle 层栈在启动时装配）。
机器能访问 GitHub 时，可用官方文档中的一条命令（将 desktop 换成你的 profile，Web GUI 常用 web）：
dsh plugin --profile desktop add github:ROBOHAPPYIY/dsh-zh-review-guard#v0.2.2
不走 git 时，可直接安装 Release 附件：
dsh plugin --profile desktop add https://github.com/ROBOHAPPYIY/dsh-zh-review-guard/releases/download/v0.2.2/dsh-zh-review-guard-0.2.2.tgz
离线可先下载 tgz、可选核对 SHA256，再本地 add；卸载示例：
dsh plugin --profile desktop remove dsh-zh-review-guard
更细的步骤（哈希、故障排查）见仓库 INSTALL.md。
典型用法¶
追加本机规则¶
内置 7 条是基线。在 append 模式（默认）下，可编辑 $DSH_HOME/zh-review-guard/rules.md，两条通道会同时使用解析后的新文本；改完无需重启，默认每 60 秒心跳检查文件修改时间并计入 status.json 的 rulesReloads。
Windows 示例（路径按你的 $DSH_HOME 调整）：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\zh-review-guard" | Out-Null
@'
- 汇报时先给结论，再给证据。
- 动手前先说明会碰哪些文件。
'@ | Set-Content -Encoding utf8 "$env:USERPROFILE\.dsh\zh-review-guard\rules.md"
rulesMode |
行为 |
|---|---|
append（默认） |
内置 7 条 + 「本机追加规则」+ 你的文件 |
replace |
完全用你的文件（仍带归属标记） |
off |
只用内置 7 条，忽略文件 |
常用配置项¶
均在 cordis.patch.yml 的 config 中，全部可选。例如：
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
关闭整个插件 |
sectionName |
zh-review-guard |
注入段名；同名就地替换 |
order |
4 |
段排序 |
syncAgentsFile |
true |
是否同步 AGENTS.md |
agentsDigestLines |
2 |
写入 AGENTS.md 的内置规则条数；0 为整份正文 |
rulesFile |
$DSH_HOME/zh-review-guard/rules.md |
自定义规则文件 |
rulesMode |
append |
append / replace / off |
includeSubagents |
true |
子会话是否注入 |
syncIntervalMs |
60000 |
规则热更新与健康检查间隔 |
适用场景与注意¶
适合谁：希望 DSH 会话里内部思考结构化、可复核，且用户可见文案稳定为简体中文的团队或个人；需要权限申请前说清「做什么、为什么、影响、可否回退」的工作流。
生态说明：DSH 强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
安全与信任：插件以当前 DSH 进程的权限运行，可能读写 $DSH_HOME 下日志与（在接管条件下）AGENTS.md。安装前建议阅读 源码 与 MIT 许可证，确认符合你的策略。不要在未核对来源的情况下盲目 pin 旧 tag；升级时对照 Release 说明。
结尾¶
dsh-zh-review-guard 把「简体中文 + 可审阅的内部思考」从会话级约定变成 bundle 级常驻规则，并用 status.json、assemblies.jsonl、health.json 回答「有没有装上、有没有被替换掉」。若你在 DSH 桌面端或 Web GUI 上长期开发智能体，可按上文命令安装 v0.2.2、重启 App，再用日志验证装配是否正常。
