波斯语 RTL 语言包 MiRHaDi/dsh-persian-rtl

面向 DeepSeek Harness 的波斯语

فارسی · 由 MiRHaDi 开发的独立社区插件

将 فارسی 添加到 Web 语言选择器，翻译 六个命名空间中的 240 个字符串，并在选择波斯语时启用从右到左布局。代码、键盘快捷键、终端和编辑器容器保持从左到右。该插件使用公共 locale API，且没有运行时 npm 依赖。

实际 DeepSeek Harness Web 应用中的波斯语设置

安装

已在 Windows 上使用 DeepSeek Harness 0.1.6-alpha.2、Node 24.15.0 和已安装的 Google Chrome 153.0.8010.52 进行测试。这是一个 alpha API；不支持更早的版本，也不保证后续兼容性。请使用此版本的现有 DSH 安装。该插件不会安装或升级 DSH。

从 Releases 下载 dsh-persian-rtl-0.1.0.tgz。在已创建 Web 配置文件的情况下，运行：

dsh plugin --profile web add ./dsh-persian-rtl-0.1.0.tgz
dsh --profile web --no-open

打开 DSH 打印的本地地址，然后选择 Settings → General → Language → فارسی。未设置的语言偏好也会跟随波斯语浏览器区域设置，例如 fa-IR。你的显式偏好优先。选择语言不需要 API 密钥；模型请求仍需要常规的提供商设置。

如需进行隔离试用，请在启动 DSH 前将 DSH_HOME 设置为空目录。请参阅官方配置文件和插件指南。发布 tarball 包含构建后的客户端，安装时不需要构建脚本。

使用 dsh plugin --profile web remove dsh-persian-rtl 移除，然后重新加载页面。卸载会移除字典、选择器条目、监听器和样式表。离开波斯语时，会恢复之前的文档方向，除非其他所有者已更改它。语言和偏好持久化由 DSH 负责。

覆盖范围和限制

| 命名空间 | 字符串数 | 固定修订版本下的覆盖范围 |
| common | 37 | 完整 |
| settings.locale | 1 | 完整 |
| sidebar | 5 | 完整 |
| settings | 29 | 完整 |
| workspace | 64 | 完整 |
| chat | 104 | 完整 |

其他命名空间使用 DSH 的英语回退。这不是应用程序的完整翻译：入门引导、提供商配置、编辑器控件和若干设置面板仍为英语。截图有意展示此范围。未实现特定于区域设置的日期转换、波斯语数字、语音和终端 UI。日期保留上游日历。单数和复数计数模板保留其参数，并使用自然的波斯语计数名词。
RTL 使用文档方向和局部作用域 CSS，而不是字符串反转或插入方向控制字符。代码容器（pre、code、kbd、samp、xterm、Monaco 和 CodeMirror）使用 LTR 隔离。段落和文本区域使用 unicode-bidi: plaintext 来处理波斯语和拉丁字母混排文本。这些选择器并不能证明每一个第三方渲染器都支持 RTL；当某个渲染器不支持时，请报告一个可复现的组件。

验证

npm ci
npm run build
npm test

六个自动化测试针对固定的上游测试夹具覆盖了每一个字典键和占位符、真实的已发布 LocaleRuntime 行为、fa-IR 协商、英语回退、重复的语言更改、卸载/重新加载、方向恢复以及监听器释放。运行时测试加载已发布的客户端工厂；未使用的渲染依赖在被调用时会抛出错误，因此它们不会假装测试设置组件。

该插件还通过真实的 dsh plugin 命令安装，并在实际的 Web 应用中使用无头系统 Chrome 进行了测试：设置语言更改 fa → en → fa、lang/dir，且页面错误为零。LTR 代码/编辑器 CSS 已在实时插件下使用临时 DOM 测试夹具进行了检查；这些测试夹具在截图前已移除。未使用任何模型请求、生产账户或用户工作区。完整的对话执行以及每一个视口/主题均未测试。

对于浏览器冒烟测试，请单独安装 Playwright 1.62.1，或在本地安装但不保存它，将 DSH_TEST_URL 设置为你的隔离运行实例的本地已认证 URL，然后运行 node test/browser.cjs。这只会打开无头 Chrome。请对该 URL 保密。该测试仅更改测试实例的语言和引导偏好设置。在启动自动化测试实例时，请使用上游的浏览器选择器覆盖层。

英语测试夹具来源：DeepSeek Harness 提交 ddefc45fbc7f8e46dd73185e68295696d1297887。要更新，请比较 test/upstream-sources.json 中列出的六个源字典；保留占位符名称和多重性。翻译和代码是在 AI 协助下准备的，并通过上述验证进行了审查；欢迎波斯语使用者的反馈。

贡献

报告缺失的翻译时，请提供命名空间/键或不含凭据的截图。对于布局错误，请包含 DSH/浏览器版本以及最少的混合语言文本。PR 应包含回归测试并描述用户可见的行为。这是一个社区包，不是 DeepSeek 的官方产品，也不声称是其核心团队的成员。