用一句话需求让 Agent 生成鸿蒙端云一体签到 App:我的实践笔记
一句话需求,Agent 交付一整个签到应用
今天在鸿蒙开发实践中心看了一个案例:用 CodeArts Agent,从一句话需求出发,自动生成一个端云一体的鸿蒙员工签到 App。看完最大的感受是,开发的瓶颈正在从“写代码”变成“说清楚需求”。
需求长什么样
一句话需求大致是:做一个端云协同的员工签到鸿蒙应用,员工用邮箱加密码注册登录,管理员配置签到位置和班次,员工用 GPS 签到,管理员查看签到列表。需求很短,但验收点一点不少:注册要邮箱加 6 位以上密码、签到要判定范围和迟到、周末禁止签到、管理员要能看到全员记录。
五轮对话做了什么
案例把整个过程拆成五轮对话:第一轮生成 PRD,明确做什么和验收标准;第二轮生成 HLD,定下端云两层架构和接口契约;第三轮一次性生成端侧和云侧代码;第四轮部署后端到服务器;第五轮构建端侧并安装到模拟器截图验收。每一轮只需要一句话,Agent 自己完成文档、代码、部署和联调。
我觉得最值得学的是第二轮:PRD 阶段就把端云接口契约定死。很多端云联调返工,都是因为接口定义不清,后期再补代价很大。
端云架构怎么分
端侧是 HarmonyOS ArkTS,6 个页面加 4 个 Service,还有配置中心和全局状态管理,负责界面渲染和 GPS 采集;云侧是 Node.js 加 Express,三个路由组加 JWT 鉴权,负责业务逻辑和数据持久化;数据层用 MySQL,三张表分别存用户、配置和签到记录,启动时自动建表;部署用 Nginx 反代加 PM2 进程守护。
签到链路是:端侧拿 GPS 坐标,HTTP 发给后端,Nginx 反代到 Node.js 服务,服务端用 Haversine 公式算距离判定是否在签到范围内,再结合班次做迟到判定,最后写库返回结果。最早加最晚双记录策略这个细节也很有意思,兼顾了多次打卡的实际情况。
容易踩的坑
案例里列了不少避坑点,有几个我印象很深:hvigor 的鸿蒙插件不在公共 npm 仓库,要先用 DevEco Studio 打开一次项目初始化依赖;ConfigCenter 里默认 API 地址必须是空字符串,防止凭据泄露;API 24 的 Kit 改名了,@kit.ArkDataKit 要改成 @kit.ArkData;默认禁明文 HTTP,调试要配 network_security_config;生产模式下密钥缺失或过短会直接退出进程。
一点体会
Agent 能把从需求到联调的体力活接过去,但有两件事它替不了:第一是把需求说清楚,验收标准含糊,生成的东西也不会准;第二是守住安全和配置的底线,比如密钥、默认地址、鉴权这些,生成之后还是要人来把关。把这两件事做好,Agent 才真正是提效工具,而不是新的返工来源。
如果你也在做鸿蒙端云一体应用,不妨先花半小时把 PRD 和接口契约写清楚,再让 Agent 接手后面的工作,体验会好很多。
- 点赞
- 收藏
- 关注作者
评论(0)