用途:当用户提到用 HAP 搭建官网、HAP 前端项目、HAP 作为数据库、企业官网、前后端分离或内容管理系统等需求时,使用本技能完成从 HAP 后台配置到前端项目搭建的完整工作流。
主要能力:设计并配置 HAP 后台数据结构;搭建 HTML/CSS/JS 前端项目;集成 HAP API V3 进行数据交互;自动启动本地开发服务器。适用企业官网、内容管理网站、数据展示平台、表单收集系统和营销落地页。
使用方式:按阶段执行。阶段1读取应用工作表列表与结构并评估差距,仅分析不写入;阶段2通过 AskUserQuestion 获得用户对新增工作表、字段或示例数据的明确确认;阶段3用 create_worksheet、update_worksheet、batch_create_records 创建结构与示例数据,每个新增工作表至少5条示例数据,附件字段必须填充图片 URL;阶段4从 MCP 配置或明道云应用设置中获取 Appkey、Sign、工作表 ID 和字段 ID;阶段5创建 index.html、css/style.css、js/config.js、js/api.js、js/main.js 等项目结构;阶段6实现带 HAP-Appkey、HAP-Sign 请求头的 API 调用、分页与筛选;阶段7动态渲染数据并处理空状态、图片失败和错误;阶段8用 python -m http.server 8000 或 npx serve -p 8000 等启动本地服务器并输出访问地址。
限制与注意:业务数据必须从 HAP 动态获取,不能写死;任何结构变更须用户确认;严禁删除已有工作表、字段或数据;SingleSelect/MultipleSelect 筛选必须使用选项 key(UUID)而非显示文本;生产环境需通过后端代理或 Serverless 保护 API 密钥。API Host 依产品线不同:明道云为 https://api.mingdao.com,Nocoly 为 https://www.nocoly.com,私有部署需在域名后加 /api。