用途：指导在自定义视图插件或独立前端页面中调用明道云 HAP V3 接口，搭建页面、实时获取和操作 HAP 应用数据，覆盖从零搭建应用到数据操作的完整工作流。
主要能力：三种鉴权方式的请求头配置（AppKey + Sign 用 HAP-Appkey、HAP-Sign；PAT 与 OAuth 2.0 用 Authorization: Bearer 与 HAP-Appid）；工作表创建（POST /v3/app/worksheets）；记录创建与批量操作（POST /v3/app/worksheets/{worksheet_id}/rows）；记录查询（POST /v3/app/worksheets/{worksheet_id}/rows/list）；关联数据获取（GET /v3/app/worksheets/{worksheet_id}/rows/{row_id}/relations/{field_id}）；用户 ID 查询（POST /v3/users/lookup）。
必要用法：鉴权密钥可优先从已配置的 HAP MCP 配置中提取（url 指向 api.mingdao.com/mcp 或 api2.mingdao.com/mcp，含 HAP-Appkey 走 AppKey+Sign，否则读 headers.Authorization 的 Bearer 令牌），也可手动从明道云后台获取。查询时顶层 Filter 须为 group，最多两层嵌套；选项字段写入和筛选必须使用选项 key 数组，数值筛选的 value 须为字符串数组；关联字段用 in 或 eq 并传 rowid，V3 API 无 belongsto 运算符。
适用场景：服务端集成、个人脚本工具、第三方应用集成，示例含客户信息表等业务数据结构搭建与查询分析。
限制：资料注明选项字段不能用显示文本，数值字段写入数字读取返回字符串，附件上传为异步通常需 5-10 秒且读取用 downloadUrl；Filter 不支持 belongsto，Lookup、Formula、SubTable 等多数字段类型 API 创建不支持；批量操作一次最多 100 条，含关联字段建议每批 30-50 条。文档依据 references/hap-api-usage-guide.md，其余文档细节暂未提供。