文搜图页面已经接入真实服务导入、查询和删除按钮也有忙碌保护。但服务被其他入口复用时两次入库仍可能重叠查询期间调用释放也会提前销毁会话。这个实验用 DevEco Code 修复服务层的串行性再通过独立测试检查生成代码。实验使用 API 26 工程以及既有的三张图鉴样本。修改对象是 ImageSearchService页面与图片沿用工程基线结果按服务合同、编译结果和系统运行分别记录。需求先写成可检查的动作实验页面只处理随包图集导入三张图片输入自然语言搜索并展示图片与原始结果字段最后能移除本实验索引。图集范围、输入空值和失败提示都写进需求避免生成器自行补一个远程服务或假结果列表。任务实现本地图鉴文搜图页面。 输入固定三张图片和一条自然语言查询。 行为真实建库、查询、删除重复点击不并发建库。 状态未初始化、执行中、结果、空结果、服务失败。 资源离页释放迟到结果不刷新旧页面。 约束不使用预置相似度代替系统结果。提示词是实验输入的一部分应与工具版本一起保存。后续优化提示时标记新版本否则两次结果无法公平比较。给 Agent 足够的工程上下文提供目标 SDK、项目结构、主题样式、路由约定与实际 API 声明。避免一次上传无关的大量文件也不要把签名密钥或生产凭证放进上下文。已有服务模块时要求复用防止 AI 在页面中再建立一套索引管理逻辑。生成之后先看业务边界页面是否只负责状态展示服务是否拥有初始化与释放数据复制是否有失败清理。语法看起来像 ArkTS不代表符合 ArkTS 的静态限制也不代表调用了当前 SDK 存在的接口。编译错误只是第一层反馈静态检查可以发现类型、导入和语法问题却难以判断删除索引是否越界、请求是否属于当前页面、能力不支持时是否返回假结果。因此修复循环应从精确错误出发而不是要求 Agent “全部改好”后一次接受大量变更。每次修复记录原始问题、修改文件和验证结果。若修复引入新依赖确认它的用途和缓存位置。不要为了消除一条警告把一个真实系统调用替换为空实现。把时间拆到可比较的阶段interfaceCodingRun{runId:string;promptVersion:string;toolVersion:string;generationMs:number;manualCorrectionMs:number;buildAndTestMs:number;runtimeValidationMs:number;acceptedDefects:number;}这份应用外实验记录同时统计生成和返工。手工基线与 Agent 实验使用同一需求和验收标准最好由不同但水平接近的任务样本比较减少开发者已经熟悉答案带来的偏差。服务失败时也能判断代码质量文搜图能力可能受设备条件影响。遇到真实异常时应检查错误是否被准确展示、重复操作是否可恢复、页面离开后是否仍有结果写入。不要把系统服务不可用归为所有生成代码都错误也不能据构建成功认定功能效果通过。实验可分别记录“工程闭环通过”和“系统效果通过”。前者包括构建、失败路径与资源管理后者要求实际检索结果。这种拆分能让工具评估保持具体。交付物应让别人重复同一实验实验记录保存需求、提示版本、关键修改、构建日志、结果页和固定查询集。复盘聚焦索引作用域、迟到结果等直接影响正确性的修复聊天记录只保留与这些修改相关的片段。开发顺序为固定需求、生成服务与页面、静态检查、人工审阅、构建、运行和结果回读。工具带来的收益由这些阶段的真实记录得出不用宣传数字替代测量。把熟悉答案带来的优势从计时中分开同一开发者先手工实现再用 Agent 实现同一页面第二次会受熟悉需求影响。小规模实验可准备两项复杂度接近的页面任务交换工具使用顺序并分别报告结果样本不足时只描述过程不推广为普遍提效比例。计时暂停原因是否计入开发耗时记录方式修复生成的错误接口计入关联缺陷和修改等待编译与测试计入并单列自动阶段日志外部账号服务长期不可用单列阻塞时长不悄悄从总时长删除acceptedDefects 应明确为验收结束仍保留的缺陷数不能只统计已经发现又修复的问题。两组功能标准必须一致返回假搜索结果的页面不进入完成样本即使它生成得最快。参考DevEco Code 官方介绍、官方开发工具课程入口。把生成范围收敛为一个可检查的服务给 Agent 的上下文限定为 ImageSearchService、当前 SDK 接口声明和五项服务合同页面与素材保持不变。生成结果只允许修改服务文件避免把页面重排、素材替换和并发修复混在一起。输入范围越明确后续越容易用同一组延迟 Promise 检查前后行为。这项实验不以一次进程耗时评价效率。生成、编译、审阅和测试承担不同工作生成器提出队列结构编译器检查 ArkTS 类型独立测试控制异步完成顺序开发者核对服务的所有权和输入快照。队列必须同时照顾失败与释放队列实现为每个实例维护 Promise 链。每个任务等待前一个任务完成后再进入平台接口对外返回原始 result对内用两个空回调把链尾恢复为可继续执行的 Promise。失败仍然交给当前调用方但不会让所有后续任务被前一次 rejection 连带拒绝。初始化另放在私有 ensureReady 中。如果队列里的 insert 再等待公开 open 入队会形成任务等待自身后方任务的死锁。close 也排进同一条队列保证已经开始的查询结束后再调用 release。释放之后的新任务会重新初始化调用方仍需在离页时停止提交新任务。最终服务实现如下。平台调用集中在队列任务中入库和删除在调用时复制路径数组import{textSearchImage}fromkit.CoreVisionKit;exportclassImageSearchService{privateready:booleanfalse;staticreadonlyscope:stringArticleLab7;asyncopen():Promisevoid{if(this.ready){return;}if(!awaittextSearchImage.init()){thrownewError(文搜图服务初始化返回 false);}this.readytrue;}asyncinsert(paths:string[]):Promisenumber{constsnapshot:string[]paths.slice();awaitthis.open();letinserted0;for(constpathofsnapshot){if(path.length128){thrownewError(图片沙箱路径超过 128 字符);}if(!awaittextSearchImage.insertImage(path,ImageSearchService.scope)){thrownewError(第${inserted1}张图片入库失败可重试导入);}inserted;}returninserted;}asyncsearch(query:string):PromisetextSearchImage.ImageObject[]{constnormalizedquery.trim();if(normalized.length0||normalized.length100){thrownewError(请输入 1–100 字的图片描述);}awaitthis.open();returntextSearchImage.search(normalized,ImageSearchService.scope,10);}asyncremove(paths:string[]):Promisevoid{constsnapshot:string[]paths.slice();awaitthis.open();for(constpathofsnapshot){if(!awaittextSearchImage.deleteImage(path,ImageSearchService.scope)){thrownewError(删除图片索引失败请检查日志后重试);}}}asyncclose():Promisevoid{if(!this.ready){return;}try{if(!awaittextSearchImage.release()){thrownewError(文搜图服务释放返回 false);}}finally{this.readyfalse;}}}编译器与延迟测试各发现了什么候选实现使用 result.then 设置链尾成功回调和失败回调都返回 void。API 26 编译器对第二个回调给出了类型错误只填写第一个泛型参数时拒绝分支沿用默认类型不能接受 void 返回值。这里显式补全两个分支的返回类型constresult:PromiseTthis.queue.thenT(task);this.queueresult.thenvoid,void(():void{},():void{});returnresult;宿主测试用转译后的源码控制 Promise 时序不会执行 ArkTS 的完整类型检查因此逻辑测试通过与编译失败可以同时出现。测试和编译必须分别完成不能用其中一种替代另一种。随后审阅排队输入发现闭包仍持有调用方的 paths 数组。调用发生时若第一项任务还没有完成调用方修改数组会影响第二项任务真正使用的路径。仅在 for 循环开始时复制已经太晚快照必须在入队前生成constpaths:string[][/original.webp];constpending:Promisenumberservice.insert(paths);paths[0]/changed.webp;// 排队任务仍应使用调用发生时的 original.webp。awaitpending;修复是在 insert 与 remove 的入口分别执行 paths.slice()之后任务只访问 snapshot。字符串元素本身不可变复制数组已经足够如果以后输入变成可变对象还需要明确对象字段的快照规则。检查串行化前当前修订版本入库操作不重叠失败通过查询完成后才释放失败通过空查询不初始化通过通过原始错误码传播通过通过排队输入保持调用时路径失败通过API 26 类型检查与构建通过通过这五项针对性检查采用真实服务源码与可控的平台替身另有八项既有服务回归包含初始化失败后重试及按作用域删除。通过延迟 Promise测试能稳定复现并发和提前释放无需依赖一次偶然较慢的设备调用。在设备上复用相同业务动作该工程最低 API 为 26安装目标也必须满足最低版本。前台 API 24 模拟器不能直接安装这个实验包降低版本声明不会让新接口自动出现。选择支持 CoreVisionKit 文搜图能力的目标后按导入三张样本、空查询、正常描述、移除本实验索引、离页再进入的顺序操作并保留平台原始错误码和检索字段。队列约束作用于同一服务实例不能协调多个实例或其他应用对同一系统能力的使用。页面离开后还要拦截迟到结果close 排队也不代表取消已开始的系统任务。用于文章的运行图片应覆盖真实结果或具体错误单纯打开页面无法验证文搜图效果。这次修复保留了系统接口与原有作用域新增的是调用顺序、失败后的队列恢复和排队输入快照。编译器与独立时序测试分别发现 Promise 泛型和可变输入问题。下一次复用同类服务时这两项检查可以直接进入验收清单。图表输入、当前五项复跑和删去的历史数字范围见第16篇可复算证据收口。