核心用法
该 Skill 作为 Firefly III 个人财务管理系统的 API 操作指南，通过结构化的 curl 命令示例，覆盖财务管理的完整生命周期。用户需预先在自托管的 Firefly III 实例中生成 Personal Access Token 并配置环境变量 FIREFLY_URL 与 FIREFLY_TOKEN，即可通过标准化 REST API 执行各类财务操作。
核心功能模块包括：账户管理（支持资产、支出、收入、负债四类账户及角色细分）、交易处理（ withdrawals/deposits/transfers 三种类型，支持自动创建关联账户）、预算控制（设定周期预算限额并追踪执行进度）、储蓄目标（Piggy Banks 可视化追踪存款进度）、订阅管理（周期性账单自动提醒）、规则引擎（基于描述、金额等条件自动分类打标签）。此外还提供分类统计、交易搜索、余额报表等数据分析能力。
显著优点
数据主权完整：Firefly III 为开源自托管方案，所有财务数据存储于用户私有服务器，彻底规避 SaaS 产品的隐私泄露与服务商锁定风险。
功能覆盖全面：从日常记账到复杂预算规划、从单次交易到周期性订阅、从手动录入到自动规则分类，形成完整的个人财务闭环。
零技能依赖风险：纯 Markdown 文档型设计，无任何可执行代码或第三方依赖，供应链攻击面为零，使用行为完全可预测。
学习成本低：curl 示例直接可用，配合 jq 等工具可快速构建个性化财务工作流，适合技术用户深度定制。
潜在缺点与局限性
自托管门槛：需要用户自行部署并维护 Firefly III 实例，对非技术用户存在服务器配置、域名证书、备份策略等运维负担。
无实时同步：作为 API 参考文档，不包含自动化同步机制，需手动或配合 cron 等外部工具实现数据更新。
中文支持有限：Firefly III 界面与文档以英文为主，国内银行数据导入、货币格式等本土化适配需额外处理。
移动端缺失：原生无 App，移动端体验依赖网页版或第三方封装，不如商业记账软件便捷。
适合的目标群体
- 隐私敏感型用户：拒绝将银行流水、消费习惯等敏感数据托管至第三方云端
- 技术极客与自托管爱好者：已拥有 NAS、VPS 或家庭服务器基础设施
- 精细化预算管理者：需要多账户、多预算、多储蓄目标并行跟踪的复杂场景
- 开源工具拥护者：倾向于使用可审计、可定制的开源方案替代商业软件
使用风险与注意事项
令牌安全管理：~/.firefly_token 文件需设置严格权限（chmod 600），避免多用户系统下的未授权读取。建议定期轮换令牌并审计访问日志。
传输层安全：务必配置 HTTPS 协议，杜绝明文 HTTP 传输导致的令牌截获风险。自签名证书需妥善管理信任链。
实例来源验证：确保连接的 Firefly III 为受信任的自部署服务，警惕钓鱼攻击诱导连接恶意服务器。
权限最小化原则：创建专用令牌时按场景分配只读或读写权限，查询报表与修改数据分离，降低误操作或令牌泄露后的影响范围。
数据备份责任：自托管意味着用户需自行承担数据备份与灾难恢复，建议配置自动化备份至异地存储。