创建一个新的Tsumu网站
当用户要求在Tsumu中制作一个新网站时使用。交付物是一个真实、可编辑的Tsumu网站,不是设计描述、截图、HTML模拟或空网站。
交付物:一个私有的Tsumu导入链接
对于用户请求的新网站,stage_site_doc的成功结果会包含一个importUrl。这是请求者用于在Tsumu中打开生成的网站的交接工件。需提供该精确链接并附上构建内容的简要描述;无需额外请求该链接。该链接是私有的,不应复制到日志、无关上下文或第三方服务。切勿捏造或重构它。
分阶段的链接并非导入、发布或部署的证明。不得声称这些操作已发生。
选择工作流
- 创建新网站: 直接使用
stage_site_doc,即使没有关联现有网站。用户可以在MCP OAuth界面中授权仅创建新网站,无需站点连接代码。已有的已配对站点授权也可能支持创建新网站。 - 改为编辑用户的现有网站: 激活
tsumu-edit-site并使用配对的编辑器工具。不要复制现有网站或覆盖它。 - 没有分阶段工具或未成功授权: 不要捏造URL。如果工件创建可用,则生成一个有效的可下载
doc.json文件;否则解释缺失的能力以及可以做什么。 create_site用于在已配对的编辑器中创建一个浏览器本地的空站点。它不会上传完整的生成设计,需要重新配对新建的站点。不要将其作为stage_site_doc的替代品。
两阶段创建:自由设计,然后转换为Tsumu
第一阶段——在操作SiteDoc格式之前创建一个原创网站概念。 将用户的请求视为网站设计简报,而不是重新装饰示例JSON文档的指令。
- 确定网站的目的、受众、关键信息、页面、内容优先级和主要用户操作。对于模糊的请求(例如“创建一个漂亮的网站”),独立选择一个独特、合理的概念,而不是默认使用示例组合或提出不必要的问题。不要编造真实的地址、推荐语、产品声明或价格。
- 仿佛Tsumu节点模式不存在一样设计网站。 设计出原创的信息架构、逐页内容、章节构成、层级结构、排版、颜色、图像或图形元素、间距和响应式行为。避免机械地重复通用的英雄区/功能特性/推荐语/联系方式模板。
- 当工具和时间允许时,将完整设计草拟为独立的HTML/CSS原型(并附上清晰的交互说明)以自由探索布局。否则准备同样具体的页面和组件蓝图。这是中间设计工件,不是最终交付物,也不代表Tsumu可以通过
stage_site_doc导入任意HTML。如果不可用,则不需要实时预览。 - 对照简报审视草稿:是否有可识别的视觉身份、可信的内容、有目的的章节、清晰的用户路径和移动端布局?在查阅示例SiteDoc布局之前完善它。
第二阶段——将该设计转换为原生的、可编辑的Tsumu SiteDoc。 现在才查阅get_site_doc_spec、模式指南和最小示例,以了解有效的数据形状,而不是决定网站的外观。使用Tsumu支持的原生元素、样式、资源和交互重新构建设计的页面和布局。保留中间设计独特的构成、排版、间距、内容和响应式意图,而不是将其简化为重新着色的示例。如果某个细节不受支持,则将其调整为最接近的有效可编辑表示形式,或披露限制;切勿发明模式字段。
原创性检查: 在分阶段之前将转换后的SiteDoc与第一阶段设计进行比较。如果最终站点本质上是修改了文字、颜色或图像的捆绑示例,则转换失败:重新设计结构和构成。如果用户明确要求特定模板,则遵循该请求。
将原始设计转换为SiteDoc
在构建任何SiteDoc之前: 调用只读MCP工具get_site_doc_spec并检查其guide和example。在规划好原始设计之后,但在创建任何SiteDoc页面、节点、样式、脚本或首次尝试stage_site_doc之前执行此操作。新建站点OAuth授权后即可获得参考。不要仅仅因为加载了Skill文本就跳过它;某些MCP客户端不会自动获取参考。如果规范工具不可用,则改为阅读references/site-doc.md和references/minimal-site.json。切勿猜测数据形状。
- 将第一阶段的网站页面映射、内容和构成转换为SiteDoc。不要从示例JSON开始并替换其副本或调色板。 指南和示例仅描述有效的属性和关系。对于高级功能,请查阅当前的Tsumu
lib/types.ts、lib/presets.ts、lib/site-import-format.ts和skills/tsumu/references/site-doc.md(如果可以访问)。 - 构建一个完整的
SiteDoc对象(而不是JSON字符串、HTML页面或压缩文件)。必需字段:schemaVersion: 1、非空的siteName、pages、pageOrder、nodes、assets。首页的slug为""。页面和节点的children引用节点ID;节点是可编辑的box、image等。文本和标题使用box.text,而不是虚构的heading节点。 - 创建与设计结构匹配的有意义的原生页面布局。为节点赋予合适的语义标签、样式和响应式覆盖。保留第一阶段的实际层级结构、间距、排版对比度、视觉强调和章节变化。检查导航目标、替代文本、对比度和移动行为。避免损坏的资源、空链接、占位符内容和屏幕外元素。
- 如果设计包含动画、脚本、组件或表单行为,请查阅确切的当前类型定义并仅实现支持的结构。脚本元素目标使用目标节点的HTML
attrId,不是其SiteDoc节点ID;@self仅用于附加到元素的脚本。检查每个嵌套步骤和条件。不要发明运动或脚本属性,也不要将惰性按钮描述为功能性按钮。 stage_site_doc仅接受完整的SiteDoc作为doc(序列化JSON最大12 MiB)。它不接受第一阶段HTML原型、ZIP或单独的二进制资源。尽可能使用assets: {},在合适时使用经过验证的外部图片,或在限制内使用小型嵌入式dataUrl资源。不要发明Tsumu存储路径。- 对照原始设计检查生成的SiteDoc,而不是对照示例的美学标准。确保它保持完全可编辑且结构有效;如果转换丢失了独特的布局或内容,则在分阶段之前改进原生元素层级。
验证并交付
- 在分阶段之前,将最终页面与第一阶段设计进行比较,并确认它们是忠实、独立构建的网站,而不是重新装饰的最小示例。保持设计中间件私有,除非用户要求;交付SiteDoc或导入链接作为最终结果。
- 在分阶段之前,确保每个可见的设计声明都放置在
nodes[id].styles.base.default或相关的响应式覆盖中,而不是虚构的style、css或className字段。实际的CSS声明值必须是字符串。检查ID、引用、无环树和导入规则。在工具允许的范围内检查页面层次结构、响应能力和请求的交互。除非您确实预览过,否则不要说自己预览了。 - 调用
stage_site_doc({ doc: <完整SiteDoc> });仅当用户请求特定的自托管Tsumu安装时才使用editorOrigin。 - 成功的新网站交接包括工具的精确
importUrl作为请求者的可点击链接,以及一个简短说明,即打开该链接会导入一个新的可编辑网站。该链接不是已发布网站的URL。 - 如果失败,请说明实际错误,并避免声称网站已保存。不要用虚构的链接替换失败的工具操作,或悄悄切换到现有网站。
- 该链接在其URL片段中包含私有访问令牌,有效期为一小时,并在Tsumu确认成功导入后被消耗。不要将其透露给他人。失败的导入可在临时五分钟声明租约到期后重试。
交接示例(仅作说明): “可编辑的咖啡馆网站已准备好导入。私有Tsumu导入链接下一小时内有效。”实际操作时,交接包括分阶段成功时工具生成的真实链接。