CEAC Visa Status Checker (Zhipu Captcha)
This skill checks U.S. visa application status from CEAC and uses Zhipu vision model to read captcha.
Required User Fields
- - LOCATION: visa application location text in CEAC (example: CHINA, BEIJING)
- NUMBER: Application ID or Case Number (example: AA0020AKAX)
- PASSPORTNUMBER: passport number
- SURNAME: first letters of surname as used in CEAC
- ZHIPUAPI_KEY: API key for captcha OCR
Optional:
- - ZHIPUMODELVISION (default: glm-4v-flash)
- MAXRETRIES (default: 5)
- RETRYDELAY_SECONDS (default: 5)
Location help:
- - See references/LOCATION.md
Workflow
- 1. Ensure dependencies are installed from requirements.txt.
- Create .env based on .env.example.txt.
- Run scripts/checkceacstatus.py.
- Return JSON output to user.
Commands
Install:
python -m pip install -r requirements.txt
Run:
python scripts/checkceacstatus.py
Output Contract
On success:
- - success: true
- status: CEAC status text
- caselastupdated: CEAC last updated date
- description: CEAC message
- application_num: returned case number
On failure:
- - success: false
- error/message/last_error
Notes
- - Captcha recognition may fail occasionally. The script retries automatically.
- LOCATION must match CEAC location dropdown text. Fuzzy match is attempted.
- Keep API keys in environment variables. Avoid hardcoding secrets in scripts.
技能名称: ceac-visa-status-checker
详细描述:
CEAC 签证状态查询工具（智谱验证码）
该技能用于从 CEAC 查询美国签证申请状态，并使用智谱视觉模型读取验证码。
必需的用户字段
- - LOCATION: CEAC 中的签证申请地点文本（示例：CHINA, BEIJING）
- NUMBER: 申请 ID 或案件编号（示例：AA0020AKAX）
- PASSPORTNUMBER: 护照号码
- SURNAME: 姓氏首字母（与 CEAC 中使用的一致）
- ZHIPUAPI_KEY: 用于验证码 OCR 的 API 密钥
可选字段：
- - ZHIPUMODELVISION（默认值：glm-4v-flash）
- MAXRETRIES（默认值：5）
- RETRYDELAY_SECONDS（默认值：5）
位置帮助：
- - 请参阅 references/LOCATION.md
工作流程
- 1. 确保已从 requirements.txt 安装依赖项。
- 基于 .env.example.txt 创建 .env 文件。
- 运行 scripts/checkceacstatus.py。
- 向用户返回 JSON 输出。
命令
安装：
python -m pip install -r requirements.txt
运行：
python scripts/checkceacstatus.py
输出约定
成功时：
- - success: true
- status: CEAC 状态文本
- caselastupdated: CEAC 最后更新日期
- description: CEAC 消息
- application_num: 返回的案件编号
失败时：
- - success: false
- error/message/last_error
备注
- - 验证码识别偶尔可能失败。脚本会自动重试。
- LOCATION 必须与 CEAC 位置下拉菜单中的文本匹配。会尝试模糊匹配。
- 将 API 密钥保存在环境变量中。避免在脚本中硬编码密钥。
