俄语入门指南 Ragnoryok1/deepseek-harness-guide-ru

DeepSeek Harness 中文指南

面向中文用户的 DeepSeek Harness（dsh）指南 —— DeepSeek AI 出品的开源智能体外壳。适用于 0.1.x 系列。

这是什么

dsh 是给编码智能体用的外壳：一个网页界面 + 一个服务端，其中一切都是插件。智能体能读取和编辑项目文件、执行命令、把工作委派给子代理、维护任务计划 —— 你则通过权限策略来管控它。

项目处于 developer preview 阶段，迭代很快 —— 版本之间可能出现破坏性变更。

环境要求

- Node.js 版本 22.19+ 或 24+（nodejs.org）
- Windows、macOS 或 Linux
- DeepSeek API 密钥（platform.deepseek.com）

快速开始（2 分钟）

npx @deepseek-ai/dsh web

这条命令会下载包，在 http://127.0.0.1:3080 启动网页界面，并在浏览器中打开。加 --no-open 参数则只启动服务端，不打开浏览器（SSH 场景下很方便）。

首次运行：三步走

1. 模型密钥

打开 Settings → Models，粘贴 DeepSeek API 密钥并保存。模型立刻就能用，不用重启服务端。也支持其他服务商，包括任何 OpenAI 兼容的端点。

2. 工作目录

点击 Choose workspace，添加你的项目目录。没选目录之前，输入框不可用 —— 这是有意设计的。

3. 第一个任务

新建会话，然后写点东西，比如：

总结这个仓库，并说明它的主要包。
智能体会自己读取文件、提出修改建议，并在需要审批的操作上按当前权限策略征求确认。

先要知道的几件事

- 往聊天里发图片：把文件拖进窗口，或用 Ctrl+V 粘贴（PNG/JPG/WebP/GIF）。
- 提及文件/文件夹/会话：在输入框里输入 @。
- 命令：输入 / 打开命令面板（compact、export、goal、plan、permission……）。
- 权限：/permission 命令切换预设（read-only / workspace-write / danger-full-access）。选到危险预设时，界面会要求你明确确认风险。
- 计划与目标：/plan 打开规划模式，/goal 设定长任务的目标。

俄语界面

官方构建自带中文和英文。完整的俄语界面以单独安装的插件形式提供：

dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru

装好之后，Settings → General → 语言里会出现俄语（通常会自动生效）。这个插件是 dsh.bundle + dsh.client 的混合体：按普通配置档 bundle 安装，自己通过 locale 服务注册 ru。不需要任何构建，也不用改上游代码。

- npm：https://www.npmjs.com/package/@ragnoryok1/dsh-client-locale-ru
- 源码：https://github.com/Ragnoryok1/dsh-client-locale-ru
- 上游公告：https://github.com/deepseek-ai/deepseek-harness/discussions/5582
- 把 ru 直接并入上游的提议仍然开放：Discussion #4172

以前那种走 fork（deepseek-harness_ru）的安装方式已经不需要了——fork 只作为开发历史保留。

去哪里求助

- 问题和 bug：上游 Discussions（Q&A 和 Ideas 分类）
- 社区：Discord DeepSeek Harness
- 用俄语：直接找我——我会回复，并补充这份指南

本指南非官方，由爱好者维护。官方文档：docs/user/guide。