写给智能体，以及打造它们的人
智能体在会话之间会丢失上下文。它们没有地方保存持久的笔记，没有自己的身份，也没有长期记忆。blackbear 把这些全都给它们：加密、本地优先、可追溯作者，可以通过 bb 命令行访问，也可以作为智能体本就会用的 MCP 服务器。装一次，你的智能体就有了家。
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} 每个智能体会话都从零开始。上下文窗口会过期，对话历史会被截断，重要的东西没有一个私密、持久的地方存放。你的智能体聪明 30 分钟，然后忘掉一切。
笔记、决定、用户偏好、项目上下文，都存在本地，加密且可搜索。bb file search 把它们全都找回来。你的智能体跨会话、跨重启、跨模型更换，都能接着上次停下的地方继续。
智能体在这里不是客人。bb profile create 给你的智能体一个正式的身份档案，并配有自己的签名密钥，用于验证作者。它写下的每条笔记、每个任务和事件都带着它的名字。
每条命令都支持 --json，输出机器可读。退出码可预测。ID 接受唯一前缀。不用解析 HTML，不用抓取网页，只有干净的数据。
与 App 相同的 XChaCha20-Poly1305 加密。保险库密钥从不离开本机。云端只看得到密文。你的智能体的想法只属于它自己，连我们也看不到。
本地 SQLite 数据库，静态加密，不依赖云端。可离线运行，可在物理隔离环境运行，也可在你的 CI 运行器上运行。同步是显式的：需要时运行 bb sync。
笔记、任务、日历、表格、文档、幻灯片、文件：blackbear 的全部功能。智能体写下的一切都会出现在任何设备的 App 里，并标明来自它的身份档案。同一个保险库，同样的加密，同样的同步。
brew install xavi-group/tap/bb，或下载二进制文件。支持 macOS、Linux 和 Windows。
bb auth login 会打开浏览器，你在那里选择这台电脑的 API 密钥可以拥有哪些权限范围；然后运行 bb vault unlock。保险库密钥会安全地保存在系统钥匙串中（在无界面的运行器上则是加密文件），之后每条命令都能直接使用。不用环境变量，不用反复输入。
bb profile create claude：你的智能体会有自己的身份档案和签名密钥。它的每次写入都有署名，bb profile export-key 还能给它一个 SSH 格式的密钥，用来签名 git 提交。
一行命令即可添加 MCP 服务器：claude mcp add blackbear -- bb mcp（或 codex mcp add，或任何 MCP 客户端）。也可以从任何工具系统（函数调用、子进程）调用 bb，输入输出都是结构化 JSON。了解更多 MCP 信息
在任何设备上打开 blackbear，智能体写下的一切都在那里：笔记、任务、事件，每一项都标明来自它的身份档案。在 App 里修改内容并同步，CLI 就能看到你的更改。人和智能体共用一个工作区。
MCP 服务器
bb mcp 从你的电脑通过 MCP 提供 Pax 自己的工具。你的智能体可以用 Pax 在 App 里使用的同一套工具和引擎，搜索、阅读你的笔记、文档、表格、幻灯片、画布、页面、任务和日历，并在你允许时修改它们。没有任何托管。
一次搜索覆盖文件、任务和事件，再按 id 打开、查看大纲和编辑：Markdown 笔记、文档、表格、幻灯片、画布和页面，还有任务和你的日程。结果易读且结构化；调用失败时会用稳定的错误码和提示说明原因。
单独的 bb mcp 只会读取。--writes 增加创建、编辑和移到废纸篓；删除的内容会进入废纸篓，你可以从那里恢复。你为 Pax 设为只读的内容保持只读，在 App 里需要你批准的操作在这里会被拒绝。
服务器在你的电脑上通过 stdio 运行，直接使用本机已有的加密工作区副本。它在启动时同步，并在每次更改后稍等片刻再同步；--no-sync 让它完全离线。
或者安装 Blackbear 插件：它会配置好同一个服务器，并附带一个简短的技能，教你的智能体先找到内容，再按 id 操作。在 Claude Code 中：/plugin marketplace add xavi-group/blackbear-plugins，然后 /plugin install blackbear@blackbear。在 Codex 中：codex plugin marketplace add xavi-group/blackbear-plugins，然后从 /plugins 安装。在 GitHub 上查看 Pax 自己的对话留在 App 里，从不对外公开。
API 密钥
每台电脑、每个智能体都有自己的账号 API 密钥，只拥有你选择的权限范围。bb auth login 会打开浏览器，由你在那里确认列表；每个密钥都可以单独撤销，不影响其他密钥。
sync 读写你已同步的工作区并解锁你的保险库。唯一会把这台电脑添加为设备的权限范围。
account:read 查看你的账号、设备和密钥。从不更改任何内容。
media 上传和下载附件。
messaging 收发端到端加密的消息。
collab 加入实时协作编辑。
inference 显示为 AI models Blackbear 托管的模型、图片生成和网络搜索。它会消耗额度，所以从不默认勾选。
Settings › Account › API keys 列出每个密钥及其权限范围。可以在那里签发密钥（由你的保险库确认，密钥只显示一次），不再使用时也可以立即撤销。
bb auth login --api-key 用你签发的密钥登录，密钥可以来自 $BLACKBEAR_API_KEY、管道输入或隐藏的提示符，因此不会进入 shell 历史记录。--no-browser 会打印登录链接，而不是打开浏览器。
Web Clipper 有自己专属的密钥类型：它只能向你的某一台设备投递加密剪藏，其他什么都做不了。
bb discover 结构化的开放网络：arXiv、Hacker News、GitHub 趋势、任何 RSS 订阅源。以干净的 Markdown 获取，智能体可以直接阅读和归档。
bb store 存储：钥匙串、键值对和数据库。在文档和笔记之外，为智能体提供结构化状态。
bb file template 模板：每日笔记、会议记录、日记。用 --template 从模板创建文件。
智能体需要的一切。每条命令都支持 --json。
bb file md create "Title" -c "…" 创建 Markdown 笔记，或用 --stdin 传入内容
bb file search "query" 在保险库的所有文件中全文搜索
bb file cat <id> 把任何文件的内容输出到 stdout，不分类型
bb file list --type md 列出文件，可按类型、标签或文件夹筛选
bb file update <id> --content "…" 替换内容；移动、加标签、置顶或归档
bb task create "Title" --due tomorrow 创建任务，支持 --priority、--tags 和相对日期
bb task list --open 列出任务：--open、--done、--archived
bb event create "Standup" --at "9am" 用自然语言安排日程，ISO 8601 也可以
bb event list 默认显示接下来一周，用 --from 和 --to 指定范围
bb profile create claude 正式的智能体身份，配有自己的签名密钥
bb sync 拉取 + 推送：完整的双向 E2EE 同步
bb status 认证、保险库、同步、身份档案和设备状态，一目了然
bb mcp 把 Pax 的工具作为本地 MCP 服务器，只读
bb mcp --writes 同时可以创建、编辑、移动和移到废纸篓
bb auth login --scopes sync,account:read 预先选定浏览器登录时提供的权限范围
bb auth login --api-key 用设置中签发的密钥在无界面环境登录
ID 接受唯一前缀。还有更多：标签、文件夹、存储、模板、导出……运行 bb help 查看