phoenixclaw-ledger

💰 对话即记账的零操作财务管家

PhoenixClaw 生态的被动式记账插件,通过 AI 自动从对话和支付截图中提取收支数据,实现零手动输入的个人财务管理。

收藏
4.5k
安装
2k
版本
v0.0.2
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

PhoenixClaw Ledger 是 PhoenixClaw 生态系统中专为个人财务管理设计的被动式追踪插件,通过 AI 技术实现"零操作"记账体验。作为 post-moment-analysis 阶段的钩子插件,它能够在用户日常对话和分享支付截图时自动识别、提取并分类财务交易,彻底解决了传统记账软件需要手动输入的痛点。

核心用法上,Ledger 采用双重触发机制:一方面被动监听 PhoenixClaw Core 分析后的 Moments,通过语义分析识别对话中的金钱往来描述,或通过 OCR 技术解析微信支付、支付宝等截图;另一方面支持主动查询,用户可通过自然语言询问支出情况、生成报表或设置预算。所有数据以 YAML 格式结构化存储于用户本地的 ~/PhoenixClaw/Finance/ 目录,并自动集成到日记系统的 Finance 章节,形成完整的财务时间线。

该技能的显著优点在于极致的自动化体验。用户无需打开独立应用或手动录入,在日常聊天中即可完成记账。多模态识别能力支持文本语义理解和图像识别,配合智能商户分类和去重机制,确保数据准确性。每周日晚 9 点的自动化周报和月度财务总结,结合预算预警和储蓄目标管理,为用户提供了全方位的财务健康视图。更重要的是,所有数据处理均在本地完成,不上传云端,保障了财务隐私安全。

然而,Ledger 也存在一定局限性。首先,它深度依赖 PhoenixClaw Core 运行环境,无法作为独立工具使用,这限制了其适用场景。其次,作为 T3 来源的个人开发者作品,虽然经过安全审计,但长期维护和功能更新可能存在不确定性。截图识别的准确率受 screenshot_confidence 配置阈值影响,过低可能导致误识别,过高则可能漏记。此外,该技能设计为单用户本地使用,缺乏多用户权限管理和企业级审计功能,不适合家庭共享或商业财务场景。

该技能最适合注重隐私保护、希望降低记账门槛的个人用户,特别是那些经常使用手机支付但缺乏耐心坚持传统记账方式的人群。对于已经使用 PhoenixClaw 作为个人知识管理系统的用户,Ledger 能够无缝融入现有工作流,实现生活记录与财务管理的统一。

使用风险方面,虽然技能本身无恶意代码,但用户应注意定期备份 ~/PhoenixClaw/Finance/ 目录以防数据丢失。支付截图包含敏感交易信息,尽管存储在本地,仍需确保设备安全。此外,作为插件,其稳定性受 PhoenixClaw Core 版本更新影响,存在 API 兼容性风险。建议用户定期检查 Ledger 的解析准确性,特别是在处理大额或重要交易时进行人工核对,避免 AI 误判导致的财务数据偏差。

安全解读

核心用法

PhoenixClaw Ledger 是一款被动式财务追踪插件,作为 PhoenixClaw 生态系统的一部分,它通过语义分析和图像识别技术,在用户无感知的情况下完成记账工作。核心工作流程包括:接收 PhoenixClaw Core 分析后的"时刻"数据 → 检测文本中的消费/收入关键词(支持多语言)或支付应用截图(微信、支付宝等)→ 提取金额、商户、类别、时间戳 → 智能去重 → 本地存储至 ~/PhoenixClaw/Finance/ledger.yaml → 自动生成日记财务板块。

用户可通过自然语言主动查询:"这周花了多少钱"、"设置月度预算5000元"、"显示消费趋势"等。系统每周日晚9点自动推送消费周报,每月1日上午8点生成月度财务总结。

显著优点

1. 零操作记账:完全消除手动输入负担,从"记得记账"转变为"自然发生"
2. 多模态识别:同时支持对话语义解析和支付截图OCR,覆盖线上线下全场景

3. 智能分类体系:基于商户名称和上下文自动归类,支持用户自定义类别

4. 目标管理整合:将储蓄目标、预算控制、消费习惯与日记 Growth Notes 联动

5. 隐私优先架构:数据完全本地存储,截图本地处理,无任何云端传输

潜在局限

1. 生态依赖:必须配合 PhoenixClaw Core(最低 v0.0.3)使用,无法独立运行
2. 识别误差风险:语义理解和OCR可能存在误判,需用户定期核对

3. 中文生态局限:截图识别针对微信支付、支付宝优化,国际支付工具支持程度未知

4. 无实时同步:纯本地架构意味着跨设备数据无法自动同步

5. 无银行级对账:无法直接对接银行账户,依赖用户主动分享或提及交易

适合人群

  • 厌倦手动记账的「懒人理财」用户
  • 高频使用移动支付、愿意分享截图或提及消费场景的用户
  • 注重隐私、拒绝将财务数据上传云端的人群
  • 已在使用 PhoenixClaw 日记系统的现有用户

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据丢失 | 纯本地存储,无云端备份 | 定期备份 `~/PhoenixClaw/Finance/` 目录 |
| 识别错误 | AI可能误判语义或OCR识别金额错误 | 每周查看交易浏览器,及时修正异常记录 |
| Core系统风险 | 插件安全依赖主程序 | 保持 PhoenixClaw Core 更新至最新版本 |
| 敏感信息残留 | 截图可能含个人信息 | 确认 Ledger 的隐私声明,了解数据提取范围 |

phoenixclaw-ledger 内容

assets文件夹
references文件夹
手动下载zip · 36.4 kB
daily-finance-section.mdtext/markdown
请选择文件