企业官网建设流程全解析

OpenMuse 财务助手教程：导入 CSV 一键生成支出报表与储蓄目标

【免费下载链接】openmuseA personal agent with a browser, terminal, files, and work that keeps going built with CopilotKit and AG-UI.项目地址: https://gitcode.com/gh_mirrors/op/openmuse

OpenMuse 是一个自带浏览器、终端与文件能力的个人智能体（Personal Agent），其内置的财务助手支持导入交易 CSV，一键生成按类别聚合的支出报表，并可把结余情况转化为储蓄目标。本教程面向新手，演示如何从零准备交易数据、一键生成支出报表，并把结果存成可持续追踪的储蓄目标。

为什么选择 OpenMuse 的财务功能？

• 📊零模型也能跑：文档、监视与财务工作流无需配置大模型即可运行，本地样本环境开箱即用
• 🧾纯本地计算：CSV 解析与汇总在服务器端完成（apps/server/src/engine/finance.ts），数据不会被用来做汇率换算或外部推断
• 🎯报表直通目标：支出卡片内一键"Turn this into a savings goal"，目标自动进入 Goals 面板持续追踪

先认识你的交易 CSV 格式

财务助手对 CSV 有明确的格式约定，提前对照可避免导入报错：

导入限制（来自 finance.ts 的校验逻辑）：

1. 文件不超过500 KB
2. 交易行数在1 ~ 5,000 行之间
3. 表头必须包含上面四列，且每行列数一致

💡 小贴士：如果你的银行导出金额是"收入为正"的写法，请先整体把收入改为负数再导入，否则报表口径会不对。

三步生成支出报表

第一步：启动 OpenMuse

克隆仓库并安装依赖（详见 README.md 的 Quick start）：

git clone https://gitcode.com/gh_mirrors/op/openmuse cd openmuse pnpm install --frozen-lockfile cp .env.example .env pnpm dev

在另一个终端运行pnpm dev:web，浏览器打开localhost:8081即可进入应用。

第二步：打开财务委托任务

进入Menu → Delegate task → Finance面板，有两种方式提供数据：

• 点击Try example transactions，使用内置示例交易（新手推荐，无需准备文件）
• 直接粘贴自己的 CSV 内容到输入框

第三步：查看生成的支出卡片

任务执行时会显示 "Analyzing the imported transactions" 步骤（入口见 service.ts）。完成后，聊天区会出现Finance tracker卡片，包含：

• Income / Spending / Remaining三个核心数字（使用源币种，不做换算）
• 统计区间：从最早到最晚一笔交易的日期范围
• Where your money went：按支出降序排列的分类清单，每类配有占比进度条

卡片交互逻辑位于 agent-ui.tsx，iOS、Android 与 Web 三端体验一致。

一键把结余变成储蓄目标

在支出卡片展开详情后，点击Create savings goal（可先输入目标名称），OpenMuse 会立即完成：

1. 在 Goals 面板新建一个Finances分类的目标
2. 自动写入两个里程碑：Choose a savings target与Review spending each week
3. 卡片上显示 "Your savings goal is saved in Goals"，之后每次收入支出复盘都能对照目标看进度

也就是说，从一份 CSV 到"报表 + 可追踪储蓄目标"，全程不超过两次点击。

常见问题

Q：导入报错怎么办？报错信息会精确定位行号，例如 "Row 3 has the wrong number of columns"。逐条对照上面四列格式修复即可；金额超出安全范围、日期非 ISO 格式也会被明确拒绝。

Q：需要配置 AI 模型吗？不需要。财务工作流是确定性计算，官方文档明确其可脱离模型运行（见 docs/FEATURES.md）。

Q：我的交易数据安全吗？数据保存在本地.openmuse/目录（嵌入式 PGlite 数据库），请保持该目录私密并定期备份；远程部署时建议使用 HTTPS 并限制网络访问。

延伸阅读

• 功能全景：docs/FEATURES.md
• 财务分析源码：apps/server/src/engine/finance.ts
• 报表卡片与储蓄目标交互：apps/mobile/src/agent-ui.tsx
• 部署与存储说明：README.md

【免费下载链接】openmuseA personal agent with a browser, terminal, files, and work that keeps going built with CopilotKit and AG-UI.项目地址: https://gitcode.com/gh_mirrors/op/openmuse