Actual 账户管理完全指南从预算账户的创建、关闭到重命名【免费下载链接】actualA local-first personal finance app项目地址: https://gitcode.com/GitHub_Trending/ac/actual本篇技术指南以 Actual 官方文档《Accounts Overview》为骨架系统讲解这款本地优先local-first个人财务应用中的账户模型——从**预算内On Budget/ 预算外Off Budget**账户的语义区别到新账户的创建流程、账户的关闭与删除、以及重命名与备注等日常管理操作。读完本文你将掌握 Actual 中账户体系的设计思路、完整操作路径以及隐藏在 UI 背后的数据模型与 API 实现原理。账户模型为什么 Actual 需要区分预算内与预算外Actual 允许你无限制地添加账户并且官方文档明确建议把所有账户包括房贷这类负债都加进来是获得个人财务全局视图的最佳方式。但与简单记账工具不同Actual 在底层把账户划分为两种语义截然不同的类型。预算内账户On Budget预算内账户直接影响预算。你可以对这类账户中的交易进行分类Categorize资金会进入月度预算的可支配额度计算账户余额会反映到预算登记表中。典型场景包括支票账户Checking信用卡Credit Card你想要纳入预算跟踪的储蓄账户预算外账户Off Budget预算外账户不参与预算分配。它的交易无法被分类只是随时间推移记录余额变化用于跟踪那些不需要规划现金流的资产或负债典型包括投资账户Investments房贷Mortgage房产、车辆等实物资产的价值跟踪从源码可以看到这一语义直接编码在数据模型中。账户实体类型 中offbudget: 0 | 1字段决定了账户的预算属性而closed: 0 | 1则标记账户是否已关闭。当账户处于预算外时新建交易时category分类字段会被置为null这正是预算外交易不可分类的底层实现依据。关于储蓄账户Savings的归属文档给出的建议是如果你不确定先放在预算内后续随时可以调整。这一决策可以在创建时决定也可以之后通过账户设置修改对应后端account-updatehandler见下文。:::note 预算外意味着当你向预算登记表budget register中的分类分配资金时该账户的余额不会被计入可用资金。 :::添加新账户完整创建流程入口位置添加账户有两个入口首次安装屏幕中央的Add Account按钮初始空状态引导。日常使用侧边栏底部的 Add account按钮。点击后会依次出现两个连续的设置界面需要填写以下选项选项说明账户来源创建本地账户Local Account或链接到受支持的银行同步服务商GoCardless / SimpleFin / PluggyAI / Akahu / Enable Banking 等账户名称为账户指定一个可识别的名字预算属性选择 On Budget 或 Off Budget当前余额输入账户的当前余额用于生成期初交易期初余额的底层实现输入当前余额后Actual 并非简单地给账户赋初值而是生成一条真实的期初交易Starting Balance transaction。在 账户服务端实现 的createAccount中流程是调用db.insertAccount插入账户记录offbudget与closed分别根据勾选状态置0/1为账户创建一个空的转账收款方transfer payee用于后续跨账户转账若余额非零则查找Starting Balance收款方与Starting Balances收入分类插入一条交易amount通过amountToInteger将用户输入的金额转换为整数分存储cleared: true期初余额默认视为已清算starting_balance_flag: true标记这是期初交易date取当前日期。这也解释了文档中Off budget 勾选框在切换账户类型后会重置的交互细节——因为每次改动类型都会重新初始化创建表单的选项状态需要再次勾选预算外选项。完成创建后新账户会立刻出现在侧边栏中。链接银行账户如果选择Link to a supported bank syncing provider则是另一条创建路径后端会先向银行同步服务商建立连接如 GoCardless 通过requisitionId、SimpleFin/PluggyAI 通过orgDomain/orgId再写入账户记录并将account_sync_source标记为对应服务商最后拉取历史交易。具体的连接方式可参考连接你的银行。不同服务商在账户层面的差异在链接实现中都有体现例如 Enable Banking 采用每账户一个会话模型因此为每个账户创建独立的银行记录而 GoCardless 则按 requisition 维度复用。关闭与删除账户当账户不再使用时可以将其关闭而不是删除以保留历史交易数据。标准关闭流程在侧边栏中点击该账户进入账户页点击交易列表右上角的**三个点⋯**打开操作菜单选择Close Account选择一个接收账户用于承接现有余额的转账——选择你已经把资金转移过去的那个账户按下Close Account确认。关闭后账户仍可在侧边栏的Closed Accounts已关闭账户分组下访问也可以从同一个操作菜单中选择Reopen重新打开。关闭操作的源码逻辑closeAccount 实现 揭示了关闭操作的分支逻辑首先会解除银行同步链接unlinkAccount从银行同步服务商处移除该账户这一步骤不可撤销若需重新同步必须再次链接账户没有任何交易直接删除账户记录账户有交易且非强制关闭将closed置为1同时如果余额不为零会通过转账收款方自动生成一条金额为-balance、备注为Closing account的转账交易把余额转移到指定账户可选指定分类强制删除force close逐个标记删除账户内的所有交易、删除转账收款方并删除账户记录。强制删除如果你想要彻底删除一个账户即使它还有余额在点击Close Account弹出的对话框中点击底部的force close即可。这会连同账户的所有历史交易一起物理删除且不可恢复操作前请务必确认。重命名账户与账户备注侧边栏快速重命名点击侧边栏中的账户名称即可触发编辑模式将光标悬停在顶部账户名称附近会浮现两个图标页面图标为账户添加备注note铅笔图标重命名账户。编辑完备注或名称后按Enter保存修改。底层实现名称与备注的修改对应后端 updateAccount handler它接收name、last_reconciled、account_group_id等字段的增量更新仅在字段有值时才更新对应列。侧边栏重命名本质上就是触发account-update这个 RPC 调用而账户备注则存储为账户关联的笔记通过账户页顶部的页面图标写入。从源码结构看桌面客户端的账户操作统一封装在 packages/desktop-client/src/accounts 目录下queries.ts负责查询对应accounts-get、account-balance、account-properties等 handlermutations.ts负责变更对应account-update、account-create、account-close、account-reopen、account-move等前后端通过 RPC 完成交互。账户生命周期小结操作入口数据影响后端 handler创建本地账户 Add account向导插入账户 转账收款方 期初交易若余额非零account-create链接银行账户 Add account向导写入账户 account_sync_source拉取历史交易gocardless-accounts-link等关闭账户账户页 ⋯ 菜单closed置 1余额自动转账account-close强制删除Close Account 弹窗底部删除账户及全部交易account-closeforced: true重新打开账户页 ⋯ 菜单closed置 0account-reopen重命名 / 备注侧边栏名称或顶部图标更新name等字段account-update整体来看Actual 的账户体系以offbudget与closed两个核心标志位为骨架配合期初交易转账收款方起始余额收款方等约定化数据构成了一个既灵活可无限添加账户、可随时关闭/重开又严谨余额转移、强制删除有完整事务逻辑的账户生命周期管理机制。掌握这些概念与操作路径后你就能根据自己的财务习惯自由搭建预算内 预算外的账户组合并安全地管理账户的整个生命周期。关联文档Accounts Overview 进阶阅读对账Reconciliation、连接你的银行【免费下载链接】actualA local-first personal finance app项目地址: https://gitcode.com/GitHub_Trending/ac/actual创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考