dsh-plugin-zh-cn
将已安装的 DeepSeek Harness 插件标题和描述渲染为简体中文，在启动时由 DSH 自有的 LLM 服务翻译，并缓存到本地 JSON 文件中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Daneel0001/dsh-plugin-zh-cn#ae590eeab314af36c1b9d215dd3539f8972f890fPlugin Zh Cn 以 dsh-plugin-zh-cn 发布，当前版本为 2.0.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 DeepSeek Harness（DSH）已安装插件的显示名与描述，在启动时用 DSH 设置里选定的模型（agentDefaultModel）自动翻译成简体中文，并缓存到本地。
没有硬编码词典，不调用任何第三方翻译 API，不碰 DOM。
安装前 billion-context A context-compression plugin — small context windows…
安装后 十亿级上下文插件 小上下文窗口即可容纳超大仓库上下文
English:
dsh-plugin-zh-cnrenders installed DSH plugin titles and descriptions in Simplified Chinese. At startup it reads a local translation cache, projects{ en }plugin metadata into{ en, zh }so DSH's ownresolveText()renders Chinese, and asks DSH's built-inllmservice to translate any installed plugin the cache does not know yet. No third-party API, no built-in dictionary, no DOM manipulation. See English summary.
| 界面语言 | 插件标题 | 插件描述 |
|---|---|---|
| 中文 | 中文标题 | 中文描述 |
| English / 其它 | 与安装前逐字相同 | 与安装前逐字相同 |
entry.enabled 与 pluginManager.setPluginEnabled，
和元数据毫无交集。zh 的插件（含全部官方内置插件）一律跳过，
一个字节都不改。已经自带中文的内置选项（「语音输入」「终端」……）自然不会被碰。ctx.effect 的清理回调原样撤销。在 DSH 桌面版的「插件」页点「添加插件」，填入本仓库地址：
github:Daneel0001/dsh-plugin-zh-cn
装好后 重启 Harness。客户端模块图是在渲染页面时写进 index.html 的，
仅刷新页面不会把新插件送进已打开的窗口。
# 1. 把 tgz 放进 profile 的 plugins 目录
Copy-Item .\dsh-plugin-zh-cn-2.0.0.tgz "$env:DSH_PROFILE_DIR\plugins\"
# 2. 在 <profile>/package.json 里登记两处
# dependencies: "dsh-plugin-zh-cn": "file:<profile>/plugins/dsh-plugin-zh-cn-2.0.0.tgz"
# dsh.profile.bundles: 追加 "dsh-plugin-zh-cn"
# 3. 用 pnpm 真正安装（这一步才会写入 lockfile 与 .modules.yaml）
node "$pnpm" install --dir "$env:DSH_PROFILE_DIR"
必须走第 3 步。 只把 tgz 放进
plugins/、再手工复制目录到node_modules/是不够的： DSH 组合 profile 时以 pnpm 的安装结果为依据，未进入pnpm-lock.yaml/node_modules/.modules.yaml的包会被静默跳过。
本次启动仍显示英文。
local-cache.json 交给 seedFiles
（格式见 examples/local-cache.example.json）。DSH 的插件列表渲染链是（均为 app.asar 内官方源码）：
客户端 UI 组件 PluginInventorySettingsTab
└─ ctx.remote.pluginInventory.list() dsh-client-ui-settings-plugin-inventory/lib/client.js
└─ 宿主服务 pluginInventory.list() dsh-host-plugin-inventory/lib/index.js
└─ readPluginInventory(ctx)
├─ ctx.loader.entries() ← 「已安装」的插件行
└─ ctx.get('pluginPackages').metaOf(name, base) → { title, description }
而屏幕上真正出现的文字，只在客户端这一个出口被解析：
// dsh-client-locale/lib/client.js
resolveText(text) {
if (typeof text === 'string') return text;
return this.fallbackChain(this.snapshot.active)
.reduceRight((resolved, locale) => text[localeKey(locale)] ?? resolved, text.en);
}
LocalizedText = string | { en: string, [locale]: string } —— 中文界面取 zh，英文界面取 en。
这正是官方内置插件显示「智能体团队」而英文界面仍显示原文的机制。
所以本插件只做一件事：在数据层把 meta.title / meta.description 从 { en } 补成 { en, zh }。
包装两处返回值，任一生效即可：
| 目标 | 位置 | 说明 |
|---|---|---|
pluginPackages.metaOf | dsh-app-boot 的 cordis Service | readPluginInventory 的直接取数处 |
pluginInventory.list | dsh-host-plugin-inventory 的 Remote 网关 | 界面调用的入口，兜底 |
事后补救。React 每次重渲染都会把改过的文本节点覆盖回去，需要持续对抗； 而且一旦插件的元数据或 DOM 结构稍有变化就容易误伤布局。 数据层注入则从根上解决问题：DOM 从头到尾就没有被改过，中文是 DSH 自己渲染出来的。
运行时缓存位置（原子写入：先写 .tmp 再 rename）：
<DSH_PROFILE_DIR>/dsh-plugin-zh-cn/local-cache.json
# 例如 C:\Users\<你>\.dsh\profiles\desktop\dsh-plugin-zh-cn\local-cache.json
{
"version": 2,
"generator": "dsh-plugin-zh-cn",
"updatedAt": "2026-10-16T10:43:30.000Z",
"entries": {
"billion-context": {
"en": { "title": "billion-context", "description": "A context-compression plugin — …" },
"zh": { "title": "十亿级上下文插件", "description": "小上下文窗口即可…" },
"model": "deepseek/deepseek-chat",
"translatedAt": "2026-10-16T10:43:30.000Z"
}
}
}
en 是英文指纹，指纹没变就一个请求都不发，变了才重译。{ "<包名>": { "title": "…", "description": "…" } }
会被当作中文译文直接吸收，可以作为初值平滑迁移。local-cache.json 与 seedFiles 都是初值，
运行时缓存里的同键条目优先，绝不会被清空覆盖。只用 ctx.get('llm').stream(...)，模型取 ctx.get('agentDefaultModel').currentSelection()。
一次请求同时把名称与描述交给模型，要求它只回一个 JSON：
系统提示词（要点）
只输出 {"name":"<中文名称>","desc":"<中文描述>"}，不要解释、不要 Markdown 围栏
名称 ≤ 12 个汉字；描述 ≤ 40 个汉字、一句话
API / Token / MCP / SSH / Git / JSON / LLM 等专有名词照抄不译
收到回复后会先校验再落盘：必须能解析出 JSON、译文必须真的含中文。 不满足就当作失败，保留英文原文。
- id: zh-cn-plugin-locale
name: dsh-plugin-zh-cn
config:
enabled: true # 总开关
strict: true # 名称+描述都有译文才写入缓存
timeoutMs: 60000 # 单条翻译超时（描述很长的插件要给足时间）
maxTokens: 4096 # 单条翻译输出上限（推理型模型可能先吐思考再给 JSON）
provider: '' # 留空 = 用「设置 → 模型」里的默认模型
model: ''
cacheFile: '' # 留空 = <profile>/dsh-plugin-zh-cn/local-cache.json
seedFiles: [] # 额外的缓存初值（绝对路径），只合并、不覆盖
maxPerStart: 500 # 每次启动最多新翻几个插件（默认实质上不限，一个全新 profile 也就几百条）
delayMs: 200 # 两条翻译之间的间隔
saveEvery: 8 # 每翻译成功几条落一次盘，中途退出不丢已完成的部分
retry: 3 # 每条最多尝试几次（设为 1 即关闭重试）
debug: false # 把每条翻译结果写进 debug 日志
package.json；不写入任何其它插件的目录。local-cache.json（及其 .tmp），位置就在插件自己的数据目录。warn 日志，不会影响 DSH 启动。在插件设置里关掉「插件简体中文化」，然后重启。
注入层随插件 fiber 一起卸载（ctx.effect 清理回调会还原被包装的两个方法）。
运行时缓存 local-cache.json 会留在 profile 里，想彻底清干净就手动删掉
<DSH_PROFILE_DIR>/dsh-plugin-zh-cn/ 目录。
npm run check # 静态自检：清单、语法、可导入性，以及「不许硬编码词典」
npm run check:syntax # 只做语法检查
npm test # 47 项验收测试（含 8 项 apply 集成测试）
npm test 零依赖，在源码目录里就能跑完 47 项（含 8 项 apply 端到端集成测试）。
测试全部在系统临时目录里工作，永远不会碰真实 profile。
导出：apply、resolveConfig、DEFAULTS、inject、name，以及供测试使用的纯函数
resolveCacheFile、nearestProfileDir、collectInstalledPlugins、
extractEnglish、alreadyLocalized、resolveSelection、runTranslationPass。
lib/index.js 插件入口：读缓存 → 装注入 → 异步扫描翻译
lib/inject.js 数据层注入：包装 metaOf / pluginInventory.list（实例 + 原型，动态 this）
lib/cache.js local-cache.json 的读取、合并、原子写
lib/translate.js llm 调用、提示词、JSON 解析与中文校验
lib/text.js LocalizedText 工具与「值不值得翻译」的判定
locale/*.json 本插件自身的语言字典（自举）
cordis.patch.yml bundle 补丁：把插件行插进组合配置树
test/acceptance.mjs 47 项验收测试
scripts/check.mjs 静态自检（CI / prepack）
examples/ local-cache.json 格式示例
dsh-plugin-zh-cn renders the titles and descriptions of installed DSH plugins in
Simplified Chinese.
At startup the host half:
<profile>/dsh-plugin-zh-cn/local-cache.json synchronously, so the first render
already has Chinese for everything it has seen before;pluginPackages.metaOf and pluginInventory.list — the exact functions the
settings UI reads plugin metadata through — projecting { en } into { en, zh }.
DSH's own resolveText() then renders Chinese on a Chinese UI and the original English
everywhere else. No DOM node, class, style, or the enable/disable toggle is touched.llm service
(ctx.get('llm'), default model from agentDefaultModel) to translate any plugin the
cache does not know, one request carrying both the name and the description, and
expecting {"name": …, "desc": …}. Results are merged back into the cache.No third-party translation API, no built-in dictionary, no network calls beyond DSH's own model route. Any failure — timeout, bad JSON, non-Chinese output, model error — leaves the English original in place and logs a warning.