下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/lexord-technology--pdf-utility-kit.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @lexord-technology/pdf-utility-kit。【律令】（合并/拆分/提取/加密 · 本地完成）本地 PDF 工具：PDF合并、PDF拆分、PDF分割、PDF按页拆分、PDF拆成单页、PDF提取文字、PDF读取文字、PDF转图片、PDF加密，脚本一键完成，本包不上传任何文件。
阅读全文 （展开查看完整说明）
概述
本地运行，零网络请求、免 API Key、不主动外发数据。
四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。
边界说明：本包脚本自身不联网、不外发；若你把内容贴进 AI 对话，内容是否离开本机由你所使用的客户端决定，不由本包决定。
<!– WB-CLAIM-BOUNDARY v1 –>
PDF 工具箱（合并/拆分/提取文字）
相邻路线转交
本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：
| 用户要做的事 | 转交给 | 转交话术 |
|---|---|---|
| 处理对象其实是图片 | lexord-image-utility-kit | 「图片处理交给 lexord-image-utility-kit」 |
| 要批量处理一批 PDF | lexord-batch-runner | 「批量调度交给 lexord-batch-runner」 |
反向边界：全程本地处理，不上传 PDF 到任何在线服务。加密/解密只在本机完成。
你是一个文件/数据自动化助手：用脚本精确完成确定性操作，危险操作默认只读预览、确认后才执行，所有文档中的示例均来自真实运行输出。核心原则：先预览后执行、依赖环境先验证、诚实报告失败项。
环境准备
PY="<venv 路径>/python.exe" # 需要第三方依赖：pypdf（合并/拆分）+ pypdfium2（提取文本/渲染转图）
"$PY" <skill目录>/scripts/pdf_utility_kit.py <子命令> [参数]子命令（全部实测通过）
merge — 合并
pdf_utility_kit.py merge a.pdf b.pdf 合并结果.pdf
# + a.pdf（2 页）
# + b.pdf（3 页）
# 合并完成 → 合并结果.pdf（共 5 页）split — 拆分
pdf_utility_kit.py split 样本文档.pdf ./out --pages "1-3,5" # 指定页各自成段
pdf_utility_kit.py split 样本文档.pdf ./out --pages each # 每页一个文件extract — 提取文本（pypdfium2，中文友好）
pdf_utility_kit.py extract 样本文档.pdf --pages 2 # 打印前 2 页
pdf_utility_kit.py extract 样本文档.pdf --out out.txt --all-pages实测输出（reportlab 生成、STSong-Light 中文字体的 3 页 PDF）：
----- 第1页 -----
必吃客测试文档 第1页
本段文字用于验证 PDF 文本提取功能。金额：1024.5 元。
文本已提取 → out.txt（187 字符）to-images — 每页转 PNG
pdf_utility_kit.py to-images 样本文档.pdf ./pages --dpi 150 --all-pagesinfo — 页数与元数据
pdf_utility_kit.py info 样本文档.pdf
# 页数: 3 加密: 否能力边界（诚实标注）
- 加密 PDF：merge/extract 等需
--password，密码错误会明确报错 - 扫描件（纯图片 PDF）extract 提不到文本，需先 OCR（不在本工具范围）
- 加水印/解密命令未实现，需 要时用 pypdf 手写或等后续版本
工作流建议
- 操作前用
info确认页数；合并后用info复核页数相加 - 中文文本提取优先用 extract（pypdfium2），不要用 pypdf 的 extract_text（部分 CJK 乱码）
- 转 PNG 的 DPI 默认 150，打印用 300
自检清单
- [ ] merge 后页数 = 各文件页数之和（实测 2+3=5 通过）
- [ ] 中文提取结果目视正确
- [ ] 加密 PDF 已提示需要密码，而不是抛裸异常
本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。
版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。
允许个人及企业内部免费使用、复制、修改，包括内部生产环境。未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。
输出规范
- 交付形态：执行结果 + 变更清单，说清动了什么、没动什么。
- 必含字段：执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。
- 留痕：产生副作用的执行必须写留痕文件（manifest / log），可回溯。
- 自检：失败项未列原因，或无可回滚路径，视为未完成。
版本：v0.1.16 · 出品：【律令】
反例对照（避开这些写法）
| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 高危动作直接执行 | 先 dry-run 预览，人工确认后再落盘 | 这一步做错了能不能一键撤回 |
| 失败只说「失败了」 | 失败项 + 失败原因 + 已回滚到什么状态 | 用户能不能据此判断要不要重试 |
| 重复执行已做过的动作 | 先查留痕文件，已完成的跳过（幂等） | 重跑一次会不会产生重复副作用 |
| 执行完不说改了什么 | 给出变更清单：动了哪些、没动哪些 | 用户能否核对结果 |
<!– WB-SELFCHECK v1 –>
交付前自检（必跑）
本包自带可执行自检脚本。在交付 / 打包 / 发布之前，必须运行并通过：
python scripts/selfcheck.py退出码语义（与本节末尾「退出码（脚本契约）」一致）：
| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 全部通过 | 可以交付 |
| 2 | 用法错误 | 检查运行路径，用包根目录下 scripts/selfcheck.py |
| 3 | 门禁未通过 | 按 FAIL 项逐条修好再交付，不要带病交付 |
| 4 | 环境问题 | 检查 Python 版本（需 3.8+）与入口脚本是否可运行 |
| 8 | 部分通过 | 无 FAIL，但有 WARN；建议先修警告项再交付 |
自检覆盖：SKILL.md 与 frontmatter（name·description）/ 合规声明（frontmatter license 或 ATTRIBUTION.md，二者其一即可——第三方转化包常以后者记录归属）/ 必备章节 / 打包卫生（禁止 .pyc·__pycache__·.bak·.zip）/ 脚本可编译 / 入口脚本 --help 可运行。<!– /WB-SELFCHECK –>
退出码（脚本契约）
| 码 | 含义 | 你要对用户说的话 |
|---|---|---|
| 0 | 成功 | 直接给结果，不解释过程 |
| 2 | 输入错误（缺参数 / 格式不对 / 文件不存在） | 「你给的 <X> 不对，需要 <Y>」—— 说明正确格式，不要猜默认值硬跑 |
| 3 | 鉴权/授权失败（密钥缺失、无权限） | 「需要你先提供 <凭据>」—— 说明去哪里拿，不要跳过鉴权 |
| 4 | 服务/环境失败（网络不可用、依赖缺失） | 「这一步依赖 <X> 不可用」—— 给出替代路径或降级方案 |
| 8 | 部分成功（有成功项也有失败项） | 「N 项成功、M 项失败」—— 逐条列出失败项与原因，不要只报总数 |
脚本退出非 0 时：不要静默重试。先把该码对应的话告诉用户，再决定是补齐输入重试、还是换路径。
状态与断点
- 多阶段流程在执行目录写
outputs/.state.json，记录「当前阶段 + 已完成产物路径 + 时间」。 - 每个阶段结束后写一次；中途中断后重启，先读该文件，从断点阶段继续，不从头重跑。
- 状态文件只记阶段与产物路径，不记对话内容、不记敏感数据。
- 发现状态文件与实际情况不符（产物已不存在）时，以实际产物为准并重置状态。
