← 返回 Skills 市场
linyao58

批量身份证 OCR 提取工具 (导出 TXT 版)

作者 linyao58 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
88
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install batch-id
功能描述
批量识别最多50张身份证正面照片,提取姓名、性别、身份证号并生成格式整齐的TXT文件输出。
使用说明 (SKILL.md)

批量身份证 OCR 提取工具 (导出 TXT 版)\r

\r 这是一个基于腾讯云 OCR 技术的 OpenClaw Skill。它能够自动识别图片中的身份证信息,并生成一份整齐的 .txt 文件发送给用户,非常适合需要批量处理证件信息的场景。\r \r

🌟 功能特点\r

\r

  • 批量处理:单次最高支持 50 张 身份证图片识别。\r
  • 格式规范:自动提取 姓名性别身份证号。\r
  • 排版整洁:每张证件信息占用三行,证件之间自动空行分隔,方便直接复制或打印。\r
  • 文件输出:直接生成 .txt 附件,避免对话框长文本刷屏。\r
  • 隐私安全:采用 OpenClaw 环境变量配置,不硬编码 API 密钥,确保您的腾讯云账号安全。\r \r

🛠️ 安装预要求\r

\r 在发布或使用此 Skill 之前,您需要:\r

  1. 拥有一个腾讯云账号。\r
  2. 腾讯云访问管理 (CAM) 获取您的 SecretIdSecretKey。\r

    建议:为安全起见,请创建一个仅拥有 QcloudOCRFullAccess 权限的子账号。\r

  3. 确保您的 OpenClaw 部署环境可以访问 ocr.tencentcloudapi.com。\r \r

🚀 配置说明 (关键)\r

\r 安装此 Skill 后,请在 OpenClaw 的 Skill 配置面板 中填入以下信息:\r \r | 配置项 | 说明 | 示例值 |\r | :--- | :--- | :--- |\r | TENCENT_SECRET_ID | 腾讯云 API 密钥 ID | AKIDxxxxxxxxxxxxxx |\r | TENCENT_SECRET_KEY | 腾讯云 API 密钥 Key | xxxxxxxxxxxxxxxxxxxx |\r | REGION | 识别接口地域 | ap-guangzhou (默认) |\r \r

📖 使用方法\r

\r

  1. 在对话框中发送一张或多张(最多50张)身份证正面照片。\r
  2. 触发本 Skill。\r
  3. 稍等片刻(程序内设有 0.5s/张 的频率保护),机器人将发送识别完成的消息。\r
  4. 下载并查看机器人发送的 身份证提取结果.txt 文件。\r \r

📝 输出格式示例\r

\r

姓名:张三\r
性别:男\r
身份证号:44010619900101xxxx\r
\r
姓名:李四\r
性别:女\r
身份证号:44010619950520xxxx
安全使用建议
该技能看起来就是用腾讯云 OCR 识别身份证并生成 TXT——这需要把腾讯云的 SecretId/SecretKey 提供给技能。安装前请确认: - skill.yaml 要求的配置键名是 'tencent-secret-id' 和 'tencent-secret-key',而 SKILL.md 使用大写环境变量名(TENCENT_SECRET_ID / TENCENT_SECRET_KEY);在你的 OpenClaw 控制面板中填入的字段名必须与平台如何把配置传给技能匹配,否则技能会提示未配置密钥。 - SKILL.md 建议配置 REGION,但代码硬编码使用 'ap-guangzhou',如果你的腾讯云资源在其他地域,识别可能失败;联系作者或修改代码以使用配置的 REGION 会更好。 - 确认平台如何处理返回的本地文件路径(/tmp/身份证提取结果.txt):确保该路径被安全上载给用户且不会泄露到其他未授权位置。 - 注意隐私:身份证是高度敏感数据。技能会把图片 URL 传给腾讯云 OCR 服务进行识别,意味着图片内容会发送到腾讯云。仅在信任腾讯云并确保账号权限最小化(如建议的只授予 OCR 相关权限的子账号)时才使用。 - 因为注册元数据没有声明凭据要求,这可能是打包或发布时的疏忽——在把密钥放入平台之前,最好确认技能作者/来源是否合法可信,或者在受控测试环境中先验证功能与配置映射。 如果你需要,我可以建议具体检查项或一段小的验证调用来确认配置在你的 OpenClaw 部署中是如何传递给 handler 的。
功能分析
Type: OpenClaw Skill Name: batch-id Version: 1.0.0 The skill is a legitimate tool for batch ID card OCR using the Tencent Cloud SDK. The code in batch_id.py correctly handles API credentials via configuration, processes image URLs, and generates a text report in the /tmp directory. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
技能名、描述、SKILL.md 和代码一致地表明它使用腾讯云 OCR 来识别身份证并生成 TXT,所需的 SecretId/SecretKey 与目的相符. 然而 registry 元数据宣称“无需环境变量/主凭据”,但 skill.yaml 与代码都要求腾讯云凭据,这是一处不一致,可能导致安装配置混淆。
Instruction Scope
SKILL.md 仅描述将图片 URL 发给技能、等待并下载生成的 TXT;代码只调用腾讯云 OCR(通过 ImageUrl)、写入 /tmp 并返回文件路径。没有看到额外读取本地敏感文件或向第三方非腾讯云端点回传数据。但存在不一致:SKILL.md 建议填写 TENCENT_SECRET_ID/TENCENT_SECRET_KEY/REGION 环境变量,实际代码从 event.config 中读取 'tencent-secret-id' 和 'tencent-secret-key',且 REGION 在代码中被硬编码为 'ap-guangzhou',SKILL.md 的 REGION 配置并未被代码使用。
Install Mechanism
无安装脚本(instruction-only / small code file + requirements.txt)。唯一外部依赖是官方 tencentcloud-sdk-python(requirements.txt),没有可疑下载 URL 或提取操作,写磁盘仅为 /tmp(正常)。总体安装风险低。
Credentials
请求的凭据(腾讯云 SecretId/SecretKey)与 OCR 功能直接相关且合理。但 registry 报告没有列出必需环境变量/凭据,而 skill.yaml 明确声明需要两个密钥,这不一致会误导用户。另外 SKILL.md 用的大写环境变量名与 skill.yaml 中的配置项名不同,可能导致凭据被放在错误位置或未正确读取。
Persistence & Privilege
技能没有设置 always:true,也不修改其他技能/系统配置,仅在 /tmp 写入输出文件并返回给平台,权限与功能范围相符。
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install batch-id
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /batch-id 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
batch-id 1.0.0 初始版本发布 - 支持批量处理最多 50 张身份证照片,自动识别姓名、性别和身份证号。 - 输出内容排版规范,结果生成 .txt 文件通过消息附件发送,方便管理和下载。 - 配置项支持环境变量,保护 API 密钥安全(不硬编码)。 - 适合需要批量处理证件信息并导出文本文件的场景。
元数据
Slug batch-id
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

批量身份证 OCR 提取工具 (导出 TXT 版) 是什么?

批量识别最多50张身份证正面照片,提取姓名、性别、身份证号并生成格式整齐的TXT文件输出。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 88 次。

如何安装 批量身份证 OCR 提取工具 (导出 TXT 版)?

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

批量身份证 OCR 提取工具 (导出 TXT 版) 是免费的吗?

是的,批量身份证 OCR 提取工具 (导出 TXT 版) 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

批量身份证 OCR 提取工具 (导出 TXT 版) 支持哪些平台?

批量身份证 OCR 提取工具 (导出 TXT 版) 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 批量身份证 OCR 提取工具 (导出 TXT 版)?

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

💬 留言讨论