快速开始
- 打开财务配置，只填一次当前账户余额、已有欠款、别人欠你的钱、你欠别人的钱。
- 打开财务看板，记完账先看顶部的今日记账和最近一笔，确认是否写入成功。
- 日常记账优先用 QuickAdd 的记账命令，小额消费可以选择无备注。
- 从微信或 AI 助手记账时，必须先 dry-run 确认，再写入，不要让 AI 自由编辑整个库。
- 每次手动改过流水或配置后，运行自检脚本确认没有结构错误。
node "[本地 Obsidian 仓库]/CN/99_系统/脚本/finance-self-test.js"每天主要打开哪里
- 财务看板：查看资产、负债、预算、分期、应收和趋势。
- QuickAdd 记账命令：新增流水、分期、借入、借出和收回。
- 手机端建议把记账命令放到 Commander 按钮或移动工具栏。
- 需要手动改账时，只改当月流水文件，不直接改看板代码。
文件分别是干什么的
- 财务看板：查看资产、负债、预算、分期、应收和趋势图。
- 财务配置：填写账户初始余额、负债初始欠款、应收初始余额、个人负债初始余额和月预算。
- 分期计划：记录分期总金额、期数、每期应还和还款日期。
00_财务/流水/YYYY-MM.md：每个月自动生成的流水文件，是最重要的数据源。- QuickAdd 脚本：负责弹窗录入，不需要日常手动修改。
第一次使用要做什么
- 打开财务配置。
- 在账户初始余额里填开始使用当天的余额。
- 在负债初始欠款里填开始使用当天已经欠的钱。
- 如果开始使用前别人已经欠你钱，在应收初始余额里填对象和金额。
- 如果开始使用前你已经欠别人钱，在个人负债初始余额里填对象和金额。
- 在月度分类预算里按生活费或工资目标调整预算。
- 以后不要每个月重填初始余额，后续余额由流水自动滚动计算。
普通消费怎么记
例子：用银行卡吃饭花了 21 元。
| 2026-05-26 | 支出 | 21.00 | 餐饮 | 银行卡 | | 晚餐 | | |支出会进入本月消费。餐饮会进入分类预算和饼图。银行卡会减少余额。
日期怎么选
QuickAdd 录入日期时支持今天、昨天、前天和打开日历。日常记账优先用前三个快捷项，补记更早的账再打开日历。应还日期、首还日期也支持同样方式。
转账怎么记
转账只表示你自己的不同账户之间互转，不是给别人付款。
- 适合：微信零钱提现到银行卡、支付宝余额转到银行卡、银行卡转到微信或支付宝、现金存入银行卡。
- 不适合：给朋友付款、借钱给别人、还花呗、信用卡或月付账单。
- 转出账户减少，转入账户增加，不算收入，也不算支出。
| 2026-05-28 | 转账 | 300.00 | 转账 | 微信→银行卡 | | 微信提现 | | |用花呗、月付、信用卡怎么记
用负债账户消费时，仍然按真实消费分类记录，普通账户留空，负债账户填写对应平台。
| 2026-05-27 | 支出 | 400.00 | 医疗 | | 月付账户 | 看牙 | 2026-06-10 | |
| 2026-06-10 | 还款 | 400.00 | 还款 | 银行卡 | 月付账户 | 还看牙费用 | 2026-06-10 | |- 负债账户消费会增加负债。
- 还款时账户填还款来源，负债账户填被还的账。
- 信用卡账单金额和消费当天参考汇率可能不同，以最终账单为准。
外币信用卡消费怎么记
系统流水基准货币是人民币。外币消费需要先用汇率脚本折算，再把原币、参考汇率和待账单校准写入备注。汇率查询失败时，AI 不能猜汇率，必须询问是否手动估算人民币金额。
node "[本地 Obsidian 仓库]/CN/99_系统/脚本/fx-rate.js" --from USD --to CNY --amount 20| 2026-05-28 | 支出 | 135.59 | 娱乐 | | 信用卡 | 买会员；USD 20.00，参考汇率 6.7793，折合 CNY 135.59，待账单校准 | | |分期付款怎么记
分期不要每个月都记成新的消费。购买当天记完整支出，后面每期只记还款。用 QuickAdd 选择新增分期计划时，系统会同时写入一笔完整的分期支出流水和一条分期计划。
- 等额分期：每期金额可以留空使用默认平均值，也可以手动输入固定金额。
- 非等额分期：在每期应还里写完整明细，例如
400/420/380/410。 - 看板会按每一期金额计算本月应还、剩余本金和剩余期数。
已有分期欠款怎么初始化
启用系统前已经存在的分期欠款，不要只在普通负债初始欠款里写总数，否则不能分析每一期应还。推荐用 QuickAdd 选择新增分期计划，再选择已有分期初始化。
- 总金额或剩余应还总额：当前剩余应还总额，不是原始消费总额。
- 期数：剩余还款期数。
- 每期金额：等额时就是固定每期金额。
- 每期应还：如果每期不同，就手写完整明细。
- 首还日期：下一期还款日期。
- 状态：已有分期必须填初始化。
别人借你的钱怎么记
别人借你的钱不算消费，它是账户余额减少，但应收增加。启用系统前已有应收，直接在财务配置的应收初始余额里初始化。
| 往来对象 | 初始应收 |
|---|---:|
| 某人 | 500.00 |
| 2026-05-28 | 借出 | 500.00 | 借出 | 银行卡 | | 借给某人 | | 某人 |
| 2026-06-03 | 收回 | 500.00 | 收回 | 银行卡 | | 某人还款 | | 某人 |你从别人那里借钱怎么记
启用系统前已经欠别人的钱，不要补旧流水，直接在个人负债初始余额里初始化。借入分为从平台借入和向个人借入；向个人借入时要填写往来对象。
| 往来对象 | 初始欠款 |
|---|---:|
| 某人 | 200.00 |
| 2026-05-28 | 借入 | 1000.00 | 借入 | 银行卡 | 其他负债 | 向某人借钱 | | 某人 |
| 2026-06-05 | 还款 | 1000.00 | 还款 | 银行卡 | 其他负债 | 还某人借款 | | 某人 |如果还款金额超过已记录借入或初始欠款，看板会提示异常。旧欠款补到个人负债初始余额，误记或重复记账则回到对应月份流水修正。
类型怎么选
| 场景 | 类型 |
|---|---|
| 吃饭、买东西、看病 | 支出 |
| 工资、奖金、报销到账 | 收入 |
| 自己的微信、支付宝、银行卡、现金之间互转 | 转账 |
| 还花呗、借呗、月付、信用卡 | 还款 |
| 从平台或朋友那里借入钱 | 借入 |
| 别人找你借钱 | 借出 |
| 别人还你钱 | 收回 |字段怎么理解
| 字段 | 说明 |
|---|---|
| 日期 | 交易发生日期 |
| 类型 | 支出、收入、转账、还款、借入、借出、收回 |
| 金额 | 一律填正数 |
| 分类 | 消费或业务分类 |
| 账户 | 微信、支付宝、银行卡、现金 |
| 负债账户 | 花呗、借呗、月付、信用卡、其他负债 |
| 备注 | 自由说明 |
| 应还日期 | 负债或还款对应的日期 |
| 往来对象 | 借出、收回、向个人借入、还给个人时填对方名字 |看板数字怎么看
- 资产合计：微信、支付宝、银行卡、现金余额合计。
- 应收合计：别人还欠你的钱。
- 负债合计：你还欠平台或别人的钱。
- 个人负债明细：你向具体某个人借的钱。
- 净资产：资产 + 应收 - 负债。
- 本月应还：本月需要还的负债和分期。
- 本月支出：只统计真正消费，不包含借出和还款。
- 本月收入：只统计真正收入，不包含收回和借入。
手动改流水时要注意
- 表格列不要改名、删列或换顺序。
- 金额永远填正数，不要填负数。
- 借出和收回必须填写往来对象。
- 用负债账户支付时，普通账户留空。
- 用普通账户支付时，负债账户留空。
- 改完流水后，回到看板等待 Dataview 自动刷新；不刷新时运行 QuickAdd 的仅刷新看板。
用 OpenClaw / AI 从微信记账
AI 只应该调用安全写入脚本，不要自由编辑整个 vault。流程是：解析自然语言、补齐缺失字段、先 dry-run、确认后 write、写完后自检。
安全写入脚本:
[本地 Obsidian 仓库]/CN/99_系统/脚本/ai-ledger-write.js
汇率脚本:
[本地 Obsidian 仓库]/CN/99_系统/脚本/fx-rate.js
自检脚本:
[本地 Obsidian 仓库]/CN/99_系统/脚本/finance-self-test.js- 金额、类型、付款账户或负债账户不明确时，必须先追问。
- 分类不明确时，给 2 到 3 个候选，不要静默归为其他。
- 普通支出必须有账户或负债账户，不能两个都空，也不能两个都填。
- 个人还款、借出、收回必须填写往来对象。
- 转账只表示自己的账户之间互转，账户写成
微信→银行卡这种格式。 - 所有金额都写正数。
- 写入前必须先 dry-run 给用户确认。
dry-run:
node "[本地 Obsidian 仓库]/CN/99_系统/脚本/ai-ledger-write.js" --vault "[本地 Obsidian 仓库]/CN" --json "<JSON>" --dry-run
确认写入:
node "[本地 Obsidian 仓库]/CN/99_系统/脚本/ai-ledger-write.js" --vault "[本地 Obsidian 仓库]/CN" --json "<JSON>" --write
写入后:
node "[本地 Obsidian 仓库]/CN/99_系统/脚本/finance-self-test.js"月份切换怎么办
QuickAdd 会按日期自动写入对应月份，例如 2026-05-28 写入 00_财务/流水/2026-05.md，2026-06-01 写入 00_财务/流水/2026-06.md。账户初始余额只在第一次启用系统时填写一次，后续靠流水自动滚动。
同步注意事项
- 手机和电脑同步的是同一个库，数据文件会一起同步。
- 尽量不要手机和电脑同时快速记同一个月的账，避免同步冲突。
- 如果出现冲突，优先保留两边新增的表格行，再打开看板检查统计。