← Back to Skills Marketplace
wlrllr

收支管理

by wlrllr · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
128
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install wlrllr-finance-tracker
Description
个人与店铺收支管理系统。用于记录日常生活开支和店铺经营数据。 触发场景: (1) 记录日常消费(吃饭、购物、交通、房租等) (2) 设置每月开支预算并监控超支 (3) 查看月度/年度开支报表 (4) 记录店铺商品进货和销售 (5) 计算商品毛利和店铺纯利润 (6) 生成店铺经营报表 (7) 询问"这个月花了多少钱...
README (SKILL.md)

收支管理技能

数据存储

所有数据存储在 ~/private_data/openclaw/workspace/data/finance/ 目录:

  • personal_expenses.json - 个人日常开支
  • shop_purchases.json - 店铺进货记录
  • shop_sales.json - 店铺销售记录
  • settings.json - 预算设置

功能列表

1. 个人日常开支

记录开支:

用户:今天吃饭花了30元
→ 记录:{date: 今天, category: 餐饮, amount: 30, note: 午餐}

支持分类:

  • 餐饮(早餐/午餐/晚餐/零食/外卖/堂食)
  • 购物(服装/日用品/电子产品/其他)
  • 交通(公交/打车/地铁/油费/停车)
  • 住房(房租/水电/物业/维修)
  • 医疗(药店/医院/体检)
  • 通讯(话费/网费)
  • 娱乐(电影/游戏/旅游/健身)
  • 教育(培训/书籍/课程)
  • 其他

预算设置:

用户:设置每月预算5000元
→ 保存到 settings.json

超支提醒:

  • 每日记录后计算当月累计
  • 达到80%预算时提醒"注意,超支风险"
  • 达到100%时提醒"已超支!"
  • 每日 heartbeat 时检查并主动提醒

查询统计:

  • 按月查询:这个月花了多少
  • 按年查询:今年总共花了多少
  • 按分类查询:这个月吃饭花了多少
  • 趋势分析:这个月和上个月对比

2. 店铺收支

记录进货:

用户:进货 iPhone15 128G 5台 每台6000元
→ 记录:{date, product: iPhone15-128G, quantity: 5, unitPrice: 6000, total: 30000}

记录销售:

用户:卖出 iPhone15 128G 2台 每台7000元
→ 记录:{date, product: iPhone15-128G, quantity: 2, unitPrice: 7000, total: 14000}

利润计算:

  • 毛利 = 销售总收入 - 销售成本(按先进先出匹配进货)
  • 净利润 = 毛利 - 运营费用(可设置)
  • 单品利润 = 销售价 - 进货价

库存查询:

用户:查一下 iPhone15 还有多少库存
→ 显示当前库存数量和成本

报表生成:

  • 月度报表:销售额、成本、毛利、净利
  • 年度报表:同上,按月汇总
  • 按商品分类统计

使用脚本

数据操作通过 scripts/finance.py 处理:

# 记录个人开支
python3 scripts/finance.py add-expense --category 餐饮 --amount 30 --note 午餐

# 设置预算
python3 scripts/finance.py set-budget --amount 5000

# 查询本月开支
python3 scripts/finance.py check-budget

# 记录进货
python3 scripts/finance.py add-purchase --product "iPhone15-128G" --qty 5 --price 6000

# 记录销售
python3 scripts/finance.py add-sale --product "iPhone15-128G" --qty 2 --price 7000

# 查看店铺报表
python3 scripts/finance.py shop-report --period month

# 查看库存
python3 scripts/finance.py stock

对话示例

记录消费:

  • "今天早餐花了12块"
  • "买了件衣服300元"
  • "打车花了45"
  • "这个月房租2500"

查询:

  • "我这个月花了多少钱?"
  • "上周吃饭花了多少"
  • "今年总支出是多少"
  • "帮我看看这个月和上个月的对比"

店铺:

  • "今天进了10台小米手机,每台2000"
  • "卖出一台iPhone,8500"
  • "这个月赚了多少"
  • "查一下AirPods的库存"

报表格式

个人月度报表:

📊 2026年3月开支报告
━━━━━━━━━━━━
预算:5000元
已花费:3850元 (77%)
━━━━━━━━━━━━
分类明细:
  餐饮:1200元 (31%)
  购物:800元 (21%)
  交通:450元 (12%)
  住房:2500元 (含在已花费中)
  ...

店铺月度报表:

📈 2026年3月店铺报表
━━━━━━━━━━━━
销售额:125,000元
成本:98,000元
毛利:27,000元 (22%)
运营费用:3,000元
净利润:24,000元 (19%)
━━━━━━━━━━━━
热销商品:
  iPhone15 128G:销售20台,利润20,000元
  AirPods Pro:销售15台,利润4,500元
Usage Guidance
This skill appears to be what it claims: a local finance tracker implemented as a Python script. Before installing or running it, consider the following: (1) Data privacy — it writes plain JSON files to ~/private_data/openclaw/workspace/data/finance/ (personal_expenses.json, shop_purchases.json, shop_sales.json, settings.json). These are not encrypted; back them up securely or restrict filesystem permissions if you care about confidentiality. (2) No network access or credentials are requested in the visible code, but the file listing was truncated — review the entire scripts/finance.py file locally to confirm there are no hidden network calls or subprocess invocations before use. (3) The SKILL.md claims proactive daily reminders but the package does not install a scheduler; you must run the script or set up your own cron/task to get automatic checks. (4) Ensure python3 is available and review the code for any additional behaviors you don’t expect. If you want encrypted storage, remote backups, or automatic scheduling, plan to add those explicitly rather than relying on this skill to do them.
Capability Analysis
Type: OpenClaw Skill Name: wlrllr-finance-tracker Version: 1.0.0 The finance-tracker skill is a legitimate tool for managing personal and shop expenses. The Python script (scripts/finance.py) uses only standard libraries to manage local JSON data within a designated workspace directory (~/private_data/openclaw/workspace/data/finance/). There is no evidence of network activity, data exfiltration, or unauthorized command execution.
Capability Assessment
Purpose & Capability
Name/description (personal and shop finance tracking) match the provided SKILL.md and the included Python script: both implement expense/purchase/sale recording, budget checks, reports, and stock/profit calculations. There are no unrelated credentials, binaries, or services declared.
Instruction Scope
Runtime instructions and examples direct use of the included scripts/finance.py commands and reference a local data directory (~/private_data/openclaw/workspace/data/finance/). This matches the script behaviour. One minor mismatch: the SKILL.md mentions '每日 heartbeat 时检查并主动提醒' (daily heartbeat / proactive reminders) but there is no install/spec that sets up a scheduler or background service — the script exposes check functions but does not auto-schedule itself. Also the SKILL.md and script operate only on local files and do not reference external endpoints or other system credentials.
Install Mechanism
No install spec is provided (instruction-only with an included script). The script runs via python3 and creates files under the user's home; there are no downloads, package installs, or external installers.
Credentials
The skill requests no environment variables or credentials (proportionate). However, it stores sensitive financial data as plaintext JSON under ~/private_data/openclaw/workspace/data/finance/ (un-encrypted), which is a privacy risk: anyone or any process with access to that filesystem location can read the records. The number of required env/config items is appropriate (none), but users should be aware of local-data persistence and access permissions.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges or modify other skills. It creates its own data files under the user's home directory, which is expected behavior for a personal tracker.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install wlrllr-finance-tracker
  3. After installation, invoke the skill by name or use /wlrllr-finance-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the finance-tracker skill for personal and shop income/expense management. - Record personal daily expenses with support for multiple categories. - Set and monitor monthly spending budgets with overspending alerts. - View monthly, yearly, and categorized expense reports, as well as spending trends. - Record shop inventory purchases and sales; track product stock. - Calculate gross and net profit for shop operations, including FIFO cost calculation. - Generate detailed monthly and annual financial reports for both personal and shop accounts.
Metadata
Slug wlrllr-finance-tracker
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 收支管理?

个人与店铺收支管理系统。用于记录日常生活开支和店铺经营数据。 触发场景: (1) 记录日常消费(吃饭、购物、交通、房租等) (2) 设置每月开支预算并监控超支 (3) 查看月度/年度开支报表 (4) 记录店铺商品进货和销售 (5) 计算商品毛利和店铺纯利润 (6) 生成店铺经营报表 (7) 询问"这个月花了多少钱... It is an AI Agent Skill for Claude Code / OpenClaw, with 128 downloads so far.

How do I install 收支管理?

Run "/install wlrllr-finance-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 收支管理 free?

Yes, 收支管理 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 收支管理 support?

收支管理 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 收支管理?

It is built and maintained by wlrllr (@wlrllr); the current version is v1.0.0.

💬 Comments