# @goodandready/dsh-russian-lang 中文文档

规范地址：https://npmcn.com/package/%40goodandready/dsh-russian-lang/

版本：0\.4\.30
npm 元数据更新时间：2026-11-15T21:24:10.203Z
中文译文更新时间：2026-11-16T19:09:44.656Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40goodandready/dsh-russian-lang
原文对照：https://npmcn.com/package/%40goodandready/dsh-russian-lang/?lang=original
项目主页：https://github.com/GooDAnDReaDY/dsh-russian-lang#readme
源码仓库：https://github.com/GooDAnDReaDY/dsh-russian-lang

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.9 MB，141 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：react ^18\.2\.0，@deepseek-ai/cordis ~4\.0\.4 \|\| ~4\.0\.5 \|\| ~4\.0\.6-alpha\.1 \|\| ~4\.1\.0，@deepseek-ai/schemastery ~3\.18\.4 \|\| ~3\.18\.5 \|\| ~3\.18\.6-alpha\.1 \|\| ~3\.19\.0，@deepseek-ai/dsh-commands \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.3\.0，@deepseek-ai/dsh-settings 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0，@deepseek-ai/dsh-home-paths 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0，@deepseek-ai/dsh-client-locale 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0，@deepseek-ai/dsh-host-webserver 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0，@deepseek-ai/dsh-client-ui-slots 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0，@deepseek-ai/dsh-client-ui-settings 0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0
- 首次发布：2026-08-23T11:17:07.540Z
- 最新版本发布：2026-11-15T21:24:10.052Z
- 近 30 天下载量：16663（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：129（近 12 个月 129 个）

## 中文简介

\* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*

## 安装

```sh
npm install @goodandready/dsh-russian-lang
```

也可以使用：`pnpm add @goodandready/dsh-russian-lang`、`yarn add @goodandready/dsh-russian-lang`、`bun add @goodandready/dsh-russian-lang`

## README

# 📦 @goodandready/dsh-russian-lang

### 适用于 DeepSeek Harness 的完整俄语本地化、智能排版与键盘布局修正插件

[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-russian-lang.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b)](https://www.npmjs.com/package/@goodandready/dsh-russian-lang) [![license](https://img.shields.io/badge/License-MIT-10b981.svg?style=for-the-badge&color=10b981&labelColor=064e3b)](https://npmcn.com/package/%40goodandready/dsh-russian-lang/LICENSE) [![DSH Plugin](https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065)](https://github.com/topics/dsh-plugin) [![Node version](https://img.shields.io/badge/Node-22%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03)](https://nodejs.org/)

![DSH v0.2.2-rc.1+](https://img.shields.io/badge/DSH-v0.2.2--rc.1%2B-blue.svg?style=for-the-badge&labelColor=1e1b4b) ![100% 覆盖率](https://img.shields.io/badge/%E8%A6%86%E7%9B%96%E7%8E%87-100%25-10b981.svg?style=for-the-badge&labelColor=064e3b) ![15673 词条](https://img.shields.io/badge/UI%E8%AF%8D%E6%9D%A1-15673-6366f1.svg?style=for-the-badge&labelColor=1e1b4b) ![89+ 插件](https://img.shields.io/badge/%E7%94%9F%E6%80%81%E6%8F%92%E4%BB%B6-89+-0ea5e9.svg?style=for-the-badge&labelColor=082f49)

[![所有项目](https://img.shields.io/badge/%E4%BD%9C%E8%80%85%E6%89%80%E6%9C%89%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e)](https://goodandready.app/)

[**🇷🇺 Русский**](https://npmcn.com/package/%40goodandready/dsh-russian-lang/README.ru.md) • [**🇬🇧 English / RU**](https://npmcn.com/package/%40goodandready/dsh-russian-lang/README.md) • [**📐 Design Contract**](https://npmcn.com/package/%40goodandready/dsh-russian-lang/DESIGN.md)

* * *

## ⚡ 概述 (Overview)

**`dsh-russian-lang`** 是针对 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) 官方 Web 界面的全面俄语本地化扩展插件。

该插件不仅无缝翻译了 DSH 核心以及 89+ 生态系统插件（共 15,546+ 词条），还集成了原生键盘布局热键转换（Alt+L）、屏幕智能排版（俄语引号 «»、长破折号 —、不换行空格）、会话一键导出 Markdown 以及多风格俄语系统提示词（System Prompt）。

* * *

## 环境要求 (Requirements)

-   **DeepSeek Harness (DSH)**: `0.2.0-rc.2 || >=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-0 <0.2.3-0`
-   **Node.js**: `>= 22.0.0`
-   **支持浏览器**: Chromium 110+, Firefox 115+, Safari 16+

## 🚀 安装与启用 (Installation)

在 DSH 的 Web 运行环境中安装插件：

```bash
dsh plugin @goodandready/dsh-russian-lang add
```

或者使用 pnpm 在个人配置目录下添加：

```bash
pnpm add @goodandready/dsh-russian-lang
```

安装完成后，在 DSH 设置界面的「插件 (Plugins)」中启用，或点击会话标题栏的 `RU ⇄ EN` 快速切换按钮即可立即生效。

* * *

## 🛠️ 主要特性 (Features)

1.  **100% 完整词条覆盖**：适配 DSH Core `v0.2.1-rc.4`，覆盖 118 个命名空间，全部词条经过人工校对。
2.  **零闪烁快速加载 (Zero-FOUT)**：内置 Bootstrap 核心词典与两阶段 ETag 缓存策略。
3.  **智能排版与输入辅助**：
    -   自动转换书名号、破折号及不换行空格。
    -   恢复常用词中的字母「ё」。
    -   按 Alt+L 自动修正输错键盘布局的文字（如 `ghbdtn` ⇄ `привет`）。
4.  **会话辅助与导出**：
    -   会话顶部快捷语言切换开关 (`RU ⇄ EN`)。
    -   助手回复一键翻译至俄语。
    -   对话一键导出为标准 Markdown 文档。
5.  **本地化检查器 (Alt+I)**：可视化审查页面上的所有 UI 词条来源及覆盖状态。

* * *

## 📄 许可证 (License)

本项目采用 [MIT License](https://npmcn.com/package/%40goodandready/dsh-russian-lang/LICENSE) 许可证发布。

## 常见问题

### @goodandready/dsh-russian-lang 是什么？

\* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*

### 如何安装 @goodandready/dsh-russian-lang？

在项目目录运行 npm install @goodandready/dsh-russian-lang，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4 \|\| ~4\.0\.5 \|\| ~4\.0\.6-alpha\.1 \|\| ~4\.1\.0）、@deepseek-ai/schemastery（~3\.18\.4 \|\| ~3\.18\.5 \|\| ~3\.18\.6-alpha\.1 \|\| ~3\.19\.0）、@deepseek-ai/dsh-settings（0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0）、@deepseek-ai/dsh-home-paths（0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0）、@deepseek-ai/dsh-client-locale（0\.2\.0-rc\.2 \|\| \>=0\.2\.1-rc\.2 \<0\.2\.2-0 \|\| \>=0\.2\.2-0 \<0\.2\.3-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-i18n，可以用 npx dsh-i18n 直接运行。

### @goodandready/dsh-russian-lang 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @goodandready/dsh-russian-lang 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @goodandready/dsh-russian-lang 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @goodandready/dsh-russian-lang 可以商用吗？

@goodandready/dsh-russian-lang 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @goodandready/dsh-russian-lang 的下载量有多少？

根据 npm 官方下载统计，@goodandready/dsh-russian-lang 在 2026/10/17 – 2026/11/15 这 30 天内被下载 16,663 次，日均约 555 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @goodandready/dsh-russian-lang 还在维护吗？

最新版本 0\.4\.30 发布于 2026/11/16（今天）；至今共发布 129 个版本，其中过去 12 个月发布了 129 个；首次发布于 2026/08/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

