fix: gate public page download links before Portal release

Add a MindSpace public HTML checker for missing companion docx/PDF paths, wire it into runtime packaging and release-portal-runtime-prod.sh, and document the workflow for agents and ops. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 12:40:59 +08:00
parent 5a970e612e
commit b273bb7aa2
10 changed files with 368 additions and 3 deletions
@@ -21,6 +21,7 @@ description: 在专属 MindSpace 目录生成可公开访问的静态 HTML 报
 5. 公网链接**仅**用于让用户浏览器打开已发布的 HTML，不能用来列目录或读数据文件
 6. 静态文件保存即可访问，**无需重启**
 7. 页面需提供 **Word/PDF 等二进制下载** 时：文件单独落盘（如 `public/方案.docx`），链接用相对路径；**禁止**在 HTML 内用 `data:...;base64,...` 嵌入 docx（易截断损坏）
+8. 页面若提供 **Word/PDF/附件下载**，相对链接指向的文件必须与 HTML **同目录（或子目录）且真实存在**；改 HTML 文件名时同步 **rename/copy** 伴生文件

 详细约束以工作区内的 `.goosehints` 与 `.agents/skills/static-page-publish/SKILL.md` 为准。

@@ -31,6 +32,14 @@ description: 在专属 MindSpace 目录生成可公开访问的静态 HTML 报
 3. 在 `<head>` 写入 **mindspace-cover**（必须与页面主题一致，见下文）
 4. 保存后服务端**立即**生成 `<文件名>.thumbnail.svg`（Agent 交互阶段即生效）
 5. 按「回复格式」返回**可点击**公网链接
+6. 若页面含下载按钮，确认 `public/<同名>.docx`（或链接中的相对路径）已落盘
+
+## 伴生下载文件（必须）
+
+- `<a href="report.docx" download>` 等相对下载链接，目标文件必须已在 HTML 同目录或子目录
+- 推荐 `public/report.html` + `public/report.docx`；**禁止** HTML 链接名与磁盘文件名不一致
+- 从 `oa/` 引用文档时，先 **复制** 到 `public/` 再写链接
+- 交付前 `list_dir public/` 自检；可跑 `npm run check:mindspace-public-links`

 ## 回复格式（必须）