俄语本地化 GooDAnDReaDY/dsh-russian-lang

📦 @goodandready/dsh-russian-lang

DeepSeek Harness 的完整俄语本地化、智能排版与键盘布局纠错

⭐ 如果你喜欢这个插件，请在 GitHub 上给它点个星 —— 这能让我知道它对你有用，也会激励我继续开发下去。

🐛 如果你发现了 bug，或者想提新功能，用任意语言在 GitHub 上开 issue 就行 —— 我会看你的提议，把有价值的想法做进后续版本。

⚡ 概览

dsh-russian-lang 是 DeepSeek Harness（dsh）网页界面的官方完整俄语本地化包。

这个包不只翻译内核界面和生态里所有热门插件，还加了几个让俄语用户用得舒服的智能功能：100% 人工校对术语、复数语法形式（plural）、自动排屏幕排版（「ёлочки」引号、长破折号、不换行空格），以及按 Alt+L 热键纠正输错布局的文本。

mermaid
graph LR
subgraph DSHCore [DeepSeek Harness 内核]
DSH[Web UI 界面] --> Loader[dsh-russian-lang 本地化加载器]
end

subgraph TranslationLayer [翻译与适配层 — 10 432 个键 / 100% 校对完成]
Loader --> CoreDict[DSH 内核 58 个命名空间 / 2 442 个键]
Loader --> PluginDict[DSH 插件 43 个命名空间 / 7 781 个键]
Loader --> PluralEngine[语法复数形式引擎：1/2/5]
end

subgraph SmartFeatures [智能模块]
Loader --> Typo[排版模块：«ёлочки» 引号与长破折号]
Loader --> LayoutFix[错误键盘布局检测器 + 快捷键 Alt+L]
Loader --> Spell[启用俄语拼写检查]
Loader --> Overrides[用户自定义键覆盖]
end

subgraph Result [结果]
CoreDict --> NativeUI[原生俄语界面]
PluginDict --> NativeUI
PluralEngine --> NativeUI
Typo --> NativeUI
LayoutFix --> NativeUI
Spell --> NativeUI
Overrides --> NativeUI
end

style DSHCore fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
style TranslationLayer fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
style SmartFeatures fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
style Result fill:#181825,stroke:#f38ba8,stroke-width:2px,color:#cdd6f4

✨ 功能全览

1. 🌐 DSH 内核 100% 覆盖（58 个命名空间，2 442 个键）
* 对话与消息（conversation）：消息流、讨论分支、工具调用卡片、生成状态与推理轨迹（thinking traces）。
* 模型与服务商（settings.models）：模型目录、推理参数、token 与 API 密钥管理。
* 推理轨迹（trajectory）：详细步骤、工具调用参数、时间戳，以及模型思考过程可视化。
* 内核设置（settings、common、settings.theme）：连接参数、快捷键、系统通知、字体缩放、模态窗口与确认提示。
* 工作区（workspace、subagent）：文件树、上下文管理、子代理的启动与协调。
* 调度器与清单（schedule.catalog、settings.pluginInventory、settings.plugins）：后台任务、执行周期、过滤器，以及已安装插件目录。
* 权限与安全（permission.access、plan、skill）：权限预设（完全访问、只读、写入工作区）、计划执行与技能。
关于翻译质量。 全部 10 432 个界面键（2 619 个核心键 + 7 813 个插件键）已 100% 翻译完成，并经过人工校读。机器翻译初稿已全部替换为经核验的表述（draft = 0）。翻译会定期通过占位符完整性自动检查器、术语表（glossary.json）合规检查以及排版溢出检测器进行校验。发现不准确之处，可在设置卡片中点击「报告翻译问题」按钮，直接生成现成的 issue。

2. 🧩 内置 DSH 生态 65+ 插件的翻译（7 781 个键）本地化自动覆盖 DeepSeek Harness 生态的全部关键插件：
* dsh-session-control —— 增强的会话管理：固定对话、按时间段归档、查看记录、过滤噪声；
* dsh-kanban 和 task-board —— 任务看板、卡片、检查清单、截止日期、完成标准（DoD）和验收关口（Acceptance Gate）；
* dsh-cost-meter —— token 成本核算、费用计算和模型资费表实时展示；
* dsh-goal —— 自主目标设定智能体，带安全循环和反思；
* dsh-moa —— 多智能体架构 Mixture-of-Agents；
* dsh-context-lens 和 dsh-context —— 上下文可视化与优化、token 分析和压缩；
* dsh-time-machine —— 工作区快照和文件状态回滚；
* dsh-shadow-auditor —— 变更影子审计和安全；
* dsh-cron 和 schedule.catalog —— 周期性 cron 任务调度器；
* dsh-clinebot 和 im-hub —— Telegram、Discord、Slack 集成与网关；
* dsh-subscriptions —— 管理个人模型订阅；
* dsh-voice 和 dsh-tts —— 语音识别和语音播报；
* dsh-image-gen —— 图像生成；
* dsh-lanmode —— 局域网网络访问和 TLS 证书生成；
* dsh-model-sync —— 模型和端点同步；
* dsh-usage-guard 和 token-dashboard —— 限额控制和 token 费用分析；
* skills-manager 和 dsh-skill-hub —— 智能体技能管理器和能力展示页；
* commandcode 和 settings.commandcode —— 命令服务商和账号；
* better-sidebar、better-input、opencode-palette、context-doctor、plugin-store、autoReview 等。

3. 🔢 俄语数词的语法形式（Plural）英语只区分 1 和 other。俄语要求数词有 3 种语法形式（1 файл、2 файла、5 файлов / 1 секунда、3 секунды、10 секунд）。本地化引擎会根据数值自动填入正确的词尾。

4. ✍️ 智能排版模块（russian-lang.typography）自动把消息文本和描述文本调整为俄语屏幕排版规则：
* 把直引号 "лапки" 替换为正确的 «ёлочки» 引号（嵌套时替换为 „лапки“）；
* 把词间连字符替换为长破折号（—）；
* 在短连词和前置词后插入不换行空格，避免出现孤行；
* 代码安全：排版严格隔离，绝不触碰源代码块、LaTeX 公式和等宽输入框。

5. ⌨️ 修正键盘布局输错（Alt+L）如果你忘了切换布局，用拉丁字母敲出了文本（比如把 проект в пальто 打成了 ghjtrn d gzkmt），插件会立刻：
* 实时识别输错的输入；
* 在输入框上方显示不打扰人的浮动提示；
* 按下热键 Alt+L 时，立刻把已输入的文本转换成正确的西里尔字母。

6. 🔍 交互式翻译检查器与实时覆盖（Alt+Click / Alt+I）内置的强大工具，用来检查界面字符串、随手即时修改译文：
* 定点检查（Alt+Click）：按住 Alt 键，点击任意界面元素（按钮、菜单项、标签），打开检查器模态窗口。
* 常驻模式（Alt+I）：把界面切换到交互式探查模式——鼠标悬停时用整齐的边框高亮元素，并带上来源徽标（Core、Plugin、DOM、Untranslated），屏幕右下角显示浮动状态小部件，带快速退出按钮。
* 检查器模态窗口：
* 精确识别系统键、命名空间和来源类型。
* 一键复制键，或复制现成的标准化 Markdown 片段，用于提交 bug 报告。
* 自定义译文（覆盖）输入框，带 「Применить」 按钮：即时修改 DOM 中的文本，并把覆盖项保存到设置（russian-lang.overrides），无需刷新页面。所有同类界面元素自动更新。
* 「Сбросить」 按钮，即时回滚到标准词典译文。
* 设置卡片中的管理（第 4.5 节）：
* 检查器快速开关按钮（Alt+I）。
* 「Экспорт JSON」 和 「Импорт JSON」 按钮，用于备份、迁移，以及在浏览器和工作配置档之间同步你的覆盖列表。

7. ⚡ 性能优化与架构安全
* MutationObserver 批处理：优化过的界面变更观察器带自适应 debounce（16 毫秒），在列表密集渲染和 LLM token 流式输出时，避免雪崩式重绘和重新计算布局（reflow）。
* 词典 HTTP 路由防护（405 Method Not Allowed）：服务端端点 /api/dsh-russian-lang/dict/core、/api/dsh-russian-lang/dict/plugins、/api/dsh-russian-lang/dict/all 严格防护，只接受安全的 GET/HEAD 方法。
* 客户端包留有余量：优化后的架构和紧凑的启动代码，让客户端脚本大小为 153.7 KiB（距上限还有 10 KiB 以上余量）。
8. 🔤 原生集成到内核插件原生注册 「Русский」 菜单项，位置在 设置 → 通用 → 语言，切换 属性，并启用浏览器内置拼写检查词典（spellcheck）。

📦 安装 bash
dsh plugin --profile web add @goodandready/dsh-russian-lang

安装完成后打开 Web 界面，进入 设置 → 通用 → 语言，选择 「Русский」，然后刷新页面。

⚙️ 配置参数（settings.yaml / Cordis 配置档）

在较新的 DSH 版本（v0.2.0-rc.2+、v0.1.7+）中，插件配置通过 Web 界面的 managed 表单统一管理（设置 → 插件 → Русская локализация），也可以在配置档/配置里按插件标识符 dsh-russian-lang 设置（依据 cordis.patch.yml）。

为了完全兼容早期内核版本（DSH <= 0.1.6），插件还会自动读取旧版命名空间 russian-lang。

参数结构声明在 lib/index.js 中，所有字段都是可选的： yaml

Актуальный формат (DSH v0.2.0-rc.2+ / v0.1.7+):

dsh-russian-lang:
enabled: true # Русский язык интерфейса (по умолчанию: true)
overrides: {} # Пользовательские оверрайды ключей (по умолчанию: {})
typography: # Интеллектуальная типографика (по умолчанию: все opt-in false)
enabled: false # Ёлочки, длинные тире, неразрывные пробелы
yo: false # Восстановление безопасной буквы «ё»
liveInput: false # Живая типографика при вводе в текстовых полях
agentPrompt: false # Системная инструкция агенту отвечать по-русски (по умолчанию: false)
agentPromptPreset: technical_expert # Пресет системного промпта (по умолчанию: technical_expert)
slashAliases: true # Русские алиасы слэш-команд (/помощь, /очистить) (по умолчанию: true)
layoutConversion: true # Детектор неверной раскладки и подсказка Alt+L (по умолчанию: true)
quickSwitch: true # Быстрый переключатель RU/EN в статусной строке (по умолчанию: true)
translateEngine: off # Движок перевода реплик: off, local (LibreTranslate) или google (Google) (по умолчанию: off)
localApiUrl: http://localhost:5000 # URL локального инстанса LibreTranslate (по умолчанию: http://localhost:5000)

Легаси-формат (DSH <= 0.1.6, поддерживается автоматически как fallback):

russian-lang:

enabled: true

...

最方便的做法是在界面里可视化配置参数：设置 → 插件 → Русская локализация。

键盘布局纠错（Alt+L）和斜杠命令的俄语别名默认开启（true），可以在设置里单独关闭（layoutConversion: false、slashAliases: false）。选择俄语区域设置后，浏览器拼写检查（lang="ru-RU"）会自动启用。

🛠 开发与仓库镜像 GitHub 上的公开仓库是 @goodandready/dsh-russian-lang 的发行镜像。主要开发、构建流水线和完整测试链路都在项目的主 Gitea 仓库中进行。

欢迎在 GitHub 上提交 Pull Requests 和 Issues，我们会按常规流程处理！要修改客户端逻辑，请使用 lib/client.template.js。在仓库中运行 npm test 会执行完整检查（270+ 个 Node.js 单元测试、构建器测试、译文与术语表 linter）。

📄 许可证

MIT © GooDAnDReaDY

回复翻译引擎

插件可以把模型回复翻译成俄语。为此提供两个引擎，你在设置里二选一。默认两个引擎都关闭（translateEngine: off）。

Google Translate（非官方）

模型回复文本会发送到 translate.googleapis.com/translate_a/single?client=gtx —— 这是 Google 的非官方公开端点，没有 SLA，也不保证可用性。模型回复里可能包含代码片段、路径、文件内容 —— 这些都会发给第三方。开启后，设置卡片上会显示黄色徽标。

LibreTranslate（本地）

插件在 127.0.0.1:5000 上启动 Docker 容器 libretranslate/libretranslate:v1.5.3。翻译完全在本地完成 —— 文本不会离开你的机器。需要先安装 Docker。

| 引擎 | 文本发往何处 | 隐私 | 网络 |
| off（默认） | 不发往任何地方 | ✅ 完全私密 | 不需要 |
| google | Google（googleapis.com） | ⚠️ 文本发送给第三方 | 需要 |
| libretranslate | localhost:5000（Docker） | ✅ 本地 | 仅拉取镜像时需要 |

[!NOTE]
Electron 系统菜单的限制： Electron 桌面外壳的系统菜单项（Application、Edit、File、Quit、Undo/Redo/Cut/Copy/Paste 等）属于 Electron 主进程（app.asar），位于操作系统层面，DSH 的 Web 插件无法翻译。