文档转公网互动页

要解决的具体问题

当你手头有一份 .docx 或 .md 格式的本地文档，需要让团队、协作者甚至外部用户直接查看时，常会遇到两道坎：一是文档直接转发后，对方没有对应软件就打不开，更别说快速定位章节内容；二是就算用工具把文档转成 HTML，也只能在本地打开，没法通过一个链接让他人远程访问。手动完成「文档转可交互 HTML」和「HTML 发公网」两个步骤，不仅需要切换不同工具，还容易在资源内联、部署配置上出错，导致最终链接打开是空白页。

技能如何工作

这个技能本身是编排层，不重复实现解析或部署逻辑，而是按固定顺序复用两个已建技能，形成一条龙流程：

1. 接收本地文档路径（.docx / .md），调用上游 z-doc-to-interactive-html 技能，生成 CSS/JS 全内联、图片 base64 化的自包含互动 HTML；
2. 校验 HTML 是否真正自包含（无外链资源），若有外链则回退让上游处理内联，避免带病部署；
3. 调用下游 z-html-public-deploy 技能，根据客户端类型（如 WorkBuddy 环境用 workbuddy_cloudstudio_deploy，其他客户端走 GitHub Pages/Netlify/Vercel 等静态托管）将 HTML 部署为公网 URL；
4. 验证 URL 返回 HTTP 200 确保可达，最终通过预览面板呈现公网链接。

适用边界与注意点

• 流程顺序不可逆，必须先保证生成合格的自包含 HTML 再部署，否则公网打开会出现空白；
• 发布前需确认用户意图，不能擅自将敏感文档公开到公网；
• 生成的公网链接可能存在时效，长期托管需提醒用户走正式静态服务；
• 技能仅做样式和部署层的编排，不会修改文档原文的语义内容。