Dingpenghui-good/dsh-conversation-language

dsh-conversation-language

DSH 插件：对话语言切换器

功能

允许在中文和英文之间切换对话语言。切换后 AI 将使用对应语言进行思考和回复。

特性

- 🌐 在设置界面中直接切换语言
- 🔄 动态更新 Persona（系统提示），无需重启即可生效
- 💾 设置通过 profile 的 Cordis patch 持久化（当前 profile 的 cordis.patch.yml）
- 🎨 匹配 DSH 原生设置界面样式

安装

⚠️ 安装完成后必须重启 DeepSeek Harness，插件才能生效。

方式一：使用 dsh 命令（推荐）

先 cd 到插件目录
cd /path/to/dsh-conversation-language
dsh plugin --profile web add .

方式二：手动安装

1. 克隆插件到 plugins 目录：
git clone https://github.com/Dingpenghui-good/dsh-conversation-language.git ~/.dsh/plugins/dsh-conversation-language
Windows: git clone https://github.com/Dingpenghui-good/dsh-conversation-language.git %USERPROFILE%\.dsh\plugins\dsh-conversation-language

2. 添加到 ~/.dsh/profiles/web/package.json：
{
"dependencies": {
"dsh-conversation-language": "link:C:/Users//.dsh/plugins/dsh-conversation-language"
},
"dsh": {
"profile": {
"bundles": [
// ... 其他 bundles
"dsh-conversation-language"
]
}
}
}

3. 运行安装：
cd ~/.dsh/profiles/web
pnpm install

4. 重启 DeepSeek Harness。

配置

方式一：通过设置界面

重启 DSH 后，打开 设置 → 通用设置，找到「对话内容语言」选项进行切换。

方式二：直接修改 profile patch

编辑当前 profile 的 cordis.patch.yml（Windows：%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml）：

- id: tool-conversation-language
config:
conversationLanguage: en   # 或 zh

然后重启 DSH。

2.0.0 起设置不再写入 ~/.dsh/settings.yaml：新架构中每个插件 entry 的
Config schema 由 settings 框架投影，写入目标是当前 profile 的 Cordis patch。

使用

切换语言后，AI 将自动以对应语言进行思考和回复，并让所有面向用户可见的文本保持同一语言——
包括工具调用的参数值（pwsh/bash 卡片上显示的 description、todo_write 的 content、
subagent 的 description、任务与作业名称等）。也可通过 get_conversation_language Tool
查询当前设置。

技术说明

| 项目 | 值 |
|------|-----|
| Settings Namespace | tool-conversation-language（= profile entry id） |
| Schema | { conversationLanguage: 'zh' \| 'en' }（volatile，默认 zh） |
| 默认值 | zh (中文) |
| Persona Override | system-prompt/assemble waterfall 拦截，按语言在 persona section 追加指令 |
| Tool 注册 | get_conversation_language — 查询当前语言设置 |

架构（DSH 0.1.7-alpha.2+）

- 宿主侧（src/index.ts）：声明 Config schema（z.union(['zh','en']).volatile().default('zh')），
settings 框架按 entry id 自动注册命名空间；system-prompt/assemble 拦截器在每次组装时
通过 ctx.settings.describe() 读取实时值，语言切换无需重启。apply 仅注入
['systemPrompt', 'tools']——settings 服务缺失时回退默认 zh。
- 客户端侧（src/client/）：通过 ctx.configForms.get('tool-conversation-language')
订阅宿主 settings 镜像，写入走 form.set('conversationLanguage', …)（经
remote.settings.mutate 落到 profile patch）；slot 行注册遵循
slots.inject('settings.general.item', …) 标准模式。
- 共享常量（namespace、语言类型）位于 src/shared.ts，保证客户端 bundle 不 value-import
任何宿主侧包（客户端 bundle purity gate）。

插件结构

dsh-conversation-language/
├── src/
│   ├── index.ts                    # Host 层：Config schema + persona 拦截 + tool
│   ├── shared.ts                   # 共享常量（namespace / 语言类型）
│   ├── client/
│   │   ├── index.ts                # Client 层：UI 注册（configForms + slots）
│   │   ├── LanguageSwitcherRow.tsx # React 组件
│   │   ├── LanguageSwitcherRow.module.css
│   │   └── settings-store.ts       # 状态管理
│   └── locales/
│       └── index.ts                # 国际化字典
├── lib/                            # 构建产物（pnpm run build 生成，安装时必须存在）
├── cordis.patch.yml                # Cordis bundle patch（entry id = settings namespace）
├── runtime-verify.mjs              # 宿主侧运行时回归
├── client-verify.mjs               # 客户端 bundle 结构回归
├── package.json
└── README.md

兼容性

| DSH 版本 | 插件版本 | 说明 |
|----------|---------|------|
| 0.1.2-rc.1 | ≤ 1.4.0 | 旧的单一 deployment:persona section（PERSONA_SECTION） |
| 0.1.5-rc.1 | ≥ 1.5.0 | persona 拆分为 prefix/suffix；宿主侧 settings 采用旧的 settings.register() 命名空间模式 |
| 0.1.7-alpha.2+ | ≥ 2.0.0 | settings 框架重构为 plugin entry Config schema + describe()/update()/mutate()；客户端 settingsScope 服务移除，改用 configForms。宿主侧 apply 不再注入 settings（缺失时回退默认值）；客户端 configForms.get() 订阅/写入 |

开发

cd dsh-conversation-language
pnpm install
pnpm run build   # 构建产物到 lib/；安装前必须执行此步

升级 DSH 大版本后，可对当前 node_modules 中的 @deepseek-ai/ 版本做回归：

node runtime-verify.mjs   # 宿主侧：tool 注册/执行、system-prompt/assemble 拦截，全部 PASS 且 exit 0 即表示兼容
node client-verify.mjs    # 客户端：bundle 模块面、slot 注册、configForms 通道

⚠️ 必须执行构建，插件运行时依赖 lib/ 下的构建产物，不能直接使用源码。

请使用 pnpm 安装依赖：@deepseek-ai/dsh-@0.1.7-alpha.2 等预发布版本在 npm 注册表中
处于「已发布但不可被 npm 解析」状态，npm install 会以 ETARGET 失败；pnpm 可以正常
解析并安装这些版本。

License

MIT