SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场pdfcraft-cli-pages

pdfcraft-cli-pages

办公与效率

查看项目

更新于 11-04 23:01

技能介绍

用途

该技能面向 PDF 页面级编辑任务：当用户要求 PDF 提取、合并、拆分、重排、旋转、裁剪或页框调整时使用。核心要求是保留原件，另存工作副本，并逐页核对来源顺序和几何参数。

主要能力

  • 登记 --input 指定的原件并另存处理。
  • 页码从 1 起，坐标与旋转以工具 Schema 为准。
  • 提供计划检查、执行、状态查询、对账与验证等受控流程。
  • 支持显式 --input 登记需保护的文件或目录，执行前后检测摘要。

使用方式

需将 SKILL_DIR 设置为宿主实际加载的本文件目录，运行时放在独立用户数据目录。示例流程：

python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" --diagnose
python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" --runtime-home "$RUNTIME_DIR"
python3 -I -B "$SKILL_DIR/scripts/commands.py" list --runtime-home "$RUNTIME_DIR"
python3 -I -B "$SKILL_DIR/scripts/commands.py" describe doc_open --runtime-home "$RUNTIME_DIR"

计划格式为：{"domain":"printcraft","steps":[{"command":"实际工具名","params":{}}]}，需先查 Schema 再填参数。执行与核对命令包括 check、run、status、reconcile、verify。输出目录必须全新；runId 只用于追踪，不保证 exactly-once，已执行或结果不明的任务不能通过换目录或 runId 重放。

适用场景

适用于需要对现有 PDF 做页面结构编辑，且要求可追溯、可核对、保留原件的受控环境。

限制

  • 属受控开发预发布；固定发行 printcraft-cli 0.2.1，仅 macOS arm64 锁定已验证，要求 Python 3.11+。
  • 入口保持 printcraft，不把 research 的 PdfCraft 新接口当成当前发行能力。
  • 显式 --input 登记之外的路径不受摘要检查覆盖，这不是沙箱。
  • 零退出只到 REVIEW_REQUIRED，必须检查显式清单、大小/摘要、新进程重开、逐页文本与几何，再完成当前摘要绑定的视觉审阅。
  • 原生 0.2.1 仅支持英语 OCR；中文扫描识别需可选 Tesseract 后端，将生成栅格化新副本，需先核实输出策略及后端身份。
  • 表单、脱敏、签名、PDF/A、OCR 分别记录验收状态。
  • 秘密字段包括 password/passwd/secret/token/api_key/credential；公开回执脱敏，私有执行材料权限 0600，结束后清理。任务目录仍可能含敏感 PDF，应由用户按保留策略清理。

路由

一般任务使用 pdfcraft-use；环境使用 printcraft-cli-setup；检查使用 pdfcraft-cli-inspect；页面使用 pdfcraft-cli-pages；批处理恢复使用 pdfcraft-cli-automation；专项契约使用 printcraft-cli。安装其他技能：npx skills add full-aigc-skills/pdfcraft-skills --skill <技能名>。