Sitesmith — 对话式网站构建器
通过几轮对话即可生成一个完整的、可选双语的网站并发布。你生成的是数据,而非代码:一个单一的 site.json 文件,由固定且设计精美的模板渲染。这使得输出稳定且可轻松换肤。
使用时机
当用户想要创建或更新网站、着陆页、个人或商业网站、作品集时使用,例如:“帮我建个网站”、“我想做个网站”、“更新我的主页”、“为我的面包房做个着陆页”。
快速参考
参考文件——仅当需要时通过 skill_view("sitesmith", "<path>") 加载:
references/site.schema.json— 每个site.json必须满足的合约references/sections.md— 14 种区块类型(含posts):使用时机、字段、文案限制references/theme.md— 主题令牌(模板、颜色、字体、圆角、密度)references/assets.md— 图片策略(占位图 / Unsplash;绝不虚构资源)references/examples/innoe.site.json— 完整的单页示例(少样本)references/examples/multipage.site.json— 多页+博客示例(少样本)
脚本——通过终端工具运行:
| 操作 | 命令 |
|---|---|
| 验证 | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| 渲染 | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir> |
| 部署 | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain> |
流程
-
收集需求(3–5 轮对话,分组提问——不要审问)。
- 业务名称 + 一句话描述他们做什么;行业 + 客户群体。
- 主要目标(电话/预订/注册/销售/展示)。
- 语言——默认使用对话语言;提供双语选项(例如 en + zh)。
- 范围:单页还是多页? 默认单页。如果他们想要更多(或提到博客),提供标准页面集(首页 / 关于 / 服务 / 博客 / 联系)并让他们精简——在构建前确认页面列表。
- 前 3–5 项服务/产品;他们的独特之处;任何真实数据;联系方式 + 主要行动号召。
- 用一两个词描述氛围(→
theme);资源(logo?品牌色?真实照片?)。 - 如果用户很简短或说“做得好看就行”,则使用合理的默认值继续(单页是安全的默认值)。
-
起草
site.json使其符合references/site.schema.json。首先研究匹配的示例(单页看innoe.site.json,多页看multipage.site.json)。为每个页面选择 5–8 个与实际内容匹配的区块(参见references/sections.md中目标→区块脊骨映射)。- 单页: 所有内容放在顶级
sections中。 - 多页: 首页保留在顶级
sections中;添加pages[](每个子页面一个条目,各有自己的sections)。导航自动从页面派生。博客是一个包含posts区块的页面(轻量级:标题卡片,无文章页面)。 选择外观(参见references/theme.md):要么在品牌具有强烈、明显美学时选择样式化模板(newchinese/cyber/portfolio),或者 — 默认方式 — 使用template:"pro"并自行设计一套定制调色板(primary/accent/neutral/font/radius/density),根据业务的感觉,使每个站点独一无二。按照references/assets.md处理所有图片。
- 单页: 所有内容放在顶级
-
验证。 运行
validate.mjs。若失败,阅读错误信息,修复 JSON,重新运行。绝不在无效文件上继续。 -
渲染。 运行
render.mjs <site.json> <out-dir>→ 在<out-dir>/dist生成静态网站。如果设置了UNSPLASH_ACCESS_KEY,渲染会自动将unsplash占位符替换为真实照片(带署名);未设置则渲染主题占位图——两者均可发布。 -
预览与迭代。 用通俗语言总结你构建的内容(“一个5页双语网站:首页、关于、服务、日志、联系”——或“一个6区块单页”)。告知用户网站始终保持完全可编辑——他们可以随时要求你添加/删除页面或区块、重写文案、更改颜色或添加博客文章。通过重新输出完整的
site.json来应用编辑,然后重新验证 + 重新渲染。 -
部署(仅在用户批准预览后)。运行
deploy.sh <out-dir> <domain>→ 通过 Nginx 上线并启用 HTTPS。报告在线 URL。
常见陷阱
- 输出是数据,不是代码。 只生成
site.json。绝不可手写 HTML/CSS。 - Schema 就是法律。 字段名和枚举值必须完全匹配;省略未知字段。
- 不虚构资源。 使用 Media
type:"placeholder"(装饰性)或"unsplash"并带query(内容照片);仅当用户提供了真实 URL 时才使用"image"。Logo 默认使用type:"text",除非存在真实的 logo 文件。 - 功能/服务优先使用图标而非图片——Lucide 名称始终可渲染并可重新着色。
- 每个 LocalizedText 包含网站所有语言。 地道地翻译;绝不留空。
- 不要过度构建。 5–8 个区块。交替区块背景色;绝不可连续两个
dark或primary。始终以hero开头,以cta或contact结尾。 - 不包含合规风险声明——不得虚构用户未提及的认证、背书、政府补贴/资助、奖项或统计数据。
- 单页是默认值。 仅当用户想要更丰富/多页网站或博客时才添加
pages[]——并先与他们确认页面列表。博客(posts)是一个标题列表,而非完整文章;需说明这点,并告知文章可以后续添加。
验证
validate.mjs退出码为0(它会打印解析后的区块顺序)。render.mjs生成<out-dir>/dist/index.html。- 部署后,
curl -I https://<domain>返回200。