Files
memind/skills/static-page-publish/SKILL.md
T
John 6ee6fd64dd Add MindSpace page live edit, chat skills, and H5 deploy tooling.
Introduce page edit sessions with draft preview and patch API, chat skill picker, user memory profile, h5ApiBase resolution, voice WAV transport, and scripts for 105/g2 deployment and Plaza local dev.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-15 22:09:38 -07:00

4.0 KiB
Raw Blame History

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

静态页面 / 报告发布

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

何时使用

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

规则摘要

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

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

推荐工作流

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

回复格式(必须)

向用户交付页面时,必须使用 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 +「我的空间」卡片 + 保存弹窗预览):

<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. tagaccentaccent2subtitle 必须与页面实际视觉一致;禁止省略 mindspace-cover 或填无关默认值
  4. 若缺少 hero 主图,封面会退化为简陋默认图,视为未达标

禁止省略 mindspace-cover 或填写与页面无关的通用配色;促销/运动/品牌页必须写明 tagaccentcover

本地对比示例:node scripts/thumbnail-preview-demo.mjs/thumbnail-demo/