RTL 智能排版 AlirezaKhoshandam/dsh-rtl-fa

dsh-rtl-fa

为 DeepSeek Harness Web GUI 提供波斯语、阿拉伯语和 RTL 文本的智能排版。

فارسی · 技术参考

前后对比

功能说明

DSH 渲染对话 Markdown 时按从左到右排版。波斯语回答因此从错误的一侧开始，波斯语、英文、URL、代码混排的段落也很难读。把整个 UI 翻成 RTL 并不能解决问题：它会破坏英文正文、代码、表格和组件布局。

本插件按文本块决定方向，依据是该块自身的内容：

- 检测阿拉伯字母文字（波斯语、阿拉伯语、乌尔都语等）以及其他 RTL 文字（希伯来语、叙利亚语、塔纳语、N'Ko、撒玛利亚语、曼达语、阿德拉姆语）；
- 内容为 RTL 时，右对齐段落、标题、列表项、引用、表格单元格、用户气泡和消息编辑器；
- 纯英文块、代码围栏、行内代码、URL、电子邮件地址、KaTeX 和 UI 外壳保持原样；
- 通过一个合并的 MutationObserver 批次更新流式回答和动态插入的内容；
- 通过官方 configForms 服务把设置持久化到 DSH 配置档，而不是用按源站隔离的 localStorage；
- 作为普通配置档 bundle 安装，无需改动 Core 文件。

安装

插件页面（推荐）

1. 把这个文件夹放在固定路径，例如 C:\Users\<you>\.dsh\plugins\dsh-rtl-fa。
2. 打开 Plugins → Add plugin → Install a third-party plugin。
3. 输入文件夹的绝对路径并安装。
4. 在 Installed plugins 中启用 dsh-rtl-fa bundle。
5. 刷新页面（或重启 DSH）。

手动安装到配置档

在 %USERPROFILE%\.dsh\profiles\desktop 中操作（先备份 package.json）：

{
"dependencies": {
"dsh-rtl-fa": "file:C:/Users/<you>/.dsh/plugins/dsh-rtl-fa"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-rtl-fa"
]
}
}
}

然后在该配置档中执行 pnpm install，刷新页面。

设置

Settings → General → Persian & RTL text

| 设置 | 默认值 | 含义 |
| Enable RTL text support | 开 | 总开关。样式表保持加载，以便该行保留样式。 |
| Direction policy | Automatic (per block) | 自动检测；Always RTL 表示任何 RTL 文字块都按 RTL 处理；Always LTR 作为手动覆盖。 |
| Apply to the message editor | 开 | 草稿含 RTL 文本时右对齐输入框。 |

设置写入当前配置档的 cordis.patch.yml，重启后仍然有效。

按块覆盖

Force this block RTL.
Force this block LTR.
…
Never touch this subtree.
Opt generic div text into detection.

混排内容行为

| 输入 | 结果 |
| برای اجرای npm install وارد پوشه شوید. | RTL 段落；npm install 保持为独立的 LTR 片段。 |
| DeepSeek Harness از مدلهای پیشرفته پشتیبانی میکند. | 尽管以英文开头，仍为 RTL；波斯语占主导。 |
| This is English with one سلام word. | LTR；一个外来词不会翻转英文段落。 |
| 围栏代码与行内代码 | 始终 LTR 且独立。 |
| 以波斯语为主的表格 | 列顺序为 RTL；英文单元格显式重置为 LTR。 |
| 全波斯语列表 | 标记移到右侧。 |
| 混合列表 | 列表方向保持中性；单个 RTL 块仍右对齐。 |
| 流式回答 | 每次变更时重新评估每个发生变化的块。 |

测试

npm run build
npm test # 29 unit, DOM, and module-integration tests
npm run test:visual # 26 assertions in real Chromium/Edge

已在隔离的 DSH 0.2.1-rc.5 配置档中验证：

- dsh-rtl-fa 出现在浏览器启动图中；
- 插件样式表加载时没有控制台或页面错误；
- Settings 行出现在 General 下；
- 切换开关后，状态通过 cordis.patch.yml 持久化；
- 输入波斯语时，真实的 Lexical 编辑器收到 dir="rtl"。

架构、算法和完整测试矩阵见 docs/TECHNICAL.fa.md。发布说明见 docs/PUBLISH.fa.md。

项目结构

src/index.js Host half + volatile Config
src/client/index.js apply/inject, Settings registration
src/client/detection.js pure script/direction classification
src/client/engine.js DOM selection, mutation scheduling, reversibility
src/client/settings.js serialized configForms writes
src/client/SettingsRow.js feature-owned Settings row
src/client/styles.css scoped direction and row styling
lib/ generated host/client artifacts
tests/ unit, jsdom, module, real-Chromium checks
docs/ technical notes and screenshots

开发

npm install --ignore-scripts
npm run build
npm test
npm run test:visual

不要手动编辑 lib/client.js。视觉测试需要已安装 Edge/Chrome，并且可能需要在不阻止 Chromium 进程/Pipe 创建的宽松沙箱外运行。

限制

- Settings 需要 configForms 服务；Host 半部分在无头/SDK 配置档中仍会加载，但那里没有设置界面。
- 波斯语/英语混合列表保持列表原有方向，防止 RTL 继承到英文条目。全 RTL 列表的标记会正确移动。
- 以波斯语为主的表格会反转列顺序。对于语义上为 LTR 的表格，在 上使用 data-dsh-dir="ltr"。
- 基于文字的检测按设计忽略数字、标点和单个中性字符。
- data-dsh-rtl-ignore 内的内容永远不会被修改。

许可证

MIT — 见 LICENSE。