用途:用已安装的 simplicity-cli 命令执行 PDF 自动填写流程,从本地文件或 URL 获取表单与源数据,填充后下载结果 PDF。适用场景是用户要求填写表单、依据已有资料自动补全 PDF 字段。
主要能力:新建表单填写(simplicity-cli new)、基于已有表单 ID 填写(simplicity-cli existing FORM_ID)、任务状态查询与等待(simplicity-cli status/wait)、按指定路径输出下载文件、JSON 机器可读输出。
使用方式:先确认安装,运行 simplicity-cli --help;缺失时优先 uv tool install ai-pdf-filler,回退方案 python3 -m pip install ai-pdf-filler,再重新检查。随后配置认证:simplicity-cli --api-key "<api_key>" 或设置环境变量 SIMPLICITY_AI_API_KEY。新建表单需在 --form-file 与 --form-url 中恰好提供一个,并至少提供一个来源(--source-file/--source-url)或上下文(--context/--context-file)。可用 --instructions 提供可选的填写行为指引。默认等待任务完成,除非用户明确要求异步;异步可用 --no-wait,配合 status 和 wait(如 --poll-interval-seconds 2 --max-wait-seconds 1800)。交互式运行使用人类可读输出,自动化或需要可解析结果时加 --json;用户指定路径时使用 --output。完成后返回任务 ID、表单/文档 ID 与下载路径。
限制:--context 与 --context-file 互斥,--instructions 与 --instructions-file 互斥;设置 --no-download 时不能使用 --output。命令缺失需先安装再重试;认证缺失需先保存密钥或设置环境变量。任务失败应报告任务 ID 与失败信息,不隐藏 API 错误细节;下载失败但任务已完成时仍需返回任务/表单标识。脚本场景可加 --json 并输出 error.code 与 error.message。更多模板与选项提示见 references/commands.md。