rosercode
b1fb2c68a9
补上此前已完成但未提交的文档更新：新增「日历」页面使用文档，并把登录后默认落地页由统计面板调整为日历，同步页面流程与偏好说明；同时补充记账弹窗内可直接新建分类/标签/渠道的说明，并登记相应截图场景。 变更内容： - 新增 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 支持按场景过滤
5.9 KiB
统计面板
「统计面板」用于查看指定时间范围内的收支汇总与图表，可从左侧菜单进入（登录后的默认首页为日历）。
时间范围
顶部下拉可选择统计的时间范围：
| 选项 | 含义 |
|---|---|
| 本月 | 当月 1 日 00:00:00 ~ 当月最后一天 23:59:59（默认） |
| 近3月 | 含本月在内向前共 3 个月 |
| 近12月 | 含本月在内向前共 12 个月 |
| 自定义 | 手动选择起止日期（结束日按 23:59:59 计算） |
右侧实时显示当前查询区间。
时间粒度
趋势图右上角可选择粒度：按日 / 按周 / 按月 / 按季 / 按年。切换时间范围时会给出默认粒度（近12月→按月，近3月→按周，本月→按日）。区间内没有数据的点会补 0，保证趋势连续。
AI 搜索
启用 AI 后，页面顶部会出现「AI 搜索」按钮，点击打开一个可拖拽、可缩放的浮窗（非模态）。用一句自然语言描述统计意图，系统会调用大模型解析为统计参数并自动回填、刷新图表，例如：
- 「上个月餐饮花了多少」→ 时间范围 + 分类
- 「近半年交通支出趋势，按周看」→ 时间范围 + 分类 + 按周粒度
- 「今年各类支出占比」→ 时间范围 + 类型
可解析并回填的参数包括：时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径与趋势粒度。浮窗内提供示例问题，输入框会记住历史记录（可一键清空）；按 Ctrl + Enter（Mac 为 ⌘ + Enter）或点击提交按钮执行，无可用条件时会提示且不改动当前筛选。详见 AI 能力。
想要返回明细的自由问答式查询，可使用智能查数。
筛选条件
- 统计口径：仅计入统计（默认）/ 全部记录 / 仅不计入。默认只统计「计入统计」的记录，建议按来源设置（微信/支付宝计入、其他来源不计入），避免多来源重复统计。
- 类型：支出 / 收入（多选）。
- 分类：多选，含「未分类」。
- 交易渠道：多选。
- 标签：多选，含「无标签」。
- 金额区间：最小 ~ 最大。
- 备注搜索。
点击「重置筛选」可清空筛选（保留时间范围与粒度）。筛选条件会记住，下次进入自动还原。
汇总卡片
第一行展示四项汇总：总收入、总支出、结余、交易笔数。
第二行展示派生指标：日均收入、日均支出、最大单笔支出（附带备注摘要）、平均每笔支出。
图表
| 图表 | 说明 |
|---|---|
| 收支趋势（柱状图） | 按所选粒度展示收入（绿）与支出（红），点击柱子或该列空白处跳转查看对应明细 |
| 支出分类占比（环形图） | 各分类支出金额占比，点击扇区跳转该分类明细 |
| 收入分类占比（环形图） | 各分类收入金额占比，点击扇区跳转该分类明细 |
| 支出交易渠道占比（环形图） | 仅统计支出，按交易渠道，点击扇区跳转该渠道明细 |
| 收入交易渠道占比（环形图） | 仅统计收入，按交易渠道，点击扇区跳转该渠道明细 |
切换语言时，图表标题、图例与交易渠道名称会实时重绘。
点击图表查看明细
所有图表都可点击下钻，跳转到收支记录并自动带入对应筛选条件：
- 趋势柱状图：整列可点击——点中柱子，或点击柱子顶端上方的空白处均可。
- 类型：点中柱子时取该柱子的收入 / 支出；点击空白处时不限定类型（沿用面板当前类型筛选）；
- 日期范围：该列代表的时间桶——按日→当天、按周→周一至周日、按月→当月、按季→当季、按年→当年。
- 分类饼图：点击某个扇区，按该分类（含「未分类」）与对应收支类型筛选。
- 渠道饼图：点击某个扇区，按该交易渠道与对应收支类型筛选。
无论从哪张图下钻，都会同时保留面板当前的统计口径、标签、金额区间与备注关键字等筛选。
触屏设备上，点击趋势柱或饼图扇区会先弹出确认气泡（「查看明细」/「取消」），确认后才跳转，避免滑动或误触直接跳走；趋势图的**「整列可点」在触屏端禁用**，只能点击柱子本体。桌面端行为不变。
页面底部的「查看收支记录」按钮则会携带当前全部筛选条件跳转，便于核对整体明细。
从收支记录点「查看统计」也会跳回本页，并还原收支记录当前的筛选条件（时间范围会切换为「自定义」）。
跳转后可直接查看对应明细；筛选条件会照常记忆，收支记录页原有的每页条数与排序偏好不受影响。
小技巧
- 想知道「上个月餐饮花了多少」，可把时间范围设为「本月」或自定义，并在分类中只勾选「餐饮」。
- 不计入统计的记录（如借款、账户间转账）默认不会计入汇总；如需查看全部，把统计口径切换为「全部记录」。
- 想快速核对某月、某周或某天的明细，直接点击「收支趋势」上对应的列（柱子或该列空白处），即可带着时间范围跳到收支记录。
- 点击分类或渠道饼图的某个扇区，可一键下钻到该分类 / 渠道的明细；点「查看收支记录」则带上当前全部筛选。