Agent Skills
返回列表
商家记账助手

商家记账助手

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-3kcbucdb/receipt-bookkeeper-v2。

技能介绍

要解决什么问题

个体户和小微企业日常记账,往往卡在「拍一张票 → 手工敲金额、日期、付款方式、科目」这一步。票是横着拍的、金额是大写汉字、渠道混在微信/支付宝/现金里,还要区分专票普票和税前扣除——Agent 若只做通用 OCR,很难输出能直接进账本、报税汇总的那一套固定字段。

技能如何工作

本技能围绕 /api/skill/receipt 与 /api/skill/ledger 两条只读/写入链路:上传票据图片(base64 或 multipart 的 image),或多方向 OCR 后输出统一 JSON(date、amount、channel、type、category、invoice、invoiceNo 等);无图时可用 text 自然语言或结构化 entry 口述记账。

  • tenant_id:同一客户的多笔识别与查账共用一本账;识别到有效金额(>0)且传入合法 tenant_id 时 saved:true 自动落账。
  • 记账后查账:成功记账后应紧接着调 ledger,把 summary(收入/支出/余额、按渠道与分类汇总)和最近明细读给用户确认,避免只回「已记录」。
  • 导出:ledger 响应含 csv 文本,表头覆盖日期、类型、金额、渠道、分类、备注、发票号等,便于转发给客户或接入报表。

渠道识别覆盖微信、支付宝、对公/个人银行卡、现金;金额支持阿拉伯数字与中文大写;按商户关键词归入物料采购、房租、工资等约 12 类科目。

适用边界与注意点

  • 网页端查账已停用,查账/导出均通过 Skill 的 ledger 端点完成。
  • 未传 tenant_id 或金额无效时仅返回识别结果(saved:false),不落账。
  • 未识别字段返回空串,不臆造;生产环境需配置 Authorization: Bearer。
  • 本技能为 SkillHub 按次付费(约 ¥0.2/次),走 X402 与 WeixinPay-Paid 凭证;计费以平台定价为准。

使用场景

  • 顾客用手机拍横屏超市小票,Agent 识别实付金额并写入该顾客的 tenant_id 账本
  • 收到增值税专票照片,要提取发票号与专票类型以便票账匹配和成本汇总
  • 老板口述「8 月 12 号支付宝收到货款 2000」,无图片也要记一笔收入并立刻读出账本确认
  • 月末按同一 tenant_id 调 ledger,用自然语言汇总本月收支并按渠道、分类说明后附带 CSV

适合人员

  • 个体户店主:每天多张微信/支付宝小票,希望拍完即落账且对话里能当场核对账本
  • 小微企业财务:要把专票、普票与支出分类对齐,减少手工录单和科目填错
  • 在 SkillHub 上接技能的集成开发者:需要稳定 JSON 字段对接自家报表或报税流程
  • 代账或客服型 Agent:每位终端用户固定 tenant_id,多笔识别与查账串联同一本账