rosercode/ledgerly-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 补充管理页批量操作说明并同步规则/AI 规则文档

Browse Source 
为规则、分类、标签管理页新增的「批量操作模式」与多选删除补充使用与开发文档，同时补上此前已完成但未同步的 AI 规则建议可编辑、编辑后实时重算去重等文档，并登记批量模式截图脚本。

变更内容：
- guide/categories-tags.md：补充分类与标签的批量删除说明，并回填 tags-batch.png、categories-batch.png 配图。
- guide/rules.md：批量删除与应用匹配账单改为需先进入「批量操作」模式（默认不显示勾选框）。
- dev/api.md：新增 DELETE /api/tag/batch、/api/category/batch，并补齐规则命中账单预览/一键应用、AI 规则去重校验等接口。
- dev/data-model.md：说明标签删除清理交易标签与规则标签关联、分类删除保留逻辑引用（账单显示未分类）。
- dev/rule-engine.md、dev/ai.md、dev/preferences.md、guide/ai.md、guide/transactions.md：同步 AI 规则建议可编辑、编辑后实时重算去重、应用开关默认开启并持久化等说明。
- scripts/ts/capture-elements.ts：新增 captureBatchModes()（标签/分类批量模式截图）并纳入 main()。

说明：
- 截图经测试环境（前端 5174 / 后端 8081，虚构数据）生成，已上传 OSS，正文以 OSS 长期地址引用；public/screenshots 目录不入库。
This commit is contained in:
rosercode
2026-10-14 01:07:46 +08:00
parent d94d4e1ed5
commit 41d1a4d5a9
10 changed files with 145 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
guide/transactions.md
+6 -4
View File
@@ -27,19 +27,21 @@
| 一键设置 | 批量设置分类、计入统计与标签；**有勾选时作用于勾选记录，未勾选时作用于当前页全部记录**，详见[一键设置（批量设置）](#一键设置-批量设置) |
| 批量删除 | 勾选至少一条后出现，确认后删除所选记录 |
| 建立关系 | 勾选至少两条后出现，为所选记录[建立账单关系](/guide/relations) |
| AI 生成规则 | 启用 AI 后出现；勾选至少一条账单，由 AI 归纳分类/标签规则，可在弹窗中勾选「同时应用到当前勾选的账单」，详见 [AI 生成规则](#ai-生成规则从勾选账单) |
| AI 生成规则 | 启用 AI 后出现；勾选至少一条账单，由 AI 归纳分类/标签规则，规则可编辑、去重实时重算，可「同时应用到当前勾选的账单」（默认开启并记住），详见 [AI 生成规则](#ai-生成规则从勾选账单) |
> 翻页、刷新或退出批量模式都会清空已勾选记录。**批量删除**与**建立关系**只作用于勾选记录；**一键设置**在未勾选时才作用于当前页全部记录，且当次勾选范围以打开弹窗时的选择为准。
## AI 生成规则（从勾选账单）
启用 AI 后，批量操作区会出现「**AI 生成规则**」按钮。勾选若干账单后点击，AI 会依据这些账单的**类型、备注、交易渠道、已有分类与标签**归纳出「关键词 → 分类/标签」规则；在弹窗中预览、勾选要创建的规则后点击「创建勾选规则」批量创建，系统会自动创建建议中不存在的新分类与标签。
启用 AI 后，批量操作区会出现「**AI 生成规则**」按钮。勾选若干账单后点击，AI 会依据这些账单的**类型、备注、交易渠道、已有分类与标签**归纳出「关键词 → 分类/标签」规则。
弹窗底部可勾选「**同时应用到当前勾选的 N 条账单**」——命中规则时会**覆盖这些账单的分类并追加标签**（不改动备注与金额）。生成与「同时应用」全程不发送金额、原始账单数据等敏感字段。
在弹窗中可**直接编辑**每条规则（名称、类型、关键词、金额区间、分类、标签；AI 建议的新分类/新标签以「新建：xxx」选项保留）；编辑后系统会自动重新判定是否与已有规则重复，**改成不重复自动勾选、改成重复自动取消并禁用**。勾选后点「创建勾选规则」批量创建，系统会自动创建建议中不存在的新分类与标签。
弹窗底部可勾选「**同时应用到当前勾选的 N 条账单**」——命中规则时会**覆盖这些账单的分类并追加标签**（不改动备注与金额）。该开关**默认开启**，并会记住上次选择。生成与「同时应用」全程不发送金额、原始账单数据等敏感字段。
![AI 生成规则（收支记录）](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-rule-transactions.png)
> 与[规则管理](/guide/rules#ai-生成规则)页的「AI 生成规则」（依据**已打标签记录**归纳）不同，此入口直接以**勾选的账单**为依据，不要求已打标签；两处都会对与已有规则重复的建议标记「已存在」并禁止导入。
> 与[规则管理](/guide/rules#ai-生成规则)页的「AI 生成规则」（依据**已打标签记录**归纳）不同，此入口直接以**勾选的账单**为依据，不要求已打标签；两处的规则建议都可编辑、都会对与已有规则重复的建议标记「已存在」并禁止导入，且编辑后实时重算。
## 账单导入