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