docs(i18n): address final proofreading feedback

This commit is contained in:
xjt
2026-08-12 16:43:38 +08:00
parent c2880d6d9b
commit 0a8c9fb1f9
33 changed files with 42 additions and 41 deletions
+10 -10
View File
@@ -2,31 +2,31 @@
[English](README.md) | 中文
DeepSeek Harness`dsh`)是一款基于 DeepSeek Harness SDK 构建的开源 coding agent(智能体)。
DeepSeek Harness`dsh`)是一款基于 DeepSeek Harness SDK 构建的开源 coding agent编程智能体)。
它采用了**一切皆插件**的架构。
## 内测
## 内测
DeepSeek Harness 正处于内部测试阶段,功能和接口可能发生变化。
为帮助诊断上报的问题,内测版本默认上传所有会话日志。设置 `DSH_TELEMETRY_DISABLED=1` 可关闭遥测。请通过内部企业微信群反馈问题和建议。
内测版本默认上传所有会话日志,以帮助我们排查反馈的问题。设置 `DSH_TELEMETRY_DISABLED=1` 可关闭遥测。请通过内部企业微信群反馈问题和建议。
## 运行
安装 Node.js ^22.19 或 >= 24 和 pnpm 11,然后运行已发布的包:
请先安装 Node.js(版本要求:`^22.19``>=24`和 pnpm 11,然后运行已发布的包:
```sh
npx @deepseek-ai/dsh web
```
该命令会初始化 Web profile 并打印 Web UI 地址,默认地址为 `http://127.0.0.1:3080`。打开该地址,在**设置 → 模型**中添加 DeepSeek API 密钥,然后启动一个会话。调用目录是默认工作区;你可以尝试输入 `Summarize this repository and identify its main packages.`
该命令会初始化 Web profile 并打印 Web UI 地址,默认地址为 `http://127.0.0.1:3080`。打开该地址,在**设置 → 模型**中添加 DeepSeek API 密钥,然后启动一个会话。运行命令时所在的目录将作为默认工作区;你可以尝试输入 `Summarize this repository and identify its main packages.`
下一步请阅读 [Web UI 指南](docs/user/guide/)。
### 从源码运行
如需改为运行仓库 checkout
如需从仓库源码运行
```sh
git clone https://github.com/deepseek-harness/deepseek-harness.git
@@ -35,18 +35,18 @@ pnpm install
pnpm dsh web
```
最后一条命令会构建仓库,并进入相同的 Web UI 路径
最后一条命令会构建仓库,再启动同一个 Web UI。
## Profile 与插件
profile 按顺序排列的插件 bundle 列表。随附的 `web` profile `dsh web` 提供功能。使用 `dsh plugin --profile <name> <pnpm args>` 管理 profile;该命令会在对应 profile 目录中将剩余参数转发给 pnpm:
profile 由一组按顺序排列的插件组合包构成。随附的 `web` profile 用于运行 `dsh web`。使用 `dsh plugin --profile <name> <pnpm args>` 管理 profile;该命令会在对应 profile 目录中将剩余参数转发给 pnpm:
```sh
npx -p @deepseek-ai/dsh dsh plugin --profile web add <package>
npx -p @deepseek-ai/dsh dsh plugin --profile web remove <package>
```
`add``remove``update``why` 等 pnpm 命令均可直接使用。该命令会先初始化不存在的 profile,再修改其中的包,并根据声明了 `dsh.bundle` 的已安装包更新 bundle 列表。准确行为见 [CLI 参考](apps/cli/reference/README.md#plugin-management)。
`add``remove``update``why` 等 pnpm 命令均可直接使用。该命令会先初始化不存在的 profile,再修改其中的包,并根据声明了 `dsh.bundle` 的已安装包更新 bundle 列表。具体行为见 [CLI 参考](apps/cli/reference/README.md#plugin-management)。
[CLI(命令行界面)参考](apps/cli/README.md)介绍 headless 执行与自定义 profile。[Python SDK](python/README.md) 和[示例](examples/README.md)介绍程序化组合与自定义组合。
@@ -68,7 +68,7 @@ npx -p @deepseek-ai/dsh dsh plugin --profile web remove <package>
[BSD 3-Clause](LICENSE)
第三方依赖及其许可证 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) 中披露
第三方依赖及其许可证 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
## 参与贡献