构建互动站点
托管在 https://{prefix}.interactive.vidmoat.com 的站点是用户个人互动视频的家园,周围没有我们的任何元素。视频是核心,站点是框架。每个页面都应在用户到达播放器之前完成引导。
工具:get_interactive_site、edit_interactive_site、publish_interactive_site(支持 MCP 和 API)。在应用程序中,相同调用通过 agentWorkspace 发送,附带 action: "interactive_site" 和 site: {tool, ...arguments}。
工作流程
- 先读取。 使用带
videos: true参数的get_interactive_site。它会返回站点是否存在(canCreate)、其页面、每个sectionId、问题列表(problems)和修订号(rev)。只能按sectionId修改被要求的项,并传回rev。 - 仅限已发布且共享的视频。 站点只显示账户中已发布且共享的互动视频;使用
videos: true可精确列出这些视频及其 ID。如果用户命名的视频不在列表中,则需先将其发布(publish_interactive带share: true,在用户同意后),绝不能猜测或替换为其他视频。 - 命名一次。 先用
get_interactive_site检查名称(带prefix: "名称"),限制尝试一两次,不要循环猜测。然后使用edit_interactive_site配合create: {prefix, title}创建站点。使用用户自己的姓名或品牌;每个账户只能有一个站点。 - 一套主题。
setTheme包含:tone(dark、light)、palette(warm、neutral、cool、forest、plum)、font和headingFont(system、serif、mono、rounded)、corners(soft、round、square)、density(comfortable、compact、airy)、width(normal、narrow、wide)、playerAccent(video保留每个视频自身外观,site使用站点的主题色)、accent颜色值#RRGGBB。深色主题适合电影感或夜间拍摄的素材,浅色适合教程和课程。省略某个令牌则保留其默认值。 - 首页按此顺序排列: 首先一个
hero(标题、一句话说明、最强视频作为video、一个按钮),然后是其余视频的grid,接着是说明部分(分支电影的story、text、about),最后是cta或links。只放置一个特色视频,不要放三个。 - 少量页面。 通常首页就足够了。只有当内容超过一屏时,才添加
films或about页面。setNav列出页面;setHeader提供标题、标语以及从images: true获取的 Logo。 - 批量编辑。 一次
edit_interactive_site调用包含所有ops(全部应用或全部不应用),然后读取回复中的problems。 - 展示,然后发布。 向用户提供
previewUrl(草稿的实际地址,有效期一小时)。只有当用户要求时才使用publish_interactive_site发布——它是一个公开页面。使用publish: false可立即下线。
示例
{"create": {"prefix": "river-films", "title": "River Films"}}
{"rev": 3, "ops": [
{"op": "setTheme", "tone": "dark", "palette": "cool", "headingFont": "serif", "accent": "#4CC9F0"},
{"op": "setHeader", "title": "River Films", "tagline": "Short films you play"},
{"op": "addPage", "slug": "films", "title": "Films"},
{"op": "setNav", "links": [{"label": "Home", "page": ""}, {"label": "Films", "page": "films"}]},
{"op": "addSection", "page": "", "section": {"kind": "hero", "heading": "Films where you choose what happens next", "body": "Pick a path, then go back and take the other one.", "video": "<id from videos:true>", "cta": {"label": "See every film", "page": "films"}}},
{"op": "addSection", "page": "", "section": {"kind": "grid", "heading": "Play them all", "videos": ["<id>", "<id>"], "columns": 3}},
{"op": "addSection", "page": "", "section": {"kind": "story", "video": "<id>", "heading": "How it branches"}}
]}
{"rev": 4, "ops": [{"op": "updateSection", "sectionId": "<from the digest>", "set": {"heading": "New films every month", "body": null}}]}
注意事项
- 无自定义代码。 禁止任何 HTML、CSS、脚本、嵌入或“自定义样式”;切勿提供这些选项。被拒绝的值会附带允许列表返回:从列表中选取。
- 页面
""是首页。 其他页面是 slug(如films、about);重命名 slug 后,其链接会自动更新。 - 按钮(
cta)可以是{label, page}或{label, href}(href必须是https地址)。links也必须是 https 地址。 text是受限的 Markdown: 仅支持##和###、列表、粗体、斜体、https 链接。不支持 HTML 和图片。about区块使用的图片 ID 来自images: true,绝不能是 URL。- 强调色可能被拒绝,如果其上文字或页面上文字难以阅读。深色背景尝试用较浅的强调色,浅色背景用较深的。
- 限制会被拒绝而非截断: 页面最多 6 页、每页最多 12 个区块、网格最多 12 个视频、导航链接最多 6 个、链接最多 10 个;标题最多 90 个字符、正文最多 600 个字符。内容需自行精简。
null移除updateSection中的可选字段;省略该字段则保留原值。- 搜索引擎可以找到已发布的站点(附带站点地图和视频数据)。为每个页面编写面向陌生搜索者的
title和description;setSettings中的indexing: false可在用户希望站点私有时阻止索引。 - 故事地图会破坏谜题体验。 默认情况下只显示开头和答案,并统计场景和结局数量。仅在教程或指南中使用
reveal: "full",绝不能在游戏或谜题中使用,也不能放在承诺机密的文案旁边。 - 海报很重要。 播放器和网格卡片在视频播放前显示海报;应选择海报是真实标题卡片的视频,而不是黑色的第一帧。
- 重命名地址(使用
edit_interactive_site的prefix参数)会保留旧名称并在一段时间内转发;不要随意重命名。 - Hobby 账户 会被拒绝并附带原因;直接说明,不要绕开限制。