用途：该技能提供使用明道云 HAP V3 接口搭建页面、实时获取数据和操作数据的完整指南，可在自定义视图插件或独立前端页面中调用 V3 接口编排业务逻辑。
主要能力：覆盖从零搭建应用到数据操作的完整 API 工作流，包含字段类型处理规范、Filter 筛选器完整语法、关联字段深度查询、常见陷阱与解决方案、性能优化最佳实践。
鉴权方式：所有请求需请求头 Content-Type: application/json、HAP-Appkey、HAP-Sign。可优先从 Cursor 全局设置文件（macOS 为 ~/Library/Application Support/Cursor/User/settings.json，Windows 为 %APPDATA%\Cursor\User\settings.json，Linux 为 ~/.config/Cursor/User/settings.json）的 mcpServers 中查找 hap-mcp-* 配置，从 URL 解析 HAP-Appkey 与 HAP-Sign；也可登录明道云在应用设置 API 密钥中手动获取。
常用端点：创建工作表 POST /v3/app/worksheets；创建记录 POST /v3/app/worksheets/{id}/rows；批量创建 POST /v3/app/worksheets/{id}/rows/batch；查询记录 POST /v3/app/worksheets/{id}/rows/list；更新记录 POST /v3/app/worksheets/{id}/rows/{row_id}；批量更新 PUT /v3/app/worksheets/{id}/rows/batch；删除记录 DELETE /v3/app/worksheets/{id}/rows/{row_id}；透视分析 POST /v3/app/worksheets/{id}/rows/pivot；查找用户 POST /v3/users/lookup。
关键限制：选项字段写入与筛选必须使用选项 key 而非显示文本，且即使单选也用数组；数值字段写入传数字、读取返回字符串，筛选 value 需为字符串数组；关联字段筛选须用 belongsto 操作符；Filter 顶层必须为 group，最多两层嵌套；批量操作一次最多 100 条，含关联字段建议 30-50 条；附件上传为异步，通常需 5-10 秒。triggerWorkflow 控制是否触发工作流，默认 true，数据迁移或测试可设为 false。
适用场景：在 HAP 上搭建应用结构、填充与查询数据、关联数据批量处理及数据透视分析。详细规范见 references/hap-api-usage-guide.md。