BotHarness 在 DeepSeek Harness（DSH） 中为 agent 提供持久身份。创建负责研究、设计或实现的 PersonaBots，分别私聊，或把它们带进 Group 协作。每个 Bot 保留自己的文件与历史，跨对话、Session 和 Workspace 延续。

BotHarness 是本仓库的插件层；DeepSeekBot 是首个应用，提供 Bot 名册、对话、记忆视图和委派。它基于 DSH 的 Plugin、Bundle 与 Session 能力构建；这里介绍的是 BotHarness 的产品能力，由社区插件交付。

Git Memory · Group 协作 · Computer 与 Browser use · IM 身份 · 开始使用 · 文档 · 社区

看得见的 Git Memory

PersonaBot 的 Memory 是一个普通 Git 工作树。笔记、人格、代码和其他文件留在磁盘上，尚未提交的文件也是当前记忆。Bot 可以通过文件、搜索、Shell 和 Git 能力探索与更新记忆；你也可以使用自己的编辑器和 Git 工具。

真实 DSH 截图，内容为虚构的展览笔记。graph 展示研究分支的合并；点击 commit，即可在历史旁查看文件 diff。未裁切原图。

• Memory files：目录树与文件阅读器，菜单可以打开或定位 Host 上的真实文件，也能下载当前完整内容。
• Memory evolution：分支、commit 历史与当前改动。点击 commit 查看 diff，或检查尚未提交的修改；可选择易读的记忆术语或 Git 术语。
• Recovery checkpoints：为显式恢复保存上下文，保留 Git 作者与历史。也可以从已有 Git 仓库创建 Bot，复用其文件与历史。

远端仓库可通过普通 Git 操作使用；项目没有内置的一键自动远端同步服务。记忆设计 · 恢复决策

把不同的 bots 带进 Group

让研究员记住依据，让设计师推进体验，让工程师检查细节。Group 中的消息保留每个 Bot 自己的身份；需要某个 Bot 参与时，直接 @ 它。

打开 Members → Invite member，搜索或选择 PersonaBot，再发出邀请。Bot 默认自动加入，邀请本身不唤醒模型；也可以为 Bot 配置手动决策。

隔离本地 Group 中的真实模型回复：Mira 回顾访客需求，Theo 提出布局，Nova 阅读前两位的回复后补充实现与检查步骤。

可为每个成员选择收件提醒方式：每条消息、摘要、仅直接提及，或静默收件。Bot 可以调整自己的 Group 提醒偏好，也可以离开 Group。私聊、Bot 间对话、Bot Inbox 与 Human Inbox 保留对话和待办入口。需要在项目中执行工作时，授予 Workspace，让 Bot 委派独立 Assignments，各自保留 Session 与报告。

Computer use 与 Browser use

能力	当前已交付	启用条件与边界
Computer use	通过 Cua Driver 观察、操作共享桌面，提供 VNC 观看与 Computer Audit。	可选 @botharness/computer Bundle；当前运行容器桌面，需要 Docker。按 Bot 打开 Computer Access，Auto-allow 关闭时，每个 Session 首次动作请求授权。
Browser use	打开与观察网页；点击、输入、按键、滚动、等待、截图、上传文件与管理多标签。侧栏展示 Bot 当前网页，Human 可以暂停其操作。	可选 @botharness/browser Bundle；在 Host 上运行受管 Bot Browser。按 Bot 打开 Browser Access；Auto-allow 关闭时需授权 Session；命名 browser profile 可保留不同登录数据，分配到同一 profile 的 Bots 共享它。

复用 Browser profile 验证 截图：Bot 已读取本地测试页，预览与 Human 控件可用。

每个 Bundle 的 DSH Profile 配置 autoAllowActions 默认关闭。开启后，该 Bundle 的操作跳过逐 Session 授权，但仍需按 Bot 开启对应 Access。

标签归属决定某个 Bot 操作哪一页；同一 browser profile 中的标签不是安全隔离边界。Computer 与 Browser Access 独立控制。开发启动器包含这两个可选 Bundle，新 Bot 仍需显式开启对应 Access。运行时设计 · Computer 契约

让 Bot 以自己的 IM 身份发言

IM 方向是将 PersonaBot 绑定到自己的平台 Bot 账号，让外部消息以该 Bot 获授权的身份发出。飞书 / Lark 是首个正在推进的接入，由 dsh-im 持有传输、凭据与连接生命周期。

当前交付边界：

• 已交付，需主动选择的开发路径：Profile 绑定、显式出站授权与持久发送记录。隔离验证使用固定版本的临时 dsh-im fork；普通上游 npm 4.32.0 缺少所需公开契约。已有出站证据是 provider 接受，不等于接收方已看到或阅读消息（#117、#624）。
• 仍在推进：真实群组或 Thread 的 @Bot 进入对应 PersonaBot 的 Inbox 与 Orchestrator，再向同源回复（#12）。provider 的提及与话题回复已有验证，但尚不能据此宣称完整产品链路已交付。
• 规划中：外部 Channel/Inbox Bridge、普通消息收件、有限上下文读取与 Bot 主动选择跟随 Thread（#48、#629）。其他 IM 平台（包括 Slack、Discord、QQ 和微信）需要独立 provider 验证，此处不列为可用接入。

参见 可选 IM 验证配置。默认安装不会启用这条外部发言路径。

当前状态

项目是 源码预览，基于固定的 DSH 0.2.0-rc.1 开发。本地 PersonaBot 创建、私聊与 Group、Git Memory、Assignment 委派、模型计划与用量视图、Computer use 和 Browser use 已有合并实现。这不代表已有稳定可下载的 BotHarness 发布：当前包仍为 private，下方方式从源码构建。

双语 Release Ledger 记录已交付变化；Issues 与 Projects 跟踪后续工作。持续维护的架构也包含目标设计与实现边界，设计页面本身不是交付承诺。

从源码开始使用

需要 Node ≥22（仓库固定 Node 24.21.0）和 pnpm 12.4.2。让 Bot 回复前，配置可用模型凭据；只有容器 Computer 需要 Docker。

git clone https://github.com/BotHarness/BotHarness.git
cd BotHarness
pnpm install
pnpm build
node scripts/dev-instance.mjs --home /tmp/botharness-demo --port 31967

选择一个全新的 --home 目录作为隔离 DSH Profile。helper 使用工作树固定的 CLI、链接本地 Bundles，验证已认证 API，并打印本地登录 URL。打开后进入 Bot mode，创建 PersonaBots、发送私聊，再建 Group 邀请成员。在 Bot 私聊的侧栏打开 Memory files 或 Memory evolution。

helper 可注入机器本地的 DeepSeek key，也可使用隔离 Profile 的凭据；密钥始终留在仓库外。模型配置、可选 IM 安装和 Client/Host 开发循环见 本地实例指南。

文档与开发

• 文档站 · 介绍 Slides
• 产品术语 · 持续维护的架构与数据流 · 架构决策
• 贡献指南 · Release Ledger · DSH 官方文档

pnpm lint && pnpm format:check && pnpm typecheck && pnpm test
pnpm build
pnpm dev:client    # 隔离本地 DSH Profile 的 Client 自动构建
pnpm docs:dev      # 文档预览：http://localhost:4321

稳定的本地文档域名：pnpm dev → https://docs.botharness.localhost（首次可能请求信任本地 CA）；免 sudo 方式为 PORTLESS_PORT=8788 PORTLESS_HTTPS=0 pnpm dev。文档页从仓库源文件生成，请修改源文件。Slides 位于 apps/presentations，用 pnpm slides:dev 迭代。

packages/core         PersonaBot 身份、记忆、Messaging、Inbox、Assignments
packages/client       @botharness/ui：Bot 名册与宿主内交互
packages/computer     可选共享容器 Computer
packages/browser      可选受管 Bot Browser
packages/deepseekbot   DeepSeekBot Bundle
apps/docs             文档站
apps/presentations    介绍与其他 Slides

社区

在 QQ 中搜索群号 1125565676 加入社区。顶部徽章链接到这里；当前没有发布已验证的邀请链接或二维码。问题反馈、功能建议与开发讨论请使用 GitHub Issues。

灵感与致谢

• Grok Bot：持久 Bot，以及像同事一样沟通和委派工作的产品灵感。
• Rakazo：持久 AI 队友、对话与记忆体验参考。
• deepseek-harness-workbench-plugin：Memory Git graph 分支线、提交列表与 diff 呈现参考。
• DeepSeek Harness：上游插件宿主。
• dsh-im、dsh-lark-link 与 dsh-lark-bridge：IM 接入基础与可靠性、路由参考。

许可

MIT，见 LICENSE。Client Bundle 中分发的第三方素材见 THIRD_PARTY_NOTICES.md。

Star History

BotHarness/BotHarness 的实时 Star 历史，使用 Star History 官方嵌入方式。