深度研究多维对比交互 HTML可打印 PDF分册合集

深度研究·多维度成果生成器(research-dossier)

把跨对象、多维度的宏观研究,一键渲染成「交互网页 + 精装 PDF + 单对象分册 + 维度合集 + 附录」

一、这个 skill 是做什么的

深度研究·多维度成果生成器专门承接"研究 N 个对象、按固定维度横比"这类重活。它把研究内容当成结构化数据,和渲染彻底分开——只要你把每个对象整理成一份结构化的数据(字段自定),它就能自动产出一整套可直接交付的成果。

一套成果包括:主交互网页(可点按钮切换国家/维度、带 SVG 世界地图)、印刷级 PDF(用 reportlab 流式排版)、单对象分册(每个对象一份独立 HTML)、维度横向合集(按维度把所有对象拉成对比表 + 共性提炼),以及四类附录(总名录 / 事件年表 / 地理分布图 / 文献清单)。

它覆盖的维度框架是:地理 / 经济 / 军事 / 政治 / 文化 / 外部 六维,外加时间线、关键事件、原因拆解(根本/直接/偶然)、历史启示。

二、什么时候用它

当你要做"大而系统"的研究或对比分析,并希望产出可交互网页 + 可打印 PDF + 分册时,就说这句话触发。典型原话信号:

它偏"成果渲染"。研究素材(事实、数据)需要你先提供或先调研清楚,它负责把结构化内容漂亮地变成网页和 PDF,而不是替你凭空查资料。

三、前置条件 / 准备

四、具体用法(步骤)

  1. 拆内容:按上面字段把每个对象写成结构化数据文件(Python dict / .py)。
  2. 渲染 HTML(build.py):用纯字符串模板 + json.dumps(data) 内嵌为 const CIVS=...。它会自动生成:主交互页(维度按钮切换 + SVG 等距投影地图)、单对象分册、维度合集、以及供 PDF 复用的 print.html 长文档。
  3. 渲染 PDF(pdf.py):用 reportlab 的 Platypus 流式排版,中文用 STSong-Light 字体;表格宽度之和须 ≤ A4 可用宽(约 493pt);地图/示意图用 reportlab.graphics.shapes 画。
  4. 交付:用 present_files 给出主交互 HTML 与 PDF,并说明子目录结构。
⚠️ 三个"黄区"易错点(它已内置规避,但你知道原理更好):① CSS/JS 里的花括号在 f-string 中要写成 {{ }},只有占位符用单括号;② 中文粗体要用 STSong-Light 注册字体族,否则 <b> 会报错;③ 画多边形用 shapes 里的 Polygon,别用 Canvas 的 drawPolygon(Canvas 没有这方法)。

五、可直接照用的示例

你直接对 AI大模型或AI智能体 说:帮我把"五大文明古国"按地理/经济/军事/政治/文化/外部六个维度做一份系统对比,要能网页交互看,也要能打印成 PDF,还要每个文明单独一份分册,外加事件年表和文献清单。

AI大模型或AI智能体 会:先和你确认维度字段与对象清单;你把每个文明的内容整理成结构化数据后,它生成主交互网页(带可切换维度的按钮和世界地图分布)、印刷级 PDF、5 份单对象分册、维度横向合集,以及含总名录/年表/分布图/文献清单的附录,最后用 present_files 把主网页和 PDF 交给你。

你直接对 AI大模型或AI智能体 说:研究内容我已经整理成 data_part1.py 和 data_part2.py 了,直接渲染网页和 PDF 吧。

AI大模型或AI智能体 会:import 这两个数据文件拼接后,跑 build.py 出网页、pdf.py 出 PDF,自动处理中文粗体与 A4 表格宽度,把成品放到输出目录并交付。

你直接对 AI大模型或AI智能体 说(进阶/可选):我想自己本地跑渲染脚本看看。

AI大模型或AI智能体 会:给你下面的命令,并说明它在做什么——先用受管 Python 建个隔离环境并装 reportlab(PDF 渲染引擎),再分别运行网页和 PDF 的生成脚本:

# 建隔离环境并安装 PDF 渲染所需的 reportlab python -m venv .venv .venv\Scripts\activate pip install reportlab # 生成交互网页与各分册 python build.py # 生成印刷级 PDF(中文用 STSong-Light 字体) python pdf.py

六、常见注意 / 避坑

七、相关 skill / 延伸

← 返回 SKILL 库