← 返回 Skills 市场
liuwei19820201

vietnam-invoice

作者 liuwei19820201 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
84
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install vietnam-invoice
功能描述
越南发票验真 - 识别发票信息并通过越南税务 API 查验真伪
安全使用建议
This skill implements the declared task, but be aware of several risks before installing/using it: - Manifest mismatch: the registry lists no required env vars, but the SKILL.md and code require VL_API_KEY, CJY_USER, and CJY_PASS. Expect to set sensitive credentials for operation. - Data leakage: the skill uploads full invoice images (base64) to an external VL/model endpoint and sends captcha images to a third‑party captcha solver (ChaoJiYing). If invoices contain PII or confidential tax numbers, those will be transmitted to those services. Only use with data you are comfortable sharing with those providers. - Credential handling: CJY uses account+password (not an API token); avoid reusing high-privilege credentials. Prefer accounts with minimal privileges and rotate credentials if exposed. - Environment/setup: the skill requires Playwright and an msedge browser install, plus PyMuPDF/Pillow — run in an isolated environment (container/VM) if possible. - Trust & provenance: the skill's source/homepage is unknown. If you will process real invoices, request provenance from the author or prefer an officially supported tool. Review the code yourself (or have a trusted reviewer) before supplying credentials. What would increase confidence: author/source verification, corrected registry metadata declaring required env vars, and explicit user-facing warnings that images and data are sent to the VL provider and ChaoJiYing (with option to disable external services or use local OCR).
功能分析
Type: OpenClaw Skill Name: vietnam-invoice Version: 1.0.0 The skill is a legitimate tool for verifying Vietnamese invoices by extracting fields via a Vision-Language model (Alibaba Cloud Bailian) and querying the official Vietnamese tax portal (hoadondientu.gdt.gov.vn). It utilizes the Chaojiying service for captcha recognition and Playwright for rendering SVG captchas. While it disables SSL verification for requests and requires external API keys (CJY_USER, CJY_PASS, VL_API_KEY), these actions are consistent with its stated functionality, and no evidence of malicious intent, data exfiltration, or unauthorized execution was found in scripts/verify_vl.py or skill.md.
能力评估
Purpose & Capability
The code (verify_vl.py + pdf_to_images.py) matches the stated purpose: it extracts invoice fields (via a VL model) and queries the Vietnam tax API. Requiring a VL API key and a captcha-solving account (CJY_USER/CJY_PASS) is coherent with that functionality. However, the skill registry metadata declares no required environment variables while the SKILL.md and code clearly require VL_API_KEY, CJY_USER, and CJY_PASS — this manifest mismatch is an incoherence.
Instruction Scope
Runtime instructions and code send full invoice images (base64 data URLs) to an external VL/model service and send captcha images to a third‑party captcha solving service (upload.chaojiying.net). The script also contacts the Vietnam tax endpoint (hoadondientu.gdt.gov.vn:30000). These operations may exfiltrate sensitive invoice data (including personal/company tax IDs) to external providers. The SKILL.md does instruct the user to set env vars, but does not explicitly warn that invoice images will be uploaded to these external services.
Install Mechanism
There is no package download or remote installer; dependencies are installed via pip and Playwright (msedge). requirements.txt lists standard PyPI packages. No arbitrary remote code downloads or obscure URLs are present in the install process.
Credentials
The code requires credentials named CJY_USER/CJY_PASS (captcha solver account) and VL_API_KEY (model API key), which are sensitive and are used to send image data to external services. While these credentials are functionally required, the registry metadata failed to declare them. Requiring a username/password (CJY) and an API key is proportional to the feature but increases privacy risk because invoice images and captcha images are transmitted off‑site.
Persistence & Privilege
The skill does not request persistent/always-on status and does not modify system-wide settings. It is user-invocable and runs only when invoked.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install vietnam-invoice
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /vietnam-invoice 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of the Vietnam Invoice Verification skill. - Supports uploading PDF/PNG/JPG files to verify Vietnamese invoices. - Integrates field extraction and authenticity verification using the VL API. - Requires environment variables for Super Eagle (验证码识别) and 百炼 VL API. - Clear user guidance on environment variable setup and dependency installation. - Robust handling of image conversion, verification retries, and result explanations.
元数据
Slug vietnam-invoice
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

vietnam-invoice 是什么?

越南发票验真 - 识别发票信息并通过越南税务 API 查验真伪. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 84 次。

如何安装 vietnam-invoice?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install vietnam-invoice」即可一键安装,无需额外配置。

vietnam-invoice 是免费的吗?

是的,vietnam-invoice 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

vietnam-invoice 支持哪些平台?

vietnam-invoice 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 vietnam-invoice?

由 liuwei19820201(@liuwei19820201)开发并维护,当前版本 v1.0.0。

💬 留言讨论