设计与多媒体

小河狸发票助手

试用

读取并分析本机“小河狸发票助手”软件中的数据。当用户要求连接小河狸发票助手、查询发票台账或明细、选择公司、统计进销项、分析客户/供应商/商品排行、查看月度开票趋势、汇总税额,或查询已归档电子发票附件时使用。通过应用的 localhost Skill API 在本机处理数据。 当前版本主要用于只读提取数据,不支持通过智能体导入、修改或删除发票数据。`open-attachment` 只会在本机调用系统默认程序打开已归档的 PDF/OFD/XML 文件,不会把文件内容上传到智能体或云端。

它能做什么

读取并分析本机小河狸发票助手中的数据。当用户要求连接小河狸发票助手、查询发票台账或明细、选择公司、统计进销项、分析客户/供应商/商品排行、查看月度开票趋势、汇总税额,或查询已归档电子发票附件时使用。通过应用的 localhost Skill API 在本机处理数据。

技能文档

小河狸发票助手 Skill

许可证:MIT

通过用户本机运行的“小河狸发票助手”桌面应用读取发票数据。确保应用与智能体运行在同一台电脑上。仅调用本机 API,不通过本 Skill 上传发票数据。

默认使用简体中文回答。金额默认按人民币格式显示并保留两位小数;使用“开具”“取得”“进项”“销项”“价税合计”“作废”等中国财税常用术语。除非用户明确要求,否则不要把台账计算结果表述为最终应纳税额或纳税申报结论。

连接应用

  1. 优先使用 scripts/invoice_assistant_client.py
  2. 用户提供地址时,传入 --base-url http://127.0.0.1:
  3. 用户未提供地址时,扫描 http://127.0.0.1:8876http://127.0.0.1:8895,并通过 /api/metadata 自动发现应用。
  4. 自动发现失败时,请用户先打开“小河狸发票助手”,然后重试。

可选环境变量:

  • INVOICE_ASSISTANT_BASE_URL:指定应用地址,例如 http://127.0.0.1:8876
  • INVOICE_ASSISTANT_PORTS:指定逗号分隔的端口或端口范围,例如 8876-8895,9000

常用查询

在 Skill 目录中运行:

python scripts/invoice_assistant_client.py info
python scripts/invoice_assistant_client.py companies
python scripts/invoice_assistant_client.py summary --company-id 1 --start 2026-01-01 --end 2026-06-30
python scripts/invoice_assistant_client.py invoices --company-id 1 --keyword 作废 --page-size 100
python scripts/invoice_assistant_client.py items --company-id 1 --keyword 咨询服务
python scripts/invoice_assistant_client.py attachments --company-id 1
python scripts/invoice_assistant_client.py open-attachment --attachment-id 123
python scripts/invoice_assistant_client.py rankings --company-id 1 --limit 10

处理自然语言分析请求时,先获取满足问题所需的最小数据集:

  • 选择公司:运行 companies
  • 汇总金额和月度趋势:运行 summary
  • 分析客户、供应商和商品排行:运行 rankings
  • 核查具体发票:运行 invoices,按需设置 keywordstartenddirection 和分页参数。
  • 分析商品或服务明细:运行 items
  • 查询已归档电子发票:运行 attachments,读取匹配的 PDF/OFD/XML 元数据。仅在用户明确要求打开本机文件时运行 open-attachment

API 规则

使用以下本机 Skill API:

  • /api/skill/health
  • /api/skill/info
  • /api/skill/companies
  • /api/skill/summary
  • /api/skill/invoices
  • /api/skill/items
  • /api/skill/attachments
  • /api/skill/attachments//open
  • /api/skill/rankings

各接口支持的筛选参数不同:

  • company_id:可重复传入。
  • startend:使用 yyyy-mm-dd 格式。
  • direction:使用 开具取得
  • keyword:对发票和明细执行模糊搜索。
  • pagepage_size:控制明细分页。
  • limit:控制排行数量。
  • invoice_id:按发票主表 ID 筛选附件。
  • file_type:使用 PDFOFDXML

summaryrankings 接口排除状态中包含“作废”的发票;明细接口保留所有状态,以便核查作废或异常发票。

附件响应包含文件类型、文件名、发票号码、公司、导出时间、文件大小、文件是否存在以及 open_api 路径,不暴露本机绝对路径。打开附件只调用用户本机的默认应用,不上传文件内容。

需要完整字段说明时,读取 references/api.md

分析要求

回答财务问题时,明确说明所选公司、日期范围以及是否排除作废发票。

分析“哪些客户开票下降明显”等问题时,先读取汇总或排行数据;需要精确计算降幅时,再按月读取发票明细并比较相邻期间。区分发票台账测算与正式纳税申报结果。

相关技能

读取并分析本机“小河狸财报助手”中已导入的财务数据。用户询问公司财务指标、资产负债表、利润表、现金流量表、历年或跨期趋势、财务数据对比、回款金额、本地财务问答时使用;仅通过 localhost 的只读接口访问数据。 使用前提: 确认小河狸财报助手正在同一台电脑上运行,版本不低于 `1.7.4`。 安全与错误处理: 只访问 `127.0.0.1` 或 `localhost`,不访问局域网 IP、公网地址或分享链接。 只调用 `/api/local-agent/*`,不执行导入、删除、修改公司、修改配置或创建分享链接。

1 次安装

本地离线OCR识别图片/PDF发票,自动分类专票/普票/电子普票,生成月度报销台账,断网可用,财务数据不向外传输。采用「本地OCR取字为主 + 本地多模态大模型(VLM)辅助字段定位」的混合路线,兼顾数字准确率与版式适应性。

3 次安装1 星标

整理一批发票/票据 PDF(增值税普通发票、铁路电子客票、住宿交通餐饮等),按购买方抬头归档到对应项目并出具报销清单。本技能应在用户需要整理发票报销、把发票归档到项目、或出具报销/消费清单时使用。不要用于:合同/法律文书合规审查、证据实体分析、PDF 合并压缩加页码(用 pdf-processor)、扫描件 OCR 转写(用 legal-ocr)。

面向上市公司的发票识别与自动入账技能包,通过 OCR 拍照/截图提取发票数据, 自动分类并匹配入账。支持增值税专用发票、普通发票、全电发票、机动车发票、 通行费、火车票机票等全类型发票,实现发票验真、自动分类、三单匹配和台账管理。

1 次安装

支持文字 / 语音单张开票、ERP订单批量开票、非结构化资料开票三大场景,提供开票全流程标准化服务。 本 Skill 面向财务批量发票处理场景,自动多格式发票识别、真伪核验、查重风控,一键输出标准化发票台账,一站式解决人工逐票核对、重复报销管控难题。 发票开具与开票权限处理。当用户提出以下需求时触发:发票开具、数电票开具、数电票开票、蓝字发票开具、单张开票、批量开票、开票二维码获取、开票二维码状态查询、开票授权、开票权限校验、开票权限延长、扫码授权开票

AI发票报销助手。上传发票图片自动识别关键信息,智能分类费用类型,查重预警防重复报销,生成可视化HTML报销报告。支持录入/查询/删除/导出全流程。触发词:发票报销、发票识别、整理报销、报销单、发票录入、invoice reimbursement、帮我看看发票、录入发票、报销报告、查发票。

3 次安装