BrainDog

你的 Agent 负责跟进，你来做决定。

项目、决策和资金，一处管理。每个 Agent 都会在开始前读取这里，并记录自己做了什么。 资金、密钥和删除操作都要等你确认。

BrainDog 是开源的。可在 brain.dog 上使用托管版，也可以在自己的设备上运行。

网站 · 文档 · 连接你的 Agent · 自行运行 · 插件

_{示例记录中的 Today 页面。所有姓名和数字均为虚构。}

它的功能

• 工作。 项目和任务。每个项目都会显示当前进度和下一步。
• Agent。 你连接的每个 Agent 都会先读取项目进度，并在结束时记录下一步。每个 Agent 都要经过你的确认才能登录，并且会在自己写入的内容上署名。你可以看到谁在处理什么。
• 需要你处理。 Agent 提出的问题会汇总在一个列表中，每个问题都附有可能的结果和原因。你的回答及其原因都会被保留。
• 资金。 账户、账单、发票、预算，以及现金还能维持多久，支持多种货币。导入 CSV 格式的银行对账单后，每一行都会归档。
• 联系人。 客户、联系人，以及谁欠谁的钱。可从 CSV 或 vCard 导入。
• 密钥。 将 API 密钥保存在记录中。Agent 可以使用这些密钥，但永远看不到它们。
• 附件。 将 PDF、图片、文档和 HTML 页面添加到项目或任务中。Agent 可以读取这些附件。
• 团队。 邀请成员并分配五种角色之一：Owner、Can decide、Can edit、Can add 或 Can view。成员的 Agent 也拥有相同权限，不会更多。通过只读链接分享单个页面，可选择是否包含资金信息。
• 斜杠命令。 按 / 或 ⌘J（Windows 上按 Ctrl J），用简单的语言向 BrainDog 提问。它会根据你自己的数据作答，并且所做的更改都可以撤销。
• 插件。 其他一切功能，从银行信息流到房东租金账簿。请参阅插件。

它可在任何浏览器中运行。iPhone 应用正在 TestFlight 上测试，Mac 应用则基于同一个项目构建。 两者都尚未上架 App Store。

始终遵循的原则

• 每项更改都会署名，并且可以撤销。
• 历史记录绝不改写。你可以查询记录在上周二时的内容。
• 资金、密钥、分享和删除操作都要等你确认。你可以允许自己的 Agent 跳过确认，但读取密钥、转让记录和删除记录始终由你决定。
• 你可以随时将所有内容导出为一个文件。

连接你的 Agent

通过地址。 任何支持 MCP 服务地址的客户端都可以使用此地址：

https://app.brain.dog/mcp

在 Claude 中，依次打开 Settings、Connectors、Add custom connector。首次连接时，客户端会在浏览器中打开 BrainDog。选择记录和 Agent 可以执行的操作，然后按 Allow。

通过命令行。 适用于 Claude Code 和你设备上的其他 Agent。需要 Node 24.13 或更高版本。

curl -fsSL https://brain.dog/cli/install.sh | sh     # macOS and Linux
irm https://brain.dog/cli/install.ps1 | iex          # Windows, in PowerShell
braindog setup https://app.brain.dog/<your record>

setup 会让设备登录（你需要在应用中批准六位数字），添加 Claude Code 钩子，注册 MCP 服务并放置 Agent Skill。 其余信息请参阅 apps/cli/README.md，所有客户端的说明请参阅 brain.dog/docs/agents/connect。

作为 Claude Code 插件。 一步即可添加 MCP 服务、会话钩子和技能：

/plugin marketplace add actuallyhoss/BrainDog
/plugin install braindog@braindog

附件

将文件添加到项目、任务或任意行。

• PDF 会在浏览器自带的查看器中打开。
• HTML 页面（例如 Agent 制作的产物）会在沙箱中呈现。它可以加载图表和样式库，但无法访问应用、你的登录信息或其他任何内容。
• Agent 会将每个文件作为文本读取。
• 文件大小最多为 25 MB。每次添加、重命名和移除都会记录在历史中，并注明操作人和时间。

从命令行：

braindog attach brief.pdf dashboard.html --to "Fix the login"
braindog attach --list --to "Fix the login"

插件和起步套件

项目、工作、人员和 Agent 均为内置功能。其他所有内容都是插件，可从应用的 Plugins 页面安装： Money 及其组成部分（投资、房产、保险、债务、目标、旅行、天课）、Stripe、Mercury、Gmail、Calendar、 Sentry、站会、项目简介等。起步套件是一组插件和示例行，适用于某种工作类型，例如 摄影师、房东或长期顾问业务。

它们来自哪里。

• 插件商店。 在 BrainDog 的工作人员审核之前，不会列出任何外部内容。
• 任意 GitHub 仓库。 安装会固定到某个提交，更新则来自该仓库。
• 你自己的 BrainDog。 向 Agent 请求 BrainDog 尚不支持的功能。它会编写并检查插件，然后在安装前征求你的同意。

它们能做什么。 列表、页面、数字和规则。Agent 可以调用的工具、命令，以及对某一行执行的操作。由它们自行绘制的视图。可向你发送通知、询问模型或保存自身数据的脚本。安装前，你可以查看所有这些内容；插件只能获得你批准的权限。脚本在沙箱中运行，只能访问文件中命名的主机。

如果插件出错。 BrainDog 可以在所有安装了某个商店插件的地方停用其有问题的版本，并告知你原因。插件的行会保留。

创建插件。 插件是一个易于阅读的文件，因此应用前你可以阅读并查看差异。命令行仍将其称为 addon。

braindog addon new plant-care                    # a folder with the file, a test and a README
braindog addon dev plant-care                    # a scratch BrainDog that installs each save
braindog addon check plant-care
braindog addon publish plant-care --github       # or --kennel, to send it to the store for review

内置插件位于 packs/ 中（该文件夹保留了旧名称），packs/README.md 介绍了如何编写插件。

两种运行方式

托管版，位于 app.brain.dog。 每条记录在 Cloudflare 上都有独立的数据库。密钥会加密封存，并且每晚都会创建一份封存副本。目前仅限邀请注册：请前往 brain.dog 申请邀请。

自行运行。 免费。只需一个容器、一个卷，无需在我们这里注册账号。

自行运行

git clone https://github.com/actuallyhoss/BrainDog braindog
cd braindog
cp selfhost.env.example .env      # set BRAINDOG_OWNER (your email) and BRAINDOG_SERVER_KEY (the server key)
docker compose up -d --build
docker compose logs braindog      # once started, it ends with the address
docker compose exec braindog cat /data/claim-link      # a one-time link: open it and add a passkey

如果不使用 Docker，则需要 Node 24.13 或更高版本以及 pnpm。这会在你自己的机器上提供 http://localhost:8080，无需任何人登录：

pnpm install
pnpm --filter @braindog/web build
export BRAINDOG_DATA=$HOME/braindog-data
node apps/selfhost/src/main.ts init <record name> --owner <your email>
node apps/selfhost/src/main.ts

邮件、Slash 使用的模型和公开地址均为可选项，只有在设置后才会启用。 apps/selfhost/README.md 介绍了如何连接 Agent、备份、恢复和升级。 docs/49-SPEC-SELFHOST.md 列出了服务器读取的所有设置。

构建方式

全程使用 TypeScript，运行于 Node 24，大多数软件包无需构建步骤。

• packages/kernel 是写入路径：统一入口、只追加账本、类型、筛选器、图形和规则。
• packages/record 将内核、声明和插件组合起来，基于 SQLite 构建单条记录。
• packages/mcp 向 Agent 提供记录。
• packages/script 是运行插件脚本的沙箱。
• packages/render 包含区块方言及其渲染器，独立发布为 braindog-render。
• apps/web 是使用 SvelteKit 构建的应用。两个主机都提供相同的构建版本。
• apps/worker 是托管在 Cloudflare Workers 上的版本：每条记录对应一个 Durable Object，并拥有自己的 SQLite。 它还运行插件存储。
• apps/selfhost 在单个 Node 进程中通过 node:sqlite 运行同一条记录，并提供容器。
• apps/cli 是 braindog 命令行工具，apps/site 是 brain.dog。
• apps/apple 是 iPhone 和 Mac 应用。apps/desktop 是较旧的桌面外壳，保留用于 Windows 和 Linux。
• tools/gates 存放每次变更都必须通过的源代码检查。

设计会先记录在文档中，见 docs/。docs/00-README.md 是索引，docs/01-ARCHITECTURE.md 是入门首选。

文档

• brain.dog/docs：BrainDog 使用方法、连接 Agent、HTTP API 和编写插件。
• docs/：带编号的设计和规范文档。
• DEPLOYMENT.md：托管版本的部署方式。

安全

请勿为漏洞提交公开问题。SECURITY.md 说明了如何私下报告漏洞。 docs/12-SECURITY.md 完整介绍了安全模型。

贡献

欢迎提交问题和拉取请求。请先阅读 CONTRIBUTING.md。其中介绍了构建、测试、检查关卡和项目风格；跳过这些要求的拉取请求通常会被退回。所有参与者都遵守行为准则。

许可证

BrainDog 是基于 Apache License 2.0 开源的（LICENSE）。例外是 packages/render，它采用 MIT License（packages/render/LICENSE），因此区块方言可以嵌入到任何地方。LICENSING.md 说明了两者的区别。

本软件按原样提供，不作任何明示或默示的保证。完整条款请参阅许可证文本。