作者:he-nan | 更新:2026-11-18

用 HarmonyOS 开发助手与 DeepSeek V4 Pro 生成元服务初始工程,围绕分箱估重、照片记录和出发核对,做一个旅行前用得上的小工具。

作品进度:已审核通过并上架。 本文记录从需求描述、工程生成到交互完善和发布准备的过程。

出门之前,我想少问几遍“带了吗”

整理行李时,我经常面对三个问题:

  • 放在哪里? 证件、电脑、衣物分散在不同箱包中。
  • 是不是太重? 整理过程中需要随时查看每个箱包的估算重量。
  • 有没有带齐? 出门前需要按实际收纳位置重新核对。

普通文字清单能记住名称,却很难同时表达“放在哪里”和“是否重新核对过”。

我想做的工具叫「行李拼盘」:以行程组织箱包,以箱包组织物品,整理时看重量,出发时逐项核对,之后仍能查看详情和照片。

例如,周五出发,准备把衣物放进托运箱、电脑放进背包、证件放进随身包。行李拼盘就按照这样的收纳关系组织清单,出门前再逐包检查。

我怎样向开发助手描述需求

使用环境与生成入口

  • 开发环境: DevEco Studio。
  • AI 插件: HarmonyOS Dev Assistant,工程保留的插件标记版本为 0.1.70。
  • 使用特性: 元服务生成。
  • 模型选择: DeepSeek / DeepSeek V4 Pro。

选择“元服务生成”和模型后,在输入框中描述行程、箱包、物品与核对流程,再发起生成。

HarmonyOS 开发助手:元服务生成模式,使用 DeepSeek V4 Pro

图 1:实际使用的开发助手界面,展示功能模式与模型选择。

把提示词写成可以检查的规则

首轮提示词没有只写“做个旅行工具”,而是描述了能判断对错的业务规则:

  • 一个行程可以包含多个箱包,每件物品属于某个箱包。
  • 物品填写数量和单件重量,箱包填写重量上限;重量用数量乘以单件重量汇总。
  • 物品可以编辑、移动和勾选;修改后核对状态需要同步。
  • 数据保存在本机,保存失败要给出反馈。
  • 提供静态 2×2 卡片入口;不把静态内容伪装成实时重量。
  • 首版不做登录、支付、自动称重、航司规则查询和未经验证的图片识别。

先把流程、校验和失败状态说清楚,生成结果才有可以逐项检查的标准。 原始提示词与插件会话均已留存。

开发准备参考了官方插件配置指南和一站式生成元服务指南。

生成了工程,还要看真正的编译结果

插件会话记录保留了页面、数据模型、本机存储和卡片相关的生成过程,也保留了编译失败与修复。

第一次构建出现了页面组件未导出、组件调用不符合语法等错误。修复后,两次构建输出出现了 BUILD SUCCESSFUL,产物为未签名 HAP。

这里需要区分:工具状态显示 completed 只说明调用结束,判断构建结果还要看编译器输出和实际产物。

我将生成过程拆成三个检查点:

  1. 工程生成: 页面、数据模型、存储与卡片文件是否齐全。
  2. 编译结果: 是否通过构建并生成对应产物。
  3. 业务运行: 能否在设备上完成核心操作。

从初始工程到目前提交审核的版本,产品逐步补充了日期选择、常用物品管理、出发确认、照片和图片清单,让整理行李的流程更完整。

把“记东西”做成一次出发的完整流程

创建行程 → 分箱装物 → 查看估重 → 设置提醒 → 出发核对 → 查看详情。

先选常用物品,再改自己的差异

反复输入“充电器”“雨伞”和重量,很容易让整理清单本身变成负担。因此,输入过程尽量以选择和微调为主:

  • 日期通过选择器选择。
  • 箱包和物品提供预设名称与参考重量。
  • 数量和重量支持加减按钮,也保留手动输入。

基础物品可以编辑、添加和删除,最多保存 100 个。进入某个箱包后,可以多选常用物品批量加入,再分别调整数量、重量和照片。

开发过程中的批量选物界面,展示选中两件常用物品

图 2:开发过程中的真机截图,展示一次选中两件常用物品的交互。

预设只负责减少输入。物品重量是可修改的估算值,箱包上限也由用户设定,不能据此判断某次航班的实际托运规则。

分箱之后,核对不能只有一个“完成”按钮

我把出发设计成单独的核对过程:进入行程,点击出发,检查各箱包中的物品,再确认身份证或护照、手机、充电器、钥匙、钱包或支付方式等关键项。

核对页面对应三种状态:

  • 没有清单: 直接提供编辑入口;没有箱包时可以添加。
  • 尚未核对完: 物品或关键项未全部确认时,不能完成出发。
  • 清单发生变动: 撤销原来的出发确认,提醒重新检查。

确认动作由此对应一份具体清单,帮助用户逐项检查。

提醒之后,还要能回到详情

每个行程可以设置提前天数和提醒时刻,通过系统日历界面确认创建提醒。用户需要完成系统确认;如果要修改或删除已经创建的日历事件,目前仍需在系统日历中处理。

行程按出发日期排列。已经确认或出发的行程仍能打开只读详情、查看箱包和物品照片,不会因为完成出发就失去查找入口。

照片和清单,各自解决不同的问题

物品照片可以拍摄,也可以从本机相册选择。相册导入后复制到应用本地,详情中可以打开大图。

当前版本提供两种查看方式,生成图片时沿用所选模式:

  • 明细表: 突出数量、重量和核对状态。
  • 照片清单: 优先展示已有照片,没有照片时按名称匹配默认图标。

分享操作为:生成 PNG 长图 → 预览 → 确认保存到相册 → 从系统相册分享。

从“一页堆满”改成四个明确入口

早期页面把行程、整理、常用物品都集中在首页,找功能很费劲。后续改成四个底部入口:

  • 首页: 查看当前行程和整理进度。
  • 行程: 按出发日期查看全部行程。
  • 基础物品: 维护常用物品和参考重量。
  • 关于: 查看版本、作者、反馈方式与协议。

行程卡片采用稳定的多色配色辅助区分;超重状态保留文字提示,避免只凭颜色判断。关于页提供作者 he-nan、版本、公开反馈邮箱,以及独立的隐私政策和用户协议页面;邮箱支持复制,协议页面保留明确的返回入口。

这些调整来自开发过程中的实际反馈,重点是让常用操作更容易找到。

发布准备暴露了哪些遗漏

卡片与快照需要对应

平台曾报告卡片与快照不匹配:工程声明了一张 2×2 卡片,却缺少对应快照。

处理方式是补充 EntryCard/entry/base/snapshot/luggageWidget-2x2.png,重新构建,再检查发布包中的 pack.res 是否包含对应快照。除了检查源目录,也需要检查实际上传包中的资源。

隐私政策需要对照实际权限

另一项问题是平台隐私政策模板多声明了图片和视频权限,与软件包不一致。这个过程提醒我:用到照片功能,不等于应该勾选所有相册权限;政策应对照实际声明和实际使用方式填写,不能靠增加无关权限来消除提示。

审核过程中曾收到数量输入问题反馈:物品数量应为整数。修复输入过滤与数据层校验,并完善基础物品重量更新后,作品已审核通过。截至 2026 年 11 月 18 日,行李拼盘已上架。

我希望开发助手进一步改善的地方

基于本次生成记录,我有三条具体建议:

  1. 把构建状态展示得更明确。 区分工具调用结束、编译失败、编译成功和签名产物生成,失败时突出第一条可操作的错误。
  2. 生成卡片时一并检查发布资源。 对照卡片名称、尺寸和数量检查 EntryCard 快照,提前发现包解析问题。
  3. 长任务提供可恢复的阶段结果。 列明已生成文件、已完成步骤、待修复问题和下一步操作,避免用户只能反复输入“继续”。

这些是个人体验建议,不代表已确认的插件通用缺陷。不同模型、插件版本和工程环境可能得到不同结果。

如果你也经常在出门前反复检查行李,你更需要“物品放在哪个包里”,还是“还有哪些东西没有核对”?欢迎在评论中分享具体场景。


相关资料:活动页面 · 配置插件 · 一站式生成元服务

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐