智能助理同时查询本地日程缓存与在线项目状态。在视觉设计稿里,这往往只是一个局部问题;真正进入 HarmonyOS 工程后,两个工具给出的更新时间不同,模型直接选一个结果会产生错误承诺。这类故障并不总会留下清晰的异常栈,反而常常出现在用户认为页面已经准备好时。这里选择 AgentReferee 的 EvidenceResolver.ets 作为最小切入点,将业务规则和界面表达拆开讨论。

HarmonyOS Agent工具结果冲突:从证据优先级到可解释回退【共创稿事节】 技术封面

一、从业务症状找到系统边界

引入来源、时间戳和置信约束,冲突时把确认权交回用户。这一判断先于具体 API 和组件写法,因为业务目的不清楚时,技术方案通常只能照顾某一种路径。本文将需要观察的对象限制为“工具证据”“来源 A”与“来源 B”等明确状态,不用笼统的成功或失败覆盖所有分支。

反向分析“安全回退”时,最难处理的是入口条件被其他模块悄悄改写。时间戳必须携带时区和来源,不能只按字符串大小排序判定哪个更新。先用 EvidenceResolver.ets 定义负责写入的对象,再检查 来源 A 如何消费结果。高风险字段如金额和执行日期冲突时,优先输出分歧而不是擅自选边。这两项约束应落实到同一份可追踪的业务判断,不要让视觉状态和系统状态各说各话。

二、把 工具证据 的状态拆开

工具结构正确不代表信息来源可靠,要先区别系统记录与用户编辑缓存。检查用户能否感知这个差异:对使用者而言,错误不是某个变量不正确,而是下一步操作突然失去可预测性。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“工具证据”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

时间戳必须携带时区和来源,不能只按字符串大小排序判定哪个更新。讨论状态与结果的边界:需要让“发出请求”和“确认生效”有明确的界线,避免把意图包装成系统已经完成的事实。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“来源 A”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

从数据所有权看,“来源 A”不应由两个生命周期不同的组件同时维护。恢复动作应该可追溯至工具原始摘要,避免只保留结论丢失出处。与此同时,工具结构正确不代表信息来源可靠,要先区别系统记录与用户编辑缓存。选择把规则收敛到 EvidenceResolver.ets 所在的调用层,可以减少每次需求变更后要重新检查的分支数量,也能避免旧视图覆盖新的业务结论。

三、业务规则与交互投影

两份结果若实体标识不同,应先做身份对齐,而不是直接比较字段值。确定信息的所有权:这一步最容易出现多个地方各维护一份副本的情况,短期写起来省事,后续却难以说明谁应当覆盖谁。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“来源 B”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

下面的核心实现保存在 entry/src/main/ets/pages/EvidenceResolver.ets(跨端文章的语言和目录以注释及工具链项目结构为准)。它只承担当前讨论的规则,界面中其他入口应通过相同模型调用,避免复制条件判断。

interface Evidence {
  entityId: string
  source: string
  timeUtc: number
  value: string
}
type Decision = { type: 'agree' | 'conflict' | 'missing'; value?: string }
function resolveEvidence(items: Evidence[]): Decision {
  if (items.length === 0) { return { type: 'missing' } }
  const ids = new Set(items.map(x => x.entityId))
  const values = new Set(items.map(x => x.value))
  if (ids.size !== 1 || values.size !== 1) { return { type: 'conflict' } }
  return { type: 'agree', value: items[0].value }
}

证据优先级应由业务制定,模型不能临时凭语言流畅程度决定可信度。从版本差异看风险:不能假设工程在一个设备上成立就可以推导出其他系统能力也具备相同接口和生命周期。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“存在冲突”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

这一决定还会影响工程协作。时间戳必须携带时区和来源,不能只按字符串大小排序判定哪个更新。当后续维护者修改 EvidenceResolver.ets 时,必须先确认“存在冲突”的来源以及它与“安全回退”之间的关系。高风险字段如金额和执行日期冲突时,优先输出分歧而不是擅自选边。清晰的数据契约能让评审围绕输入、输出和失败条件展开,减少代码审查时仅凭截图判断行为是否正确。

四、变化发生时如何守住契约

高风险字段如金额和执行日期冲突时,优先输出分歧而不是擅自选边。设计最小失败样本:好的边界测试不需要大量数据,反而应该把两个冲突的操作放在最短路径中,让问题成因清晰暴露。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“需要确认”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

工具证据 页面结构与交互状态

恢复动作应该可追溯至工具原始摘要,避免只保留结论丢失出处。决定如何留痕:可观测性不是保存更多原始数据,而是留下解释关键状态变化所需的最少字段。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“安全回退”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

相同用户动作可能对应两种不同后果。恢复动作应该可追溯至工具原始摘要,避免只保留结论丢失出处。如果随后出现 来源 A 的状态变化,工具结构正确不代表信息来源可靠,要先区别系统记录与用户编辑缓存。处理策略应根据实际完成阶段而变化:未被业务接受可以直接拒绝,已进入系统调用就需要等待明确结果,失败后是否重新尝试则由场景约束决定。

五、异常场景和回退条件

无数据、连接失败、权限不足属于不同错误类别,不应混在“未知”一个文案里。收束为验收条件:最后要把抽象的“体验更好”改写成可以被另一位工程师独立复核的结果。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“工具证据”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

工具证据 业务状态关系与验收边界

评测至少覆盖新旧版本冲突、同名不同人、时间倒序和无有效证据。先把事实固定在业务对象上:其关键不是多加一条条件判断,而是厘清这条信息由哪一层维护。在 AgentReferee 这一场景里,需要把检查位置落到 EvidenceResolver.ets 周围的调用链,而不是继续依赖用户观察到的最后一帧画面。

围绕“来源 A”这一状态,审查者可以追问两件事:发生变化之前应该保持什么,变化之后哪些操作仍然有效。若前置条件不成立,应该拒绝本次动作并给出可以恢复的路径,不能只让按钮失去响应。

反向分析“来源 A”时,最难处理的是入口条件被其他模块悄悄改写。时间戳必须携带时区和来源,不能只按字符串大小排序判定哪个更新。先用 EvidenceResolver.ets 定义负责写入的对象,再检查 存在冲突 如何消费结果。高风险字段如金额和执行日期冲突时,优先输出分歧而不是擅自选边。这两项约束应落实到同一份可追踪的业务判断,不要让视觉状态和系统状态各说各话。

六、把验证路径写给下一位维护者

在工程里建立一条可复核的路径:先让 智能助理同时查询本地日程缓存与在线项目状态,随后刻意触发 两个工具给出的更新时间不同,模型直接选一个结果会产生错误承诺 所涉及的边界,再按照本文的状态约定观察页面和回调。第一组检查保留正常输入,第二组把网络或页面生命周期切换插进执行中间,第三组关注数据复用和版本差异。三组验证必须分别记录前置状态、触发动作与预期输出。

对 AgentReferee 而言,一个合格的回归结论至少要回答:用户是否能识别“存在冲突”,业务层是否以预期条件处理“需要确认”,系统反馈与“安全回退”是否保持一致。即使在某个设备上看到理想画面,也只能证明该环境、该分支已被覆盖,其他机型与后续SDK仍需重新验证。

交接时应该保留的不是一长串条件判断,而是可执行的回归问题:评测至少覆盖新旧版本冲突、同名不同人、时间倒序和无有效证据。针对“工具证据”先复原问题入口,再观察“来源 B”的状态,最后检查 EvidenceResolver.ets 的处理结果。两份结果若实体标识不同,应先做身份对齐,而不是直接比较字段值。这样未来替换组件或升级框架时,仍能沿着业务事实确认兼容性。

七、取舍与适用范围

最终方案的核心是:引入来源、时间戳和置信约束,冲突时把确认权交回用户。这种设计会增加少量显式状态和测试工作,但也避免了回调、页面和系统资源在边界上互相覆盖。对长期维护的 HarmonyOS 应用来说,少写一个万能控制器,往往比多写几处保护分支更稳健。

代码中的可观察状态和界面效果要以所用 SDK 的实际版本、设备能力和业务输入为准。对需要进一步量化的性能指标,应通过目标工程的调试工具采集数据再比较,不能从页面截图推断耗时与资源占用。下一次改动先检查已经建立的业务契约,再决定是否允许扩展状态或更换底层实现。

参考资料

Logo

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

更多推荐