前言¶
在 DSH(DeepSeek Harness)里做面向中文用户的智能体时,常见现象是:最终回答已是中文,但模型内部的 reasoning(思维链)仍大量用英文。结果是术语前后不一致、推理深度与中文表达脱节,工具调用前后的分析也会退回英文。只在系统提示里写一句「请用中文思考」,在一轮对话的中后段往往会被稀释。下面介绍社区插件 dsh-chinese-thinking 如何用五层互相冗余的注入点,把「用中文推理」写进 Harness 的多个环节。
这是什么¶
dsh-chinese-thinking 由维护者 helix-byte 发布,在 SkillHub 社区目录中归类为模型推理。npm 包名为 @skyline/dsh-chinese-thinking(当前版本 1.0.0),采用 MIT 许可证。插件定位是:用五层冗余机制强制模型在内部推理阶段优先使用中文,而不是仅约束最终可见回复。
解决什么问题¶
模型给出中文回答时,内部 reasoning 仍可能以英文进行,带来:
- 中英混杂,术语前后不一致;
- 推理深度与中文表达脱节;
- 工具调用前后的分析退回英文。
本插件把语言约束拆成五个注入点,任一层失效仍有其余层兜底。
五层机制¶
下面按 README 中的表格说明各层注入位置与作用。
| 层 | 注入位置 | order |
作用 |
|---|---|---|---|
| Layer 1 | 系统提示节 language:chinese-reasoning |
-200 | 在所有系统提示节之前先立规矩 |
| Layer 2 | 运行时上下文(独立于系统提示的历史消息层) | -200 | 不进系统提示,避免被后续拼接稀释 |
| Layer 3 | agent/pre-step 每步骤消息注入 |
— | 每一步追加语言提醒,并保留下游 decision 的其余字段 |
| Layer 4 | 工具使用指导 language:tool-guidance |
150 | 覆盖工具调用前分析、调用中决策、调用后解读 |
| Layer 5 | 推理语言后验检测 + 修正注入 | — | 读取上一步 reasoning,中文占比不足时注入修正指令 |
Layer 5 判据¶
从 session.snapshotEvents() 回溯最近的 assistant/message,取其 reasoning 块文本,统计 CJK 统一表意文字(U+4E00 ~ U+9FFF)占比:
chineseChars / text.length >= 0.2
低于 20% 即判定为非中文推理,下一步注入「语言修正」而非普通「语言提醒」。后验检测只覆盖上一步的 reasoning,无法干预模型内部实际计算。
安装与启用¶
本插件以 DSH bundle patch 方式挂载,不是单独的 dsh plugin add 一行命令。cordis.patch.yml 中定义插入点:
- insert:
- id: chinese-thinking
name: '@skyline/dsh-chinese-thinking'
应用顺序为:
dsh-base → dsh-web-app → 本插件层 → profile 自己的 cordis.patch.yml。
操作步骤:
- 将插件目录放入
dsh-plugins/。 - 在目标 profile 的
cordis.yml/cordis.patch.yml中引用上述 patch。
依赖 @deepseek-ai/cordis ^4.0.0。安装前建议阅读仓库源码与 LICENSE,插件以当前 DSH 进程权限运行。
兼容性与实现细节¶
- 会话格式 v4 的
source约定:kind必须是非空字符串,且不得使用保留值plugin。V3 时代的{ kind: 'plugin', plugin: '<name>' }在 v4 持久化准入阶段会抛format v4 message requires a producer-owned source kind。本插件使用命名空间plugin:chinese-thinking。 - 旧代码中的
agent.session.events并不存在;公开读取入口是session.snapshotEvents()。插件对两者做了兼容。
已知限制¶
- 后验检测只覆盖上一步
reasoning。 - 注入消息以
user角色下发,会在会话里产生额外消息条目(id前缀cthnk-)。 - 中文字符占比是粗略启发式;代码块、专有名词占比高的推理可能被误判为「非中文」,从而触发不必要的修正。
适用场景¶
适合已在 DSH 上跑中文场景、且希望思维链与工具调用分析也保持中文一致性的开发者。若 profile 仍混用 v3 式 source 包装,需先按 v4 约定调整,否则整轮可能失败。
结尾¶
dsh-chinese-thinking 用系统提示、运行时上下文、逐步 pre-step、工具指导与后验修正五层叠加,把「中文推理」从一句软约束变成 Harness 里的硬约束链。目录与源码:
- 社区目录:https://www.skillhub.cn/plugins/helix-byte/dsh-chinese-thinking
- GitHub:https://github.com/helix-byte/dsh-chinese-thinking
SkillHub 为社区插件目录,与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」的扩展方式。