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

pdfcraft-use

办公与效率

查看项目

更新于 11-04 23:01

技能介绍

用途

pdfcraft-use 是 PDF 任务的总入口技能，适用于用户提出一般 PDF 检查、编辑、中文扫描 OCR 或交付需求但未指定专业入口的场景。该技能按目标进行路由，登记原件和产物，串联执行与验收。

主要能力

  • 任务流程：核实输入 → 只读检查 → 按需页面处理或自动化 → 显式清单验收 → 视觉审阅。
  • 最短链可以只使用本技能自身脚本，无须安装兄弟技能。
  • 支持通过计划格式组织步骤：{"domain":"printcraft","steps":[{"command":"实际工具名","params":{}}]}，先查 Schema 再填参数。
  • 提供 check、run、status、reconcile、verify 等命令用于计划检查、执行、状态查询、对账与验证。
  • 中文扫描识别：显式可选 Tesseract 后端，该路径生成栅格化新副本。

使用方式

环境要求：Python 3.11+；固定发行 printcraft-cli 0.2.1，仅 macOS arm64 锁已验证。入口保持 printcraft，不把 research 的 PdfCraft 新接口当成当前发行能力。

将 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"

--archive 可指定离线固定 ZIP，仍验证全部摘要；不修改 PATH。cli.py -- tools 首用可能安装，不能称为只读安装诊断。

计划检查与执行：

python3 -I -B "$SKILL_DIR/scripts/commands.py" check "$PLAN" --runtime-home "$RUNTIME_DIR"
python3 -I -B "$SKILL_DIR/scripts/commands.py" run "$PLAN" --output "$NEW_TASK_DIR" --expect "$OUTPUTS" --input "$ORIGINAL_PDF" --runtime-home "$RUNTIME_DIR"
python3 -I -B "$SKILL_DIR/scripts/commands.py" status "$NEW_TASK_DIR/receipt.json"
python3 -I -B "$SKILL_DIR/scripts/commands.py" reconcile "$NEW_TASK_DIR/receipt.json"
python3 -I -B "$SKILL_DIR/scripts/commands.py" verify "$VERIFY_REQUEST" --runtime-home "$RUNTIME_DIR"

适用场景

  • 一般 PDF 检查、编辑与交付任务。
  • 需要中文扫描 OCR 且用户未指定专业入口时。
  • 需要按目标路由并登记原件与产物的 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 <技能名>。

限制与注意事项

  • 当前为受控开发预发布状态。
  • 仅 macOS arm64 锁已验证。
  • 原生 0.2.1 仍只有英语；中文扫描识别需显式选用 Tesseract 后端，并先核实输出策略及后端身份。
  • 输出目录必须全新；runId 只用于追踪，不保证 exactly-once。已执行/结果不明的任务不能通过换目录或 runId 重放。
  • 只读对账不启动原生编辑。旧/损坏回执拒绝恢复，保留原件调查。
  • 显式 --input 登记需保护的文件或目录，执行前后检测摘要；参数中未登记的路径不受该检查覆盖，这不是沙箱。
  • 优先编辑工作副本；现有用户授权直接复用，仅新增加原件覆盖、真实打印或超出输出范围时重新确定授权。原生过程可能写文件、联网或使用系统资源。
  • 零退出只到 REVIEW_REQUIRED。必须检查显式清单、大小/摘要、新进程重开、逐页文本与几何，再完成当前摘要绑定的视觉审阅。未知或部分结果不自动重放；不自动循环修订。表单、脱敏、签名、PDF/A、OCR 分别记录验收状态。
  • 秘密字段包含 password/passwd/secret/token/api_key/credential；公开回执脱敏，私有执行材料权限 0600，结束后清理。避免把秘密放进文件名或不相关普通字段。任务目录仍可能含敏感 PDF，应由用户按保留策略清理。