d4551/deepseek-harness

DeepSeek Harness

MIT 许可证 · Node.js、bun 1.4、TypeScript 7 · 开发者预览

像给五岁小孩一样解释

DeepSeek Harness 是一个机器人助手的工具箱。你用大白话告诉机器人要做什么。机器人从箱子里挑工具——读文件、跑命令、搜网页——一步步完成工作，并把做过的一切展示给你。当工具需要审批时，由你或可选的评审者决定能否继续。这个工具箱有一扇窗户（Web UI），你可以在里面看机器人干活并和它对话；它甚至能召唤更多机器人，一起共享一张待办清单（Agent Teams）。

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。

它构建于一切皆插件的架构之上，由 Cordis 驱动，其设计参见论文 _A Programming Paradigm for Spatiotemporal Composability_。

文档：https://deepseek-harness.github.io/deepseek-harness/

为什么选择本 fork

本仓库在上游 harness 之上扩展了 npm 包里拿不到的能力与工具链：

- 多智能体 swarm —— 在默认 Web 会话中使用 /swarm ，通过持久名册、任务看板与邮箱协调并发 teammate。Team 控件展示实时活动，并可打开 teammate 会话。
- 展示真实状态的 Web UI —— 在浏览器里管理 workspace 根目录、通过生成的卡片编辑每个插件的设置，并用 diff、搜索、todo、轨迹卡片跟进工作。
- 浏览器搜索与网页阅读 —— 模型通过 Chromium 搜索 Bing 并读取 JavaScript 渲染的页面，无需搜索 API 密钥。浏览器可执行文件、user agent 与并发数均可配置。
- 强化的审批 —— 默认筛查会拒绝缺少理由或命中规避工作短语的请求。可选的对抗式评审者根据完整人类指令历史评估精确工具调用，并拒绝无法决定的请求。
- 现代化工具链 —— bun 1.4 workspace、TypeScript 7、Node 24+（CI 验证），取代上游的 npm/yarn 时代配置。

获取本仓库的代码

本仓库不向 npm 发布任何包。npx @deepseek-ai/dsh 安装的是上游官方发行版而非本 fork——运行本仓库的代码请按下文运行从源码构建。搭建细节见开发指南。

工具链要点：bun 1.4 是包管理器与脚本运行器（isolated workspace linker；dsh plugin 转发给 bun）；TypeScript 7（typescript ^7.0.2）编译 Host 与 Client program，并在 typescript/unstable/sync 与 typescript/unstable/ast 导出 compiler API。

从本仓库构建出的 Web UI 自称 DeepMeow，搭配猫脸标记，源码构建与 official 产物皆然；Web UI 指南说明了该名称出现的位置。

开发者预览

DeepSeek Harness 处于 _开发者预览_ 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

运行本项目前，请阅读安全说明。

运行

从源码运行

安装 Node.js 与 package.json 指定的 bun 版本，然后运行：

git clone https://github.com/d4551/deepseek-harness.git
cd deepseek-harness
bun install
node packages/web/web-fetch-playwright/node_modules/playwright/cli.js install chromium
bun run build
bun run dsh web

bun run build 会准备仓库产物。bun run dsh web 会直接使用这些已构建产物，不会重新构建。

最后一条命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。

在默认 Web 会话中输入 /，即可预览可用命令及其说明。提交 /swarm  可请求并发 teammate。打开 Agent Team，即可跟进成员活动与任务、搜索按对话分组的成员消息，并打开子会话。支持的操作见 Team 控件。

使用 /goal  启动持久目标。提交 /goal 可查看目标，以及编辑、暂停、恢复或清除目标的命令。详见目标命令。

自动审批评审默认关闭。要启用它，请打开设置 → 插件 → 审批流程，将评审者设为由评审者决定，然后保存。评审者通过所选模型提供方接收完整人类指令历史、精确工具参数和理由。只有明确允许才会授权操作一次；拒绝裁决、证据不完整或评审失败都会拒绝请求。详见评审配置与限制。

需要持久协作时，请使用命名 teammate。普通 subagent 和 subagent_fork 调用只完成一次；后台调用返回可通过 job_output 收集或通过 job_kill 停止的 job。Team 消息与后续任务工具以命名 Team member 为目标。

默认由 Chromium 提供 web_search 和渲染式 web_fetch。搜索读取 Bing 结果页；验证挑战或页面拦截会返回明确错误。在设置 → 插件 → 网页访问中选择各能力的提供方；浏览器搜索和抓取配置它们共用的浏览器。DeepSeek、Exa 与 Perplexity 仍是可选的 API 提供方。详见浏览器设置。

社区与支持

- 通过 GitHub Discussions 提交反馈或 bug 报告。
- 为你的插件仓库添加 dsh-plugin 话题，便于被发现。
- 欢迎加入 DeepSeek Harness Discord 社区。

参与贡献

参见 CONTRIBUTING.md。

开发

请先阅读开发指南与架构文档。

源码分析介绍 Babel 语法审计，以及通过 bun run analyze:typescript   查询 TypeScript 7 符号、导入别名、声明位置、推断类型与诊断。

面向 agent：请遵循 AGENTS.md。

许可证

MIT

第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。