InternalsModules
Module: previews
src/core/src/previews/：Live Preview 背后的 registry。它记录哪些本地端口/文件正被分享、使用哪些 slugs、生命周期如何。
文档提示：当前文档全部由 Codex 生成，正在积极审阅、扩充和优化中。
src/core/src/previews/：Live Preview 背后的 registry。它记录哪些本地端口/文件正被分享、使用哪些 slugs、生命周期如何。
职责
跟踪 preview sessions（dev-server ports 和 rendered files），铸造 owner/share URLs，执行 share TTL，并清理 preview 相关进程。HTTP serving side（reverse proxy、iframe toolbar、markdown rendering）在 server 的 preview 子模块里。
关键类型
| Type | File | Role |
|---|---|---|
Preview store / SESSIONS | store.rs | Slug → preview session；SHARE_TTL_SECS = 600 |
| Owner vs share semantics | store.rs | Owner URL 随 preview 存活；share URL 在铸造后 600 秒过期 |
kill_by_session / shutdown_kill_all_ports | mod.rs | 按 agent session / daemon stop 时所有 previewed ports 杀 dev-server processes |
交互
- ← server (MCP
preview/md_preview)： agents 通过 tools 创建 previews；skills（va-preview、va-md-preview）包装它们。 - ← server (
preview/handlers)： resolve slugs、proxy requests、render markdown。 - ← workspace： 关闭 thread 会 kill 绑定到其 session 的 previews。
- ← cli / dashboard： list 和 delete。
不变量：不要破坏
- Share URLs 是唯一 unauthenticated surface：单个 slug，硬 TTL。不重新审视安全模型就不要扩大 scope 或 lifetime。
- Preview processes 是 session-scoped：agent session 的 dev servers 会随
/close和 daemon 一起死，不留下 orphanednpm run dev。 - Owner links 需要 daemon token；share expiry 不能影响 owner path。
已知技术债
- remediation plan 中无跟踪项。
Source anchors: src/core/src/previews/ (mod, store), src/server/src/web_server/preview/ (proxy, iframe, markdown, cookie_proxy), src/server/src/web_server/mcp/tools.rs (preview tools).
Last verified: v0.7.11