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 支持按场景过滤
This commit is contained in:
2026-10-13 12:52:08 +08:00
parent 4425a6ba04
commit b1fb2c68a9
16 changed files with 263 additions and 21 deletions
+66
View File
@@ -0,0 +1,66 @@
# 日历
「日历」是登录后的默认首页,用月视图与年视图直观查看每天的收支情况。左侧菜单默认置于首项,访问 `/` 也会自动进入本页。
![日历(月视图)](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/calendar.png)
## 月视图
- 每天展示当天**收入**(绿色,`+`)、**支出**(红色,`-`)与**结余**;同一天既有收入又有支出时显示三行,否则只显示对应的一侧。
- **今天**以高亮标记;点击网格中相邻月份的灰色日期会自动切换到该月。
- 顶部四张卡片显示**当月合计**:总收入、总支出、结余、交易笔数。
## 切换月份与视图
表头提供:
- 「‹」「›」:切换上一月 / 下一月(年视图下为上一年 / 下一年);
- **年份 / 月份下拉**:直接跳转到任意年月;
- **今天**:回到当前月并选中今天;
- **月视图 / 年视图**:切换视图。
## 年视图
年视图以 12 个月的卡片展示每月收入、支出与结余,无数据的月份显示「无数据」,当前月高亮。点击任意月份卡片即可进入该月的月视图。
![日历年视图](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/calendar-year.png)
某一年完全没有数据时,会显示「本年暂无交易数据」的空状态提示。
## 统计口径
表头的「**统计口径**」下拉控制参与汇总的记录范围:
| 选项 | 含义 |
|---|---|
| 仅计入统计(默认) | 只统计「计入统计」的记录 |
| 全部记录 | 计入与不计入的记录都统计 |
| 仅不计入 | 只统计「不计入统计」的记录 |
切换后日历中的金额、顶部合计与点击日期弹出的**当日明细**都会随之变化:明细只列出符合当前口径的记录,与汇总口径保持一致。
## 查看某天的明细
点击日历中的某一天,会弹出当天的**交易明细浮窗**:
- 顶部显示**当日合计**(收入 / 支出 / 结余);
- 下方逐条列出当天交易,每条在主行显示时间、分类、渠道与**金额**(收绿支红);
- 点击任意条目可打开该笔账单的**完整详情**(标签、账单关系、来源图片、原始数据等,为只读);
- 底部「**在收支记录中查看**」会携带当天日期与当前统计口径跳转到[收支记录](/guide/transactions),便于继续编辑整理。
![当日明细浮窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/calendar-day-detail.png)
> 当日明细(按当前统计口径)最多展示前 50 条,超出时浮窗内会提示总数,可点「在收支记录中查看」查看全部。
## 链接分享与偏好
- 当前视图与年月会同步到地址栏(形如 `?view=month&y=2026&m=9`),刷新页面或把链接分享给他人,都能还原到对应月份与视图。
- **视图**(月 / 年)、**统计口径**与**最近浏览的年月**会被记住,下次进入自动还原;地址栏带参数时以参数为准。
## 小技巧
- 想知道某一天具体花在哪,直接点该日期,先看当日合计,再逐条核对明细。
- 想看全年的分布,切到「年视图」浏览各月汇总,再点开支出最高的月份查看当天明细。
- 不计入统计的记录(如借款、账户间转账)默认不参与汇总,当日明细也不会列出;如需一并查看,把统计口径切换为「全部记录」。
> 想从更大的时间跨度看趋势与占比,可使用[统计面板](/guide/dashboard)的图表与筛选。