柠檬云发票助手

解决什么问题

发票处理的工作流通常断裂在几个环节：进销项发票要从税局端导出，附件散落在邮件和共享盘里，清单靠手工整理，统计口径各人各写，风险分析更是凭感觉。等到月结，会计手里只剩一堆 PDF、Excel 和截图，很难确认某张票的抵扣状态、红冲记录或供应商集中度是否存在异常。

本技能把「取票 → 附件 → 抵扣数据 → 清单 → 统计 → 风险报告」串成一条可恢复的任务链。Agent 负责把自然语言需求翻译成结构化任务参数，本地 CLI 负责执行和落盘，任何一步超时或中断都能用原 --task-file 续查，不必从头再来。

技能如何工作

核心是一个 invoice-assistant 命令行工具，按阶段推进：

• 预检与任务创建：业务命令前先执行 task-preflight-check 校验 API Key 与能力绑定；init-task 按税号精确匹配企业，把服务端返回的地区、登录类型固化到任务上下文
• 取票与附件：fetch-invoices 拉取整批发票数据，fetch-attachments 下载原件，fetch-deduction 统一处理勾选认证数据——一般纳税人拉进项，小规模纳税人记录 skipped
• 清单与统计：取票后强制生成发票清单，analyze-invoice-data 输出 发票统计分析.xlsx
• 风险分析：build-invoice-context-data 生成可追溯的风险上下文，再产出面向财务负责人的中文报告并转 PDF，正文、Excel 与 PDF 的本地绝对路径全部回显

工程细节上：Windows 下必须做 PowerShell UTF-8 初始化，中文 JSON 入参走 --input 文件而非 stdin；版本过低直接阻断执行并按报错链接自动更新；异步任务未进入终态前禁止重建任务，只有用户明确要求才追加 --confirm-duplicate。

适用边界与注意点

风险分析只输出疑点、边界与复核建议，不做违法定性，也不单凭进项大于销项判定高风险。脚本内部的英文字段、枚举值和布尔状态必须翻译成通俗中文；源发票中的法定名称、商品型号可保留原文，但首次出现要跟中文说明。

API Key、token、签名 URL、税局密码等敏感材料不进入任何用户可见输出。预检返回「无权调用该能力」时流程立即停止，这是权限问题，不是登录失败。无法判定是新任务还是继续任务时，一律按新任务处理，不复用历史 Excel、附件目录或报告。