Agent五轮对话生成鸿蒙签到App:今天的案例浏览与DevSpace实测笔记

举报
yd_239631198 发表于 2026/11/12 12:00:36 2026/11/12
【摘要】 今天在鸿蒙开发实践中心浏览了一个案例——《使用 Agent 生成鸿蒙端云一体员工签到 App》,随后又在 AI DevSpace 里就其中一个技术点向 AI Shell 提了个问题。把这两段真实体验记下来,供同样想试试 Agent 驱动开发的朋友参考。 案例做了什么案例的起点只有一句话需求:实现一个端云协同的员工签到鸿蒙应用——员工用邮箱注册登录、GPS 签到,管理员配置签到位置、班次和提示...

今天在鸿蒙开发实践中心浏览了一个案例——《使用 Agent 生成鸿蒙端云一体员工签到 App》,随后又在 AI DevSpace 里就其中一个技术点向 AI Shell 提了个问题。把这两段真实体验记下来,供同样想试试 Agent 驱动开发的朋友参考。

案例做了什么

案例的起点只有一句话需求:实现一个端云协同的员工签到鸿蒙应用——员工用邮箱注册登录、GPS 签到,管理员配置签到位置、班次和提示语,并查看全员签到记录。

CodeArts Agent 用五轮对话把这句话变成了可运行的系统,案例里记录了真实对话过程:

  1. 第 1 轮:提出需求,生成 PRD 需求文档(功能清单、数据模型、接口定义、端云交互时序);
  2. 第 2 轮:生成架构设计 HLD,确定端云两层架构;
  3. 第 3 轮:生成端侧与云侧代码;
  4. 第 4 轮:部署后端到服务器;
  5. 第 5 轮:构建端侧并安装到模拟器,截图验收。

案例页给出的验收结果是 5/5 全部通过:健康检查、admin 登录、员工注册、员工登录+签到、管理员查看签到列表。这里说明一下:这是案例页的记录,我今天只做了浏览和阅读,没有自己重新跑一遍部署。

技术栈一句话概括:端侧是 HarmonyOS ArkTS(6 个页面 + 4 个 Service + 配置中心),云侧是 Node.js + Express + MySQL(3 个路由组 + JWT 鉴权),Nginx + PM2 部署在 FlexusL 上。签到判定里有几个我觉得有意思的设计:GPS 位置用 Haversine 公式算球面距离,再和签到半径比较;一天取最早和最晚两条记录;周末不签到;迟到判定按班次时间来。

在 AI DevSpace 里验证了一个细节

看完案例,我带着同一个问题去了 AI DevSpace(体验版,免费试用,不用额度):端侧拿到 GPS 经纬度后,后端一般如何判断员工是否在签到范围内?Haversine 公式怎么用?

AI Shell 的回答很干脆,分三步:先查考勤点(每个考勤点存经纬度和半径,比如公司大门半径 100 米),再用 Haversine 公式算员工当前 GPS 到考勤点的球面距离,最后比较 distance <= radius,在范围内就通过。

公式也给了出来:

a = sin²(Δφ/2) + cos(φ₁)·cos(φ₂)·sin²(Δλ/2)
c = 2·atan2(√a, √(1−a))
distance = R·c(R≈6371000 米)

让我印象最深的是它补的一个工程提醒:民用 GPS 精度 5~10 米,室内更差,所以签到半径要留余量——比如实际允许 100 米,可以设成 120 米,避免“站在门口却签到失败”的投诉。这个提醒和案例里“范围判定”那一节正好对得上。

案例里值得抄的避坑清单

案例附了一个 21 条的踩坑记录,几条我觉得最容易踩:

  • @ohos/hvigor-ohos-plugin 不在公共 npm registry 上,要先通过 DevEco Studio 打开项目一次来初始化依赖;oh-package.json5 里不应该声明 hvigor 插件,它是 npm 包不是 ohpm 包;
  • DEVECO_SDK_HOME 要指向 SDK 根目录,指向子目录会报 invalid;
  • API 24 的 Kit 改名了,@kit.ArkDataKit 改成 @kit.ArkData;
  • 默认禁明文 HTTP,调试要加 network_security_config.json,生产必须上 HTTPS;
  • Ubuntu apt 默认的 Node 太旧(v12),要用 NodeSource 装 Node 20;
  • hdc install 遇到 install version downgrade,先卸载再安装。

这些坑点都是案例原文里写的,我没有自己逐一复现,只是把浏览时觉得有用的记了下来。

一点体会

一句话需求到一个能跑通的端云一体应用,中间最值钱的其实不是代码行数,而是 PRD、HLD、部署联调这些环节的顺序和验收标准。Agent 把体力活接过去之后,人要把关的还是需求边界和验收:比如签到半径留多少余量、周末要不要签到、数据凭据放哪里——这些决定了做出来的东西能不能真的用起来。

如果你也在看鸿蒙端云一体的案例,建议先按案例的“快速体验”路线把现成版本跑起来、看到第一个成功结果,再回头读完整实践的 5 轮对话;遇到问题先翻 output/踩坑记录.md,里面大概率已经有答案。


本文是今天浏览案例与体验 AI DevSpace 的学习笔记,案例内容与验收结果以案例原文为准;AI Shell 的回答由 AI 生成,仅供参考。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。