---
name: static-page-publish
description: 在专属 MindSpace 目录生成可公开访问的静态 HTML 报告与页面（TKMind H5 通用技能）
---

# 静态页面 / 报告发布

本技能为 **TKMind H5 多用户环境** 的通用发布流程。安装到用户工作区后，内容会按用户替换为专属目录与公网前缀。

## 何时使用

- 用户要「生成网页 / HTML 报告 / 可视化页面 / 分享链接」
- 用户提到「放到 MindSpace」「给个能打开的链接」

## 规则摘要

1. 只在**当前用户工作区**（会话 `working_dir`）内读写与搜索，从 `.` 开始
2. 查找 CSV/文档时只用相对路径（如 `oa/report.csv`），**禁止**去上级目录、MindSpace 根目录、其它用户目录或主机路径搜索
3. 读 CSV/列目录：用工作区内的 `shell`（`ls oa/`、`cat file.csv`）或 `tree`；**禁止**用公网 URL 代替
4. 公网链接**仅**用于让用户浏览器打开已发布的 HTML，不能用来列目录或读数据文件
5. 静态文件保存即可访问，**无需重启**

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

## 推荐工作流

1. 确认需求（标题、章节、视觉风格、是否需要 hero 图）
2. `write_file` 创建 `public/页面.html`（需要调整已有页面时用 `edit_file`；需要时在同目录或 `assets/` 放主图）
3. 在 `<head>` 写入 **mindspace-cover**（必须与页面主题一致，见下文）
4. 保存后服务端**立即**生成 `<文件名>.thumbnail.svg`（Agent 交互阶段即生效）
5. 按「回复格式」返回**可点击**公网链接

## 回复格式（必须）

向用户交付页面时，**必须使用 Markdown 可点击链接**：

```markdown
[马来西亚旅游攻略](https://goo.tkmind.cn/MindSpace/<用户ID>/public/malaysia-travel-guide.html)
```

要求：

- **必须**使用 `[页面标题](完整URL)`，不要只给裸 URL 或「点这里」
- 页面写入 `public/` 时，URL **必须**包含 `/public/` 路径段（与磁盘路径一致）
- 标题用页面真实主题名
- 可同时给出相对路径（如 `public/malaysia-travel-guide.html`）
- 说明：保存即生效，无需重启

## 信息流预览图（必须）

每个 HTML 必须在 `<head>` 包含与**页面主题一致**的元数据。系统据此生成 **精美的 3:4 信息流封面**（工作区 `*.thumbnail.svg` +「我的空间」卡片 + 保存弹窗预览）：

```html
<meta name="description" content="一句话摘要，显示在预览图副标题">
<meta name="mindspace-cover" content='{"tag":"旅行","emoji":"🇲🇾","accent":"#ff6b35","accent2":"#24243e","subtitle":"马来西亚深度游","cover":"assets/hero.jpg"}'>
```

| 字段 | 要求 |
|------|------|
| `tag` | 与主题一致：旅行 / 美食 / 报告 / **运动** / **活动** 等 |
| `accent` / `accent2` | 页面主色，与 hero/背景 CSS 一致 |
| `subtitle` | 一句话卖点；未写时用 description |
| `cover` / `image` | **必须**指向高质量主图（相对 HTML 或 `https://`）；见下文 |
| `emoji` | 可选；也可写在 title 中 |

### 精美预览图（必须达标）

保存 HTML 后，系统会**立即**生成 `<文件名>.thumbnail.svg` 作为卡片封面。要产出**可在信息流中直接展示的精美封面**，必须：

1. **视觉类页面**（旅行、美食、活动、运动、品牌、产品、促销等）**必须**在 `assets/` 放置高质量 hero 主图（建议宽度 ≥1200px），并在 `cover` 字段引用（如 `assets/hero.jpg`）
2. **纯文字报告**可仅用配色 + tag，但仍须保证 `accent` / `subtitle` 与页面风格一致
3. `tag`、`accent`、`accent2`、`subtitle` 必须与页面实际视觉一致；**禁止**省略 mindspace-cover 或填无关默认值
4. 若缺少 hero 主图，封面会退化为简陋默认图，**视为未达标**

**禁止**省略 mindspace-cover 或填写与页面无关的通用配色；促销/运动/品牌页必须写明 `tag`、`accent` 和 `cover`。

本地对比示例：`node scripts/thumbnail-preview-demo.mjs` → `/thumbnail-demo/`
