### 一、登录系统
#### 步骤 1：打开应用登录页
输入账号与密码，勾选「保持登录」后点击「登录」按钮即可进入应用主界面；没有账号时可点击「去注册」完成注册。页面底部还可点击「配置 Gitee 数据同步」直接进入同步配置。
| 登录信息 |
详细内容 |
| 默认账号 |
test |
| 默认密码 |
123456 |
| 用户配置文件 |
json/sys_user.json |
### 二、记账管理
记账模块包含：记账（编辑收支记录）与记账列表（收支明细汇总）两个页面。
#### 步骤 1：新建一笔收支记录
进入「记账」页面，可看到支出 / 收入两个大类入口，点击即可开始记账。
- 账本：选择记录归属的账本，如「个人记账」
- 收支类型：选择「支出」或「收入」
- 项目：填写交易项目或类别，如「晚餐」
- 支付途径：选择支付方式，如「微信」
- 金额：填写交易金额
- 记账时间：选择记录发生的日期时间
- 备注：可补充说明信息，如「牛肉火锅」
填写完成后点击「确定」保存，点击「取消」放弃编辑。
#### 步骤 2：查看记账列表
- 顶部汇总展示当日收入、支出与结余（如 收入 ¥0.00、支出 ¥117.00、结余 ¥-117.00）
- 支持筛选搜索，可按账本、分类、渠道等维度筛选查看
- 列表按日期分组展示每条明细（账本、类型、项目、金额等），底部展示总条数与分页信息
### 三、笔记记录
笔记模块支持随手记录文字内容，支持 Markdown 语法与换行编辑。
#### 步骤 1：新增笔记
- *名称（必填）：填写笔记名称，不能为空
- 分类：选择笔记归属的分类
- 标签：可为笔记添加标签；暂无标签时可在【我的 → 标签管理】中新增
- 内容：填写笔记正文，支持 Markdown 语法与换行
填写完成后点击「确定」保存，点击「取消」放弃。
### 四、体重记录
体重模块用于按日期时段跟踪体重变化，帮助管理个人健康数据。
#### 步骤 1：新增体重记录
- *体重时间（必填）：选择测量体重的日期时间
- *体重（KG）（必填）：输入体重数值，如 68.5
- 时段：选择「上午 / 中午 / 下午」测量时段
- 备注（选填）：补充与本次记录相关的说明
填写完成后点击「确定」保存即可。
### 五、我的（个人中心）
- 展示当前登录用户信息（用户名与账号）
- 「应用设置」：调整应用偏好与参数
- 「数据同步」：进入 Gitee 数据同步配置
- 「笔记分类管理」「笔记标签管理」：管理笔记的分类与标签
- 底部「退出登录」按钮：退出当前账号
### 六、Gitee 数据同步
Gitee 模块用于将本地数据通过私有仓库备份到远程，实现跨设备简单同步。配置后，记录数据在打开应用、回到前台、增删改后自动同步。
#### 步骤 1：获取 Gitee 访问令牌（PAT）
访问令牌（Personal Access Token，PAT）用于授权应用读写你的私有仓库。请按以下步骤在 Gitee 官网生成：
生成步骤：
- 登录 gitee.com，点击右上角头像，进入「设置」
- 在左侧菜单选择「安全设置」→「私人令牌」
- 点击「生成新令牌」，填写令牌描述（如：KeGieApp 数据同步）
- 在权限范围（scope）中勾选
projects（仓库读写权限），其余保持默认即可
- 点击「生成」，页面会显示一串
xxxxxxx 格式的令牌字符串
- 立即复制并妥善保存该令牌——出于安全考虑，Gitee 只会完整显示这一次，关闭页面后将无法再次查看
安全提示：令牌等同于你的账号凭证，请勿泄露给他人、不要提交到代码仓库。建议为令牌设置较短的过期时间，并定期更换；如不慎泄露，请立即到「私人令牌」页面删除或重新生成。
#### 步骤 2：配置 Gitee 仓库
进入「数据同步」页面（或登录页底部「配置 Gitee 数据同步」），填写仓库信息。其中「访问令牌」一栏填入上一步获取到的 PAT。
| 配置项 |
详细说明 |
| 仓库名 owner |
Gitee 用户名或组织名 |
| 仓库名称 |
用于同步数据的 Gitee 仓库名称（如 ruovea-ledger-sync / db-mysql） |
| 访问令牌 |
Gitee 个人访问令牌（PAT），在 Gitee 私人令牌中生成（勾选 scope:projects），用于访问私有仓库。获取方法见上方步骤 1 |
| 分支 |
选择同步分支，默认为 master |
| 同步路径前缀 |
留空表示仓库根目录 |
| 库文件名 |
同步的数据库文件名，默认为 ledger.db |
| 同步口令 |
留空表示不加密；设置口令后远程文件将被加密，忘记口令将无法恢复数据 |
配置Gitee（填写仓库信息）
配置Gitee测试（连接成功）
提示：请先在 Gitee 创建安全令牌（scope:projects）并妥善保管；令牌口令一致才能同步成功，忘记口令将无法恢复数据。同步仓库请优先使用私有仓库。
#### 步骤 3：测试连接并保存配置
点击「测试连接」验证仓库信息是否正确；连接成功后会提示「连接成功」。确认无误后点击「保存配置」/「保存」即可。
#### 步骤 4：执行数据同步
- 立即同步：手动触发一次数据上传 / 下载
- 导出明文库 / 导入明文库：可将本地数据库导出为明文备份，或从明文库恢复数据
- 配置完成后，记录数据在打开应用、回到前台、增删改后会自动同步
