docs: 同步汇账最新功能，新增智能查数、账单关系等文档

对照 ledgerly 自文档上次更新以来的全部改动，补充新功能文档、修正品牌与版本残留，并新增下载与安装页；配图已重新截取并上传 OSS，本地截图目录不纳入版本管理。变更内容： - 新增「智能查数」「账单关系」两个使用文档页，并登记侧边栏与总览 - 设置页扩充为八个面板（账号安全、数据库实时进度、外观、导航等）并改为即时保存 - 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗 - 统计面板补充饼图/渠道图下钻与筛选双向联动；规则管理补充批量删除 - AI 能力补充智能查数与关系命名；新增下载与安装页 - 开发文档同步：AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署 - 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案，版本号对齐 0.1 - 截图脚本新增账单详情等场景并更新登记说明： - download.md 的 OSS 下载链接保持待发布产物回填，暂不调整 - 已通过 npm run docs:build 与 npm run typecheck:scripts
2026-09-26 21:57:38 +08:00
parent b979c6e498
commit 923d6db5c0
35 changed files with 841 additions and 216 deletions
@@ -0,0 +1,68 @@
+# 账单关系
+
+「账单关系」用于把**互相关联的多笔收支**组合在一起，例如「交通卡充值」与后续的乘车扣款、分期还款的每一期、支付链路上的多笔记录。建立关系只做关联，不会改动金额，也不影响统计。
+
+## 两种关系类型
+
+| 类型 | 含义 | 典型场景 |
+|---|---|---|
+| **父子关系** | 一个「父账单」（资金池）对应多个「子账单」（从资金池流出） | 交通卡充值 → 多次乘车；账户充值 → 逐笔消费 |
+| **同级关系** | 多笔地位平等的账单聚合在一起 | 一笔消费在多个平台留下的关联记录、分次归还 |
+
+- 父子关系中，**必须且只能有一条父账单**，其余为子账单。
+- 同级关系中，所有成员地位相同，按加入顺序依次连接。
+
+## 入口
+
+| 入口 | 说明 |
+|---|---|
+| 收支记录列表「**关系**」列 | 该行所属关系组数量，点击「N 个关系」打开关系管理弹窗 |
+| 收支记录「**批量操作**」 | 进入多选模式，勾选**至少两条**后点「建立关系」，直接新建关系组 |
+| 账单**详情**弹窗 | 「账单关系」分组内查看该笔账单的全部关系 |
+
+![新建账单关系弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/relation-editor.png)
+
+## 新建与编辑关系
+
+1. 选择**关系类型**（父子关系 / 同级关系）。
+2. 填写**关系名称**（可选，如「交通卡充值」）与**备注**。
+3. 点「添加账单」，在分页选择弹窗中勾选要关联的账单（支持备注搜索）。
+4. 父子关系下，用单选指定其中一条为**父账单**（从批量操作进入时，默认以被操作的那条为父账单，且不可移除）；同级关系无需指定，成员按列表顺序排列。
+5. 点击「保存」。
+
+约束与说明：
+
+- 一个关系组**至少包含两条账单**，成员上限 50 条。
+- **一笔账单不能同时加入两个同类型的关系组**；如需更换，请先在原关系组中解除。
+- **关系名称会记住历史**：再次新建同名类型的关系时，名称输入框会自动给出历史名称建议（按最近使用、去重，最多 50 条）。
+- 关系类型会被**记忆**：下次新建时默认沿用上次选择的类型。
+
+## 关系图
+
+关系管理弹窗中，每个关系组都会以自绘的关系图展示：
+
+- 节点为圆形，**支出为红色、收入为绿色**；当前正在查看的账单以蓝色描边且节点更大。
+- **父子关系**：父账单居中在上，子账单分行排列，父 → 子连线带箭头。
+- **同级关系**：成员按顺序链式连接，边上标注「关联」。
+- 节点内显示金额，节点下方显示备注或分类；鼠标悬停可查看完整信息。成员较多时自动换行，图形自适应宽度。
+
+![账单关系图](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/relation-panel.png)
+
+## AI 生成名称与备注
+
+启用 AI 后，新建/编辑关系弹窗中会出现「**AI 生成**」按钮。系统会把成员账单的**收支类型、交易渠道、分类名称与备注**发送给模型（**不包含金额**），由其归纳出一个关系名称与简短备注，并自动填入；你可以在保存前修改。
+
+> 成员少于两条时无法生成，会提示先添加账单。生成的名称会覆盖名称框（备注仅在返回非空时覆盖）。
+
+## 删除关系
+
+在关系组卡片上点「删除」，确认后**仅解除关联**，不会删除任何账单。删除单笔账单时，系统会自动把它从所属关系组中移除；若某个关系组剩余成员不足两条、或父子关系不再有父账单，该关系组会自动解散。
+
+## 与统计的关系
+
+账单关系只用于**查看与整理**，不参与统计口径。每笔账单是否计入统计，仍由各自的「计入统计」开关决定，详见[收支记录](/guide/transactions)。
+
+## 相关
+
+- [收支记录](/guide/transactions)：记录管理与批量操作。
+- [AI 能力](/guide/ai)：AI 生成关系名称、分类标签建议等。