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

对照 ledgerly 自文档上次更新以来的全部改动，补充新功能文档、修正品牌与版本残留，并新增下载与安装页；配图已重新截取并上传 OSS，本地截图目录不纳入版本管理。

变更内容：
- 新增「智能查数」「账单关系」两个使用文档页，并登记侧边栏与总览
- 设置页扩充为八个面板（账号安全、数据库实时进度、外观、导航等）并改为即时保存
- 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗
- 统计面板补充饼图/渠道图下钻与筛选双向联动；规则管理补充批量删除
- AI 能力补充智能查数与关系命名；新增下载与安装页
- 开发文档同步：AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署
- 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案，版本号对齐 0.1
- 截图脚本新增账单详情等场景并更新登记

说明：
- download.md 的 OSS 下载链接保持待发布产物回填，暂不调整
- 已通过 npm run docs:build 与 npm run typecheck:scripts

guide/ai.md

@@ -1,6 +1,6 @@
 # AI 能力
 
-系统集成 **DeepSeek** 大模型，在分类打标、查询、记账等环节提供智能辅助。所有 AI 功能需先在「系统设置 → AI 模型配置」中启用并配置 API Key。
+系统集成 **DeepSeek** 大模型，在分类打标、查询、记账等环节提供智能辅助。所有 AI 功能需先在「设置 → AI 模型配置」中启用并配置 API Key。
 
 ## 数据与隐私
 
@@ -19,6 +19,8 @@
 - 智能记账：你输入的一句话；
 - 生成分类/标签、推荐 Emoji/颜色：你输入的名称或描述；
 - 生成规则：所选记录的类型、备注、交易渠道、已有分类与标签（不含金额与原始账单数据）；
+- 生成账单关系名称：所选账单的收支类型、交易渠道、分类名称与备注（不含金额与原始账单数据）；
+- 智能查数：你输入的自然语言，以及可供查询的表结构说明（不含账单原始字段）；
 - 图片记账：你**主动上传**的账单/支付截图会**整张**发送给视觉模型（可能含金额、交易对方、订单号等），视为你主动提供的输入。
 
 图片同时会保存在本地（`data/ai-images/`），仅本人可查看；请勿上传包含他人敏感信息的图片。
@@ -27,14 +29,14 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
 
 ## 配置
 
-在「系统设置 → AI 模型配置」中：
+在「设置 → AI 模型配置」中：
 
 - 开启「启用 AI 建议」。
 - 填写 **API Key**。
 - 可选修改 **接口地址**（默认 `https://api.deepseek.com`）、**模型**（默认 `deepseek-chat`）与**视觉模型**（默认 `deepseek-flash`，用于图片记账）。
 - 点击「测试连接」验证配置。
 
-![系统设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
+![设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
 
 ## 功能一览
 
@@ -51,6 +53,8 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
 | 推荐颜色 | 标签管理 → AI 推荐 | 为标签推荐颜色 |
 | 生成规则 | 规则管理 → AI 生成规则 | 由已打标签的记录归纳分类与标签规则 |
 | 统计搜索 | 统计面板 → AI 搜索 | 自然语言解析为统计筛选条件与维度 |
+| 生成关系名称 | 收支记录 → 账单关系 → AI 生成 | 依据关联账单的类型、渠道、分类与备注生成关系名称与备注 |
+| 智能查数 | 左侧菜单 → 智能查数 | 自然语言转只读 SQL 查询并展示结果 |
 
 ## 分类与标签建议
 
@@ -60,14 +64,14 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
 
 ## 智能查询
 
-在收支记录页的 AI 查询框中输入自然语言，例如：
+在收支记录页点「AI 搜索」打开**可拖拽、可缩放的浮窗**，在输入框中用自然语言描述，例如：
 
 - 「上个月餐饮」→ 时间范围 + 分类
 - 「超过500的支出」→ 类型 + 金额区间
 - 「待报销的支出」→ 标签 + 类型
 - 「微信支付」→ 交易渠道
 
-解析结果会直接应用为筛选条件并立即查询。
+按 `Ctrl + Enter`（Mac 为 `⌘ + Enter`）提交，解析结果会直接应用为筛选条件并立即查询；浮窗的位置与大小会被记住。详见[收支记录](/guide/transactions)。
 
 ## 智能记账
 
@@ -97,13 +101,15 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
 - 顶部摘要说明识别到的账单内容；勾选后点击「导入勾选」批量写入收支记录（导入时会再次按去重键跳过重复）。
 - 未识别到有效交易时会给出提示，不会写入任何记录。
 
-> 图片记账使用的是视觉模型，可在「系统设置 → AI 模型配置」中单独配置（默认 `deepseek-flash`）。详见[系统设置](/guide/settings)。
+> 图片记账使用的是视觉模型，可在「设置 → AI 模型配置」中单独配置（默认 `deepseek-flash`）。详见[设置](/guide/settings)。
 
-导入后的记录在[收支记录](/guide/transactions)页的「**来源图片**」列可回看原图（默认加载缩略图，可切换为原图）。
+导入后的记录可在[收支记录](/guide/transactions)的「**详情**」弹窗中回看来源图片（默认加载缩略图，可点「加载原图」切换为原图）。
 
 ## AI 统计搜索
 
-在统计面板顶部的 AI 搜索框中用一句自然语言描述统计意图，例如「上个月餐饮花了多少」「近半年交通支出趋势，按周看」。系统会解析为**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径与趋势粒度**并自动回填、刷新图表。详见[统计面板](/guide/dashboard)。
+在统计面板顶部点「AI 搜索」打开浮窗，用一句自然语言描述统计意图，例如「上个月餐饮花了多少」「近半年交通支出趋势，按周看」。系统会解析为**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径与趋势粒度**并自动回填、刷新图表。详见[统计面板](/guide/dashboard)。
+
+> 想要更自由的问答式查询（直接生成查询并返回明细），可使用[智能查数](/guide/sql-query)。
 
 ## AI 生成规则
 
@@ -111,7 +117,7 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
 
 ## 用量统计
 
-「模型使用情况」页面（系统设置 → AI 模型配置 →「使用情况」）展示 AI 调用汇总与明细。
+「模型使用情况」页面（设置 → AI 模型配置 →「使用情况」）展示 AI 调用汇总与明细。
 
 ![模型使用情况](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/ai-usage.png)
 

guide/dashboard.md

@@ -23,15 +23,17 @@
 
 ## AI 搜索
 
-启用 AI 后，页面顶部会出现「**AI 搜索**」按钮，点击打开搜索弹窗。用一句自然语言描述统计意图，系统会调用大模型解析为统计参数并自动回填、刷新图表，例如：
+启用 AI 后，页面顶部会出现「**AI 搜索**」按钮，点击打开一个**可拖拽、可缩放的浮窗**（非模态）。用一句自然语言描述统计意图，系统会调用大模型解析为统计参数并自动回填、刷新图表，例如：
 
 - 「上个月餐饮花了多少」→ 时间范围 + 分类
 - 「近半年交通支出趋势，按周看」→ 时间范围 + 分类 + 按周粒度
 - 「今年各类支出占比」→ 时间范围 + 类型
 
-![AI 统计搜索弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-search.png)
+![AI 统计搜索浮窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-query-window.png)
 
-可解析并回填的参数包括：**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径**与**趋势粒度**。弹窗内提供示例问题，输入框会记住历史记录（可一键清空）；回车或点击「AI 查询」即可执行，无可用条件时会提示且不改动当前筛选。详见 [AI 能力](/guide/ai)。
+可解析并回填的参数包括：**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径**与**趋势粒度**。浮窗内提供示例问题，输入框会记住历史记录（可一键清空）；按 `Ctrl + Enter`（Mac 为 `⌘ + Enter`）或点击提交按钮执行，无可用条件时会提示且不改动当前筛选。详见 [AI 能力](/guide/ai)。
+
+> 想要返回明细的自由问答式查询，可使用[智能查数](/guide/sql-query)。
 
 ## 筛选条件
 
@@ -39,7 +41,7 @@
 - **类型**：支出 / 收入（多选）。
 - **分类**：多选，含「未分类」。
 - **交易渠道**：多选。
-- **标签**：多选。
+- **标签**：多选，含「无标签」。
 - **金额区间**：最小 ~ 最大。
 - **备注搜索**。
 
@@ -55,28 +57,37 @@
 
 | 图表 | 说明 |
 |---|---|
-| 收支趋势（柱状图） | 按所选粒度展示收入（绿）与支出（红），点击柱子或该列空白处可跳转查看对应明细 |
-| 支出分类占比（环形图） | 各分类支出金额占比 |
-| 收入分类占比（环形图） | 各分类收入金额占比 |
-| 支出交易渠道占比（环形图） | 仅统计支出，按交易渠道 |
-| 收入交易渠道占比（环形图） | 仅统计收入，按交易渠道 |
+| 收支趋势（柱状图） | 按所选粒度展示收入（绿）与支出（红），**点击柱子或该列空白处**跳转查看对应明细 |
+| 支出分类占比（环形图） | 各分类支出金额占比，**点击扇区**跳转该分类明细 |
+| 收入分类占比（环形图） | 各分类收入金额占比，**点击扇区**跳转该分类明细 |
+| 支出交易渠道占比（环形图） | 仅统计支出，按交易渠道，**点击扇区**跳转该渠道明细 |
+| 收入交易渠道占比（环形图） | 仅统计收入，按交易渠道，**点击扇区**跳转该渠道明细 |
 
 切换语言时，图表标题、图例与交易渠道名称会实时重绘。
 
-### 点击趋势图查看明细
+### 点击图表查看明细
 
-「收支趋势」柱状图的**整列都可点击**：点中柱子，或点击柱子顶端上方的空白处均可。点击后跳转到[收支记录](/guide/transactions)，并自动带入该列对应的筛选条件：
+所有图表都可点击下钻，跳转到[收支记录](/guide/transactions)并自动带入对应筛选条件：
 
-- **类型**：点中柱子时取该柱子的收入 / 支出；点击空白处时不限定类型（沿用面板当前类型筛选）；
-- **日期范围**：该列代表的时间桶——按日→当天、按周→周一至周日、按月→当月、按季→当季、按年→当年；
-- **其他筛选**：统计面板当前的统计口径、分类、交易渠道、标签、金额区间与备注关键字。
+- **趋势柱状图**：整列可点击——点中柱子，或点击柱子顶端上方的空白处均可。
+  - **类型**：点中柱子时取该柱子的收入 / 支出；点击空白处时不限定类型（沿用面板当前类型筛选）；
+  - **日期范围**：该列代表的时间桶——按日→当天、按周→周一至周日、按月→当月、按季→当季、按年→当年。
+- **分类饼图**：点击某个扇区，按该分类（含「未分类」）与对应收支类型筛选。
+- **渠道饼图**：点击某个扇区，按该交易渠道与对应收支类型筛选。
+
+无论从哪张图下钻，都会同时保留面板当前的统计口径、标签、金额区间与备注关键字等筛选。
 
 ![点击趋势柱状图跳转收支记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/dashboard-trend-jump.png)
 
-跳转后可直接查看该时间段内的对应明细；筛选条件会照常记忆，收支记录页原有的每页条数与排序偏好不受影响。
+页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转，便于核对整体明细。
+
+> 从[收支记录](/guide/transactions)点「查看统计」也会跳回本页，并还原收支记录当前的筛选条件（时间范围会切换为「自定义」）。
+
+跳转后可直接查看对应明细；筛选条件会照常记忆，收支记录页原有的每页条数与排序偏好不受影响。
 
 ## 小技巧
 
 - 想知道「上个月餐饮花了多少」，可把时间范围设为「本月」或自定义，并在分类中只勾选「餐饮」。
 - 不计入统计的记录（如借款、账户间转账）默认不会计入汇总；如需查看全部，把统计口径切换为「全部记录」。
 - 想快速核对某月、某周或某天的明细，直接点击「收支趋势」上对应的列（柱子或该列空白处），即可带着时间范围跳到收支记录。
+- 点击分类或渠道饼图的某个扇区，可一键下钻到该分类 / 渠道的明细；点「查看收支记录」则带上当前全部筛选。

guide/download.md

@@ -0,0 +1,109 @@
+# 下载与安装
+
+本章介绍如何获取「汇账」的安装包并在本机运行。
+
+系统提供两种分发形态：
+
+| 形态 | 适用场景 | 说明 |
+|---|---|---|
+| 免安装应用（app-image） | 推荐 | 自带精简 Java 运行时，解压即用，**无需另装 JDK** |
+| 可执行 jar | 已有 JDK 21 的环境 | 单个 jar 文件，`java -jar` 运行 |
+
+每个平台各提供两个版本：
+
+- **个人记账（GUI 版）**：带图形界面启动器，可在窗口或系统托盘中启停服务、打开浏览器、实时查看日志。
+- **后端服务（服务版）**：命令行启动，适合服务器或后台常驻运行。
+
+## 下载地址
+
+当前版本：`0.0.1-SNAPSHOT`。以下均为阿里云 OSS 长期签名地址，有效期至 **2036 年**。
+
+### Windows（x64）
+
+| 版本 | 下载 | 校验 |
+|---|---|---|
+| 个人记账（GUI） | [Ledgerly-windows-x64.zip](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/windows/Ledgerly-windows-x64.zip?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=2bzQh3TpGGA2qop%2FXh%2FbyN9av%2Fg%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/windows/Ledgerly-windows-x64.zip.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=uKasei8G%2Bft2kZNscrJIRKfCg8c%3D) |
+| 后端服务 | [LedgerlyServer-windows-x64.zip](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/windows/LedgerlyServer-windows-x64.zip?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=02PxWpHN%2FVjGnm%2BOAtzJakeG3GM%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/windows/LedgerlyServer-windows-x64.zip.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=ToeO4rwW6I1%2FA12bMZOV4pKsMPs%3D) |
+| 校验清单 | [SHA256SUMS](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/windows/SHA256SUMS?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=gyaLuqTqV9ra9CeJYEZZTOg1qFQ%3D) | |
+
+### Linux（x64）
+
+| 版本 | 下载 | 校验 |
+|---|---|---|
+| 个人记账（GUI） | [Ledgerly-linux-x64.tar.gz](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/linux/Ledgerly-linux-x64.tar.gz?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=cMLZ4xpv0lhz0GWC7FPXXThu4MM%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/linux/Ledgerly-linux-x64.tar.gz.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=5hEMux5%2BmLcbrg%2BNuAbwvk15qSk%3D) |
+| 后端服务 | [LedgerlyServer-linux-x64.tar.gz](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/linux/LedgerlyServer-linux-x64.tar.gz?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=VsJhCRQeWNqQuBfkyXI1llxbrko%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/linux/LedgerlyServer-linux-x64.tar.gz.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=h2evKRHMhJhQTKgv2XFKSOMR14E%3D) |
+| 校验清单 | [SHA256SUMS](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/SHA256SUMS?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=9AEbPWUyrZNxTbE3TCzVeIc3hy8%3D) | |
+
+### 可执行 jar（跨平台）
+
+需要本机已安装 **JDK 21**。
+
+| 版本 | 下载 | 校验 |
+|---|---|---|
+| 普通 jar | [ledgerly-0.0.1-SNAPSHOT-jdk21.jar](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/ledgerly-0.0.1-SNAPSHOT-jdk21.jar?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=198KOxfQgVxy9Bp5EGyqTjbcoX4%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/ledgerly-0.0.1-SNAPSHOT-jdk21.jar.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=YsP4w312R4%2BkqCFgqsaVUGY5q0k%3D) |
+| 带 GUI 启动器 jar | [ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=e6x%2FIxXBxINyaeX2BDkhnvgKvyY%3D) | [sha256](https://adccrac.oss-cn-beijing.aliyuncs.com/ledgerly/release/0.0.1-SNAPSHOT/ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar.sha256?OSSAccessKeyId=LTAI5tA21KsXJTQoSmt4m7YJ&Expires=2105596492&Signature=TfA5AwPl5OwdUv2FKLf%2F1XSXetQ%3D) |
+
+## 运行
+
+### Windows
+
+解压 zip 后进入解压出的目录：
+
+- **个人记账（GUI）**：双击 `Ledgerly.exe`，在启动器界面上点击「启动服务」，再点「打开浏览器」。
+- **后端服务**：运行 `LedgerlyServer.exe`，会附带控制台窗口显示日志；服务在本机 `http://localhost:8080` 提供页面与接口。
+
+### Linux
+
+个人记账（GUI）：
+
+```bash
+tar xzf Ledgerly-linux-x64.tar.gz
+cd Ledgerly
+./bin/Ledgerly
+```
+
+后端服务：
+
+```bash
+tar xzf LedgerlyServer-linux-x64.tar.gz
+cd LedgerlyServer
+./bin/LedgerlyServer
+```
+
+### 可执行 jar
+
+```bash
+java -jar ledgerly-0.0.1-SNAPSHOT-jdk21.jar
+```
+
+带 GUI 启动器的 jar（需要桌面环境）：
+
+```bash
+java -jar ledgerly-0.0.1-SNAPSHOT-jdk21-gui.jar
+```
+
+默认访问地址为 `http://localhost:8080`，可在「设置」中修改端口，或运行时用 `--server.port=18081` 指定。
+
+## 校验下载文件
+
+建议下载后校验文件完整性（`sha256` 文件内容即对应压缩包/ jar 的 SHA-256 值）。
+
+Linux：
+
+```bash
+sha256sum -c Ledgerly-linux-x64.tar.gz.sha256
+```
+
+Windows PowerShell：
+
+```powershell
+Get-FileHash -Algorithm SHA256 .\Ledgerly-windows-x64.zip
+# 与 .sha256 文件中的值比对
+```
+
+## 运行目录与数据
+
+- 配置、日志、数据默认落在程序所在目录；可用 `--home=<目录>` 参数或环境变量 `LEDGERLY_HOME` 指定基准目录。
+- 首次访问时，页面会引导选择 **SQLite**（本地单文件，零配置）或 **MySQL**，保存后自动建表。
+
+> 更多安装与使用说明见[快速开始](/guide/getting-started)；自行构建与部署见[构建与部署](/dev/build-deploy)。

guide/faq.md

@@ -14,7 +14,7 @@
 
 ### 支持哪些账单？
 
-支付宝、微信、美团、招商银行、交通银行，详见[账单类型与获取](/guide/bills/overview)。
+支付宝、微信、美团、淘宝、京东、招商银行、交通银行，详见[账单类型与获取](/guide/bills/overview)。
 
 ### 导入后重复了怎么办？
 
@@ -50,7 +50,7 @@
 
 ### 想让备注不显示在界面上？
 
-可在记录行使用「隐藏」功能，备注会显示为 `******`，需要时再「查看」或「取消隐藏」。
+可在记录行使用「隐藏」功能，备注会显示为 `******`，需要时再「查看」或「取消隐藏」。默认这些记录会从收支记录列表与 Excel 导出中排除；如需让其显示，可在「设置 → 外观设置」开启「显示已隐藏备注的记录」。
 
 ### 分类和标签有什么区别？
 
@@ -60,7 +60,7 @@
 
 ### AI 功能不可用？
 
-请先在「系统设置 → AI 模型配置」中开启并填写 API Key，然后点「测试连接」验证。
+请先在「设置 → AI 模型配置」中开启并填写 API Key，然后点「测试连接」验证。
 
 ### 邮箱账单会自动入库吗？
 
@@ -78,7 +78,7 @@
 
 ### 忘记密码怎么办？
 
-当前版本未提供自助找回。可在数据库中重置对应用户的密码哈希，或新建账号后迁移数据。
+登录后可在「设置 → 账号安全」中，凭**原密码**修改密码（也支持一键随机生成新密码）。若已完全忘记密码，当前版本暂未提供自助找回，可在数据库中重置该用户的密码哈希，或新建账号后迁移数据。
 
 ### 数据存在哪里？
 

guide/getting-started.md

@@ -33,7 +33,7 @@
 
 ![数据库初始化](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
 
-首次进入时按引导选择数据库类型并填写连接信息，点击「保存并应用」即可。登录后可通过右上角用户菜单 →「数据库设置」随时切换数据库；切换后原数据库的数据保留，不做自动迁移。
+首次进入时按引导选择数据库类型并填写连接信息，点击「保存并应用」即可。登录后可通过右上角用户菜单 →「设置」→「数据库配置」随时切换数据库；切换后原数据库的数据保留，不做自动迁移。
 
 ## 注册与登录
 
@@ -44,7 +44,7 @@
 
 ![注册卡片](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/register-card.png)
 
-注册功能可在「系统设置 → 注册设置」中开启或关闭。新注册用户会自动获得一套默认分类、标签与邮箱发件人规则。
+注册功能可在「设置 → 注册设置」中开启或关闭。新注册用户会自动获得一套默认分类、标签与邮箱发件人规则。
 
 ## 界面语言
 
@@ -56,7 +56,8 @@
 2. 进入「分类管理」「标签管理」按自己的习惯调整分类与标签。
 3. 在「规则管理」配置常用自动归类规则（如「星巴克 → 餐饮」）。
 4. 导出并导入历史账单（见[账单类型与获取](/guide/bills/overview)）。
-5. 按需配置「AI 模型」「定时通知」「邮箱账单」。
+5. 在「设置」中按需配置「AI 模型」「定时通知」「邮箱账单」，并可调整「外观设置」与「导航设置」。
+6. 启用 AI 后，可用左侧「智能查数」以自然语言查询账本。
 
 ## 下一步
 

guide/index.md

@@ -6,25 +6,28 @@
 
 - [项目简介](/guide/introduction)：系统定位、核心功能与技术栈
 - [快速开始](/guide/getting-started)：数据库配置、注册登录、界面语言与首次使用建议
+- [下载与安装](/guide/download)：Windows / Linux 安装包与可执行 jar 的下载、运行与校验
 - [统计面板](/guide/dashboard)：时间范围、筛选条件与图表说明
 
 ## 记账与整理
 
 - [收支记录](/guide/transactions)：记录管理、筛选、批量操作、账单导入、AI 建议与记账
+- [账单关系](/guide/relations)：父子/同级关系、关系图与 AI 生成关系名称
 - [分类与标签](/guide/categories-tags)：分类与标签的维护与使用建议
 - [交易渠道管理](/guide/channels)：内置渠道与自定义渠道的新建、改名与删除
-- [规则管理](/guide/rules)：按关键词/金额/类型自动归类打标，支持 AI 生成规则、搜索与分页
+- [规则管理](/guide/rules)：按关键词/金额/类型自动归类打标，支持 AI 生成规则、搜索、分页与批量删除
 - [邮箱账单](/guide/email-bills)：IMAP 自动拉取账单邮件
 
 ## 智能与自动化
 
-- [AI 能力](/guide/ai)：分类标签与渠道建议、自然语言查询与记账、多图图片记账（实时进度）、AI 搜索与规则生成、用量统计
+- [AI 能力](/guide/ai)：分类标签与渠道建议、自然语言查询与记账、多图图片记账（实时进度）、AI 搜索与规则生成、关系命名、用量统计
+- [智能查数](/guide/sql-query)：用自然语言生成只读 SQL 查询账本，结果支持卡片/表格/图表
 - [定时提醒与通知](/guide/notifications)：多渠道账单导入提醒
 
 ## 系统
 
-- [系统设置](/guide/settings)：数据库、注册、账单来源统计、外观、AI、通知配置
-- [系统日志](/guide/logs)：访问日志、登录日志、运行日志
+- [设置](/guide/settings)：账号安全、数据库、注册、账单来源统计、外观、导航、AI、通知配置
+- [日志](/guide/logs)：访问日志、登录日志、运行日志
 
 ## 账单获取
 

guide/introduction.md

@@ -18,13 +18,14 @@
 | 收支记录 | 增删改查、分页与多条件筛选、批量设置分类/标签、批量删除、计入统计开关、备注隐藏、导出 Excel |
 | 分类与标签 | 收入/支出分类与标签的增删改查，新用户自动获得默认数据，AI 推荐 Emoji 与颜色 |
 | 交易渠道 | 内置渠道 + 自定义渠道的新建/改名/删除，改名不影响历史账单 |
-| 统计图表 | 月度收支、分类占比、收支趋势、交易渠道占比，支持按日/周/月/季/年粒度，点击趋势图可下钻对应明细 |
+| 统计图表 | 月度收支、分类占比、收支趋势、交易渠道占比，支持按日/周/月/季/年粒度，图表可点击下钻对应明细 |
+| 账单关系 | 父子/同级多笔账单关联、自动绘制关系图，AI 生成关系名称与备注 |
 | 账单导入 | 七类账单解析、zip 解密、解析预览、按交易号去重、规则建议 |
-| 自定义规则 | 关键词/收支类型/金额区间组合，优先级排序、启用停用，导入时自动应用；支持 AI 生成规则、搜索与分页 |
-| AI 能力 | 分类标签与渠道建议、自然语言查询、文字/多图图片记账、AI 统计搜索、AI 生成规则、分类/标签/渠道生成、Emoji/颜色推荐、用量统计 |
+| 自定义规则 | 关键词/收支类型/金额区间组合，优先级排序、启用停用，导入时自动应用；支持 AI 生成规则、搜索、分页与批量删除 |
+| AI 能力 | 分类标签与渠道建议、自然语言查询、智能查数（自然语言转只读 SQL）、文字/多图图片记账、AI 统计搜索、AI 生成规则、分类/标签/渠道生成、关系命名、Emoji/颜色推荐、用量统计 |
 | 邮箱账单 | 多邮箱 IMAP IDLE 监听、发件人规则识别账单类型、待处理列表先预览再导入 |
 | 定时通知 | 每天/每周/每月提醒，邮箱 SMTP 与 Server 酱渠道，发送日志 |
-| 系统日志 | 访问日志、登录日志、运行日志在线查看，运行日志实时推送，自动清理 |
+| 日志 | 访问日志、登录日志、运行日志在线查看，运行日志实时推送，自动清理 |
 | 账号与多语言 | JWT 登录、注册开关、运行时数据库配置（SQLite/MySQL）、中/英/日三语 |
 
 ## 技术栈

guide/logs.md

@@ -1,6 +1,6 @@
-# 系统日志
+# 日志
 
-系统日志通过右上角用户菜单 →「系统日志」进入，包含三个标签页：**访问日志**、**登录日志**、**运行日志**。页头右上角可选择日志保留时长（30 天 / 90 天 / 180 天 / 永久保留）。
+日志通过右上角用户菜单 →「日志」进入，包含三个标签页：**访问日志**、**登录日志**、**运行日志**。页头右上角可选择日志保留时长（30 天 / 90 天 / 180 天 / 永久保留）。
 
 ## 访问日志
 

guide/notifications.md

@@ -1,8 +1,8 @@
 # 定时提醒与通知
 
-系统可按周期提醒你导入新账单，并通过邮箱或 Server 酱推送通知。配置入口为「系统设置 → 定时通知」。
+系统可按周期提醒你导入新账单，并通过邮箱或 Server 酱推送通知。配置入口为「设置 → 定时通知」。
 
-![系统设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
+![设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
 
 ## 提醒周期
 

guide/pages.md

@@ -10,30 +10,35 @@
 | 注册 | `/register` | 创建账号 | 登录页「没有账号？去注册」（注册开启时） |
 | 数据库初始化 | `/database-setup` | 首次配置数据库 | 数据库未配置时自动引导 |
 | 统计面板 | `/dashboard` | 收支汇总与图表 | 登录后默认页；左侧菜单 |
+| 智能查数 | `/smart-query` | 自然语言转只读 SQL 查询 | 左侧菜单（**AI 启用时**） |
 | 收支记录 | `/transactions` | 记录管理与**账单导入** | 左侧菜单 |
 | 分类管理 | `/categories` | 收入/支出分类维护 | 左侧菜单 |
 | 标签管理 | `/tags` | 标签维护 | 左侧菜单 |
 | 交易渠道管理 | `/channels` | 自定义交易渠道维护 | 收支记录页「渠道管理」按钮 |
 | 规则管理 | `/rules` | 自动归类规则 | 左侧菜单 |
 | 邮箱账单 | `/email-bills/*` | 邮箱配置 / 发件人规则 / 待处理账单 | 左侧菜单 |
-| 系统设置 | `/settings` | 数据库 / 注册 / 账单来源统计 / 外观 / AI / 通知配置 | 顶部用户菜单 |
+| 设置 | `/settings` | 账号安全 / 数据库 / 注册 / 账单来源统计 / 外观 / 导航 / AI / 通知配置 | 顶部用户菜单 |
 | 模型使用情况 | `/ai-usage` | AI 调用统计与明细 | 设置页「AI 模型配置」→ 使用情况 |
-| 系统日志 | `/logs/*` | 访问 / 登录 / 运行日志 | 顶部用户菜单 |
+| 日志 | `/logs/*` | 访问 / 登录 / 运行日志 | 顶部用户菜单 |
 | 账单导入（独立页） | `/bill-import` | 手机端上传账单 | **仅由通知邮件链接直达** |
 
+> 「账单关系」不是独立页面，它是收支记录内的弹窗：由列表「关系」列或「批量操作 → 建立关系」进入，详见[账单关系](/guide/relations)。
+
 ## 全局导航
 
 ### 左侧菜单
 
-统计面板 → 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单
+统计面板 → 智能查数（AI 启用时）→ 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单
+
+左侧菜单的**顺序与显隐可自定义**（设置 → 导航设置），并在下次进入时还原。
 
 ### 顶部用户菜单
 
-- **系统日志**：`/logs`
-- **系统设置**：`/settings`
+- **日志**：`/logs`
+- **设置**：`/settings`
 - **退出**：清空登录态并返回 `/login`
 
-> 「模型使用情况」没有独立菜单入口，需从「系统设置 → AI 模型配置 → 使用情况」进入。
+> 「模型使用情况」没有独立菜单入口，需从「设置 → AI 模型配置 → 使用情况」进入。
 >
 > 「交易渠道管理」同样没有独立菜单入口，需从「收支记录 → 渠道管理」进入。
 
@@ -41,20 +46,23 @@
 
 - **首次使用**：`/database-setup` → `/register` → `/login` → `/dashboard`
 - **手动记账**：收支记录 → 点击「新增记录」→ 表单弹窗 → 保存
-- **查看趋势明细**：统计面板 → 点击「收支趋势」某一列（柱子或该列空白处）→ 收支记录（自动带入时间范围、类型与当前筛选条件）
+- **查看趋势明细**：统计面板 → 点击趋势柱、分类/渠道饼图或「查看收支记录」→ 收支记录（自动带入对应筛选条件）
+- **反向跳转**：收支记录 → 点击「查看统计」→ 统计面板（还原当前筛选条件）
 - **账单导入**：收支记录 → 点击「导入账单」→ 解析预览 → 确认导入 → 回到收支记录
 - **手机导入**：通知邮件链接 → `/bill-import`（独立页，非弹窗）→ 上传解析 → 确认导入
 - **渠道维护**：收支记录 → 点击「渠道管理」→ 新建 / 改名 / 删除自定义渠道 → 返回收支记录
+- **账单关系**：收支记录「关系」列 → 关系弹窗；或「批量操作」勾选多条 → 建立关系
+- **智能查数**：左侧菜单「智能查数」→ 输入自然语言 → 查看结果、生成的 SQL 与历史提问
 - **自动归类**：规则管理配置规则 → 账单导入预览时命中并给出建议
 - **邮箱账单**：邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
-- **AI 辅助**：系统设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」
-- **系统维护**：顶部菜单 → 系统设置 / 系统日志
+- **AI 辅助**：设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
+- **系统维护**：顶部菜单 → 设置 / 日志
 
 ## 页面关系说明
 
-- **收支记录**是核心页面：手动记账、账单导入、批量设置、AI 能力都从这里进入，导入完成后也回到该页查看。
+- **收支记录**是核心页面：手动记账、账单导入、批量操作、账单关系与 AI 能力都从这里进入，导入完成后也回到该页查看。
 - **账单导入**有两条独立路径：
   - 收支记录页的「导入账单」**弹窗**（桌面端常用）；
   - 通知邮件直达的 **`/bill-import` 独立页**（面向手机，非弹窗，元素精简，系统内无其他入口）。
-- **系统设置**聚合了数据库、注册、账单来源统计、外观、AI、通知六类配置；模型用量与日志分别从设置页与顶部菜单进入。
-- **交易渠道管理**是收支记录页的附属页，用于维护自定义渠道，维护完成后返回收支记录继续记账或筛选。
+- **设置**聚合了账号安全、数据库、注册、账单来源统计、外观、导航、AI、通知八类配置；模型用量与日志分别从设置页与顶部菜单进入。
+- **交易渠道管理**是收支记录页的附属页；**账单关系**是收支记录内的弹窗，两者都在整理完成后回到收支记录继续操作。

guide/relations.md

@@ -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 生成关系名称、分类标签建议等。

guide/rules.md

@@ -52,6 +52,15 @@
 
 点击「搜索」按条件查询，「清空」重置全部条件。新增规则后回到第一页，便于查看新规则。
 
+## 多选与批量删除
+
+规则列表每行前都有勾选框，表头可**全选当前页**：
+
+- 勾选若干规则后，点右上角「**批量删除**」并确认，即可一次性删除选中的规则。
+- 未勾选任何规则时「批量删除」不可点击。
+
+> 删除规则只影响后续导入时的自动归类，已应用的历史记录分类与标签不会被撤销。
+
 ## AI 生成规则
 
 启用 AI 后，规则管理页右上角会出现「**AI 生成规则**」按钮，可让 AI 依据**已打标签的记录**自动归纳出「关键词 → 分类/标签」规则，无需手工逐条编写。

guide/settings.md

@@ -1,8 +1,20 @@
-# 系统设置
+# 设置
 
-系统设置通过右上角用户菜单 →「系统设置」进入，包含六个配置面板。
+「设置」通过右上角用户菜单 →「设置」进入，包含八个配置面板。
 
-![系统设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
+![设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
+
+## 账号安全
+
+![账号安全面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/panel-account-security.png)
+
+用于**修改当前登录账号的密码**：
+
+- 输入**原密码**、**新密码**与**确认新密码**，点「修改密码」提交。
+- 新密码长度需为 **6–50 个字符**，且不能与原密码相同。
+- 可点「**随机生成**」自动生成一个 12 位、含大小写字母与数字的密码（已排除易混淆字符），生成后会明文显示并可一键**复制**；修改成功后请使用新密码登录。
+
+> 修改密码仅校验原密码，**不提供**通过邮箱等方式的密码找回。
 
 ## 数据库配置
 
@@ -13,6 +25,8 @@
 - **MySQL**：主机、端口、数据库名、用户名、密码。
 - 提供「测试连接」与「保存并应用」。保存后立即生效并自动建表；已配置时密码留空表示不修改。
 
+测试与保存时会实时展示**执行进度**：连接测试、建表、结构迁移、数据源切换等步骤会以进度日志逐条推送，处理较久时请保持窗口打开，完成后点「关闭」即可。
+
 系统支持启动后再配置数据库：未配置时前端会引导进入初始化页面，无需启动前准备。登录后也可随时切换数据库，切换后原数据库数据保留、不做自动迁移。
 
 ## 注册设置
@@ -41,12 +55,37 @@
 
 ![外观设置面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/panel-display.png)
 
-选择「不计入统计」的记录在[收支记录](/guide/transactions)列表中的展示方式：
+外观设置包含三组配置，**修改后自动保存**，无需再点保存按钮：
+
+**1. 不计入统计的记录样式**：选择「不计入统计」的记录在[收支记录](/guide/transactions)列表中的展示方式：
 
 - **删除线（默认）**：整行加删除线，类型与金额列保持原样。
 - **灰色标签**：类型列显示灰色「不计入」标签，金额列置灰且不显示正负号。
 
-面板内提供**实时预览**，切换选项即可看到效果；该偏好按**当前账号**保存，登录后生效。
+面板内提供**实时预览**，切换选项即可看到效果。
+
+**2. 显示已隐藏备注的记录**（默认关闭）：
+
+- 关闭时，备注被隐藏的记录不会出现在收支记录列表与 Excel 导出中。
+- 开启后，这些记录会正常显示（备注仍为 `******`，可临时「查看」）。
+
+**3. 表格每页条数**：
+
+- **表格每页条数选项**：所有表格分页共用的候选列表，默认 `10 / 20 / 50 / 100`，可自行增删（最多 10 项）。
+- **默认每页条数**：从候选中选择，作为各表格未单独记忆时的默认值（默认 20）。
+- 每张表格会分别记住上次选择的每页条数；本机记忆优先于全局默认值。
+
+## 导航设置
+
+![导航设置面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/panel-nav-menu.png)
+
+调整左侧导航的**显示顺序与显隐**（按当前账号保存，跨设备生效）：
+
+- **拖动**每项左侧的手柄即可调整顺序，修改后自动保存。
+- 用开关控制各项的显示或隐藏。
+- 至少需保留一个可见项；「**恢复默认**」可还原为默认顺序与全部显示。
+
+> 隐藏只移除菜单入口，页面仍可通过地址直接访问。当 AI 未启用时，依赖 AI 的菜单项（如「智能查数」）不会出现在此处，也不会显示在左侧导航。
 
 ## AI 模型配置
 
@@ -68,5 +107,5 @@
 
 ## 相关
 
-- [系统日志](/guide/logs)：查看访问、登录与运行日志。
+- [日志](/guide/logs)：查看访问、登录与运行日志。
 - [快速开始](/guide/getting-started)：数据库配置与注册登录。

guide/sql-query.md

@@ -0,0 +1,74 @@
+# 智能查数
+
+「智能查数」让你用**自然语言**直接查询账本，由 AI 生成一条**只读 SQL** 并执行，结果以统计卡片、表格或图表展示，无需自己拼筛选条件。
+
+> 这是与[统计面板的「AI 搜索」](/guide/dashboard#ai-搜索)不同的能力：AI 搜索是「自然语言 → 统计面板筛选条件」，智能查数则是「自然语言 → SQL 查询」，适合更自由、更灵活的问答。
+
+## 入口与前提
+
+- 先在[设置](/guide/settings#ai-模型配置)中**启用 AI** 并配置 API Key。
+- 启用后，左侧菜单会出现「**智能查数**」（未启用时不显示）。
+- 直接访问路由 `/smart-query` 也可进入。
+
+![智能查数](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/sql-query.png)
+
+## 提问
+
+在页面顶部的输入框用一句自然语言描述想查的内容，例如：
+
+- 上个月一共花了多少钱
+- 按分类统计今年的支出
+- 今年收入最高的一个月
+- 各渠道的支出占比
+- 本月支出最高的 5 笔
+
+输入框支持多行（自动增高），点击「查询」或按 `Ctrl + Enter`（Mac 为 `⌘ + Enter`）提交；页面也会给出示例问题，点击即可直接查询。
+
+## 结果展示
+
+系统会根据查询结果自动选择展示方式：
+
+| 结果形态 | 展示 |
+|---|---|
+| 只有一行 | **统计卡片**，逐项展示各列的数值 |
+| 多行且含数值列 | **动态表格**，可切换为**柱状图**或**饼图** |
+| 多行但无数值列 | 表格 |
+
+- 结果中的**渠道**列会自动显示渠道名称（含自定义渠道），而不是内部编码。
+- 结果最多返回 **1000 行**；超过时会提示「仅展示前 1000 行」。
+- 无结果的查询会显示空态提示。
+
+## 生成的 SQL
+
+查询结果上方会给出 AI 生成的 SQL，默认折叠：
+
+- 使用 `sql-formatter` 缩进、`highlight.js` 语法高亮，便于阅读。
+- 可点「复制 SQL」把格式化后的语句复制到剪贴板。
+- 同时展示对查询意图的简要说明。
+
+## 历史提问
+
+页面下方是**历史提问**折叠面板，按账号在服务端持久化：
+
+- 展示提问内容与时间（精确到分钟），默认展示最近若干条。
+- 支持按关键字**搜索**历史。
+- 点击某条历史可**回填并立即重新查询**；也可复制该次提问。
+- 可一键**清空历史**。
+
+> 当前会话内的提问与结果会缓存在浏览器会话中，切换账号时自动清除；结果超过 500 行时只缓存提问与视图，避免占用过多空间。
+
+## 安全与隐私
+
+智能查数始终以**只读**方式访问你自己的数据：
+
+- 仅允许**单条 `SELECT`** 查询，拒绝任何写操作、DDL、多语句、`SELECT INTO`、`FOR UPDATE` 与危险函数。
+- 只能查询**系统白名单内的数据表**，且每张表都会被强制注入当前用户的隔离条件，**只能看到本人数据**。
+- 查询**不返回原始数据（`rawData`）与交易号**等敏感字段。
+- 生成的 SQL 会经过安全网关校验后才执行，并限制执行时间与返回行数。
+
+AI 本身收到的信息仅为你的自然语言提问与可查询的表结构说明，不包含账单原始字段。
+
+## 相关
+
+- [AI 能力](/guide/ai)：系统全部 AI 功能一览。
+- [统计面板](/guide/dashboard)：固定的统计汇总与图表。

guide/transactions.md

@@ -9,8 +9,9 @@
 | 按钮 | 功能 |
 |---|---|
 | 排序 | 交易时间（新→旧 / 旧→新）、金额（高→低 / 低→高） |
+| 查看统计 | 携带当前筛选条件跳转到[统计面板](/guide/dashboard) |
 | 一键设置 | 对当前表格展示的记录批量设置分类、计入统计与标签 |
-| 批量删除 | 删除表格中勾选的记录 |
+| 批量操作 / 退出批量 | 进入多选模式，可批量删除或为选中的多条记录[建立账单关系](/guide/relations) |
 | 导入账单 | 打开账单导入弹窗 |
 | 渠道管理 | 进入[交易渠道管理](/guide/channels)页，维护自定义渠道 |
 | 导出 Excel | 按当前筛选条件导出 |
@@ -18,6 +19,8 @@
 | 智能记账 | 用一句话描述收支，AI 解析后预填表单（需启用 AI） |
 | 新增记录 | 手动新增一笔记录 |
 
+> 默认为普通模式，表格不显示勾选列；点「批量操作」后才进入多选模式，勾选记录后可「批量删除」，或勾选至少两条后「建立关系」。
+
 ## 账单导入
 
 「收支记录」页支持把支付宝、微信、美团、淘宝、京东、招商银行、交通银行的账单文件解析并导入为收支记录。
@@ -95,35 +98,42 @@
 
 **更多筛选**：标签（含「无标签」）、计入统计、金额区间。
 
-启用 AI 后，顶部会出现 **AI 智能查询**输入框，可用自然语言查询，例如：
+启用 AI 后，顶部会出现「**AI 搜索**」入口，点击打开一个**可拖拽、可缩放的浮窗**（非模态，打开后仍可继续操作主界面）。在浮窗中用自然语言查询，例如：
 
 - 「上个月餐饮」
 - 「超过500的支出」
 - 「待报销的支出」
 - 「微信支付」
 
-解析结果会直接应用为筛选条件并立即查询。筛选条件与每页条数、排序方式会自动记忆，下次进入自动还原。
+浮窗输入框支持多行，按 `Ctrl + Enter`（Mac 为 `⌘ + Enter`）提交；解析结果会直接应用为筛选条件并立即查询。浮窗的位置与大小会被记住，输入时还能快速选择历史提问。筛选条件与每页条数、排序方式会自动记忆，下次进入自动还原。
+
+![AI 查询浮窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-query-window.png)
 
 ## 表格与行操作
 
-表格展示：交易时间、类型、分类、金额、交易渠道、备注、标签、来源图片、计入统计开关与操作。
+表格展示：交易时间、类型、分类、金额、交易渠道、备注、标签、计入统计开关、关系与操作。
 
-- **备注隐藏**：可将敏感备注持久隐藏为 `******`，需要时临时「查看」或「取消隐藏」。
-- **计入统计**：行内开关可直接切换；关闭后该记录不纳入月度统计（适合借款、转账等），行内会以删除线标示。
-- **来源图片**：图片记账生成的记录会显示「查看（N）」入口，弹窗内先加载缩略图，可按需「加载原图」查看对应截图。
-- **行操作**：编辑、查看「原始数据」（账单导入或图片记账时的原始字段，以 JSON 展示）、删除。
+- **备注隐藏**：可将敏感备注持久隐藏为 `******`，需要时临时「查看」或「取消隐藏」。默认这些记录会从列表与 Excel 导出中排除，可在[设置 → 外观设置](/guide/settings#外观设置)中开启「显示已隐藏备注的记录」。
+- **计入统计**：行内开关可直接切换；关闭后该记录不纳入月度统计（适合借款、转账等），行内会以删除线标示（样式可在外观设置中调整）。
+- **关系**：展示该记录所属[账单关系](/guide/relations)组的数量，点击可查看与管理。
+- **行操作**：编辑、详情、删除。
 
-![来源图片弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/source-images.png)
+### 账单详情
 
-分页支持每页 10/20/50/100/200/500 条。
+点击行内「**详情**」打开「账单详情」弹窗，集中展示单条账单的以下信息：
 
-## 查看原始数据
+- **基本信息**：类型、金额、分类、交易渠道、交易时间、是否计入统计、备注与创建时间。
+- **标签**：该记录的全部标签。
+- **账单关系**：所属的[账单关系](/guide/relations)组，可在弹窗内直接新建。
+- **来源图片**：图片记账生成的记录会展示其来源截图，默认加载缩略图，可按需点「加载原图」查看原图。
+- **原始数据**：账单导入或图片记账时保留的原始字段（以 JSON 展示），用于核对金额、交易状态、对方账号、交易类型等明细。
 
-账单导入或图片记账时，系统会完整保留每笔交易在原始账单中的字段（以 JSON 存储）。在记录行点击「**原始数据**」即可查看，用于核对金额、交易状态、对方账号、交易类型等明细。
+![账单详情弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/bill-detail.png)
 
-- **账单导入**记录保留原始账单行字段；**图片记账**记录保留模型从截图提取的原始字段。
-- **手动新增**的记录没有原始数据，该按钮不可用。
-- 原始数据是排查导入异常、核对账单的重要依据。
+> - **账单导入**记录保留原始账单行字段；**图片记账**记录保留模型从截图提取的原始字段；**手动新增**的记录没有来源图片与原始数据。
+> - 原始数据是排查导入异常、核对账单的重要依据。
+
+分页的每页条数**候选与默认值在[设置 → 外观设置](/guide/settings#外观设置)中统一配置**（默认候选 10 / 20 / 50 / 100，默认 20）；各表格会分别记住上次选择的每页条数。
 
 ## 一键设置（批量设置）