GaaaorkOrga/dsh-locale-fr

dsh-locale-fr — 为 DeepSeek Harness Web UI 提供的法语语言包

这是一个为 DeepSeek Harness（dsh）打造的语言包。
它让浏览器界面显示为法语：侧边栏、编辑器、命令菜单、执行轨迹、
设置及其所有子项——33 个命名空间中共 1163 条字符串。

它还附带一个可分离的第二层，用于翻译两个硬编码了中文标签的社区插件
（参见第三方层）。

截图与状态：本语言包每日针对 @deepseek-ai/dsh 0.1.1-rc.2 使用，
并设计为在 0.1.2+ 上继续可用。

为什么会有这个项目

dsh 仅提供 zh 和 en。这是一个发布选择，而非架构限制：
@deepseek-ai/dsh-client-locale 暴露了一个真正的扩展点。

- dsh 0.1.2-rc.1 及更高版本——ctx.locale.addLanguage({ id, label, fallback }) 接受任何
回退链最终指向 en 的类 BCP 47 标签。本语言包注册 fr，并且
Français 会出现在 设置 → 通用 → 语言 中，完全无需改动 UI。该选择
会以 locale.preference: fr 的形式持久化在 ~/.dsh/settings.yaml 中。
- dsh 0.1.1-rc.2 及更早版本——目录被冻结为 zh/en，且 setLocale("fr")
会抛出异常。此时本语言包会修补读取字符串的那个单一函数，
lookup(namespace, key)，使其优先查询法语。结果相同，但有一个注意事项：法语
始终处于激活状态，因为没有可供切换离开的目录条目。移除该插件即可
恢复英语。

本语言包会自动检测处于哪种情况。无需任何配置。

未翻译的键始终回退到英语，绝不会回退到中文。

安装

从本地检出安装
dsh plugin --profile web add "link:/path/to/dsh-locale-fr"

或直接从 git 安装
dsh plugin --profile web add "github:GaaaorkOrga/dsh-locale-fr"

仅限 Web 配置文件——它是一个浏览器端插件，并通过自己的
cordis.patch.yml 自行挂载，因此 headless 和 tui 配置文件永远不会引用它，启动时也不会加载它。

在 dsh 0.1.2+ 上，请在 设置 → 通用 → 语言 中选择 Français。或直接设置：

~/.dsh/settings.yaml
locale:
preference: fr

node_modules 下的任何文件都不会被修改。 dsh 更新不会抹掉翻译。

它是如何构建的

dictionaries/fr.json 是唯一的事实来源。lib/client.js 是由它生成的——
切勿编辑生成的文件：

python3 tools/build-client.py

添加或修正字符串

编辑 dictionaries/fr.json，重新构建，刷新页面。键与 dsh
注册的命名空间一一对应（conversation、chat、trajectory、settings.models 等）。

花括号中的占位符——{count}、{toolName}、{command}——是契约的一部分，
必须逐字复制，包括拼写。

在 dsh 升级后刷新

新的 dsh 版本会添加字符串。在你采集并翻译它们之前，它们会以英语显示：

1. 从你实际运行的 dsh 中采集英语字典python3 tools/harvest-dsh-dictionaries.py \
~/.npm/_npx//node_modules/@deepseek-ai  english.json

2. Diff against dictionaries/fr.json, translate the delta however you like,
merge it back into dictionaries/fr.json
3. Rebuild
python3 tools/build-client.py

从你运行的版本中采集，而不是从缓存中恰好存在的任何版本——命名空间
和键会在不同版本之间变动。这个错误在这里耗费了一轮调试。

移植到另一种语言

这套机制中没有任何部分是法语专用的：

1. 将 dictionaries/fr.json 复制为 dictionaries/.json 并翻译其中的值。
2. 在 tools/build-client.py 中，修改 LANGUAGE（id、用其自身语言表示的 label、fallback）
以及传递给 locale.register 的 "fr"。
3. 重新构建、安装，完成。

欢迎提交添加语言的拉取请求——请先在 issue 中说明，以便我们就能
它应该放在这里还是放在同级包中达成一致。

第三方层

@welsione/dsh-model-router（0.0.8）和 dsh-model-selector（0.5.0）从不调用 ctx.locale：
每个标签都是字符串字面量。任何语言的语言包都无法触及它们——这是
集成缺口，而非翻译缺口。路由器的整个设置页面保持中文，
而模型标签的标签在每个屏幕上都会显示。

dictionaries/third-party-fr.json 保存了 575 个中文片段及其法语译文，由
MutationObserver 对显示内容进行应用。是片段，而非句子：那些插件在运行时
组装它们的标签。

防护措施：

- 表意文字之外的任何内容都不会被触碰；
- 绝不触及输入框、代码块或对话记录内部；
- 只替换那两个插件已知的片段，因此任意文本——包括用户粘贴的
中文——从构造上就被保留不动；
- 生成的法语不包含表意文字，因此观察器会收敛；
- 只重新扫描被修改的节点，按动画帧批量处理。在答案流式输出时，
对每一帧进行全文档遍历曾针对 2 秒内 720 次变更进行过测量。

这一层是权宜之计。 上游请求已提交——
welsione/dsh-model-router#1、
DeepVite/dsh-model-selector#1——并且
一旦其中任何一个落地，它就应该被删除。要立即禁用它，请清空该文件：
bash
echo '{}' > dictionaries/third-party-fr.json && python3 tools/build-client.py

要为更新的插件版本重新生成它：
bash
python3 tools/harvest-hardcoded-cjk.py \
~/.dsh/profiles/web/node_modules/@welsione/dsh-model-router/lib/client.js \
~/.dsh/profiles/web/node_modules/dsh-model-selector/lib/client/index.js > runs.json

已知缺口

任何语言包都无法触及，因为它们不经过 locale 注册表：

- 斜杠命令描述（/compact、/export 等）——由宿主提供。
- 访问模式名称（只读 / 工作区写入 / 完全访问）——由宿主
标识符渲染而来。
关于 dsh 版本的一点说明

latest 已于 2026-09-04 从 0.1.1-rc.2 迁移到 0.1.2-rc.1。该版本从 @deepseek-ai/dsh-settings 中移除了
settingsNamespace 和 installSettingsSection，而 dsh-model-selector 和 @welsione/dsh-model-router 仍在导入它们。插件加载器会汇总这些失败，并且 dsh 会拒绝启动——它不仅仅是跳过这两个插件。
这与本包无关，但如果你运行那些插件就会遇到；在它们跟上之前，请固定你的 dsh 版本。

贡献

欢迎提交 issue 和 pull request——翻译修正、其他语言，或接手维护。代码注释为英文；词典是纯 JSON，除 Python 3 外无需任何构建链。

许可证

MIT——参见 LICENSE。

En français

Ce paquet met l'interface web de DeepSeek Harness en français : 1163 étiquettes réparties en
33 familles de textes. dsh ne livre que le chinois et l'anglais, mais son registre de langues
prévoit officiellement des langues supplémentaires — ce paquet s'y branche, sans modifier un
seul fichier livré par l'éditeur.

- Installation : dsh plugin --profile web add "github:GaaaorkOrga/dsh-locale-fr", puis
choisir Français dans Réglages → Général → Langue (dsh 0.1.2+). Sur une version
antérieure, le français s'applique tout seul.
- Corriger un mot : éditer dictionaries/fr.json, relancer python3 tools/build-client.py,
recharger la page. lib/client.js est engendré — ne jamais l'éditer à la main.
- Une étiquette non traduite retombe en anglais, jamais en chinois.
- Une seconde couche traduit l'affichage de deux modules communautaires qui écrivent leurs
libellés chinois en dur, hors du système de langues. Elle est provisoire : deux demandes ont
été déposées auprès de leurs auteurs.

Contributions bienvenues, y compris pour d'autres langues ou pour reprendre la maintenance.