本文集包含20篇独立短篇教程，对应封面编号01—20。前10篇讨论鸿蒙应用中的端侧AI应用层架构，不将通用架构包装成鸿蒙7独有API。模型加载、推理与分词需接入实际支持的框架。所有示例均为核心代码片段，本轮未进行编译或真机验证。封面为AI生成概念插画，界面和小字不作为官方功能、事实或API依据。

模型回答“建议安排张三明天下午跟进”，人能理解，程序却很难直接处理。

“明天下午”是什么时间？张三对应哪个账号？这是一条建议，还是已经确定的任务？如果直接把整句话塞进待办系统，模糊信息就变成了真实业务数据。

解决办法，是先定义结果结构，再让模型填充。

interface TaskDraft {
  title: string;
  ownerId: string;
  dueAt: string;
  missingFields: string[];
}

function canPreview(task: TaskDraft): boolean {
  return task.title.trim().length > 0 &&
    task.title.length <= 120;
}

这个例子故意保留了missingFields。原文没有负责人，就应该明确记录缺失，而不是让模型补出一个看起来合理的人选。canPreview只判断标题是否适合进入预览，不代表完整校验或执行授权。

结构化输出需要经过三道检查。第一道检查格式：返回内容是否能够解析，必填字段是否存在，字段类型是否正确。第二道检查业务含义：负责人是否属于当前团队，时间是否有效，标题是否超长，任务是否与原文有关。第三道检查执行条件：即使结构完整，也不代表可以立即保存。用户可能只要求“先给我一个建议”。

还要区分“没有值”和“值为空”。对于负责人字段，空字符串可以表示尚未确认，但不能被解释为默认分配给当前用户。团队需要在接口契约里写清楚这些含义。

解析失败时，不要无限重试。可以允许一次受控修复，把明确的格式错误交回模型；如果仍然失败，就显示原始建议，允许用户手动编辑。

页面展示也应该反映数据状态：已识别字段正常显示，缺失字段标记为“待确认”，模型推测内容不能和原文事实混在一起。

验收不能只测试一份漂亮的JSON。还要测试缺字段、错误类型、超长内容、无效日期，以及包含未授权账号的结果。

结构化输出真正解决的，是模型结果如何进入应用的数据流程，而不是让回答看起来更整齐。

官方参考资料

1. 华为：读屏适配指南。https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V14/screen-reading-adapt-guide-V14
2. 华为：焦点位置设置。https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/scenario-focus-position-setting
3. 华为：字体大小单位检查规则。https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-v5/ide_font-size-unit-V5