NIMBLE LEDGER
这是一个本地优先的资产与现金流管理工具。网页程序与账本数据分开保存：nimble_ledger.html 是程序，*.json 是每一本账本的数据。网页版用于随时访问和分发，本地 HTML 副本可按个人需求修改。
本工具、示例账本和这份说明由账本使用者与 OpenAI Codex 协作开发。Codex 用于在本地修改和验证代码；真实账本仍只保存在用户选择的 JSON 文件中。
开始使用
- 建议用 Chrome 或 Edge 打开 HTTPS 网页；直接打开本 HTML 文件时，浏览器可能限制本地文件写回。
- 下载当前 HTML 本地版。下载后可与自己的 JSON、
README.md 和示例账本放在同一文件夹使用。
- 点击“账本管理”中的“新建账本”，输入账本名称并选择本地目录。网页会在该目录创建 JSON，之后的修改会自动写回。
- 网页版没有已登记账本时会自动加载 6 个月示例账本，无需下载即可体验。示例包含自动更新股价、汇率、多币种和常见流水；数据只在浏览器内存中展示。需要保留修改时，点击“下载示例副本”。也可单独下载示例 JSON。
- 添加月份；系统会继承最近上月的资产和汇率，不复制流水。
- 在资产负债表维护期末持仓、价格或金额，在流水表记录收入、支出、转账、买卖和还款。
- 月末更新股票价格和汇率，检查对账提示及整体趋势。
每月记账原则
- 收入、支出和转账应选择对应现金账户；转账不改变净资产。
- 买入、卖出会同时影响现金和投资持仓。股票按数量变化，基金和固定资产按金额变化。
- 还款会同时减少现金和负债。
- 优先用流水解释余额变化，不要直接修改继承来的现金、负债或持仓。出现对账提醒时，检查遗漏的流水或手工改动。
- 修改历史月份后，使用“同步到下月”或“同步到后续所有月份”重建后续期初。
数据、备份与联网
- JSON 是唯一的数据源，请定期复制备份；删除月份或批量改动前尤其应备份。
- Chrome/Edge 的 HTTPS 页面支持选择目录后自动写回 JSON。其他浏览器可导入 JSON，编辑后通过“备份”下载更新版本。
- 自动股价和汇率会访问公开接口；不希望联网时可直接手工填写价格和汇率。
- 浏览器只在本地记住文件句柄，数据仍以 JSON 文件为准；换电脑或更换浏览器后重新选择同一 JSON 即可。
移动端访问
- 通过分享链接首次打开时，会直接展示示例账本，无需下载文件。
- Android Chrome/Edge 可尝试选择目录并自动写回 JSON；无法选择目录时，使用“备份”下载更新版。
- iPhone/iPad 及其他不支持目录写回的浏览器：新建或导入后，下载 JSON 到系统“文件”App；下次重新打开并在编辑后下载新版。
- 不要把浏览器缓存或隐私模式当作正式账本存储。手机端应保留下载的 JSON，并定期备份到自己的云盘或电脑。
让 AI 修改本网页
本地版和网页版使用同一份 HTML。让 AI 修改时，提供 HTML、示例 JSON 和具体目标；确认后将新版 HTML 上传替换服务器的 index.html 即可。账本 JSON 不需要、也不应上传到服务器。
可直接使用的要求：修改此 HTML 的 [目标]；保持本地 JSON 自动保存、导入/备份、加密、跨月同步和既有 JSON 兼容；用 demo-ledger.json 验证；输出新的 HTML 文件，不修改真实账本。
样式、文案、图表和新增展示字段通常可以直接修改。涉及数据和计算时，请把以下约束一并告诉 AI：
- 保持 JSON 兼容；新增字段必须允许旧账本缺失并提供默认值，不能静默丢弃或重写用户数据。
ASSET_CLASSES、FLOW_TYPES、applyFlow、rebuildChildFromParent、syncToAll、reconcile 共同维护流水联动、跨月同步和对账，修改流水含义时必须一起检查。- 流水的
fromIdx / toIdx 引用资产列表下标；重排或删除资产时必须保留现有重映射逻辑。
- 不要把数据上传到服务器或改变本地 JSON 保存机制。涉及大范围逻辑修改时，优先生成新的
ledger_vN.html 版本并保留旧版回退。