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/ai.md
+4 -4
View File
@@ -51,7 +51,7 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
| 生成渠道 | 新增/编辑记录 → 交易渠道 → AI 新建 | 由账单描述生成渠道名称并创建 |
| 推荐 Emoji | 分类管理 → AI 推荐 | 为分类推荐 Emoji 图标 |
| 推荐颜色 | 标签管理 → AI 推荐 | 为标签推荐颜色 |
| 生成规则 | 规则管理 → AI 生成规则（已打标签记录）／收支记录 → 批量操作 → AI 生成规则（勾选账单） | 由所选记录归纳分类与标签规则，可同时应用到勾选账单 |
| 生成规则 | 规则管理 → AI 生成规则（已打标签记录）／收支记录 → 批量操作 → AI 生成规则（勾选账单） | 由所选记录归纳分类与标签规则，规则可编辑、去重实时重算，可同时应用到勾选账单（默认开启） |
| 统计搜索 | 统计面板 → AI 搜索 | 自然语言解析为统计筛选条件与维度 |
| 生成关系名称 | 收支记录 → 账单关系 → AI 生成 | 依据关联账单的类型、渠道、分类与备注生成关系名称与备注 |
| 智能查数 | 左侧菜单 → 智能查数 | 自然语言转只读 SQL 查询并展示结果 |
@@ -116,10 +116,10 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
有两种生成方式：
- **规则管理页**：点「AI 生成规则」，选择用于归纳的**已打标签记录**（默认全选当前页，支持搜索、筛选与分页），AI 依据这些记录的**类型、备注、交易渠道、已有分类与标签**生成规则建议，预览编辑后批量创建。
- **收支记录页**：在**批量操作**区勾选若干账单后点「AI 生成规则」，直接以**勾选的账单**为依据归纳规则（不要求已打标签）；弹窗中还可勾选「**同时应用到当前勾选的账单**」，命中时覆盖这些账单的分类并追加标签。
- **规则管理页**：点「AI 生成规则」，选择用于归纳的**已打标签记录**（默认全选当前页，支持搜索、筛选与分页），AI 依据这些记录的**类型、备注、交易渠道、已有分类与标签**生成规则建议；建议可**逐字段编辑**（名称、类型、关键词、金额区间、分类、标签），编辑后自动重算去重，勾选后批量创建。
- **收支记录页**：在**批量操作**区勾选若干账单后点「AI 生成规则」，直接以**勾选的账单**为依据归纳规则（不要求已打标签）；规则同样可编辑、去重实时重算，弹窗中还可勾选「**同时应用到当前勾选的账单**」（**默认开启**并记住上次选择），命中时覆盖这些账单的分类并追加标签。
两种方式都会对与已有规则重复的建议标记「已存在」并禁止导入。详见[规则管理](/guide/rules#ai-生成规则)与[收支记录](/guide/transactions#ai-生成规则从勾选账单)。
两种方式都会对与已有规则重复的建议标记「已存在」并禁止导入，且**编辑后实时重算**（改到不重复自动勾选、改成重复自动取消并禁用）。详见[规则管理](/guide/rules#ai-生成规则)与[收支记录](/guide/transactions#ai-生成规则从勾选账单)。
## 用量统计
guide/categories-tags.md
+6
View File
@@ -26,9 +26,12 @@
- **编辑**：在分类行点击「编辑」修改。
- **删除**：点击「删除」并确认；已使用该分类的记录会变为「未分类」。
- **批量删除**：点右上角「**批量操作**」进入批量选择模式，支出与收入两张表格都会出现勾选列，勾选后点「**批量删除**」并确认即可一次删除多个（两表勾选会合并处理）；点「**退出批量**」退出并清空勾选。
- **图标**：使用 Emoji 选择器挑选，也可自定义输入。
- **AI 生成分类**：启用 AI 后，输入用途描述（如「日常通勤打车地铁」），点「AI 生成」自动填充名称、类型与图标。
![分类批量删除](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/categories-batch.png)
新注册用户会自动获得一套默认分类（如餐饮、交通、购物、居住、通讯、娱乐、医疗、教育等）。
## 标签管理
@@ -46,6 +49,9 @@
- **颜色**：使用颜色选择器，内置常用色板；启用 AI 后点「AI 推荐」可按标签名称推荐颜色。
- 标签以彩色标签形式在收支记录、导入预览等位置展示。
- 删除标签会从所有交易记录中移除该标签，操作前会二次确认。
- **批量删除**：点右上角「**批量操作**」后表格出现勾选列，勾选要删除的标签后点「**批量删除**」并确认，即可一次删除多个；点「**退出批量**」退出并清空勾选。批量删除同样会从所有交易记录中移除这些标签。
![标签批量删除](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/tags-batch.png)
## 使用建议
guide/rules.md
+22 -5
View File
@@ -54,12 +54,29 @@
## 多选与批量删除
规则列表每行前都有勾选框，表头可**全选当前页**：
为保持列表清爽，规则表格默认不显示勾选框。需要进行批量操作时，点右上角「**批量操作**」进入批量选择模式，此时每行前会出现勾选框，表头可**全选当前页**；完成后点「**退出批量**」退出并清空勾选。
- 勾选若干规则后，点右上角「**批量删除**」并确认，即可一次性删除选中的规则。
- 未勾选任何规则时「批量删除」不可点击。
> 删除规则只影响后续导入时的自动归类，已应用的历史记录分类与标签不会被撤销。
> 删除规则只影响后续导入与手动应用，已应用的历史记录分类与标签不会被撤销。
## 一键应用到匹配账单
规则默认只在**账单导入**时对新增记录生效，不会自动改写已有记录。如需把规则应用到**历史账单**，可在规则列表使用「应用」：
1. **单条规则**：点击规则行的「**应用**」按钮。
2. **多条规则**：点右上角「**批量操作**」进入批量选择模式，勾选若干规则后点「**应用匹配账单**」。
两种方式都会先弹出**预览**：按规则条件（类型 + 关键词 + 金额区间）列出全部命中的账单，并显示每条账单的**当前分类/标签 → 目标分类/标签**，以及命中总数、将更新分类数与将追加标签数；确认后点「**确认应用**」执行。
![应用规则到匹配账单](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/rule-apply-preview.png)
- **分类**：覆盖写入（仅当规则分类与账单收支类型一致时）。
- **标签**：追加到账单已有标签之后，**不会删除**原有标签。
- 匹配范围为**全部历史账单**；**停用的规则**也可手动应用（应用后再启用不影响本次结果）。
- 命中超过 500 条时预览仅展示前 500 条，应用仍作用于全部命中；重复执行不会产生重复标签（幂等）。
- 全程本地运算，不调用 AI。
## AI 生成规则
@@ -71,14 +88,14 @@
![AI 生成规则 · 选择记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-rule-select.png)
2. **预览规则**：AI 依据所选记录的**类型、备注、交易渠道、已有分类与标签**归纳出规则建议，展示规则名称、关键词、目标分类与标签、理由。名称与关键词可编辑，勾选后点击「创建勾选规则」批量创建；系统会自动创建建议中不存在的新分类与标签。
2. **预览与编辑规则**：AI 依据所选记录的**类型、备注、交易渠道、已有分类与标签**归纳出规则建议，展示规则名称、类型、关键词、金额区间、目标分类与标签、理由。所有字段都可**直接编辑**（名称、类型、关键词、金额区间、分类、标签），AI 建议的新分类/新标签以下拉里的「**新建：xxx**」选项保留；勾选后点击「创建勾选规则」批量创建，系统会自动创建建议中不存在的新分类与标签。
![AI 生成规则 · 预览规则](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-rule-preview.png)
> 此外，也可在[收支记录页的批量操作区](/guide/transactions#ai-生成规则从勾选账单)勾选账单后直接生成规则（不要求已打标签），并可选「同时应用到勾选账单」。
> 此外，也可在[收支记录页的批量操作区](/guide/transactions#ai-生成规则从勾选账单)勾选账单后直接生成规则（不要求已打标签），并可选「同时应用到勾选账单」（默认开启，会记住上次选择）。
::: tip 与已有规则去重
AI 建议若与**数据库中已有规则重复**（按「类型 + 关键词 + 分类 + 标签集合」判定），会标注「**已存在**」，**默认不勾选且不可勾选**，无法导入，避免产生重复规则。
AI 建议若与**数据库中已有规则重复**（按「类型 + 关键词 + 分类 + 标签集合」判定），会标注「**已存在**」，默认不勾选且不可勾选。**编辑规则后会自动重新判定**：改成不重复会自动勾选，改成重复会自动取消勾选并禁用，避免产生重复规则。
:::
## 示例
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 生成规则」（依据**已打标签记录**归纳）不同，此入口直接以**勾选的账单**为依据，不要求已打标签；两处的规则建议都可编辑、都会对与已有规则重复的建议标记「已存在」并禁止导入，且编辑后实时重算。
## 账单导入