GooDAnDReaDY/dsh-russian-lang

📦 @goodandready/dsh-russian-lang

DeepSeek Harness 的完整俄语本地化、智能排版和键盘布局修正

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

🐛 如果你发现了 bug 或想提出新功能，请用任意语言在 GitHub 上创建 issue —— 我会考虑你的建议，并在插件的后续版本中实现有用的想法。

[!NOTE]
项目的语言政策：dsh-russian-lang 是 DSH 界面俄语本地化的专用插件。规范文档仅以俄语维护（README.md、README.ru.md）。对其不适用三语文档的通用要求。

⚡ 概述

dsh-russian-lang 是 DeepSeek Harness (dsh) 网页界面的官方、全面的俄语本地化包。
该软件包不仅翻译了核心界面和生态系统中所有流行插件，还添加了智能功能，以便舒适地进行俄语工作：100% 人工校对术语、语法复数形式（plural）、自动屏幕排版（«ёлочки» 引号、长破折号、不换行空格）以及通过快捷键 Alt+L 修正因错误键盘布局而输入的文本。

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

subgraph TranslationLayer [翻译与适配层 — 8735 个键 / 100% 已校对]
Loader --> CoreDict[DSH 核心的 49 个命名空间 / 2146 个键]
Loader --> PluginDict[DSH 生态系统的 60+ 个插件 / 6589 个键]
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. 🌐 100% 覆盖 DSH 核心（49 个命名空间，2146 个键）
* 对话与通信（conversation）：消息流、讨论分支、工具调用卡片、生成状态和推理过程（thinking traces）。
* 模型与提供商（settings.models）：模型目录、推理参数、令牌和 API 密钥管理。
* 推理轨迹（trajectory）：详细步骤、工具调用参数、时间戳以及模型思考的可视化。
* 核心设置（settings、common、settings.theme）：连接参数、快捷键、系统通知、字体缩放、模态窗口和确认对话框。
* 工作区（workspace、subagent）：文件树、上下文管理、子代理的启动与协调。
* 计划任务与清单（schedule.catalog、settings.pluginInventory、settings.plugins）：后台任务、执行周期、过滤器和已安装插件目录。
* 访问权限与安全（permission.access、plan、skill）：权限预设（完全访问、只读、写入工作区）、计划执行与技能。

关于翻译质量。 全部 8735 个界面键（2146 个核心 + 6589 个插件）已 100% 翻译并人工校对。机器翻译草稿已被完全替换为经过验证的表述（draft = 0）。翻译会定期通过占位符完整性自动检查器、术语表合规性检查（glossary.json）以及排版溢出检测器进行验证。发现不准确之处——设置卡片中的“报告翻译问题”按钮会创建一个现成的 issue。

2. 🧩 DSH 生态系统中 60 多个插件的内置翻译（6589 个键）
本地化自动覆盖 DeepSeek Harness 生态系统的所有关键插件：
* dsh-session-control —— 扩展会话管理：对话置顶、按时间段归档、查看记录和过滤噪声；
* dsh-kanban 和 task-board —— 任务看板、卡片、检查清单、截止日期、完成标准（DoD）和验收关口（Acceptance Gate）；
* dsh-cost-meter —— 代币成本核算、费用计算和模型资费表实时显示；
* dsh-goal —— 具有安全循环和反思能力的自主目标导向智能体；
* dsh-moa —— Mixture-of-Agents 多智能体架构；
* dsh-context-lens 和 dsh-context —— 上下文可视化与优化、代币分析和压缩；
* 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 —— 限额控制和代币消耗分析；
* 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. ⚙️ 用户自定义覆盖（russian-lang.overrides）
您可以在设置 → 插件 → Russian Lang → 覆盖中，按照您团队的术语覆盖任何系统翻译键，而无需编辑源代码。

7. 🔤 原生集成到内核
插件原生地在设置 → 通用 → 语言菜单中注册「Русский」项，切换  属性，并激活内置的浏览器拼写检查词典（spellcheck）。

📦 安装

dsh plugin --profile web add @goodandready/dsh-russian-lang

安装后，打开 Web 界面，转到设置 → 通用 → 语言，选择「Русский」并刷新页面。

⚙️ 配置参数（settings.yaml）

设置命名空间为 russian-lang。架构声明在 lib/index.js 中，
所有字段均为可选：

russian-lang:
enabled: true          # Русский язык интерфейса
typography:
enabled: true        # Ёлочки, длинные тире, неразрывные пробелы
yo: false            # Восстанавливать «ё» (по умолчанию выключено)
agentPrompt: false     # Просить агента отвечать по-русски
overrides: {}          # Свои значения для любых ключей перевода

更简单的做法是在设置 → 插件 → 俄语本地化中完成同样的操作。

布局修正（Alt+L）和浏览器拼写检查随俄语一起启用，
没有单独的键。

📄 许可证

MIT © GooDAnDReaDY

⚡ v0.2.9 新功能 — Smart Russian UX

v0.2.9 版本将插件功能从纯粹的本地化扩展为对使用俄语模型工作体验的完整适配：

1. 输入框中的实时屏幕排版（Live Input Typography）：
- 自动将机器编程引号（""）替换为角引号（«...»）。
- 自动将双连字符（--）替换为长破折号（—）。
- 自动将三点（...）替换为省略号（…）。
- 单字母及短俄语介词（в、на、с、к、о、у、за、по 等）后使用不换行空格（ ）。
- 严格的代码隔离：行内代码（反引号  code ）和多行代码块（   - （v0.2.19 中的变更：消除了对 input 输入字段的破坏性重写；将双连字符替换为破折号、引号替换为角引号、介词后替换为不换行空格的操作移至 keydown 处理器，使用原生 insertText，保留焦点、原生 Ctrl+Z 撤销，且无光标跳动。观察器 typoObserver 仅改为 childList: true，避免在令牌流式传输期间重置用户文本选择。）

2. 快速语言切换器（Quick Language Switcher）：
- 紧凑的 RU ⇄ EN 芯片直接嵌入对话会话头部（conversation.session.header.utilities）。
- 可一键即时切换整个界面语言，无需进入设置。

3. 斜杠命令的俄语别名（Slash-Command Aliases）：
- 输入时即时自动展开命令：
- /цель ➔ /goal
- /сжать ➔ /compact
- /план ➔ /plan
- /экспорт ➔ /export
- /память ➔ /memory
- /отзыв ➔ /feedback
- /разрешения ➔ /permission

4. 代理系统指令预设（Agent Style Presets）：
- 在插件设置卡片中可选择模型的规范回复风格：
- 💼 技术专家：严格的俄语工程术语、整洁的代码、俄语架构注释。
- 📝 技术文档撰写者：书籍排版、Markdown、ГОСТ/RFC 文档结构。
- ⚡ 简洁模式：极度精简准确的回答，无开场客套。

5. 本地化会话导出（Localized Markdown Export）：
- 生成整个对话历史的精美 Markdown 文件，包含俄语日期、角色名称（«👤 Пользователь»、«🤖 Ассистент»）、令牌指标和工具调用指示。

6. 音译快捷键（Alt+T）：
- 在输入框中即时将输入的拉丁字母转写转换为西里尔字母，或反向转换（privet ⇄ привет）。
- （自 v0.2.15 起已弃用：为保障 Lexical 原生输入畅通无阻，已移除实验性 UI 拦截器；程序函数 phoneticTranslit 保留在 lib/pure.js 中。）

7. 助手回复的行内翻译（RU ↗）与隐私：
- 助手回复操作面板中的 RU ↗ 按钮可将模型回复翻译为俄语，同时保留代码块（📋 Копировать）。
- 🔒 隐私与引擎选择：
- 默认（关闭）：不向任何地方发送任何消息数据。点击按钮会提示需要选择引擎。
- 本地 LibreTranslate （推荐）：在您的服务器上以 Docker 容器完全自主运行（~500–700 MB RAM）。可直接从 DSH 设置卡片中一键启动，或手动启动：
bash
docker run -d --name libretranslate --restart unless-stopped -p 127.0.0.1:5000:5000 libretranslate/libretranslate --load-only en,ru,zh

- Google Translate（在线）：适合喜欢在线翻译且不想分配 RAM 资源的用户。设置中会显示明确警告，提示文本将被传输到 Google 的公共服务器。