HarmonyOS Agent跨设备接力:会话摘要如何控制信息边界【共创稿事节】
专题:独立文章 工程案例:接力口袋 阅读定位:多设备会话移交

用户在手机上查找行程,到平板上接着整理表格,简单复制全部聊天历史不仅消耗上下文预算,还可能把与当前任务无关的个人信息传到了另一台设备。AI辅助工具可以生成候选代码,但工程负责人仍要对文件影响面、输入数据与最终产物负责。引入工具的第一步是定义拒绝什么,而非让它尽可能多做。以接力口袋为线索,本文先确认事实,再把关键代码和异常路径放在同一问题中讨论。将会话分成目标、已确认事实、待办、授权范围和不可移交数据五部分,移交包先由规则处理,再经用户可见的范围确认。
01 把工具建议拆成可执行的审阅任务

完整的问题单至少包含这些依赖节点:任务分类 → 摘要压缩 → 设备能力核验 → 用户确认 → 接续执行。对于接力口袋,输入来源、业务状态和预期的结束条件必须可以互相核对。采集证据要遵守最小必要原则:有任务代号、阶段、结果就够用时,不应把用户输入原文顺手存进调试日志。
先给所有参与者一份相同的路径和证据,再讨论如何调整代码。将会话分成目标、已确认事实、待办、授权范围和不可移交数据五部分,移交包先由规则处理,再经用户可见的范围确认。记录里只保留必要的测试数据与资源键,既能定位问题,也不额外暴露用户信息。
02 确定数据由谁持有
业务层至少要清楚描述当前处于哪个阶段,以及哪些事件有权改变它。将会话分成目标、已确认事实、待办、授权范围和不可移交数据五部分,移交包先由规则处理,再经用户可见的范围确认。 以接力口袋为对象,应明确何时创建、何时变更以及何时撤销这些状态,并将每条判断变成单元测试输入。
本篇将可独立验证的判断收进Handoff.ets,系统能力调用留在外部适配层。工具自动生成的代码必须通过同一组规则验证,而不能依赖模型给出的完成说明。 具体平台函数与受支持设备应以目标API和对应工具链文档为准;纯逻辑通过不等于完整工程已经在实机验证。
03 触发时机:跨设备移交只保留当前任务需要的事实
跨设备移交只保留当前任务需要的事实,例如日期和已选项,而不是把历史对话逐字拼接。这里建议记录一次失败的可见表现,再记录修复后允许的表现;仅有成功日志,无法证明边界已经收紧。工程上应先明确对象由谁维护,以及边界被跨越时谁负责失效。如果责任边界模糊,最终常见的现象是页面看起来正确,后台却仍沿用旧值。为了后续升级,字段名称和含义应写入版本化契约。即使只增添一个可选字段,也要明确旧客户端会如何处理。
04 资源归属:摘要中的来源要标记用户已确认或工具返回

摘要中的来源要标记用户已确认或工具返回,避免新设备把推测性的建议误当成确定命令。这一步值得补一条反例:输入字段缺失、版本倒退或者事件乱序时应发生什么。反例能逼出方案里没有声明的默认行为。对这类问题,最有价值的工作不是再加一层条件判断,而是把输入、输出和副作用写成契约。契约的好处在于遇到新设备或新版本时,团队能具体定位哪个假设发生了变化。验证时不仅看功能完成,还应观察资源是否被释放、老事件是否继续到达,以及页面退出后有没有未完成的后台任务。
05 数据边界:接收设备的可用工具与权限可能不同
接收设备的可用工具与权限可能不同,移交前应判定哪些待办可执行,哪些只能转成阅读内容。如果该流程以后扩展到平板或PC,业务契约应独立于窗口尺寸。把归属写在应用层,布局更换不应改变结果的合法性。不要把此处的实现当作独立小功能,它会影响错误恢复、缓存更新和用户反馈。一旦出现中途退出或者网络重试,缺少边界条件的流程会重新暴露出设计缺口。团队的回归单要写明前置条件。仅写“进入页面点击按钮”通常不足以重现旧数据、授权失效或构建差异引起的问题。
06 异常落点:敏感字段单独划分并默认不随包移动
敏感字段单独划分并默认不随包移动,用户同意的是具体字段集合而不是一次永久授权。从审阅者的视角看,所有结论都应该落在可以执行的动作上,例如切换状态后验证哪一条数据消失,或哪一个错误必须出现。验证应当从最不顺利的一条路径开始,而不是先追求界面截图好看。只有失败时状态仍可解释,成功时的体验才有可持续的工程意义。如果缺少权威来源,界面应该承认仍待确认。把不确定状态硬翻译成成功状态,会让后面的补偿和申诉难以设计。
07 回归手段:移交记录需带schema版本和生成时间
移交记录需带schema版本和生成时间,过旧的摘要应要求重新获取或明确标注可能过期。负责这一节点的同学应提供一条可重放的最小路径,包含输入来源、触发时刻和最后的状态。任务卡写到这一层,问题就能被复核。做代码评审时可以把这条规则当成具体问题来提问:谁提供数据,何时失效,如何复核。这三件事若有一项没有答案,就不宜把结论写成已完成。实际核验要包含前后的两份快照:操作之前已经有哪些状态,操作以后哪些字段必须变化。这样即使换人执行也不容易遗漏关键点。
08 发布留痕:完成接力后只保留必要的审计摘要

完成接力后只保留必要的审计摘要,避免把每一台设备都变成完整历史数据副本。提交改动前可以把这一规则单独抽出来测试:准备两个相互冲突的事件,让结果反过来检验业务优先级是否明确。实践中最容易漏掉的是异步工作与当前页面是否仍属于同一轮业务。明确代次、版本或作用域之后,复用组件与多设备切换才不会把旧结果当成新结果。如果这一段结果完全依赖网络请求,就要把超时与重试单列出来,而不是让一个无限转动的进度控件承担错误处理。
09 关键代码:让业务判断脱离页面副作用
代码选取的是足以暴露边界条件的一小段,而非一个完整应用模板。文件Handoff.ets对应多设备会话移交;实际服务接入仍要确认目标API及平台异常处理,不能从纯逻辑正确推断设备测试已经完成。
type Handoff = { goal: string; facts: string[]; permitted: string[]; excluded: string[] };
function visiblePayload(h: Handoff, confirmed: string[]): Handoff {
const allowed = new Set(confirmed);
return { goal: h.goal,
facts: h.facts.filter(x => allowed.has(x) && !h.excluded.includes(x)),
permitted: h.permitted,
excluded: [] };
}
const payload = visiblePayload({goal:'行程整理', facts:['出发日','身份证号'],
permitted:['read'], excluded:['身份证号']}, ['出发日']);
不要把这段代码直接当作整套平台接入方式,原生接口适配另有生命周期与权限要求。这一步值得补一条反例:输入字段缺失、版本倒退或者事件乱序时应发生什么。反例能逼出方案里没有声明的默认行为。 对接力口袋来说,下一步要在目标工具链上编译适配层,核对事件结果是否确实经过了这道判断。
10 异常复盘:不要拿正常路径代替所有验收
边界1:旧摘要携带过时的出行日期。 这不是要求代码永远不报错,而是要求错误不会改变不该改变的业务数据。异常前后读取同一资源键,有助于证明这个结论。在接力口袋里,还要对照多设备会话移交的业务契约确认用户最终看到的内容、能继续采取的动作以及留下的错误证据是否一致。对照当前构建号复查,才不会把上一次遗留的现象误认为新回归。
边界2:平板没有必要工具却继续执行副作用动作。 开发调试用例要包含触发条件、预期错误类别与恢复入口。三者齐全,之后的版本回归才不需要依赖问题发现者本人。在接力口袋里,还要对照多设备会话移交的业务契约确认用户最终看到的内容、能继续采取的动作以及留下的错误证据是否一致。对照当前构建号复查,才不会把上一次遗留的现象误认为新回归。
边界3:用户拒绝移交某字段但摘要仍包含派生信息。 处理结果应通过状态而非提示语判断。无论界面展示成功还是失败,都需要找到相应的本地或服务端证据支持。在接力口袋里,还要对照多设备会话移交的业务契约确认用户最终看到的内容、能继续采取的动作以及留下的错误证据是否一致。对照当前构建号复查,才不会把上一次遗留的现象误认为新回归。
11 验收口径与准备上线的证据
发送前可预览移交字段;缺少权限时明确降级;撤回字段不会在接收设备历史摘要中反复出现。。当同一能力存在手机、平板和PC多种界面时,应先共享业务级断言,再按设备补充焦点、生命周期与布局验收。这份标准可以交给不熟悉实现细节的测试人员,由对方根据入口、数据和预期结果独立执行。
回归样本建议覆盖正常闭环、外部资源失败、操作半途离开和版本迁移四种情况。为了后续升级,字段名称和含义应写入版本化契约。即使只增添一个可选字段,也要明确旧客户端会如何处理。对多设备会话移交,能重现的测试步骤比未经验证的设备成绩更重要;尚未采集到的数值应留空,不能替代工程证明。
如果缺少设备测量或审核结果,材料应明写待验证的条件,不填写猜测的通过率。范围清晰的待办比没有来源的漂亮数字有用。对AI工具与Skill,审批记录、输入约束和最终制品应保留相互关联的标识。在这些条件之外,不应为追求一个漂亮的结论而忽略尚未验证的部分。
12 一个可以直接带回项目的检查记录
| 检查对象 | 需要回答的问题 | 保存的证据 |
|---|---|---|
| 入口 | 从哪一步触发多设备会话移交 | 操作路径与版本号 |
| 状态 | 谁拥有最终状态 | Handoff.ets对应的规则与边界用例 |
| 失败 | 出错后能否恢复 | 错误码、用户提示、恢复操作 |
| 发布 | 如何避免回归退化 | 构建回执、验收单、依赖锁 |
结语
把验收条件存进项目,比在群里口头确认一次结果更可靠。将会话分成目标、已确认事实、待办、授权范围和不可移交数据五部分,移交包先由规则处理,再经用户可见的范围确认。 在接力口袋的后续迭代中,最值得持续维护的是这份输入、边界和回归规则的对应关系。
参考资料与适用范围
更多推荐

所有评论(0)