用途
Interactive Research Report 是一个建站技能,目标是把一份深度报告(主题不限,如芯片、猪周期、能源、物流、医药等)转成一个可交互、可下钻、带动画封面、具备编辑级排版质量的单页研究网站。
主要能力
- 三层规范结构:不变层(字体/配色/版式/组件,需逐字照搬,见 DESIGN.md 与 assets/)、抽象层(封面由“主题原子”生成、图表按“数据形态”选择,见 COVER.md 与 CHARTS.md)、方法论层(调试循环与复盘清单,见 QA.md)。
- 封面四态引擎:A 无限对象递归、B 物理实体分层拆解、C 工程蓝图线框、D 拆解加开箱动画(冲击版)。四态是同一物理对象的不同视图。
- 图表选型表:按数据形态而非图表库选型,例如产能/规模爬坡用行业实体等距单元、实体流向结果用命运流、历史事件用墙图时间轴、多窗口多维比较用矩阵热表、分层价值链用 2.5D 价值堆叠、概率判断用赔率板等。
- 编辑级组件:斜体衬线导语、“FROM THE RECORD”引文块、“ANALYST NOTE”注释、杂志三栏概念卡、图表框三件套(衬线标题 + 等宽副标题 + 来源行)。
- 交互三件套:图内每个数字可点击打开深色下钻卡(数值 + 依据 + 带日期来源);IntersectionObserver 入场动画;prefers-reduced-motion 下显示静态完成帧。
- 单文件打包:通过 templates/bundle.py 编辑文件清单即可打包,打包后在 file:// 下复验。
使用方式
- 输入约定(开工前与用户确认):一份报告 md/pdf 作为唯一事实来源;结构化数据表(csv/json/表格)编译为 js/data.js 暴露 window.RPT;来源登记表带来源与日期,编译为 js/sources.js(K1–Kn 锚点表),无日期的来源需分级;确定主题原子(该行业最物理、可分解、可即时识别的实体);确定语言(默认机构研究英语、句首大写)与交付宽度基线(默认 1680/1280 双验收)。
- 构建流水线:数据层 → 骨架(skeleton.html + theme.css + fonts.css + utils.js + 本地 d3/topojson)→ 章节规划(封面 → 执行摘要 → 概念卡 → 历史/机制 → 现状 → 参与者 → 结论 → 附录 → 来源)→ 封面 → 图表(每张图走 QA 循环)→ 右侧常驻栏(随滚动切换画布,可选但强烈建议)→ 全量回归(通过 QA 闸门后打包单文件并在 file:// 复验)。
- 规模参考:完整站点约 20 个 js 模块、4000–6000 行;最小可行版(封面 B + 5 张签名图 + K 表)约 1500 行。每个图表模块是独立 IIFE + 宿主 div,单点失败不影响其他模块。
适用场景
适合需要把一份深度研究报告转化为可发表级别、可交互探索的单页研究站点,尤其是希望呈现行业物理结构、历史机制与概率判断的机构研究类内容。
限制与约束
- 字体、配色、版式、组件为硬约束,不得即兴改动;字体仅 ET Book 衬线 400/700 与 Menlo 等宽全大写;禁用外部字体链接。
- 红线:不得使用左侧色条加底色的引文卡、顶部色条圆角卡、超过一屏高的卡片、自动网格产生的 2+1 孤列、无语义的彩虹配色。
- 严禁强制绘制非图表内容(数字墙、文本框决策树、同异案例桥图、图标传导链等已退役,须用对应替代件)。
- 图表须通过“去文字识别测试”“主题替换测试”“假图表测试”;仅编码单列数字或单一序数关系的图应降级为正文或表格。
- 每张图完成后须走“截图 → 评论 → 修复 → 复验”循环;QA 闸门要求 node --check 全过、1680/1280 双宽度零页面错误/零控制台错误/零横向溢出(英文站点零可见残留中文)、字体检查通过、减少动态下动画静态化、标签零重叠零越界、单文件 file:// 零错误,并抽检 5 个数字下钻可回溯到 sources.js 与原文。
文件参考
DESIGN.md、CHARTS.md、COVER.md、QA.md 四份规范;assets/theme.css、assets/fonts.css;templates/utils.js、templates/skeleton.html、templates/bundle.py;references/gallery/(每种模式的成品截图);references/BUILD_LOG-example.md(完整案例 V1→V8.4 构建日志)。