Ragnoryok1/deepseek-harness-guide-ru

DeepSeek Harness 俄语版

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

这是什么

dsh 是编码智能体的 harness：一个 Web 界面 + 服务器，其中一切都是插件。智能体能够读取和编辑项目文件、运行命令、将工作委派给子智能体并维护任务计划——而你可以通过权限策略对其进行控制。

该项目处于开发者预览阶段，发展迅速——不同版本之间可能出现破坏性变更。

要求

- 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 上启动 Web 界面并在浏览器中打开它。--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 的混合体：作为普通的 profile 包安装，并通过 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。