DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Krislu1221 /

Krislu1221/dsh-html-panel

Verified

排版台:把每轮回答排成一页 HTML 放在 DSH 右栏,可翻历史。 · Typeset: every answer set as a page in the right sidebar, with paging back through history.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@cb560843

排版台 · Typeset

复杂的回答,一页看清。

排版台


你大概遇到过这种事

问了一个不算小的问题,agent 回了一大段:有结论、有对比、有数据、有注意事项。

于是你开始翻:

  • 一共五六屏,你要的那个数字埋在第三屏中间
  • Markdown 表格一宽就错位,几组数据没法并排比
  • 全篇一个字号一个颜色,重点和备注长得一模一样
  • 想回头核对一下,又得往上滑回去

信息其实都在,只是没排过。纯文本和 Markdown 能表达结构,但表达不了轻重。

三种读法,差别在哪

读法 层级 对比 一眼抓重点
纯文本 靠空行 靠上下翻 ✗
Markdown # 级标题 表格,宽了就错位 勉强
排成 HTML 的一页 字号、色块、分区 并排、进度条、图表 ✓

HTML 能做的事,Markdown 天生做不了:同一页里给出轻重。关键结论占一块版面,补充说明收进边栏,数据变成条而不是一串数字。

排版台怎么做的

它把「渲染」和「对话」拆开,放在同一个窗口里并排:

┌──────────────────────────────┬─────────────────────┐
│  原始对话(一个字都不删)    │  排版台             │
│                              │  ┌───────────────┐  │
│  你:把这三家的方案对比一下  │  │ 结论          │  │
│  助手:好,我排了一页 →      │  │ ━━━━━━━━━ 62% │  │
│                              │  │ 对比表 · 三条 │  │
│  细节都在左边,随时能对      │  │ 注意:仅限…   │  │
│                              │  └───────────────┘  │
│                              │   ‹   3 / 12   ›    │
└──────────────────────────────┴─────────────────────┘

三个要点:

  1. 左右对照 —— 左边是完整原文,右边是这一轮排好的一页。想核对随时看左边,不用来回滚。
  2. 一页装下 —— 这一轮的关键结论、数据、对比、注意事项,都收进同一屏,不用翻。
  3. 留档可回翻 —— 每一轮一页,‹ › 翻得回去。上午的结论,下午还在。

至于"哪些是关键信息" —— 由写页面的一方来决定(通常是助手按你的约定把要点排进去,也可以自己写)。排版台负责把它稳稳地呈现出来,不抢戏。


快速开始

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

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit cb560843843d

Community comments

No comments yet. Be the first to write one.