思考语言 aymidasing/dsh-thinking-lang

dsh-thinking-lang

面向 DeepSeek Harness（dsh-desk） 的插件：设置智能体内部推理（思考）所用的语言。

目标环境： DeepSeek Harness 0.2.0-rc.2+（dsh -V）。License： MIT。

本项目的代码、文案与文档均由 DeepSeek 生成（在人工指导下迭代产出）。它不是 DeepSeek Harness 官方组件，未经官方审核；使用前请自行阅读源码。

它做什么

在设置 → 通用里新增一行「思考语言」，位于宿主自身的语言设置项下方。整行只有一个下拉框：

| 配置项 | 取值 | 作用 |
| 思考语言 | 自动 / 简体中文 / 繁體中文 / English | 内部推理与规划所用的语言 |

auto 是怎么判定的

选「自动」时，按顺序取第一个能映射到语言目录的来源：

| 顺序 | 来源 | 取值方式 |
| 1 | 操作系统语言 | POSIX 环境变量 LC_ALL / LC_MESSAGES / LANG；Windows 上这些通常为空，改用 Intl.DateTimeFormat().resolvedOptions().locale（跟随系统区域设置） |
| 2 | DSH 界面语言 | 设置服务里 locale 命名空间的 preference 字段 |
| 3 | 兜底 | 硬编码的 zh-CN（FALLBACK_TAG） |

标签先被清洗成 BCP-47（_→-，去掉 .UTF-8、@latin 这类 POSIX 修饰），再交给平台自带的 Intl.Locale 拆成语言／文字／地区三段，不手写标签文法。查找从最具体到最一般：完整标签 → 带文字的 → 带地区的 → 裸主标签，所以 en-GB 会落到 en。

中文是唯一的例外——两个条目共用 zh 这个主标签，决定简繁的是文字而不是地区。这部分交给 CLDR：maximize() 会把短标签省略的文字补出来，Hant 判为繁體、其余判为简体。于是 zh-TW/zh-HK/zh-MO/zh-Hant 都是繁體，zh/zh-SG/zh-Hans 都是简体，两张对照表都不需要。

| 系统 | 界面 | 结果 |
| zh-CN | en-US | 简体中文 |
| en-US | zh-CN | English |
| fr-FR（目录里没有） | en-US | English（落到下一级） |
| 取不到 | 取不到 | 简体中文 |

在下拉里显式选了某个语言时，那个选择优先于上面全部三级，与系统/界面语言无关。

提示词是怎么注入的

一份提示词被拆成两半，注入两个不同的位置——区别不在内容，而在求值时机。

| | systemPrompt.section | systemPrompt.context |
| 由谁生成 | sectionText | contextText |
| 内容 | 一行规则，直接写出语言名 | 只有语言名加一句强调 |
| 随什么变化 | 随思考语言变 | 随思考语言变 |
| 求值时机 | 每会话组装一次 | 每次模型调用重新求值 |
| 顺序 | order: 1 | order: -10 |

实际注入的文本

两段文本都由 src/core.ts 生成。这里是公开文档，不转载注入原文——它们会直接进入模型上下文，属于实现细节，只以「去看代码」的方式给出入口。

| | systemPrompt.section | systemPrompt.context |
| 生成函数 | sectionText | contextText |
| 形状 | 一行规则，句中嵌入所选语言的英文名 | 一个固定标记，后接所选语言的英文名与一句强调 |
| 长度 | 124–136 字符（每种语言一份） | 53–65 字符 |
| 语言名形式 | 英文名，如 Simplified Chinese / Traditional Chinese / English | 同左 |

要看注入原文，读 src/core.ts 里这两个函数；改完 npm run build 即可生效。

这个拆分带来两个直接结果：

1. 切语言在下一轮立即生效 —— context 每一步都重新求值，不必重启或新开会话。
2. section 里那个语言名要等新会话 —— 它在会话组装时定稿。同一个会话中途改语言，context 那行会立刻跟着变，但 section 里的名字要等下次组装才跟上。

两段都带语言，是有意的冗余：section 是权威版本（位于 persona 之后、所有工具说明之前），context 只负责实时性。想去掉重复就删掉 context——代价是切语言必须新开会话。

顺序与优先级

- section 的 order: 1 紧跟在宿主的 persona 之后、第一个策略段之前——也就是渲染出来的 persona 那句话的下一行。
- context 的 order: -10 排在其它每步注入块之前。注意：section 与 context 属于两个不同的序列，两者的 order 数值不可直接比较。

取值依据是 DSH 自己的分段表：@deepseek-ai/dsh-system-prompt 里的 SECTION_ORDERS——身份 -1000、部署 persona 0、PLAN_POLICY 500、工具段从 1000 起。order: 1 正好落在 persona 与第一个策略段之间。

Token 开销（实测）

用 DeepSeek V3 的词表实测（@lenml/tokenizer-deepseek_v3，不计特殊 token）：

| 语言 | section | context |
| 简体中文 | 29 | 16 |
| 繁體中文 | 29 | 16 |
| English | 28 | 15 |
语言名本身只占 1–2 token，所以换语言对每轮开销几乎没有影响。

section 每会话一次，不随轮次增长；context 每轮一次。跑 100 轮：

| 语言 | section | context × 100 | 合计 |
| 简体 / 繁體 | 29 | 1600 | 1629 |
| English | 28 | 1500 | 1528 |

⚠️ 切换语言的缓存代价

这才是本插件唯一需要留意的开销，量级远大于上面那几十个 token。

DeepSeek 的上下文缓存自动生效、无需改代码，但它只认从第 0 个 token 起完全相同的前缀——官方原话：「只有当两个请求的前缀内容相同时（从第 0 个 token 开始相同），才算重复。中间开始的重复不能被缓存命中。」（API 上线硬盘缓存）

而 section 内嵌了所选语言的名字，位置又相当靠前（order: 1，紧跟 persona）。于是：

改一次思考语言，从 section 那一行往后的前缀全部改变——包括其余 system prompt（工具说明等）和全部对话历史，那一轮统统按「缓存未命中」计费。

差价是 50 倍（deepseek-flash 空闲时段：命中 0.02 元 / 百万 token，未命中 1 元 / 百万 token；高峰时段同样 50 倍。见模型 & 价格）。

context 那行同样随语言变化，只是它 inject 的深度不同、影响面可能小一些；两段中任何一段变了，从它往后的前缀都不再匹配。

好消息是一次性的：切完语言后新前缀会重新被缓存，从下一轮起恢复正常命中。所以代价约等于「重新算一遍完整上下文」这一次。

实用建议：选定一种语言就别频繁来回切，尤其别在一轮对话中间切。切换不影响正确性，只影响钱。

安装

npm install
npm run build
dsh plugin --profile desktop add .

装完重启 GUI。语言约束对新会话生效；切语言本身在已有会话的下一轮就生效。

构建

npm install
npm run check # typecheck + build

构建分两段：

1. tsc -p tsconfig.json 编译宿主端到 lib/；
2. tsdown 把客户端打成 CommonJS 到 client/client.raw.cjs，再由 scripts/wrap-client-bundle.mjs 套上 DSH 的 __ModuleLoader__ 工厂外壳，输出 client/client.js。

选 CommonJS 是为了让产物天生就是 require(...) 形态——DSH 的客户端工厂只提供 require，若先打成 ESM 就还得事后用正则把导入语句改回来。

Node（构建）需要 ^22.18.0 || >=24.11.0；插件运行时不依赖本机 Node。

目录结构

| 路径 | 说明 |
| src/core.ts | 语言目录、配置归一化、两份提示词生成。纯函数，无宿主依赖，客户端与宿主端共用。locale 解析走平台自带的 Intl.Locale |
| src/index.ts | 宿主入口：Config schema、section 与 context 注册、语言解析（含操作系统语言探测） |
| src/client/index.ts | 客户端入口：在 settings.general.item 插槽注册设置行 |
| src/client/panel.ts | 单行设置控件与样式 |
| src/client/locales.ts | 三套行文案（简 / 繁 / 英） |
| cordis.patch.yml | bundle patch，登记宿主入口 |
| PROVENANCE.md | 设置行样式的来源记录，以及从 app.asar 读宿主源码的方法（维护用） |
| lib/ · client/ | 构建产物（不入库） |

依赖面

| 类型 | 包 | 说明 |
| 运行时 | @deepseek-ai/schemastery | DSH 的设置 schema 格式，export const Config 必需 |
| 构建期 | typescript · tsdown · @types/node | 只在 npm run build 时用到 |
| 宿主提供 | @deepseek-ai/dsh-client-ui-primitives | 客户端用 tryRequire 按需取用；宿主没有时降级为原生控件 |

不依赖任何 DSH 类型包。 宿主上下文由 src/index.ts 里的本地 HostContext 接口结构化描述，所以包里没有 @deepseek-ai/cordis（既不是 dependency 也不是 peerDependency）。

宿主端对包只暴露四个导出：name、inject、Config、apply——其余全部是模块内私有。

设置行文案的语言（预留功能，默认关闭）

设置行的文案可以跟随思考语言而不是界面语言——选 繁體中文，这一行的标题与说明就变繁体。整套机制已经实现并接线完毕，但当前不生效。

| 开关 | src/client/locales.ts 里的 COPY_FOLLOWS_THINKING_LANGUAGE，默认 false |
| 启用 | 改成 true → npm run build → 重启 GUI |
| 还要改别的文件吗 | 不用。三套字典与选取函数 dictionaryFor 都在 locales.ts 里 |

因为开关是编译期常量，构建时 rolldown 会把这条死分支连同繁体字典一起摇掉——当前产物里没有这些文案，行为与「只跟随界面语言」完全一致。语言选择器的选项始终显示各语言的本族语名（简体中文 / English），所以即使文案换成了你不熟悉的语言，也能从同一个下拉里切回来。

已知限制

- section 的位置绑住宿主的分段表：order: 1 取自 @deepseek-ai/dsh-system-prompt 的 SECTION_ORDERS（persona 0、PLAN_POLICY 500）。宿主若调整那张表，改 src/index.ts 的 SECTION_ORDER。
- 设置行的位置绑住宿主语言项的 order：宿主语言行注册在 order: 0（@deepseek-ai/dsh-client-locale），本插件用 order: 1 紧贴其后。宿主若调整，改 src/client/index.ts 的 ROW_ORDER 即可。
- 只支持三种思考语言：简体中文、繁體中文、English。要增删语言，改 src/core.ts 的 CATALOGUE，并在 src/client/locales.ts 补上对应文案。
- 没有聊天命令：切换语言只走设置页。如需 /thinking-language，可参照 dsh-thinking-language 的命令实现补上。
- auto 依赖运行时能报出系统语言：Linux/macOS 走环境变量，Windows 走 Intl。两者都拿不到时会静默落到界面语言，再不行才是 zh-CN——顺序与取值方式见上文「auto 是怎么判定的」。
- 与其它语言插件互斥：本插件的插件 id 与设置命名空间都是 thinking-language，与同名的思考语言插件无法共存；包名 dsh-thinking-lang 与 dsh-thinking-language 也极为接近，注意区分。

License

MIT，见 LICENSE。