The project's README from github.com/libukai/awesome-deepseek-harness. As one markdown file: README.md.
DeepSeek Harness 终极指南:资料、教程、插件与工具
本项目秉持少而精的原则,精选并收录 DeepSeek Harness 相关优质资源,与更多 AI 从业者共同构建更繁荣的 Agent 生态。
如果这个项目对你有帮助,欢迎点一个 ⭐;也欢迎关注 𝕏 @李不凯正在研究,获取更多 Agent 实践内容。
DeepSeek Harness(简称 DSH 或 dsh)是 DeepSeek AI 开源的 Agent Harness 项目。它基于 Cordis,采用 Everything is a Plugin(一切皆插件) 的架构:模型适配器、工具、会话日志、界面和 Agent Loop 都可以通过插件树组合与替换。
当前核验到的官方 GitHub 开发者预览版为 0.1.2-rc.1;npm latest 与 next 均已指向 0.1.2-rc.1。该 RC 增加完整历史回合导航、精确 Token / 耗时统计、子代理模型选择、ACP 标准控件、定时任务和断线重连,并以可双向继续的 send_message 取代单向 report。公开 WebFetch 默认启用但有 SSRF 防护;SQLite Session Backend 已移除(旧数据保留,导出需旧版本);DeepSeek 适配器默认附带已启用插件包名与版本(可关闭),Session 日志增量上传仍为可选且默认关闭。官方同时明示未经安全审计,Sandbox、Approval 与 Permission 不构成完全隔离保证。下方各项目标注的 DSH 版本仅代表作者声明的开发或测试基线,不应自动视为已兼容最新预览版。
安装 Node.js 22.19.x 或 24+(推荐 24+)后执行:
npx @deepseek-ai/dsh web
默认访问 http://127.0.0.1:3080。进入 Settings → Models 配置模型服务后即可创建会话。详细步骤见官方快速开始和模型服务配置。
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
官方 Python SDK 支持通过内置运行时以编程方式调用 Harness,无需在系统中安装 Node.js。当前要求 Python 3.10+,支持情况和平台限制以官方 Python SDK 指南为准。
python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk
web 和 headless 是发行版内置的 Profile。外部插件以声明 dsh.bundle 的 Bundle 加入指定 Profile:
dsh plugin --profile web add <package-or-git-spec>
dsh --profile web --dump-config
从 Git 仓库安装时,建议固定 commit,并先检查安装脚本。pnpm 可能要求显式授权依赖的构建脚本;这些构建脚本会在 Agent 沙箱之外执行。完整机制见官方插件打包与安装教程。
官方提供开源仓库、配套论文和较完整的参考文档,并持续运营开发者社区。
| 教程 | 形式 | 内容 |
|---|---|---|
| DeepSeek Harness 从零到一 | 中文教程与 Demo | 包含原理、源码拆解、8 个 Demo 和 mini-harness 教学项目 |
| DeepSeek Harness:从开机到拆开 | 中文实测电子书 | 提供 PDF、EPUB 和 HTML,收录完整系统提示词、129 行默认启动清单与三份原始会话日志 |
| 解剖 DeepSeek Harness | 交互式源码专题 | 拆解会话、上下文、工具、沙箱、Code Mode 和 Subagent 等核心机制 |
| Cordis 在做什么:从 DeepSeek Harness 看 | 中文架构短文 | 从插件作者视角解释 Cordis 心智模型,讨论复杂度如何转移到系统内部 |
| DeepSeek Harness 白皮书 | 中英双语手册 | 14 章覆盖安装、插件开发、安全与成本,提供在线阅读、PDF 和可运行示例;内容采用 CC BY-NC-SA 4.0,基于 0.1.0-rc.6 |
| NanoCordis | 可运行的教学实现 | 用约 1,600 行 TypeScript 重建 Cordis 插件框架与 DSH 形态的 Agent Runtime;MIT、npm 0.1.0、95 项测试,默认 Fake Model 无需 Key,Bash 工具仍需人工批准,真实模型凭据只从环境变量读取 |
收录包含完整论述、实践细节或一手背景的公开社交媒体长帖,补充官方资料未覆盖的背景与实践细节。
| 长帖 | 作者与背景 | 内容摘要 |
|---|---|---|
| 从早期参与者视角理解 DSH | Jiayuan (JY) Zhang;作者自述提前一个月获得仓库访问权限 | 将 DSH 同时理解为可运行的 Coding Agent 和 Agent 开发框架;用“乐高汽车”解释一切皆插件,并讨论 Runtime 自扩展、自进化软件雏形、当前成熟度和函数式编程特征。 |
| 从 Agent Runtime / Agent OS 视角理解 DSH | Anionex;内测参与者与插件作者 | 从模型、工具、策略、存储、上下文、界面和 Loop 的可组合性解释 DSH,并讨论 Agent 对运行时的有限观察与自扩展。 |
| 玩了一夜 DeepSeek Harness,我发现它在用《我的世界》的方式干掉 Claude Code | 品玩;发布首夜的媒体观察 | 用《我的世界》的原版、Mod、CurseForge 与整合包类比 DSH 本体、插件、目录和发行版,并记录首夜的兼容性与安全争议。 |
| 从源码对照 DSH 与 Codex:声明式插件 vs 可替换 Agent Loop | 鸭哥;读完源码后与 Codex 逐行对照。展开文见 yage.ai | 将 Codex 的声明式插件与 DSH 的命令式进程内插件对照,认为日常写代码并不需要 Cordis 的复杂度;唯一结构性优势是 Agent Loop 本身可热替换,从而为自进化 Harness 提供物理插槽。 |
以下项目提供了独立的用户界面、发行形态或产品化组装,而不只是单个工具能力。
分类说明: 发行版或 Fork 会直接复用、修改或重新打包完整的 DSH Runtime,不能通过
dsh plugin安装,因此不属于插件;独立客户端则通过 Web、RPC、ACP 或配套桥接插件连接 DSH。它们仍然是 Harness 生态的重要组成部分。
| 项目 | 平台 / 形态 | 说明 |
|---|---|---|
| DeepSeek Harness Desktop (anywhere-labs) | macOS (Apple Silicon) / Windows · Electron | v2.0.2 固定并原样运行 DSH 0.1.1-rc.2,提供本地服务、系统托盘、恢复 / 回滚和内置插件市场;上游含破坏性更新,旧 Profile 与未适配插件可能失效,升级前应先新建安全 Profile 并保留插件清单 |
| dsh-desktop | macOS / Windows · Electron · 早期 | 原样复用官方 Web UI,并让长任务常驻托盘;关闭渲染层 Node 集成、限制导航、更新包校验 SHA-256,但 Agent 进程仍拥有普通用户级文件权限,发行包也尚未正式开发者签名 |
| DeepSeek Harness Desktop (steven-kid) | macOS / Windows / Linux · Electron · 早期 | 保持原版 Web UI 的最小桌面壳,使用随机回环端口、Electron 沙箱和 contextIsolation,发行包通过跨平台启动冒烟测试;macOS 尚未公证,Windows 尚未商业签名 |
| DeepSeek Harness Desktop App | macOS / Windows · Electron · 社区工作台 | v0.1.9 在官方 Web / Profile 运行链上提供项目、Git Worktree、浏览器、Canvas、Site、Office 产物、文件 / 文件夹附件和 14 个固定 Bundle;macOS Apple Silicon 包已签名公证,Windows x64 包未签名但已在 GitHub Windows Runner 验收安装、启动、断网 Profile、恢复、卸载与残留清理。中断的插件安装会在下次启动安全重试,用户主动卸载的插件不会被自动补回 |
| TinyWhale | macOS · Electron · 发行版 Fork | 直接 Fork deepseek-ai/deepseek-harness 并增加独立桌面壳;连接已有 Web UI,或启动完整的 dsh web Runtime,不属于插件 |
| Oh-DSH | macOS / Linux / Windows · 社区发行版 | 将 DSH、Node.js 与本地能力打包为 Desktop、Web 和 TUI 三种形态,提供分层安装包与统一的 ohdsh 启动器 |
| DSH Desktop | macOS / Windows · Electron | 管理本地 Harness、工作区、随机端口、Profile、插件和会话的跨平台桌面端 |
| dsh-launcher | Windows · WebView2 | 提供静默启动、独立窗口、便携包和 MSI 的轻量启动器 |
| 项目 | 类型 | 说明 |
|---|---|---|
| dsh-TUI | TUI Bundle | Claude Code 风格全屏终端、流式状态、上下文仪表与会话回退 |
| dsh-tianshu-tui | TUI Bundle | 基于天枢演进的完整终端交互层,状态来自 DSH 会话事件流 |
| dsh-tui | TUI Bundle · 早期 | 支持本地 DeepSeek 与离线运行;仍处于活跃开发期,移植前的测试套件尚未恢复运行 |
| dsh-mini-tui | TUI 插件 · 早期 | 直接连接 DSH Runtime 的轻量终端界面;MIT、v0.2.0,通过 npm 安装,并以 DSH 0.1.0-rc.6 开发与测试 |
| Orbis | 移动远控 · Beta | 通过 DSH 插件完成设备配对、端到端加密传输和多设备实时更新 |
| dsh-web-ui | Web UI 集合 | 汇总任务看板、Git Graph、移动界面、皮肤、宠物和运行统计等组件 |
| dsh-web | Docker Web · 早期 | 通过 Docker 部署完整 Web 界面、工作区和插件市场;项目处于高速开发期,需挂载数据卷持久化配置与会话 |
项目被收录不代表已经签名、公证、自包含或适合生产环境;请查看各项目 README 和 Releases 中的当前说明。
allow / deny 自动审批决策。0.2.1,声明兼容 DSH 0.1.1-rc.1 并附测试套件;但仍为同日快速迭代项目,尚无 CI、GitHub Release 或独立使用证据,标注为早期。插件会在 ~/.dsh/spec-collab 写入协作账本与独立 Git 仓库,并启动额外 AI 审核会话;HTTP 管理面默认仅回环与同源,花名并非身份认证,对外开放前必须另配认证和可信反向代理。0.1.0,固定 DSH 0.1.1-rc.2,仓库声明 104 项测试并在 macOS / Windows 做过原生隔离验收。它不新增自定义事件,也不是 Sandbox、Memory 或语义证明系统;命令副作用解析和证据匹配仍可能漏判,同日首发且缺少独立使用证据,因此标注为早期。open-record-replay 本地源码副本。v0.1.1,功能仍处早期。