提到 AI Agent，很多教程会先介绍规划、记忆、工具调用和多智能体协作。这些概念都重要，但初学者很容易遇到一个问题：名词大概听懂了，打开编辑器以后，还是不知道第一行代码应该写什么。。我们会逐步实现知识库问答、工单查询、草稿生成、人工确认和任务恢复。本篇先搭好项目骨架，跑通输入、调用和输出。不需要申请 API Key，也不需要安装数据库。

在接入本地图像处理能力时，我遇到过一种很有迷惑性的代码结构：ArkTS 负责界面，C++ 负责计算。看上去已经把耗时逻辑“下沉”到了 Native 层，页面应该轻松很多。但如果 ArkTS 通过同步接口调用 C++，调用期间 UI 线程依然可能一直等待。

在接入本地图像处理能力时，我遇到过一种很有迷惑性的代码结构：ArkTS 负责界面，C++ 负责计算。看上去已经把耗时逻辑“下沉”到了 Native 层，页面应该轻松很多。但如果 ArkTS 通过同步接口调用 C++，调用期间 UI 线程依然可能一直等待。

做一个任务列表页面时，我遇到了一个很容易让人怀疑点击事件的问题。页面功能不复杂：展示任务，点击“完成”按钮后，把任务状态改为已完成，同时更新按钮文字。添加和删除任务都正常，唯独点击“完成”时，界面没有变化。一开始我以为事件没触发，后来在回调里加了日志才发现：事件执行了，布尔值也已经改变，只是页面没有跟着更新。这次排查涉及的是 ArkUI 状态管理 V2。下面把问题拆开，说明为什么会出现这种情况，以

做一个任务列表页面时，我遇到了一个很容易让人怀疑点击事件的问题。页面功能不复杂：展示任务，点击“完成”按钮后，把任务状态改为已完成，同时更新按钮文字。添加和删除任务都正常，唯独点击“完成”时，界面没有变化。一开始我以为事件没触发，后来在回调里加了日志才发现：事件执行了，布尔值也已经改变，只是页面没有跟着更新。这次排查涉及的是 ArkUI 状态管理 V2。下面把问题拆开，说明为什么会出现这种情况，以