# AI 回答里的富内容：块和组件

> source: 想法/草稿/AI回答里的富内容-块和组件.md

## 问题

> ChatGPT 的聊天页面是怎么做到用这么多富文本内容的（图片网格、时间线卡片、表格、编号拆解、示意图、可拖的图表、轨距对比图）？想做到这样，用什么技术、文件怎么组织？

## 它大概是怎么做的

- 模型输出的不是 HTML，而是 **Markdown + 结构化的「块」**：普通段落照常是 Markdown，非文字的东西是带类型的数据（图片组、实体卡、引用、图表规格、小部件）。
- 前端有一张 **类型 → 组件** 的表（React），流式收到一块就渲染一块。模型只决定「放什么、填什么数据」，长相由组件决定，所以一整篇看起来风格统一。
- 图片来自搜索工具：模型给关键词或实体，后端返回图片和来源，前端排成 1+N 网格、带「+10」角标。引用小胶囊（`thepaper.cn +1`）同理，是搜索结果的 id，不是模型写的链接。
- 可拖的图表、示意图：要么是预设的图表组件吃一份 JSON 规格，要么是模型现写一段代码在沙箱 iframe 里跑。截图里的向心加速度柱状图是前者的样子。
- 关键的三件事：**块只放数据**、**组件集中维护**、**数据可校验**（比如 v²/r 算出来对不对）。

## 放到 me.api 上

这套思路网站已经有了，`site/src/live/blocks.ts` 就是那张表（vim-try、echarts、mermaid、storyline、atlas……12 种），`src/components/blocks/` 一种一个 Astro 组件，构建时逐块 check。缺的只是这次截图里那几种「讲解型」块：

| 截图里的东西 | 对应的块（想法） | 字段 |
|---|---|---|
| 顶部三图 + 角标 | `gallery` | 图片路径、说明、来源 |
| 年代 + 缩略图 + 一段话 | `timeline` | 年份、标题、图、正文 |
| `YZ 25G 3XXXXX` 拆解 | `decode` | 原串、每段的值和含义 |
| 机车 + 客车示意 | `diagram`（SVG 组件）或 mermaid | 节点、标签 |
| 拖速度看 a=v²/R | `slider-chart` | 公式、变量范围、刻度；构建核对几点数值 |
| 1067 vs 1435 并排 | `compare` | 两边的值、单位、说明 |

文件组织不变：文章 `文章/<slug>/index.md` 里写块，图片放同目录或 `media/`，原图 `素材/`；新块先写 `todo-block`，再加 blocks.ts 一行 + 一个组件。

## 每篇的互动都不一样怎么办

> 我的博客可能每篇文章的富内容块、交互方式都不一样。

分三层，按「用了几次」往上升：

1. **一次性**：这篇自己的组件，代码和文章放一起（`文章/<slug>/xxx.ts`），文章里只写一个通用块 `widget`，块里是 `@src xxx.ts` 加这一篇的数据。组件导出 `mount(el, data, kit)`，网站现在的「玩具」（原来叫活文章）（`src/app.ts` 里 `import('/live/'+id+'.js').then(m => m.mount(...))`）已经是这个约定，只是现在是整页、代码放在 `site/src/live/`。
2. **用到第二、三次**：抽成 blocks.ts 里的一种块，有字段和 check。
3. **共用的底子**：不是块，是 `kit`：主题色、字体、滑块/按钮/播放条（`algorithm-ui.ts` 已经是一部分）、数值格式化。每篇长得不一样，但都从这里拿零件，所以看起来还是一家人。

要守的线：文章 md 里仍然只有数据；组件按需加载（只有用到的那篇才下载它的 js）；要完全放开（任意 HTML、第三方库）就放进沙箱 iframe，和主站样式隔开。

## 走到哪了

2026-11-16 做了第一层：`widget` 块。

- 写法：`@src 名字.widget.ts`、`@title`、`@alt`（必填，没脚本和纸面时看到的就是这句），后面是这篇的数据。
- 组件在 `文章/<slug>/名字.widget.ts`，导出 `mount(el, 数据, kit)`，可以再导出 `check(数据)`；不能 import，零件从 `site/src/live/kit.ts` 拿（滑块、按钮、播放条、建 SVG、读主题色）。样式写同名 `.widget.css`，选择器限定在自己身上，也过 design-lint。
- 构建时编译、查 `mount`、跑 `check`，有一处不过就停；只有公开文章的组件会从 `/widget/…` 发出去，块滚进视口才下载。
- 样板是向心加速度滑块（`site/test/fixtures/widgets/curve.widget.ts`），`check` 会核对文中写的 v²/R。

上面两个问题（怎么检查、文件怎么进构建）就这样答了。

## 还没想通的

- 图片怎么来：网站没有搜索工具，图要作者自己拍/找，版权和来源字段怎么定？
- `slider-chart` 要不要做成通用（任意公式）还是每个场景一个组件？现在的答案是先每个场景一个 widget，用到第二次再说。
- 第三层（iframe、第三方库）还没做，等第一次真的需要 three.js 这类东西时再加。
