跳到主要内容

HAP Compute 使用指南


本指南包括:认识 HAP Compute、创建与部署、管理应用、计费说明和常见问题。

一、认识 HAP Compute​

HAP Compute 是一个提供网站和后端服务托管能力的产品。开发者使用 WorkBuddy、Claude Code、Codex 等 AI 编程工具编写网站和后端代码后,可以通过 HAP Compute 快速部署上线,获得可访问的网址,无需自行准备服务器、域名和 HTTPS 证书。

HAP Compute 的主要用途是基于 HAP 应用中的数据构建网站,例如面向客户、经销商或公众的门户、商城、看板等。HAP 应用本身已具备数据管理、业务处理和页面展示能力,HAP Compute 并不替代这些能力,而是提供更加自由的网站界面、交互和自定义后端服务。两者结合使用时,业务数据和规则由 HAP 统一管理,网站界面及交互通过 HAP Compute 灵活实现。此外,HAP Compute 也支持独立运行无需连接 HAP 应用的网站,例如企业官网、活动页面等。

1.1 可以用 HAP Compute 做什么​

  • 业务门户:搭建客户门户、报名网站、经销商订货商城等,业务数据可保存在 HAP 工作表中统一管理。
  • 经营看板:创建自定义数据大屏、统计看板或移动端页面,灵活展示业务数据。
  • 自定义后端:运行价格计算、数据校验、外部接口调用等后端服务。
  • 独立网站:发布企业官网、活动页面、信息展示页面等,无需连接 HAP 应用。

查看 12个 示例应用

1.2 网站应用与后端服务​

一个 Compute 应用可以包含以下内容:

  • 网站应用 :用户通过浏览器访问的页面,例如商城、门户、展示页面和业务看板。
  • 后端服务 :执行计算、校验、调用外部系统等操作,也可以在授权范围内访问 HAP 数据。

每个 Compute 应用拥有独立的访问地址与运行环境。不同应用相互隔离,单个应用重新部署或发生故障,不会直接影响其他 Compute 应用的运行。

1.3 进入控制台​

在 HAP 首页左侧导航进入 Compute,或直接访问 Compute 控制台。

控制台用于创建和管理个人及组织内的 Compute 应用。

二、创建与部署 Compute 应用​

在 Compute 列表页面,点击右上角的 【创建 Compute】,选择创建方式:

  • 使用 Mingo:使用 HAP 内置的 AI Agent,通过对话描述需求,完成开发与部署。
  • 连接其他 AI 工具:连接 WorkBuddy、Claude Code、Codex 等 AI 编程工具,借助 CLI 和 Skills 完成开发与部署。

如果没有创建按钮,说明管理员禁止普通成员创建 Compute。

开发方式与后续维护
  • 使用 Mingo 开发的应用,需继续通过 Mingo 修改,目前暂不支持下载源码到本地开发。

  • 使用其他 AI 工具在本地开发并部署的应用,需继续在本地修改,Mingo 无法获取本地源码。

2.1 使用 Mingo​

你可以在和 Mingo 的对话中描述希望实现的功能,借助 Mingo 开发网站或后端服务,并部署到 Compute。

  1. 打开 Mingo:点击【使用 Mingo】,也可以直接唤出 Mingo 并选择 compute 工具。
  2. 发送网站需求:向 Mingo 描述所需功能、使用场景,以及需要连接的 HAP 应用和数据。
  3. 部署到 Compute:根据对话中的提示补充需求,完成开发后,让 Mingo 将应用部署到 Compute。

例如,你可以这样描述需求:

请制作一个活动报名网站,展示活动时间、地点和介绍,支持访客填写姓名、手机号并提交报名。报名信息保存到 HAP 工作表中。完成后请部署到 Compute。

2.2 连接其他 AI 工具​

如果你使用其他 AI 编程工具,可通过 HAP Compute CLI 和 Skills 连接 Compute。

  1. 在 Compute 列表页面,点击 【创建 Compute】>【连接其他 AI 工具】。
  2. 在 【安装 CLI 与 Skills】 区域点击 【复制指令】。
  3. 将指令粘贴到 AI 编程工具中发送,让 AI 按说明完成安装。
  4. 按提示在浏览器中完成明道云账号登录和授权。
  5. 由 AI 检查连接的服务地址和组织,确认连接到了本次开发的目标组织。

复制的安装指令包含服务地址、组织信息和技能包地址。AI 会据此安装或更新 CLI 与 Skills,并核对实际连接状态。部分工具安装后需要刷新会话或重启,才能加载新增的 Skills 或 MCP 工具。

如果使用外部 AI 工具时还需要 AI 创建 HAP 工作表、配置字段或业务流程,需另外连接 HAP MCP 并安装相应的 HAP Skills,具体请参考连接 HAP 应用与数据。

安装与审计提示

首次联网安装前,AI 工具会展示知情说明。Compute 会记录登录账号、组织、工具版本和操作结果用于安全审计,不记录需求、对话、代码、文件路径和密钥等内容。安装前请阅读工具给出的说明。

2.3 描述需求并连接 HAP 数据​

开始开发前,先确认要使用的 HAP 应用与数据,并向 AI 说明应用需求。

使用外部 AI 工具连接 HAP 应用与数据​

连接 Compute 后,AI 可以创建和部署网站或后端服务。如果还需要外部 AI 工具创建 HAP 工作表、配置字段或业务流程,还应连接 HAP MCP 并安装相应的 HAP Skills。

完成连接后,让 AI 核对:

  • 是否连接到了正确的 HAP 组织。
  • 当前凭据是否有权访问目标应用。
  • 是否具备本次任务所需的建表、读写数据或配置流程等能力。
应用授权范围

如果凭据只授权了部分应用,AI 新建的应用可能不在授权范围内,出现“创建成功,但后续访问无权限”的情况。此时应检查并调整凭据的应用授权范围,再让 AI 继续,避免重复创建应用。

应用授权凭据与登录用户身份的权限差异,请参考身份认证。

描述需求时,建议说明以下内容:

  • 使用者:应用面向哪些人,是否需要登录。
  • 功能:用户需要查看哪些信息、执行哪些操作。
  • 展示内容:活动时间、地点、介绍等具体内容。
  • 数据:使用已有 HAP 工作表,还是由 AI 新建;需要保存哪些字段。
  • 流程:提交后是否需要触发审批、通知等业务流程。
  • 发布目标:完成后部署到哪个组织的 Compute。

例如,你可以这样描述需求:

请制作一个活动报名网站,面向访客公开访问,无需登录。页面展示活动时间、地点和介绍,支持填写姓名、手机号并提交报名,两项均为必填。请在当前组织中创建 HAP 报名工作表保存数据,报名记录仅供主办方管理,不在网站上公开展示。完成后部署到 Compute,并验证报名信息确实保存到了工作表。

同时提供活动名称、时间、地点和介绍,可以让 AI 直接完成页面内容。尚未确定的信息可以要求标注“待公布”,避免 AI 自行编造。

补充需求与调整方案​

不必一次提供完整的技术方案,可以先描述基本需求,查看结果后再通过对话调整。对于尚未确定、但会影响数据结构、访问权限或业务处理的事项,也可以要求 AI 先提出问题或说明方案,再开始实施。

说明偏好,也可以随时调整

AI 会根据需求选择实现方式。例如,收集姓名和手机号时,AI 可能嵌入 HAP 公开表单。如果希望使用自行设计的报名表单,可以提前说明,也可以看到结果后继续对话:“请改为自定义报名表单,通过后端 API 将数据保存到 HAP 工作表。”

如果希望先了解关键方案,可以在需求末尾补充:“缺少关键信息时请先向我确认;涉及数据接入方式、权限和业务规则的选择,请先说明方案,再开始实施。”

2.4 发布与更新应用​

开发完成后,可通过对话或 CLI 发布应用。两种方式都应完成发布前检查、部署和线上验证,具体步骤及确认方式有所不同。

通过 Mingo 或 AI 对话发布​

在 Mingo 或已连接 Compute 的 AI 工具中,直接描述发布需求,例如:

请检查这个网站并部署到 Compute。部署后打开线上地址,验证页面、报名提交和 HAP 数据保存是否正常。

AI 会根据目标 Compute 支持的发布方式完成以下工作:

  1. 创建 Compute:设置名称、用途说明和图标,核对目标组织。
  2. 完成开发与配置:制作页面,连接 HAP 数据,并配置所需的服务端参数。
  3. 执行发布前检查:检查实际发布包中的密钥、个人信息等风险线索。
  4. 部署上线:等待发布完成,核对运行状态并获取真实访问网址。
  5. 验证线上功能:打开网站,验证关键操作及数据保存结果。

如果发布前检查要求人工复核,AI 会展示相关发现,等待你在对话中确认,或修改后重新检查。阻断项需要修复,不能通过确认直接跳过。

后续修改完成后,可以继续对 AI 说:

请重新部署,并验证线上版本已经更新。

遇到错误?

在开发过程或完成功能配置后,页面出现任何问题,都可以先告诉 AI, 自行排查错误并修复更新。

通过 CLI 发布(外部 AI 工具)​

使用外部 AI 工具时,也可以自行运行 CLI 命令。对于支持普通部署的 Compute,基本流程如下:

① 初始化:hap-compute init

为 Compute 建档并生成本地项目。初始化成功表示应用已登记、本地模板已生成,不代表业务网站已经上线。

② 发布前检查:hap-compute review

检查实际发布包,可能出现以下结果:

检查结果含义
放行当前检查未发现需要阻止发布的问题,可继续部署。
需要人工复核存在需要发布者判断的风险,应检查后确认或修改。
阻断发布包未通过检查,需要修复后重新检查。

发布前检查不等同于完整的代码安全审计,也不代表所有动态行为或媒体内容都已通过审核。

③ 部署上线:hap-compute deploy

对本次实际发布包再次检查,通过后上传并部署。需要人工复核时,可按 CLI 提示在终端确认;由 AI 操作时,也可在对话中确认后由 AI 继续执行。

启用了版本式发布的 Compute,应按 CLI 与 Skills 的提示完成预览和正式发布,不套用普通部署命令。

验证与后续更新​

部署命令返回成功后,还应检查 Compute 的运行状态,并打开真实访问网址验证功能。

对于活动报名网站,建议至少验证:

  • 电脑和手机上能正常查看活动信息与报名表。
  • 姓名、手机号等必填项和格式校验有效。
  • 提交后显示明确的成功或失败提示。
  • 报名信息确实保存到了目标 HAP 工作表。
  • 网站不会公开展示报名者的个人信息。

可以使用明确标记的测试数据完成验证,核对保存结果后清理测试记录。

修改网站代码后,需要重新发布才能更新线上版本。如果只是修改 HAP 公开表单、业务规则或工作流,通常无需重新部署网站,但仍应验证网站与修改后的配置兼容。

2.5 如何访问​

部署成功后,可根据访问场景选择以下方式:

  1. 直接访问或分享:

    在 Compute 控制台目标应用的 【网站应用】>【基础】 中点击访问地址打开网站,或复制链接分享。

  2. 添加为 HAP 网站应用:

    在 HAP 首页选择 【应用】>【新建应用】>【网站应用】,填写名称、选择已部署的 Compute、设置可见设备后创建,成员即可从工作台访问。详见如何创建一个应用。

  3. 嵌入 HAP 自定义页面:

    编辑自定义页面,添加 【嵌入URL】 组件并填写 Compute 网站的 HTTPS 访问地址,预览后保存。目标网站需允许被嵌入,详见自定义页面中如何嵌入 URL 页面。

HAP 入口或页面的可见权限与 Compute 网站的登录认证、数据权限分别配置,请按需检查两侧设置。

三、管理 Compute 应用​

创建并部署 Compute 后,可以进入列表、详情页,查看网站、后端服务、访问方式、日志和资源用量。

进入控制台后,可通过 【我的】 和 【全部】 切换应用范围。

具有 Compute 管理权限的用户才能看到 【全部】 页签。

在 Compute 列表中打开需要管理的 Compute,通过左侧导航切换各个栏目。页面右上角的 【Mingo 修改】 可进入 Mingo,继续通过对话调整应用;使用其他 AI 工具开发时,也可以在原项目中继续修改并发布。

3.1 概览​

【概览】 展示当前 Compute 的整体运行情况,包括运行状态、上次部署时间、近 30 天部署成功率和本月信用点消耗。

通过页面中的功能卡片,可以打开网站访问地址、复制链接,或进入网站应用、后端服务和身份认证栏目。

下方 【运行指标】 支持按时间范围查看 QPS、网站应用访问次数、后端服务调用次数和后端服务错误。QPS 表示每秒请求数量;日志采集可能存在延迟,最近的数据可能尚未完整。

3.2 网站应用​

【网站应用】 用于查看网站的基本信息、部署记录和线上文件。

查看基础信息与部署记录​

在 【基础】 页签中,可以查看网站标识、访问地址、路径、状态和上次部署时间。点击访问地址打开网站,或点击旁边的复制按钮分享链接。

下方 【部署记录】 显示版本号、部署时间和结果,当前使用的版本标记为 【当前生效】。点击对应记录的 【查看日志】,可查看该次部署过程,帮助定位部署失败的原因。

点击 【使用命令行部署】 可查看文件准备和部署命令说明。通过 AI 或 CLI 更新网站时,应在对应项目中完成修改并重新发布。

版本回退提示

回退网站版本不等于自动回退 HAP 工作表数据、工作流或全部后端配置。回退前请确认所选版本与当前业务接口的兼容性。

管理网站文件​

切换到 【文件】 页签,浏览线上文件目录,支持搜索文件、刷新目录,并查看文件路径、大小和更新时间。

进入业务网站目录后,可以上传文件,并对已有文件执行下载或删除操作。

保持线上文件与项目一致

上传或删除线上文件可能影响网站访问。建议同步维护本地项目;否则,下次从项目重新部署时,可能覆盖在线上单独调整的文件。页面中还可能显示平台资源目录,应先确认目录用途再操作。

3.3 后端服务​

【后端服务】 用于查看和管理应用的服务端程序。列表展示服务名称、状态、类型、运行环境、创建时间和描述,支持搜索及刷新。

点击服务名称或 【查看】,进入详情页,可切换 【配置】、【代码】、【版本】 和 【日志】 四个页签。

如果应用仅部署静态网站,列表可能显示 【暂无后端服务】。例如,嵌入 HAP 公开表单的网站可由 HAP 直接处理提交;改为自定义表单并通过 API 写入数据后,Compute 中就会出现相应的后端服务。

基本信息与运行配置​

在 【配置】 页签中,可以查看运行环境、状态、描述和调用方式。点击基本信息区域的 【编辑】,可修改描述、内存和超时时间,完成后点击 【保存】。

配置项说明
内存(MB)函数运行时可使用的最大内存;更大的内存同时提供更大的 CPU 规格。
超时(秒)单次运行允许的最长时间,达到超时后会被中断。
固定出口 IP连接需要配置 IP 白名单的外部系统时,可按需开启;会产生额外信用点消耗,以页面提示为准。

固定出口 IP​

需要通过固定出口 IP 连接外部系统时,可按需开启固定出口 IP。开启前会弹出确认提示,说明额外信用点消耗及关闭后的计费规则,以页面提示为准。

配置环境变量​

环境变量用于保存服务运行所需的参数,例如 API 地址、工作表 ID 和应用级访问凭据,无需将这些值写入代码。

  1. 在服务详情的 【配置】 页签中,找到 【环境变量】。
  2. 点击该区域的 【编辑】,按业务要求添加或修改变量。
  3. 保存后,重新访问网站或调用接口,检查配置是否正确。

在控制台保存的环境变量会立即应用,并在重新部署后保留。 使用 CLI 的 hap-compute env set 修改变量时,则需要再运行部署命令才能生效。

例如,自定义报名表单通过后端 API 写入 HAP 工作表时,可将 AppKey、Sign 和工作表 ID 配置为环境变量。具体变量名由应用代码决定,应按 AI 或开发者提供的说明填写。

环境变量注意事项

变量值在列表中会脱敏展示。密钥应配置在后端,不要写入前端代码。平台保留变量由系统管理,全部环境变量总大小上限为 4KB。占位值不等于有效凭据,填写后仍需验证真实接口调用。

查看访问路由​

【访问路由】 展示路由前缀地址、路由前缀和是否需要登录,并支持复制地址。

这里展示的是前缀,不一定是可直接调用的完整接口。例如,前缀为 /api,实际报名接口可能为 POST /api/registrations。具体路径、请求方法和参数由代码定义,直接在浏览器中打开 /api 返回 404,并不一定表示服务异常。

查看代码​

在 【代码】 页签中,可浏览已部署的源码目录,搜索文件并点击查看内容。此处仅展示用户源码,依赖目录、版本库和环境配置文件不提供预览。

需要修改代码时,可返回 Mingo 或原 AI 开发项目完成修改并重新发布。

查看与回退版本​

【版本】 页签列出代码版本及发布时间,并标记 【当前版本】。需要恢复旧代码时,可对允许回退的历史版本使用 【回退代码】;当前版本不可回退到自身。

回退前核对影响

回退代码不会撤销已经写入工作表或数据库的业务数据,也不等于恢复旧的环境变量。操作前应确认旧代码与当前配置、字段结构兼容,回退后重新验证接口和业务流程。

查看服务日志​

在 【日志】 页签中,可选择 【最近 1 小时】 或 【今天】,查看当前服务的日志时间、内容、级别、资源名称和请求 ID。

点击日志行左侧的展开按钮查看详细内容,或复制请求 ID,定位同一次调用的相关日志。运行异常、接口报错或超时,可先检查此页;也可以到 【日志监控】 中统一查看。

3.4 身份认证​

【身份认证】 用于设置网站访问方式和访客登录方式。

设置访问方式​

  • 公开访问:任何人都可以直接访问,无需登录。
  • 登录访问:访客登录后访问;至少开启一种登录方式后,才能选择此项。
登录与数据权限

网站是否需要登录,与用户可以查看或修改哪些业务数据,是两个不同的设置。需要限制“只能查看自己的订单”等业务权限时,应在应用逻辑及数据访问配置中落实,不能仅依靠网站登录。

配置登录方式​

  • 已支持的登录方式:明道云、钉钉、飞书。

  • 开发中的登录方式:企业微信、OAuth 2.0、OIDC、SAML 2.0、CAS

明道云登录​

启用后,点击【登录与访问设置】,配置接口权限、允许访问的应用和允许授权的人员。

点击【设置】按钮,配置明道云登录时登录名称、图标和说明。

其他方式登录​

点击【添加】按钮选择其他身份源后,按页面要求填写名称、应用 ID、应用密钥等信息。

可通过配置窗口中的 【配置指南】 查看接入说明。配置完成后,还应实际验证登录和返回网站的流程。

登录后,用户可以看到哪些 HAP 数据?​

Compute 应用可以使用应用授权凭证,也可以使用明道云登录用户的身份调用 HAP 接口。同一应用可以按功能组合使用两种方式。每次调用能访问哪些数据,取决于该次调用使用的凭证。

  • 使用应用授权凭证(AppKey、Sign):后端服务在该凭证的授权范围内访问 HAP 数据。即使员工已经登录,此类调用也不会自动按该员工在 HAP 中的个人权限筛选数据。
  • 使用明道云登录用户的身份:启用明道云登录,并配置允许访问的应用和接口后,网站可以使用当前用户的身份调用接口,按该用户在 HAP 中的可见范围展示数据。

例如,在内部销售门户中,员工通过明道云登录后,产品目录可以使用应用授权凭证读取供全体员工查看的产品资料;我的客户则使用当前员工的登录身份读取客户记录。两种方式可以同时用于一个门户,员工在我的客户中看到的记录与其在 HAP 中的可见范围一致。

3.5 日志监控​

查询日志​

进入 【日志监控】>【日志管理】,按日志类型和时间范围查询记录,支持网站访问日志和后端运行日志等,可查看请求时间、内容、结果、耗时等信息。

当网站报错、后端调用失败或运行超时时,可以先根据发生时间筛选相关日志,再检查请求结果及服务配置。

日志范围说明

Compute 的访问、部署和后端运行日志,与 HAP 应用内的数据操作记录不是同一类日志。通过 HAP 接口产生的数据修改,应结合 HAP 对应的操作日志查询。

运维监控​

在 【日志监控】>【运维监控】 中查看应用运行情况的趋势图,结合访问次数、调用次数及出错情况观察应用运行状态。

3.6 用量与消费​

用量与消费 用于查看当前 Compute 的资源用量和信用点消耗。选择日期范围后,可查看所选期间的总消耗、每日变化,以及访问次数、数据计算与存储、网站应用存储、后端服务流量与计算等资源指标。点击指标旁的说明图标,可了解统计口径。

资源用量与实际扣费可能存在差异,具体请点击右上角 【计费规则】,查看用量收费、最低费用和每日结算规则。组织信用点不足时,Compute 会自动暂停,信用点充足后自动恢复;资源保留期限及到期处理方式以页面说明为准。

四、计费说明​

Compute 按日结算信用点,维持环境运行所需的基础资源消耗也计入当日扣费。因此,「用量与消费」中各项用量折合的信用点与当日实际扣费可能略有差异。

每日计费规则​

Compute 根据当天累计启用时长,分为活跃 Compute 和非活跃 Compute,分别适用以下规则:

Compute 类型与判定条件计费方式示例
活跃 Compute:当天累计启用时长 ≥ 6 小时每个 Compute 按当天实际消耗单独计费,每个每天最低收取 1 信用点A 折合 0.40 点,收取 1 点;B 折合 2.30 点,收取 2.30 点
非活跃 Compute:当天累计启用时长不足 6 小时同一组织当天的所有非活跃 Compute 合并计费,按合计消耗收取,整组每天最低收取 1 信用点C、D 分别折合 0.30 和 0.40 点,合计 0.70 点,整组收取 1 点

按上例,组织当天合计扣费 4.30 信用点,即 A 的 1 点 + B 的 2.30 点 + C、D 合并的 1 点。

费用按日统计,于次日凌晨 01:00–02:00 发起结算。

计费项目​

各项资源用量按下表折合为信用点,再按每日计费规则计算实际扣费。

资源项单位单项计算公式(信用点)
普通访问次数次普通访问次数 × 0.000006
安全访问次数次安全访问次数 × 0.00002
数据计算用量核秒核秒数 × 0.00019
数据存储用量MB·时MB·时数 × 0.0000009765625
网站应用存储量MB容量(MB)× 占用天数 × 0.0000076953125
后端服务外网流量MBMB 数 × 0.0015625
后端服务计算用量GB·秒GB·秒数 × 0.00022216
固定出口 IP天开启天数 × 2

五、常见问题​

Q1:能否只用 Compute,不连接 HAP 应用?

可以。展示型官网、活动页等可以独立运行。如果需要统一管理客户、订单、审批和权限等业务数据及流程,建议连接 HAP 应用。

Q2:修改 HAP 工作流后,需要重新发布网站吗?

仅修改 HAP 中的业务规则或工作流,通常不需要重新部署网站。但如果修改影响了网站调用的接口、字段或返回数据结构,需要同步调整并重新部署网站。

Q3:后端服务能否长期保存业务数据?

不能依赖运行实例的内存和本地磁盘作为可靠持久化存储。需要长期保留的数据,建议使用 HAP 工作表等明确提供持久化能力的服务。

Q4:应用要求登录后,是否自动具有 HAP 数据权限?

不是。登录认证与数据访问授权是不同的控制环节。调用 HAP 接口时,实际权限取决于所使用的用户令牌或应用级凭据。

Q5:怎样查看历史版本和部署失败原因?

进入应用详情的【网站应用】查看部署记录及日志;需要排查运行中的接口错误时,在【后端服务】或【日志监控】查看相应日志。

这篇文档对你有帮助吗?