家底不记流水。它只让你在固定周期填一次「现在每个账户有多少钱」，然后把这条线画出来——涨了多少、谁占多少、负债几成。
这篇按第一次使用的顺序走一遍：建账 → 盘点 → 看 → 给家人看 → 备份。
文中所有截图来自应用内置的演示数据（SEED），不是任何人的真实账本。你装好之后看到的数字会是空的，需要自己填。
一、先建立正确预期
| 它做 | 它不做 |
|---|---|
| 按周期记录每个账户的余额 | 记每一笔收支流水 |
| 把余额变化画成趋势、按人拆、按类拆 | 做预算、做分类账 |
| 生成只读报告和加密备份 | 连银行、连支付宝、联网同步 |
用一句话判断它适不适合你：你想要的是一张每月更新的”家里现在有多少钱”，而不是一本要天天记的账。
二、装起来：三种方式选一个
| 方式 | 适合 | 命令/入口 |
|---|---|---|
| fnOS 微应用（fpk） | 有飞牛 NAS，全家用 | 应用中心安装，装完有桌面图标 |
| Docker | 任意能跑容器的机器 | docker compose up -d（仓库自带 compose.yaml） |
| 纯 Node | 想先在本机试试 | node server.mjs，然后开 http://localhost:8080 |
零依赖（npm install 都不用跑），Node ≥ 22。第一次打开会引导你设置应用密码——4–8 位字母加数字，存的是加盐哈希，不存明文。这个密码后面用来解锁账本、加密导出。
三、建账：先建成员，再建账户
顺序别反：账户必须归属到某个成员。
成员：家里有几个人就建几个，外加一个默认的「共同」（共同池、共同账户）。每个人的颜色可以改，图表里靠它区分。
账户：每一项资产或负债是一个账户，关键是三个属性：
| 属性 | 选项 | 说明 |
|---|---|---|
| 类别 | 现金 / 存款 / 投资 / 固定资产 / 负债 | 决定它在明细里归到哪一组、图表里什么颜色 |
| 归属 | 某个成员或「共同」 | 决定「按人」视图怎么拆 |
| 计入净值 | 开 / 关 | 有些账户（比如代管的钱）你可能不想算进自家净值 |
另外可以填：开户日、到期日（到期前会提醒）、当前余额、备注。
四、每月一次盘点（核心流程）
这是你唯一需要规律执行的动作。点左侧 盘点流，分三步：
① 结转——每行显示「当前余额」和「本次余额」两列，你只需要改那些变了的。留空就沿用当前余额，所以「没变化」这件事不需要填。
这页有几个细节是专门为”记不住”设计的：
- 页面底部实时算「本次净值」，你一边填一边能看到总数；
- 草稿自动暂存：填一半关上，回来还在（
清空本页草稿可以推倒重来）； - 真的没变化就点 标记为不变，一次过；
- 盘点日期默认今天，可改（补记上月也可以）。
② 确认——如果某个账户这次的数和上次差得太多，会让你单独确认一次。跳变往往是把「万」当「元」填错了，这一步就是为了拦它。
③ 完成——落盘成一条快照（{月份, 总资产, 总负债}），并更新每个账户的历史点。
万一填错了：那条快照可以撤销，改完重新提交。
五、看：三个视图回答三个问题
首页总览——「现在家里有多少钱」
总资产 213.6 万 − 总负债 85.0 万 = 净资产 128.6 万 较上次记录 +33,887（+2.71%），负债率 39.8%趋势——「是涨还是跌」。三种口径切换：
| 口径 | 画什么 | 什么时候看 |
|---|---|---|
| 净值 | 总资产 − 总负债 | 最常用，看家底增长 |
| 资产负债 | 两条线（资产、负债） | 看负债是在扩张还是收缩 |
| 结构 | 各类资产占比随时间变化 | 看现金是不是太多、投资是不是太重 |
归属——「每个人占多少」：圆环按成员分段，下面列表给出金额、占比、较上次变化。共同账户单独一段，不会被摊到个人头上。
明细——「钱都在哪」：按 现金 / 存款 / 投资 / 固定资产 / 负债 分组，每组有小计和占比；点某一行进账户详情，看这个账户自己的历史曲线。
六、设置里那几个”看起来能改其实不该改”的
- 负债率口径：显示为只读——固定
总负债 / 总资产，不提供「净负债率」切换。理由写在项目页：口径可配，两个人就会看到两个数字，然后开始吵架。 - 变化基准：同样只读——首页按「各账户上次记录余额」比，趋势按「所选区间的月度代表点」比。
- 同月多点处理：一个月盘了两次（比如月中补一次），可以选
保留多条或取当月最后一个。这个影响趋势图的取点方式，不删原始记录。 - 陈旧判定：默认 2 个月。超过这个时间没盘点，首页会提示数据已旧——提醒你该盘了。
- 金额单位：
万/元。选「万」时大数字显示为万，副标题仍给精确值。 - 涨跌色系：
红涨绿跌/绿涨红跌，只影响变化的文字颜色，不影响曲线主色。
七、给家人看：只读报告 + 隐私遮罩
只读报告：一键生成纯静态 HTML，可以导出留档或发给家人。它不带任何操作入口，也不含密码——适合”给爸妈看一眼今年攒了多少”。
隐私遮罩：左侧底部那个按钮，一点就把所有金额换成圆点、图表虚化。适合在别人旁边开电脑时用。它不是权限控制，只是显示层遮挡——真要防护，用应用密码锁。
八、备份：默认就加密
家底的数据只有一个真源：data/ledger.json。导出走加密容器，不是复制一份明文 JSON：
format: jiadi.encryptedv: 1kdf: scrypt-N32768-r8-p1 （也接受旧版 pbkdf2-sha256-210000）cipher: aes-256-gcmsalt: 16B iv: 12B tag: 16B data: <密文>几点使用上的建议：
- 导出频率：跟你的盘点节奏走，每月盘完导一次最省心；
- 密码就是应用密码：丢了打不开，所以密码自己记牢（或写进你自己的密码管理器）；
- 覆盖式操作有保险：导入账本、恢复演示、清空这类操作之前，服务端会先把当前账本复制一份到卷根的
.jiadi-keep/ledger-before-<操作>-<时间戳>.json——删应用不会连带删掉它； - 导入会被严格校验：金额必须两位小数以内、日期必须真实存在（
2026-02-30直接被拒）、账户类别必须在白名单里、账户归属的成员必须存在。校验不过就整份拒绝，不做”部分导入”。 - 还支持 CSV 导出，方便你在 Excel 里自己算点东西。
九、多人一起用要注意什么
- 共享密码：全家用同一个密码，没有多用户权限。家底是给「一家人共同看」设计的，不是给「防家里人」设计的；
- 单写者：服务端用
server.lock保证只有一个写入进程；两台设备同时改，后保存的覆盖先保存的（余额字段本来就是”最后一次盘点为准”）； - 空闲自动上锁：服务端模式下无操作 15 分钟回到锁屏（
JIADI_IDLE_LOCK_MS可调），共用平板时不容易被顺手翻到； - 手机也能开：同一局域网访问同一个地址就行，界面是响应式的。
十、常见问题
| 现象 | 处理 |
|---|---|
| 忘了应用密码 | 没有找回通道（只存哈希）。用最近的加密备份 + 你记得的密码恢复；所以密码要单独存一份 |
| 想改负债率口径 | 改不了，也不打算给。写成只读是为了让全家看同一张图 |
| 某个账户余额不确定 | 留空/不填，它会标「待补」并从汇总里排除，不会当 0 拉低净值 |
| 盘错了怎么改 | 撤销那条快照，重新盘一次 |
| 换机器怎么搬 | 导出加密备份 → 新机器装好 → 导入 |
| 数据占多大 | 一个 JSON 文件，几十个账户用几年也到不了几 MB |
| fnOS 微应用存哪 | 应用的 data/ 目录；备份策略按 NAS 自己的来 |
十一、一句话总结
建成员 → 建账户 → 每月填一次余额 → 看三条线 → 盘完导一份加密备份。
剩下所有功能（趋势口径、归属、明细、报告、遮罩）都是在这一个动作上长出来的显示层。它刻意做得少，因为记账这件事，能坚持下来的才是好账本。
相关：
- 它是怎么实现的（领域校验、单写者、备份加密）：家底项目主页
- 安装包与更新日志：github.com/Sunanang/jiadi/releases