前言¶
DeepSeek Harness（DSH）的 Web 界面默认以英文文案为主。若你在土耳其语环境下使用 DSH，或需要向土耳其语用户交付同一套 Harness 能力，单靠改浏览器翻译并不稳定：占位符、Markdown 与分隔符容易错位，且无法与 DSH 自带的语言切换机制对齐。
社区维护者 mkfeyman 发布的 dsh-turkish-locale 是面向 DSH Web UI 的土耳其语（Türkçe）语言包。它基于文档化的客户端 locale API 注册 tr 语言，不修改打包应用、无需重新构建。下文介绍其能力、安装方式与使用注意点。
这是什么¶
dsh-turkish-locale 同时作为 DSH 客户端插件与 bundle（含 dsh.bundle.patch）发布，许可证为 MIT。仓库：https://github.com/mkfeyman/dsh-turkish-locale；社区目录页：https://www.skillhub.cn/plugins/mkfeyman/dsh-turkish-locale。
package.json 中声明的 DSH 引擎范围为 >=0.2.1-rc.3 <0.3.0，当前包版本为 1.0.0。
核心功能¶
语言包在浏览器端通过 ctx.locale.addLanguage 与 ctx.locale.register 注册 tr，并以 en 作为回退语言。
翻译规模与覆盖范围（与 README 一致）：
- 64 个 namespace，2,910 条字符串；
- 对应 DSH 0.2.1-rc.3（commit
be72761）随客户端分发的英文 UI 文案的 100%； - 占位符、Markdown、分隔符与标点按源字符串校验保留。
启用后，界面语言选项中会出现 Settings → General → Language → Türkçe（土耳其语界面下为 Ayarlar → Genel → Dil）。选择会写入 profile 的 cordis.patch.yml 中的 locale.preference；<html lang> 随当前 locale 变化，英土双向切换可在运行中的 Web GUI 内即时生效（在 HMR 可用时无需整应用重启）。
词典来源：从 DSH 0.2.1-rc.3 已安装客户端包中的英文源提取，按 namespace 翻译并在生成 bundle 前逐条核对占位符集合；相关提案见 DeepSeek Harness 仓库 Discussions #11015。
安装与启用¶
安装前请知悉：插件以当前 DSH 进程权限运行，安装前应自行审阅源码与 MIT 许可证。DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；下文命令与 URL 均来自仓库 README。
从插件市场（Discover）安装¶
- 在 Plugins → More → Discover 中将下列地址添加为索引源（Settings → Plugins 也可查看已配置源）：
https://raw.githubusercontent.com/mkfeyman/dsh-turkish-locale/main/market-index.json
- 在市场中安装 「Türkçe dil paketi」。安装器会固定为
git+https://github.com/mkfeyman/dsh-turkish-locale#<commit>，因此本机 pnpm 可用的 Git 为必要条件。
手动安装¶
- 将本包复制到某 DSH profile 的
node_modules（README 以 Windows PowerShell 为例）：
Copy-Item -Recurse dsh-turkish-locale "$HOME\.dsh\profiles\desktop\node_modules\"
- 在同一 profile 的
cordis.patch.yml中增加 bundle 行，并可默认 locale 为tr：
- insert:
- id: tr-locale
name: dsh-turkish-locale
- id: locale
config:
preference: tr
- 若已启用 HMR，语言包可在运行中的应用中激活；否则需重启应用或重新加载 Web GUI。在 Ayarlar → Genel → Dil（或英文路径 Settings → General → Language）中切换语言。
典型用法与仓库结构¶
典型流程：安装 bundle → 在通用设置中选择 Türkçe → 确认 locale.preference 与界面文案一致。无需单独调用 API；客户端入口为 lib/client.js，向 @deepseek-ai/dsh-client-locale 注入注册逻辑。
| 路径 | 作用 |
|---|---|
lib/client.js |
浏览器 bundle：注册语言与词典 |
lib/index.js |
宿主侧占位（Loader 行） |
cordis.patch.yml |
添加 tr-locale 行并可默认 tr |
locales/tr.json |
namespace → key → 土耳其语文案 |
market-index.json |
插件市场索引（format 1） |
适用场景与注意¶
适合：需要在 DSH Web UI 使用完整土耳其语界面、且 DSH 版本落在 0.2.1-rc.3 至 <0.3.0 区间的用户或集成方。
注意：
- 语言包覆盖以 0.2.1-rc.3 英文基线为准；升级 DSH 主版本或客户端文案变更后，需关注插件是否发布兼容更新。
- 市场安装依赖 Git；手动安装需正确 profile 路径与
cordis.patch.yml补丁语法。 - 分类为 客户端 插件，仅影响 Web UI 文案与 locale 行为，不替代服务端配置。
结尾¶
dsh-turkish-locale 用社区插件方式补齐 DSH Web UI 的土耳其语体验：64 个 namespace、2910 条字符串、MIT 许可，与官方 locale 扩展点一致。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
