波斯语右排 mehdinikzad68/dsh-fa-rtl

dsh-fa-rtl

在 DeepSeek Harness Web GUI 中让波斯语（Farsi）聊天消息从右到左显示。

فارسی | English

模型给出的波斯语回答，以及你自己发的波斯语消息，都会从右到左、右对齐显示；而英文段落、代码块和表格保持原本的从左到右排版。这是一个纯 DSH 插件：不改动应用文件，不需要构建工具链，安装后无需任何配置。

工作原理

DSH 渲染的每一行聊天都是从左到右（LTR）排版；其中的波斯语文本会由 Unicode 算法做双向重排，但基准方向仍是 LTR——所以波斯语段落依然左对齐，标点也会漂到错误的一侧。

Web 标准的修法是 dir="auto"。插件碰不到 React 渲染出的 DOM，于是本插件改用与之完全等价的 CSS：

unicode-bidi: plaintext;
text-align: start;

unicode-bidi: plaintext（CSS Writing Modes 4）让每个文本块根据块内第一个强方向字符自行决定方向——以波斯语开头的段落按 RTL 渲染并右对齐；以英文开头的段落不受影响。由此带来：

- 混合内容（波斯语正文 + 代码 + 表格）能正确渲染：正文 RTL， 代码有意不动（保持 LTR），表格按单元格逐个处理，列表标记随所属列表一起翻转。
- 选择器只作用于 dsh-client-ui-chat 在其流式条目上输出的稳定 data- 属性（data-chat-flow-kind、data-chat-group-part、data-turn-process-answer）。绝不引用构建期哈希过的类名，所以 UI 更新后插件依然可用。万一某个属性变了，CSS 只是不再匹配——不会弄坏应用。

安装

需要 DSH ≥ 0.2.0-rc.2，且使用 web 组合（desktop 或 web 配置档）。任何 Chromium/Electron ≥ 105 都可以。

从 DSH Web UI 安装

打开侧边栏的 Plugins 页面，用本仓库的 GitHub 地址（github:mehdinikzad68/dsh-fa-rtl）安装 bundle。安装会在配置档目录里运行 pnpm，并默认启用该 bundle。

从命令行安装

dsh plugin --profile desktop add github:mehdinikzad68/dsh-fa-rtl
or, for the web profile:
dsh plugin --profile web add github:<owner>/dsh-fa-rtl

安装通常会自动启用 bundle；如果没有，就到 Plugins 页面手动打开。如果你的配置档只在启动时应用补丁，重启一次应用。

从智能体会话安装

让智能体调用 plugin_manager 工具，action 用 install_bundle，并传入 GitHub spec。每次管理调用都需要你批准。

本地开发（不安装）

克隆仓库，把配置档补丁行指向模块文件（ESM 无法导入目录）。在 <profile-dir>/cordis.patch.yml 中：

- insert:
- id: fa-rtl
name: 'C:\path\to\dsh-fa-rtl\lib\index.js'

验证

1. 用波斯语向模型提问——波斯语文本按 RTL 渲染并右对齐；数字和标点位置正确；代码保持 LTR。
2. 浏览器控制台（或 DevTools）显示：[dsh-fa-rtl] active — Persian chat text now renders right-to-left
3. 中包含 标签。
4. 设置 → 插件 中该 bundle 不显示同步错误。

卸载

在插件页面移除该 bundle，或执行 dsh plugin --profile <profile> remove dsh-fa-rtl（安装方式），或者从 cordis.patch.yml 中删除 fa-rtl 插入块（本地方式）。条目禁用后，模块系统会移除插件的样式表。

包结构

dsh-fa-rtl/
├── package.json # manifest: dsh.bundle.patch + dsh.client declaration
├── cordis.patch.yml # bundle patch: registers the fa-rtl Loader row on install
├── lib/index.js # Host half (Node): imports cleanly, mounts as a Cordis plugin
├── lib/client.js # Client half (browser): hand-written DSH client bundle, injects CSS
├── README.md / README.fa.md
└── LICENSE # MIT

扩展

- 想让更多界面支持 RTL（比如 ask_user_question 卡片）？在 lib/client.js 中扩大 scope 选择器列表并保存——HMR 会热替换 bundle，或者重启一次。
- 想对所有内容强制* RTL（连英文文本也是）？在同一文件中把 unicode-bidi: plaintext 换成 direction: rtl。

已知限制

- 以拉丁词开头的段落（比如 «VS Code را نصب کن»）在自动模式下会解析为 LTR——这与网页上各处的 dir="auto" 行为一致；其中的波斯语部分顺序仍然正确。
- 溢出的宽表格保留其物理边距；非常宽的波斯语表格对齐可能略有不同。
- 问题卡片（ask_user_question）和部分侧边栏在 v1 中有意不在范围内。

许可证

MIT