PocketSmith财务管理

技能简介

PocketSmith Skill 是一个命令行工具，通过 PocketSmith API 管理个人财务数据。支持查询、创建、更新和删除交易记录与分类体系，同时提供预算分析和标签管理功能。

能做什么

• 按用户、账户、分类等多维度查询交易记录
• 创建、修改、删除交易条目（需开启写入权限）
• 构建多级分类体系，设置颜色和账单属性
• 生成预算报表与趋势分析
• 管理交易标签

使用说明

安装步骤

1. 克隆技能仓库并进入目录
2. 确保已安装 Python 3.8+ 和 uv 包管理器
3. 运行 uv sync 安装依赖

环境配置

export POCKETSMITH_DEVELOPER_KEY="your_key_here"
export POCKETSMITH_ALLOW_WRITES="true"  # 如需写入操作

常用命令示例

# 验证连接
uv run pocketsmith auth status

# 列出某用户2024年咖啡消费
uv run pocketsmith transactions list-by-user <user_id> --start-date 2024-01-01 --end-date 2024-12-31 --search "coffee"

# 创建支出交易（需开启写入）
uv run pocketsmith transactions create <account_id> --payee "超市" --amount -120.50 --date 2024-06-15

# 添加子分类
uv run pocketsmith categories create <user_id> --title "餐饮" --parent-id 123 --colour "#ff6600"

输入与输出

见下方输入与输出表格。

风险提示

• 写入操作默认禁用，需显式设置 POCKETSMITH_ALLOW_WRITES=true
• 删除交易或分类不可恢复，建议先备份数据
• API 调用受速率限制，批量操作请控制频率
• 开发者密钥泄露可能导致财务数据暴露

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/lextoumbourou/pocketsmith-skill/SKILL.md
来源类型：GitHub 开源技能