鸿蒙端云一体开发实战：用 Agent 生成员工签到 App 的完整复盘

一、场景与目标

鸿蒙（HarmonyOS）端云一体应用的典型痛点是：前端要写 ArkTS/ArkUI 界面，后端要写云函数与数据模型，两端字段、鉴权、容灾逻辑反复对齐，开发成本高。本文以「员工签到 App」为例，复盘如何借助 AI Agent 完成从需求描述到端云一体工程的生成，并梳理可复用的落地要点。

二、整体方案

方案分三层：

1. 端侧：ArkTS + ArkUI 声明式 UI，负责签到页、记录列表页、个人中心；使用 @State/@Link 管理状态，通过 HTTP/云函数 SDK 访问后端。
2. 云侧：云函数负责签到、查询、统计三类接口；云数据库存放用户、签到记录、地理围栏配置。
3. 鉴权：接入 AGConnect 认证，端侧拿到 Token 后在云函数侧校验，避免把密钥写进端侧包。

三、Agent 生成流程

在鸿蒙开发实践中心打开该案例后，可以按如下步骤复现：

• 用自然语言描述业务：签到、防重复签到、迟到判定、历史记录查询；
• 让 Agent 输出数据模型（User、CheckInRecord）与云函数接口定义；
• 基于模板骨架生成 ArkUI 页面，再由人工补充交互细节与异常态；
• 端云联调时优先验证鉴权链路，再验证业务字段。

四、关键代码片段

// 端侧签到请求（示意）
async function checkIn(userId: string, geo: string) {
  const res = await cloud.callFunction({
    name: 'checkIn',
    data: { userId, geo, ts: Date.now() }
  });
  return res.result;
}

五、踩坑与经验

1. 不要盲目信任生成结果：字段命名、错误码需要人工对齐，否则云函数返回与端侧解析容易错位。
2. 先定接口再生成 UI：接口稳定后页面生成质量明显提升，返工更少。
3. 鉴权先行：Token 校验放在云函数入口统一拦截，比在每个业务函数里各写一遍更可靠。
4. 状态管理收敛：签到状态放在页面级 @State，避免跨页共享造成时钟不同步。

六、小结

Agent 生成端云一体工程的价值不在于「一键出成品」，而在于把模板化、样板化的部分快速铺好，开发者聚焦业务规则与体验打磨。对鸿蒙应用开发来说，这套流程可以把一个签到类 Demo 的搭建时间从数小时压缩到半小时以内。