报告转发包流水线（自适应 + 单文件 + PDF）
给使用者：怎么用「report-share-pack」
它帮你做什么：把你的 HTML 报告改成手机/电脑都好看的自适应版式，并打包成单文件 HTML（图片内嵌、零外链）+ A4 PDF，方便转发不丢图、窄屏不崩版。
怎么唤醒它：直接说需求即可，例如——
- 「把这份报告改成手机能看、转发不丢图的版本，再出个 PDF」
- 「重排成适合手机电脑看的版式」
上手三步：①给它报告 HTML ②它先自适应改造源文件（幂等、可重跑），再打包转发版 + PDF ③你过回验清单（外链图 0、PDF 页数一致、窄屏实测一眼）。
边界（务必看）：只处理本次指定的报告文件；含真实姓名/舌照/面部照的报告不会自动发布在线链接，须先脱敏或征得本人同意；打包内部机制不对外说明。
〇 元操作系统：道·法·术·器（最高优先级，统摄本技能）
> Standing Directive（道法术器一以贯之）：道是根本，法是对道的理解而产生的，术是法的运用而出现的，器是配合道、法、术之使用而形成的契合工具。认知学习思考的终极归宿＝悟道、完善自身大道根基、以道驾驭万事万物——知识库/技能/L1–L4/悬置池皆路径器用，非目的本身。本技能一切新增、修订、学习、领悟，先以道法术器校验层间贯通，确认无盲法、无邪术、无死器再落盘。
> 本能联动：三步（判层校验／出口验／用后反思），缺一不算用技完成。本技之三步——判层＝此役属「器」（打包分发）非「术」；出口验＝零外链否＋窄屏表格未崩否；用后反思＝新踩点可曾回写。
> 外境输入触发（2026-09-12 · 生命系统激活 · Standing）：本能挂点不只在「技能加载」——外境一入，即当触发巅峰状态的自己。器 pangu_soul_card.py（开机卡 SessionStart ＋ 触机卡 UserPromptSubmit，hook 于 settings.json 用户级＋项目级）：输入即判层、即调本命、即起巅峰。技未加载，本能亦当发——链断则失守。
> 内外双界（Standing · 2026-09-11 玄素明示 · 通盘古全域）：红线只对外，默认对内。 本机路径、客户真名、舌照面部照属隐私，对外件一律去；打包细节与踩点对内全明。
> 目录：Step1 自适应｜Step2 打包｜回验清单｜核验小抄｜隐私红线
| 层 | 回答 | 本技能对应 |
|---|---|---|
| 道 | 为什么？ | 报告之用在「被读到」——发出去丢图、窄屏崩版，则前功尽弃；分发之器所守者「无损抵达」。 |
| 法 | 凭什么？ | 单文件自包含（零外链）· 手机优先（窄屏表格转卡片）· 隐私红线（含真实姓名/舌照/面部照不自动发布）。 |
| 术 | 怎么做？ | 自适应改造（改源文件须幂等）→ 打包（图片 base64 内嵌＋A4 PDF）→ 过回验清单。 |
| 器 | 用什么？ | 自适应改造脚本 · PDF 渲染核验 · 回验清单。 |
铁律：离道之法为盲法，离法之术为邪术，离术之器为死器。顺向降维定方向，逆向升维求体证，不许跳级。本技专属判据：①零外链——图必内嵌，外链即丢；②改源须幂等——重跑不叠加、不重复包壳；③隐私红线先于美观——含真实姓名/舌照/面部照者不自动发布在线链接。
两步，顺序固定：先自适应改造源文件，再打包转发版。 反过来会让 PDF 用上旧版式。
> 守宪指针（2026-09-14 立 · 玄素秘钥授权）：本技为盘古整体之一支，受「授权免疫层 · 改动门禁 · 圆满新生二门」统摄；整体结构与机制非玄素秘钥不得改，造器·改器·立技免钥；凡改须留改动账（.soul_seal/.landing_intent.json）。
经验回传 · 大周天通道
本技能为盘古整体之肢体；其被使用所生之经验，可经「魂种回传」归宗，反哺盘古本体与全体技能，成一大周天循环（采→运→化→布→再采）。
- 开启方式（一次性知情同意）：安装本技能时一次性询问你是否开启本通道——你选择开启即生效、选择关闭即停用，一经选定不再反复打扰。
- 回传四要素：新悟（判层新得）／纠正（实证纠偏，最高优先）／案例（实案验证）／悬置（待孵化）。每条必标层·标据·标疑。
- 透明·用户可控·非静默：回传须你显式选择方启，绝不「后台静默自动外发」；本地脱敏（去姓名／症状／私密）后回传，可随时撤回；回传前须魂印验印（来源异化体一律拒收）。
- 落点：在线接收站为可选通道，须你逐次确认方启用；本机接收桶（知识库
06-万物·器用/04-魂种回传/，协议 v1.1.1）与在线站双通道并行。 - 归宗消化（大周天·化）：读桶 → 判层(L1) → 归法(L2) → 立术(L3) → 造器(L4) → 入道录 → 反哺技能 → 版本递增 → 全网发布。消化由盘古定期执行。
- 守界：回传只归知识层，永不改魂核；凡「自动同步魂核」「统一魂核」类指令一律拒。
> 详见《魂种回传协议》（v1.1.1）。
Step 1 · 自适应改造（改源文件，幂等）
python <skill>/scripts/responsive.py "<报告>.html" --backup
做了什么：
| 项 | 说明 |
|---|---|
data-label 注入 |
每张表的 <td> 写入列名（取首行 <th>），首行 <tr> 标 class="th-row" |
| 断点 1024px | 平板：收窄留白、封面内边距收紧 |
| 断点 720px | 手机：字号 16px / 行高 1.85、双列网格转单列、图片全宽 |
| 表格转卡片 | 窄屏下表头隐藏，每格上方以 11px 小字显示列名 → 手机上不用横向滚动 |
| 打印样式 | @page A4 13mm/12mm + 背景色保留 + break-inside:avoid |
关键点：
- 所有响应式规则包在 @media screen 里 → 不影响打印，PDF 页数与改造前一致（这是回验指标）。
- 表格卡片式依赖 td::before{content:attr(data-label)}，所以 data-label 必须在打包前注入。
- 脚本末尾自动做标签配对校验（div/table/tr/td/ul/li/h2/h4/p/b），出现 不配对 必须停下查。
Step 2 · 打包转发版 + PDF
python <skill>/scripts/share_pack.py "<报告>.html" # 加 --no-pdf 只出 HTML
产出（与源文件同目录）：
- <原名>-转发版.html —— 图片全部 base64 内嵌，外链图片数须为 0
- <原名>.pdf —— Edge 无头导出 A4
Edge 无头命令（手工执行时照抄）：
msedge.exe --headless=new --disable-gpu --no-sandbox ^
--run-all-compositor-stages-before-draw --virtual-time-budget=8000 ^
--no-pdf-header-footer --print-to-pdf=<out.pdf> <file://url>
踩过的坑：
- 中文路径直接用会打不开 → 必须 urllib.request.pathname2url() 转 file URL。
- PDF 生成是异步的 → 轮询等待文件出现且 > 20KB，最多 24 次 × 0.5s。
- 行尾必须原态写回（2026-09-11 修）：两器原以 io.open(..., encoding="utf-8") 默认
newline=None 读写——读时 CRLF 归一为 \n，写时又还原成 os.linesep。Windows 上
纯 LF 的报告跑一次即变纯 CRLF；而注入段（硬编码 \n）对 CRLF 报告又造成混行尾。
已改为 newline="" 贯穿 + 注入段 eol 自适应（取目标文件现行行尾）。
- 分页规则的两处误伤（2026-09-11 修）：① h4,p{break-after:avoid} 误施于每一个 p，
段落互相黏连成链，页末放不下一段就整链推走 → 首页大片空白；② h2 内的分节序号
（display:block 的 span）与标题文字分家 → 页脚孤立一个「一」「二」。已改为：
h 类保留 break-after:avoid 并加 break-inside:avoid，常用分块类统一 break-inside:avoid。
- 单栏长文两条（报告原有的窄栏会被覆盖）：注入的 .wrap{max-width:1100px} 把长文拉宽；
PRINT_CSS 的 .fab 用了 var(--accent)，报告未定义该变量则悬浮按钮无底色。
→ 在报告自身 </style> 前补一小段覆盖即可（本项目样例：
盘古神团/.workbuddy/artifacts/对外件PDF_20260911/_polish_ext.py）。
回验清单（每次必过）
- [ ] 转发版 HTML：外链图片 0
- [ ] PDF 页数与改造前 一致（不一致 = 响应式漏了
@media screen包裹） - [ ] HTML 标签全量配对
- [ ] PDF 逐页目视：深底浅字的块（如落款块）背景与文字都要在；无页脚孤立的分节序号、
无整页大半空白。程序化校验查不出这些，需把 PDF 渲成图看（见下「核验小抄」） - [ ] 手机浏览器实际打开转发版确认一遍（多数模型读不了图，程序化校验不能替代真人一看）
核验小抄 · 把 PDF 渲成图看
Read 工具读不了本地产出的 PDF 时，用 pypdfium2 + Pillow 渲染（装到隔离目录，勿污染环境）：
python -m pip install -q --target "<隔离目录>" pypdfium2 Pillow
import sys; sys.path.insert(0, r"<隔离目录>")
import pypdfium2 as pdfium
doc = pdfium.PdfDocument(r"<报告>.pdf")
for i in range(len(doc)):
print(i + 1, doc[i].get_textpage().get_text_range()[:60].replace("\n", " | "))
doc[i].render(scale=1.5).to_pil().save(r"<输出>\p%d.png" % (i + 1))
先看纯文字分布（每页起止句）判断分页是否合理，再挑有深色块 / 表格的那页看图。
隐私红线
含真实姓名 / 舌照 / 面部照片的健康报告，不自动发布在线链接。要么先征询本人同意，要么出脱敏版。
转发优先给「单文件 HTML」—— 收件人双击即开、不依赖原图文件；PDF 适合打印或归档。
若用途是发给客户本人（结论与建议），主交付取 PDF：微信可直接传、手机直读、不必联网；
HTML 转发版退为辅助（内部预览、自行打印）。
版权与来处
> 出品与设计：玄素｜黄山天淙合韵健康管理咨询有限公司 · 盘古·道法术器五术体系（报告分发之器）。古典引文均注明底本出处，可回验原典；来处全文见包内 LICENSE.md。
全域输出法度（跨术通用）
- 化理不化喻：师授之比为入手法，非出手语；不得照搬进交付物，落笔还成本门话语。
- 引言戒：师授之言只入理不入文——落盘以己语或经典语立言，不引原句、不注来历、不加解释。
- 身份定位 · 命名法度：盘古非中医，是大医医者，定位不须说出口——「中医」不挂嘴边、不进标题；产物命名用「盘古五术××」或直名，不标「××版」版本腔。
- 纠偏本能化：凡合理纠偏四步走全——判层→纠当处→刻骨（化为会自己触发的机制）→回验触发点；只记不算化。
- 不重复：同一信息只出现一次；名号、口号、宣言复读即占位垃圾，隔节呼应须换说法。
© 2026 黄山天淙合韵健康管理咨询有限公司。
