Copilot 快速上手
Copilot 是平台内置的账本助手：用自然语言问账、做复盘，并把一句话记成待审核条目。本教程带您走通一条最短的完整路径。
它只读查询账本，不会改账；记账也只生成待审核条目，写入仍需您确认。
您将完成什么与前提
完成本教程后，您可以：
- 用自然语言问出一个账本问题的答案
- 让 Copilot 做一次月度复盘
- 说一句话生成一条待审核条目，并在审核后写入账本
建议：您已登录 Beancount-Trans，且账本里已有若干交易记录。若还没有，请先跟随 快速入门 上传一份账单并写入账本。
⏱️ 预计耗时：5 分钟。
逐步操作
登录控制台后，点击顶栏的 「Copilot」。
若页面提示未配置密钥，请先打开 「输出配置 → BYOK」，填写接口地址、API 密钥与模型名称，并点 「测试」 确认可用。
问一个关于账本的问题
- 在输入框中提问，例如「我有哪些账户和标签？」或「上个月支出都花在哪里了？」。
- 等待流式回答结束。
您应看到：
- 回答中的每个金额都来自账本的查询结果，而不是模型的估算
- 回答下方可展开 「查看查询详情」，查看本次执行的 BQL 与结果预览
- 可点 「打开本次查询」 跳到 Fava 专业报表核对
让它做一次复盘
- 继续提问，例如「帮我写一份月度总结」或「提供一份消费洞察」。
您应看到：
- 回答先给出跨期对比的结论，再追溯 1~2 条线索，而不是只报一个数字
- 这类问题会自动进入 「洞察模式」，无需额外开关
为什么有些提问会进入洞察模式，有些不会？
判定条件（关键词、提问长度、是否属于纯事实问句）见 Copilot 字段与限制。
用 Copilot 查询共享账本
别人把账本分享给您之后，Copilot 会同时读取您的账本与共享账本，遵循简单的查询逻辑：
- 默认优先查询您本人的账本，只有当本人账本中查不到相关记录时，才会访问共享账本
- 如果提问时直接指定账本名称（绑定时设置的别名），会直接查询对应账本
- 只有当您明确要求合计（例如用「一共」「总共」提问），才会汇总多账本数据，且回答中会标注每个数字的来源账本
说一句话生成一条待审核条目
- 在同一个对话中描述一笔交易，例如「今天在超市花了 88 元，用支付宝」。
- 等待回执。
哪些字段必须说清、哪些可以省略？
说清的字段模型直接采用，没说的按缺省补全；必填字段、缺省值与约束见 Copilot 字段与限制。
您应看到：
- 回答提示「已生成 N 条待审核条目」，并指向 「条目审核」
- 此时账本尚未被改动，条目还在待审核队列里
有多条记录要记录？
Copilot 一次性最多支持 10 条记录。
若不够，建议在「文件管理」上传文件并解析 或「移动端上传文件解析」的方式批量生成。
在条目审核里确认写入
- 通过 待办横幅 或 用户下拉菜单 进入 「待办列表」，打开 「条目审核」 待办。
- 在列表中找到来源为 「Copilot 记账」 的条目，核对日期、账户与金额；有需要可直接编辑条目文本。
- 点击确认写入。
您应看到：
- 待审核条目数减少，条目已完成写入
- 若待办已过审核截止时间，系统会自动写入，页面也会给出提示
这类条目写入
trans/collect.bean；各来源的写入位置与方式见 账本写入。
随后打开 「Fava -> 日记账」，确认这笔交易已出现在日记账中。
常见卡点
- 账本为空，问不出结果：先完成 快速入门，或在 「个人设置 → 共享账本」 添加他人分享的账本。
- 说「记一笔」后账户识别不到：确认要记的账户已存在于 「解析配置 → 账本账户」 中；新增账户可参照 新增支出分类。
下一步
- 记账字段、洞察触发条件与写入目标：Copilot 字段与限制
- 为什么记账要先过审核：为什么我一定要保留审核
- 想让 Claude Code / Cursor 也能读这份账本：接入 AI 客户端