DeepSeekBot

中文 ｜ English

开源的 GrokBot 平替。一组有各自身份、人格和记忆的 bots，一起做事。

官网 · 宣传片 · 安装 · 能力 · 截图 · 版本亮点 · Bot 市场 · 社区 · 文档

DeepSeekBot 以一个 npm 包装进 DeepSeek Harness（DSH）：Bot 名册、私聊与 Group、看得见的 Git Memory、任务委派，以及 Bot 自己的 IM 身份。创建负责研究、设计或实现的 PersonaBots，分别私聊，或把它们带进 Group 协作；每个 Bot 保留自己的文件与历史，跨对话、Session 和 Workspace 延续。

• GrokBot 的开源平替，MIT 开源
• 基于 DeepSeek Harness，你在 DSH 里接入的任何模型 provider 都能用
• 兼容其他 DSH 插件，可以和它们装在同一个 Profile
• 连接飞书 / Lark、Slack、Discord 和微信，Bot 用自己的身份发言
• 定时任务与 Bot 市场：让 Bot 按时做事，一键安装或分享别人做好的 Bot

本仓库是 BotHarness：为 DSH agent 提供持久身份的插件层，DeepSeekBot 是它的首个产品。

宣传片

3 分钟看懂 DeepSeekBot：一组有身份、人格和记忆的 bots，在小镇里一起做事。点击封面即可播放。

安装

桌面端：打开 DeepSeek Harness 桌面端，点「插件 → 添加插件」，在「包名或地址」里输入 deepseekbot，保持「npm 官方源」，点「安装」。显示「已安装」后点「立即启用」（提示重启时重启当前 Profile），侧栏会出现「Bot 模式」。还没装 DSH？先下载桌面端。

开发者（命令行）：需要 Node 22 以上，支持 DSH 0.2.0-rc.1 起的 0.2 系列。

npm i -g @deepseek-ai/dsh@0.2.0-rc.1
dsh plugin --profile web add deepseekbot
dsh web

打开后进入 Bot mode，创建 PersonaBot，先私聊，再建 Group 邀请成员。要接入飞书、Slack、Discord 或微信，到「设置 → IM bots」连接应用，再在 Bot 的 Profile 里绑定身份、授权群组。安装后账号默认不连接，由你逐个开启。想先试试又不想动现有配置，可以换一个新的 Profile 名字。参见 DSH 官方文档：打包与安装插件。

每个 Bot 都是一位同事

截图

Bot 名册与私聊：每个 Bot 有自己的像素头像；右侧是它的记忆演化。	Group 协作：@ 三个 Bot，它们各自回复，Nova 读完前两位再接话。
记忆演化：点一个 commit，就能看到 Bot 改了记忆里的哪几行。	定时任务：一句话让 Bot 自己建任务；侧栏卡片标出是谁建的、是否锁定。
编辑定时任务：按分钟、小时或每天执行，锁定后 Bot 不能改，还能看最近 20 次执行。	Bot 市场：按话题和关键词找 Bot，点「安装」就多一个 PersonaBot（图中为示例数据）。
更新内容：首次安装和每次升级后，Bot 模式会告诉你这一版改了什么。	Bot 设置：查看当前版本，检查更新，打开官网更新日志。

截图来自隔离的本地 DSH，点开可看 2880 × 1800 原图。对话由脚本生成，是虚构的天文台展览示例；Bot 市场中的条目为示例数据。

看得见的 Git Memory

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

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

把记忆推到 GitHub 等 Git 远端，就能在多台机器、多个 DSH 之间共享同一份记忆。记忆设计 · 恢复决策

把不同的 bots 带进 Group

让研究员记住依据，让设计师推进体验，让工程师检查细节。Group 中的消息保留每个 Bot 自己的身份；需要某个 Bot 参与时，直接 @ 它。在 Group 侧栏的「成员 → 邀请成员」里搜索或选择 PersonaBot；Bot 默认自动加入，邀请本身不唤醒模型，也可以在 Bot 设置里改成由 Bot 自己决定。

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

定时任务：让 Bot 按时做事

对 Bot 说「每天早上 9 点读一下日志，给我发个摘要」，它会自己建一个定时任务。你也可以在私聊侧栏的「定时任务」里点 + 手动新建。

• 三种节奏：每隔几分钟、每隔几小时，或每天固定时间（可选时区）。
• 按时唤醒：每次执行都会进入 Bot 收件箱并唤醒 Bot；收件箱里的这一项能直接跳回对应的定时任务。
• 谁建的一目了然：侧栏卡片标出是你建的还是 Bot 建的。锁定之后 Bot 只能看、不能改或删；每个 Bot 最多同时启用 20 个。
• 执行记录：编辑窗口列出最近 20 次执行，并链接到处理它的会话。

设计决策

Bot 市场：分享和安装 Bot

Bot 市场 收录公开 GitHub 仓库里分享的 Bot。在 Bot 模式的消息列表点 + → Bot 市场，按话题或关键词浏览，点「安装」后会先显示来源仓库和最新提交，提醒这是第三方内容；确认后它的 Memory 仓库被克隆成你的一个新 PersonaBot。也可以把仓库地址贴进去，立即收录。

想分享自己的 Bot：先检查它的 Memory 里没有不该公开的内容，再按 分享 Bot 教程 让 Bot 自己发布到 GitHub，加上 botharness-bot 话题即可上架。DeepSeekBot 会在每个 Bot 的 Memory 里自动维护 .botharness/bot.json（名称、岗位、头像），所以市场里显示的和你侧栏里的一致。

更新与更新日志

首次安装后，以及每次升级后第一次打开 Bot 模式，DeepSeekBot 会弹出这一版（或你上次看过之后所有版本）的更新内容。设置 → Bot 设置 → DeepSeekBot 版本 显示当前版本，「检查更新」会查询 npm；有新版本时列出新内容，可以一键安装并重启 DSH，步骤见 更新 DeepSeekBot。完整记录见 官网更新日志 和仓库里的 CHANGELOG。

Computer use 与 Browser use

这两个 Bundle 目前只在源码版中可选，不包含在 npm 上的 deepseekbot 包里。

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

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

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

让 Bot 以自己的 IM 身份发言

把 PersonaBot 绑定到自己的平台 Bot 账号，外部消息就以这个 Bot 获授权的身份发出。已支持 飞书 / Lark、Slack、Discord 和微信，连接由 DeepSeekBot 随包管理的 IM Provider（维护自 dsh-im）负责传输、凭据与连接生命周期。

• 在群聊或话题里 @Bot，消息进入该 PersonaBot 的 Inbox，由它在原话题回复。
• 只有你授权过的群和频道才会进入 Bot 的 Inbox；出站发送需要显式授权，并留有发送记录。
• 可以按 Bot 设置收件方式：只响应提及、按数量或时间汇总普通消息，或立即唤醒。
• 微信私聊里，Bot 能接收你发来的文件并在原私聊回传处理结果；源码版还支持图片预览和图片回复。

连接指南：飞书 / Lark · Slack · 微信。

像素头像：输入名字，得到一张脸

每个 Bot 的默认头像都由名字生成：同一个名字，在哪里都是同一张脸。Bot 工作时，头像会一颗像素一颗像素地变成它正在用的工具（读文件、终端、搜索、等你批准……）。到官网输入名字试试，还能下载高清头像。头像来自开源的 BotPixel（@botharness/pixel-avatar 与 @botharness/pixel-morph），上面截图里的所有头像都是它生成的。

版本亮点

每个版本的核心变化，完整条目见 CHANGELOG 和 官网更新日志。

站在 DeepSeek Harness 上

DeepSeekBot 直接用 DSH 自己的 Session 管理和 Harness：你在 DSH 里接入的任何 LLM 模型 provider，Bot 都能用；也可以和其他 DSH 插件装在一起。个别插件可能还不兼容，遇到了欢迎提 Issue 或 PR。

双语 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（包括可选的 Computer 与 Browser），验证已认证 API，并打印本地登录 URL。打开后进入 Bot mode，创建 PersonaBots、发送私聊，再建 Group 邀请成员。在 Bot 私聊的侧栏打开 Memory files 或 Memory evolution。

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

文档与开发

• DeepSeekBot 官网 · 文档站 · 介绍 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

社区

问题、想法，还有你做出来的 Bot，都欢迎带来。

• Discord：加入 DeepSeekBot 服务器
• QQ 群：在 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 官方嵌入方式。