小河狸发票助手

问题

小河狸发票助手用于让 Agent 读取本机桌面应用里的发票数据，适合回答“哪些客户开票下降明显”“某供应商取得发票有多少”这类本地财务查询。它不依赖云端上传，数据只通过本机 API 访问，技能本身不负责把文件内容外发。

工作方式

技能优先调用 scripts/invoice_assistant_client.py 连接应用。用户可以传 --base-url http://127.0.0.1:<port>；未指定时会在 http://127.0.0.1:8876 到 http://127.0.0.1:8895 扫描 /api/metadata。常用只读能力包括：

• companies：查看可选公司。
• summary：查看金额和趋势。
• rankings：查看客户、供应商、商品排行。
• invoices：按关键词、日期、方向、分页查发票明细。
• items：分析商品或服务。
• attachments：列出 PDF、OFD、XML 附件元数据；仅在用户明确要求时打开本地文件。

接口支持 company_id、start/end、direction、keyword、page/page_size、limit 等过滤。summary 和 rankings 会排除状态含“作废”的发票，明细接口保留全部状态，便于检查异常单据。

边界

应用必须与 Agent 在同一台电脑运行。附件响应只返回文件类型、文件名、发票号、大小等元数据，不暴露绝对路径；打开附件只是调用本机默认程序。回答财务问题时，应说明公司、日期范围和是否排除作废发票，税务差异只能视为开票台账计算，不是最终应纳税额或申报结果。