Personal Finance Tracker

核心用法

Personal Finance 是一款基于 SQLite 的本地化记账工具，无需云端依赖即可实现完整的个人财务管理。用户可通过自然语言快速记录支出（如"午餐花费 500 元"），系统自动归类至预设或自定义分类。支持动态添加新类别，满足个性化记账需求。

关键操作路径：

• 初始化：运行 scripts/init_db.py 创建本地数据库 finance.db
• 记账：对话输入消费记录 → 自动解析金额、类别、备注 → 写入 transactions 表
• 预算管理：为 8 大预设类别（餐饮/房租/水电/交通/娱乐/购物/健康/其他）或自定义类别设定限额
• 提醒系统：在 schedules 表配置 EMI 还款日及一次性年度支出，自动触发提醒
• 周报生成：定期汇总 transactions 数据，输出消费分析与预算执行率

显著优点

1. 数据主权：SQLite 本地存储，零云端上传，隐私风险极低
2. 零配置门槛：预设 8 类常见消费场景，开箱即用
3. 扩展灵活：类别与预算均可动态调整，适应收入结构变化
4. 自动化提醒：避免遗忘固定支出，改善现金流管理

潜在局限

• 无多设备同步：纯本地架构意味着手机/电脑数据隔离，需手动迁移
• 缺乏可视化：依赖文本周报，无图表趋势分析
• 无银行对接：不支持自动导入信用卡/借记卡流水
• 提醒可靠性：依赖运行环境持续在线，关机期间可能漏提醒

适合人群

• 隐私敏感型用户（拒绝云端财务应用）
• 极简记账需求者（无需复杂投资分析）
• 技术爱好者（可自行扩展 SQL 查询与报表）
• 固定收入工薪族（EMI 与年度账单管理场景明确）

常规风险

| 风险类型 | 说明 | 缓释建议 |

|---------|------|---------|

| 数据丢失 | 本地单点存储，磁盘故障即永久丢失 | 定期手动备份 `finance.db` |

| 误操作覆盖 | SQL 直接写入无事务回滚确认 | 关键操作前导出备份快照 |

| 隐私泄露 | 数据库文件权限配置不当 | 设置文件系统访问权限 |

| 预算漂移 | 无强制超支拦截，仅提醒依赖自律 | 建议结合银行短信双重校验 |

核心用法

Personal Finance 是一款基于本地 SQLite 数据库的个人财务管理 Skill，专注于离线场景下的记账、预算与提醒功能。

基础操作三步走：
1. 初始化数据库：运行 scripts/init_db.py 创建本地存储（首次自动完成）
2. 记录支出：通过自然语言指令记账，如「午餐花费 58 元，计入餐饮类别」，系统自动写入 finance.db
3. 查看状态：查询预算余量、分类支出汇总或待付账单（EMI/年费）

预设八大类别：餐饮、房租、水电、交通、娱乐、购物、健康、其他，支持动态增删。

自动化任务：

• 每周生成消费摘要
• 自动提醒即将到期的分期付款与年度支出

---

显著优点

| 维度 | 亮点 |

|:---|:---|

| **隐私安全** | 100% 本地存储，零网络传输，财务数据不出设备 |

| **即开即用** | 无需注册账号、绑定银行卡或配置云端服务 |

| **轻量透明** | 仅 104 行代码，纯 Python + SQLite，可审计 |

| **防注入设计** | 全部采用参数化 SQL 查询，杜绝 SQL 注入风险 |

| **离线可用** | 无外部 API 依赖，弱网/无网环境完全可用 |

| **权限最小化** | 仅使用标准库（sqlite3、os），无敏感权限申请 |

---

局限与注意事项

1. 无多端同步：本地 SQLite 文件固定于 ~/.openclaw/workspace/skills/personal-finance/，换设备需手动迁移
2. 无云备份：系统故障或误删文件会导致数据永久丢失，建议定期手动备份 finance.db
3. 功能精简：无银行流水导入、无投资组合追踪、无报表可视化，适合基础记账场景
4. T3 来源可信度：由独立开发者维护，无知名组织背书，虽经安全认证但属社区项目级别
5. 输入验证待加强：当前依赖参数化查询防注入，建议未来版本增加金额格式、类别长度等校验

---

适合人群

• 隐私敏感型用户：拒绝将财务数据上传云端
• 极简主义者：不需要复杂功能，追求「打开即记」的体验
• 离线场景用户：经常处于弱网环境或注重数据主权
• 技术爱好者：希望审计代码逻辑、自定义扩展

---

常规风险

| 风险类型 | 等级 | 说明 |

|:---|:---|:---|

| 数据丢失 | ⚠️ 中 | 本地单点存储，无自动备份机制 |

| 设备迁移 | ⚠️ 低 | 需手动复制 `.db` 文件至新设备 |

| 功能误用 | 🟢 低 | 自然语言记账可能因解析偏差导致分类错误，建议定期核对 |

| 安全漏洞 | 🟢 极低 | 认证报告零威胁发现，代码结构清晰可审计 |

> 建议：每月手动备份 finance.db 至安全位置（加密 U 盘或本地 NAS），以防意外数据丢失。