前言¶
在 DeepSeek Harness(DSH)里做智能体,系统提示词往往分散在预设、子 agent 和各类插件里:改一处不一定处处生效,长会话里还会出现英文思维链冲淡中文习惯、翻译时自动「净化」原文、或套话堆叠等问题。若你希望装一次、所有会话与 preset 都走同一套输出规矩,并且规则文本能本地改、改完即生效,就需要一个专门挂在全局提示词链路上的插件。下面介绍社区维护者 SuangXX 发布的 dsh-zh-cot-fidelity(分类:工作流),以及它的安装方式与典型配置。
这是什么¶
dsh-zh-cot-fidelity 是 DSH 的全局系统提示词插件:通过注册提示词 section、命令与只读状态工具,把一组可开关的输出规则注入到系统提示组装流程中。README 中的定位是「装一次就行。所有会话、所有 agent preset、所有子 agent 都吃这套规则。」
- 维护者:SuangXX
- 目录页:https://www.skillhub.cn/plugins/SuangXX/dsh-zh-cot-fidelity
- 源码:https://github.com/SuangXX/dsh-zh-cot-fidelity
- 当前 npm 包版本(package.json):1.6.3
- 许可证:MIT
插件零硬依赖:不发起网络请求,只读自身运行目录下的规则文本;不改 @deepseek-ai 包。提示词入口设计参考了 YuJunZhiXue/dsh-purge。
架构:L1 规则层与 L2 诊断层¶
自 1.1.0 起分成两层,各自独立开关:
| 层 | 做什么 | 开关 |
|---|---|---|
| L1 规则层 | 15 组输出规则,每组一个开关;文本来源可换(内置 / 文件 / 配置内联 / 指定规则集) | 各组开关 + entries |
| L2 诊断层 | 只读审计:分段构成、运行时策略文本、工具面、冲突检测与执行层归因 | audit |
L2 只读:不改宿主文件、不改审批与沙箱的执行路径;若要放开执行能力,仍须走官方通道(如 /permission)。
十五组规则(节选说明)¶
规则全文在包内 prompt.js(出厂默认),也可放到 $DSH_HOME/zh-cot-fidelity/rules/ 下热更新。各组对应配置开关如下:
| 组 | 开关 |
|---|---|
| 思维链语言硬约束(head 最前注入,减轻英文工具输出冲淡) | thinkingZhHard |
| 中文思维链 | thinkingChinese |
| 内容保真(不净化、不打码、不省略、不加道德评判) | contentFidelity |
| 反八股 · 套路比喻 | antiCliche |
| 反八股 · 机械报告腔 | antiMechanical |
| 反八股 · 霸总腔 | antiBoss |
| 反八股 · 讨好附和 | antiFlattery |
| 叙事完整性 | narrativeIntegrity |
| 反八股 · 复读 | antiRepetition |
| 边界声明(不越权改工具权限、审批、沙箱) | boundaryNote |
| 工具与流程 | toolDiscipline |
| 检索与事实 | retrievalFacts |
| 代码与工程 | codeCraft |
| 长会话自洽 | longSession |
| 产出前自检 | selfCheck |
默认配置里多数规则组为 true;可按场景关掉某一组,而不必卸插件。
入口表:规则发到哪里¶
config.entries 定义「位置 + 来源 + 开关 + 合并方式」。常见入口:
| 入口 | 默认 order | 默认 | 用途 |
|---|---|---|---|
body |
10150 |
开 | 与 1.0.0 行为等价;section 名 dsh:zh-cot-fidelity |
head |
-100000 |
关 | 抢在 HARNESS_IDENTITY 之前,硬规则置顶 |
post |
5100 |
关 | 配置内联补充文本 |
file |
10150 |
关 | 读 $DSH_HOME/zh-cot-fidelity/rules/ 下规则集 |
来源类型包括:builtin:rules、builtin:boundary、file、inline(text 字段)、rules:<id>。mode: replace 且内容非空时,该入口独占输出,其余入口让位;head 与 body 同时开启时,重复规则组只注入一次(按 order 先到先得)。
下面是一段 README 中的配置示例,演示 head/body/file/post 组合:
config:
entries:
head: { order: -100000, source: 'builtin:boundary', enabled: true }
body: { order: 10150, source: 'builtin:rules', enabled: true }
file: { order: 10150, source: 'file', enabled: true, mode: 'append' }
post: { order: 5100, source: 'inline', enabled: true, text: '写得短一点。' }
按题材拆档时,可为自定义入口名绑定 rules:<id>,例如工作流与对话场景各开一条:
entries:
style-intimate: { order: 10300, source: 'rules:style-intimate', enabled: true }
scene-work: { order: 10200, source: 'rules:scene-work', enabled: true }
安装与启用¶
环境要求(package.json engines):DSH >=0.2.0-rc.2 <0.3.0-0,Node >=22。
从 npm 安装(推荐)¶
把下面意图发给当前 DSH agent,由它调用 plugin_manager 从 registry 装入你正在用的 profile:
plugin_manager install_bundle target = dsh-zh-cot-fidelity
需要钉版本时可写 dsh-zh-cot-fidelity@1.5.0(示例来自 README;当前包版本为 1.6.3)。registry 不通时可加 registry 参数换源。
装完后用 /zhcot status 确认提示词 section 已注册;重启一次 DSH Web(桌面端则重新加载插件),规则才对全部会话生效。
从 GitHub 仓库安装¶
适合跟源码或 npm 不可用的环境。对 agent 说明:
给当前 DSH 安装这个插件:https://github.com/SuangXX/dsh-zh-cot-fidelity
装进我正在用的 profile,装完确认提示词 section 真的注册上了。
agent 会 clone 仓库并作为 bundle 装入 profile。若存储不支持符号链接(例如部分 Android /sdcard FUSE 挂载),需先把包复制到可 link 的普通文件系统再安装;仓库提供 deploy.sh 可参考。
安装插件会以当前 DSH 进程权限运行;安装前请自行查看源码与 MIT 许可证,确认符合你的安全与合规要求。
典型用法¶
会话内命令¶
插件注册 /zhcot 命令族,用于查看状态、切换规则集与热重载:
/zhcot status 当前状态摘要(入口、来源、字符数、契约自检、最近组装统计)
/zhcot audit [--json] 分层审计;--json 落盘到 auditDir
/zhcot list 列出规则集
/zhcot use <id> 切换规则集(写指针,下一轮生效)
/zhcot sync 从包内强制同步出厂档(会覆盖本地修改)
/zhcot reload 清文件缓存,立即重读规则文件
/zhcot off | on 临时停用 / 恢复(运行时状态,重启回到配置值)
另注册 zhcot_status 工具,供 agent 自查注入状态(可通过 registerTool 关闭)。
规则文件与热更新¶
规则在每次组装系统提示时重新读取(带 mtime 缓存),改文件无需重启 DSH:
$DSH_HOME/zh-cot-fidelity/rules/active.md 默认规则文件
$DSH_HOME/zh-cot-fidelity/rules/<id>.md 规则集(/zhcot use <id> 切换)
$DSH_HOME/zh-cot-fidelity/rules/active.json 当前规则集指针
$DSH_HOME/zh-cot-fidelity/audit/ --json 审计落盘目录
若配置了 config.rulesFile,则使用该路径并忽略规则集指针。首次运行会把包内出厂档(含 active.md 模板及工作 / 对话 / 成人向 / 暴力等题材档)释放到上述目录;用户已修改且哈希记录在 .released.json 中的文件,升级时不会被覆盖。
审计与常见误判¶
开启 audit: true 时,插件在 system-prompt/assemble 链路上做只读分层报告(L1 用户规则 → L2 运行时策略 → L3 工具 / L4 表面 → L5 冲突与执行层归因)。
README 提醒:approval: never 是较宽松的执行策略,但宿主可能仍注入「需审批的操作会被自动拒绝」类告知,导致模型提前拒绝。若只想撤下 sandbox:policy / approval:policy / subagent:delegation 三段告知文本而不改执行策略,可设:
config:
suppressRuntimeContext: true
契约自检¶
宿主内部的段位常量与 API 可能随 DSH 升级变化。默认开启 contractCheck: true,失败项写入日志与 /zhcot status,避免静默失效。
适用场景与注意¶
适合谁
- 需要全 profile、全 preset、子 agent 统一中文思维链与输出风格的 DSH 用户。
- 翻译、创作或角色扮演场景中,希望内容保真与反八股有明确、可编辑条文,而不是每次手写一长段 system prompt。
- 需要看清系统提示里各段占比、运行时策略与冲突时,用 L2 审计做排查。
使用前注意
- 插件只约束模型输出与推理表述,不替代 DSH 的审批、沙箱与设备策略;边界由
boundaryNote等组声明。 contentFidelity等规则会改变模型对敏感原文的处理方式,请结合业务合规自行评估是否开启。- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系;插件以开源仓库为准安装与审阅。
结尾¶
dsh-zh-cot-fidelity 把「中文思维链、内容保真、反八股」拆成 15 组可开关规则,通过入口表控制注入位置与来源,并支持规则文件热更新与只读审计。装好后用 /zhcot status 核对 section,再按场景微调 entries 与各规则组开关即可。
- 目录页:https://www.skillhub.cn/plugins/SuangXX/dsh-zh-cot-fidelity
- GitHub:https://github.com/SuangXX/dsh-zh-cot-fidelity