Files
ledgerly-docs/guide/pages.md
T
rosercode 923d6db5c0 docs: 同步汇账最新功能,新增智能查数、账单关系等文档
对照 ledgerly 自文档上次更新以来的全部改动,补充新功能文档、修正品牌与版本残留,并新增下载与安装页;配图已重新截取并上传 OSS,本地截图目录不纳入版本管理。

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

说明:
- download.md 的 OSS 下载链接保持待发布产物回填,暂不调整
- 已通过 npm run docs:build 与 npm run typecheck:scripts
2026-09-26 21:57:38 +08:00

4.8 KiB
Raw Blame History

页面总览

本节汇总系统的全部页面、用途、入口方式与相互之间的跳转关系。

页面清单

页面 路由 用途 入口方式
登录 /login 用户名密码登录 未登录访问受保护页面时自动跳转
注册 /register 创建账号 登录页「没有账号?去注册」(注册开启时)
数据库初始化 /database-setup 首次配置数据库 数据库未配置时自动引导
统计面板 /dashboard 收支汇总与图表 登录后默认页;左侧菜单
智能查数 /smart-query 自然语言转只读 SQL 查询 左侧菜单(AI 启用时)
收支记录 /transactions 记录管理与账单导入 左侧菜单
分类管理 /categories 收入/支出分类维护 左侧菜单
标签管理 /tags 标签维护 左侧菜单
交易渠道管理 /channels 自定义交易渠道维护 收支记录页「渠道管理」按钮
规则管理 /rules 自动归类规则 左侧菜单
邮箱账单 /email-bills/* 邮箱配置 / 发件人规则 / 待处理账单 左侧菜单
设置 /settings 账号安全 / 数据库 / 注册 / 账单来源统计 / 外观 / 导航 / AI / 通知配置 顶部用户菜单
模型使用情况 /ai-usage AI 调用统计与明细 设置页「AI 模型配置」→ 使用情况
日志 /logs/* 访问 / 登录 / 运行日志 顶部用户菜单
账单导入(独立页) /bill-import 手机端上传账单 仅由通知邮件链接直达

「账单关系」不是独立页面,它是收支记录内的弹窗:由列表「关系」列或「批量操作 → 建立关系」进入,详见账单关系。

全局导航

左侧菜单

统计面板 → 智能查数(AI 启用时)→ 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单

左侧菜单的顺序与显隐可自定义(设置 → 导航设置),并在下次进入时还原。

顶部用户菜单

  • 日志:/logs
  • 设置:/settings
  • 退出:清空登录态并返回 /login

「模型使用情况」没有独立菜单入口,需从「设置 → AI 模型配置 → 使用情况」进入。

「交易渠道管理」同样没有独立菜单入口,需从「收支记录 → 渠道管理」进入。

典型跳转路径

  • 首次使用:/database-setup → /register → /login → /dashboard
  • 手动记账:收支记录 → 点击「新增记录」→ 表单弹窗 → 保存
  • 查看趋势明细:统计面板 → 点击趋势柱、分类/渠道饼图或「查看收支记录」→ 收支记录(自动带入对应筛选条件)
  • 反向跳转:收支记录 → 点击「查看统计」→ 统计面板(还原当前筛选条件)
  • 账单导入:收支记录 → 点击「导入账单」→ 解析预览 → 确认导入 → 回到收支记录
  • 手机导入:通知邮件链接 → /bill-import(独立页,非弹窗)→ 上传解析 → 确认导入
  • 渠道维护:收支记录 → 点击「渠道管理」→ 新建 / 改名 / 删除自定义渠道 → 返回收支记录
  • 账单关系:收支记录「关系」列 → 关系弹窗;或「批量操作」勾选多条 → 建立关系
  • 智能查数:左侧菜单「智能查数」→ 输入自然语言 → 查看结果、生成的 SQL 与历史提问
  • 自动归类:规则管理配置规则 → 账单导入预览时命中并给出建议
  • 邮箱账单:邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
  • AI 辅助:设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
  • 系统维护:顶部菜单 → 设置 / 日志

页面关系说明

  • 收支记录是核心页面:手动记账、账单导入、批量操作、账单关系与 AI 能力都从这里进入,导入完成后也回到该页查看。
  • 账单导入有两条独立路径:
    • 收支记录页的「导入账单」弹窗(桌面端常用);
    • 通知邮件直达的 /bill-import 独立页(面向手机,非弹窗,元素精简,系统内无其他入口)。
  • 设置聚合了账号安全、数据库、注册、账单来源统计、外观、导航、AI、通知八类配置;模型用量与日志分别从设置页与顶部菜单进入。
  • 交易渠道管理是收支记录页的附属页;账单关系是收支记录内的弹窗,两者都在整理完成后回到收支记录继续操作。