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

给鸿蒙应用加一个AI入口，最容易想到的方式，是放一个输入框，再把用户的问题交给模型。

演示时很顺利。用户说“整理一下会议内容”，模型立即输出一段摘要。但当用户说“整理一下会议内容，先别保存”，问题就出现了：应用到底应该生成摘要，还是同时创建文件？

自然语言可以表达目标，真正执行的动作必须由应用控制。

意图识别的第一步，是整理应用支持的能力。例如，第一版会议助手只提供三种操作：生成摘要、提取待办、查找记录。没有必要一开始就开放任意操作。

可以先建立一个明确的动作集合：

enum Intent {
  Summarize = 'summarize',
  ExtractTasks = 'extract_tasks',
  SearchNotes = 'search_notes',
  Clarify = 'clarify'
}

interface IntentDecision {
  intent: Intent;
  requiresClarification: boolean;
  sourceText: string;
}

这里的Clarify非常重要。用户输入“处理一下这个”，既没有明确动作，也没有明确对象，应用应该追问，而不是替用户猜测。

模型返回意图之后，还需要通过业务校验。例如，生成摘要必须有可读取的原文；提取待办不能自动把推测的人名当成负责人；查找记录需要限定用户当前有权访问的数据范围。

不要把模型输出的置信度直接当作执行许可。模型自报“置信度95%”，并不代表真实准确率达到95%。阈值必须通过实际样本验证，而且高影响动作仍然需要独立授权。

在鸿蒙工程里，可以把流程分成三层：页面负责收集输入，意图服务负责产生候选动作，业务执行器负责校验和执行。这样即使以后替换模型，页面与业务规则也能保持稳定。

验收时至少准备四组输入：明确需求、模糊需求、包含否定词的需求，以及应用不支持的需求。重点检查“先别保存”“只做摘要”“不要修改原文”等限制是否被保留下来。

一个可靠的AI入口，首先应该知道什么时候执行、什么时候澄清，以及什么时候停下来。

官方参考资料

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
4. 华为：国际化和本地化。https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V13/i18n-l10n-V13