阿拉伯语 RTL 界面 qrandmaster/dsh-ar-rtl

为 DeepSeek Harness 添加阿拉伯语本地化与从右到左方向支持

一个非官方客户端插件，为 DeepSeek Harness 界面加上完整本地化与真正的方向（RTL）支持。该界面只随附英文和中文，代码里没有任何方向支持。

* 一条命令安装 —— 不需要 Node，安装过程中也不需要联网
* 58 个命名空间、2615 个键，全部译为现代标准阿拉伯语
* 真正的方向：插件自己写入 dir="rtl"，因为应用里根本没有代码会写它
* 混合文本正常：同时包含阿拉伯语和英语的行不再打乱片段顺序
* 代码保持 LTR：代码块、命令、标识符、键盘快捷键
* 能扛住应用更新，并配有一键维护脚本，处理那些扛不住的部分

irm https://raw.githubusercontent.com/qrandmaster/dsh-ar-rtl/main/bootstrap.ps1 | iex

然后重新加载界面，选择 Settings ← General ← Language ← العربية。

想要现成文件？从最新版本下载压缩包，解压后运行 install.bat。

插件具体加了什么

| 组件 | 详情 |
| 「العربية」语言 | 注册进应用的语言注册表，并保存为用户偏好（preference: ar） |
| 方向 | 应用里没有代码读取或写入 dir；插件写入它，并监听语言变化 |
| 文本 | 58 个命名空间、2615 个键，现代标准阿拉伯语 |
| 混合文本 | 段落用 unicode-bidi: plaintext，并为 165 个技术值做方向隔离 |
| 代码 | 保持从左到右：代码块、命令、快捷键、路径、标识符 |
| 布局 | 50 多处覆盖，基于应用随附样式表的文本规则，而非猜测 |

环境要求

* DeepSeek Harness 已安装在 Windows 上（桌面应用）。
* 安装不需要联网，不需要 pnpm，也不需要 Node —— 压缩包原样复制。

安装

方法一：一条命令

irm https://raw.githubusercontent.com/qrandmaster/dsh-ar-rtl/main/bootstrap.ps1 | iex

脚本把这个仓库下载为归档，解压到临时目录，运行 install.ps1，然后清理自己。

方法二：下载并解压

1. 下载这个仓库（Code 按钮，然后 Download ZIP），或从版本页面下载发行包，然后解压。
2. 双击 install.bat。
3. 重新加载界面，然后 Settings ← General ← Language ← العربية。

方法三：直接从终端

powershell -ExecutionPolicy Bypass -File install.ps1 # تثبيت
powershell -ExecutionPolicy Bypass -File install.ps1 -Update # صيانة بعد تحديث التطبيق
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall # إزالة كاملة

有用的选项：-Profile <name>（默认 desktop）、-DshHome <path>、-AsarPath <app.asar>，以及 -DryRun，只展示将要发生什么而不执行。

维护与卸载

| 命令 | 作用 |
| install.bat | 安装或重新安装 |
| update.bat | 每次应用更新后：重新探测被混淆的类名，重新构建，然后部署 |
| uninstall.bat | 完整卸载（加载行 + 已安装的包） |

DeepSeek Harness 更新时会发生什么？

插件不在应用里，而在用户文件中：

%USERPROFILE%\.dsh\profiles\desktop\plugins\dsh-ar-rtl\ 包 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml 加载行

更新应用只会替换应用本身，不会碰这个目录，所以插件不会被删，加载行也不会丢。
但每个组件的命运各不相同：

| 组件 | 更新后 | 原因 |
| 语言、方向、文本和隔离 | 保留 | 不依赖任何类名 |
| 更新新增的键 | 显示英文，直到被翻译 | 尚无译文 |
| 图标和对齐修正 | 可能静默失效 | 应用里的类名经过混淆，每次构建都会变 |

正因如此才有了 update.bat：它扫描新的 app.asar，按规则正文而不是按名称重新识别类名，然后重新构建并发布。如果某个组件形态变了，它会明确报出来（COULD NOT RESOLVE），而不是让效果悄悄消失。

验证插件是否工作

打开浏览器控制台，输入：

__DSH_AR_RTL__ // 当前语言、方向、作用域和键的数量，以及样式表是否已注入

已知限制

* 四个实验性插件名称仍为英文（Agent Teams · Auto Authorization Review · Automation tasks · Voice input）：它们的标题从 app.asar 内的包数据读取，而应用里的 resolveText 函数按文档和实现都不查询词典。
* 阿拉伯语复数：词典的单一形式无法表达阿拉伯语的六种复数类别，所以 1 用单数，1 以上用复数。
* 视觉修正针对的类名本身就经过混淆；正因如此才有了 update.bat。

仓库结构

├─ bootstrap.ps1 一行命令安装入口 ├─ install.ps1 安装、更新和卸载逻辑 ├─ install.bat 双击文件 ├─ uninstall.bat ├─ update.bat ├─ client.js 已构建的包（生成产物，已提交，让安装无需 Node 也能运行） ├─ src/rtl.css 方向样式表：方向、bidi、LTR 代码和布局修正 ├─ ar/.json 58 个阿拉伯语词典 ├─ tools/ │ ├─ build-client.mjs 把样式表和词典合并进 client.js │ ├─ selftest.mjs 20 项运行时包行为检查 │ ├─ validate-ar.mjs 把键和占位符与英文源比对 │ ├─ namespace-keys.json 仅键名（英文值不再分发） │ ├─ export-keys.mjs 从本地清单重新生成 namespace-keys.json │ ├─ refresh-selectors.mjs 在任何更新后重新识别混淆的类名 │ └─ gh-api.mjs 用于发布本仓库的 GitHub API 小型客户端 ├─ docs/HOW-IT-WORKS.md 深入技术说明 ├─ scripts/publish.ps1 发布到 GitHub 的脚本 └─ .github/workflows/ci.yml 自动校验

关于文件语言的说明

本仓库的所有文档均为阿拉伯语：README.md、CHANGELOG.md、 INSTALL-AR.md 和 docs/HOW-IT-WORKS.md。

而可执行文件则有意保持英文，出于三个无法回避的技术原因：

install.ps1 和 publish.ps1：Windows PowerShell 5.1——也就是双击时运行 .bat 文件的解释器——读取不带字节顺序标记的脚本文件（BOM）以 ANSI 编码而非 UTF-8，于是其中任何阿拉伯语词汇都会显示为乱码。通常的解决办法是加上 BOM，但在 bootstrap.ps1 里做不到（原因见下），而只在部分文件里加、另一些不加又会让人困惑；所以我们选择保留英文消息、阿拉伯语文档。
* bootstrap.ps1：通过 irm … | iex 执行，把以 BOM 开头的文件传给这条路径可能让执行报错。
* .bat 文件：cmd.exe 按系统编码读取，其中的阿拉伯语会破坏命令。

tools/.mjs 里的代码注释也用英文，因为它们会在并不总能正确设置编码的编辑器里被读取和显示。技术术语、文件名和命令在所有位置都保持拉丁字母，因为它们是标识符，不是文本。

开发

node tools/build-client.mjs # 重新生成 client.js
node tools/selftest.mjs # 20 项对包行为的校验
node tools/validate-ar.mjs # 比对词典
node tools/refresh-selectors.mjs --dry-run # 用已安装的构建检查样式表

refresh-selectors.mjs 需要本地安装该应用（它会读取 app.asar）。validate-ar.mjs 在干净的仓库副本里以「仅键」模式运行；如果存在本地 inventory/ 目录（其中存放提取出的英文词典），它还会校验占位符和段落行是否一致。

贡献

翻译：修改 ar/<namespace>.json，保持键集合不变，每个 {placeholder} 占位符也原样保留，然后运行 validate-ar.mjs。
* 布局修正：往 src/rtl.css 里加规则时，必须在注释里附上随包发布的那条规则原文作为依据 —— 原因见 docs/HOW-IT-WORKS.md。
* 提交前运行 build-client.mjs；自动校验分支会重新构建并与源码比对。

汉化没有翻译键的内容

应用里有些文本不是词典键，ctx.locale.register 触及不到。这一层已在插件里做了阿拉伯语化：

| 文本 | 来源 | 如何阿拉伯语化 |
| Off · Low · High · Max | 应用内 DeepSeek 服务商目录：名字写死在代码里，以数据形式（reasoning.efforts[].name）到达界面，服务商配置里没有对应字段 | 页面层：src/effort-ar.js —— 只处理下拉菜单按钮，不碰对话正文，也不重命名单个模型名，停用时还原原值。由 tools/selftest-effort.mjs 测试 |
| 应用标题栏第一个按钮的文本（显示时被截断） | 外壳在 Shadow DOM 里构建菜单栏，起点为 48px，这个值假定窗口按钮在右侧；而在阿拉伯语 Windows 上它们被移到左侧，按钮就落到了它下面 | src/rtl.css（第 12 层）：在 RTL 下用可调变量 --dsh-ar-rtl-titlebar-start 平移菜单栏，默认值 152px |

注意：应用原生菜单（About · Check for Updates · Manage dsh Command · Exit）由 Electron 的主进程根据外壳词典构建，而外壳词典只有英文和中文，任何插件都触及不到。要阿拉伯语化它就得打 app.asar 补丁 —— 而每次应用更新都会抹掉补丁，所以有意搁置。

许可证

MIT —— 见 LICENSE。本项目非官方，与 DeepSeek 无隶属关系，也未获其支持；它不含应用任何代码，也不重新分发提取出的英文文本；只是词典只翻译 README、方向性文档和插件文件。