weaver-work-cli 0.1.6 → 0.1.8

package/skills/weaver-e10-yepiaotong/references/invoice-issuing.md

@@ -20,7 +20,15 @@
 
 `payload` 是已整理好的 `MakeInvoiceReqDTO`。核心字段至少包括购方名称、发票类型、外部单号、金额合计和一条商品明细。专票或全电纸质专票必须提供购方税号。
 
-CLI 会固定销方名称 `上海泛微网络科技股份有限公司`、销方税号 `9131000070322836XD`，并补齐 `billingType="0"`、`sourceType="4"`、`asyncCallFlag="1"`、`invoiceMethod="5"`、`taxSign="1"`。Agent 不要把 Cookie、ETEAMSID、业务 Token 或认证字段放入 payload。
+### 购方信息补齐
+
+修正后的资料包没有提供客户档案查询 operation。组装 payload 前，Agent 只能从用户输入、附件内容或对话上下文提取购方信息；资料不足时必须追问用户补齐，不要调用 `invoice.customer.*` 或绕过 CLI 查询原始接口。
+
+- 个人普票：`invoiceType="7"`，`personLogo="1"`，无需税号。
+- 企业专票或需要企业抬头时：必须由用户或附件提供购方名称、税号；地址、电话、开户行和账号有明确来源时才填入，没有来源不要编造。
+- 从附件提取购方信息前，必须先提醒用户文件内容可能进入当前大模型上下文，并可能发送到解析服务，等待明确确认后再处理。
+
+销方为 CLI 内置固定值（当前版本固定为销方名称 `上海泛微网络科技股份有限公司`、销方税号 `9131000070322836XD`，非按当前 E10 租户动态解析），Agent 无需也不应自行构造或改写销方字段；CLI 会一并补齐 `billingType="0"`、`sourceType="4"`、`asyncCallFlag="1"`、`invoiceMethod="5"`、`taxSign="1"`。Agent 不要把 Cookie、ETEAMSID、业务 Token 或认证字段放入 payload。
 
 ## 命令
 
@@ -29,13 +37,13 @@ CLI 会固定销方名称 `上海泛微网络科技股份有限公司`、销方
 Windows PowerShell：
 
 ```powershell
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-20260827-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
 ```
 
 macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-20260827-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
+weaver-work-cli --json invoice run invoice.issuing.make.prepare --input-json '{"mode":"ledger","payload":{"invoiceType":"8","externalDocumentNo":"AI-EXAMPLE-001","purchaserName":"XX科技有限公司","purchaserTaxNo":"91310000MA1234AB56","totalAmount":100,"taxAmount":6,"totalAmountWithTax":106,"details":[{"goodsName":"信息技术咨询服务","revenueCode":"3040205","taxRate":0.06,"amount":100,"amountWithTax":106,"taxAmount":6,"quantity":"1","unit":"项"}]}}'
 ```
 
 复杂 payload 建议保存为 UTF-8 JSON 文件。
@@ -48,7 +56,7 @@ Set-Content -Encoding utf8 -LiteralPath .\issuing.json -Value @'
   "mode": "issue",
   "payload": {
     "invoiceType": "8",
-    "externalDocumentNo": "AI-20260827-001",
+    "externalDocumentNo": "AI-EXAMPLE-001",
     "purchaserName": "XX科技有限公司",
     "purchaserTaxNo": "91310000MA1234AB56",
     "totalAmount": 100,
@@ -69,7 +77,7 @@ cat > ./issuing.json <<'JSON'
   "mode": "issue",
   "payload": {
     "invoiceType": "8",
-    "externalDocumentNo": "AI-20260827-001",
+    "externalDocumentNo": "AI-EXAMPLE-001",
     "purchaserName": "XX科技有限公司",
     "purchaserTaxNo": "91310000MA1234AB56",
     "totalAmount": 100,

package/skills/weaver-e10-yepiaotong/references/invoice-reim.md

@@ -25,7 +25,7 @@
 3. 用 `invoice.reim.requests.list` 获取事前申请，再按时间、费用类型和标题做匹配；原始 ID、日期、金额必须逐字符保留。
 4. 用 `invoice.reim.workflow.resolve` 得到报销工作流，必要时按工作流分组。
 5. 对每组并行读取 `invoice.reim.form.structure`、`invoice.reim.row-info` 和 `invoice.reim.employee-superiors`；只有需要用户修正关联字段时才用 `invoice.reim.field.search`。
-6. Agent 按表单结构组装 `payload`，先调用 `invoice.reim.flow.create.prepare`，展示标题、主表字段数、明细行数、发票和风险；用户明确确认后再调用 `.apply`。
+6. Agent 按表单结构组装报销单 JSON，先调用 `invoice.reim.flow.create.prepare`，展示标题、主表字段数、明细行数、发票和风险；用户明确确认后再调用 `.apply`。
 7. 报销单创建成功后，后续修正使用 `invoice.reim.flow.update.prepare/apply`，不要重复创建同一组发票的报销单。
 
 ## 命令
@@ -44,20 +44,18 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.requests.list --input-json '{"pageNo":1,"pageSize":20,"requestname":"交通","cusCreateDateStart":"2026-07-01","cusCreateDateEnd":"2026-07-31"}'
 ```
 
-创建报销单建议用 UTF-8 JSON 文件传入完整 payload。
+创建报销单建议用 UTF-8 JSON 文件传入完整报销单 JSON。
 
 Windows PowerShell：
 
 ```powershell
 Set-Content -Encoding utf8 -LiteralPath .\reim-create.json -Value @'
 {
-  "payload": {
-    "work_flow_id": "1181057526276915214",
-    "mainFormId": "1181057741029226975",
-    "request_name": "交通费报销-示例-2026-08-04",
-    "main_fields": [],
-    "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
-  }
+  "work_flow_id": "1181057526276915214",
+  "mainFormId": "1181057741029226975",
+  "request_name": "交通费报销-示例-2026-08-04",
+  "main_fields": [],
+  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
 }
 '@
 weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input .\reim-create.json
@@ -68,19 +66,17 @@ macOS/Linux（bash/zsh）：
 ```bash
 cat > ./reim-create.json <<'JSON'
 {
-  "payload": {
-    "work_flow_id": "1181057526276915214",
-    "mainFormId": "1181057741029226975",
-    "request_name": "交通费报销-示例-2026-08-04",
-    "main_fields": [],
-    "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
-  }
+  "work_flow_id": "1181057526276915214",
+  "mainFormId": "1181057741029226975",
+  "request_name": "交通费报销-示例-2026-08-04",
+  "main_fields": [],
+  "detail_rows": [{"dataIndex":1,"subFormId":"1181057741029227992","invoiceId":"12345","fields":[]}]
 }
 JSON
 weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
 ```
 
-确认后把 prepare 返回的 continuation 原样放入 apply 输入。
+确认后把 prepare 返回的 continuation 原样放入 apply 输入，并在同一个顶层 JSON 中加入 `"confirm": true`。`invoice.reim.flow.create.*` 的 `inputSchema` 会逐字段暴露 `work_flow_id`、`mainFormId`、`request_name`、`main_fields`、`detail_rows`、`need_user_confirm` 和 `unable_to_fill`，不要再包一层通用 `payload`。
 
 ## 输出处理
 

package/skills/weaver-e10-yepiaotong/references/reim-api-reference.md

@@ -194,7 +194,7 @@ CLI 信封中列表在 `data.items`。下面是单条发票的票面结构（对
           },
           "buyer": {
             "tcode": "9131000070322836XD",
-            "company": "泛微网络科技股份有限公司"
+            "company": "上海泛微网络科技股份有限公司"
           },
           "payer": {
             "tcode": "91460200348073438U",
@@ -1065,11 +1065,11 @@ CLI operation：`invoice.reim.flow.create.prepare` → 用户确认 → `invoice
 
 > **⚠️ 禁止重复创建：同一组发票数据只能创建一次。创建成功后，修改报销单请用 `invoice.reim.flow.update.prepare/apply`，不要再次调用 create。**
 
-将填单结构化 JSON 作为 `payload` 提交到 CLI，生成报销单流程。
+将填单结构化 JSON 作为 operation 顶层入参提交到 CLI，生成报销单流程。不要再包一层通用 `payload`。
 
 ### 入参
 
-入参即 Step 4 组装的完整填单 JSON（结构定义见 [form-fill-rules.md](reim-form-fill-rules.md#最终输出结构)），作为请求体（JSON Body）提交。
+入参即 Step 4 组装的完整填单 JSON（结构定义见 [form-fill-rules.md](reim-form-fill-rules.md#最终输出结构)），字段会在 `inputSchema.properties` 中逐项暴露，并作为请求体（JSON Body）提交到 E10。
 
 
 | 字段                  | 类型     | 必填  | 说明                               |
@@ -1085,7 +1085,7 @@ CLI operation：`invoice.reim.flow.create.prepare` → 用户确认 → `invoice
 
 ### 命令
 
-将 Step 4 的 JSON 包在 `payload` 里写入文件，先 prepare，用户确认后再 apply。
+将 Step 4 的 JSON 作为 operation 顶层输入写入文件，先 prepare，用户确认后再 apply。
 
 Windows PowerShell：
 
@@ -1099,7 +1099,7 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.flow.create.prepare --input ./reim-create.json
 ```
 
-`payload` 示例：
+顶层输入示例：
 
 ```json
 {
@@ -1229,9 +1229,9 @@ CLI operation：`invoice.reim.flow.update.prepare` → 用户确认 → `invoice
 
 ### 命令
 
-将以下 JSON 包在 `payload` 里写入文件，先 `invoice.reim.flow.update.prepare`，用户确认后再 `.apply`。
+将以下 JSON 作为 operation 顶层输入写入文件，先 `invoice.reim.flow.update.prepare`，用户确认后再 `.apply`。
 
-### payload 示例
+### 顶层输入示例
 
 #### 场景1：同时删除明细第2行 + 修改主表 + 更新第1行明细
 
@@ -1337,4 +1337,3 @@ CLI operation：`invoice.reim.flow.update.prepare` → 用户确认 → `invoice
 - `fieldName` 仅用于可读性，不参与业务逻辑
 - 如果只删除不修改，只传 `requestId` + `deleteDetailRows` 即可
 - `value` 为空、`unable_to_fill=true`、`need_search=true` 的字段会被自动跳过
-

package/skills/weaver-e10-yepiaotong/references/reim-examples.md

@@ -451,7 +451,7 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.reim.flow.create.apply --input ./reim-create-apply.json
 ```
 
-> apply 的 JSON 需包含 `payload`（与 prepare 一致）、`continuation`（prepare 返回的 token）、`confirm: true`。
+> apply 的 JSON 需包含与 prepare 一致的顶层报销单字段、`continuation`（prepare 返回的 token）、`confirm: true`。
 
 **返回：**
 
@@ -651,7 +651,7 @@ Step 5 创建时，"相关项目"字段有多个候选，放入了 `need_user_co
 
 用户选择了"智慧园区一期"（id=P001），调用 `invoice.reim.flow.update.prepare` → 用户确认 → `invoice.reim.flow.update.apply` 补充：
 
-> 将以下 JSON 写入 `reim-update.json`，然后执行 `weaver-work-cli --json invoice run invoice.reim.flow.update.prepare --input ./reim-update.json`，用户确认后再执行 `.apply`（传入 payload + continuation + confirm:true）。
+> 将以下 JSON 写入 `reim-update.json`，然后执行 `weaver-work-cli --json invoice run invoice.reim.flow.update.prepare --input ./reim-update.json`，用户确认后再执行 `.apply`（传入顶层更新字段 + continuation + confirm:true）。
 
 ```json
 {