dsh-think-zh-expand-eac

DSH 思考增强插件（EAC 定制版）：让 agent 的思考（reasoning）与回复强制使用中文，并把界面残留的硬编码英文（Thinking / Tool Call 等）中文化。

本仓库是派生版本（fork），已移除全部会接管对话渲染器的显示功能。

引用与来源声明

本仓库派生自 baosfeng/my-dsh-plugins 中的 plugins/dsh-think-zh-expand， 原作者：@baosfeng，许可证 MIT。

• 上游版本：dsh-think-zh-expand@0.4.8
• 本派生版本：dsh-think-zh-expand-eac@1.0.0
• 上游许可证：MIT（原样保留，版权归原作者）

本版仅按需裁剪上游的显示层功能，未修改上游的强制中文提示词与中文化词表逻辑。 若你需要上游的完整功能（思考块默认展开、自绘渲染器），请直接使用 上游插件。

为什么会有这个 EAC 版

上游 dsh-think-zh-expand 会用 priority: -1 接手 conversation.chat.node 的 assistant-step 渲染器，自行绘制思考块（默认展开、流式强制展开）。

这会与任何折叠类插件发生结构性冲突：

折叠插件	冲突原因
dsh-turn-fold	同样以 priority: -1 抢占 assistant-step 座位，两者只能有一个生效
dsh-auto-collapse	依赖 DOM 锚点 data-chat-flow-key / data-turn-process 定位折叠目标，而上游自绘的思考块不产生这些锚点，导致其折叠逻辑对该段失明

结果是：装了折叠插件却「思考收不起来」或折叠栏失效，且不报错——属于静默失效，很难排查。

本版的做法：把渲染器完全交还宿主，只保留不碰 DOM 结构的功能。思考块的折叠表现 由宿主与折叠插件决定，本版不再干预。

功能

1. 思考强制中文（Server 端）✅ 保留

通过 systemPrompt.section 注入一条固定系统提示（order: -90，persona 之前最先读到）， 内容为结构化语言规则（最高优先级，不可被上下文覆盖）：

强制要求：思考过程（reasoning）必须用简体中文书写；最终回复默认简体中文（跟随用户语言）。 关键场景：英文错误消息/日志/堆栈不改变语言；大量英文上下文不"带偏"输出。 代码与术语：代码、命令、文件路径、标识符与技术术语保持原文，不翻译。

无论用户用什么语言提问，模型的思考过程与回答都使用中文。

2. 界面标签中文化（Client 端）✅ 保留

官方 UI 的 zh 字典本身未翻译完（如 toolbar.duration: "Duration"），且存在硬编码英文 （Thinking、Tool Call、ASSISTANT 等）；locale.register 对已注册的同名 ns+locale 字典重复注册会抛错，无法经 locale 服务补译。

因此本插件在 DOM 层做精准文本替换：只匹配「完全等于」词表的叶子文本节点 （排除 pre/code/输入区，避免误伤代码块与消息正文），MutationObserver 跟随 React 重渲染持续生效。同时覆盖工具名、工具描述、工具目录与卡片标题/摘要的中文化。

该功能不改变 DOM 结构，只改写文本节点内容，因此不与折叠插件冲突。

与上游的差异（已移除的功能）

以下功能全部移除，因为它们要么直接抢位、要么产出折叠插件无法识别的 DOM：

已移除	说明
assistant-step 渲染器注册	上游以 priority: -1 抢占 conversation.chat.node 座位
ThinkBlock	上游自绘思考块（默认展开、流式强制展开）
AssistantStepView / renderBlocks / imageGroupEnd	上游自绘的 assistant 节点与图片分组渲染
stripControlTags	仅供上述渲染器使用的控制标签剥离
官方 SVG 图标内联（chevronDownIcon / thinkIcon）	仅供上述思考块使用
.dsh-think-zh-expand-* 样式表	仅供上述思考块使用
dsh-md-render 跨插件依赖	上游经 dsh.client.external require 其 MarkdownView

行为差异

场景	上游	本版
思考块默认状态	展开	交还宿主（通常为收起单行摘要）
流式中思考块	强制展开	交还宿主
思考内容 Markdown 渲染	由本插件经 MarkdownView 渲染	由宿主内置渲染
工具调用行	上游自绘	交还宿主（丢失上游的部分自绘样式）
与折叠插件共存	❌ 冲突	✅ 无冲突

兼用性说明（section 名已改名）

上游注册的 system-prompt section 名为 dsh-think-zh，本版改为 dsh-think-zh-eac。

原因：DSH 对同一层重复 name 的 section 注册会抛错。改名后，上游版与本版即使同时启用 也不会导致启动失败。但两者注入的是同一段中文指令，功能完全重复，仍建议只启用其一。

安装

DSH Desktop (EAC)

在 DSH Terminal 中针对当前 profile 安装：

dsh plugin --profile web-desktop add github:jing-hy/dsh-think-zh-expand-eac
dsh --profile web-desktop --dump-config
pnpm list dsh-think-zh-expand-eac --depth 0

配置输出应包含 id: think-zh-expand-eac 与 name: dsh-think-zh-expand-eac。 验证后重启 DSH Desktop。

普通 DSH CLI / Web

dsh plugin --profile web add github:jing-hy/dsh-think-zh-expand-eac
dsh --profile web --dump-config

从源码安装

git clone https://github.com/jing-hy/dsh-think-zh-expand-eac.git
dsh plugin --profile web-desktop add link:<仓库路径>

与折叠插件一起使用

本版设计目标就是与折叠插件共存。推荐组合：

dsh plugin --profile web-desktop add dsh-auto-collapse   # 或 dsh-turn-fold
dsh plugin --profile web-desktop add github:jing-hy/dsh-think-zh-expand-eac

不要同时启用 dsh-auto-collapse 与 dsh-turn-fold——它们都通过 DOM/渲染器操作对话区， 机制互相致盲。二选一。

开发

npm run typecheck   # tsc 类型检查（server + client 两份配置）
npm run build       # 重新生成 lib/index.js 与 lib/client.js
npm test            # host 端冒烟测试（Node 内置 test runner）

lib/client.js 是构建产物，必须提交——DSH 直接提供该文件，不在安装时构建。 修改 src/client/index.ts 后务必重新构建并提交产物。

构建流程

1. tsc -p tsconfig.json → lib/index.js（server 端）
2. tsc -p tsconfig.client.json → lib/.client-build/index.js（client 端 CommonJS 单文件）
3. node scripts/build.mjs 把 client 编译产物注入 lib/client.src.js 模板的 /*__CLIENT_BUNDLE__*/ 占位符 → lib/client.js

上游构建还需从 dsh-shared 注入共享图标（/*__PART_ICONS__*/）。 本版已移除该步骤，scripts/build.mjs 会在此占位符残留时直接报错，避免静默产出坏包。

目录结构

路径	职责
src/index.ts	server 端：system-prompt section 注册
src/types.d.ts	DSH 运行时类型最小契约
src/client/index.ts	client 端：界面中文化（词表 + DOM 精准替换）
lib/index.js	server 端构建产物（提交）
lib/client.js	client 端构建产物（提交，DSH 实际提供）
lib/client.src.js	client bundle 模板（含 __CLIENT_BUNDLE__ 占位符）
scripts/build.mjs	构建脚本：编译 + 注入模板
cordis.patch.yml	bundle patch：把插件行挂载进 profile
test/host-smoke.mjs	host 端冒烟测试

许可证

MIT。本仓库保留上游 MIT 许可证 与版权声明。

上游项目：baosfeng/my-dsh-plugins · 原作者 @baosfeng