6ee6fd64dd
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>
4.0 KiB
4.0 KiB
name, description
| name | description |
|---|---|
| static-page-publish | 在专属 MindSpace 目录生成可公开访问的静态 HTML 报告与页面(TKMind H5 通用技能) |
静态页面 / 报告发布
本技能为 TKMind H5 多用户环境 的通用发布流程。安装到用户工作区后,内容会按用户替换为专属目录与公网前缀。
何时使用
- 用户要「生成网页 / HTML 报告 / 可视化页面 / 分享链接」
- 用户提到「放到 MindSpace」「给个能打开的链接」
规则摘要
- 只在当前用户工作区(会话
working_dir)内读写与搜索,从.开始 - 查找 CSV/文档时只用相对路径(如
oa/report.csv),禁止去上级目录、MindSpace 根目录、其它用户目录或主机路径搜索 - 读 CSV/列目录:用工作区内的
shell(ls oa/、cat file.csv)或tree;禁止用公网 URL 代替 - 公网链接仅用于让用户浏览器打开已发布的 HTML,不能用来列目录或读数据文件
- 静态文件保存即可访问,无需重启
详细约束以工作区内的 .goosehints 与 .agents/skills/static-page-publish/SKILL.md 为准。
推荐工作流
- 确认需求(标题、章节、视觉风格、是否需要 hero 图)
write创建public/页面.html(需要时在同目录或assets/放主图)- 在
<head>写入 mindspace-cover(必须与页面主题一致,见下文) - 保存后服务端立即生成
<文件名>.thumbnail.svg(Agent 交互阶段即生效) - 按「回复格式」返回可点击公网链接
回复格式(必须)
向用户交付页面时,必须使用 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 作为卡片封面。要产出可在信息流中直接展示的精美封面,必须:
- 视觉类页面(旅行、美食、活动、运动、品牌、产品、促销等)必须在
assets/放置高质量 hero 主图(建议宽度 ≥1200px),并在cover字段引用(如assets/hero.jpg) - 纯文字报告可仅用配色 + tag,但仍须保证
accent/subtitle与页面风格一致 tag、accent、accent2、subtitle必须与页面实际视觉一致;禁止省略 mindspace-cover 或填无关默认值- 若缺少 hero 主图,封面会退化为简陋默认图,视为未达标
禁止省略 mindspace-cover 或填写与页面无关的通用配色;促销/运动/品牌页必须写明 tag、accent 和 cover。
本地对比示例:node scripts/thumbnail-preview-demo.mjs → /thumbnail-demo/