mcpField
A
ai-pdf-filler-cli

ai-pdf-filler-cli

github.com/askyourpdf文档处理1341 次安装35 周前更新
代码仓库

关于 ai-pdf-filler-cli

通过 simplicity-cli 使用 ai-pdf-filler 填写 PDF 表单的命令行工作流技能，涵盖安装、认证、任务监控和下载结果。

主要功能

  1. 01从文件或 URL 创建表单
  2. 02按 ID 填写现有表单
  3. 03提供上下文和来源文档
  4. 04监控任务或等待完成
  5. 05下载结果并返回标识符

适用场景

  1. 01根据来源文档自动填写新 PDF
  2. 02使用提供的上下文填写 PDF
  3. 03跟踪异步填表任务
  4. 04将完成的表单保存到指定路径

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/askyourpdf/ai-pdf-filler --skill ai-pdf-filler-cli

安装后在 Claude Code 中输入/ai-pdf-filler-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
references/
commands.md

详细介绍

AI PDF Filler CLI

使用已安装的 simplicity-cli 命令执行 PDF 自动填充工作流。 适用此技能时，优先直接执行命令，而不是手动调用 API。

核心工作流

  1. 运行 simplicity-cli --help，确认已安装 simplicity-cli。
  2. 如果尚未安装，请安装 CLI：
  • 首选：uv tool install ai-pdf-filler
  • 备选：python3 -m pip install ai-pdf-filler
  • 使用 simplicity-cli --help 再次检查。
  1. 确保已完成身份验证（在 https://simplicity.ai 创建账户并获取 API 密钥）：
  • 首选：运行 simplicity-cli login，并在隐藏提示中粘贴密钥。
  • 非交互式：printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin。
  • 或设置环境变量：SIMPLICITY_AI_API_KEY。
  1. 选择自动填充方式：
  • 新建 PDF 表单：使用 simplicity-cli new。
  • 已有表单 ID：使用 simplicity-cli existing FORM_ID。
  1. 等待任务完成，除非用户明确要求异步执行。
  2. 返回生成的任务 ID、表单／文档 ID，以及下载的输出文件路径。

命令模式

保存 API 密钥
simplicity-cli login

printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin
根据文件及上下文新建表单
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"
已有表单 ID
simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07"

--context 是用于填写表单字段的源数据。 仅在需要提供可选的自动填充行为指导时使用 --instructions。

任务监控
simplicity-cli status TASK_ID
simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800

规则与验证

  • 对于 new，必须且只能指定 --form-file 或 --form-url 其中一个。
  • 对于 new，至少需要一个源（--source-file／--source-url）或上下文（--context／--context-file）。
  • --context 和 --context-file 不能同时使用。
  • --instructions 和 --instructions-file 不能同时使用。
  • 设置了 --no-download 时，不得使用 --output。

执行偏好

  • 交互式运行时使用人类可读输出模式。
  • 用于自动化或需要机器可解析输出时，使用 --json。
  • 仅在用户要求异步移交时使用 --no-wait；否则等待任务完成。
  • 用户要求指定文件路径时，使用 --output。

故障处理

  • 如果找不到 simplicity-cli，先安装 ai-pdf-filler，然后重试。
  • 如果缺少身份验证信息，请指导用户运行 simplicity-cli login（或使用 --api-key-stdin），或者设置 SIMPLICITY_AI_API_KEY。
  • 如果任务失败，请报告任务 ID 和失败消息；不要隐藏 API 错误详情。
  • 如果任务成功完成后下载失败，仍须返回任务／表单标识符。
  • 对于脚本场景，使用 --json 重新运行，并提供 error.code 和 error.message。

参考资料

请参阅 references/commands.md，查看简明模板和选项提示。

评论

支持 Markdown