Pura X Max 这类「阔折叠」来了：外屏比普通直板机更宽更短，内屏一展开就进入大屏布局范围。很多团队的第一反应是「加一个 if PuraXMax 分支」「读取物理屏幕尺寸」「监听 orientation」。这些做法在第一台设备上能跑，但横屏、分屏、自由窗口、未来新形态一起涌来时就会全面崩溃。

文章以"烘焙助手"为完整案例：用户说"帮我查烘焙记录并计算失重率"，Agent 先调 read_baking_records 工具读取三条记录，再调 calculate_weight_loss 工具计算失重率，最后用中文给出结论。文章覆盖六大主题：环境准备与 HAR 接入（构建 HAR、声明本地依赖、INTERNET 权限）、Provider 与 LLMClient 组装（智谱/DeepSeek

纯文本对话只是 AI Agent 的起点——用户可能想拍照让 Agent 分析、想上传 PDF 让 Agent 总结。但在鸿蒙上做多模态输入，远不止"把图片转成 base64 发给模型"那么简单。智谱的视觉模型接受 image_url，DeepSeek 根本不支持图片；智谱的文档用 file_url，DeepSeek 只接受宿主提取的文本。如果你不做 pre-call 校验就把不支持的格式发给 P

调一个大模型 API，Demo 只要一次 fetch，生产要处理：并发请求互斥、请求取消、后台 dispose、网络错误到用户文案的映射，以及鸿蒙流式 HTTP 的时序坑（headersReceive 先于状态码）。本篇讲我们接入 DeepSeek 的完整调用层：单 active coordinator、generation 隔离、串行化状态迁移，和修好的那个真实的流式时序 bug。

代码 READY 不等于能上架——还差一个物料包：名称、简介、详细描述、图标、截图、分类，以及 AGC 后台一堆鸿蒙特有的表单项。物料最大的陷阱是"写着写着就夸大了"，审核发现描述与实现不符直接打回。本篇讲我们的物料包工程：归档结构、与实现逐条对齐的 listing 定稿（附真实漂移修正表）、鸿蒙分层图标与截图规格、AGC 后台的关键表单项，以及缺项如何诚实记录而不是假装完成。

代码 READY 不等于能上架——还差一个物料包：名称、简介、详细描述、图标、截图、分类，以及 AGC 后台一堆鸿蒙特有的表单项。物料最大的陷阱是"写着写着就夸大了"，审核发现描述与实现不符直接打回。本篇讲我们的物料包工程：归档结构、与实现逐条对齐的 listing 定稿（附真实漂移修正表）、鸿蒙分层图标与截图规格、AGC 后台的关键表单项，以及缺项如何诚实记录而不是假装完成。

个人开发者上架，合规是最容易"下周再说"然后被审核打回的部分。本篇给一份最小可行清单：关于页七要素、协议全文放 rawfile 应用内展示、版本号与 app.json5 同源（门禁比对）、麦克风用途文案与 module.json5 权限声明逐字复用、数据清除入口——以及每条背后的鸿蒙机制与审核逻辑。

个人开发者上架，合规是最容易"下周再说"然后被审核打回的部分。本篇给一份最小可行清单：关于页七要素、协议全文放 rawfile 应用内展示、版本号与 app.json5 同源（门禁比对）、麦克风用途文案与 module.json5 权限声明逐字复用、数据清除入口——以及每条背后的鸿蒙机制与审核逻辑。

上架前的最后一次构建，最怕的不是功能 bug，是"卫生"问题：vendor 还是 example 占位、versionCode 忘了递增、Debug 夹具混进 Release 包、拿上周的旧 HAP 冒充新构建、真机验收的和上架的根本不是同一种产物。本篇讲发布卫生的完整清单：鸿蒙工程里元数据到底住在哪、AGC 发布证书与签名配置、静态门禁逐项核对、干净重建原则，和"验收构建必须有 SHA-256"

上架前的最后一次构建，最怕的不是功能 bug，是"卫生"问题：vendor 还是 example 占位、versionCode 忘了递增、Debug 夹具混进 Release 包、拿上周的旧 HAP 冒充新构建、真机验收的和上架的根本不是同一种产物。本篇讲发布卫生的完整清单：鸿蒙工程里元数据到底住在哪、AGC 发布证书与签名配置、静态门禁逐项核对、干净重建原则，和"验收构建必须有 SHA-256"