doc-trio-paylisted

# 文档格式一条龙（一次付费 7 天不限次） 同一份内容要交成三种格式：给领导的是 Word、发出去的是 PDF、里面那张表还得单独给一份 Excel。 本 Skill 一次出齐，且**三种格式用同一套排版规范**。分两段： **先免费诊断**（只读，不产出成品），**再取授权执行转换**（按次计费，在你本机完成，材料不出本机）。 > **为什么需要授权**：转换动作需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**（不联网即可验证真伪与有效期）， > 但**没有有效授权就不执行转换**——这是服务的一部分，不是限制。 --- ## 第 0 步 · 前置检查（必做，先判这个工具适不适合你的材料） 在调用任何服务之前先确认： | 检查项 | 判定 | |---|---| | 输入类型 | **仅 .md / .txt / .csv / .xlsx**。`.docx`/`.pdf` **读不了** —— 本工具是**生成器**，不是格式互转器。要出成品：把文字复制出来存成 .md/.txt；文档里的表另存为 .xlsx 或复制成 Markdown 表格 | | 要不要出 Excel | **材料里得有表格**。纯文字材料出 Excel 没有意义（一张只有段落的表），诊断会直接判 ❌ | | 要 PDF 吗 | 本机得有中文字体（Windows 自带 simhei 即可），否则用 `--font` 指定 | | 期待是否合理 | PDF 里**没有行内粗体**（标记符会被去掉、只留文字）；**不嵌图片**；不生成可点击链接。先跟用户讲清楚 | | 是不是"一份材料要多种格式" | 这是本工具的核心场景。只要一种格式、且内容简单，先跑免费诊断看结论 | **只有第 0 步谈过，才进入第 1 步。** --- ## 第 1 步 · 免费诊断（check，只读，不收费） ```bash python scripts/doctrio.py check <材料> --report 诊断.md ``` 诊断会逐项给出：材料里有什么（标题/段落/列表/表格计数）、**三种格式分别能不能出**、 **出之前要知道的**（会丢什么、哪里会不一样）。其中三条别处看不到： - **哪些字符本机 PDF 字体里没有**（例：半角 `¥` 在 SimHei 里没有字形，PDF 里会是空白）； - 列表符号在 PDF 里会用什么字符（由字体能力决定，不是随便挑的）； - 表格超过 6 列时 Word/PDF 会压缩列宽。 **先把诊断结果拿给用户看**，确认要出哪些格式，再进入付费环节。 --- ## 第 2 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/doc-trio-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` 可选：带上则这份授权**绑定