deepseek-harness/README.zh.md

DeepSeek Harness

English | 中文

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

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

安装

使用一条命令安装 dsh：

curl -fsSL https://raw.githubusercontent.com/deepseek-harness/deepseek-harness/master/scripts/install.sh | sh

安装器要求系统已安装 git 和 Node ^22.19 || >=24，缺少 pnpm 时可代为安装，并会提示输入 DeepSeek API 密钥。

安装器会把所有检出都放在 ~/.dsh/source 下：master 克隆位于 ~/.dsh/source/master，每次安装的 staging 检出是一个 git worktree ~/.dsh/source/staging-<时间戳>。稳定符号链接 ~/.dsh/source/current 指向当前生效的 staging worktree，~/.local/bin 中的 dsh 链接到 current/bin/dsh，因此升级只需重指一个符号链接，PATH 上的 dsh 从不移动。再次运行该命令会基于更新后的 master 新增一个 staging worktree，并把 current 重指到它。其他安装位置和选项见 scripts/install.sh。

使用 DeepSeek Harness

Web UI

推荐在本地使用 Web UI。安装完成后以及每次更新后，请先构建前端，再启动 Web UI。通过 dsh 启动器解析当前运行的检出，这样无论当前是哪个 staging worktree，命令都成立（启动器会经由稳定的 current 符号链接解析）：

dsh_bin=$(cd "$(dirname "$(command -v dsh)")" && pwd -P)/$(basename "$(command -v dsh)")
while [ -L "$dsh_bin" ]; do
  link=$(readlink "$dsh_bin")
  case $link in /*) dsh_bin=$link ;; *) dsh_bin=$(cd "$(dirname "$dsh_bin")" && cd "$(dirname "$link")" && pwd -P)/$(basename "$link") ;; esac
done
dsh_dir=$(cd "$(dirname "$dsh_bin")/.." && pwd -P)
pnpm --dir "$dsh_dir" run build && pnpm --dir "$dsh_dir" run build:web
dsh web

Web UI 默认通过 http://127.0.0.1:3080 提供服务。

TUI

启动全屏终端界面：

dsh

Headless

运行一项任务，打印最终答案后退出：

dsh -p "summarize this workspace"

为什么选择 DeepSeek Harness

内置功能涵盖文件读取、编辑与搜索、shell 执行、可复用 skill（技能）、任务跟踪、subagent 与工作流、持久化会话，以及上下文压缩（context compaction）。TUI 还包含 Plan Mode。

• 一切皆插件。 模型、工具、策略、存储、上下文管理和界面均可组合为 Cordis 插件，部署方无需 fork agent loop（智能体循环）即可扩展或替换行为。底层设计见架构文档。
• Code Mode（需显式启用）。 它会提供 run_code 工具和生成的 TypeScript SDK，只有程序输出会重新进入模型上下文。参见 Code Mode。
• 自指 Cordis 工具需显式启用。 这些工具可让 agent 检查自身的实时运行时，并在运行中挂载或卸载插件。参见 Cordis 工具。

社区

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

开发

pnpm install
pnpm run test:coverage

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

面向 agent：遵循 AGENTS.md。

DeepSeek Harness 目前处于预发布阶段。

许可证

BSD 3-Clause