{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zhichu-tracker",
    "name": "智出 - 智能收支追踪器",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/dyby99-gif/zhichu-tracker",
    "canonicalUrl": "https://clawhub.ai/dyby99-gif/zhichu-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/zhichu-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zhichu-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "assets/categories.json",
      "scripts/expense-tracker.py",
      "scripts/report-generator.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zhichu-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/zhichu-tracker",
    "agentPageUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Smart Expense Tracker - 智能收支追踪器",
        "body": "通过自然语言快速记账，自动生成财务报告的智能工具。"
      },
      {
        "title": "功能特性",
        "body": "📝 自然语言记账: \"今天午饭花了35元\"、\"收到工资8000\"\n🏷️ 智能自动分类: 自动识别餐饮、交通、购物等分类\n📊 多维度报告: 日报、周报、月报、趋势分析\n🔒 本地数据存储: JSON文件存储，保护隐私\n🌐 中英文支持: 支持中英文自然语言输入\n⚠️ 消费异常检测: 自动识别异常消费模式"
      },
      {
        "title": "添加收支记录",
        "body": "# 记录支出\npython scripts/expense-tracker.py add \"今天午饭花了35元\"\npython scripts/expense-tracker.py add \"昨天打车去公司28块\"\npython scripts/expense-tracker.py add \"买衣服花了299元\"\n\n# 记录收入\npython scripts/expense-tracker.py add \"今天发工资8000元\"\npython scripts/expense-tracker.py add \"收到红包200\""
      },
      {
        "title": "查看记录",
        "body": "# 列出最近7天记录\npython scripts/expense-tracker.py list\n\n# 列出最近30天记录\npython scripts/expense-tracker.py list 30\n\n# 只显示支出\npython scripts/expense-tracker.py list 7 expense"
      },
      {
        "title": "生成报告",
        "body": "# 日报\npython scripts/report-generator.py daily\npython scripts/report-generator.py daily 2024-01-15\n\n# 周报\npython scripts/report-generator.py weekly\npython scripts/report-generator.py weekly 1  # 上周\n\n# 月报\npython scripts/report-generator.py monthly\npython scripts/report-generator.py monthly 1  # 上月\n\n# 趋势分析\npython scripts/report-generator.py trend 30"
      },
      {
        "title": "查看统计",
        "body": "# 最近30天收支摘要\npython scripts/expense-tracker.py summary\n\n# 最近90天摘要\npython scripts/expense-tracker.py summary 90\n\n# 查看分类列表\npython scripts/expense-tracker.py categories"
      },
      {
        "title": "项目结构",
        "body": "smart-expense-tracker/\n├── SKILL.md                      # 本文件\n├── scripts/\n│   ├── expense-tracker.py       # 核心记账逻辑\n│   └── report-generator.py      # 报告生成器\n└── assets/\n    └── categories.json          # 分类配置"
      },
      {
        "title": "数据存储",
        "body": "路径: ~/.openclaw/workspace/data/expenses/expenses.json\n格式: JSON\n隐私: 纯本地存储，不上传云端\n\n数据结构:\n\n{\n  \"expenses\": [\n    {\n      \"id\": \"a1b2c3d4\",\n      \"date\": \"2024-01-15\",\n      \"type\": \"expense\",\n      \"amount\": 35.00,\n      \"category\": \"餐饮\",\n      \"note\": \"午饭\",\n      \"raw_text\": \"今天午饭花了35元\",\n      \"created_at\": \"2024-01-15T12:30:00\"\n    }\n  ],\n  \"categories\": {\n    \"income\": [\"工资\", \"奖金\", \"投资\", ...],\n    \"expense\": [\"餐饮\", \"交通\", \"购物\", ...]\n  }\n}"
      },
      {
        "title": "时间表达",
        "body": "\"今天...\" - 今天\n\"昨天...\" - 昨天\n\"前天...\" - 前天\n\"2024-01-15...\" - 指定日期"
      },
      {
        "title": "金额表达",
        "body": "\"花了35元\"\n\"花了35块\"\n\"35元\"\n\"收入5000\""
      },
      {
        "title": "自动分类关键词",
        "body": "分类触发关键词餐饮吃饭、午饭、晚饭、外卖、奶茶、咖啡、火锅交通地铁、公交、打车、滴滴、加油、停车、高铁购物购物、买衣服、鞋子、包包、化妆品、淘宝、京东娱乐电影、游戏、充值、会员、旅游、KTV居住房租、房贷、水电、物业费、装修工资工资、薪水、发工资奖金奖金、年终奖、分红"
      },
      {
        "title": "分类配置",
        "body": "分类配置存储在 assets/categories.json，包含:\n\n收入分类: 工资、奖金、投资、兼职、红包、退款、其他收入\n支出分类: 餐饮、交通、购物、娱乐、居住、医疗、教育、通讯、人情、其他支出\n预算预警: 每个分类可设置预算阈值\n关键词映射: 自定义分类识别关键词"
      },
      {
        "title": "自定义分类",
        "body": "编辑 assets/categories.json 添加自定义分类和关键词。"
      },
      {
        "title": "日报",
        "body": "当日收支总览\n分类明细\n交易记录列表"
      },
      {
        "title": "周报",
        "body": "本周收支总览\n日均支出\n每日明细\nTOP支出分类"
      },
      {
        "title": "月报",
        "body": "月度收支总览\n预算执行情况\n周度趋势\n分类统计\n日均支出"
      },
      {
        "title": "趋势分析",
        "body": "消费趋势（上升/下降/稳定）\n异常消费检测（超过均值2倍）\n环比变化分析\n消费建议"
      },
      {
        "title": "删除记录",
        "body": "# 删除指定ID的记录\npython scripts/expense-tracker.py delete a1b2c3d4"
      },
      {
        "title": "JSON格式输出",
        "body": "# 报告输出JSON格式（便于程序处理）\npython scripts/report-generator.py monthly 0 json"
      },
      {
        "title": "批量导入",
        "body": "可通过直接编辑 expenses.json 文件实现批量导入。"
      },
      {
        "title": "使用建议",
        "body": "每日记账: 养成每天记录的习惯，可以在每天晚上花2分钟回顾当天支出\n及时分类: 如果自动分类不准确，可以在备注中添加更具体的关键词\n定期复盘: 每周查看周报，每月查看月报，了解自己的消费模式\n设置预算: 在 categories.json 中为各分类设置预算预警值"
      },
      {
        "title": "无法识别金额",
        "body": "确保金额格式正确，如 \"35元\"、\"35块\"\n尝试明确表达：\"花了35元\""
      },
      {
        "title": "分类不准确",
        "body": "在描述中添加更多关键词，如 \"淘宝买衣服\" 会比 \"买衣服\" 更准确\n可在 categories.json 中添加自定义关键词"
      },
      {
        "title": "数据文件损坏",
        "body": "数据文件是纯JSON，可用文本编辑器修复\n建议定期备份 ~/.openclaw/workspace/data/expenses/expenses.json"
      },
      {
        "title": "添加新的自动分类规则",
        "body": "编辑 scripts/expense-tracker.py 中的 KEYWORD_MAPPING 字典:\n\nKEYWORD_MAPPING = {\n    # 现有规则...\n    \"新关键词\": \"目标分类\",\n    \" another keyword\": \"Category Name\"\n}"
      },
      {
        "title": "集成其他工具",
        "body": "expense-tracker.py 可作为模块导入:\n\nfrom scripts.expense_tracker import ExpenseTracker\n\ntracker = ExpenseTracker()\nrecord = tracker.add(\"今天买书花了50元\")\nprint(record)"
      },
      {
        "title": "技术规格",
        "body": "Python版本: 3.9+\n依赖: 无外部依赖，仅使用标准库\n编码: UTF-8\n数据格式: JSON"
      },
      {
        "title": "许可证",
        "body": "MIT License"
      }
    ],
    "body": "Smart Expense Tracker - 智能收支追踪器\n\n通过自然语言快速记账，自动生成财务报告的智能工具。\n\n功能特性\n📝 自然语言记账: \"今天午饭花了35元\"、\"收到工资8000\"\n🏷️ 智能自动分类: 自动识别餐饮、交通、购物等分类\n📊 多维度报告: 日报、周报、月报、趋势分析\n🔒 本地数据存储: JSON文件存储，保护隐私\n🌐 中英文支持: 支持中英文自然语言输入\n⚠️ 消费异常检测: 自动识别异常消费模式\n快速开始\n添加收支记录\n# 记录支出\npython scripts/expense-tracker.py add \"今天午饭花了35元\"\npython scripts/expense-tracker.py add \"昨天打车去公司28块\"\npython scripts/expense-tracker.py add \"买衣服花了299元\"\n\n# 记录收入\npython scripts/expense-tracker.py add \"今天发工资8000元\"\npython scripts/expense-tracker.py add \"收到红包200\"\n\n查看记录\n# 列出最近7天记录\npython scripts/expense-tracker.py list\n\n# 列出最近30天记录\npython scripts/expense-tracker.py list 30\n\n# 只显示支出\npython scripts/expense-tracker.py list 7 expense\n\n生成报告\n# 日报\npython scripts/report-generator.py daily\npython scripts/report-generator.py daily 2024-01-15\n\n# 周报\npython scripts/report-generator.py weekly\npython scripts/report-generator.py weekly 1  # 上周\n\n# 月报\npython scripts/report-generator.py monthly\npython scripts/report-generator.py monthly 1  # 上月\n\n# 趋势分析\npython scripts/report-generator.py trend 30\n\n查看统计\n# 最近30天收支摘要\npython scripts/expense-tracker.py summary\n\n# 最近90天摘要\npython scripts/expense-tracker.py summary 90\n\n# 查看分类列表\npython scripts/expense-tracker.py categories\n\n项目结构\nsmart-expense-tracker/\n├── SKILL.md                      # 本文件\n├── scripts/\n│   ├── expense-tracker.py       # 核心记账逻辑\n│   └── report-generator.py      # 报告生成器\n└── assets/\n    └── categories.json          # 分类配置\n\n数据存储\n路径: ~/.openclaw/workspace/data/expenses/expenses.json\n格式: JSON\n隐私: 纯本地存储，不上传云端\n\n数据结构:\n\n{\n  \"expenses\": [\n    {\n      \"id\": \"a1b2c3d4\",\n      \"date\": \"2024-01-15\",\n      \"type\": \"expense\",\n      \"amount\": 35.00,\n      \"category\": \"餐饮\",\n      \"note\": \"午饭\",\n      \"raw_text\": \"今天午饭花了35元\",\n      \"created_at\": \"2024-01-15T12:30:00\"\n    }\n  ],\n  \"categories\": {\n    \"income\": [\"工资\", \"奖金\", \"投资\", ...],\n    \"expense\": [\"餐饮\", \"交通\", \"购物\", ...]\n  }\n}\n\n自然语言支持示例\n时间表达\n\"今天...\" - 今天\n\"昨天...\" - 昨天\n\"前天...\" - 前天\n\"2024-01-15...\" - 指定日期\n金额表达\n\"花了35元\"\n\"花了35块\"\n\"35元\"\n\"收入5000\"\n自动分类关键词\n分类\t触发关键词\n餐饮\t吃饭、午饭、晚饭、外卖、奶茶、咖啡、火锅\n交通\t地铁、公交、打车、滴滴、加油、停车、高铁\n购物\t购物、买衣服、鞋子、包包、化妆品、淘宝、京东\n娱乐\t电影、游戏、充值、会员、旅游、KTV\n居住\t房租、房贷、水电、物业费、装修\n工资\t工资、薪水、发工资\n奖金\t奖金、年终奖、分红\n分类配置\n\n分类配置存储在 assets/categories.json，包含:\n\n收入分类: 工资、奖金、投资、兼职、红包、退款、其他收入\n支出分类: 餐饮、交通、购物、娱乐、居住、医疗、教育、通讯、人情、其他支出\n预算预警: 每个分类可设置预算阈值\n关键词映射: 自定义分类识别关键词\n自定义分类\n\n编辑 assets/categories.json 添加自定义分类和关键词。\n\n报告类型\n日报\n当日收支总览\n分类明细\n交易记录列表\n周报\n本周收支总览\n日均支出\n每日明细\nTOP支出分类\n月报\n月度收支总览\n预算执行情况\n周度趋势\n分类统计\n日均支出\n趋势分析\n消费趋势（上升/下降/稳定）\n异常消费检测（超过均值2倍）\n环比变化分析\n消费建议\n高级用法\n删除记录\n# 删除指定ID的记录\npython scripts/expense-tracker.py delete a1b2c3d4\n\nJSON格式输出\n# 报告输出JSON格式（便于程序处理）\npython scripts/report-generator.py monthly 0 json\n\n批量导入\n\n可通过直接编辑 expenses.json 文件实现批量导入。\n\n使用建议\n每日记账: 养成每天记录的习惯，可以在每天晚上花2分钟回顾当天支出\n及时分类: 如果自动分类不准确，可以在备注中添加更具体的关键词\n定期复盘: 每周查看周报，每月查看月报，了解自己的消费模式\n设置预算: 在 categories.json 中为各分类设置预算预警值\n故障排除\n无法识别金额\n确保金额格式正确，如 \"35元\"、\"35块\"\n尝试明确表达：\"花了35元\"\n分类不准确\n在描述中添加更多关键词，如 \"淘宝买衣服\" 会比 \"买衣服\" 更准确\n可在 categories.json 中添加自定义关键词\n数据文件损坏\n数据文件是纯JSON，可用文本编辑器修复\n建议定期备份 ~/.openclaw/workspace/data/expenses/expenses.json\n扩展开发\n添加新的自动分类规则\n\n编辑 scripts/expense-tracker.py 中的 KEYWORD_MAPPING 字典:\n\nKEYWORD_MAPPING = {\n    # 现有规则...\n    \"新关键词\": \"目标分类\",\n    \" another keyword\": \"Category Name\"\n}\n\n集成其他工具\n\nexpense-tracker.py 可作为模块导入:\n\nfrom scripts.expense_tracker import ExpenseTracker\n\ntracker = ExpenseTracker()\nrecord = tracker.add(\"今天买书花了50元\")\nprint(record)\n\n技术规格\nPython版本: 3.9+\n依赖: 无外部依赖，仅使用标准库\n编码: UTF-8\n数据格式: JSON\n许可证\n\nMIT License"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dyby99-gif/zhichu-tracker",
    "publisherUrl": "https://clawhub.ai/dyby99-gif/zhichu-tracker",
    "owner": "dyby99-gif",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zhichu-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/zhichu-tracker",
    "agentUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zhichu-tracker/agent.md"
  }
}