chore: auto release commit (2026-09-14 22:22:49)
All checks were successful
技能自动化发布 / release (push) Successful in 7s
All checks were successful
技能自动化发布 / release (push) Successful in 7s
This commit is contained in:
chenfuqiang
120
TUTORIAL.md
120
TUTORIAL.md
@@ -1,91 +1,85 @@
|
||||
数据管理与对话任务是本技能两种**平行**的用法：想在表上对着数据操作、维护标准库，走数据管理；想把发票信息直接发给助手要结论，走对话。本技能不提供定时任务（预审对象逐次由人指定，没有可以无人值守批量跑的队列）。
|
||||
本技能有以下使用方式：
|
||||
|
||||
- **CLI 命令**：通过命令行执行发票提取、票据预审等操作
|
||||
- **对话任务**：用自然语言让 Agent 完成票据合规预审
|
||||
|
||||
## 本技能做什么
|
||||
|
||||
你把发票的票面信息（可粘贴文字或由助手读照片转写）连同报销事由、出差行程一起交给技能；技能按"字段完整性 → 税号白名单 → 行程日期逻辑 → 住宿/交通标准 → 风控标记"五道关逐张体检，给出 通过 / 待确认 / 驳回 结论和一份《初审意见单》报告，并把历史记录保存下来，供你回填发票真伪查验结果、管理员维护标准库。
|
||||
票据合规预审助手，帮助财务人员快速完成差旅报销发票的合规性预审：
|
||||
|
||||
1. **RPA 发票提取**：自动登录智慧校园系统，从票据合规预审页面提取发票数据
|
||||
2. **四步审核**：发票字段完整性、税号白名单、日期逻辑、经费标准
|
||||
3. **初审意见单**：生成 HTML 格式的审核报告
|
||||
|
||||
## 开始前
|
||||
|
||||
- 准备好发票票面信息：发票号码、开票日期、金额、购买方名称与税号、销售方名称；差旅报销另备出差起止日期、目的地、职级档位
|
||||
- 管理员确认"税号白名单""经费标准库"已按学校现行规定维护（首次安装时内置了示例种子）
|
||||
- 如需回填发票真伪，先到全国增值税发票查验平台（inv-veri.chinatax.gov.cn）完成核验
|
||||
- 已安装 Python 3.10+、Playwright
|
||||
- 已安装 `jiangchang-platform-kit`（或设置 `PYTHONPATH` 指向其 `src/`）
|
||||
- 已安装 Edge 或 Chrome 浏览器
|
||||
|
||||
## 入口一：数据管理
|
||||
## 入口一：CLI 命令
|
||||
|
||||
左侧表列表中能看到本技能的五张表：发票登记、初审意见、经费标准库、税号白名单、节假日。
|
||||
### 提取发票数据
|
||||
|
||||
### 预审一张或多张发票
|
||||
```powershell
|
||||
$env:PYTHONPATH="D:\jiangchang\huashang\jiangchang-platform-kit\jiangchang-platform-kit\src"
|
||||
cd D:\jiangchang\huashang\verify-invoice-default\verify-invoice-default
|
||||
|
||||
1. 点左侧"发票登记"表，再点表顶栏的「票据合规预审」按钮
|
||||
2. 在表单里粘贴发票字段信息（支持一张的对象写法，也支持多张合并成一批），按需填写报销事由、预算项目编号、出差起止、目的地城市、职级
|
||||
3. 提交后稍等片刻，页面提示"预审完成 N 张：通过 x，待确认 y，驳回 z"；表格自动刷新出现本次记录
|
||||
4. 切到"初审意见"表查看每张发票的结论摘要
|
||||
python scripts\main.py extract-invoices --username 15527406659 --password qwer1234 --profile-dir "$env:TEMP\verify-invoice-edge-profile"
|
||||
```
|
||||
|
||||
### 查看《初审意见单》报告
|
||||
参数说明：
|
||||
|
||||
1. 在"初审意见"表点表顶栏的「生成初审意见单」按钮（不选行时重建最近 10 份）
|
||||
2. 左侧 HTML 报告区出现 `report-编号` 条目，点开即可预览三色清单与规则引用
|
||||
| 参数 | 说明 |
|
||||
|---|---|
|
||||
| `--username` | sandbox 门户手机号 |
|
||||
| `--password` | sandbox 门户密码 |
|
||||
| `--profile-dir` | 浏览器 Profile 目录（保存登录态，多次复用） |
|
||||
| `--headless` | 可选，无头模式（生产不建议） |
|
||||
| `--detail-mode` | 可选，提取详细信息 |
|
||||
|
||||
### 回填发票真伪查验结果
|
||||
### 测试连接
|
||||
|
||||
1. 在"初审意见"表找到目标行（预审结论为"待确认"的行通常卡在这一步）
|
||||
2. 点该行操作列的「回填查验结果」
|
||||
3. 在表单里选择查验结果：通过 / 不符，填写备注后提交
|
||||
4. 回填"不符"后，该行结论自动升级为"驳回"
|
||||
```powershell
|
||||
python scripts\main.py test-rpa-connection --username 15527406659 --password qwer1234 --profile-dir "$env:TEMP\verify-invoice-edge-profile"
|
||||
```
|
||||
|
||||
### 维护税号白名单与经费标准
|
||||
### 票据合规预审
|
||||
|
||||
1. 打开"税号白名单"表：点顶栏「新增税号白名单」录入税号与单位名称；发现错误条目点行内「删除税号」
|
||||
2. 打开"经费标准库"表：双击或用行内「更新经费标准」修改标准值；请同步核对"依据文件""条款"两列，保持可追溯
|
||||
```powershell
|
||||
python scripts\main.py prereview --invoice-json invoices.json
|
||||
```
|
||||
|
||||
### 重建初审意见单
|
||||
|
||||
```powershell
|
||||
python scripts\main.py render-html
|
||||
```
|
||||
|
||||
## 入口二：对话任务
|
||||
|
||||
新建任务，选择本技能后，直接把要办的事说清楚。
|
||||
直接告诉 Agent：
|
||||
|
||||
### 预审发票（最常用）
|
||||
> 帮我从智慧校园提取发票数据
|
||||
|
||||
把发票信息连同报销上下文一起发给助手，例如：
|
||||
> 对这些发票做票据合规预审
|
||||
|
||||
> 帮我预审一张住宿费发票：号码 24312000000012345678，开票日期 2026-08-18，金额 1650 元，购买方广州华商学院（税号 91440101MA9XXYYY0A），销售方广州某某酒店；我 8 月 17 到 20 日出差广州，职级副高及以上，项目编号 KYGX2026001
|
||||
|
||||
助手会复述解读三色清单：驳回项会读出违反的标准条款，待确认项会告诉你下一步该做什么（如去查验平台核验真伪）。
|
||||
|
||||
你也可以直接发发票照片，让助手转写字段后再确认预审。
|
||||
|
||||
### 查历史、查标准、查统计
|
||||
|
||||
- "查一下我最近预审过的发票"→ 助手返回历史结论列表；"只看被驳回的"也可以
|
||||
- "出差的住宿费标准是多少"→ 返回对应城市等级与职级的上限
|
||||
- "预审统计一下"→ 返回总量、通过率、驳回率与集中开票商家
|
||||
|
||||
### 回填查验结果
|
||||
|
||||
> 我刚在查验平台查了报告 12 那张发票，结果是通过的
|
||||
|
||||
助手会把该记录的真伪状态改为"已查验通过"；若你说"不符"，结论会升级为驳回。
|
||||
|
||||
## 入口三：定时任务
|
||||
|
||||
本技能不需要定时：预审的对象是逐次提交的具体发票，由人发起即可，没有适合无人值守周期执行的任务。
|
||||
Agent 会调用本技能的 CLI 命令完成操作并返回结果。
|
||||
|
||||
## 主能力对照表
|
||||
|
||||
| 能力 | 数据管理 | 对话任务 |
|
||||
|------|----------|----------|
|
||||
| 预审发票（单张/一批） | 「票据合规预审」按钮（表单） | 直接说事由+票面信息 |
|
||||
| 批量预审 input 目录 | 不支持 | 支持（进任务中心，有进度） |
|
||||
| 查看《初审意见单》 | 「生成初审意见单」按钮 + 侧栏预览 | 让助手重建后去侧栏打开 |
|
||||
| 回填真伪查验结果 | 行级「回填查验结果」 | 对话说明报告编号与结果 |
|
||||
| 查询历史 / 统计 | 查看初审意见表 | 对话查询 |
|
||||
| 查看经费标准 | 经费标准库表 | 对话查询 |
|
||||
| 维护标准 / 白名单 | 表上直接改 / 顶栏行级按钮 | 也可以让助手改 |
|
||||
| 定时预审 | 不提供 | 不提供 |
|
||||
| 能力 | CLI 命令 | 对话触发 |
|
||||
|---|---|---|
|
||||
| RPA 发票提取 | `extract-invoices` | "提取发票数据" |
|
||||
| 票据合规预审 | `prereview` | "做票据预审" |
|
||||
| 重建意见单 | `render-html` | "重建意见单" |
|
||||
| 查看预审历史 | `list-reports` | "查看预审记录" |
|
||||
|
||||
## 常见卡住怎么办
|
||||
|
||||
- **预审按钮点了没反应**：发票字段信息没填或格式不对。至少要有发票号码、开票日期、金额；多张时写成一个数组
|
||||
- **提示"购买方税号不在白名单"但我校确实能报**：白名单还没维护该税号。找管理员在"税号白名单"表新增后重新预审
|
||||
- **住宿费被判超标但标准不对**：标准库的数值可能还是示例种子。请管理员按学校现行文件修改"经费标准库"后再试
|
||||
- **结论一直是"待确认"**：多半卡在发票真伪未查验。到查验平台核验后回填结果即可
|
||||
- **看不到《初审意见单》报告**：先在"初审意见"表点一次「生成初审意见单」，再到左侧 HTML 报告区打开
|
||||
- **发票照片识别不准**：照片模糊、折叠会导致字段缺失。重新拍摄平整、光线均匀的票面，或缺的字段手动补上再预审
|
||||
| 问题 | 解决方法 |
|
||||
|---|---|
|
||||
| 浏览器没弹出 | 检查 `OPENCLAW_BROWSER_HEADLESS=0`，确认 Edge/Chrome 已安装 |
|
||||
| 登录超时 | 检查网络，确认 sandbox.jc2009.com 可访问 |
|
||||
| 智慧校园进不去 | 删除 Profile 目录重新运行，让它重新登录 |
|
||||
| 提取不到发票 | 检查 Profile 目录下是否有登录态，运行 `test-rpa-connection` 测试 |
|
||||
|
||||
Reference in New Issue
Block a user