phoenixclaw-ledger

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 误判导致的财务数据偏差。