dsh-plugin-t-expert 0.4.9 → 0.4.36

package/data/experts/security/invoice-verify-expert/skills/invoice-verify/references/parameters.md

@@ -0,0 +1,82 @@
+# 发票查验参数说明
+
+## 参数列表
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| invoiceTypeNo | String | **必填** | 发票类型代码 |
+| invoiceCode | String | **条件必填** | 发票代码 |
+| invoiceNo | String | **必填** | 发票号码 |
+| billingDate | String | **必填** | 开票日期，格式：20220419（8位数字） |
+| invoiceAmount | Double | **条件必填** | 发票不含税金额，以元为单位 |
+| checkCode | String | **条件必填** | 校验码后六位 |
+| invoiceFee | Double | **条件必填** | 发票价税合计，以元为单位 |
+| totalAmount | Double | **条件必填** | 总金额，以元为单位 |
+
+## 发票类型与必填参数对照矩阵
+
+| 发票类型代码 | 类型说明 | 发票代码 | 发票号码 | 开票日期 | 不含税金额 | 校验码 | 价税合计 | 总金额 | 备注 |
+|-------------|---------|:-------:|:-------:|:-------:|:---------:|:-----:|:-------:|:-----:|------|
+| 01 | 增值税专用发票 | ✅ | ✅ | ✅ | ✅ | | | | |
+| 03 | 机动车销售统一发票 | ✅ | ✅ | ✅ | ✅ | | | | |
+| 04 | 增值税普通发票 | ✅ | ✅ | ✅ | | ✅ | | | 如果为"全电纸质普通发票"，取"全电发票号码"作为"校验码"入参 |
+| 08 | 增值税电子专用发票 | ✅ | ✅ | ✅ | ✅ | | | | |
+| 10 | 增值税普通发票(卷式) | ✅ | ✅ | ✅ | | ✅ | | | |
+| 10 | 深圳区块链发票 | ✅ | ✅ | ✅ | ✅ | ✅ | | | 代码10既是卷式普通发票，也用于深圳区块链发票，需根据具体场景判断 |
+| 11 | 增值税普通发票(卷式) | ✅ | ✅ | ✅ | | ✅ | | | |
+| 14 | 增值税电子普通发票（通行费） | ✅ | ✅ | ✅ | | ✅ | | | |
+| 112 | 电子发票（增值税专用发票） | | ✅ | ✅ | | | ✅ | | |
+| 113 | 电子发票（普通发票） | | ✅ | ✅ | | | ✅ | | |
+| CZEI312 | 电子发票（普通发票-通行费） | | ✅ | ✅ | | | ✅ | | |
+| CZEI013 | 二手车销售统一发票 | ✅ | ✅ | ✅ | | | ✅ | | |
+| CZEI112 | 电子发票（铁路电子客票） | | ✅ | ✅ | | | ✅ | | **发票号码必须为 20 位**（实测：19 位/18 位/16 位等均返回 121981 参数格式有误；20 位通过格式校验后才会返回业务结果 121802/121803/121800） |
+| CZEI113 | 电子发票（航空运输电子客票行程单） | | ✅ | ✅ | | | | ✅ | |
+| CZEI212 | 电子发票（机动车销售统一发票） | | ✅ | ✅ | | | ✅ | | |
+| CZEI313 | 电子发票（二手车销售统一发票） | | ✅ | ✅ | | | ✅ | | |
+
+## 判参逻辑速查
+
+1. **所有类型**都需要 `invoiceTypeNo`、`invoiceNo`、`billingDate`
+2. **发票代码**：01、03、04、08、10、11、14、CZEI013、深圳区块链发票 需要
+3. **不含税金额**：01、03、08、深圳区块链发票 需要
+4. **校验码**：04、10、11、14、深圳区块链发票 需要。04 类型若为"全电纸质普通发票"，取"全电发票号码"作为校验码
+5. **价税合计**：112、113、CZEI013、CZEI112、CZEI212、CZEI313、CZEI312 需要
+6. **总金额**：CZEI113 需要
+
+## 发票类型代码说明
+
+| 代码 | 类型说明 |
+|------|----------|
+| 01 | 增值税专用发票 |
+| 03 | 机动车销售统一发票 |
+| 04 | 增值税普通发票 |
+| 08 | 增值税电子专用发票 |
+| 10 | 增值税普通发票(卷式) / 深圳区块链发票 |
+| 11 | 增值税普通发票(卷式) |
+| 14 | 增值税电子普通发票（通行费） |
+| 112 | 电子发票（增值税专用发票） |
+| 113 | 电子发票（普通发票） |
+| CZEI013 | 二手车销售统一发票 |
+| CZEI112 | 电子发票（铁路电子客票） |
+| CZEI113 | 电子发票（航空运输电子客票行程单） |
+| CZEI212 | 电子发票（机动车销售统一发票） |
+| CZEI312 | 电子发票（普通发票-通行费） |
+| CZEI313 | 电子发票（二手车销售统一发票） |
+
+## 常见错误码速查
+
+| 结果码 | 含义 | 排查方向 |
+|--------|------|----------|
+| 121800 | 查验成功，发票一致 | ✅ 直接通过 |
+| 121802 | 查验失败，参数与票面不一致 | 核对开票日期/金额/号码（用乘车日期会触发此错） |
+| 121803 | 税局没有查到该发票 | 号码在系统中不存在（可能是样票/OCR 号码识别有误） |
+| 121981 | 参数格式有误 | 字段类型/位数不合法（详见各类型备注列） |
+| 121984 | 不存在的发票类型 | 检查 `invoiceTypeNo` 拼写（如 CZEI112 写错会触发） |
+
+## OCR 读图容错提醒
+
+从发票图片识别参数时注意：
+1. **开票日期 vs 乘车日期**：电子客票有两类日期（乘车日期、开票日期），查验 API 只认**开票日期**（billingDate）
+2. **发票号码位数**：CZEI112 必须 20 位；其他电子发票 20 位是常见标准
+3. **"01" 容易被 OCR 误读为 "10" 或 "1"**：月日两位数字务必核对
+4. **复核机制**：先看是否有"统一社会信用代码"15/18/20 位 + "价税合计"金额 + "发票号码"，三者互相对得上才调用 API

package/data/experts/security/invoice-verify-expert/skills/invoice-verify/scripts/verify_invoice.py

@@ -0,0 +1,239 @@
+#!/usr/bin/env python3
+"""
+发票查验脚本
+通过汇联易查验服务进行发票真伪查验（标准 JSON-RPC over SSE 协议）。
+
+用法：
+  python3 verify_invoice.py --invoiceTypeNo 113 --invoiceNo ... --billingDate 20251203 --invoiceFee 75.87
+
+API Key 读取优先级（从高到低）：
+  1. --apikey 命令行参数
+  2. 脚本同目录下的 .apikey 文件
+  3. HELIOS_KEY 环境变量
+
+参数说明见 references/parameters.md
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+import urllib.request
+
+MCP_URL = "https://hlymcp.huilianyi.com:8443/mcp"
+MCP_TOOL_NAME = "huilianyi_verify_invoice"
+
+# SSE data line pattern
+SSE_DATA_RE = re.compile(r"^data:\s*(.+)$", re.MULTILINE)
+
+
+def build_params(args: argparse.Namespace) -> dict:
+    """Build tool arguments dict from CLI args."""
+    arguments = {
+        "invoiceTypeNo": args.invoiceTypeNo,
+        "invoiceNo": args.invoiceNo,
+        "billingDate": args.billingDate,
+    }
+
+    if args.invoiceCode is not None:
+        arguments["invoiceCode"] = args.invoiceCode
+    if args.invoiceAmount is not None:
+        arguments["invoiceAmount"] = args.invoiceAmount
+    if args.checkCode is not None:
+        arguments["checkCode"] = args.checkCode
+    if args.invoiceFee is not None:
+        arguments["invoiceFee"] = args.invoiceFee
+    if args.totalAmount is not None:
+        arguments["totalAmount"] = args.totalAmount
+
+    return arguments
+
+
+def call_mcp(api_key: str, arguments: dict) -> dict:
+    """Call the MCP endpoint via standard tools/call protocol and return parsed result."""
+    # Standard MCP tools/call payload
+    payload = {
+        "jsonrpc": "2.0",
+        "method": "tools/call",
+        "params": {
+            "name": MCP_TOOL_NAME,
+            "arguments": arguments,
+        },
+        "id": 1,
+    }
+
+    data = json.dumps(payload).encode("utf-8")
+    req = urllib.request.Request(
+        MCP_URL,
+        data=data,
+        headers={
+            "Content-Type": "application/json",
+            "Accept": "application/json, text/event-stream",
+            "MCP_KEY": api_key,
+        },
+        method="POST",
+    )
+
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            raw_body = resp.read().decode("utf-8")
+    except urllib.error.HTTPError as e:
+        return {"_error": f"HTTP {e.code}: {e.read().decode('utf-8', errors='replace')}"}
+    except urllib.error.URLError as e:
+        return {"_error": f"网络错误: {e.reason}"}
+    except Exception as e:
+        return {"_error": f"未知错误: {e}"}
+
+    # Parse SSE response: extract last "data:" line's JSON
+    matches = SSE_DATA_RE.findall(raw_body)
+    if not matches:
+        return {"_error": f"无法解析 SSE 响应: {raw_body[:200]}"}
+
+    try:
+        result = json.loads(matches[-1])
+    except json.JSONDecodeError as e:
+        return {"_error": f"JSON 解析失败: {e}\n原始数据: {matches[-1][:500]}"}
+
+    # Unwrap MCP tool result
+    if "result" in result:
+        mcp_result = result["result"]
+        if isinstance(mcp_result, dict) and "content" in mcp_result:
+            content_list = mcp_result["content"]
+            if content_list and isinstance(content_list, list):
+                text = content_list[0].get("text", "")
+                try:
+                    inner = json.loads(text)
+                except json.JSONDecodeError:
+                    inner = {"message": text}
+                inner["_isError"] = mcp_result.get("isError", False)
+                return inner
+        return mcp_result
+
+    if "error" in result and result["error"]:
+        return {"_error": f"MCP error {result['error'].get('code','')}: {result['error'].get('message','')}"}
+
+    return result
+
+
+def format_result(data: dict) -> str:
+    """Format the verification result into human-readable output."""
+    if "_error" in data:
+        return f"❌ 查验失败：{data['_error']}"
+
+    # Code 121800 = "查验成功，发票一致" — treated as success
+    code = data.get("code", "")
+    message = data.get("message", "")
+
+    if code == "121800" or "查验成功" in message:
+        # Extract invoice details from nested data
+        details = data.get("details", {})
+        invoice_data = details.get("data", {}) or data
+
+        fee_yuan = (invoice_data.get("fee", 0) or 0) / 100
+        fee_without_tax = (invoice_data.get("feeWithoutTax", 0) or 0) / 100
+        tax = invoice_data.get("tax", "")
+        tax_yuan = float(tax) / 100 if tax else 0
+
+        lines = [
+            "✅ 发票查验通过 — 该发票真实有效，与税务系统一致",
+            "=" * 56,
+            f"发票类型:    {invoice_data.get('type', 'N/A')}",
+            f"发票号码:    {invoice_data.get('invoiceNo', 'N/A')}",
+            f"发票代码:    {invoice_data.get('invoiceCode') or '(电子发票无发票代码)'}",
+            f"开票日期:    {invoice_data.get('billingDate', 'N/A')}",
+            f"购买方:      {invoice_data.get('title', 'N/A')}",
+            f"购买方税号:  {invoice_data.get('draweeNo', 'N/A')}",
+            f"销售方:      {invoice_data.get('payee', 'N/A')}",
+            f"销售方税号:  {invoice_data.get('payeeNo', 'N/A')}",
+            f"价税合计:    ¥{fee_yuan:.2f}",
+            f"不含税金额:  ¥{fee_without_tax:.2f}",
+            f"税额:        ¥{tax_yuan:.2f}",
+            f"税率:        {invoice_data.get('invoiceGoods', [{}])[0].get('taxRate', 'N/A')}%",
+            f"货物/服务:   {invoice_data.get('invoiceGoods', [{}])[0].get('goodsName', 'N/A')}",
+            f"发票状态:    {invoice_data.get('receiptStatus', 'N/A')}",
+            f"是否作废:    {'否' if invoice_data.get('invalidStatus') == 'N' else '是'}",
+            "=" * 56,
+            f"查验结果码:  {code} ({message})",
+        ]
+        lines.append("")
+        lines.append("提示：查验返回的发票信息与您提供的一致。")
+        return "\n".join(lines)
+
+    # Other codes — likely failure
+    lines = [
+        f"❌ 发票查验未通过",
+        "=" * 40,
+        f"结果码: {code}",
+        f"消息:   {message}",
+    ]
+    if "details" in data:
+        dtl_msg = data["details"].get("message", "")
+        if dtl_msg and dtl_msg != message:
+            lines.append(f"详情:   {dtl_msg}")
+    return "\n".join(lines)
+
+
+def get_api_key(cli_key=None):
+    """Read API key from multiple sources, ordered by priority.
+
+    Priority: CLI arg > .apikey file > HELIOS_KEY env var.
+    """
+    # 1. CLI --apikey argument (highest priority)
+    if cli_key:
+        return cli_key
+
+    # 2. .apikey file in the same directory as this script
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    apikey_file = os.path.join(script_dir, "..", ".apikey")
+    if os.path.isfile(apikey_file):
+        try:
+            with open(apikey_file, "r") as f:
+                key = f.read().strip()
+                if key:
+                    return key
+        except OSError:
+            pass
+
+    # 3. HELIOS_KEY environment variable (fallback)
+    return os.environ.get("HELIOS_KEY")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="发票查验")
+    parser.add_argument("--apikey", default=None, help="汇联易查验 API Key (优先级最高)")
+    parser.add_argument("--invoiceTypeNo", required=True, help="发票类型 (必填)")
+    parser.add_argument("--invoiceCode", default=None, help="发票代码 (条件必填)")
+    parser.add_argument("--invoiceNo", required=True, help="发票号码 (必填)")
+    parser.add_argument("--billingDate", required=True, help="开票日期，格式：20220419 (必填)")
+    parser.add_argument("--invoiceAmount", type=float, default=None, help="发票不含税金额，以元为单位 (条件必填)")
+    parser.add_argument("--checkCode", default=None, help="校验码后六位 (条件必填)")
+    parser.add_argument("--invoiceFee", type=float, default=None, help="发票价税合计，以元为单位 (条件必填)")
+    parser.add_argument("--totalAmount", type=float, default=None, help="总金额，以元为单位 (条件必填)")
+
+    args = parser.parse_args()
+
+    # Get API key (priority: --apikey > .apikey file > HELIOS_KEY env var)
+    api_key = get_api_key(args.apikey)
+    if not api_key:
+        print("❌ 错误：未找到 API Key")
+        print("请通过以下任一方式提供 API Key：")
+        print("  1. 命令行参数：--apikey YOUR_KEY")
+        print("  2. 在脚本上级目录创建 .apikey 文件，写入 Key")
+        print("  3. 设置环境变量：export HELIOS_KEY=your_api_key")
+        sys.exit(1)
+
+    # Build arguments and call
+    arguments = build_params(args)
+    data = call_mcp(api_key, arguments)
+
+    # Output result
+    print(format_result(data))
+
+    # Exit with error code if verification failed
+    if "_error" in data:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/data/experts/security/invoice-verify-workbuddy/.codebuddy-plugin/plugin.json

@@ -0,0 +1,144 @@
+{
+  "name": "invoice-verify-workbuddy",
+  "version": "1.0.4",
+  "description": "Intelligent invoice expert team for invoice recognition, tax authority verification, business credit checks, and smart invoice folder archiving across uploaded files, batch spreadsheets, and local folders.",
+  "author": {
+    "name": "百望股份",
+    "email": "market@baiwang.com"
+  },
+  "expertType": "team",
+  "agentName": "invoice-verify-team-lead",
+  "teamInfo": {
+    "leadAgent": "invoice-verify-team-lead",
+    "memberAgents": [
+      "invoice-sorter",
+      "invoice-verifier",
+      "counterparty-risk-analyst",
+      "archivist"
+    ]
+  },
+  "agents": [
+    "./agents/invoice-verify-team-lead.md",
+    "./agents/invoice-sorter.md",
+    "./agents/invoice-verifier.md",
+    "./agents/counterparty-risk-analyst.md",
+    "./agents/archivist.md"
+  ],
+  "skills": [
+    "./skills/invoice-verify"
+  ],
+  "displayName": {
+    "en": "Intelligent Invoice Expert Team",
+    "zh": "智能发票专家团"
+  },
+  "profession": {
+    "en": "Intelligent Invoice Expert Team",
+    "zh": "智能发票专家团"
+  },
+  "displayDescription": {
+    "en": "Five AI experts collaborate across uploaded invoices, batch spreadsheets, or selected local folders to recognize invoices, verify them with tax authority data, check business credit, and archive results automatically.",
+    "zh": "五位AI专家接力协作，通过上传文件、表格或文件夹，完成识别、税局验真、信用核查与归档"
+  },
+  "avatar": "avatars/team.png",
+  "categoryId": "11-SecurityCompliance",
+  "defaultInitPrompt": {
+    "en": "Use Intelligent Invoice Expert Team Check the invoices in a selected local folder",
+    "zh": "使用智能发票专家团帮我核验上传的发票"
+  },
+  "tags": [
+    {
+      "en": "Recognition and Verification",
+      "zh": "识别验真"
+    },
+    {
+      "en": "Business Credit",
+      "zh": "商业信用"
+    },
+    {
+      "en": "Smart Invoice Folder",
+      "zh": "智能票夹"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "en": "Use Intelligent Invoice Expert Team Check the invoices in a selected local folder",
+      "zh": "使用智能发票专家团帮我核验上传的发票"
+    },
+    {
+      "en": "Check the credit status of these suppliers: XX Logistics, XX Trading, XX Technology",
+      "zh": "帮我看看这几个供应商的信用情况：XX物流、XX贸易、XX科技"
+    },
+    {
+      "en": "Verify this invoice batch and check the issuers' credit status",
+      "zh": "这批发票验完顺便查一下开票方的信用状况"
+    }
+  ],
+  "members": [
+    {
+      "id": "invoice-verify-team-lead",
+      "name": {
+        "en": "Chief Expert",
+        "zh": "百晓通"
+      },
+      "profession": {
+        "en": "Intelligent Invoice Chief Expert",
+        "zh": "智能发票首席专家"
+      },
+      "avatar": "avatars/lead.png",
+      "role": "lead"
+    },
+    {
+      "id": "invoice-sorter",
+      "name": {
+        "en": "Recognition",
+        "zh": "百晓甄"
+      },
+      "profession": {
+        "en": "Multimodal Recognition Expert",
+        "zh": "多模态识别专家"
+      },
+      "avatar": "avatars/sorter.png",
+      "role": "member"
+    },
+    {
+      "id": "invoice-verifier",
+      "name": {
+        "en": "Verifier",
+        "zh": "百晓燕"
+      },
+      "profession": {
+        "en": "Invoice Verification Expert",
+        "zh": "发票查验专家"
+      },
+      "avatar": "avatars/verifier.png",
+      "role": "member"
+    },
+    {
+      "id": "counterparty-risk-analyst",
+      "name": {
+        "en": "Credit",
+        "zh": "百晓信"
+      },
+      "profession": {
+        "en": "Business Credit Expert",
+        "zh": "商业信用专家"
+      },
+      "avatar": "avatars/risk.png",
+      "role": "member"
+    },
+    {
+      "id": "archivist",
+      "name": {
+        "en": "Invoice Folder",
+        "zh": "百晓慧"
+      },
+      "profession": {
+        "en": "Enterprise Invoice Folder",
+        "zh": "企业票夹"
+      },
+      "avatar": "avatars/archivist.png",
+      "role": "member"
+    }
+  ],
+  "plugin": "invoice-verify-workbuddy"
+}

package/data/experts/security/invoice-verify-workbuddy/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:06.730108+00:00

package/data/experts/security/invoice-verify-workbuddy/.env

@@ -0,0 +1,11 @@
+BAIWANG_OCR_STANDARD_URL=https://openapi.baiwang.com/mcp/wukong/lctoolscall?key=53353a4c6744481476d9b7b8386bd37c
+BAIWANG_INVOICE_RECOGNIZE_VERIFY_URL=https://openapi.baiwang.com/mcp/wukong/lctoolscall?key=53353a4c6744481476d9b7b8386bd37c
+BAIWANG_COUNTERPARTY_RISK_URL=https://openapi.baiwang.com/mcp/wukong/lctoolscall?key=53353a4c6744481476d9b7b8386bd37c
+OSS_ACCESS_KEY=LTAI5t7GuSEL4zhxYziDLEQc
+OSS_SECRET_KEY=QOgZxWNyhtR8qFqcvdZKS7Z19WNUdH
+OSS_BUCKET_NAME=bw-invoice-workbuddy
+OSS_BUCKET_DOMAIN=bw-invoice-workbuddy.oss-cn-beijing.aliyuncs.com
+OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com
+OSS_PREFIX=invoice-uploads
+PLATFORM_TAXNO=9133011020260528C9
+BAIWANG_IMAGE_RECOGCOLLECT_USER_ACCOUNT=admin_6dvjogabsfipo

package/data/experts/security/invoice-verify-workbuddy/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "invoice-verify-workbuddy",
+  "division": "security",
+  "categoryId": "11-SecurityCompliance",
+  "importedAt": "2026-09-29T12:42:06",
+  "source": "workbuddy expert marketplace (COS)"
+}