SuperAPI AI 工具集

hostinger-headless

前端与建站

查看项目

更新于 10-25 08:08

技能介绍

用途

Hostinger Headless 是一个将提示词变为 Hostinger 线上网站的技能,负责一次完整运行:检查账户、开通主机与域名、初始化后端(需要销售时创建电商店铺)、构建前端、部署并验证结果。前端按用户意图即时构建,没有模板库;后端使用 Hostinger 真实产品:网页主机(静态或 Node.js)、域名与 DNS、Hostinger 电商(公开 Storefront API 与托管结账)、WordPress 作为无头 CMS/博客后端(通过公开 WP REST API 读取)。

前提条件

  • 已认证的 Hostinger MCP 会话。若 MCP 工具返回认证错误,需返回 entry/skill.md 重新引导。
  • 主机相关 MCP 操作(涉及店铺时还包括电商,涉及内容后端时还包括 WordPress)。各用户可用的操作不同,可在 Hostinger Connector 中切换产品组;若搜索找不到所需操作,应请用户启用对应产品组或配置限定范围的二进制(如 hostinger-hosting-mcp),而不是自行变通。
  • 有效的主机方案。Hostinger 主机是付费产品:若账户没有可用方案,应明确告知用户需要订阅,引导至 https://www.hostinger.com/web-hosting,并暂停等待用户确认购买。这不是错误,而是新账户的正常步骤。不需要主机的部分(规划、本地构建前端)可在用户决定期间继续。

操作解析

按意图优先、磁盘其次解析,不能让空目录覆盖用户请求。先检查 iterate(由明确的磁盘信号决定):

  • iterate:项目中存在 .hostinger/site.json,说明网站已通过本技能部署,用户想要修改。复用记录的域名/站点信息,只应用新意图所需的增量(改前端则重新部署;加店铺则运行 references/STORE.md 后重新部署)。绝不重新开通已有站点。
  • connect:磁盘上已有前端项目(或以 zip/导出/URL 形式引入),尚未部署到 Hostinger,且语言如“部署这个/托管这个/把它连接到 Hostinger”。触发时当前目录为空不是 create 信号。
  • create:从提示词创建新网站,没有引入任何现成内容,如“给我建一个店铺/作品集/网站”。

信号冲突时应询问用户,不要猜测。

运行流程

  1. 发现:从提示词(以及 connect/iterate 的磁盘项目)推断:是否需要店铺(任何买卖/产品意图 → 是)?是否需要所有者管理的内容——博客、新闻或任何无需重新部署即可编辑的内容(→ WordPress 后端;很少变化的静态文案不符合)?需要什么品牌、文案和结构?适合什么技术栈——简单站点用纯静态 HTML/CSS/JS(默认),需要静态输出的框架构建,或确实需要 SSR 或服务端代码时用 Node.js 应用。优先静态:部署最快且没有构建失败面。只询问无法推断的内容。
  2. 设置(references/SETUP.md):检查方案,然后在免费子域名(或用户自己的域名)上开通网站并等待就绪。
  3. 店铺(references/STORE.md,仅在需要电商时):解析或创建店铺及其自定义销售渠道,初始化商品/配送/支付,并记录 sales_channel_id 供前端使用。
  4. 内容后端(references/WORDPRESS.md,仅在需要所有者管理内容时):在专用子域名上安装 WordPress,等待就绪,并向所有者提供 wp-admin 登录链接。前端通过公开 WP REST API 读取。
  5. 构建:创建或接入前端。店铺运行遵循 references/STORE.md 的前端契约(商品目录在运行时从公开 Storefront API 获取,购物车存于 localStorage,客户端结账——绝不在网站中嵌入 API 令牌)。内容运行遵循 references/WORDPRESS.md 的前端契约(文章在运行时从 WP REST API 获取,渲染 HTML 正文,优雅的空状态)。应用需要 MySQL 时遵循 references/DATABASE.md(各运行时连接哪个主机,凭据通过环境变量或服务端配置文件,绝不放在前端)。
  6. 部署(references/DEPLOYMENT.md):归档并通过匹配的主机操作部署,Node.js 运行需轮询构建日志。
  7. 验证:curl 线上 URL 确认 200 和真实页面文案;店铺运行确认结账 POST 返回重定向 URL;内容运行确认 WP REST API 返回 200 且前端渲染文章。向用户展示线上 URL 和管理入口(hPanel:https://hpanel.hostinger.com,电商店铺仪表盘,内容用 wp-admin)。
  8. 记录:在项目中写入 .hostinger/site.json:{ "domain", "username", "type": "static"|"nodejs", "sales_channel_id"?, "store_id"?, "cms_domain"? }。这使后续运行解析为 iterate。

尽量非交互运行。必须涉及用户的例外:付费方案确认、任何花钱的操作(购买域名、新订阅)、以及提示词无法决定的真正等同选项之间的选择。

参考路径

  • 方案检查 + 网站/域名开通:references/SETUP.md
  • 店铺:初始化后端 + 前端 API 契约:references/STORE.md
  • WordPress:无头 CMS/博客后端 + 前端读取契约:references/WORDPRESS.md
  • 部署:静态 vs Node.js、归档规则、日志、验证:references/DEPLOYMENT.md
  • 数据库 + 运行时:各运行时 MySQL 主机、环境变量、轮询内容、运行时日志:references/DATABASE.md

信息来源

search 返回的 inputSchema 是请求结构的权威,调用前应阅读。有两个实时来源在冲突时优先于此处的描述:电商操作 ecommerce_miscellaneous_custom-storefront-setup-instructions 会从服务器返回当前店铺前端集成指南,任何店铺运行开始时都应执行它;Hostinger API 参考 https://developers.hostinger.com 描述了操作背后的每个端点。

适用场景

从提示词创建网站(店铺、作品集等)、将已有前端项目部署到 Hostinger、对已部署网站进行迭代修改。

限制

需要已认证的 Hostinger MCP 会话和有效付费主机方案;部分 MCP 操作需在 Hostinger Connector 中启用对应产品组;涉及花钱的操作必须由用户确认;具体价格与订阅费用暂未提供。