用 HarmonyOS 开发助手做「行李拼盘」:从分箱估重到出发核对
作者:he-nan | 更新:2026-11-18
用 HarmonyOS 开发助手与 DeepSeek V4 Pro 生成元服务初始工程,围绕分箱估重、照片记录和出发核对,做一个旅行前用得上的小工具。
作品进度:已审核通过并上架。 本文记录从需求描述、工程生成到交互完善和发布准备的过程。
出门之前,我想少问几遍“带了吗”
整理行李时,我经常面对三个问题:
- 放在哪里? 证件、电脑、衣物分散在不同箱包中。
- 是不是太重? 整理过程中需要随时查看每个箱包的估算重量。
- 有没有带齐? 出门前需要按实际收纳位置重新核对。
普通文字清单能记住名称,却很难同时表达“放在哪里”和“是否重新核对过”。
我想做的工具叫「行李拼盘」:以行程组织箱包,以箱包组织物品,整理时看重量,出发时逐项核对,之后仍能查看详情和照片。
例如,周五出发,准备把衣物放进托运箱、电脑放进背包、证件放进随身包。行李拼盘就按照这样的收纳关系组织清单,出门前再逐包检查。
我怎样向开发助手描述需求
使用环境与生成入口
- 开发环境: DevEco Studio。
- AI 插件: HarmonyOS Dev Assistant,工程保留的插件标记版本为 0.1.70。
- 使用特性: 元服务生成。
- 模型选择: DeepSeek / DeepSeek V4 Pro。
选择“元服务生成”和模型后,在输入框中描述行程、箱包、物品与核对流程,再发起生成。

图 1:实际使用的开发助手界面,展示功能模式与模型选择。
把提示词写成可以检查的规则
首轮提示词没有只写“做个旅行工具”,而是描述了能判断对错的业务规则:
- 一个行程可以包含多个箱包,每件物品属于某个箱包。
- 物品填写数量和单件重量,箱包填写重量上限;重量用数量乘以单件重量汇总。
- 物品可以编辑、移动和勾选;修改后核对状态需要同步。
- 数据保存在本机,保存失败要给出反馈。
- 提供静态 2×2 卡片入口;不把静态内容伪装成实时重量。
- 首版不做登录、支付、自动称重、航司规则查询和未经验证的图片识别。
先把流程、校验和失败状态说清楚,生成结果才有可以逐项检查的标准。 原始提示词与插件会话均已留存。
开发准备参考了官方插件配置指南和一站式生成元服务指南。
生成了工程,还要看真正的编译结果
插件会话记录保留了页面、数据模型、本机存储和卡片相关的生成过程,也保留了编译失败与修复。
第一次构建出现了页面组件未导出、组件调用不符合语法等错误。修复后,两次构建输出出现了 BUILD SUCCESSFUL,产物为未签名 HAP。
这里需要区分:工具状态显示 completed 只说明调用结束,判断构建结果还要看编译器输出和实际产物。
我将生成过程拆成三个检查点:
- 工程生成: 页面、数据模型、存储与卡片文件是否齐全。
- 编译结果: 是否通过构建并生成对应产物。
- 业务运行: 能否在设备上完成核心操作。
从初始工程到目前提交审核的版本,产品逐步补充了日期选择、常用物品管理、出发确认、照片和图片清单,让整理行李的流程更完整。
把“记东西”做成一次出发的完整流程
创建行程 → 分箱装物 → 查看估重 → 设置提醒 → 出发核对 → 查看详情。
先选常用物品,再改自己的差异
反复输入“充电器”“雨伞”和重量,很容易让整理清单本身变成负担。因此,输入过程尽量以选择和微调为主:
- 日期通过选择器选择。
- 箱包和物品提供预设名称与参考重量。
- 数量和重量支持加减按钮,也保留手动输入。
基础物品可以编辑、添加和删除,最多保存 100 个。进入某个箱包后,可以多选常用物品批量加入,再分别调整数量、重量和照片。

图 2:开发过程中的真机截图,展示一次选中两件常用物品的交互。
预设只负责减少输入。物品重量是可修改的估算值,箱包上限也由用户设定,不能据此判断某次航班的实际托运规则。
分箱之后,核对不能只有一个“完成”按钮
我把出发设计成单独的核对过程:进入行程,点击出发,检查各箱包中的物品,再确认身份证或护照、手机、充电器、钥匙、钱包或支付方式等关键项。
核对页面对应三种状态:
- 没有清单: 直接提供编辑入口;没有箱包时可以添加。
- 尚未核对完: 物品或关键项未全部确认时,不能完成出发。
- 清单发生变动: 撤销原来的出发确认,提醒重新检查。
确认动作由此对应一份具体清单,帮助用户逐项检查。
提醒之后,还要能回到详情
每个行程可以设置提前天数和提醒时刻,通过系统日历界面确认创建提醒。用户需要完成系统确认;如果要修改或删除已经创建的日历事件,目前仍需在系统日历中处理。
行程按出发日期排列。已经确认或出发的行程仍能打开只读详情、查看箱包和物品照片,不会因为完成出发就失去查找入口。
照片和清单,各自解决不同的问题
物品照片可以拍摄,也可以从本机相册选择。相册导入后复制到应用本地,详情中可以打开大图。
当前版本提供两种查看方式,生成图片时沿用所选模式:
- 明细表: 突出数量、重量和核对状态。
- 照片清单: 优先展示已有照片,没有照片时按名称匹配默认图标。
分享操作为:生成 PNG 长图 → 预览 → 确认保存到相册 → 从系统相册分享。
从“一页堆满”改成四个明确入口
早期页面把行程、整理、常用物品都集中在首页,找功能很费劲。后续改成四个底部入口:
- 首页: 查看当前行程和整理进度。
- 行程: 按出发日期查看全部行程。
- 基础物品: 维护常用物品和参考重量。
- 关于: 查看版本、作者、反馈方式与协议。
行程卡片采用稳定的多色配色辅助区分;超重状态保留文字提示,避免只凭颜色判断。关于页提供作者 he-nan、版本、公开反馈邮箱,以及独立的隐私政策和用户协议页面;邮箱支持复制,协议页面保留明确的返回入口。
这些调整来自开发过程中的实际反馈,重点是让常用操作更容易找到。
发布准备暴露了哪些遗漏
卡片与快照需要对应
平台曾报告卡片与快照不匹配:工程声明了一张 2×2 卡片,却缺少对应快照。
处理方式是补充 EntryCard/entry/base/snapshot/luggageWidget-2x2.png,重新构建,再检查发布包中的 pack.res 是否包含对应快照。除了检查源目录,也需要检查实际上传包中的资源。
隐私政策需要对照实际权限
另一项问题是平台隐私政策模板多声明了图片和视频权限,与软件包不一致。这个过程提醒我:用到照片功能,不等于应该勾选所有相册权限;政策应对照实际声明和实际使用方式填写,不能靠增加无关权限来消除提示。
审核过程中曾收到数量输入问题反馈:物品数量应为整数。修复输入过滤与数据层校验,并完善基础物品重量更新后,作品已审核通过。截至 2026 年 11 月 18 日,行李拼盘已上架。
我希望开发助手进一步改善的地方
基于本次生成记录,我有三条具体建议:
- 把构建状态展示得更明确。 区分工具调用结束、编译失败、编译成功和签名产物生成,失败时突出第一条可操作的错误。
- 生成卡片时一并检查发布资源。 对照卡片名称、尺寸和数量检查 EntryCard 快照,提前发现包解析问题。
- 长任务提供可恢复的阶段结果。 列明已生成文件、已完成步骤、待修复问题和下一步操作,避免用户只能反复输入“继续”。
这些是个人体验建议,不代表已确认的插件通用缺陷。不同模型、插件版本和工程环境可能得到不同结果。
如果你也经常在出门前反复检查行李,你更需要“物品放在哪个包里”,还是“还有哪些东西没有核对”?欢迎在评论中分享具体场景。
更多推荐

所有评论(0)