verify-invoice-default/TUTORIAL.md

本技能有以下使用方式：

• CLI 命令：通过命令行执行发票提取、票据预审等操作
• 对话任务：用自然语言让 Agent 完成票据合规预审

本技能做什么

票据合规预审助手，帮助财务人员快速完成差旅报销发票的合规性预审：

1. RPA 发票提取：自动登录智慧校园系统，从票据合规预审页面提取发票数据
2. 四步审核：发票字段完整性、税号白名单、日期逻辑、经费标准
3. 初审意见单：生成 HTML 格式的审核报告

开始前

• 已安装 Python 3.10+、Playwright
• 已安装 jiangchang-platform-kit（或设置 PYTHONPATH 指向其 src/）
• 已安装 Edge 或 Chrome 浏览器

入口一：CLI 命令

提取发票数据

$env:PYTHONPATH="D:\jiangchang\huashang\jiangchang-platform-kit\jiangchang-platform-kit\src"
cd D:\jiangchang\huashang\verify-invoice-default\verify-invoice-default

python scripts\main.py extract-invoices --profile-dir "$env:TEMP\verify-invoice-edge-profile"

参数说明：

参数	说明
--username	sandbox 门户手机号
--password	sandbox 门户密码
--profile-dir	浏览器 Profile 目录（保存登录态，多次复用）
--headless	可选，无头模式（生产不建议）
--detail-mode	可选，提取详细信息

测试连接

python scripts\main.py test-rpa-connection --profile-dir "$env:TEMP\verify-invoice-edge-profile"

票据合规预审

python scripts\main.py prereview --invoice-json invoices.json

重建初审意见单

python scripts\main.py render-html

入口二：对话任务

直接告诉 Agent：

帮我从智慧校园提取发票数据

对这些发票做票据合规预审

Agent 会调用本技能的 CLI 命令完成操作并返回结果。

主能力对照表

能力	CLI 命令	对话触发
RPA 发票提取	extract-invoices	"提取发票数据"
票据合规预审	prereview	"做票据预审"
重建意见单	render-html	"重建意见单"
查看预审历史	list-reports	"查看预审记录"

常见卡住怎么办

问题	解决方法
浏览器没弹出	检查 OPENCLAW_BROWSER_HEADLESS=0，确认 Edge/Chrome 已安装
登录超时	检查网络，确认 sandbox.jc2009.com 可访问
智慧校园进不去	删除 Profile 目录重新运行，让它重新登录
提取不到发票	检查 Profile 目录下是否有登录态，运行 test-rpa-connection 测试