# @aquex/reasonbook 中文文档

规范地址：https://npmcn.com/package/%40aquex/reasonbook/

版本：4\.12\.0
npm 元数据更新时间：2026-11-05T00:47:50.105Z
中文译文更新时间：2026-11-06T13:17:51.269Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aquex/reasonbook
原文对照：https://npmcn.com/package/%40aquex/reasonbook/?lang=original
项目主页：https://github.com/kneelinghorse/reasonbook#readme
源码仓库：https://github.com/kneelinghorse/reasonbook

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.8 MB，2119 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：7 个
- peer 依赖：@xenova/transformers ^2\.17\.2
- 首次发布：2026-10-12T16:12:26.487Z
- 最新版本发布：2026-11-05T00:47:49.914Z
- 近 30 天下载量：3342（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

理由书:在会话中幸存下来的决定,在本地记录中AI代理保存.

## 安装

```sh
npm install @aquex/reasonbook
```

也可以使用：`pnpm add @aquex/reasonbook`、`yarn add @aquex/reasonbook`、`bun add @aquex/reasonbook`

## README

# B. 理由手册——在届会中幸存的决定

[![npm version](https://img.shields.io/npm/v/@aquex/reasonbook)](https://www.npmjs.com/package/@aquex/reasonbook) [![License: Apache 2.0](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://npmcn.com/package/%40aquex/reasonbook/LICENSE)

理性手册保存了您项目的决定、理由和教训的本地记录,以便下一个代理会话能够收回您留下的地方. 由你决定 代理记账 不需要仪表板账户.

[![A recorded handoff between Claude Code and Codex](https://raw.githubusercontent.com/kneelinghorse/reasonbook/main/docs/demo/reasonbook-handoff.gif)](https://github.com/kneelinghorse/reasonbook/blob/main/docs/demo/reasonbook-handoff.mp4)

65秒回放有记录的跑道. [阅读演示的收据](https://github.com/kneelinghorse/reasonbook/blob/main/docs/demo/README.md) 财务报告和审定财务报表 [理性书发送和储存的东西](https://npmcn.com/package/%40aquex/reasonbook/docs/trust.md)。 。 。 .

## 试试看

下面选择一个插件, 或者用 npm 安装 CLI . [你的第一个十分钟](https://npmcn.com/package/%40aquex/reasonbook/docs/first-ten-minutes.md) 将您从安装到记录一个选择,并在另一个会话中找到它的理由.

提交生成的代理指令, `rbook/.gitignore` 和您的工程文档; 保留 SQLite 商店、 WAL/ SHM 文件和快照.

### 安装在 Claude 代码

为您的所有工程安装一次插件 :

```sh
claude plugin marketplace add kneelinghorse/reasonbook
claude plugin install reasonbook@reasonbook
```

安装后启动新的 Claude 代码会话, 然后请它启动 Causebook Ledger 这个项目。 如果第一个会话说Reasonbook正在安装,则在它完成后启动另一个会话.

### 分三步获取项目摘要

需要20号或更新的节点.

1.  安装被绑定的 CLI :
    
    ```sh
    npm install -g @aquex/reasonbook@4.12.0
    ```
    
    确保全局 npm bin 目录位于您的 PATH 上 。 如果前一个软件包在全球安装, 请运行 `npm uninstall -g @aquex/cmos-mcp` 先说 版本4只提供 `reasonbook` 命令; 更新使用旧命令的脚本和MCP配置.
    
2.  在您想要跟踪的项目文件夹中, 启动一个编辑器 :
    
    ```sh
    cd /absolute/path/to/your/project
    reasonbook init --level ledger
    ```
    
3.  阅读其第一份摘要:
    
    ```sh
    reasonbook review --format=context
    ```
    

文摘将该项目命名,并展示其决定、教训和公开工作。 一个新的 列车开始为空. 规划员增加了下个步骤; Builder增加了冲刺和任务.

提交生成 `AGENTS.md`, (中文(简体) ), `CLAUDE.md`, (中文(简体) ), `rbook/.gitignore` 和项目文档 维持。 新记录的忽略文件保留了 SQLite 商店,其WAL/SHM 文件和快照出局 吉特语 Init 保存已存在的忽略文件 。 共享记录需要保存 未跟踪;通过Reasonbook的共享命令来交换这些记录.

插件安装不设置 `reasonbook` 在你的终端路径。 只有插件用户才能 替换 `reasonbook` 在这些命令中 `npx --prefer-offline -y @aquex/reasonbook@4.12.0`, (中文(简体) ), 比如说 `npx --prefer-offline -y @aquex/reasonbook@4.12.0 review --format=context`。 。 。 .

## 代码插件

```sh
codex plugin marketplace add kneelinghorse/reasonbook
codex plugin add reasonbook@reasonbook
```

对于聊天工作流程, 使用 `codex plugin add reasonbook-chat@reasonbook` 换句话说. 见 [编码和核查限制](https://npmcn.com/package/%40aquex/reasonbook/docs/harnesses.md#codex)。 。 。 .

## 从CMOS升级

使用 `reasonbook doctor` 检查什么需要改变和 `reasonbook migrate` 以预览记录移动. 跟着 [移徙指南](https://npmcn.com/package/%40aquex/reasonbook/docs/migrating-from-cmos.md) 在移动客户记录之前升级客户.

## 提出一个决定,然后批准

当一个选择需要您批准时,代理以一条具体线结束回复:

> 将记录 : 使用每周检讨, 因为它保持读取列表的有用性, 而无需每日维护 .

随着开发商的钩子被启用并与对话连接,Stop钩子将它作为 草案。 您的下一份答复可以批准、拒绝、提问或修改措辞。 经纪人 记录一份经批准的草案,并归还 `P<n>` id;一份草案尚未成为决定。 同样 现场谈话,两个多小时后的回答仍然可以解决一个未过期的草稿. 迟到 批准为代理人裁决的记录;逾期下降的情况依然存在。 需要约束、规则和概况草案 将再次提出供明确批准。 检查项目文件夹中的草稿:

```sh
reasonbook drafts list
```

`reasonbook-chat` 直接记录你要求或批准的选择和理由。 它说 在谈话中你没有引用谈话内容 也没有使用草稿. 已经明确认可确切的措辞,这一点很重要,因此代理人不必再问了.

## 方法

-   一个项目,一份决定、经验教训、制约因素和下一步的记录.
-   从该记录开始;支持的钩子将其自动带入会话.
-   有意录制决定,并说明理由. 取代了改变的决定.
-   使过期和超会话可见; 关闭短跑会默认保持记录活动.
-   保持项目记录 这样它能活下来 工具的改变.

[方法](https://npmcn.com/package/%40aquex/reasonbook/docs/method.md) 给出五行的完整, 理性书在每个级别做什么 如何向上移动 [启动模板](https://github.com/kneelinghorse/reasonbook/tree/main/templates) 保存每个关卡开始的文件 .

## 你的机器还留下什么

记录保留在您的项目的 SQLite 文件中 。 有存储的用户范围密钥或遗留 环境证书、明确的会话和短跑结束尝试的背景 上传 **整个文件**,包括待决和被否决的提案。 对于一个注册的项目, MCP工具在5个安静的分钟或30分钟的连续写作后也会安排上传; 下一次民意调查在60秒内开始, 当没有上传租借或故障后退挡住它. 转移时间随之而来。 详情请参见 [可选:主机仪表板](https://npmcn.com/package/%40aquex/reasonbook/#readme-optional-hosted-dashboard)。 。 。 . `RBOOK_CHECKPOINT_SYNC=off` 停止自动上传和手动 `rbook_db(action="backfill")` 上传. 其他要求的网络行动和共享记录交换仍然可用. 登录对其它请求的仪表盘呼叫有效的项目密钥, 但关闭和手动 回填还需要存储的用户扫描密钥或环境证书. 隐性进程- 退出关闭不上传 。 共享项目 理由书. ai不停地上传整个文件 直到分享将其记录交给仪表板 ,然后发送共享记录的更改,直到将其移回。 客户端也支持 a 成员在理由簿时上传已擦除过的 SQLite 副本 。 ai 开始主机恢复。 车主 在共享记录页面上审查并确认回收计划。 无论是 `RBOOK_SHARED_SYNC=off` 或者说 `RBOOK_DASHBOARD_SHARING=off` 停止回收捐款,包括在明确同步期间. [全面网络和数据披露](https://npmcn.com/package/%40aquex/reasonbook/SECURITY.md#outbound-network)。 。 。 .

## 这是什么

理性书是协议+客户端. 它在您的机器上运行,拥有一个 SQLite 数据库 `rbook/db/rbook.sqlite`,并在MCP上曝光了15个打字工具. Claude Code和Codex经过核实(见 [绳索引导](https://npmcn.com/package/%40aquex/reasonbook/docs/harnesses.md);其他MCP客户端,如克勞德·德克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通克通.

从盒子里出来

-   有可审计过渡的冲刺和任务状态机器
-   用于决定、学习、制约、下一步的会话记录
-   跨越短跑、有FTS5检索的战略背景
-   在决定、学习、任务、课程之间全文搜索
-   数据库需要时的快照; 短跑关闭前后的备份尝试; 之前需要的备份 带有所选行的还原或快照
-   每个项目证书存储和设备编码认证(RFC 8628)

仪表板在 [理由书.ai](https://reasonbook.ai/) 实值 **选项**您可以永远单独运行Reasonbook——注册解锁仪表板上传(SQLite → Postgres镜像),项目登记册(`rbook://you/*` 和跨项目通讯。 没有它,其他工具仍然在当地运作.

## 安装

建议:全局安装此发布. 服务器从磁盘开始, 没有注册 发射时的搜索:

```bash
npm install -g @aquex/reasonbook@4.12.0
```

如果前一个软件包在全球安装, 请运行 `npm uninstall -g @aquex/cmos-mcp` 先说 版本4只提供 `reasonbook` 命令; 更新使用旧命令的脚本和MCP配置.

或按要求运行 `npx`键入版本并选择本地缓存:未绑定 `npx -y` 每次发射时都可以再次检查包裹.

```bash
npx --prefer-offline -y @aquex/reasonbook@4.12.0
```

语义 (vector) 搜索是可选的. 没有它,检索只是关键词,安装是 大约45 MB 而不是大约306 MB. 要在检索中添加矢量词, 安装 `@xenova/transformers` 在理性书旁边. `rbook_db(action="health")` 报告是否打开.

需要20号或更新的节点.

## 配置您的 MCP 客户端

Claude Code 和 Codex 被验证; 其他块遵循每个客户端自己的 MCP 配置 并且未用理性书测试。 下面的每个实例都会运行一个被绑定的版本通过 `npx`,倾向于本地缓存;升级, 更改版本。 随着全局安装,使用 `"command": "reasonbook"` 放下枪 `npx` 参数( 保留) `--project-root` 在有实例的情况下).

### 克劳德代码

```bash
claude mcp add-json rbook '{"command":"npx","args":["--prefer-offline","-y","@aquex/reasonbook@4.12.0"]}'
```

### 克劳德桌面

添加为 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)或等同于Windows/Linux上的:

```json
{
  "mcpServers": {
    "rbook": {
      "command": "npx",
      "args": [
        "--prefer-offline",
        "-y",
        "@aquex/reasonbook@4.12.0",
        "--project-root",
        "/absolute/path/to/your/project"
      ]
    }
  }
}
```

Claude桌面预计将启动没有项目上下文的服务器(在macOS上,来自 `/` 没有 工作空间根;未与"理性"一同测试),所以在配置中命名项目. `--project-root` 仅适用于此服务器条目,并且仅适用于 无项目背景的呼叫:无 `projectRoot`,没有工作空间根,也没有工作目录 `/`, (中文(简体) ), 您的家目录或服务器的安装目录。 从任意一个启动服务器的客户端 其他文件夹应当通过 `projectRoot` 换句话说.

### 光标

添加为 `~/.cursor/mcp.json`数字 :

```json
{
  "mcpServers": {
    "rbook": {
      "command": "npx",
      "args": ["--prefer-offline", "-y", "@aquex/reasonbook@4.12.0"]
    }
  }
}
```

### 齐德

```json
{
  "context_servers": {
    "rbook": {
      "command": "npx",
      "args": ["--prefer-offline", "-y", "@aquex/reasonbook@4.12.0"]
    }
  }
}
```

### VS代码( Claude 扩展)

从集成终端上方使用 Claude 代码命令, 或添加服务器 结束 `/mcp` 在克劳德面板。 扩展和CLI共享MCP配置; 更改后启动新对话 。 扩展名不添加 `claude` 改为 所以终端路线需要独立的克洛德CLI. [VS代码中的克洛德代码](https://code.claude.com/docs/en/vs-code#connect-to-external-tools-with-mcp)

### 风起浪起

```json
{
  "mcpServers": {
    "rbook": {
      "command": "npx",
      "args": ["--prefer-offline", "-y", "@aquex/reasonbook@4.12.0"]
    }
  }
}
```

## 第一通电话

项目工具工作在一个有Reasonbook数据库的文件夹上,所以一个新的项目以init开始:

```
rbook_project(action="init", projectRoot="/absolute/path/to/your/project")
```

`init` 创建 `rbook/db/rbook.sqlite`种子文件,一个 `AGENTS.md` (单位:千美元) `CLAUDE.md` 在项目根部导入它 (如果文件已经存在,则保留其中任一文件)。 在没有数据库的文件夹中,读取或写入工程的工具 拒绝和名称 `init`;登记和登录行动不需要项目.

然后运行 `rbook_agent_onboard` 一次:在一个新项目上,它走第一会的设置。 打开一次 后会随会文摘:

```
Run rbook_review to see the project state.
```

`rbook_review` 返回共享会话摘要:项目身份、当前短跑、开放工作和最近的决定。 它的本地文本核心被封顶为4,000个字符;后附的组合上下文和周围的MCP响应都在封顶之外.

整个行走过程——安装——配置——输入——第一次冲刺/任务/会话循环——生活在 [文档/开始](https://npmcn.com/package/%40aquex/reasonbook/docs/getting-started.md)。 。 。 .

## 工具表面

"理性"曝出15个综合工具. 12 个使用a `action` 选择操作的参数; `rbook_agent_onboard`, (中文(简体) ), `rbook_status` 财务报告和审定财务报表 `rbook_review` 带不 `action`。 。 。 . [图文.md](https://npmcn.com/package/%40aquex/reasonbook/TOOL_REFERENCE.md) 每个动作发布一个参数表,所以它表示哪些参数实际适用于给定的呼叫.

| 工具 | 目的 |
| --- | --- |
| `rbook_review` | 会话摘要:身份,冲刺,工作,决定,其他项目信号 |
| `rbook_agent_onboard` | 冷启动有效载荷:身份、主动冲刺、任务、决定、建议 |
| `rbook_status` | 诊断快照: rbook 地址、 仪表板 url、 认证级、 同步时间戳 |
| `rbook_mission` | 特派团——创建、更新、查询和链接依赖关系 |
| `rbook_mission_transition` | 任务状态机器——起步,完成,阻断,解阻,放出,延后,重开 |
| `rbook_sprint` | Sprints—— CRUD, 关闭, 复古, 并交叉打印分析 |
| `rbook_session` | 工作会议(可选)——开始,获取见解,完整,列表,搜索 |
| `rbook_context` | 主/项目背景——取景,更新,收缩,快照和搜索 |
| `rbook_decisions` | 战略决定——记录、显示、清单、搜索、更新、停滞审查 |
| `rbook_learnings` | 贯穿各领域的学习——清单、搜索、展示、更新和重申 |
| `rbook_db` | 数据库操作——健康、快照/恢复、回填和上下文相接 |
| `rbook_project` | 项目——输入,注册,列表,验证;共享,邀请,加入,成员,同步 |
| `rbook_auth` | Dashboard 证书使用寿命周期——设备编码登录,旋转,撤销 |
| `rbook_message` | 跨项目信息(需要主机仪表板) |
| `rbook_feedback` | Agent-feedback 通道——列表,分解,解析,存档 |

见 **[图文.md](https://npmcn.com/package/%40aquex/reasonbook/TOOL_REFERENCE.md)** 对于精确的每个动作参数参考物——它来自每个构造上的工具定义,因此它从不从被运出表面漂移.

## 共享项目记录

这个 [共享指南](https://npmcn.com/package/%40aquex/reasonbook/docs/sharing.md#share-a-projects-record) 覆盖仪表板,SSH和捆绑. 读取 [信任边界](https://npmcn.com/package/%40aquex/reasonbook/docs/trust.md#shared-copies) 在和别人分享完整记录之前.

## 可选:主机仪表板

见 [连接主机仪表板](https://npmcn.com/package/%40aquex/reasonbook/docs/sharing.md#optional-connect-the-hosted-dashboard) 用于登录、上传及其控制.

## 项目决议

理性书从不做你没有命名的项目 每个工具都叫它选一个项目 在这个 命令,在项目无法使用时拒绝而不是退回:

1.  这个 `projectRoot` 调用参数: 项目文件夹或已准确注册 `rbook://owner/project` 地址 电话 地址发现读取存储的身份而不修复 它们; 没有匹配、 重复匹配或不可读的注册身份拒绝 .
2.  对于一个支持的 Codex 请求, 它的对话工作文件夹 。 无效的文件夹 拒绝 而不是返回服务器的文件夹 .
3.  工作空间根植您的 MCP 客户端的广告: 一个"理性"项目的第一个.
4.  工作目录,或上面最近的文件夹,是“理性”项目——一个持有 `rbook/db/`; 一个普通文件夹, 命名为 `rbook` 不计数(搜索在您家下面停止) 目录).
5.  只有在服务器完全没有项目上下文时 —— 不 `projectRoot`没有根 有工作 目录 `/`,您的主目录或服务器的安装目录(如客户端启动) 没有项目文件夹的服务器 : `--project-root <dir>` 参数在服务器的配置中,然后是注册默认设置 与 `rbook_project(action="register", projectRoot="...", setAsDefault=true)`。 。 。 .
6.  否则,电话被拒。 在不是“理性”工程的文件夹中,写出名称 `rbook_project(action="init")` 以及一个读取的答案 "没有理性书项目在'".

`rbook_project(action="list")` 包括已存储的id、地址和文件夹. `init`, (中文(简体) ), `register` 财务报告和审定财务报表 `unregister` 需要文件夹; 地址永远不会成为文件系统路径.

其使用的每个成功响应名称(`projectRoot` 财务报告和审定财务报表 `resolvedBy` ,以及 在其文本中说,每当项目来自工作区, `--project-root` 或登记处 默认。 在 3. 2. 0 之前设置的注册默认值在您重新运行之前不应用 `setAsDefault`; 数据 服务器, `rbook_message(action="whoami")` 财务报告和审定财务报表 `rbook_review` 说,当一个人存在.

## 将工作移出中央规划文件夹

如果您在一个“理性”项目中收集了多项努力,请使用 `spin-out` 当需要努力时 拥有工程文件夹 。 它复制了选定的特派团、其相关决定、学习和下一个 步骤,以及您名下的任何额外记录标识。 源头仍然是可读的历史 指向新项目.

先创建目的文件夹 。 源头必须注册,两家店必须注册 拥有独特的项目身份。 需要两个根; 此命令不使用环境 项目或登记册默认。 奥米 `--apply` 预览选择和映射 :

```sh
reasonbook spin-out --from /work/projects --to /work/new-product --sprint sprint-12

# Or select missions, with additional decisions, learnings and next steps by ID:
reasonbook spin-out --from /work/projects --to /work/new-product \
  --missions product-plan,product-prototype \
  --decisions 41,42 --learnings 17 --next-steps 23,24

# Apply the same reviewed selection:
reasonbook spin-out --from /work/projects --to /work/new-product \
  --missions product-plan,product-prototype \
  --decisions 41,42 --learnings 17 --next-steps 23,24 --apply
```

选择其中之一 `--sprint` 或者说 `--missions`。无理由手册的目的地报告为需要 在预览中初始化; `--apply` 初始化并先取数据库备份 抄袭. 复制工作保留其地位,但在目的地没有短跑任务. 准备就绪后就把它交给目标冲刺 来源:排队、被封锁和被推迟的任务 已放弃;已完成和已放弃的特派团保留其地位。 来源决定和 学习变成存档,源的下几个步骤被删除。 默认列表和检索 删除这些已转移的源行。 Sprint历史保留其计数并识别转账 他们的目的地指针。 没有短跑自动关闭.

阅读源或复制决定、学习或使命及其现有 `show` 动作和一个 明确 `projectRoot`;结果包括: `spunOutTo` 或者说 `spinOutOrigin` 和可读地址. 作为历史的下一步,使用 `rbook_context(action="next_steps", nextStepAction="list", nextStepIds=[23], projectRoot="/work/projects")`。 。 。 . 明确的身份证包括移动或丢放行 `nextStepStatus` 仍然过滤它们. 普通后台列表继续显示开放工作. 没有冲刺的下一步目标 在42天后被标记为闲置。 CLI 不立即上传两个商店: 每个输入 在其下次成功 MCP 写入后正常上传时间表,但须遵守配置 [上传控制](https://npmcn.com/package/%40aquex/reasonbook/#readme-optional-hosted-dashboard)。 。 。 .

中断后重试确切命令 。 经核实已完成的操作返回,不变. 如果在目标复制后源记录发生变化,则拒绝最后源标识 这两家店都保存下来供审查。 如果保留重试没有承诺的目标收讫, 命令还拒绝:在复制前无法区分崩溃和已删除的 更早的拷贝。 保护 **既包括根又包括操作 ID** 在补救中指明的,检查 分类账和预写快照,在重试前解决或恢复相冲突状态. 不删除保留以强制复制另一个副本; 重试绝不默默地覆盖复制的工作 .

## 环境变量

```bash
# Optional — connects to the hosted dashboard. Defaults to https://reasonbook.ai
# when unset; treat empty string as unset.
RBOOK_DASHBOARD_URL=https://reasonbook.ai

# Optional — the directory the server reads its own .env from. It does NOT select a project:
# use the projectRoot parameter, or --project-root in a server's config.
RBOOK_PROJECT_ROOT=/path/to/your/project

# Optional — override the credential + registry directory. Default: ~/.config/rbook
RBOOK_CONFIG_DIR=/custom/path

# Snapshot retention (default shown)
RBOOK_MAX_SNAPSHOTS=50

# Optional — disable timed uploads, explicit-close uploads and manual backfill for this server.
# Shared-record exchanges and other requested network actions remain available.
RBOOK_CHECKPOINT_SYNC=off

# Optional — disable shared-record exchanges started by hooks and the server timer.
# Explicit reasonbook sync and bundle commands remain available; recovery contributions stop.
RBOOK_SHARED_SYNC=off

# Optional — turn off starting a share or a join through reasonbook.ai on this machine
# (off, false, 0 or no, in any case). On by default; a project already shared through the
# dashboard syncs either way. Hosted recovery contributions are also stopped by this switch.
RBOOK_DASHBOARD_SHARING=off
```

## 错误响应形状

每个工具返回一个统一的信封 :

```json
{
  "success": false,
  "error": {
    "code": "MISSION_NOT_FOUND",
    "message": "Mission 's99-m01' not found",
    "suggestion": "Use rbook_mission(action=\"list\") to see available missions"
  }
}
```

`code` 是机器可读的, `message` 是人可读的, `suggestion` 是一个具体的下一步。 校验出错 `validValues` 联合国 `string[]`) (中文(简体) ). 状态错误可以携带 `currentState`: 当相关任务、会话或短跑状态可用时, 通常为状态字符串, 并且 `SESSION_ALREADY_ACTIVE` 仅一个对象 `{ id, type, title, startedAt, captureCount }`部门 `code` 在读之前.

## 安全问题

-   **附录只审计.** 会话事件和任务过渡为仅附加行. 上下文的快照保留着他们的行,ID和事件,但是 `rbook_db(action="prune_snapshots")` 可以清空自己写的Reasonbook 副本的内容.
-   **原子弹证书写作.** `credentials.json` 以0600权限通过临时文件+重命名写入.
-   **数据库快照.** `rbook_db(action="snapshot")` 按要求复制数据库。 A 类 `rbook_sprint(action="complete")` 尝试关闭前后的快照; 快照失败警告而不阻碍完成 。 应用 `rbook_db(action="prune_snapshots")` 到非空选择需要备份,以及 `rbook_db(action="restore")` 将虚拟数据库复制到 `rbook/db/snapshots/pre-restore/`。 。 。 . `RBOOK_MAX_SNAPSHOTS` 封顶 保存多少: 取一去一去去一去去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去一去去一去一去一去一去一去一去 没有别的东西先被拍下来, 没有软删除网—— `rbook_db(action="purge")` 从仪表板镜像中删除此工程的数据,并在项目通过reasonbook.ai共享时被拒绝. 见 [警卫](https://npmcn.com/package/%40aquex/reasonbook/SECURITY.md#backups--deletion--the-honest-reality)。 。 。 .
-   **干行所出之处.** `rbook_context(action="condense")` 接受 `dryRun` 预览而不承诺。 这不是变异工具的一般属性。 Backfill 的旧事件- 重放干线已退役并拒绝使用 `LEGACY_SYNC_RETIRED`。 。 。 .

## 已知限制

-   共享记录仅在每一份活动副本报告支持后才会切换到协议2; `rbook_review` 名称屏蔽副本。 在开关前,id声称使用他们现有的时钟顺序. 之后,第一个计算好的验收会确定索赔的立场,预开关索赔排在后面,一旦复制件收存了先前提出的每一项索赔的数据,即为最终确认。 仍可先申请可预测的身份证明;追偿法官以前没有按时序判断交易。 必须留一个消失的复制件 来阻止开关。 在reasonbook.ai, 业主使用 **保留此副本** 在共享记录页面上.
-   在协议-2开关后,年长的读者只在包含其第一次协议-2更改的整个交易之前才能收到每条流. 加入、继承和计划向老读者或未报告的读者采取的行动都拒绝. **降级可以在本地重命名 ID:** 旧的拷贝仍会发出自己的书信, 在继续共享工作之前更新每份副本。 回收仅在通过的权威前缀中保留开关.
-   已注册的工程,在服务器运行时,在写出后带有仪表板证书上传快照并明确关闭; 手动 `rbook_db(action="backfill")` 请求立即上传整个文件 。 共享记录交换使用自己的钩子、定时器和 `RBOOK_SHARED_SYNC` 控制系统.
-   SQLite是真理的来源;仪表盘上握住主人上传的镜子. 共享副本与 `reasonbook sync`通过理疗手册,通过SSH或捆绑.
-   通过reasonbook.ai,将一个项目向后移动被测量到一个成员,自动同步关闭:在移动后该副本与仪表板同步之前,所有者副本在SSH上捕获到成员副本. 随着自动同步的启动,成员副本可能首先会同步. 未测量:成员副本先与仪表板同步,其同步后表示通过SSH或用捆绑与所有者副本同步,成员副本则无法通过SSH获取. 仪表板的活动种子默认显示每页有50个条目,最多100个,其决定页显示每页有20个;更古老的条目在后页上.
-   一个通过reasonbook.ai通过其成员的代理更改共享的项目;仪表板的页面显示记录. 托管恢复在呼叫发现失物招领者或后方裁判后收集幸存副本,所有者审查并确认其计划. 退职后同一记录的重新分享保留了成员/账户的约束,包括被除名的成员;只有在事后通过直接分享才被接纳的成员被拒绝。 每位成员都保存本地副本. [隐私](https://npmcn.com/package/%40aquex/reasonbook/docs/privacy.md#sharing-through-reasonbookai) 说明已部署的成员核对情况及其有效人口普查要求.
-   通过理性书分享 AI名称并拒绝覆盖所有者写出,成功交换或保留SSH路径的其他副本,包括被观察到或被路由过的前所有者副本. Dashboard- route 行, 剪接副本, 而此文件夹的前身不计数 。 在直接授权副本上, `reasonbook set-aside --replica <id>` 预览一份已删除的副本的截断和最后一次交换; 添加 `--yes` 来记录它。 此人的其他副本仍为会员. 角色的改变,去除和重新承认保留了剪接;后写出被隔离的人再做,恢复不会等那份. 在主办项目上,业主使用 **保留此副本** 在共享记录页面上 **这个拷贝不见了** 证实一份过去七天的来电 在恢复或后移时无法使用此控制 。 在仪表板裁判时拒绝地方行政.
-   备案记录需要报告4.5.0的图书馆版本,或稍后在计划移交或仪表板共享的目标上。 未知的报告也拒绝; 上传前的共享检查 . **A 类 `reasonbook recover` 由前- 4. 5.0 二进制运行,可以取消预设边.** 在使用前更新恢复副本 。 旧的 `rbook_db(action="clone")` 财务报告和审定财务报表 `rbook_db(action="pull")` 拒绝动作 `LEGACY_SYNC_RETIRED`;其动作值一直维持到 5.0.0.

## 文档

-   [文档](https://npmcn.com/package/%40aquex/reasonbook/docs/README.md) ——它是什么,如何安装,水平和在哪里阅读更多.
-   [交接演示](https://github.com/kneelinghorse/reasonbook/blob/main/docs/demo/README.md) ——65秒回放录下跑道,并有笔录.
-   [信托](https://npmcn.com/package/%40aquex/reasonbook/docs/trust.md) ——什么留下你的机器,什么被钩子所读取,如何把每个部分都关掉.
-   [隐私](https://npmcn.com/package/%40aquex/reasonbook/docs/privacy.md) ——收集,仪表板能见度,保存和清除.
-   [方法](https://npmcn.com/package/%40aquex/reasonbook/docs/method.md) ——"五行","三关"和"如何向上".
-   [开始](https://npmcn.com/package/%40aquex/reasonbook/docs/getting-started.md) ——客户端配置和可选构建器走通.
-   [共享和托管的仪表板](https://npmcn.com/package/%40aquex/reasonbook/docs/sharing.md) ——共享路由,登录和上传控制.
-   [覆盖面](https://npmcn.com/package/%40aquex/reasonbook/docs/harnesses.md) ——原生适配器,MCP提示和无钩倒回.
-   [工具参考](https://npmcn.com/package/%40aquex/reasonbook/TOOL_REFERENCE.md) ——每个工具,动作,参数(由工具定义产生).
-   [更改日志](https://npmcn.com/package/%40aquex/reasonbook/CHANGELOG.md) ——发布注释和工具表面变化.

## 发展

候选人考试,替换 `kneelinghorse/reasonbook` 绝对退出 路径。 安装后启动新的 Claude 代码会话 。 插件提供 MCP 服务器、 钩子和命令; 其第一个冷会话可能报告Reasonbook 是 从下一个会话开始安装并加载记录 。 使用 `/reasonbook:init` 用于新的 记录, `/reasonbook:start` 读它, `/reasonbook:close-out` 工作结束, `/reasonbook:plan` 计划, 财务报告和审定财务报表 `/reasonbook:build` 执行. [插件安装](https://code.claude.com/docs/en/discover-plugins)。 。 。 . 其他工具使用 [适应器和覆盖指南](https://npmcn.com/package/%40aquex/reasonbook/docs/harnesses.md)。 。 。 .

```bash
git clone https://github.com/kneelinghorse/reasonbook
cd reasonbook
npm install
npm run build
npm test
```

开发需要Node.js 20.17或更新(lint-staged 16.4);已出版的软件包运行于Node.js上 二十个或更新.

承诺前的钩子通过husky/lint-相机运行 lint +格式. 这个公共寄存器是一个代码镜; 发布验证和npm发布从私人来源运行.

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://npmcn.com/package/%40aquex/reasonbook/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40aquex/reasonbook/NOTICE)。 。 。 .

## 常见问题

### @aquex/reasonbook 是什么？

理由书:在会话中幸存下来的决定,在本地记录中AI代理保存\.

### 如何安装 @aquex/reasonbook？

在项目目录运行 npm install @aquex/reasonbook，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 reasonbook，可以用 npx reasonbook 直接运行。

### @aquex/reasonbook 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aquex/reasonbook 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aquex/reasonbook 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aquex/reasonbook 可以商用吗？

@aquex/reasonbook 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aquex/reasonbook 的下载量有多少？

根据 npm 官方下载统计，@aquex/reasonbook 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,342 次，日均约 111 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aquex/reasonbook 还在维护吗？

最新版本 4\.12\.0 发布于 2026/11/05（2 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/10/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。