mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

xjt ce883ffea3 Merge remote-tracking branch 'origin/master' into docs/post-v3-release-proofreading

# Conflicts:
#	.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.i18n.yaml
#	.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.zh.md
#	README.i18n.yaml
#	README.zh.md
#	scripts/snapshots/translation-prompt-v4/request-response.expected.json

2026-08-12 16:45:48 +08:00

2.9 KiB

Raw Blame History

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

从源码运行

如需从仓库源码运行：

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

pnpm run build 会准备仓库产物。pnpm dsh web 不会重新构建，而是直接启动同一个 Web UI。

Profile 与插件

profile 由一组按顺序排列的插件组合包构成。随附的 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。

2.9 KiB Raw Blame History Unescape Escape