用途:把 Sideshow 中已完成、需要交付给终端外人员的演示面(图表、原型、说明、diff 讲解)发布为 stacktr.ee 上的私有页面,任何人用普通浏览器即可打开。
主要能力:将 surface 的有序部件(html、markdown、mermaid、diff、terminal、image)重组为单个自包含文档,inline CSS、脚本固定到版本化 CDN 或预渲染、图片用 data: URI 内嵌,不引用 localhost 或 sideshow 资源 URL。默认发布为 unlisted 链接并保留 7 天过期,可加密码或邮箱门禁,交付前做 PII 检查。
使用方式:从运行中的 sideshow 服务器(SIDESHOW_URL,默认 http://localhost:8228)或对话中获取内容,合成 HTML 后发布:
echo "$HTML" | bash scripts/publish.sh
也可用 publish_html MCP 工具。后续迭代原地更新:
echo "$HTML_V2" | bash scripts/publish.sh --update <id-or-slug>
适用场景:把成品演示面发给客户、同事或用户手机。限制:不用于仍在本终端迭代操作者的场景,也不用于循环刷新的实时状态页(应使用 stacktree-status-dashboard);仅当用户明确称其为长期保留时用 --expires-never;审查类产物不得使用公开 slug。回复时需告知链接、过期时间及接收方无需安装任何东西,sideshow 会话仍保留在本地不受影响。安装命令与更多细节暂未提供。