Files
ledgerly-docs/guide/dashboard.md
T
rosercode b1fb2c68a9 docs: 新增日历页文档并补充记账直接新建分类/标签/渠道说明
补上此前已完成但未提交的文档更新:新增「日历」页面使用文档,并把登录后默认落地页由统计面板调整为日历,同步页面流程与偏好说明;同时补充记账弹窗内可直接新建分类/标签/渠道的说明,并登记相应截图场景。

变更内容:
- 新增 guide/calendar.md,并在 .vitepress/config.mts 侧边栏与 guide/pages.md、guide/index.md 登记日历页
- index.md、guide/getting-started.md、guide/dashboard.md、guide/pages.md 同步日历为登录后默认落地页与页面流程
- dev/preferences.md 新增日历偏好 ledgerly.calendar.view/year/month/statsScope 说明
- guide/transactions.md 补充记账弹窗内直接新建分类/标签/渠道的说明,guide/ai.md、guide/categories-tags.md、guide/channels.md 同步相关描述
- scripts/ts/capture-all.ts、capture-pages.ts、capture-elements.ts 增加日历与新建分类等截图场景,captureModals 支持按场景过滤
2026-10-13 12:52:08 +08:00

96 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 统计面板
「统计面板」用于查看指定时间范围内的收支汇总与图表,可从左侧菜单进入(登录后的默认首页为[日历](/guide/calendar))。
![统计面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/dashboard.png)
## 时间范围
顶部下拉可选择统计的时间范围:
| 选项 | 含义 |
|---|---|
| 本月 | 当月 1 日 00:00:00 ~ 当月最后一天 23:59:59(默认) |
| 近3月 | 含本月在内向前共 3 个月 |
| 近12月 | 含本月在内向前共 12 个月 |
| 自定义 | 手动选择起止日期(结束日按 23:59:59 计算) |
右侧实时显示当前查询区间。
## 时间粒度
趋势图右上角可选择粒度:**按日 / 按周 / 按月 / 按季 / 按年**。切换时间范围时会给出默认粒度(近12月→按月,近3月→按周,本月→按日)。区间内没有数据的点会补 0,保证趋势连续。
## AI 搜索
启用 AI 后,页面顶部会出现「**AI 搜索**」按钮,点击打开一个**可拖拽、可缩放的浮窗**(非模态)。用一句自然语言描述统计意图,系统会调用大模型解析为统计参数并自动回填、刷新图表,例如:
- 「上个月餐饮花了多少」→ 时间范围 + 分类
- 「近半年交通支出趋势,按周看」→ 时间范围 + 分类 + 按周粒度
- 「今年各类支出占比」→ 时间范围 + 类型
![AI 统计搜索浮窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-query-window.png)
可解析并回填的参数包括:**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径**与**趋势粒度**。浮窗内提供示例问题,输入框会记住历史记录(可一键清空);按 `Ctrl + Enter`(Mac 为 `⌘ + Enter`)或点击提交按钮执行,无可用条件时会提示且不改动当前筛选。详见 [AI 能力](/guide/ai)。
> 想要返回明细的自由问答式查询,可使用[智能查数](/guide/sql-query)。
## 筛选条件
- **统计口径**:仅计入统计(默认)/ 全部记录 / 仅不计入。默认只统计「计入统计」的记录,建议按来源设置(微信/支付宝计入、其他来源不计入),避免多来源重复统计。
- **类型**:支出 / 收入(多选)。
- **分类**:多选,含「未分类」。
- **交易渠道**:多选。
- **标签**:多选,含「无标签」。
- **金额区间**:最小 ~ 最大。
- **备注搜索**。
点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。
## 汇总卡片
第一行展示四项汇总:**总收入**、**总支出**、**结余**、**交易笔数**。
第二行展示派生指标:**日均收入**、**日均支出**、**最大单笔支出**(附带备注摘要)、**平均每笔支出**。
## 图表
| 图表 | 说明 |
|---|---|
| 收支趋势(柱状图) | 按所选粒度展示收入(绿)与支出(红),**点击柱子或该列空白处**跳转查看对应明细 |
| 支出分类占比(环形图) | 各分类支出金额占比,**点击扇区**跳转该分类明细 |
| 收入分类占比(环形图) | 各分类收入金额占比,**点击扇区**跳转该分类明细 |
| 支出交易渠道占比(环形图) | 仅统计支出,按交易渠道,**点击扇区**跳转该渠道明细 |
| 收入交易渠道占比(环形图) | 仅统计收入,按交易渠道,**点击扇区**跳转该渠道明细 |
切换语言时,图表标题、图例与交易渠道名称会实时重绘。
### 点击图表查看明细
所有图表都可点击下钻,跳转到[收支记录](/guide/transactions)并自动带入对应筛选条件:
- **趋势柱状图**:整列可点击——点中柱子,或点击柱子顶端上方的空白处均可。
- **类型**:点中柱子时取该柱子的收入 / 支出;点击空白处时不限定类型(沿用面板当前类型筛选);
- **日期范围**:该列代表的时间桶——按日→当天、按周→周一至周日、按月→当月、按季→当季、按年→当年。
- **分类饼图**:点击某个扇区,按该分类(含「未分类」)与对应收支类型筛选。
- **渠道饼图**:点击某个扇区,按该交易渠道与对应收支类型筛选。
无论从哪张图下钻,都会同时保留面板当前的统计口径、标签、金额区间与备注关键字等筛选。
> 触屏设备上,点击趋势柱或饼图扇区会先弹出确认气泡(「查看明细」/「取消」),确认后才跳转,避免滑动或误触直接跳走;趋势图的**「整列可点」在触屏端禁用**,只能点击柱子本体。桌面端行为不变。
![点击趋势柱状图跳转收支记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/dashboard-trend-jump.png)
页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转,便于核对整体明细。
> 从[收支记录](/guide/transactions)点「查看统计」也会跳回本页,并还原收支记录当前的筛选条件(时间范围会切换为「自定义」)。
跳转后可直接查看对应明细;筛选条件会照常记忆,收支记录页原有的每页条数与排序偏好不受影响。
## 小技巧
- 想知道「上个月餐饮花了多少」,可把时间范围设为「本月」或自定义,并在分类中只勾选「餐饮」。
- 不计入统计的记录(如借款、账户间转账)默认不会计入汇总;如需查看全部,把统计口径切换为「全部记录」。
- 想快速核对某月、某周或某天的明细,直接点击「收支趋势」上对应的列(柱子或该列空白处),即可带着时间范围跳到收支记录。
- 点击分类或渠道饼图的某个扇区,可一键下钻到该分类 / 渠道的明细;点「查看收支记录」则带上当前全部筛选。