用途:通过已安装的 simplicity-cli 命令行工具执行 PDF 表单自动填写,从本地文件或 URL 获取数据源填充表单,并监控异步任务、下载结果文件。
主要能力:支持新建表单(simplicity-cli new)与已有表单 ID(simplicity-cli existing FORM_ID);表单和来源均可为本地文件或 URL;可通过 --context、--context-file 提供填充数据,通过 --instructions 提供可选填表行为指导;支持任务状态查询与等待完成;支持指定输出路径、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。
常用命令:保存密钥 simplicity-cli --api-key "<api_key>";本地表单加 context 填充 simplicity-cli new --form-file ./form.pdf --context "name: John Doe; dob: 1990-07-07";本地表单加来源文件 simplicity-cli new --form-file ./form.pdf --source-file ./w2.pdf --source-file ./id.pdf;URL 表单 simplicity-cli new --form-url "https://example.com/form.pdf" --source-url "https://example.com/source.pdf";已有表单 simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07";任务监控 simplicity-cli status TASK_ID 与 simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800。
规则与验证:new 时 --form-file 与 --form-url 必须二选一;至少提供一个来源或上下文;--context 与 --context-file 互斥,--instructions 与 --instructions-file 互斥;--no-download 与 --output 不可同时使用。交互时用人类可读输出,自动化时用 --json;除非用户明确要求异步,否则等待任务完成;需要指定路径时使用 --output。完成后返回任务 ID、表单/文档 ID 和下载路径。
限制与失败处理:CLI 未安装需先安装再重试;认证缺失需保存密钥或设置环境变量;任务失败需报告任务 ID 和失败信息,不得隐藏 API 错误细节;下载失败但任务成功时仍返回任务/表单标识;脚本场景可用 --json 并展示 error.code 与 error.message。参考资料见 references/commands.md。