土耳其语语言包 kaanyavuzer/dsh-plugin-locale-tr

dsh-plugin-locale-tr

CI
npm
license
topic

用于 DeepSeek Harness Web GUI 的土耳其语（tr）语言包。

DeepSeek Harness 自带英语和简体中文。本插件将土耳其语添加为第三种可选语言——无需修改任何核心文件。它使用了 @deepseek-ai/dsh-client-locale 为插件作者记录的语言包扩展点：

- ctx.locale.addLanguage({ id: 'tr', label: 'Türkçe', fallback: 'en' }) 添加目录条目，这正是让 Türkçe 出现在 设置 → 通用 → 语言 中的原因。
- ctx.locale.register(namespace, 'tr', dictionary) 为每个命名空间贡献翻译后的字符串。

覆盖范围

| 命名空间 | 45 |
| 字符串 | 1,870 / 1,870 |
| 目标构建 | DeepSeek Harness 0.1.7-rc.2 |

聊天、侧边栏、设置、工具结果、计划模式、子代理、会话轨迹、计划任务、插件管理器、语音输入、文档/Excel/PDF 预览以及键盘快捷键。

本语言包未包含的任何键都会沿语言链回退到英语，因此界面绝不会渲染出原始的键名。

安装

1. Clone the pack somewhere permanent
git clone https://github.com/jevgpt/dsh-plugin-locale-tr.git ~/.dsh/plugins/dsh-plugin-locale-tr

2. Put it where your profile can resolve it
mkdir -p ~/.dsh/profiles/desktop/node_modules/dsh-plugin-locale-tr
cp -r ~/.dsh/plugins/dsh-plugin-locale-tr/{package.json,lib,README.md,LICENSE} \
~/.dsh/profiles/desktop/node_modules/dsh-plugin-locale-tr/

// 3. Declare it in the profile manifest
// ~/.dsh/profiles/desktop/package.json
"dependencies": {
"dsh-plugin-locale-tr": "file:/absolute/path/to/dsh-plugin-locale-tr"
}

4. Add it to the profile's patch layer
~/.dsh/profiles/desktop/cordis.patch.yml
- insert:
- id: locale-tr
name: dsh-plugin-locale-tr

必须使用 insert 形式。 仅带有裸 id 的补丁会针对现有行；当没有匹配的行时，加载器会发出警告并跳过它，因此仅写 - id: locale-tr 会静默地不加载任何内容。

重启 DeepSeek Harness，然后在 设置 → 通用 → 语言 中选择 Türkçe。该选择是持久的，因此在后续重启后依然保留。将土耳其语报告为其语言的浏览器会在未做任何选择的情况下以土耳其语启动。

移除

从 cordis.patch.yml 中删除 - insert: 块并重启。土耳其语将从选择器中消失，界面会恢复到之前选择的语言。
工作原理

package.json dsh.client 声明：platform 为 "web"，注入 locale 包 lib/index.js 宿主部分——有意留空；它的存在是为了让该包成为客户端扫描能够解析的合法 Loader 行 lib/client.js 浏览器部分——生成产物，注册语言和词典 src/dictionaries/ 每个命名空间一个文件：本包翻译所依据的英文/中文源行，外加土耳其语值 scripts/ 提取、构建、验证和漂移检查工具 tests/ 完整性、占位符、清单和集成门禁

dsh 客户端模块加载器通过读取包的清单来发现它：一个带有 platform: 'web' 的 dsh.client 声明，外加一个 ./client 导出。随后它会提供该 bundle，并在客户端的 Cordis fiber 中调用其导出的 apply。

该 bundle 只调用已公开的公共 API。它不触碰任何私有内部实现，因此随着客户端演进它仍能继续工作——新的 UI 字符串只会回退到英文，直到在这里被翻译。

开发

需要 Node.js 22.19 或更高版本——与 dsh 的下限相同，也是测试脚本的 node --test glob 所需要的版本。无依赖。

npm run build # 从 src/dictionaries/ 重新生成 lib/client.js
npm run verify # 在加载器沙箱中加载 bundle 并断言其注册项
npm test # 词典完整性、占位符、CJK 和清单门禁
npm run test:all # verify + test

lib/client.js 是生成并提交的，因为 dsh 直接从已安装的包中加载它，而 npm 使用者不会运行构建步骤。CI 会重新构建它，如果提交的字节不同则失败。

集成检查

npm test 证明产物格式良好。若要进一步证明土耳其语确实能解析，请针对真实安装运行集成测试套件——它会取用应用自身的词典，在此之上加载本包，并驱动 locale 服务真实的查找算法：

npx --yes @electron/asar extract "/app.asar" .dsh-extract
DSH_EXTRACT=.dsh-extract npm run test:e2e

它断言所有 1,870 个已翻译的键都解析为所注册的土耳其语值，占位符仍能替换，某个功能命名空间会回退到通用词典，并且选择英语时仍渲染英语。没有 DSH_EXTRACT 时，该测试套件会带原因跳过，因此 npm test 在干净检出上保持通过。

跟上 dsh 的步伐

语言包绑定于某次构建所附带的副本：当 dsh 新增键时，它们回退到英文；当它删除键时，本包会残留死条目。两者都不会破坏任何东西，因此没有任何东西会自行暴露这种漂移。

提取一次 app.asar，然后与那套完整的包集合进行比较
npx --yes @electron/asar extract "/app.asar" .dsh-extract
npm run check:drift -- --packages .dsh-extract/dsh/node_modules/@deepseek-ai
npm run extract -- --packages .dsh-extract/dsh/node_modules/@deepseek-ai

当键缺失时，check:drift 会以非零状态码退出，因此它可作为 CI 门禁使用。extract 会重写 src/dictionaries/，同时保留所有现有翻译——只有真正新增的键会以 null 出现。翻译这些内容，然后运行 npm run build。

scripts/dsh-app.mjs 会自动定位已安装的应用，但桌面安装会将大多数包保留在 app.asar 内，因此请传入 --packages 以进行完整比较。部分集合会被检测到并以退出码 2 拒绝，而不会被报告为大规模漂移。

贡献

对土耳其语措辞的修正是最有价值的贡献。编辑 src/dictionaries/.json，运行 npm run build && npm run test:all，然后发起拉取请求。参见 CONTRIBUTING.md。

说明

- 与英文保持完全一致的值是有意为之：格式模板（{value}M）、单位后缀（{value} tok/s）、标识符（compact、export），以及土耳其语界面按惯例不翻译的技术名称（JSON、Terminal、Markdown）。
- 产品名称、模型 ID、命令标记和文件扩展名从不翻译。
- 该语言包是针对 DeepSeek Harness 0.1.7-rc.2 生成的。DSH 处于开发者预览阶段，其字符串会在各版本之间变化；更新后请运行漂移检查。

许可证

MIT。这是一个非官方社区语言包，与 DeepSeek AI 无关联。