fzy3232/dsh-chinese-language

dsh-chinese-language

让 DeepSeek Harness（dsh）的智能体用简体中文思考和回答——通过一条省 token 的 system prompt 段落，加一条 runtime context 提醒，不碰原生 persona 配置。

为什么需要它

DSH 出厂时的 system prompt 是英文优先的。模型的隐藏推理跟着 system prompt 走，可见回答又跟着推理走，所以只要没有东西明确约束，长会话就会自然滑向英文。

在每条消息里写"用中文回答"当然有效，但那是单会话的：换个窗口、恢复一个旧会话就没了。这个插件把规则写在模型每次都会读到的地方。

它做了什么

插件用两个通道注册同一条规则，两者的 token 特性不同：

| 通道 | 落点 | 成本 |
| --- | --- | --- |
| system prompt 段落 user:chinese-language，order 10300 | deployment:persona-suffix（order 10200）之后，即装订结果的最末尾 | 每个请求都会重发，因此刻意写短 |
| runtime context 提醒 user:chinese-language，order 100 | 运行时动态快照，投影在最新消息旁边 | 只持久化一次：harness 仅在文本变化时写新快照，而这段文本是静态的 |

为什么要两个：新会话靠段落就够了；但长会话或恢复的会话历史里已经有大量英文推理，只在历史开头出现一条规则会被冲淡——runtime context 提醒紧贴当前对话重申规则，这正是已经在跑的会话不用重开也能重新读到规则的原因。

两个注册都是纯追加：不替换 personaPrefix / personaSuffix，不重写任何工具、技能、workspace 指令行，也不改变任何原生段落的顺序。它覆盖所有继承挂载作用域的智能体：挂在根作用域时，每个会话和每个加入该作用域的子智能体都会读到。

默认段落是两行，提醒是一行更短的：

语言规则：始终使用简体中文进行内部推理（thinking）与最终回答，历史内容为英文时同样适用。
代码、命令、路径、URL、报错原文和专有名词保留原文。

语言提醒：本轮内部推理与可见回答使用简体中文。

token 预算

| 版本 | 稳态默认文本量 |
| --- | --- |
| 0.1.0（只有段落，四行） | 约 148 字符 |
| 0.2.0（两行 + 一行提醒） | 约 99 字符 |

两点保证成本是平的：

- 段落文本很短，且位置固定在 prompt 前缀里，不会让 prefix cache 失效。
- runtime context 文本永不变化，harness 只持久化一次并反复复用那条消息：它不会逐步累积，也不会每轮多出一段提醒文本。

想要绝对最省，用 context: false 把提醒通道整体关掉；在 0.1.7 系列上，旧行为正好等于 context: false 加一段四行的 lines。

安装

方式一：从 GitHub 安装（推荐）

dsh plugin --profile web add github:fzy3232/dsh-chinese-language
dsh web   # 重启生效，然后新建一个会话

方式二：从 npm 安装（发布后可用）

dsh plugin --profile web add dsh-chinese-language

两个渠道的机制相同：包内声明了 dsh.bundle.patch，所以 dsh plugin add 会把它追加进 dsh.profile.bundles，启动时加载器再合并包内的 cordis.patch.yml 插入插件行。不需要手改任何 profile 文件。

如果你用的不是 Web profile，把 web 换成 tui、headless 等自己的 profile 名。

方式三：单文件本地挂载（不用包管理器）

插件就是一个零依赖的 ES module，因此也可以当本地文件用。

mkdir -p "$DSH_HOME/dsh-plugins"
curl -fsSL -o "$DSH_HOME/dsh-plugins/chinese-language.mjs" \
https://raw.githubusercontent.com/fzy3232/dsh-chinese-language/main/lib/index.js

然后在 $DSH_HOME/cordis.patch.yml 里加一条 insert（文件不存在就自己建）：

- insert:
- id: user-chinese-language
name: ./dsh-plugins/chinese-language.mjs

升级

GitHub 依赖是按已安装的 commit 锁定的，所以正在跑的 profile 会一直用旧构建，直到你显式刷新：

dsh plugin --profile web update dsh-chinese-language
dsh web   # 重启 profile 才会加载新模块

已经在跑的会话会保留它装订时的那份 system prompt；重启后，runtime context 提醒会在它的下一步到达。

配置

所有字段都可选。未知键会被忽略；某个已知键的值不可用时，回退到该键的默认值，而不会让整个加载项失败。

| 键 | 默认值 | 含义 |
| --- | --- | --- |
| lines | 内置的两条规则 | 段落行数组，用换行拼接。空行和非字符串项会被丢掉。 |
| text | 无 | 非空时整体取代 lines，优先级高于 lines。 |
| order | 动态推导，回退 10300 | 段落排序值。大于 10200 就会落在所有原生段落之后。 |
| section | 开启，名 user:chinese-language | 传 false 关闭段落通道；传字符串则作为段落名。 |
| sectionName | user:chinese-language | 段落名。同一作用域内必须唯一，重名会让加载器直接报错。 |
| contextText | 内置的一行提醒 | 单独替换提醒文本，不影响段落文本。 |
| context | 开启，名 user:chinese-language | 传 false 关闭提醒通道；传字符串则作为提醒名。 |
| contextName | user:chinese-language | 提醒名，同一作用域内必须唯一。 |
| contextOrder | 动态推导，回退 100 | 提醒排序值；值越小，在快照里越靠前。 |

在提供 getSectionOrder() / getContextOrder() 的 harness 上，两个 order 分别由 DEPLOYMENT_PERSONA_SUFFIX 和 SANDBOX_POLICY 推导，因此即使原生槽位移动也能跟上；老版本 harness 用常量兜底。

示例——保留两个通道，只把措辞收紧：

- insert:
- id: dsh-chinese-language
name: dsh-chinese-language
config:
lines:
- 始终使用简体中文回答。
- 代码、命令和报错原文保留原文。
contextText: 提醒：用简体中文。

注意：patch 会整体替换目标行的 config，所以任何一次覆盖都要把它需要的键全部重写。

验证

dsh --profile web --dump-config | grep -A2 dsh-chinese-language

用的是本地挂载方式时，看到的应该是文件路径：

== /Users/you/.dsh/cordis.patch.yml
- id: user-chinese-language
name: file:///Users/you/.dsh/dsh-plugins/chinese-language.mjs

然后新建会话：规则从第一轮就进入模型。已经在跑的会话，提醒会在它的下一步到达——harness 显示在最新一条消息上方的运行时上下文快照里，会有一条名为 user:chinese-language 的贡献：

Current runtime context. This snapshot supersedes earlier runtime-context snapshots.
...
语言提醒：本轮内部推理与可见回答使用简体中文。

这份快照是写一次、原地替换的：只有快照里真正变化的部分（沙箱状态、召回的灵枢记忆……）才会触发重写，所以那条提醒既不会累积，也不会每步重复。

通道不可用时会怎样

两个通道各自独立降级，任何一路缺失都不会让规则整体消失：

| 情形 | 段落通道 | 提醒通道 |
| --- | --- | --- |
| 正常 | 有 | 有 |
| harness 没有 systemPrompt.context()（早于 runtime context API） | 有 | 跳过 |
| 部署在 dsh-system-prompt 上设了 includeRuntimeContext: false | 有 | 被 harness 抑制 |
| 某个 agent preset 用 complete: true 的人设段落接管提示词 | 被取代——harness 会把那个段落恢复成唯一的 prompt 段落 | 仍然有 |

最后一行正是这条提醒存在的理由，而不是重复：complete 人设恰好是"只注入段落"的语言插件彻底失声的场景。同一条规则走两个通道，才能保证至少有一路留在模型面前。

两个通道都在开发机上装过的每一代 @deepseek-ai/dsh-system-prompt 上实测过——0.1.5-rc.2、0.1.5-rc.3、0.1.7-rc.1、0.1.7-rc.2——每一代的挂载行为一致，段落都排在最后。早于 0.1.5-rc.2 的版本未经验证：它们会保留段落通道、跳过提醒通道。

作用范围与边界

- 它约束的是 prompt——system prompt 段落加上 runtime context 快照——也就是模型开始推理前读到的东西，不是一个 token 级过滤器。
- 隐藏推理是模型的输出。prompt 能强力引导它，但这一层给不出数学意义上的绝对保证——实际表现是"稳定遵守"，而不是"不可能违反"。
- 代码、命令、文件路径、URL、API 名称和报错原文保持原样，这是内置规则的一部分。
- 如果别的插件在同一作用域注册了同名段落或同名上下文，加载器会显式报错。改 sectionName / contextName 即可。

卸载

dsh plugin --profile web remove dsh-chinese-language

本地挂载方式：从 $DSH_HOME/cordis.patch.yml 删掉那条 insert，再删掉 .mjs 文件。

开发

没有构建步骤，没有运行时依赖。lib/index.js 就是整个插件。

npm test          # node --test：契约 + 打包（本机装有真实依赖时还会跑真实 harness 套件）
node --check lib/index.js

| 测试文件 | 覆盖内容 |
| --- | --- |
| test/contract.test.mjs | 两个通道、全部配置键、老 harness 路径、稳态 token 预算 |
| test/manifest.test.mjs | npm pack --dry-run 是否带上模块、patch、两个 README 与许可证 |
| test/rc2-integration.test.mjs | 对着真实 @deepseek-ai/dsh-system-prompt 组装：段落排在最后、提醒进入快照、complete 人设、抑制运行时上下文，以及 profile 的 pnpm store 里找到的每一代版本 |

第三个套件 import 的 @deepseek-ai/* 装在 dsh profile 里而不是本仓库，所以解析不到时会显示 skipped，不会让 CI 变红。要在本机真正跑它，把仓库指向已安装的 profile（该软链已被 git 忽略）：

ln -sfn "$DSH_HOME/profiles/web/node_modules" node_modules
npm test

要在真实插件树里验证，用上面的本地挂载配方挂上，再跑一次 dsh --profile web --dump-config。

许可

MIT，见 LICENSE。