HTML Artifacts 调研(2026-11-02,11-04 补充 Amp Artifacts)

By 陈成 · Published November 2, 2026 · Updated November 4, 2026

Agent 产出的 HTML artifacts 最近有什么进展(GitHub Issue artifacts、porthole),社区怎么看,对 Qoder 有什么启发?

来源:X 书签(含评论区)、GitHub Changelog、porthole 仓库文档、Amp 公告与文档、X 搜索、Reddit 搜索。链接见文末。

一句话

Agent 产出的东西正在从「聊天里的一段 Markdown」变成「一个能单独打开、能分享、能评论、能挂到工作对象上的 HTML 页面」。上周有两件事把这个趋势往前推了一步:GitHub 让 HTML 挂到 Issue 上成为一等公民(Issue artifacts);botiverse 开源了一个专门安全渲染 agent HTML 的宿主侧沙箱库(porthole)。前者解决「放哪儿、谁能看、怎么留版本」,后者解决「怎么在自己的产品里安全地显示」。

flowchart LR
    A[Agent / Skill<br/>生成 HTML] --> B{放到哪里}
    B -->|托管分享| C[Claude Artifacts<br/>claude.ai/artifact]
    B -->|挂到工作项| D[GitHub Issue artifacts<br/>gh issue artifact]
    B -->|挂到线程| D2[Amp Artifacts<br/>Markdown 源·多人共编]
    B -->|本地文件| E[~/xxx.html<br/>Lavish / answer-me-with-html]
    B -->|自家产品内嵌| F[宿主 App<br/>porthole 沙箱渲染]
    C & D & D2 & E & F --> G[人:浏览 / 批注 / 评论]
    G -->|反馈回流| A

1. GitHub Issue artifacts(10-28 公开预览)

是什么:把 agent 产出物直接挂在 Issue 上,作为后续 agent 和队友的持久上下文。支持三类:

类型 用途 备注
Markdown 计划、调研、根因分析 可 --attach 图片/视频
链接 Slack/Teams 讨论、原型、外部资源 .url 文件也会转成链接
HTML 交互可视化、流程图、图表 页面上可在「渲染预览」和「源码」间切换;存为 embedded_html 类型

入口:

gh issue artifact create 142 'docs/signin-plan.md#Sign-in plan' oauth-research.md
gh issue artifact create 142 menu-prototype.html          # → embedded_html
gh issue artifact create 142 --type plan -F - < plan.md
sequenceDiagram
    participant Dev as 开发者
    participant Agent as Coding Agent
    participant Issue as GitHub Issue
    Dev->>Agent: 调查 #142
    Agent->>Issue: gh issue artifact create 142 rca.md / viz.html
    Note over Issue: 版本历史 + 独立 URL
    Dev->>Issue: 在网页上看渲染后的 HTML、改计划
    Agent->>Issue: 下个会话 gh issue artifact list/view 142
    Issue-->>Agent: 上次的计划、结论作为上下文

社区反应(X):

我的看法:这是 GitHub 版的「把 Claude Artifacts 绑到工作项上」。关键差异在于它跟 Issue 生命周期绑定,并且有版本历史,天然适合做 agent 之间的交接。短板是还没覆盖 PR,App 端也还没支持 HTML。


2. botiverse/porthole:宿主侧 HTML 沙箱

是什么:给「要在自家 App 里显示 agent 写的 HTML」的宿主用的库(TypeScript,Apache-2.0,2026-10-11 创建,npm @botiverse/porthole 0.14.7,★26,很早期)。目标是做出 ChatGPT / Claude App 里那种内联卡片和独立页面的效果。

核心思路:一份配置同时生成 CSP、iframe sandbox 参数、壳运行时、以及教 agent 怎么写页面的说明书,几处不会对不上。另外附带一套泄漏测试(leak suite),在 Chromium / WebKit / Firefox 上验证隔离是否真的成立。

flowchart TB
    subgraph Config["defineDisplays(一份配置)"]
      P1[inlineWidget] & P2[liveWidget] & P3[artifact] & P4[MCP Apps] & P5[URL]
    end
    Config --> CSP[CSP / sandbox flags]
    Config --> Shell[In-frame shell<br/>流式渲染·自适应高度·主题·host 函数桥]
    Config --> Manual[给 Agent 的写作手册]
    Config --> Check["/check: lintContent / checkPage"]
    Shell --> Iso{隔离方式}
    Iso --> O1[opaque origin iframe]
    Iso --> O2["独立子域 a-&lt;id&gt;.content.host"]
    O2 --> Nested["nested: 页面再套一层 opaque 子 frame"]
    Shell -. 可选 .-> RT["App runtime: porthole.use(user/comments/artifact/assets/db)"]

几个值得注意的设计:

社区反应:书签来源是 @zty0826(TennyZhuang)回复 @ludamn513「太喜欢 claude artifacts,准备自己写一个 Harness 中立的」,@xuanwo 回了句「这个好」。讨论量还小,属于圈内工程师推荐。


3. 更大的图景:HTML 正在成为 agent 的默认输出格式

3.1 官方产品

3.2 开源「去 Anthropic 化」复刻

用户书签 @__oQuery:「Claude Code 最好用的就是 Artifact……五种类型我自己做了,再也不用受 A\ 的气了」。评论区 @rickye26 说得最到位:「五种类型本质上都是 html,只要支持 html 再加上对任意 DOM 元素的评论功能就差不多了」。

项目 ★ 定位
JimLiu/baoyu-design 5.8k 把 Claude Design / Slides / Dashboard 移植成 Skill,任何 agent 和模型都能跑;v2.1 加了评论;已支持 DeepSeek Harness
plannotator/effective-html 3.8k 线框图、交互原型、计划、图表的 HTML skill 集合
QingYunA/answer-me-with-html 5.1k 用一页离线 HTML 回答复杂问题(先 md 再排版)
tt-a1i/archify 92.5k 把想法/代码库变成交互架构图(明暗主题、导出 PNG/SVG)
Sma1lboy/artifact-share 4 一个 POST 发布 HTML 拿到评审链接,agent 以 JSON 读回结论(CF Worker + KV,约 200 行)
r3.hyperlogue.tech(@rickye26) — 跨 harness 的开源 artifact + DOM 评论
ZCode visualize skill — Gen UI 渲染契约

3.3 Reddit 视角

3.4 反对和保留意见


4. 总结和判断

flowchart LR
    subgraph 生产
      S[Skill 约定渲染契约<br/>visualize / effective-html / baoyu-design]
    end
    subgraph 承载
      H1[托管:Claude Artifacts]
      H2[工作项:GitHub Issue artifacts]
      H5[线程:Amp Artifacts·Markdown 共编]
      H3[自建:porthole + 自家 App]
      H4[本地:单文件 .html]
    end
    subgraph 协作
      R[DOM 级批注 / 评论] --> L[agent 读回反馈]
    end
    S --> H1 & H2 & H3 & H4 & H5 --> R
    L --> S
  1. 格式之争基本结束:复杂结果用富页面呈现已是共识(Claude、GitHub、Amp、ZCode、T3 Code、herdr 都在做)。争论转到了「源文件用 md 还是 html」和「成本」上:Claude 和 GitHub 存任意 HTML,Amp 存 Markdown 再渲染。
  2. 竞争点从「能渲染」转到「能协作」:DOM 级评论、反馈回流给 agent、版本历史。GitHub 给了版本历史和工作项绑定,Amp 给了人和 agent 共编同一份文档的冲突合并,porthole 给了批注底座,baoyu-design 和 artifact-share 给了开源评论闭环。协作有两条路:一条是在 HTML 上评论、由 agent 改(Claude / porthole),另一条是人直接改源文档、agent 先读修改再合并(Amp)。
  3. 厂商中立是社区的主要诉求:「不受 A\ 的气」「Harness 中立」「任何 agent 任何模型」。Claude Design 关停会加速这个方向。
  4. 安全是自建方案绕不过去的门槛:agent 写的 HTML 应当视为不可信内容。porthole 的「一份配置同时生成 CSP 和 agent 说明书 + 跨浏览器泄漏测试」是目前看到最系统的做法,值得做 harness 或 IDE 的团队参考(比如 qodercli 如果要做 HTML 渲染/预览)。
  5. 可以直接用起来的:gh issue artifact create <issue> report.html 把 agent 产出的分析页挂回 Issue,作为跨会话、跨人的交接物。

5. 对 Qoder 意味着什么

基于 Qoder 主干(2026-10-30,2e1cb39630)的源码和 llm-wiki。

5.1 现状:零件基本都有,但各自为政

Qoder 已经有三块跟 HTML artifacts 相关的能力,分属不同模块:

能力 在哪 做了什么 缺什么
内联可视化 内置 MCP 工具 present_visualization(chatSession/capabilities/visualization) agent 先把 HTML 片段写到 visualizations/*.html,再调用工具;校验后存成不可变快照,Desktop 和手机端(Remote Control)都能看。渲染是 127.0.0.1 上的代理页 + sandbox="allow-scripts" 的 srcdoc iframe,CSP 全关(connect-src 'none',图片只允许 data:),上限 1 MB 只能内联在会话里,没有独立页面、分享链接和版本历史;出网全关,Chart.js / D3 这类库只能内联进去
产物预览 + 批注 packages/artifact-preview PDF / PPTX / DOCX / XLSX 预览,按 SHA-256 revision 绑定,批注锚定在页码/元素/A1 区域上,作为附件交回 agent,协议兼容 Codex README 明写「HTML 不在当前范围内」
协作产物卡片 Discussion(Desktop + apps/web) 卡片支持 HTML/HTM,3 MB 以内可预览,Desktop 和 Web 共用一个预览组件 只做静态预览:「HTML 不执行脚本或联网」,交互页面在这里是死的

另外,协作侧已经有 Project / Discussion / Issue 和 Web 宿主,也就是说 GitHub 刚上线的「把 artifact 挂到 Issue 上」,Qoder 在对象模型上已经有了落点。

flowchart LR
    A[Agent 写 HTML] --> V[present_visualization<br/>会话内联·可交互·无出网]
    A --> F[工作区 .html 文件]
    F --> D[Discussion 卡片<br/>Desktop/Web·静态·不执行脚本]
    P[artifact-preview<br/>PDF/Office 批注 → agent] -. 未覆盖 HTML .-> F
    V & D --> G((缺:独立页面 + 分享链接 + 版本 + DOM 评论回流))

5.2 缺口

  1. 没有「可托管、可分享的 HTML 页面」这一层。内联可视化是会话里的一张卡片,Discussion 里的 HTML 是静态的,都不是 Claude Artifacts / Issue artifacts 那种有独立 URL、有版本、打开就能交互的页面。
  2. HTML 没有批注回流。Office/PDF 已经有「批注 → agent 附件」这条链路,HTML 恰好是 agent 最常输出的格式,反而没有。
  3. 交互和安全只能二选一。会话里能跑脚本但不能出网,协作里能分享但不能跑脚本。要在 Web/Discussion/Issue 里运行交互 HTML,需要 porthole 那种独立 origin(或独立子域)的隔离方案,不能直接复用 Desktop 的 127.0.0.1 代理。
  4. 跟 Issue / 评审没有绑定。我的实际用法是让 AI 自证、产物用 HTML 承载,但内网 code 平台可能不支持传 HTML,只能打包发给 review 的同学,反馈也回不到 agent。

5.3 建议(按投入从小到大)

  1. 内联可视化放开 CDN 白名单:参照 porthole 的第二档(cdnjs / jsDelivr / unpkg,要求锁版本),或者像 porthole 那样同源内置 Chart.js / D3。改动小,生成质量提升明显。
  2. artifact-preview 加 HTML 格式:复用 revision 和批注协议,批注用 W3C selector / DOM 锚点(跟 porthole 一样),交回 agent 的格式与 Office 批注保持一致。
  3. Issue / Discussion 挂 HTML artifact:有版本历史和独立 URL,Web 宿主用独立子域渲染可交互页面,出网分级默认关闭。这一步就是 Qoder 版的 GitHub Issue artifacts,也能作为 MR 自证产物的托管地址,评审时贴链接就行,不用再打包发文件。写入可以参考 Amp:每次保存一个 revision,agent 碰到更新的版本时写入被拒,必须先合并再写,这样人改过的内容不会被覆盖。
  4. 统一生成契约:给 agent 的写作说明(尺寸、主题 token、可用的库、出网档位)和 CSP 由同一份配置生成,避免 prompt 里说能用、渲染时却被拦掉。

一句话:Qoder 不缺渲染能力,缺的是把这些零件串成「生成 → 托管 → 评论 → 回流」的闭环,而 Issue 和 Web 宿主正好是现成的挂载点。


参考链接

核心

X 书签(含评论)

X 搜索

Reddit

Read this report as Markdown · Cite it (BibTeX)