deepseek-harness/README.zh.md

DeepSeek Harness

English | 中文

DeepSeek Harness（dsh）是一款基于 DeepSeek Harness SDK 构建的开源 coding agent（智能体）。

它采用了一切皆插件的架构。

内测声明

DeepSeek Harness 正处于内部测试阶段，功能和接口可能发生变化。

为帮助诊断上报的问题，内测版本默认上传所有会话日志。设置 DSH_TELEMETRY_DISABLED=1 可关闭遥测。请通过内部企业微信群反馈问题和建议。

运行

安装 Node.js ^22.19 或 >= 24 和 pnpm 11，然后运行已发布的包：

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 UI 指南。

从源码运行

如需改为运行仓库 checkout：

git clone https://github.com/deepseek-harness/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm dsh web

最后一条命令会构建仓库，并进入相同的 Web UI 路径。

Profile 与插件

profile 是按顺序排列的插件 bundle 列表。随附的 web profile 为 dsh web 提供功能。使用 dsh plugin --profile <name> <pnpm args> 管理 profile；该命令会在对应 profile 目录中将剩余参数转发给 pnpm：

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 参考。

CLI（命令行界面）参考介绍 headless 执行与自定义 profile。Python SDK 和示例介绍程序化组合与自定义组合。

社区

扫描二维码，或打开 DeepSeek Harness 微信社区申请页面 申请加入。

开发

请先阅读开发指南；修改包之前，请阅读架构文档。

面向 agent：遵循 AGENTS.md。

许可证

BSD 3-Clause

第三方依赖及其许可证在 THIRD_PARTY_NOTICES.md 中披露。

参与贡献

向本仓库贡献前，请阅读 CONTRIBUTING.md。