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