dsh-think-zh

DeepSeek Harness（DSH）插件：把模型的思考（reasoning）锁定为简体中文，档位在
**设置 → 通用设置 →「思考语言」**里随时切换；回复语言跟随提问语言。

项目解决什么问题

DeepSeek Harness 默认的思考语言常常为英文，这不利于中文使用者阅读推理过程、复核结论。
本插件在每次请求的 system prompt 中注入一条精简的强制语言指令，使：

• 思考语言可控：默认档强制简体中文，也可切到「默认英文」，把思考语言交还模型；
• 回复跟随提问语言：中文提问用中文答，英文提问用英文答，判断不出语言倾向时默认简体中文；
• 代码、标识符、文件路径、命令等保持原文，不翻译。

限制声明：思考语言本质是模型自身行为，插件只能通过「注入强制指令」影响，无法在程序上
100% 锁死；模型是否遵守超出插件控制范围。

目录

• 特性
• 安装
• 使用
• 配置项
• 工作原理
• 兼容性
• 常见问题
• 开发与贡献
• 许可

特性

• 默认档注入两条强制条款：思考必须用简体中文 + 回复跟随提问语言；切到「默认英文」则只保留回复条款，思考语言交还模型。
• 档位在 GUI 里切换：设置 → 通用设置 →「思考语言」，样式与相邻的「语言」行一致。
• 改完即时生效：档位是 volatile 配置，下一份请求即用新文本；不用重启、也不用重挂插件。
• 两条投递通道：静态 system prompt section（默认开）与每轮用户消息前置（injectPerTurn，默认关，用于对静态 section 服从弱的模型），两者相互独立。
• 零运行时开销：只注入一段文本，无语言检测、无缓冲、无写回；每次请求的额外成本就是那段指令本身（简体中文档 90 字符，默认英文档 64 字符）。

安装

前置条件：

• DeepSeek Harness ≥ 0.1.7（「思考语言」设置项依赖官方 settings 服务的 volatile 字段）。
• 源码方式另需 Node.js ≥ 22.19 与 pnpm（dsh plugin 内部调用 pnpm）。

方式一：桌面应用内安装（推荐）

1. 打开侧栏 插件，点 添加插件。
2. 填仓库地址 https://github.com/Len7183/DSH-Think-zh（也接受 github:Len7183/DSH-Think-zh）。
3. 安装完成后按提示重启 DSH。

方式二：命令行安装

dsh plugin --profile <profile 名> add github:Len7183/DSH-Think-zh

需要可复现安装时，固定到某个提交：

dsh plugin --profile <profile 名> add github:Len7183/DSH-Think-zh#<commit-sha>

• <profile 名> 即 ~/.dsh/profiles/<名字> 的目录名；等价写法 npx @deepseek-ai/dsh plugin ...。
• 桌面应用自己的 desktop profile 由应用独占管理，dsh plugin 对它不可用——桌面用户走方式一。
• 仓库内已提交 lib/ 构建产物，安装时不需要跑构建脚本。若 pnpm 提示 git 依赖的 prepare 被阻止，把提示里的 key 加到该 profile 的 pnpm-workspace.yaml 下 allowBuilds 后重跑即可。

方式三：从源码安装

git clone https://github.com/Len7183/DSH-Think-zh.git
cd DSH-Think-zh
npm install
npm run build

# 装进 profile（任意目录执行）；桌面应用也可在插件页填这个绝对路径
dsh plugin --profile <profile 名> add <本目录绝对路径>

安装必须经由 dsh plugin 或桌面插件页。在本目录直接 npm install 只会把包当普通依赖装进当前目录，不会注册进任何 profile。

使用

设置项：思考语言

设置 → 通用设置，在「语言」行下方即是「思考语言」两档。

简体中文（默认）：

语言要求（强制）：
1. 思考（reasoning）必须使用简体中文。
2. 回复使用与用户提问相同的语言；无法判断时默认简体中文。代码、标识符、文件路径、命令等保持原文，不翻译。

默认英文：

语言要求（强制）：
1. 回复使用与用户提问相同的语言；无法判断时默认简体中文。代码、标识符、文件路径、命令等保持原文，不翻译。

• 即时生效：改完的下一份请求即用新文本；已经发出的那一轮不回溯改写。
• 持久化：写入当前 profile 的 cordis.patch.yml，即 dsh-think-zh 条目的 config.thinkingLanguage。
• 默认档与 1.0 之前的内置文本逐字一致：升级后没动过设置的用户行为不变。
• 「默认英文」档不注入思考语言条款，模型是否仍用中文思考取决于模型自身。

验证是否生效

profile 由命令行启动时（web、tui 等）：

dsh --profile <profile 名> --dump-config | grep dsh-think-zh

会话内：新建会话，在轨迹视图（先在 设置 → 通用设置 打开「代码工作工具」）里看 system prompt 是否出现「语言要求（强制）：」这一段；打开设置切档位，该段文本应随之变化。

输入输出示例

中文提问（默认「简体中文」档）：

用户：请帮我写一个计算斐波那契数列的 Python 函数。

思考（reasoning，简体中文）：用户需要一个计算斐波那契数列的 Python 函数。可以用迭代或递归实现……
回答（text，简体中文）：下面是一个使用迭代实现的 Python 函数：
def fibonacci(n): ...

英文提问（默认「简体中文」档：思考仍为中文，回复跟随英文）：

用户：Write a Python function to compute the Fibonacci sequence.

思考（reasoning，恒为简体中文）：用户要求一个计算斐波那契数列的 Python 函数。回复语言应跟随提问使用英文，代码保持原样……
回答（text，跟随提问使用英文）：Here is an iterative Python implementation:
def fibonacci(n): ...

以上是机制示意，实际输出取决于模型：思考语言由所选档位约束，回复语言跟随提问语言，代码与标识符保持原文。

配置项

字段	类型	默认	说明
injectPrompt	boolean	true	是否把指令注册为 system prompt section（静态通道）
injectionText	string	''	自定义指令文本；非空时整段生效，「思考语言」档位被忽略
injectPerTurn	boolean	false	是否每轮在用户消息前额外注入（高显著通道）
thinkingLanguage	zh | en	zh	设置页写入的档位；大小写与首尾空白不敏感，一般无需手改

想在配置文件里直接改，就在 ~/.dsh/profiles/<profile 名>/cordis.patch.yml 的 dsh-think-zh 条目下追加 config：

- id: dsh-think-zh
  name: 'dsh-think-zh'
  config:
    injectPrompt: true
    injectionText: ''           # 非空时整段生效，档位被忽略
    injectPerTurn: false
    thinkingLanguage: zh        # 大小写/首尾空白不敏感

injectPerTurn：每轮注入（可选）

静态 system prompt section 对多数模型已经够用，但部分模型对静态 section 的服从弱——实证：kimi k3-256k 在默认 effort 档、思考已开的情况下仍从第一步起用英文（2026-09-10）。这类场景把 injectPerTurn 打开，插件会在每轮请求的第一条用户消息前，以用户消息形态（与对话 steering 同一高显著通道）前置同一指令，文本同样跟随「思考语言」档位。

• 注入形如 [dsh-think-zh/preturn] <指令文本>，带幂等标记：多 pre-step 调用不会重复叠加，也不会扩散到后续文本块或后续用户消息。
• 依赖宿主的 agent/pre-step 瀑布；宿主不提供时记一条 dsh-think-zh: 开头的 error 日志并跳过，静态通道不受影响。
• 两条通道独立：injectPrompt: false 时，仍可只用 per-turn 通道投递指令。

工作原理

环节	机制
加载依赖	插件声明 inject: [systemPrompt]，cordis 等 systemPrompt 服务就绪后才执行 apply
注入点	ctx.systemPrompt.section() 注册 dsh-think-zh/language（order 2，位于 persona 之后、一方工具指引之前）
生效时机	每次请求组装 system prompt 时现读；section 的 text 以提供者形态注册，volatile 配置改完立刻反映到下一份请求
设置行	client.js 注册 settings.general.item（order 5，位于「语言」0 与「外观」10 之间），取值经官方 settings 服务写入 profile 条目 config
持久化	thinkingLanguage 是 schemastery .volatile() 字段：改完即时生效、不重挂插件
运行时开销	无检测、无缓冲、无写回；token 成本就是那段指令（简体中文档 90 字符，默认英文档 64 字符）

section() 的注册在宿主侧是 cordis effect，随插件所在 context 卸载自动回收。

兼容性

能力	起始宿主版本
静态 system prompt 注入（injectPrompt、injectionText）	0.1.0-rc.6
每轮用户消息注入（injectPerTurn，需 agent/pre-step 瀑布）	0.1.2
「思考语言」设置项（需 settings 服务 volatile 字段，schemastery ≥ 3.18.3）	0.1.7

常见问题

装完没反应？ 先重启 DSH——插件在启动时组合，漏重启是最常见原因；再用上面的 --dump-config 确认 dsh-think-zh 条目确实在 profile 里。

思考还是英文？ 先确认设置里选的是「简体中文」；已经是而模型仍不服从，说明它对静态 section 服从弱，打开 injectPerTurn。

设置里没有「思考语言」行？ 宿主低于 0.1.7，升级 DSH。

设置行显示「保存失败，请重试」？ profile 目录写入失败，检查 ~/.dsh/profiles/<profile 名> 的写权限后重试。

轨迹视图在哪？ 先在 设置 → 通用设置 打开「代码工作工具」。

开发与贡献

npm install
npm test        # vitest 单元测试（含 client bundle 契约）
npm run typecheck
npm run build   # tsc 构建 host 半到 lib/

client.js 是手写的零构建 bundle（window.__ModuleLoader__.load），由宿主直接交给浏览器，不经 tsc；它的契约（模块 id、inject、注册参数、档位表与 host 常量一致）由 tests/client.spec.ts 锁定。改过 src/ 必须重新构建并提交 lib/——仓库里的产物就是安装时被加载的那一份，CI 有硬守卫。

贡献流程、代码地图与硬约束见 CONTRIBUTING.md；Bug 与功能建议走 Issues。

许可

MIT © Len7183