排版台 · Typeset
复杂的回答,一页看清。
你大概遇到过这种事
问了一个不算小的问题,agent 回了一大段:有结论、有对比、有数据、有注意事项。
于是你开始翻:
- 一共五六屏,你要的那个数字埋在第三屏中间
- Markdown 表格一宽就错位,几组数据没法并排比
- 全篇一个字号一个颜色,重点和备注长得一模一样
- 想回头核对一下,又得往上滑回去
信息其实都在,只是没排过。纯文本和 Markdown 能表达结构,但表达不了轻重。
三种读法,差别在哪
| 读法 | 层级 | 对比 | 一眼抓重点 |
|---|---|---|---|
| 纯文本 | 靠空行 | 靠上下翻 | ✗ |
| Markdown | # 级标题 |
表格,宽了就错位 | 勉强 |
| 排成 HTML 的一页 | 字号、色块、分区 | 并排、进度条、图表 | ✓ |
HTML 能做的事,Markdown 天生做不了:同一页里给出轻重。关键结论占一块版面,补充说明收进边栏,数据变成条而不是一串数字。
排版台怎么做的
它把「渲染」和「对话」拆开,放在同一个窗口里并排:
┌──────────────────────────────┬─────────────────────┐
│ 原始对话(一个字都不删) │ 排版台 │
│ │ ┌───────────────┐ │
│ 你:把这三家的方案对比一下 │ │ 结论 │ │
│ 助手:好,我排了一页 → │ │ ━━━━━━━━━ 62% │ │
│ │ │ 对比表 · 三条 │ │
│ 细节都在左边,随时能对 │ │ 注意:仅限… │ │
│ │ └───────────────┘ │
│ │ ‹ 3 / 12 › │
└──────────────────────────────┴─────────────────────┘
三个要点:
- 左右对照 —— 左边是完整原文,右边是这一轮排好的一页。想核对随时看左边,不用来回滚。
- 一页装下 —— 这一轮的关键结论、数据、对比、注意事项,都收进同一屏,不用翻。
- 留档可回翻 —— 每一轮一页,
‹ ›翻得回去。上午的结论,下午还在。
至于"哪些是关键信息" —— 由写页面的一方来决定(通常是助手按你的约定把要点排进去,也可以自己写)。排版台负责把它稳稳地呈现出来,不抢戏。
快速开始
1. 安装 —— 用 DSH 的插件管理器,别手写 profile 的 package.json:
plugin_manager install_bundle → target 指向本仓库绝对路径
2. 刷新页面。 右栏标签条出现「排版台」,侧栏底部也多了「打开排版台」。
3. 写第一页:
mkdir -p ~/.dsh/html-panel/<会话ID>
cat > ~/.dsh/html-panel/<会话ID>/<时间戳>.html << 'EOF'
<!DOCTYPE html><html><body>…</body></html>
EOF
文件名按时间排序即页码。写进去,右栏两秒内出现新的一页。
想让助手每次都自动排一页?写进工作区的
AGENTS.md—— 一次约定,长期有效。
功能
| 功能 | 说明 |
|---|---|
| 右栏标签 | 与内置的浏览器 / 文件 / 终端并排,不遮挡对话 |
| 左右对照 | 原文留在聊天区,排版页在右栏,随时对照 |
| 多页留档 | 全部历史按时间排序,‹ › 翻到任意一页 |
| 自动跟随 | 2.5 秒轮询,新页自动出现;手动翻历史时不会被拽回最新 |
| 两种数据源 | 优先读文件;同时兼容旧会话里的 ```html 围栏,迁移不丢历史 |
| 失效提示 | 最新回复还没对应页时,明确说「显示的是较早一页」,不假装同步 |
| 主题跟随 | 外壳用宿主主题 token,深浅色自动适配 |
| 自包含页面 | 面板给 HTML 加沙箱与 CSP,不需要也不允许引外部 CDN |
安全边界
模型生成的 HTML 是不可信内容,两层隔离:
| 层 | 做法 | 效果 |
|---|---|---|
| iframe | sandbox="allow-scripts",不带 allow-same-origin |
页面活在不透明源:碰不到宿主 DOM、cookie、localStorage |
| CSP | connect-src 'none' · frame-src 'none' · form-action 'none' · base-uri 'none' |
无法 fetch 外传、不能嵌 iframe、不能提交表单 |
已实测验证:window.parent.document → 被拦截;fetch('https://…/steal') → 被拦截。
想引 CDN 就得放开
connect-src—— 那等于允许模型生成的页面往外发数据。这个护栏是故意留的,不建议改。
页面要交互时用面板提供的桥:
<button onclick="DSH.toAssistant('按这个结论,继续下一步')">让 AI 继续</button>
边界与限制
- 页按会话归属:
~/.dsh/html-panel/<会话ID>/,不同会话互不串味 - 轮询而非事件订阅:回复生成中会慢半拍(2.5 秒内)
- 页面必须自包含:不能引外部脚本 / 样式 / 字体
- Host 需能读
~/.dsh/html-panel/,沙箱策略极严时可能读不到
常见问题
页面空白?
多半是文件没写进对应会话的目录。检查 ~/.dsh/html-panel/<会话ID>/ 下有没有 .html。
新回复没出现?
看标签栏的「更新于」时间。时间没动 = 这一轮确实没产出页;时间在动但内容没变 = 页码被钉住了,按 › 回最后一页。
能放图表吗? 能,手写 SVG 或 CSS 进度条。不引 CDN 是设计选择,不是缺陷。
为什么叫排版台? 它不预览「一段代码」,它把每一轮排成一页放上台子,还能往回翻。名字取的就是这件事。
页面设计语言
页面按页型分两种脾气:叙述页(编辑纸感)与数据页(瑞士网格)。
判定表 design/page-types.md,令牌与规则 design/设计语言.md,
模板直接复制:design/templates/narrative-a.html / design/templates/data-b.html。
页面在 <html> 上声明 data-page-type="narrative|data" data-typeset="v1" ——
壳据此显示「叙述页 / 数据页」,读者因此知道这页为什么长得不一样。
两种页型实际长这样(点图可看完整样例):
| 叙述页 · A 编辑纸感 | 数据页 · B 瑞士网格 |
|---|---|
![]() |
![]() |
截图与样例都在 design/:screenshots/ 是图,demo/ 是可直接打开的 HTML。
改了 demo 之后重截:node design/screenshot.mjs(820 pt 宽、2× 缩放,与右栏一致)。
令牌冻结在页面里(TYPESET v1),宿主不覆盖颜色;改审美 = 发 v2 模板,旧页不追改。
技术说明
注册契约、数据通道、路由与排错记录:docs/技术说明.md。 一句话版本:右栏标签是两阶段注册(先注册标签类型,再注册标签体),少一步就是空白面板。
许可
MIT


No comments yet. Be the first to write one.