doc-digest-paylisted

# 长文档读薄 · PDF 提炼摘要（一次付费 7 天不限次） 把读不完的长文档，变成一份能直接转发的提炼稿。本 Skill 分两段： **先免费诊断 + 试读**（只读，不动你的文件），**再取授权执行提炼**（按次计费，在你本机完成，文档不出本机）。 > **为什么需要授权**：提炼动作需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**（不联网即可验证真伪与有效期）， > 但**没有有效授权就不执行提炼**——这是服务的一部分，不是限制。 --- ## 第 0 步 · 前置检查（必做，先判值不值得用这个工具） 在调用任何服务之前先确认： | 检查项 | 判定 | |---|---| | 文件格式 | **仅 .txt / .md / .docx / .pdf**。老版 .doc → 让用户先另存为 .docx 或 .txt，再继续 | | 是不是扫描件 | 拿不准就先跑 `scan`：**提不出文字会明确报「没有文字层」**，不会静默给一份空稿 | | 文档够不够长 | **1500 字以下直接劝停**：这个体量自己读比提炼快。本工具解决的是"读不动"，不是"读得完" | | 期待是否合理 | 本稿**不改写、不概括**——它摘的都是原文原句。要"用一句话总结全文"，那是 AI 通读本稿之后的活，不是本工具替它做的；「表格和图片里的内容」不在覆盖范围，先跟用户说清楚 | **只有第 0 步谈过，才进入第 1 步。** --- ## 第 1 步 · 免费诊断 + 试读（scan，只读，不收费） ```bash python scripts/docdigest.py scan <文件> --preview 3 --report 诊断.md ``` 诊断会告诉用户：多少页、多少字、多少个章节块、章节结构长什么样、**前 3 页原样试读**， 以及解析过程中发现的限制（无文字层 / 缺映射 / 无分页信息等）。 **先把诊断结果拿给用户看**，确认他要继续，再进入付费环节。 --- ## 第 2 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/doc-digest-license Content-Type: application/json {"machine_fp":"<本机指纹串，8–128 位字母数字/连字符，可省略>"} ``` **首次调用一定拿到 `402 Payment Required`** —— 这是设计，不是错误。响应里带： - HTTP 头 `Payment-Needed`（base64url 编码的账单） - 响应体 `payment_needed` / `payment_needed_token` / `amount` / `out_trade_no` > `machine_fp` 可选：带上则这份授权**绑定这台机器**，换机器需重新授权。省略则不绑定。 > 本机指纹：`python scripts/license_check.py fingerprint` ## 第 3 步 · 处理 402（完成支付） 把 `payment_needed_token`（或整个 `Payment-Needed`）交给**支付宝 AI 付**完成授权支付。 支付完成后你会拿到一个 **`Payment-Proof`** 凭证。 **不要自己伪造、不要跳过这一步** —— 服务端会拿它去支付宝网关做真实校验