从本地到公开：lavish-axi 导出单文件与 ht-ml.app 分享发布完全指南

从本地到公开lavish-axi 导出单文件与 ht-ml.app 分享发布完全指南【免费下载链接】lavish-axiHTML is the new markdown. Lavish is the new editor for your HTML artifacts.项目地址: https://gitcode.com/gh_mirrors/la/lavish-axiAI 生成的 HTML 工件怎么交付给不会跑本地环境的人lavish-axiLavish Editor给出两条路径export命令把工件连同本地图片、样式、脚本内联进单个 HTML 文件双击即开、无需任何服务器share命令把同一份单文件发布到第三方托管 ht-ml.app得到一个可直接分享的链接还能加密码保护私密页面。本完全指南面向新手带你走通从本地导出到公开分享的全流程并附上安全边界说明与自建后端的进阶玩法。 先认识 Lavish Editor上图Lavish Editor 演示动图——HTML 单文件工件在本地浏览器中打开并可交互审阅Lavish Editor 的理念是HTML is the new markdownAI Agent 擅长产出富 HTML 工件计划、对比表、图表、报告而 Lavish 负责让人类在本地浏览器里审阅、批注这些工件并把反馈回传给 Agent。当协作完成后工件需要离开本地——这正是导出单文件与分享发布两个命令的用武之地详见 README.md 的 Export and sharing 一节。 场景一导出单个可携带的 HTML 文件两种导出入口一行命令或浏览器菜单命令行方式Agent 也能替你执行lavish-axi export plan.html执行后会在源文件旁边生成plan.export.html——命名规则是原文件名 .export。想放到别处用--out path指定输出路径lavish-axi export plan.html --out ~/Desktop/方案.html浏览器方式审阅界面顶栏的溢出菜单⋮里有Export standalone HTML按钮点击即下载同名.export.html文件并提示带有 N 条警告之类的状态。上图Lavish Editor 审阅界面——左侧是被审阅的 HTML 工件右侧是与 Agent 的对话面板顶栏菜单即包含导出与发布入口导出时发生了什么本地资源全部内联Lavish 会做一次纯本地的 HTML 变换实现见 src/export-bundle.js内联本地资源工件引用的本地图片、CSS、字体、JS 都被转成 data URI 或内联代码块塞进同一个 HTML 文件剥离编辑器 SDK审阅用的批注、快照等注入代码会被移除导出文件打开后就是干净的页面保留远程引用CDN、在线字体等远程链接原样保留——导出文件无需服务器但渲染这些远程资源仍需联网。这条变换不会发出任何网络请求本地读取被严格限制在工件所在目录内无法安全内联的file://绝对路径会被替换成about:blank避免你的本地路径泄漏进导出文件。读懂导出结果警告与提示导出命令实现见 src/cli.js会输出几类有用的信息字段含义unresolved_local_assets未能内联的本地资源——文件搬家后会失效需要修复后重新导出notices非阻断提示如作者自设的 CSP meta 标签未改动self_paint_warning页面没有显式背景色导出后可能衬底建议先补背景再导出 场景二一键发布获得可访问的分享链接发布只需一条命令lavish-axi share plan.htmlLavish 先把工件打包成与导出相同的单文件本地资源内联再上传到 ht-ml.app 服务器返回一个可直接访问的 URL外加一个秘密update_key。请注意两点分享默认公开——拿到链接的任何人都能查看update_key只返回一次是日后更新或下线该页面唯一的凭证务必保存。在浏览器里则更直观顶栏溢出菜单选择Publish link会弹出 Publish artifact 对话框发布后展示 URL、可见性PUBLIC/私有以及 update key。私密分享给页面加密码lavish-axi share plan.html --private # Lavish 自动生成密码 lavish-axi share plan.html --password mypw # 使用你指定的密码--private生成的密码是 3 组 4 位字符如abc2-xyz9-mnk4特意避开了 0/o、1/l 这类易混淆字符实现见 src/share-password.js方便人工转述。浏览器对话框里也可以输入自定义密码留空则发布时自动生成。几个需要提前知道的规则密码属于共享密钥发给谁谁就能看页面密码只能新增或更换不能移除宿主服务不支持清空公开页面转私有后CDN 缓存可能让它再被无密码访问几分钟。更新与下线同一个 URL 持续生效lavish-axi share plan.html --site abc123 --update-key key # 就地更新URL 不变 lavish-axi share --unpublish --site abc123 --update-key key # 下线更新会原地替换页面内容链接不变非常适合发布后继续迭代。由于 ht-ml.app 没有删除接口下线实际是把页面替换成一个占位提示并加随机密码上锁——URL 仍然可解析只是看不到原内容。️ 安全边界Lavish 不会做什么理解边界才能放心分享分享传输实现见 src/html-app.js从不抓取远程 URL打包过程零外发请求天然无 SSRF 风险不泄漏本地路径不安全内联的绝对路径在输出前被抹除不无限制上传单资源默认 10 MB、总包默认 25 MB 上限可用环境变量调整⚠️ht-ml.app 是第三方服务不属于 Lavish 的一部分内容提交前还会经过宿主的 422 内容安全扫描。 进阶把分享后端指向你自己的服务不想依赖第三方设置LAVISH_AXI_HTML_APP_API_URL指向自托管后端即可可选LAVISH_AXI_HTML_APP_TOKEN鉴权。契约很简单POST /v1/sites创建页面并须返回urlupdate_keyPUT /v1/sites/{site_id}用 update_key 鉴权做就地更新。完整契约与一个 Cloudflare Worker 最小参考实现见 docs/self-hosting-share.md。❓ 常见问题速查问导出的文件打开还需要 Lavish 吗不需要。它是纯静态单文件双击即开也可托管在任何静态服务器上。问白板Mermaid 图表导出去是什么样白板只是浏览器里的增强视图导出与分享出去的仍是普通 Mermaid 渲染结果上图浏览器内的 Mermaid 白板全屏编辑视图——此交互只存在于本地审阅导出的单文件工件仍渲染为静态 Mermaid 图问update_key 丢了怎么办无法找回该页面将永远无法更新或下线只能重新发布一个新页面会得到新 URL。问想彻底删除已发布页面ht-ml.app 无删除端点只能下线成占位页需要公开链接时可重新发布。 相关文档与源码项目总览与 CLI 命令表README.md导出打包实现src/export-bundle.js分享传输与 ht-ml.app 接口src/html-app.js密码生成逻辑src/share-password.js导出/分享命令实现src/cli.js自托管分享后端契约docs/self-hosting-share.md导出打包测试用例test/export-bundle.test.js【免费下载链接】lavish-axiHTML is the new markdown. Lavish is the new editor for your HTML artifacts.项目地址: https://gitcode.com/gh_mirrors/la/lavish-axi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考