前言¶

DeepSeek Harness（DSH）Web 端默认以英文界面为主。若你需要在浏览器里用波斯语（فارسی）操作设置、侧栏、工作区与对话等常见区域，并希望界面在选中波斯语时采用从右到左（RTL）排版，单靠改浏览器语言往往不够：未翻译的命名空间仍会回落英文，代码与终端区域也需要与正文方向隔离。社区插件 dsh-persian-rtl（维护者 MiRHaDi）通过 DSH 公开的 locale 客户端 API 注册语言包与样式，在 web 配置下扩展语言选择器与文档方向，且不引入运行时 npm 依赖。

这是什么¶

dsh-persian-rtl 是独立的社区插件（非 DeepSeek 官方产品），分类为客户端，面向 DeepSeek Harness Web。它在语言选择器中加入 فارسی，翻译 6 个命名空间共 240 条字符串，并在选中波斯语时启用 RTL 布局；代码块、快捷键说明、终端与编辑器容器保持 LTR。插件使用 @deepseek-ai/dsh-client-locale 注入，当前发布版本 0.1.0，许可证 MIT。

核心功能¶

翻译覆盖¶

其余命名空间仍使用 DSH 英文回退。README 明确说明：并非全应用翻译——引导、提供商配置、Composer 控件及部分设置面板仍为英文。未实现按 locale 的日期转换、波斯数字、语音与终端 UI 本地化；日期仍沿用上游日历。单复数计数模板保留占位符并使用自然波斯语计数词。

RTL 与混排¶

RTL 通过文档方向（dir）与作用域 CSS 实现，不做字符串反转或插入方向控制字符。pre、code、kbd、samp、xterm、Monaco、CodeMirror 等容器使用 LTR 隔离；段落与 textarea 使用 unicode-bidi: plaintext 以处理波斯语与拉丁文混排。第三方渲染组件是否完全支持 RTL 需个案反馈。

语言偏好¶

在 Settings → General → Language 中选择 فارسی 即可。若未显式设置语言偏好，也会跟随波斯语浏览器 locale（例如 fa-IR）；显式偏好优先。选择语言不需要 API Key；模型请求仍按 DSH 常规范式配置提供商。

安装与启用¶

维护者在 DeepSeek Harness 0.1.6-alpha.2、Node 24.15.0、Windows 上已安装 Google Chrome 153.0.8010.52 的环境测过。API 处于 alpha 阶段，更早版本不受支持，后续兼容性不保证。插件不会安装或升级 DSH，需已有对应版本的 DSH 安装。

1、从 GitHub Releases 下载 dsh-persian-rtl-0.1.0.tgz。
2、确保已创建 web profile，在 tarball 所在目录执行：

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

3、打开 DSH 打印的本地地址，进入 Settings → General → Language → فارسی。

Release 包内已包含构建好的客户端，安装时无需再跑构建脚本。若要做隔离试用，可在启动 DSH 前将 DSH_HOME 指向空目录；profile 与插件机制见上游 profile and plugin guide。

卸载并刷新页面：

dsh plugin --profile web remove dsh-persian-rtl

卸载会移除词典、选择器条目、监听器与样式表；离开波斯语时会恢复先前的文档方向（除非其他逻辑已修改）。语言与偏好的持久化由 DSH 负责。

典型用法¶

安装并启动 Web profile 后，在设置中将界面语言切到 فارسی，即可在已覆盖的六个命名空间内看到波斯语文案，同时整体布局为 RTL，代码与终端区域仍为 LTR。

维护者还用真实 dsh plugin 命令安装，并在实际 Web 应用中用无头系统 Chrome 做过冒烟：fa → en → fa 语言切换、lang/dir 与零页面错误等。浏览器侧可选：单独安装 Playwright 1.62.1，将 DSH_TEST_URL 设为隔离运行实例的本地已认证 URL，执行 node test/browser.cjs（仅打开无头 Chrome；勿泄露该 URL）。

适用场景与注意¶

适合谁：需要在 DSH Web 上以波斯语阅读常见 UI、并依赖 RTL 混排规则的开发者或使用者；接受引导、提供商与部分面板仍为英文的现状。

权限与安全：插件随当前 dsh 进程权限运行，安装前请自行查阅 仓库源码 与 MIT 许可证。社区目录 skillhub.cn 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。

开发与校验（维护者侧，非安装必需）：

npm ci
npm run build
npm run test

含六项自动化测试（词典键与占位符、固定上游 fixture、LocaleRuntime、fa-IR 协商、英文回退、重复切换语言、卸载/重载与方向恢复等）。英文 fixture 对应 DeepSeek Harness 提交 ddefc45fbc7f8e46dd73185e68295696d1297887。

结尾¶

dsh-persian-rtl 在 DSH Web 上补齐波斯语选择与 RTL，并限定 LTR 的技术区域，适合需要 فارسی 界面又保留代码/终端可读性的场景。进一步了解与下载：

• 目录页：https://www.skillhub.cn/plugins/MiRHaDi/dsh-persian-rtl
• GitHub：https://github.com/MiRHaDi/dsh-persian-rtl