--- name: static-page-publish description: 在专属 MindSpace 目录生成可公开访问的静态 HTML 报告与页面（TKMind H5 通用技能） --- # 静态页面 / 报告发布本技能为 **TKMind H5 多用户环境** 的通用发布流程。安装到用户工作区后，内容会按用户替换为专属目录与公网前缀。 ## 何时使用 - 用户要「生成网页 / HTML 报告 / 可视化页面 / 分享链接」 - 用户提到「放到 MindSpace」「给个能打开的链接」 ## 规则摘要 0. 可以用 `apps__create_app` 设计/预览页面，但那一步只是在 Apps 窗口内生成交互式 App，**还没有公网链接**；只要用户要「可访问的链接」「分享出去」，最后必须把内容 `write_file` 落到 `public/*.html`，按下方「回复格式」给出真实链接，不要停在 App 阶段就回复链接 1. 只在**当前用户工作区**（会话 `working_dir`）内读写与搜索，从 `.` 开始 2. 查找 CSV/文档时只用相对路径（如 `oa/report.csv`），**禁止**去上级目录、MindSpace 根目录、其它用户目录或主机路径搜索 3. 读 CSV/列目录：用工作区内的 `shell`（`ls oa/`、`cat file.csv`）或 `tree`；**禁止**用公网 URL 代替 4. **禁止**用 `shell` / `cat` / `heredoc` / `echo` / `cp` 写入 `public/*.html`；HTML 必须用 `write_file` / `edit_file`（shell 在容器内执行，公网链接会 404） 5. 公网链接**仅**用于让用户浏览器打开已发布的 HTML，不能用来列目录或读数据文件 6. 静态文件保存即可访问，**无需重启** 7. 默认只生成 HTML；不要在没有明确需求时强制生成 Word、PDF、长图等伴生文件 8. 只有用户明确要求 **Word/PDF 等二进制下载** 时：文件单独落盘（如 `public/方案.docx`），链接用相对路径；**禁止**在 HTML 内用 `data:...;base64,...` 嵌入 docx（易截断损坏） 9. 只有用户明确要求**长图下载**时：必须先 `load_skill` → `long-image-download`，调用 `generate_long_image` 生成同目录 `public/<页面名>.long.png`，再返回长图预览与下载链接；禁止把 `.thumbnail.svg` 当成长图 10. **禁止**在 HTML 中用 CDN `https://...` 引用 `