DeepSeekBot 是 BotHarness 开发的 MIT 开源 GrokBot 平替，作为 deepseekbot 插件安装到 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
本仓库维护 DeepSeekBot 产品及其 BotHarness 插件层。正式品牌连写为 DeepSeekBot；模型调用使用你自己的服务商额度，持续后台任务需要运行 DSH 的宿主保持在线。
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，创建 Bot，先私聊，再建 Group 邀请成员。要接入飞书、Slack、Discord 或微信，到「设置 → IM bots」连接应用，再在 Bot 的 Profile 里绑定应用。飞书应用绑定后，私聊和 @ 它的消息直接进入 Bot 收件箱。安装后账号默认不连接，由你逐个开启。想先试试又不想动现有配置，可以换一个新的 Profile 名字。参见 DSH 官方文档：打包与安装插件。
| 能力 | 说明 |
|---|---|
| 持久身份 | 每个 PersonaBot 有自己的名字、岗位、Soul（SOUL.md）和像素头像，跨对话、Session 与 Workspace 延续。 |
| 看得见的 Git Memory | Bot 的记忆是一个普通 Git 工作树。在侧栏浏览文件、分支、commit 历史与 diff，也能推到 GitHub，在多台机器之间共享同一份记忆。 |
| Group 协作 | 消息保留各自身份，需要谁就 @ 谁。每个成员可以选择每条提醒、摘要、仅提及或静默。 |
| 定时任务 | 让 Bot 每隔几分钟、每小时或每天做一件事。你可以在侧栏新建，也可以直接让 Bot 自己建；锁定后 Bot 只能看、不能改。 |
| Bot 市场 | 从 Bot 市场 一键安装别人分享的 Bot，或把自己的 Bot 发布到 GitHub 分享出去。 |
| Assignments 委派 | 授予 Workspace 后，Bot 可以委派独立的 Assignment，各自保留 Session 与报告；需要你回答或批准时，侧栏会显示待办数。 |
| 自己的 IM 身份 | 在飞书 / Lark、Slack、Discord 和微信里绑定 Bot 自己的身份，被 @ 时在原话题里回复；微信私聊还能收发文件和图片。 |
| 更新提示 | 安装或升级后显示这一版的更新内容；Bot 设置里能看到当前版本，检查 npm 上的新版本并一键安装、重启。 |
| Computer 与 Browser use | 开发中组件：操作共享桌面或受管浏览器，可实时观看与暂停。正式 npm 1.2.0 不含这两个 Bundle。 |
这里是 BotHarness 的 DeepSeekBot：安装包为 deepseekbot，官网为 deepseekbot.app。FeiZhuLulu 的 DS Bot 使用 ds-bot，是另一个独立项目；DS Bot 不是本产品的简称。两者均基于 DSH，均非 DeepSeek 公司官方产品。查看 DeepSeekBot 与 DS Bot 的选型对比。
不是。它使用 DSH 中配置的模型提供商；能否接入取决于接口支持、模型配置与凭据。Bot 的记忆和聊天记录保存在自己的宿主，调用远程模型时相关上下文仍会发给所选服务商。
 Bot 名册与私聊：每个 Bot 有自己的像素头像；右侧是它的记忆演化。 |
 Group 协作：@ 三个 Bot，它们各自回复，Nova 读完前两位再接话。 |
 记忆演化：点一个 commit，就能看到 Bot 改了记忆里的哪几行。 |
 定时任务：一句话让 Bot 自己建任务；侧栏卡片标出是谁建的、是否锁定。 |
 编辑定时任务：按分钟、小时或每天执行，锁定后 Bot 不能改，还能看最近 20 次执行。 |
 Bot 市场：按话题和关键词找 Bot，点「安装」就多一个 PersonaBot（图中为示例数据）。 |
 更新内容：首次安装和每次升级后，Bot 模式会告诉你这一版改了什么。 |
 Bot 设置：查看当前版本，检查更新，打开官网更新日志。 |
截图来自隔离的本地 DSH，点开可看 2880 × 1800 原图。对话由脚本生成，是虚构的天文台展览示例；Bot 市场中的条目为示例数据。
PersonaBot 的 Memory 是一个普通 Git 工作树。笔记、人格、代码和其他文件留在磁盘上，尚未提交的文件也是当前记忆。Bot 可以通过文件、搜索、Shell 和 Git 能力探索与更新记忆；你也可以使用自己的编辑器和 Git 工具。
- Memory files：目录树与文件阅读器，菜单可以打开或定位 Host 上的真实文件，也能下载当前完整内容。
- Memory evolution：分支、commit 历史与当前改动。点击 commit 查看 diff，或检查尚未提交的修改；可选择易读的记忆术语或 Git 术语。
- Recovery checkpoints：为显式恢复保存上下文，保留 Git 作者与历史。也可以从已有 Git 仓库创建 Bot，复用其文件与历史。
把记忆推到 GitHub 等 Git 远端，就能在多台机器、多个 DSH 之间共享同一份记忆。记忆设计 · 恢复决策
让研究员记住依据，让设计师推进体验，让工程师检查细节。Group 中的消息保留每个 Bot 自己的身份；需要某个 Bot 参与时，直接 @ 它。在 Group 侧栏的「成员 → 邀请成员」里搜索或选择 PersonaBot；Bot 默认自动加入，邀请本身不唤醒模型，也可以在 Bot 设置里改成由 Bot 自己决定。
可为每个成员选择收件提醒方式：每条消息、摘要、仅直接提及，或静默收件。Bot 可以调整自己的 Group 提醒偏好，也可以离开 Group。私聊、Bot 间对话、Bot Inbox 与 Human Inbox 保留对话和待办入口。需要在项目中执行工作时，授予 Workspace，让 Bot 委派独立 Assignments，各自保留 Session 与报告。
对 Bot 说「每天早上 9 点读一下日志，给我发个摘要」，它会自己建一个定时任务。你也可以在私聊侧栏的「定时任务」里点 + 手动新建。
- 三种节奏：每隔几分钟、每隔几小时，或每天固定时间（可选时区）。
- 按时唤醒：每次执行都会进入 Bot 收件箱并唤醒 Bot；收件箱里的这一项能直接跳回对应的定时任务。
- 谁建的一目了然：侧栏卡片标出是你建的还是 Bot 建的。锁定之后 Bot 只能看、不能改或删；每个 Bot 最多同时启用 20 个。
- 执行记录：编辑窗口列出最近 20 次执行，并链接到处理它的会话。
Bot 市场 收录公开 GitHub 仓库里分享的 Bot。在 Bot 模式的消息列表点 + → Bot 市场，按话题或关键词浏览，点「安装」后会先显示来源仓库和最新提交，提醒这是第三方内容；确认后它的 Memory 仓库被克隆成你的一个新 PersonaBot。也可以把仓库地址贴进去，立即收录。
想分享自己的 Bot：先检查它的 Memory 里没有不该公开的内容，再按 分享 Bot 教程 让 Bot 自己发布到 GitHub，加上 botharness-bot 话题即可上架。DeepSeekBot 会在每个 Bot 的 Memory 里自动维护 .botharness/bot.json（名称、标签、简介、头像），所以市场里显示的和你侧栏里的一致。不想公开的话，也可以在 Bot 资料页导出 zip 直接发给对方，见 导出与导入 Bot。
首次安装后，以及每次升级后第一次打开 Bot 模式，DeepSeekBot 会弹出这一版（或你上次看过之后所有版本）的更新内容。设置 → Bot 设置 → DeepSeekBot 版本 显示当前版本，「检查更新」会查询 npm；有新版本时列出新内容，可以一键安装并重启 DSH，步骤见 更新 DeepSeekBot。完整记录见 官网更新日志 和仓库里的 CHANGELOG。
版本范围（2026-10-11）：下述为当前源码能力。正式 npm
deepseekbot@1.2.0仅默认提供 Core、Client 与 IM Provider，不含 Computer / Browser Bundle；默认打包这两项的变更仍在 Unreleased。源码运行与正式包安装请分别核对。
当前源码配置包含这两个 Bundle；新 Bot 仍需显式开启对应 Access 才能使用。
| 能力 | 当前已交付 | 启用条件与边界 |
|---|---|---|
| Computer use | 通过 Cua Driver 观察、操作共享桌面，提供 VNC 观看与 Computer Audit。 | 当前源码随 deepseekbot 提供；当前运行容器桌面，需要 Docker。按 Bot 打开 Computer Access，Auto-allow 关闭时，每个 Session 首次动作请求授权。 |
| Browser use | 打开与观察网页；点击、输入、按键、滚动、等待、截图、上传文件与管理多标签。侧栏展示 Bot 当前网页，Human 可以暂停其操作。 | 当前源码随 deepseekbot 提供；在 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；正式 npm 1.2.0 不默认包含它们。运行时设计 · Computer 契约
把 PersonaBot 绑定到自己的平台 Bot 账号，外部消息就以这个 Bot 获授权的身份发出。已支持 飞书 / Lark、Slack、Discord 和微信，连接由 DeepSeekBot 随包管理的 IM Provider（维护自 dsh-im）负责传输、凭据与连接生命周期。
- 在群聊或话题里 @Bot，消息进入该 PersonaBot 的 Inbox，由它在原话题回复。
- 只有你授权过的群和频道才会进入 Bot 的 Inbox；出站发送需要显式授权，并留有发送记录。
- 可以按 Bot 设置收件方式：只响应提及、按数量或时间汇总普通消息，或立即唤醒。
- 微信私聊里，Bot 能接收你发来的文件并在原私聊回传处理结果；源码版还支持图片预览和图片回复。
每个 Bot 的默认头像都由名字生成：同一个名字，在哪里都是同一张脸。Bot 工作时，头像会一颗像素一颗像素地变成它正在用的工具（读文件、终端、搜索、等你批准……）。到官网输入名字试试，还能下载高清头像。头像来自开源的 BotPixel（@botharness/pixel-avatar 与 @botharness/pixel-morph），上面截图里的所有头像都是它生成的。
每个版本的核心变化，完整条目见 CHANGELOG 和 官网更新日志。
| 版本 | 核心内容 |
|---|---|
| 下一版（未发布） | 微信原始语音可准备后播放；Discord 的外部平台默认值可独立保存，由 Profile 设置继承。 |
| 1.1.0（2026-10-06） | Bot 定时任务（侧栏新建，或让 Bot 自己建、改、删，锁定后 Bot 不能改）；每个 Session 都带上 Bot 的 Soul 与核心记忆（SOUL.md + MEMORY.md，见 教程）；Bot 设置里一键更新并重启；Channel 侧栏统一为卡片样式；微信支持语音转写和图片；Memory 自动维护 .botharness/bot.json；可关闭的匿名使用统计。 |
| 1.0.2（2026-10-06） | 安装和升级后显示更新内容，Bot 设置里检查 npm 新版本；新增 分享 Bot 教程；上下文读取保留准确的 source-conflict 拒绝。 |
| 1.0.1（2026-10-05） | 首个 npm 正式版：拥有各自身份的 PersonaBots、Git Memory、Group、Assignment、像素头像，飞书 / Lark、Slack、Discord 和微信身份（微信私聊可收发文件），以及首版 Bot 市场。1.0.0 未作为产品发布。 |
| 开发历史（截至 2026-09-20） | 首个版本之前的基础：PersonaBot 身份与文件记忆、Bot 模式的频道外壳与名册、从 Git 仓库创建 Bot、在 Host 上打开记忆文件，以及双语文档站。 |
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/DeepSeekBot.git BotHarness
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 随 deepseekbot umbrella 提供），验证已认证 API，并打印本地登录 URL。打开后进入 Bot mode，创建 Bot、发送私聊，再建 Group 邀请成员。在 Bot 私聊的侧栏打开 Memory files 或 Memory evolution。
helper 可注入机器本地的 DeepSeek key，也可使用隔离 Profile 的凭据；密钥始终留在仓库外。模型配置、可选 IM 安装和 Client/Host 开发循环见 本地实例指南。
- DeepSeekBot 官网 · 文档站 · 介绍 Slides
- 产品术语 · 持续维护的架构与数据流 · 架构决策
- 贡献指南 · Agent 开发规范 · 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独立 Lark 测试 App 可配置一次并跨 worktree、branch 和 session 复用：node scripts/dev-im-test-apps.mjs setup。凭据只保存在机器本地，每次测试前仍须协调独占接收窗口；见共享测试 App 指南。
稳定的本地文档域名：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 Discussions · 欢迎帖
- 明确的 Bug 与实施任务：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。
BotHarness/DeepSeekBot 的实时 Star 历史，使用 Star History 官方嵌入方式。