完全指南:从余额查看到批量交易管理)
Actual Budget 账户账本Account Register完全指南从余额查看到批量交易管理【免费下载链接】actualA local-first personal finance app项目地址: https://gitcode.com/GitHub_Trending/ac/actual本指南聚焦 Actual Budget本地优先的个人理财应用中最核心的界面之一——账户账本Account Register即单个账户的交易管理视图。你将掌握账户头部各项功能的用法重命名、笔记、余额解读、对账入口、交易的导入与手动添加、条件过滤与已存过滤器以及基于多选交易的批量操作并配合仓库源码理解这些交互背后的实现原理。账户账本视图概览在 Actual Budget 中账户账本Account Register是管理某个账户全部交易的界面。你可以在侧边栏点击任意账户进入该视图也可以在“全部账户”视图下跨账户浏览交易。视图主体由三部分构成账户头部Account Header显示账户名称、当前余额并提供导入、新增、过滤、搜索、对账等操作入口交易表格按日期倒序展示该账户的全部交易支持勾选、行内编辑、拆分交易展开/折叠选中交易工具条勾选交易后出现的批量操作菜单。关于账户的创建、开/关预算on/off budget、关闭/删除账户等更底层的账户管理参见 Accounts Overview。账户头部Account Header账户头部是账本视图的“控制中心”几乎所有核心操作都从这里发起。其实现位于 packages/desktop-client/src/components/accounts/Header.tsx由AccountHeader组件渲染。重命名账户与账户笔记重命名将鼠标悬停在顶部账户名称上会浮现一个铅笔图标点击后名称变为可编辑输入框回车Enter即可保存。添加笔记名称旁还有一个笔记图标点击可写入账户备注。Actual Budget 完整支持 Markdown悬停光标到笔记图标上时笔记会按 Markdown 渲染显示。这两处交互对应源码中的AccountNameField与NotesButton组件笔记按钮通过NotesButton以account-${account.id}为 ID 绑定存储铅笔按钮触发editingName状态切换到输入框Header.tsx。注意账户重命名后提交时还会经过validateAccountName校验避免与已有账户重名Account.tsx。余额的颜色语义与已清算/未清算明细账户名称下方显示当前余额其颜色有明确的财务语义绿色余额为正红色余额为负。颜色逻辑定义在 packages/desktop-client/src/components/accounts/Balance.tsxprops.value 0时使用theme.numberNegative红大于 0 时使用theme.numberPositive绿等于 0 时使用弱化文本色。当光标悬停在余额上时会出现一个下拉箭头chevron点击后展开显示两个附加金额Cleared total已清算合计仅包含已与银行账单核对cleared的交易Uncleared total未清算合计尚未与银行对账的交易的总额。这两个值在MoreBalances组件中通过查询cleared: true/cleared: false实时计算得出Balance.tsx。理解这两个数字是对账Reconciliation的基础详见 Reconciliation。余额图Balance Chart若账户此前通过三点菜单开启了“显示余额图”头部还会渲染一张净值/余额走势图BalanceHistoryGraph其显隐状态由show-account-${accountId}-net-worth-chart偏好控制Header.tsx。导入交易Import点击头部工具栏中的Import按钮可导入外部财务文件。Actual Budget 支持CSV、QIF、OFX、QFX、CAMT五种格式其中OFX/QFX 因包含交易 ID 而推荐优先使用对去重最友好。在源码层面导入按钮弹出的文件选择框过滤了qif、ofx、qfx、csv、tsv、xml扩展名Account.tsx选中文件后打开“导入交易”弹窗导入完成后自动刷新交易列表。完整的导入步骤含 CSV 字段映射、日期格式、分隔符、金额翻转等选项参见 Importing Transactions。手动添加交易Add New点击Add New按钮会在表格顶部出现一条空白交易行Payee收款方与Category类别字段提供下拉菜单可直接从既有数据中选择可以直接新建 Payee收款方但新建类别只能前往预算视图操作详见 Budget View填写完成后回车即保存。搜索框Search头部右侧是Search搜索框可快速检索交易的全部字段收款方、类别、金额、备注等。底层通过queries.transactionsSearch构造带搜索条件的查询Account.tsx。搜索时会顺带处理你设置的系统日期格式以匹配日期字段。快捷键提示从 Header.tsx 的源码可以看到账本页内置了若干键盘快捷键——Ctrl/CmdF聚焦搜索框、T快速新增交易、Ctrl/CmdI打开导入、Ctrl/CmdB触发银行同步需已连接同步服务且在线。拆分交易Split Transactions一笔交易可以拆分成多个类别例如一笔杂货支出按比例分到“食品”和“日用品”。表格中使用展开/收缩箭头黄色框所示按钮来显示或隐藏拆分后的子交易。该按钮的切换逻辑由useSplitsExpanded状态与expand-splits本地偏好共同驱动并在表格中联动折叠/展开Header.tsx。三点菜单账户操作头部最右侧的三个水平点蓝色框所示按钮打开账户操作菜单可对账户执行多种操作源码中对应AccountMenu组件Header.tsx主要包括对账Reconcile启动对账工具详见下节导出Export将当前查询结果导出为 CSV 文件显示/隐藏余额图切换头部净值/余额走势图管理表格列Manage table columns增删列、调整列顺序显示/隐藏已核对交易过滤掉已对账reconciled的交易连接银行Link account/ 取消连接接入银行同步服务如 GoCardless、SimpleFIN、Pluggy.ai 等详见 Connecting Your Bank关闭账户Close account将账户转入“已关闭账户”或强制删除。对账Reconciliation入口头部右上角还有一把锁形图标即对账工具入口。从源码可以看到悬停该图标会显示该账户上次对账时间相对时间 绝对日期取自account.last_reconciled未对账过的账户则显示“Not yet reconciled”Header.tsx。对账完成后被锁定的交易无法直接编辑完整流程清算标记、差额核对、Lock transactions 等见 Reconciliation。交易过滤Filtering条件过滤点击头部Filter按钮可基于任意字段构建过滤条件例如“收款方为Kroger且类别为Food”。过滤与简单搜索不同支持叠加多个条件and/or 逻辑每个条件还能进一步细化日期区间、金额范围、matches正则匹配等可用于生成各类消费汇总与税务数据。过滤条件通过FiltersStack组件展示为头部下方的条件堆栈并支持增删条件、切换 and/or、一键清空Header.tsx。启用过滤后头部余额旁会出现Filtered balance过滤后余额即当前过滤结果对应的金额合计Balance.tsx。完整的过滤条件类型与实操示例含正则运算符、保存/修改/删除过滤器参见 Filtering Transactions。保存过滤器Saved Filters如果你经常重复使用同一组过滤条件可以将其保存点击交易表格上方的Unsaved filter下拉按钮选择Save new filter并命名之后点击Filter → Saved即可随时调出已保存的过滤器支持重命名、更新、删除。已保存过滤器以TransactionFilterEntity存储头部通过savedFilters属性加载并在FiltersStack中联动显示。选中交易与批量操作勾选交易与选中余额点击交易行最左侧日期字段左边的复选框即可选中一笔或多笔交易。选中后头部会显示Selected balance选中交易余额即所选交易的金额合计Balance.tsx展示在账户余额右侧便于快速核对所选交易的总和表格上方会出现选中交易数量下拉菜单红色框所示展开后可对选中交易执行批量命令。批量操作Bulk Actions选中交易后通过下拉菜单可执行以下批量操作对应SelectedTransactionsButton组件见 Header.tsx批量编辑一次性修改选中交易的收款方、类别、备注、账户等字段批量删除 / 批量复制删除或复制多笔交易复制的交易会立即出现在表格中批量应用规则Run rules对选中交易统一执行已配置的规则规则运行后自动批量更新数据库并刷新列表Account.tsx设为转账Set transfer/ 合并交易Merge处理账户间转账与重复交易关联/取消关联计划Link/Unlink schedule将交易与定期计划绑定。重要提示批量编辑/复制对**拆分交易split transactions**兼容性不佳可能产生非预期结果操作前请先展开确认或避开拆分交易。完整的批量编辑用例如为导入交易批量补类别、批量加备注、批量改账户等与详细步骤参见 Bulk Actions。底层机制速览交易如何被加载与计算理解账本视图的表现有助于你在数据量大时合理使用分页加载交易列表通过pagedQuery按 150 条一页分页拉取配合onlySync: true保证多端同步一致Account.tsx余额计算头部余额与逐行“运行余额”基于 Actual 的响应式电子表格spreadsheet引擎按需计算只有满足“无搜索、无过滤、按日期倒序”等条件时才会显示运行余额canCalculateBalanceAccount.tsx隐藏已核对交易当关闭“显示已核对交易”且不显示余额时查询会自动追加reconciled: { $eq: false }过滤Account.tsx切换账户重置状态从一个账户切到另一个账户时搜索、过滤、排序状态会自动清空Account.tsx。小结账户账本是 Actual Budget 日常记账、对账与数据分析的主战场头部聚合了账户元信息名称、笔记、余额、余额图、数据入口导入、新增、搜索、过滤与账户级操作对账、导出、关闭、银行同步交易表格则提供拆分展开、多选与批量编辑能力。将本指南与 Accounts Overview、Reconciliation、Importing Transactions、Filtering Transactions 和 Bulk Actions 配合阅读即可完整掌握从日常录入到定期对账的整套工作流。【免费下载链接】actualA local-first personal finance app项目地址: https://gitcode.com/GitHub_Trending/ac/actual创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考