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 类型 |
入口:
- GitHub App 会话里产生的 artifact 自动挂到对应 Issue(App 内创建/查看 HTML 暂未上线,"coming soon")。
- CLI:
gh issue artifact create|edit|list|view|download|delete(本机 gh 2.103.3 已可用)。 - github.com 上可直接增删改,保留版本历史,每个 artifact 有独立 URL。
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):
- @ryoppippi:「good bye long PR body!!」——用户书签里的原帖。回复里 @GDarchen 指出目前只有 Issue,没有 PR。
- @Kesin11:「看起来跟 Claude 的 Artifact 差不多,挺方便」。
- @An_yhl:最实用的场景是 bug 根因分析挂回 Issue,下次接手不用翻聊天记录。
- @DaveTy94:「agent 的计划不该消失在聊天历史里」。
- @srz_zumix 已经让 gh-copilot-attendant 生成 Copilot 用量 HTML 并通过 Issue artifacts 共享(发布 5 天内就有工具接入)。
- 日本社区反应热烈(codezine 报道,@shimabox「HTMLしか勝たん」)。
我的看法:这是 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-<id>.content.host"]
O2 --> Nested["nested: 页面再套一层 opaque 子 frame"]
Shell -. 可选 .-> RT["App runtime: porthole.use(user/comments/artifact/assets/db)"]
几个值得注意的设计:
-
预设:inline widget、live widget(读宿主数据、自身无网络)、artifact(单文件或多文件页面)、MCP Apps(外部协议沿用
io.modelcontextprotocol/ui2026-01-26,不发明新协议)、URL(比如 dev server 预览)。 -
出网分级(默认全关):
- Closed:只能用内联代码和
data:/blob:; LIBRARY_CDNS:cdnjs / jsDelivr / unpkg / esm.sh / Google Fonts,外加 Tailwind、jQuery、Plotly 的官方 CDN(只放行脚本),要求 agent 锁定版本;anyHttps: ["img"]:只放行被动资源,专门给带外链图片的存量内容用;- porthole 自带库:Chart.js / D3 从同源提供,给 live widget 用。
官方建议是先全关,用到库再开 CDN,新写的页面永远不需要
anyHttps。 - Closed:只能用内联代码和
-
批注:按 W3C selector 锚点画评论标记、草稿标记,页面按钮可以往宿主输入框塞草稿。这就是「在 HTML 上点元素写评论,再让 agent 读回去」那套交互的底座。
-
本机场景也要隔离:README 专门说了,agent 写的页面可能带着它读到的注入指令,不隔离的话可以读 UI 的 key、调 agent 的本地 API。如果内容完全可信、只需要显示,用普通 iframe 就够了。
-
使用方:Raft(工作区 Artifacts、HTML 附件预览)、Ferry。
社区反应:书签来源是 @zty0826(TennyZhuang)回复 @ludamn513「太喜欢 claude artifacts,准备自己写一个 Harness 中立的」,@xuanwo 回了句「这个好」。讨论量还小,属于圈内工程师推荐。
3. 更大的图景:HTML 正在成为 agent 的默认输出格式
3.1 官方产品
- Claude Code Artifacts(6 月上线 Team/Enterprise):会话产出可分享页面,PR walkthrough、项目 dashboard 等。7 月 @howie_serious 测到可以连 MCP 读用户数据做团队看板。@_catwu 的 PM 用法:「上周谁用 X 最多?做个 Top10 artifact,再约 15 分钟聊」。
- Claude Design 将于 12-14 关停、并入 Artifacts:Reddit r/ClaudeDesign 意见分裂。
- 正面(43 赞):artboard 能在画布上并排展示一个原型的多个状态,交接给 Claude Code 更顺。
- 负面(34 赞):「Artifacts 比 Design 慢 5 倍、体验差」。有人建议让 Claude Code 写确定性转换脚本来迁移,也有人推荐 open-design.ai。
- 有人一针见血:「artifact 本质就是一个由 Claude 托管的 .html」。
- Amp Artifacts(11-02 公告):挂在 thread 上、由 agent、你和队友共同编辑的文档。有东西要读(计划、报告、会议纪要、跨多个 thread 汇总的结论)时,agent 会主动写一份 artifact,不再回一大段文字。artifact 在 thread 旁边打开。
- 源格式是 Markdown:agent 通过内置
artifact工具读写 Markdown,内容可以有标题、清单、表格、代码、图片和「交互视图」(文档没写怎么存储和渲染)。导出支持 Markdown / HTML / PDF。 - 共编和冲突处理:每次保存产生一个 revision。agent 工作期间如果有人存了新版本,agent 的写入会被拒绝,它要把改动合并到新版本上,不能覆盖。公告原话:「agent 回来时会先读你的修改,再把它们融进去,而不是覆盖」。人编辑的方式是直接改文档(勾清单、改表格、重写段落),没有单独的评论功能。
- 分享三档:thread 成员(默认,可编辑)/ 工作区成员(只读)/ 任何拿到链接的人(免登录)。管理员可以关掉公开链接,也可以走带审计的只读访问。单个 artifact 上限 2 MB;图片跟 thread 存在一起,通过工作区链接或公开链接打开时图片会显示不出来。
- 公告里的例子:agent 翻了约 60 个 thread,写出一份「长 shell 命令阻塞等待浪费多少模型调用」的分析,配图对比轮询(约 3.9k 次)和 async watch(978 次);另一个例子是让两个 orb 并行做两版 Markdown 预览方案,再合成一份对比文件、检查项和成本并给出推荐的 artifact。
- 我的看法:Amp 选了「Markdown 做源、渲染做视图」(见 3.4),把重点放在「人和 agent 改同一份文档」上,而不是 DOM 级评论。这是目前协作闭环最完整的一家:有版本、有冲突合并、有分级分享。代价是表现力受限于 Markdown 加交互视图,做不了 Claude Artifacts 那种任意 HTML 应用。
- 源格式是 Markdown:agent 通过内置
- ZCode v3.15.1 Gen UI(@seekjourney 书签):agent 通过
visualizeSkill 输出 HTML+JS,对话框直接渲染,普通交互由前端 JS 处理,需要推理时再调 agent;也支持 MCP Apps 可编辑画布。评论区的共识是「Skill 把渲染契约固定下来,模型只管吐 HTML」。 - T3 Code:@zqkrq 的 ADE 排行榜提到它能在聊天里渲染 HTML artifacts,看懂子 agent 流程容易多了。
- herdr / gram 也能渲染交互 HTML 页面(@jerry543 书签)。
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 视角
- r/ClaudeAI「This is 61 KB HTML file」(1.1 万赞、900 评论):Opus 5.5 用 30 分钟写出单文件 WebGPU 海洋模拟,期间用子 agent 对截图做互评。评论两极:一边惊叹,另一边说「就是个 shader + JS,去看 demoscene / shadertoy」。单文件 HTML 已经成了展示模型能力的标准载体。
- r/claudeskills「Artifact tool 每会话吃约 13k token」:作者在
permissions.deny里禁用内置 Artifact,换成按需加载的/local-artifactskill。评论建议预先做好设计系统和常用页面模板,再配一个很小的 skill。这是一个实际成本问题。 - r/ClaudeAI「Using Artifacts instead of Project Notes」:有人拿 artifact 当项目笔记。
- r/ClaudeDesign 有人做了 decision board skill,把项目里所有待决策项渲染成一页。
3.4 反对和保留意见
- Markdown 做源、HTML 做视图(@Prosedown1):agent 编辑和 diff
.md便宜,便于 review;每次重写长 HTML 成本高,改了什么也看不出来。Amp Artifacts 已经按这个思路做成了产品:Markdown 存储,渲染时带交互视图,需要时再导出 HTML。 - 安全:这正是 porthole 存在的理由。另外 Reddit r/netsec 上「Markdown Is the New Executable」(387 赞)说的是攻击者往下载目录里塞 agent 指令。agent 读进来的东西会进到它写出的 HTML 里,所以渲染端必须隔离、限制出网。
- 体验与速度:托管型 artifacts 有时比专用产品(Claude Design)慢;生成长页面的 token 成本也不低。
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
- 格式之争基本结束:复杂结果用富页面呈现已是共识(Claude、GitHub、Amp、ZCode、T3 Code、herdr 都在做)。争论转到了「源文件用 md 还是 html」和「成本」上:Claude 和 GitHub 存任意 HTML,Amp 存 Markdown 再渲染。
- 竞争点从「能渲染」转到「能协作」:DOM 级评论、反馈回流给 agent、版本历史。GitHub 给了版本历史和工作项绑定,Amp 给了人和 agent 共编同一份文档的冲突合并,porthole 给了批注底座,baoyu-design 和 artifact-share 给了开源评论闭环。协作有两条路:一条是在 HTML 上评论、由 agent 改(Claude / porthole),另一条是人直接改源文档、agent 先读修改再合并(Amp)。
- 厂商中立是社区的主要诉求:「不受 A\ 的气」「Harness 中立」「任何 agent 任何模型」。Claude Design 关停会加速这个方向。
- 安全是自建方案绕不过去的门槛:agent 写的 HTML 应当视为不可信内容。porthole 的「一份配置同时生成 CSP 和 agent 说明书 + 跨浏览器泄漏测试」是目前看到最系统的做法,值得做 harness 或 IDE 的团队参考(比如 qodercli 如果要做 HTML 渲染/预览)。
- 可以直接用起来的:
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 缺口
- 没有「可托管、可分享的 HTML 页面」这一层。内联可视化是会话里的一张卡片,Discussion 里的 HTML 是静态的,都不是 Claude Artifacts / Issue artifacts 那种有独立 URL、有版本、打开就能交互的页面。
- HTML 没有批注回流。Office/PDF 已经有「批注 → agent 附件」这条链路,HTML 恰好是 agent 最常输出的格式,反而没有。
- 交互和安全只能二选一。会话里能跑脚本但不能出网,协作里能分享但不能跑脚本。要在 Web/Discussion/Issue 里运行交互 HTML,需要 porthole 那种独立 origin(或独立子域)的隔离方案,不能直接复用 Desktop 的 127.0.0.1 代理。
- 跟 Issue / 评审没有绑定。我的实际用法是让 AI 自证、产物用 HTML 承载,但内网 code 平台可能不支持传 HTML,只能打包发给 review 的同学,反馈也回不到 agent。
5.3 建议(按投入从小到大)
- 内联可视化放开 CDN 白名单:参照 porthole 的第二档(cdnjs / jsDelivr / unpkg,要求锁版本),或者像 porthole 那样同源内置 Chart.js / D3。改动小,生成质量提升明显。
- artifact-preview 加 HTML 格式:复用 revision 和批注协议,批注用 W3C selector / DOM 锚点(跟 porthole 一样),交回 agent 的格式与 Office 批注保持一致。
- Issue / Discussion 挂 HTML artifact:有版本历史和独立 URL,Web 宿主用独立子域渲染可交互页面,出网分级默认关闭。这一步就是 Qoder 版的 GitHub Issue artifacts,也能作为 MR 自证产物的托管地址,评审时贴链接就行,不用再打包发文件。写入可以参考 Amp:每次保存一个 revision,agent 碰到更新的版本时写入被拒,必须先合并再写,这样人改过的内容不会被覆盖。
- 统一生成契约:给 agent 的写作说明(尺寸、主题 token、可用的库、出网档位)和 CSP 由同一份配置生成,避免 prompt 里说能用、渲染时却被拦掉。
一句话:Qoder 不缺渲染能力,缺的是把这些零件串成「生成 → 托管 → 评论 → 回流」的闭环,而 Issue 和 Web 宿主正好是现成的挂载点。
参考链接
核心
-
GitHub Changelog · Issue artifacts are now in public preview — https://github.blog/changelog/2026-10-28-issue-artifacts-are-now-in-public-preview/
-
botiverse/porthole — https://github.com/botiverse/porthole
- Adopting / Choosing egress — https://github.com/botiverse/porthole/blob/main/docs/ADOPTING.md#choosing-egress
- Threat model — https://github.com/botiverse/porthole/blob/main/docs/THREAT_MODEL.md
-
Amp · Artifacts(2026-11-02)— https://ampcode.com/news/artifacts
- Amp 文档 · Threads → Artifacts — https://ampcode.com/docs/threads#artifacts
X 书签(含评论)
- @ryoppippi「good bye long PR body!!」— https://x.com/ryoppippi/status/2117089556256456900
- @zty0826 porthole 推荐 — https://x.com/zty0826/status/2116853495915835826
- @__oQuery 自制 Artifact 五种类型 — https://x.com/__oQuery/status/2112262691184312451
- @seekjourney ZCode Gen UI / visualize Skill — https://x.com/seekjourney/status/2112098606543188111
- @_catwu PM 用 artifact — https://x.com/_catwu/status/2107967210467803152
- @DmitriyLeybel / @ferminrp pstack 解析 artifact — https://x.com/ferminrp/status/2110699895078461906
- @omarsar0 /learn skill 学习中心 artifact — https://x.com/omarsar0/status/2069797099814682638
- @jerry543 herdr gram 渲染 HTML — https://x.com/jerry543/status/2104841020290515306
- @mate_mattt eli5 HTML skill — https://x.com/mate_mattt/status/2091819832295739553
- @midudev archify — https://x.com/midudev/status/2094425974406320207
X 搜索
- @Kesin11 Issue artifacts 解读 — https://x.com/Kesin11
- @An_yhl Issue artifacts 用于根因分析交接 — https://x.com/An_yhl
- @DaveTy94 agent 计划别消失在聊天里 — https://x.com/DaveTy94
- @srz_zumix gh-copilot-attendant v0.5.0 — https://github.com/srz-zumix/gh-copilot-attendant/releases/tag/v0.5.0
- @marlene_zw Universe 26 cookbook(含 Issue Artifacts)— https://github.com/octodemo/virtual-universe-26
- @trq212 Claude Code Artifacts 发布 — https://x.com/trq212
- @zqkrq ADE 排行榜 / T3 Code 渲染 HTML artifacts — https://x.com/zqkrq
- @dotey baoyu-design v2 — https://github.com/jimliu/baoyu-design
- @hfcorriez answer-me-with-html — https://github.com/QingYunA/answer-me-with-html
- @tom_doerr effective-html — https://github.com/plannotator/effective-html
- @Prosedown1 Markdown 做源、HTML 做视图 — https://x.com/Prosedown1
- @Infoxicador 逆向 ChatGPT Apps iframe 沙箱 — https://x.com/Infoxicador
- Sma1lboy/artifact-share — https://github.com/Sma1lboy/artifact-share
- This is 61 KB HTML file — https://www.reddit.com/r/ClaudeAI/comments/1x7v7gj/
- I moved from Claude design to artifacts — https://www.reddit.com/r/ClaudeDesign/comments/1xh3ajb/
- Claude 'Artifacts' SLOW … compared to Claude Design — https://www.reddit.com/r/ClaudeDesign/comments/1xhhnu6/
- Artifact tool costs ~13k tokens — https://www.reddit.com/r/claudeskills/comments/1xa5ym6/
- Using Artifacts instead of Project Notes — https://www.reddit.com/r/ClaudeAI/comments/1xexnze/
- Markdown Is the New Executable — https://www.reddit.com/r/netsec/comments/1xcnb6o/