@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/CHANGELOG.md

@@ -0,0 +1,1391 @@
+# 变更日志
+
+## 17.0.0 - 2026-10-29
+
+### 变更
+
+- 行为adapted-results在原扫描列后只追加处理结论、处理说明、后续事项，结论统一为无需适配、已适配、待决策；废弃结果格式及scanner4.0.0保持。
+- 行为Row ID、MODEL_ASSESSED、内部六类状态、兼容分析、修改文件与详细证据保留在分组和报告，已适配不表示编译或设备验收通过。
+
+### 新增
+
+- 增加纯格式化函数formatUpgradeResults，按原始字节哈希和逻辑行身份检查完整对应，保留原列与重复行，统一UTF-8 BOM和CRLF输出。
+- 增加可执行的Node文件调用示例，使用参数数组、node:path和pathToFileURL处理中文、空格及引号路径，并复用原子写入与占用失败提示。
+
+### 修复
+
+- 拒绝重复表头、同名处理列、缺失或错误行身份及空理由，避免误把CSV对象数组当作二维数组导致空表或原列丢失。
+- 文件示例兼容带BOM的UTF-8结果JSON，写入失败不覆盖原扫描或宣称成功。
+
+### 验证
+
+- 新增10项格式化与文档示例回归，两份真实样例在临时目录生成37行和70行的12列表，原扫描及原交付字节保持；真实Windows和Node20未新增实测。
+
+## 16.0.0 - 2026-10-29
+
+### 变更
+
+- 行为与废弃主扫描CSV分别精简为9列和8列，完整来源、符号、列号及替代证据保留在扫描JSON，findingId计算及交付布局4保持。
+- 官方资料索引仅登记当前路径和原文哈希，删除originalSourceReference、originalPath、aliases及转换函数，路径派生身份统一使用当前来源。
+- 删除整包manifest及其生成和专用校验，保留官方原文哈希与有效文档链接检查。
+- evals及专用夹具仅在本地保留并取消Git跟踪，评测缺失时明确跳过，自动测试必需夹具迁入测试目录。
+
+### 修复
+
+- 金标比较使用完整JSON区分来源与废弃符号，并核对CSV全部可见字段和重复计数，拒绝记录不一致或精简废弃表缺少JSON的比较。
+
+### 文档
+
+- 版本专题改名sdk-versions.md，列出API13起30个精确版本，Windows执行说明归入验证和排错资料，扫描器API12技术起点保持。
+- 同步两类适配流程、评估说明、报告模板和维护职责，从扫描JSON读取精简CSV移出的证据，历史原件保留。
+
+### 验证
+
+- 增加模式表头、重复与零行、当前路径身份、版本列表及可选评测回归，不含evals的复制目录通过adapter测试和结构校验。
+
+## 15.0.1 - 2026-10-29
+
+### 文档
+
+- 常见行为案例扩充为13个主题，补齐生命周期、动画、媒体、列表与UI默认值的触发条件、正反例和验证方法。
+- 新增scanner-missed-cases.md，按真实构建报错或用户明确报告的异常查询V1函数字段、卡片HSP、控制器字面量及依赖混淆案例，不接入主动核查或扫描统计。
+- 修正无参控制器构造、HSP单字段迁移、全局MIME替换及混淆开关机械恢复等误用，补齐Video失败与切源的播放意图清理边界。
+
+### 验证
+
+- 更新178项场景定义，完成6情景及正常构建对照的隔离模型走查、真实SDK示例完整构建和两个预期编译诊断复现，保留未签名、设备、卡片HSP及发布混淆回归的验证边界。
+
+## 15.0.0 - 2026-10-29
+
+### 变更
+
+- 行为流程重排为U01–U09，按变更条目完成只读评估、汇总spec并取得批准后独立修复，默认尽量保持升级前体验。
+- 删除人工初核快照、更新命令、专用读取与维护锁及测试，移除manualReview和独立适用性问题清单，保留官方索引、精确版本和scanner协议。
+- 前后对比改为修改前真实构建归档before包，修复后可生成用例再依次测试before/after，原包归档失败与后续设备阻断分别处理。
+
+### 新增
+
+- 增加单变更评估和单物理文件修复说明，少量修复由主agent完成，较多文件按物理身份分派并统一协调共享修改。
+- 增加spec与测试报告模板，三类测试范围、实际批准、原始行及阶段包证据关联到独立交付文件。
+
+### 修复
+
+- agent文档纳入活动资源和锚点校验，来源回归直接核对官方行为目录，补清原始Source Reference与官方URL的独立来源。
+
+### 验证
+
+- 更新161项场景定义并执行单变更取材及六情景编排的隔离模型走查，保留真实Windows、Node20和HarmonyOS工程构建/设备未执行边界。
+
+## 14.0.1 - 2026-10-29
+
+### 修复
+
+- 兼容性API与源码注解按自身起始版本约束compatible，区分API22、API23、API26机制门槛及C/C++编译器能力，修正告警屏蔽两种语法的混用。
+- 行为流程恢复按官方设备行为边界与真实宿主target处理跨系统差异，同步入口、模板和评测，保留不自动调整compatible、不做通用接口可用性匹配及行为复扫的边界。
+
+### 文档
+
+- 公共兼容专题聚焦API保护、告警屏蔽、CAPI加载链接及UI组件隔离；新增target升级兼容专题，公共配置与设备版本背景归入版本契约。
+- HAR专题集中说明宿主target、初始化、集成版本约束与真实库消费，行为示例改为Image解码策略和GridRow/GridCol断点参数的代码对照。
+- 补充14个机制门槛、跨系统行为及宿主集成场景，更新资料清单与148项评测资源，保留历史CHANGELOG和既往验收事实。
+
+## 14.0.0 - 2026-10-28
+
+### 变更
+
+- 废弃流程取消修改前后对比，重排为D01–D11；保留明确要求时的当前包单次设备验证、准确SDK迁移、完整构建及真实复扫。
+- 行为流程删除复扫并重排为U01–U11，不进行低版本适配、接口版本可用性匹配或最低设备验收，保持原compatible；保留官方触发/target隔离、SDK代码阅读、真实检查与构建及按需对比。
+- 公共验证、编码、HAR和原生资料按当前职责加载，联合任务仅为行为before协调，报告与进度不再补回退役状态；CSV列与布局4不变。
+
+### 文档
+
+- Context及Kit指南去除SDK文件/行号、本机与取材整理背景，改为适用场景和接口条件说明，签名/版本事实及两份指南的示例代码块保持。
+- 同步当前步骤、锚点、维护索引和134项评测资源；SDK来源及历史验收事实仍保留在维护记录，不新增适配执行器或文案镜像测试。
+
+## 13.0.2 - 2026-10-28
+
+### 文档
+
+- Context/UIContext迁移专题归入废弃目录，归并类型区别、四种来源、全局接口对照、受控服务和迁移示例，移除旧公共路径与行为流程引用。
+- 废弃接口样例按ImageKit、AudioKit、LocalizationKit统一组织接口说明、新旧代码及差异；ResourceManager按真实Kit导出归类，ArkUI内容仅在Context专题维护。
+- 通用异常、Promise失败传播与表达式迁移规则集中到公共ArkTS规范，since及低版本回退处理集中到公共兼容指南，保留Context必要判空及生命周期约束。
+
+### 修复
+
+- 按真实SDK区分UIContext各成员及重载门槛，纠正animateToImmediately无替代的旧结论；缺少CalendarPickerDialog直接成员时明确核验边界。
+- 修正材料中的不安全Context强转与无归属清理、音量接收者及off参数混用、资源ID替换业务对象等示例风险，保留回调、返回、缓存和资源语义。
+
+### 验证
+
+- 62条SDK声明及30项UI映射核对，代表性代码经隔离真实ArkTS/HAP构建；保留API20、异常、设备能力与未签名告警，不宣称最低设备或实际生命周期验收。
+- 更新内容去向清单、迁移索引、资料清单及129项场景评测；不新增适配执行器或文案镜像测试。
+
+## 13.0.1 - 2026-10-28
+
+### 文档
+
+- 行为与废弃分别采用U01–U12、D01–D12完整流程，独立维护确认、评估、修改、验证、失败返回及交付，删除共用步骤编排。
+- 两条主流程按路径引用单份公共知识；公共验证、排错与格式不再反向依赖功能流程，Context共享示例集中维护。
+- 行为取材、初核、分类及验证选择回归行为流程，废弃替代、迁移与残留判断回归废弃流程；报告各自指向对应交付节点，原布局4与CSV列保持。
+- 明确联合任务共同原基线、全部已选before、共享修改批准及最终输入一致时的构建证据复用条件。
+
+### 校验
+
+- 资料校验改为检查两条完整流程，更新步骤迁移对照与126项场景评测；保留scanner及基础维护回归，不新增适配执行器或文案镜像测试。
+
+## 13.0.0 - 2026-10-28
+
+### 变更
+
+- 删除安装器与旧安装参数，README改为OpenCode全局/项目完整目录复制，补充PowerShell写法及其他宿主目录，更新时替换旧副本。
+- 脚本统一按scanner、shared、maintenance分类，platform整体迁移至scripts/shared/platform，旧路径不留转发包装，npm命令名称保持不变。
+- 移除旧批次布局1/2/3读取及旧诊断回退，仅生成布局4；历史CSV可作为普通输入导入新批次，历史文件与验证记录不改写。
+
+### 精简
+
+- 删除未接入的scanner汇总导出、仅测试引用的进程转发层、安装专用目录复制和无生产调用的后台启动、文件名清洗、统计文案等函数。
+- 合并参数解析、文件工具及版本包装，保留严格SDK校验、API26别名、发布通道、维护可选缺失目录及跨平台文件/进程语义。
+- 删除安装、旧布局读取、固定文案/行数、模板默认字段与测试内重写统计的断言，保留有效扫描、资料与跨平台回归，脚本由94个减为84个，生产/维护模块由54个减为48个。
+
+### 验证
+
+- 完整复制后从不同工作目录运行CLI、资源校验及现有后端夹具，核对工具指纹、worker动态加载和布局4输出；AST检查无悬空相对模块引用。
+- 本机保留回归156项通过、1项既有Windows专用测试跳过，结构校验通过；未将脚本和后端夹具结果冒充真实工程、模型适配或设备验收。
+
+## 12.1.0 - 2026-10-27
+
+### 新增
+
+- 两类新扫描统一使用布局4，原始表直接写入upgrade或deprecated功能目录，适配表统一为adapted-results-<批次ID>.csv并复用同一12位随机ID，移除新交付的adaptation层。
+- 批次读取兼容旧布局1/2/3，内部扫描证据保持在批次.internal；功能目录及发布前路径重新校验，外部旧批次元数据不能绕过链接越界检查，历史交付不自动迁移。
+
+### 文档
+
+- 两类报告在功能下方前置工程、product、范围、compatible实际值和target旧值到目标值及实施状态，区分HAR历史基线、扫描区间与编译SDK。
+- 行为分组增加rowClassifications，按原始CSV逻辑行汇总无需适配、可选适配、必须适配、待分类和范围外；废弃按六类处理结果统计，重复行分别保留，CSV结果列不变。
+- 同步导入、继续任务、原始字节保护、目录引用与报告模板，旧输入复制到新批次，伴随旧元数据单独保留，不覆盖新批次身份。
+
+### 测试
+
+- 新增两类目录布局、旧批次读取、盘符/UNC、中文空格、越界链接、发布前换链和报告统计夹具回归，固定CSV夹具字节以兼容autocrlf，新增8个场景定义共122项。
+- 本机全量测试180项通过、1项既有Windows专用测试跳过，结构校验通过；后端夹具与模板检查不冒充真实工程扫描、模型业务分类或设备验收。
+
+## 12.0.5 - 2026-10-27
+
+### 修复
+
+- 行为评估先读取本地索引、人工初核和完整变更章节，仅在本地缺失、来源歧义或SDK冲突时记录原因后补充官方网页，区分scanner取材与模型实际阅读。
+- 逐组核对原始来源、历史路径映射与精确版本，沿用版本能力识别API26别名并保留Beta/Release，防止串用整表首行来源和丢失通道。
+
+### 文档
+
+- 行为分组增加knowledge与manualReview摘要，保留实际阅读范围、初核独立信息及补充资料；分析问题在逐文件reason/evidence作答，收尾回读来源、空理由、漏答与过期状态，CSV及scanner接口不变。
+- 补充Toast材质与内置文本样式分析问题，初核“否”仍须核对真实触发条件，初核未匹配不单独阻断已有充分证据的评估。
+
+### 测试
+
+- 新增四变更可移植夹具与来源、初核、历史路径、精确版本及模板契约回归，增加10个场景定义，共114项。
+- 完成一次新旧文档的隔离Codex取材对照，核查实际读取日志和产物；旧版也读本地，未复现原GLM漏读，不将有限样例、结构校验或场景定义冒充全模型、完整适配与设备验收。
+
+## 12.0.4 - 2026-10-27
+
+### 文档
+
+- 行为目标 target 未明确时提供有依据的候选并等待选择，不将实际编译 SDK 或 CSV 终点作为用户目标，保留原 target 时不伪造升级区间。
+- 行为与废弃 API 均先展示汇总修复方案，取得全部或指定部分批准后才修改源码和构建配置，方案实质变化重新确认，断点继续沿用仍适用的明确批准。
+- 行为评估后主动询问是否模拟器前后对比及无需适配、可选适配、必须适配的自由组合范围，选择仅影响用例，不改变修复批准与逐行分母。
+- 已选对比但 before 因构建、签名或模拟器等问题受阻时暂停修改，等待用户补齐条件、改为仅 after 或跳过设备验证，不自行降级。
+- 轻量进度与两类报告保留目标、方案答复、批准范围、验证分类及基线受阻后的决定，扫描器 CLI、原始扫描和结果 CSV 列保持不变。
+- 更新现有评测的批准前提及目标选择预期，新增 15 个确认场景，共 104 项；结构校验与文档走读不冒充独立模型交互或设备验收。
+
+## 12.0.3 - 2026-10-27
+
+### 文档
+
+- 将 14 篇指导按 common、upgrade、deprecated 分类，保留 changelogs、toolchain 及根目录机器数据位置，更新导航、相对链接与步骤迁移表，不保留旧根目录跳转副本。
+- 拆分行为变更与废弃 API 报告模板，S12 按模式选择；分别突出行为触发/业务影响与 SDK 替代/复扫残留，交付文件名和逐行结果格式保持不变。
+- 新增自包含的 ArkTS 编码规范，S05/S07 修改前必读兼容指南及适用编码规范，S08 按真实差异复核，不要求另装其他 Skill 或开展无关风格整改。
+- 明确每轮源码或构建配置修改后必须真实完整构建，后续源码、配置或 SDK 变化须重新验证；未编译成功只能交付部分结果，MODIFIED 仅表示已修改。
+
+### 修复
+
+- 链接校验递归覆盖分类后的指导与两份模板，继续排除官方原文；安装升级回归验证新入口可用且旧模板与入口被清理，保留 Windows 路径和锚点回归。
+- 更新 7 个现有评测的模板选择、编码依据、编译未执行/失败/失效和零命中交付要求，重新生成 42 项引用清单；24 篇官方原文、188 条策略与初核记录及 Scanner 2.0.1 保持不变。
+
+## 12.0.2 - 2026-10-27
+
+### 变更
+
+- 变更资料目录重命名为 references/changelogs，索引同步改名，正文文件统一使用小写英文及阶段前缀；保留 7 个版本目录中的 24 篇原文，正文、行号及哈希不变。
+- 删除 API12 的 14 篇文档、132 条行为策略、132 条初核记录和 138 条总览记录，当前策略与初核各保留 188 条、总览保留 195 条，引用清单收敛为 41 项。
+- Scanner 升至 2.0.1，同步默认资料路径和版本约束，保留扫描参数、CSV 字段、两种模式及批次布局。
+
+### 修复
+
+- 保留文档的原始路径及重命名前路径通过索引精确映射，保持策略和初核标识稳定；Windows 分隔符统一处理，拒绝歧义、越界及未登记来源。
+- 初核工作簿导入过滤并报告 API12 行，策略生成排除 API12 来源；其余记录继续严格校验，保留原始工作簿与来源证据。
+- 已排除的 API12 行为规则在正文解析前过滤，避免依赖已删除资料；from=12 仍覆盖 API13 变更，API12 低版本兼容与真实 SDK 废弃识别继续保留。
+
+### 文档
+
+- 按各篇主语言统一 Markdown，修正英文 Hvigor 手册中的中文标题，将中文归档计划和金标记录中的英文说明、标题与表头译为中文，保留技术标识及历史事实。
+- 更新当前指导、职责、评测和跨平台回归，不恢复远端 CI 门禁。
+
+## 12.0.1 - 2026-10-27
+
+### 文档
+
+- 新增共用兼容指南，提炼版本与打包字段、安装门槛、接口 since、行为生效、target 隔离、API26 格式及 ArkTS/UI 保护的规则和最小示例，保留官方来源与快照依据。
+- 将原生加载、弱引用与弱库、APIAVAILABLE、依赖和 ABI 验证归入原生专题，将源码/字节码 HAR 约束、真实宿主 target 及集成态 HSP 区别归入 HAR 专题。
+- 补充 IDE、SDK 与命令行工具配套核对，以及最低兼容版本、边界两侧、新接口实际调用和宿主场景的验收要求，更新 Skill 导航与共用流程。
+- 删除旧“应用升级适配与兼容性”目录的 22 篇原文及系统缓存，移除重复升级流程、发布反馈页和静态设备数据，仅保留官方查询入口；不另建归档副本。
+- 更正宿主 target 的通用取模示例，限定旧版本编码与编译参数的适用条件，重新生成 55 项引用清单；Scanner 保持 2.0.0，扫描算法、CLI 与 CSV 不变。
+
+## 12.0.0 - 2026-10-27
+
+### 变更
+
+- 行为变更与废弃API全面改为文档驱动，删除适配CLI、自动语义审计、源码/模型账本、恢复回滚、配置事务、构建调度及报告引擎；不提供旧适配协议或自动Fixed证明。
+- 采用入口、共用十二步、功能差异、按需专题、轻量模板与知识库层次；每步明确适用条件、输入、动作、输出、完成判据和异常处理，按用户授权自动推进。
+- 主要交付收敛为原始扫描、轻量进度/分组记录、results.csv、api-adapt-report.md及实际验证证据；模型判断、编译、复扫、运行、对比和最低设备分别报告。
+
+### 删除
+
+- 同时删除适配引擎相关单元测试、专用helpers和孤立夹具，保留scanner、安装、跨平台基础、资料维护和文档完整性回归；仍被评测使用的原字节资料迁至evals/fixtures。
+- 运行链脚本净减8033行，含scanner/platform及维护入口净减8111行，测试/helpers另净减5016行；文件移动和测试删除不冒充运行代码削减。
+
+### 修复
+
+- scanner保留原扫描实现、CLI和输出字段结构，其私有身份模块不再反向加载适配策略或声明已删除的审计/账本能力。
+- 文档和模板检查覆盖实际阅读树及本地锚点，补充API26配置值26.0.0与扫描表达式26.0.0(26)Release的区别。
+- 资料维护锁拒绝自动回收遗留锁，避免并发维护删除彼此锁文件；兼容性说明移除已退役引擎的自动保障声明。
+- 更正先前autoResize(true)保持旧默认的错误解释：官方旧默认false，26仅超过5000万像素默认true；小图可无需修改，主动降采样true作为独立业务意图验收。
+
+### 文档
+
+- 删除前完成84原模块、36业务动作及6框架退役决定的迁移对照，无未处理项；更新保留脚本职责和89个场景评测。
+- 真实隔离Image/HAP编入、代表废弃迁移/完整构建/复扫及622行统计验收已执行；设备未执行，独立评测代理额度中断后的收尾按轻量进度核对完成，不伪造通过。
+
+## 11.0.0 - 2026-10-27
+
+### 变更
+
+- 将废弃 API 模式 deprecated-only 直接重命名为 deprecated，统一 Adapter、Scanner、内部调用、批次元数据、运行身份、报告和诊断，不提供旧名称别名或记录迁移。
+- Scanner 升至 2.0.0，保持 schema 3、时间戳目录、CSV 名称和业务字段及 SDK 审计含义不变，upgrade 模式沿用现有流程。
+
+### 修复
+
+- CLI 与内部路由提前拒绝无效模式，批次读取、运行清单和功能身份校验不再让旧名称通过默认分支执行。
+- 被拒绝的旧模式命令不读取后续账本、不创建恢复运行或写入指标，原始文件保持不变；新 deprecated 运行继续按原有证据规则恢复。
+
+### 文档
+
+- 同步帮助、示例、维护脚本、评测和版本约束，新增旧名称拒绝与新模式交付/恢复回归；保留历史 CHANGELOG 原文，不运行远端 CI。
+
+## 10.0.0 - 2026-10-27
+
+### 变更
+
+- 删除扫描器 full 模式和默认模式，scan、inspect-rules、适配器调用封装及内部扫描入口必须显式选择 upgrade/deprecated-only，非法模式在读取 SDK 或创建输出前返回 SCAN_MODE_INVALID。
+- 删除 API 差异表规则引擎、声明解析、兼容性分类、跨版本抵消、full 行为自动分类和项目级运行验证分组，移除对应覆盖字段、快照字段及退役测试。
+- Scanner 升级至 1.0.0，新扫描必须绑定有效批次，保持行为 schema 2、废弃 schema 3、CSV 字段与逐位置身份，旧 CSV、旧诊断和历史 full 只读保护继续保留。
+
+### 修复
+
+- DevEco 在解析来源标题前按模式筛选规则，避免无关行为文档缺失阻断废弃扫描，保留真实 SDK 废弃识别、替代声明审计及原生扫描边界。
+- 官方来源目录生成脚本不再推断动作或运行验证结论，旧新路径沿用原始条目标识，统一换行哈希并修正 API 26 目录的 API Level 解析。
+- 废弃维护验收脚本显式选择模式并使用实际返回的报告路径，重复扫描对比排除本次批次 ID 差异。
+
+### 文档
+
+- 同步两种模式的命令、报告边界、脚本职责和本地回归，保留 320 条行为资料与来源校验，不恢复远端 CI。
+
+## 9.0.1 - 2026-10-26
+
+### 变更
+
+- 按用户要求删除 macOS/Windows 与 Node 20/24 四组合 GitHub Actions 工作流，同步取消仓库纪律和 README 中的远端 CI 验收门槛，保留跨平台兼容与本地全量测试、结构校验要求。
+
+### 修复
+
+- 资料目录完整性回归忽略 Finder 自动重建的 .DS_Store 缓存，避免浏览目录后将系统缓存误计为额外版本或文档。
+
+## 9.0.0 - 2026-10-26
+
+### 变更
+
+- 清理 os-changelog 中不含实际变更正文的 1115 篇 Markdown、14 个抓取摘要及系统杂项，将 38 篇有效原文按 8 个版本目录平铺，使用阶段前缀区分同名文档。
+- 删除内置 API 变更清单表，full 入口保留但不再维护这些表提供的接口定义与废弃补充规则覆盖，作为破坏性变更发布。
+
+### 修复
+
+- 用目录外结构化索引保留原总览的官方条目链接、版本、设备与生效信息，320 条行为策略及人工初核记录同步迁移路径，原文、行号、哈希和评审标识保持不变。
+- 通过精确旧路径映射兼容历史 CSV 和初核工作簿，插件缺少 changeId 时沿用原始路径生成稳定规则标识，未知显式来源不按相似标题回退匹配。
+
+### 文档
+
+- 更新资料布局、索引加载方式与 full 覆盖边界说明，新增正文完整性、逐条解析一致性、旧工作簿更新、官方锚点及双平台路径回归。
+
+## 8.0.0 - 2026-10-26
+
+### 变更
+
+- 行为变更改为模型负责业务适用性、源码及必要配置修改，使用独立简单状态登记逐原始行结论，退出旧语义审计、适用性分析、事务账本及内置功能测试执行器。
+- 新适配必须显式选择 upgrade 或 deprecated-only，扫描器 full 保留；旧行为及 full 适配记录只读，废弃 API 保留 SDK 审计、Fixed/Unfixed 及可信恢复。
+
+- 相对7.0.1净减少3405行运行脚本（不计测试与文件移动），计入维护脚本净减少3869行。
+
+### 新增
+
+- 增加模型来源明确的业务适配报告，区分评估、实际差异、编译和运行，自动统计记录、位置、唯一文件、变更与文件工作单元。
+- 保留 HAP/HAR 真实构建薄封装、失败与输入过期检测、产物快照及可选前后证据登记，候选 CSV 提供逐行截图短路径。
+- 用可移植案例核对622行、613位置、161文件、286工作单元、19变更，并覆盖零命中、无需修改、混合结论、遗漏、原生扫描与证据不足。
+
+### 修复
+
+- 根 target 更新不算逐条 API 修复，缺新产物不能沿用旧包，空用例及不同设备不能冒充完整对比，修改后不能补造 before 基线。
+
+### 文档
+
+- 重写行为、HAR、原生和测试指导及逐脚本保留理由，迁移行为评测，保留废弃关键回归；Image autoResize(true) 在隔离模板完成真实修改和 Hvigor HAP 构建。
+- 按用户后续要求取消四组合 CI 通过的核验门禁，保持跨平台实现及本地 npm test、npm run validate。
+
+## 7.0.1 - 2026-10-26
+
+### 变更
+
+- 将行为变更与废弃 API 的分类、逐行审计和报告投影分属独立功能模块，根 CLI 延迟加载所选功能，保留旧命令与交付契约。
+- 提取共享范围筛选、构建输入和产物事实，旧工作流、存储与编译层明确作为过渡依赖，不复制两套适配引擎。
+
+### 修复
+
+- 新运行按功能绑定实现身份与参考资料范围，另一功能代码、全局包版本或入口说明更新不再使单功能运行无关失效；旧身份维持原有校验和可信恢复规则。
+- 拒绝跨功能、缺失及未知模式的实现身份；doctor 与 inspect-toolchain 不再提前加载无关适配实现。
+- 补充双向功能损坏加载、静态依赖边界、共享实现失效和参考资料隔离回归，保留原有废弃、HAR、原生与运行测试。
+
+### 文档
+
+- 新增覆盖 152 个运行和维护脚本的职责清单，说明归属、直接使用者、具体保留价值与第二批处理决定。
+- 记录两批实施边界与验收计划，说明功能范围身份及历史运行处理。
+
+## 7.0.0 - 2026-10-23
+
+### 变更
+
+- 新 deprecated-only/model 批次采用 schemaVersion=3，扫描总表、适配总表、实施方案、审计构建报告和交付摘要集中到扫描时间戳目录根部。
+- 扫描 JSON、验证 CSV、覆盖及诊断集中到 .internal/scanner，默认账本及快照集中到 .internal/api-upgrade-runs；原有 full、行为变更及历史 model 布局保持原样。
+- 废弃 API 的 CSV 与目录共用时间戳及同秒冲突后缀，prepare 导入创建保留原字节的新副本，Scanner 同步至 0.20.0。
+
+### 新增
+
+- 从 SDK 替代事实、工作队列和既有分组评估生成实施方案，在准备、登记评估、审计和 finalize 时更新，保留未评估、缺口及过期状态。
+- 导入复制伴随扫描证据并核验原件、副本及元数据哈希，继续执行原有 SDK/源码校验，不因复制接受不完整扫描。
+- prepare、finalize、status、diagnose-run 和交付索引统一返回实际路径，支持自定义账本及切换工作目录。
+
+### 修复
+
+- 扩展新批次的所有权、回读、原子发布、恢复转交和内部目录边界保护，保留旧报告快照并阻止旧运行覆盖新交付。
+- 补充零行和非空交付、格式及行序、普通和部分 finalize、来源篡改、模拟器证据及双平台链接与并发命名回归。
+
+### 文档
+
+- 更新废弃 API 交付目录、实施方案、导入和历史兼容说明，同步参考清单哈希。
+
+## 6.4.0 - 2026-10-23
+
+### 新增
+
+- 新增受控 HAR 宿主功能证据关联，冻结委托条目范围，逐阶段核验真实库依赖、HAP 与采集点；库构建可独立取得凭据并共享宿主执行。
+- 新增历史补充验收入口，只读核验原交付和归档构建包，在独立目录生成新 CSV、追踪和报告，缺少原始基线时保留部分验收。
+- 新增 compact 截图展示，只投影逐行绑定的关键业务采集点，生成可复用且哈希可核验的短路径副本；保留既有 JSON 默认格式。
+
+### 修复
+
+- 所有候选行均须验证对应功能，变更不适用不能免测；绑定原始源码位置、功能断言与采集点，禁止删除失败或受阻用例降低验收分母。
+- 增强 Dialog 等容器范围、控件类型和可见性定位，支持经设备能力探测的单指令双击，瞬态采证复用布局并核验观测窗口。
+- 历史用例关联先复核再验收，过期库构建、宿主结果、篡改截图和缺失基线不能形成通过结论；展示切换不使有效计划或关联失效。
+- 补充四批共42行可移植反馈夹具及跨平台回归，覆盖精简导出、失败范围保留、源码分支绑定、HAR 依赖和构建变动、历史原件保护及目录链接越界。
+
+### 文档
+
+- 更新逐条功能覆盖、精简截图交付、联合升级共享执行及历史补充验收说明，新增六项行为评测。
+
+## 6.3.0 - 2026-10-23
+
+### 新增
+
+- 新增行为变更白盒分析、路由与逐条用例冻结、修改前后设备执行及结果登记四个命令，全部候选条目均关联功能用例或明确缺口。
+- 增强测试支持显式选择模拟器或真机，独立构建原配置基线并核验修改后 HAP；HAR 通过绑定依赖的宿主构建与运行，前后凭据分别归档。
+- 内置执行器支持语义定位、点击、长按、滑动、输入、条件等待、布局及进程日志断言，按显式采集点归档截图和布局树。
+- 按需接入 Python Hypium、工程已有测试及 ux-judge，冻结外部脚本与运行时信息，保留功能断言实际值、原始判定结果和各轮证据。
+- 候选表新增测试截图路径列，生成 JSON、Markdown、HTML 测试报告并汇入升级报告和交付索引，分别统计条目追踪、实际执行、功能视觉通过及有效对比。
+
+### 修复
+
+- 前置业务状态须结合真实起始证据明确确认，导航锚点、截图生成或模型中断均不能替代功能通过或有效前后对比。
+- 源码变化使修改后结果过期，计划、脚本及运行时变化使相关对比失效；新失败不回用旧成功，重导出保留有效截图关联且不改变原始扫描表和 Fixed 语义。
+- 测试证据统一物理路径身份并拦截目录链接越界，报告发布保留尚未落盘的构建状态，脚本快照不作为自定义输出目录中的新源码参与分析。
+- 新增十九项双平台增强测试回归，覆盖重复条目、非视觉断言、基线与凭据、真机身份、模型中断、证据篡改、前置状态及路径别名。
+
+### 文档
+
+- 增加修改前测试范围确认、完整计划及外部结果样例、前后执行与验收标准，补充五项 Skill 行为评测并同步参考资料清单。
+
+## 6.2.0 - 2026-10-22
+
+### 新增
+
+- 模拟器冒烟支持 --emulator-name、--hdc-target 显式选择，记录命令与阶段耗时，并输出失败原因、证据路径和下一步动作。
+- 联合升级支持 apply-config --reuse-from-run，核验物理工程、product、原始基线与工具写入凭据后关联配置，不重复写盘。
+
+### 修复
+
+- 修复已有模拟器与 USB 真机同时在线时候选为空的问题，验证实例端口和设备属性，歧义、不匹配或未知身份立即停止且不安装到真机。
+- 分离启动保留中文和空格参数并报告进程提前失败，拒绝将显式在线目标归属到未运行实例，保留任务开始前已有实例。
+- 配置已达目标时明确诊断历史运行；恢复显式保留原配置基线和修复预算，配置冲突不再误导为反复恢复，已正确配置时不重复写盘。
+- 补充多设备选择、启动和传输失败、凭据拒绝、路径别名、配置幂等及恢复证据保护回归。
+
+### 文档
+
+- 明确联合升级配置关联与验证顺序，新增 Windows 短命令示例、失败诊断及重试边界，区分截图采集、业务交互和视觉验收。
+- 新增三项运行耗时相关评测用例，同步参考资料完整性清单。
+
+## 6.1.1 - 2026-10-22
+
+### 修复
+
+- 从项目默认待验收项中移除官方规则覆盖缺口及 Windows 平台维护验证，保留业务与最低版本设备验收事项。
+- 交付摘要和实施方案不再重复插件规则缺失提示，coverage.json 与 final-report.json 继续保留真实覆盖状态和完整缺失清单。
+- 补充完整覆盖、不完整覆盖、导入 CSV 及废弃迁移报告回归，核对自动导出与显式交付均保留详细覆盖证据。
+
+### 文档
+
+- 同步 Skill、交付指南、使用示例和评测预期，明确用户要求 Windows 验证时才单独报告实际结果，保留工具跨平台维护门禁。
+
+## 6.1.0 - 2026-10-22
+
+### 新增
+
+- 初核快照新增可选字符串 versionIsolation，保留“是否版本隔离”原值，继续使用 schemaVersion 1 并兼容旧快照和旧表。
+- 固定维护命令允许同步初核判断、备注、开发者确认及版本隔离四项信息并逐项报告差异，辅助列缺失时保留既有信息，明确空值允许清空。
+
+### 修复
+
+- 正确解析 Excel 自闭合空单元格，避免空开发者确认列吞并后一列共享字符串备注，保留中文、多行内容、连续空格及真实行号。
+- 同步第三版 320 条初核记录，更新 6 条初核判断、25 条备注和 57 条开发者确认；初核“是”252 条、“否”68 条，新增版本隔离参考信息。
+- 补充空单元格、缺失列、辅助信息增改清空、旧目录兼容及分流不受辅助信息影响的双平台回归。
+
+### 文档
+
+- 明确辅助信息仅供快照和维护报告参考，不新增 CSV 列，不触发自动确认或兼容保护，保留官方指导与真实 SDK 证据要求。
+
+## 6.0.2 - 2026-10-21
+
+### 文档
+
+- 新增废弃 API 专用样例文件，统一组件与窗口上下文、参数注入、受控服务、异常与 Promise、音量及 Intl 场景，保留原有代码和验收边界。
+- 上下文指南保留来源选择、生命周期、公开接口和多窗口规则，代码样例迁入专用文件并按章节引用。
+- 行为变更正反例移出废弃迁移样例，入口及模型流程按功能选择读取路径，共同约束继续适用于两类流程，同步参考资料清单。
+
+## 6.0.1 - 2026-10-21
+
+### 修复
+
+- 保留 71 个评测用例 ID，将旧 structured 正向要求迁移至现行 model 流程，修正候选分流、失败保留现场、异常契约、原生适配及旧账本拒绝预期。
+- 校验入口新增评测 ID、必填字段、夹具文件和人工指南本地链接检查，覆盖中文空格路径、CRLF、括号及代码示例，不用关键词推断自然语言预期。
+
+### 文档
+
+- 将音量与 Intl 重复说明集中到升级正反例，明确适用前提、SDK 证据和最低设备验收边界。
+- 将 SDK 夹具声明数量及历史偏移移至跨平台验收文档，普通流程保留实际声明核验原则，同步参考资料清单。
+
+## 6.0.0 - 2026-10-21
+
+### 破坏性变更
+
+- 彻底移除 structured 决策、预览、事务执行、自动回滚和旧修复队列，仅保留 workflowVersion 6 的 model 工作流。
+- 移除 structured 历史状态查看、诊断和恢复；旧账本在加锁、记录指标或修改文件前返回 UNSUPPORTED_WORKFLOW_VERSION，须重新扫描并准备 model 运行。
+- 保留默认 model 与显式 --edit-mode model，其他编辑模式直接报参数错误，旧命令按未知命令处理。
+
+### 重构
+
+- 将共用 SDK 声明定位与版本保护证明迁入现有证据模块，保留 model 审计、显式回滚、失败预算和历史 model 恢复。
+- 清理准备、构建验证、状态诊断、交付及源码账本中的旧协议分支和产物，删除仅服务旧流程的模块及测试。
+- 将 HAP、HAR、宿主及模拟器混合回归迁移至 model 账本，覆盖无副作用拒绝、构建复用和编译失败保留源码。
+
+### 文档
+
+- 删除 structured 归档和旧协议说明，更新现行流程、兼容边界、交付布局及参考资料清单。
+
+## 5.1.0 - 2026-10-20
+
+### 新增
+
+- 沿用公共执行器与静态注册表，新增表单组件触摸热区及 openCustomDialog 重载两个独立适用性分析器。
+- Button 同时检查构造选项和完整属性链中的 ControlSize，仅 SMALL 可能适用；Toggle 按真实模式判断，Chip、ChipGroup 和 Select 继续评估。
+- 依据真实 SDK 接收者、参数类型和解析签名区分弹窗重载，ComponentContent 形式自动不适用，CustomDialogOptions 形式保留可能适用。
+
+### 修复
+
+- 默认尺寸或模式须由所选 SDK 的声明说明证明，动态值、重复配置、隐藏属性修改、类型断言及错误恢复保留待核实。
+- 防止漏读 Button 构造尺寸或仅凭弹窗参数个数造成误排，源码与 SDK 声明证据沿用公共校验和过期检测。
+
+### 文档
+
+- 记录本次细化条件的用户来源、官方条目链接及 SDK 证据边界，更新分析器扩展说明与 Skill 入口。
+- 新增不按平台跳过的 SDK 夹具回归，并扩展隔离 PasswordInput 案例的真实 ETS/SDK、自动评估及 CSV 验证。
+
+## 5.0.6 - 2026-10-20
+
+### 修复
+
+- CLI 入口统一 native 物理路径和平台路径比较，修复符号链接或 Windows junction 安装后静默退出，保留正常入口的运行锁、错误退出码及耗时指标。
+- 区分成功构建复用、宿主刷新与相同输入失败重试，成功凭据有效时返回 cacheHit，宿主变化时复用有效 HAR；凭据绑定依赖安装后的编译输入，避免首次生成锁文件造成额外构建及宿主刷新死锁。
+- 为应用及宿主 HAP 保存独立构建快照、原输出路径与字节哈希，冒烟绑定准确产物；构建前清理应用入口旧输出，排除其他模块、旧签名包与 app 打包副本。
+- 将本地外部 HAR/HSP/HAP 依赖字节纳入应用构建指纹，补充运行证据的 HAP 身份；重新构建时重置当前运行结论并保留历史会话，保持二进制排除源码分析的边界。
+
+### 文档
+
+- 补充应用与三方库联合升级、成功复用、宿主刷新、快照失效及模拟器受控启动指导，明确恢复运行和真机验收边界。
+- 增加跨平台 CLI 链接安装、产物覆盖、快照损坏、外部依赖变化和宿主重试回归，并在 PasswordInput 隔离副本完成真实联合构建验收。
+
+## 5.0.5 - 2026-10-20
+
+### 修复
+
+- 以源码类型白名单限制模块解析、编译器输入和适用性分析，排除 HAR、HAP、HSP、ABC、原生库及其他非源码产物，避免压缩包文本哈希与原始字节不一致造成误报。
+- 必要配置通过独立输入接口读取并记录原始字节指纹，保留真实修改检测；无可用源码或声明的依赖保留相关证据缺口，不解析二进制补造类型。
+- 新增二进制依赖、包入口、现有声明、目录别名、配置字节变化及任意命名工程内外三方库的跨平台回归，Scanner 升至 0.19.1。
+
+### 文档
+
+- 明确按用户提示词及工程模块配置确定三方库源码范围，不预设 ohos_library、library 或 Demo 目录，并将命令示例改为本次任务的明确占位符。
+
+## 5.0.4 - 2026-10-20
+
+### 文档
+
+- 按废弃 API 与 API 行为变更两项能力重构 Skill，增加总体流程图、场景矩阵、输入和步骤表，并将详细规则组织为按需参考。
+- 按环境依赖、Skill 安装和快速入门重写 README，提供应用废弃 API、应用行为变更和 HAR 行为变更三组提示词及交付件说明，删除维护实现与历史案例内容。
+- 明确应用 HAP、三方库 HAR 与宿主 HAP 的构建和运行关系，以及独立 HAR 暂不支持废弃 API 适配的现有边界。
+
+## 5.0.3 - 2026-10-20
+
+### 维护
+
+- 扫描器源码迁至 Skill 根目录 scanner，统一导入、默认资料目录、运行指纹、安装及跨平台测试入口，Scanner 保持 0.19.0。
+- package-lock.json 移出版本控制，CI 使用不生成锁文件的依赖安装；忽略临时输出、日志和缓存，安装时排除这些产物并清理被覆盖安装中的旧目录。
+- 删除 19 份历史验证、版本化验收与迁移记录，保留当前适配指南、规则快照、原生验收方法及真实 SDK 回归夹具；修正文档引用并更新参考资料清单。
+- 按风险删除 44 个测试用例，主要为退休 structured 写入编排、导出存在检查和重复断言；保留 model、SDK、低版本、HAR、原生 ABI、证据完整性与 Windows 缺陷回归。
+
+## 5.0.2 - 2026-10-20
+
+### 修复
+
+- SDK 来源记录仅写入实际运行、SDK 路径与版本、编译器版本及快照，移除针对历史 Windows 回传文本的硬编码哈希和 UIContext 专项比较；保留声明级证据和旧来源文件读取。
+
+### 清理
+
+- 完整 Windows SDK 原文改为无损 gzip 夹具，271070 字节压缩至 37158 字节；测试在内存解压并验证原始哈希、长度和全部 400 声明，不生成明文副本。
+- 精简 Windows 历史失败夹具，仅保留 console 修改、重载诊断正文与能力版本声明，保持五个回归场景。
+- 删除无 model 调用的旧上下文审计脚本和已失效的 structured 维护验收入口，同步活动文档、历史归档说明及 eval；保留 model 维护入口、structured 内部共享算法和历史账本恢复。
+
+## 5.0.1 - 2026-10-20
+
+### 修复
+
+- 内存编译夹具统一 Windows 路径分隔符和大小写，防止虚拟源码缺失导致类型与 SDK 绑定回归误报；新增可在双平台运行的路径别名测试，不改变运行时审计规则。
+
+## 5.0.0 - 2026-10-20
+
+### 变更
+
+- 所有新适配统一使用 model，退休 structured 决策写入 CLI；历史运行保留只读诊断与可信恢复，共享 SDK 验证算法继续复用。
+
+### 修复
+
+- 官方替代关系、准确 SDK 声明、实参及失败传播均可证明且异常集合未扩大时，保留既有异常策略，不为等价迁移强制新增 catch。
+- 修复可空联合与已缩窄断言误报，按真实类型识别 UIAbilityContext 别名和子类，继续拒绝 any、unknown 及不安全 Context 转换。
+- 统一审计发现、阻断集合与来源分类，保留遗留风险，区分自定义规则、SDK 编译器、ArkTS Linter 和证据缺口；未启动构建明确报告 NOT_RUN。
+- 重复审计观察不消耗源码修复次数，同一失败输入重复验证不重复计次；三种实质失败方案及无进展限制继续生效。
+- 防止保留旧调用重复消耗历史风险，禁止丢弃 Promise 失败传播或跨匿名函数借用等价证据，合并原生及后续发现的阶段门槛和统计。
+- 帮助和退休协议在参数与 SDK 检查前返回，不取得运行锁、不写入 metrics；旧运行恢复无法映射修复预算时明确拒绝而不重置。
+
+### 文档
+
+- 将上下文来源优先级、受控 ContextUtils、窗口归属及同身份清理迁入 model 必读指导，归档旧预览与决策协议说明。
+- 补充风险分类、有限修复和原 217 行证据回放验收，Scanner 保持 0.19.0；Windows Beta1 与最低业务设备验收仍为待办，继续 EXPERIMENTAL。
+
+## 4.1.0 - 2026-10-19
+
+### 新增
+
+- upgrade + model 支持 C/C++ 中准确绑定 SDK 声明的 C 函数直接调用与局部参数修改，复用方案登记、源码审计、构建及 CSV 交付闭环。
+- 从逐 ABI 编译数据库或 Ninja 提取真实命令，支持响应文件与流式 Clang AST，保留中文、BOM、CRLF 和准确调用归属。
+- 固化编译器、SDK 头文件、配置、响应文件及实际依赖基线，校验物理路径身份与修改后的输入完整性。
+- doctor、运行账本、验证及最终报告增加可选 nativeCapabilities、nativeAnalysis、nativeVerification，分别记录语义、构建和设备状态。
+- 增加 C/C++ 真实 SDK 修复正例、ComprehensiveTool 隔离验收及跨平台回归，覆盖同名函数、同一行多调用、宏、间接调用、版本不足、诊断和输入变化。
+
+### 修复
+
+- 解析 C/C++ 源码及头文件的 Clang 错误，阻止注释、日志、相邻调用或无关构建成功将原生条目标为 fixed。
+- HAR 宿主构建指纹仅识别已注册模块根目录内严格匹配 SDK 模板的 BuildProfile.ets 生成文件，保留业务文件与配置变更检查。
+
+### 文档
+
+- 明确首版调用范围、低版本证据、原生复核边界及真实扫描覆盖缺口；设备、AR 硬件和最低版本业务验收保持独立待验收状态。
+
+## 4.0.1 - 2026-10-19
+
+### 修复
+
+- 原生模块分别执行语义扫描并输出逐模块状态，单模块超时不丢弃其余模块结果。
+
+### 新增
+
+- 增加 ComprehensiveTool 真实工程隔离验收、原工程指纹复核、逐 ABI Ninja 构建及直接 DevEco 结果对照。
+- 验收保留重复命中、BOM、列号和物理路径身份，超时或结果不完整时明确返回 INCOMPLETE。
+
+### 文档
+
+- 记录真实 SDK 的原生扫描边界、验收恢复命令及 AR 模板解析超时，区分元数据生成、实际构建和设备验收。
+
+## 4.0.0 - 2026-10-19
+
+### 变更
+
+- 新 upgrade 批次采用 schemaVersion=2 布局，元数据、所有权、扫描证据及默认账本集中到 .internal/，扫描根目录保留六份核心交付件和实际运行证据。
+- upgrade 不再生成空验证 CSV，Scanner 返回 validationCsv=null；model 不再生成 structured 专用的三个空目录和空 decisions.jsonl。
+- 保留三类零行 CSV、源码基线、审计对象、构建诊断和报告快照，Scanner 同步至 0.19.0。
+
+### 修复
+
+- 扫描、CSV 导入、prepare 失败诊断、状态查询、交付发布和恢复统一使用版本化路径，显式账本目录继续优先。
+- 兼容旧布局及其恢复路径，元数据损坏或缺失、版本不明、重复元数据及内部链接越界时拒绝回退或覆盖。
+- 补充新旧布局恢复、零命中和非空扫描、自定义目录、发布中断恢复及 Windows 盘符、UNC、junction 边界回归。
+
+### 文档
+
+- 更新产物用途、精简布局、返回路径及历史兼容说明，同步参考资料哈希清单。
+
+## 3.0.0 - 2026-10-18
+
+### 变更
+
+- 新生成的候选及适配交付 CSV 将“人工判断是否需要适配”列替换为“初核是否涉及代码修改”，过滤原因同步新名称，历史产物不改写。
+
+### 新增
+
+- 增加 `npm run update:behavior-review -- --xlsx "<表格>" [--check]` 固定维护入口，支持只读差异预览、来源哈希、判断统计、未知值提示及内置快照和引用哈希同步。
+- 常规更新只允许初核判断和备注变化，目录身份、增删记录等变化明确停止，写入或校验失败恢复原文件，重复导入保持无额外修改。
+
+### 修复
+
+- 导入器兼容新旧判断表头，拒绝重复或冲突标题、重复来源和公式判断值，保留真实工作表行号及中文多行备注。
+- 更新 320 条初核快照，backToTop 判断由“否”改为“是”，同步 convertXml 和 getWindowProperties 两条备注，初核“是”246 条、“否”74 条。
+- 分流与适配流程的固定数量回归改用独立测试目录，日常判断和备注调整无需修改测试预期。
+
+### 文档
+
+- 明确预览差异、更新快照、全量验证、版本同步及提交推送的维护流程，保留自定义快照入口和新运行要求。
+
+## 2.20.2 - 2026-10-17
+
+### 修复
+
+- 假扫描器通过平台路径构造和安全字符串序列化保留 Windows 反斜杠，修复 C++ 超时报告丢失结果的门禁失败，Scanner 同步至 0.18.2。
+- `npm test` 顺序执行并汇总 Adapter 与 Scanner，前一套件失败或发现目录失败后仍执行后一套件，任一失败保持非零退出码。
+- 补充中文、空格及单引号路径回归，核对 ArkTS/C++ 结果、CSV 和扫描 JSON 的位置一致性，并覆盖套件失败传播及单套件命令。
+
+### 文档
+
+- 补充跨平台测试聚合行为及本轮门禁问题映射，保留真实 Windows DevEco 实测待验收说明。
+
+## 2.20.1 - 2026-10-16
+
+### 修复
+
+- 物理路径解析统一 native 口径（同步 `realpathSync.native`、异步 `fs.promises.realpath`），修复 Windows 8.3 短路径（如 `RUNNER~1`）与长路径身份分裂导致合法绝对目录被误判越界，Scanner 同步至 0.18.1。
+- 宿主 SDK 测试夹具按生产结构建立原始与规范化双路径索引，Windows 分隔符及大小写差异不再丢失声明证据。
+- 基线覆盖路径断言改用 `node:path` 构造，消除写死的 POSIX 绝对路径，并新增别名根与绝对目录选择一致的双平台回归测试。
+
+### 文档
+
+- 开发纪律新增跨平台基线：CI 四组合全绿为完成标准、路径必须经 `node:path` 构造、物理解析统一 native 口径、新增测试默认不按平台跳过。
+
+## 2.20.0 - 2026-10-16
+
+### 新增
+
+- 新 upgrade 批次使用 12 位随机 ID 命名扫描总表、代码适配候选表和预计无需代码修改表，时间戳目录保留，批次预留独占检测并发冲突。
+- 扫描目录根部集中发布实施方案、交付摘要和详细报告，内部账本保存历史快照，自定义账本路径不改变交付位置。
+- 根目录发布增加运行所有权、哈希和回读保护，中断恢复此前文件；恢复运行沿用批次 ID，旧运行显示 SUPERSEDED 并仅引导查看历史报告。
+
+### 修复
+
+- CSV 写入同步核验当前发布所有者，防止已被接管的旧运行覆盖新运行结果；保留旧账本和非 upgrade 模式的原文件名及路径。
+
+### 文档
+
+- 补充 CSV 初步分流语义、Excel 唯一文件名、完整产物布局和实施验收清单，Scanner 同步至 0.18.0。
+
+## 2.19.0 - 2026-10-16
+
+### 新增
+
+- 升级适配按真实变更身份、版本和 API 声明聚合跨文件适配组，组内保留文件工作单元及逐行证据。
+- 准备结果、模型指导、状态和最终报告提供适配组与文件工作单元的映射及独立统计。
+
+### 修复
+
+- 实施方案按适配组集中展示全部文件与官方指导，分别保留自动适用性分析和模型评估结果。
+- 整组完成要求所有文件单元完成，混合结论显示 MIXED，源码变化后的无需修改结论及方案标记为过期。
+- 保留逐文件修改归属、CSV 行数和 fixed 审计，旧运行继续使用原分组与统计口径。
+
+### 文档
+
+- 补充两层分组接口、PasswordInput 案例回归和版本验收记录，明确 record-assessment 继续使用文件工作单元 groupId。
+
+## 2.18.4 - 2026-10-16
+
+### 修复
+
+- Adapter 与 Scanner 共用 SDK 定位，接受根目录和 default 目录，后端持续使用规范根目录，显式无效路径不回退。
+- doctor 按组件层读取 SDK 元数据，单次复用版本目录与后端帮助探测，增加分阶段耗时和准确的工程、SDK 诊断。
+- finalize 前置统一交付清单并生成可回读的 delivery-summary.md，列出零行 CSV、实施方案及实际运行证据会话。
+- 区分自动导出与显式最终交付，状态查询复核交付文件和当前验证指纹，文件缺失或篡改明确失败。
+
+### 文档
+
+- 明确优先使用环境发现、所有任务分支显式 finalize，以及最终回复必须列出完整交付路径；Windows 保持实验支持。
+- 内置 Scanner 升至 0.17.4，同步确定性定位、效率与交付回归。
+
+## 2.18.3 - 2026-10-15
+
+### 修复
+
+- 分离配置 target 与精确扫描版本，SDK26 Beta1/Beta2/Release 均允许配置 26.0.0；扫描起点取同 API 最早版本，终点取不高于实际 SDK 的最新版本。
+- 内置带来源校验的 30 个精确 SDK 版本，合并当前工具链版本并在各入口、运行记录和报告保留解析依据。
+- 按实际 index 后端能力执行整模块扫描，不再强制传入 scanFilePaths，窄目录能力不足时明确停止。
+- 保护有效 Text 自动不适用理由，人工补充不再覆盖默认 CopyOptions.None 的工具证据。
+- 按 OHPM 帮助选择参数，安装暂时失败最多保留锁文件清理重试一次，总预算维持 600 秒。
+- 宿主环境失败可复用仍匹配的 HAR 构建凭据，受控同步的 HAR 副本不再误触发库输入变化，继续核验产物和依赖字节。
+- 统一 HDC 本地原生路径和明确接收目录，按设备能力保留 JPEG/PNG 格式，并将预加载兼容脚本纳入实现指纹。
+- 修复维护验收脚本对历史 CSV 和 PasswordInput 构建工程布局的假设，原工程仅只读校验。
+
+### 文档
+
+- 补充分离版本、后端能力、环境恢复、截图和干净包 Windows 待验收约束，内置 Scanner 升至 0.17.3。
+
+## 2.18.2 - 2026-10-15
+
+### 修复
+
+- 统一 Windows 增量审计的依赖、哈希及缓存诊断路径身份，复检受影响调用方并保留未修复错误。
+- 修复 SDK 适用性声明识别、跨盘模块及宿主入口定位，保持真实路径和源码边界校验。
+- 共用批处理执行、输出回调和 PATH 合并，补齐 OHPM 工具发现、超时进程树及临时目录清理诊断。
+- 兼容 Skill frontmatter 的 BOM 与 CRLF，修复日志导入和金标比较的 Windows 路径匹配。
+- 升级内置 Scanner 至 0.17.2，补齐双平台确定性回归及可配置真实 SDK 验收入口。
+
+### 文档
+
+- 统一活跃文档的跨平台单行命令和路径引号，记录问题处理映射与真实 Windows 待验收清单，保留实验支持状态。
+
+## 2.18.1 - 2026-10-15
+
+### 修复
+
+- 统一集成扫描与升级 CSV 导入的默认输出到 skill 启动目录，保留显式输出路径和独立适配账本配置。
+- 新运行记录输出根目录，模拟器证据沿用实际扫描目录及同秒冲突后缀，跨目录执行和恢复运行不改变归档位置。
+- 证据归档按记录的输出根目录检查路径与符号链接边界，历史运行保留原有位置且不自动迁移。
+
+### 文档
+
+- 明确任务启动目录、构建工程与扫描范围的区别，补充切换目录后固定绝对输出路径的用法。
+
+## 2.18.0 - 2026-10-15
+
+### 新增
+
+- 新增按模块和 product/target 编译 HAR、关联宿主工程及 assembleHap 验证，支持源码目录和 HAR 文件两种本地依赖。
+- 新增宿主依赖同步、HAR 备份、OHPM 缓存内容校验及独立 hostVerification，运行前校验库、宿主、配置、依赖和准确产物凭据。
+- 新增持久运行证据服务和 record-runtime-evidence，统一归档截图、布局、日志、命令轨迹和会话 JSON，支持手工补充证据及失败现场。
+
+### 修复
+
+- 修复纯 HAR 工程被 assembleApp 阻断，保留模块真实构建任务、SDK/JDK 会话环境及当前产物证明。
+- 修复后端 scan-* 合成锚点覆盖真实变更链接，按原始规则身份生成独立链接，统一官方文档地址别名及导入分流匹配。
+- 禁止从其他 product/target 选取历史 HAP；宿主失败不覆盖库的编译成功结论，运行状态和归档校验分别报告。
+
+### 文档
+
+- 补充宿主参数、两种依赖构建流程、运行证据登记和隔离验收脚本，记录真实 SDK/Hvigor 与模拟器验收结果。
+
+## 2.17.0 - 2026-10-15
+
+### 新增
+
+- 新增公共执行器、静态注册表和独立适用性分析器，首个实现基于真实 SDK/ETS 调用核对 Text 文本选择菜单条件。
+- 新增逐行适用性结论、证据及通用 CSV 列，整组不适用时自动登记 NO_CODE_CHANGE，保留人工判断、原始记录和 unfixed。
+- 适用性证据绑定源码、依赖、配置、SDK、官方指导及实现指纹，审计重新分析，输入变化后禁止沿用旧结论交付。
+
+### 修复
+
+- 分开报告加载规则、命中规则、记录、源码位置和工作组数量，避免将 findingCount 误写为规则数。
+- 官方覆盖缺口列出具体变更、版本、来源及当前 DevEco 插件包版本，保留 INCOMPLETE。
+- 保留后端有效超链接，缺少 URL 时从唯一官方条目补齐 CSV Title，链接缺失或歧义时明确报告并保留纯文本。
+
+### 文档
+
+- 补充分析器扩展接口、最小注册示例及证据生命周期说明，增加第二条变更分析器的完整接入回归和 PasswordInput 隔离验证。
+
+## 2.16.0 - 2026-10-14
+
+### 新增
+
+- 新增按模块或目录选择扫描范围，同类多选取并集、两类同时使用取交集，支持已注册的工程外 HAR 模块。
+- 将所选模块路径或文件集合传入 DevEco 两类后端，目录扫描按模块与命令行长度分批，不支持精确范围时明确停止。
+- 新增 HAR 模型主导升级流程，独立记录库适配基线与构建 target，允许在已升级构建工程中补齐库适配。
+- 新增宿主 target 独立方案与 SDK 数据流审计，核验真实 BundleInfo 查询、版本归一化、缓存初始化、调用实例和实际保护分支。
+- 新增两个真实 HAR 示例的原始 CSV 夹具、范围与后端回归，以及隔离工程扫描、导入和完整构建验收脚本；Scanner 升至 0.16.0。
+
+### 修复
+
+- 统一工程外源码位置、基线、修改归属、回滚和恢复路径，保护范围外源码，保留既有依赖告警。
+- 扫描与准备使用一致的范围快照，编译审计保留只读工程上下文，避免将未选中的源码误判为删除。
+
+### 文档
+
+- 补充模块和目录入口、HAR 升级、宿主与设备版本独立保护及证据不足时保持 unfixed 的规则。
+
+## 2.15.1 - 2026-10-14
+
+### 修复
+
+- 统一所有预检、Scanner 和 Adapter 的编译 SDK ≥ target 校验，SDK26 可用于 target20，不再要求安装精确目标 SDK。
+- 默认 doctor 在显式目标请求中推荐 upgrade，保留用户目标与显式模式，并分别记录实际编译 SDK、目标版本和声明快照。
+- 废弃 API 按目标版本上限过滤，声明读取与哈希保留真实编译 SDK 来源，取消仅 upgrade 模式的特殊绕行。
+- 模拟器优先选择 compatible 至 target 范围内的实例，无匹配时允许更高版本，并记录实际运行 API 及独立验收边界。
+
+### 文档
+
+- 补充 OpenCode SDK26/target20 的全流程命令，清理活动文档中的精确 SDK 限制，禁止替换用户目标或因此跳过编译与运行。
+- 补充真实 target20 扫描、Hvigor 构建及高版本模拟器尝试的验收记录，运行失败保留诊断与实例关闭结果。
+
+## 2.15.0 - 2026-10-13
+
+### 新增
+
+- 新增 upgrade 模式，按旧 target 至新 target 的左开右闭区间扫描 DevEco 插件四类工程相关变更，排除废弃及额外 API 差异规则。
+- 新增四版本解析与升级校验，旧 target 缺省取旧 compatible，新 compatible 可省略，允许真实编译 SDK 高于目标 target。
+- 新增人工判断 XLSX 导入及内置快照，兼容文档锚点、标题及版本别名，并交付原始、待适配、待复核三份时间戳 CSV。
+- 新增官方适配指导、修改前逐组实施方案和逐行审计，同接口及关联回调修改可独立核验，未修改保持小写 unfixed。
+- 新增官方与插件覆盖差异清单、隔离 SDK/Hvigor 验收脚本及真实插件 3361 行回归夹具，Scanner 升至 0.15.0。
+
+### 修复
+
+- 保留插件列信息及准确代码范围，防止同一行调用去重丢失、宽泛计划范围误标修复和物理路径别名误判。
+- 原子分配时间戳目录，校验人工快照及交付回读与所有权，方案或源码变化后不沿用过期修复状态。
+- CLI 导入不再执行调用方参数，支持隔离验收及已有命令复用。
+
+### 文档
+
+- 重整 Skill 祈使语气与渐进式流程，补充 target/compatible 升级、人工表更新、低版本保护、Logger/hilog 和最小修改正反例。
+- 明确 C/C++ 仅保留实施建议，官方缺失规则、Windows、最低版本设备和业务运行仍须独立验收。
+
+## 2.14.0 - 2026-10-13
+
+### 新增
+
+- 新增 record-assessment 单组/批量轻量评估，自动绑定源码与 SDK 证据，评估过期和逐行修复状态独立报告。
+- 新增 recover-run，保留原工程扫描行、分组、不可变基线和修复停止记录，有界内存读取旧状态，不继承旧 Fixed 或构建结论。
+- model schema 3 使用不可变证据对象与单一原子提交指针，保留历史批次，消除完整分析累积导致的巨型 JSON。
+- 重型审计工作进程提供五秒阶段进度和取消诊断，同运行修改锁避免并发半提交。
+
+### 修复
+
+- 完整解析 HMS 平台版本及 API 编号，分开接口和能力标签，具体报告解析失败原因，不再截断 4.0.0(10) 制造缺口。
+- 替代绑定与安全范围分离，检查相关 catch、回调、辅助声明及初始化链，无关导入声明不连坐逐行结果。
+- apply-config 仅更新、回读和登记配置，不隐式审计；索引复用唯一文件的路径、差异、参数形状及不变基线，当前 SDK 检查按变化和消费者扩大范围。
+- 准备/恢复先交付全量待验证 CSV，审计失败也更新可信部分，源码变化不沿用旧 Fixed，交付所有权冲突拒绝覆盖。
+- model 校验失败返回非零并保存完整诊断，取消和证据缺口不消耗源码修复次数，恢复不重置停止控制。
+- 模板字符串使用解析器叶子映射，保留 CRLF 转换后的历史诊断；构建告警按同一 SDK 声明及异常处理状态比较，处理退化仍拒绝，恢复矩阵重置为待验收。
+
+### 文档
+
+- 默认原工程原地适配，禁止因工具故障复制工程、缩小扫描基线或撤销源码；同步恢复、评估、持久化和专项 eval。
+- 保留完整 Windows SDK 回归夹具，Scanner 仍为 0.14.0；Windows Beta1 与最低 API13/20+ 业务设备验收待完成，继续 EXPERIMENTAL。
+
+## 2.13.1 - 2026-10-12
+
+### 修复
+
+- model 恢复扫描 CSV 同目录的同名 _adapted.csv，保留全部原始行、公式、BOM 与换行，原子写入后回读并记录交付回执，拒绝覆盖用户或其他运行文件。
+- 逐行绑定修改片段、SDK 声明、类型重绑定和诊断，不再以整批失败或跨文件同名 API 残留一票否决，替代数量不足不虚报 Fixed。
+- 多片段差异与分段语法锚点避免大文件历史诊断误报；构建告警核对物理路径、不可变源码及 SDK 声明绑定，归属不明保留待确认，既有日志内 API 迁移不误报为新增 console。
+- 每个错误身份和必要依赖闭包独立计数，失败分支执行停止控制；有效 catch 和日志参数内 API 修复计实质进展，纯文案与格式不计。
+- 补齐模块子路径与显式别名的审计类型解析，分离重载选择与真实注释冲突，空 catch、未 await Promise 与构建新增异常告警提供具体诊断。
+- 原始行和清单交叉保护，apply-config 回读保留字节证据；失败或停止自动尝试可信部分 CSV 交付，默认保留源码且仅显式安全回滚。
+- 完整构建及指纹一致、无新增安全问题时允许 model 部分冒烟，明确 PARTIAL 并保留最低设备待办，沿用取证后关闭本次实例。
+
+### 文档
+
+- 同步 Skill、模型参考、交付路径、逐行统计与专项 eval；保留完整 Windows SDK 回归夹具、structured 默认调用及 Scanner 0.14.0 业务语义。
+- Windows Beta1 真实工程及最低 API13/20+ 设备验证仍须独立验收，不以本机或高版本模拟器替代，继续 EXPERIMENTAL。
+
+## 2.13.0 - 2026-10-10
+
+### 新增
+
+- 新增 --edit-mode model 与 workflowVersion 6，Skill/doctor 推荐模型直接改源码，CLI 默认 structured 保持兼容。
+- 新增 audit-changes，从真实差异记录批次并按 SDK 接收者、准确重载、最低版本保护、可空性、异常及残留自动审计。
+- verify-build 自动审计，SDK semantic/ArkTS Linter 只拒绝新增问题，失败保留源码、完整诊断与错误依赖闭包快照。
+- 新增显式 rollback-changes，仅恢复已审计且能证明归属的片段，后续或未知归属修改保留。
+- 构建指纹绑定源码、配置、SDK、工具和环境，实质修复有限重试，纯日志与格式不构成新方案。
+
+### 修复
+
+- 声明绑定 JSDoc AST 分离接口、参数区间、错误码及能力版本，局部歧义标记 EVIDENCE_GAP，不阻断其他分组准备。
+- prepare 自动保存实现指纹、SDK/编译器、声明范围、原文及文件哈希，明确比对 Windows 回传文本与实际 SDK 差异。
+- 完整回传 UIContext 的 400 声明覆盖 LF/CRLF/BOM 和真实注释冲突，两个 get 重载均为 API 12，API 23 错误码不作为接口门槛。
+- 音量 API 20 保护独立于目标编译通过，订阅/取消订阅核验接收者、回调身份及一致分支，off 不添加 StreamUsage。
+- API 13 的 zh-CN weekday short 缓存按具体运行时证据直接采用 Intl.DateTimeFormat，不强制探测、双缓存或旧回退。
+- 修正物理工程根路径与别名基线映射，避免把 macOS /var 与 /private/var 的历史诊断误判为新增。
+
+### 文档与验证边界
+
+- 同步模型主流程、structured 历史参考、版本锁及专项 eval，CI 保留 macOS/Windows × Node 20/24 的 npm ci/test/validate。
+- 代码适配、最低版本兼容、编译、残留、模拟器和关闭单独报告，缺口和待验证项不由构建成功覆盖。
+- Scanner 保持 0.14.0；真实 Windows Beta1 及最低 API 13/20+ 音量与 Intl 设备验收仍待完成，继续 EXPERIMENTAL。
+
+## 2.12.0 - 2026-10-10
+
+### 新增
+
+- workflowVersion 5 保存不可变源码内容、哈希及权限，事务与编辑账本交叉核对，旧运行保持只读。
+- 新增 apply-ready-transactions 和 finalize --partial，独立成功事务先落地，保留全部阻塞分组及 PARTIAL 状态。
+- 共享 Provider 拆为创建、导出及注册的前置事务，消费者通过依赖关联，不因共用辅助文件整体阻塞。
+- 预览登记已校验决策，transactionOverrides 只需 editId/newText，工具填充位置、哈希与 SDK 证据。
+- 预验证失败独立记录并缓存相同输入，回到失败方案或三次无进展时停止，不占用实际编译修复次数。
+- 锁定开发依赖 TypeScript 5.9.3，让 Windows 原始诊断及类型 AST 关键夹具在无 SDK 的 CI 运行。
+
+### 修复
+
+- 独立解析 SDK 原始声明及多段 JSDoc，区分接口 @since 与跨平台能力版本，诊断输出准确范围、哈希及来源冲突。
+- 类型 AST 规范化完整重载签名内的联合成员顺序，按源码编辑映射比较并去重诊断，保留真实类型与可空性变化。
+- 嵌套 API 按各自版本门槛恢复低版本调用，历史 console 保留单次求值或已证明的互斥分支，不误报为新增日志。
+- 同文件增量事务从原始快照重新投影，保留已应用成果；编译按精确位置及依赖闭包回滚，无源码进展不重复构建。
+- 工具生成失败记录 TOOL_BLOCKED，不伪装成业务 UNFIXED，诊断给出可应用、可选择或停止的确定下一步。
+
+### 文档与验证边界
+
+- 同步事务级工作流、只读工具约束、验收记录及专项 eval；CI 使用 npm ci，保留 macOS／Windows × Node 20／24。
+- 本机独立工程保留 91 组，85 组／205 处实际应用，12 处业务阻塞；完整构建、异常审计、模拟器冒烟及新实例关闭通过，适配仍为 PARTIAL。
+- Scanner 保持 0.14.0，不修改扫描 CSV 业务语义；真实 Windows Beta1／GLM 重放未完成，继续标记 EXPERIMENTAL。
+
+## 2.11.0 - 2026-10-09
+
+### 新增
+
+- 预览保留全部请求分组，逐组输出 READY、REQUIRES_MODEL_DECISION 和 BUSINESS_BLOCKED，按事务隔离失败并引用共享诊断。
+- 内部函数可注入实际 Context；模块内 ContextUtils 沿最短已声明依赖链注册，唯一实例与身份清理不增加模块依赖。
+- workflowVersion 4 固定运行实现指纹，交叉重建 source-state 与编辑账本，旧运行目录只读。
+- 新增独立工程全链路验收工具及 90 处逐项映射记录，区分已应用、合法回退、具体业务阻塞和验证结果。
+
+### 修复
+
+- 统一预览、记录及全局校验，修复 openCustomDialog 异常证据、历史 console 重缩进误报和 Promise 中途 catch 引入 void。
+- 重复类／成员命中仅编辑一次，嵌套回调按自身作用域组合，多行字符串、模板与 CRLF 保持原内容。
+- 非空 Context 注入覆盖调用点及可选参数，已有明确失败 return 的提示操作保留返回契约，不用默认值或非空断言掩盖错误。
+- Intl 缓存关联项统一迁移并审计能力回退，音量 off 的旧分支补齐异常处理，能力保护不误转为数值阈值。
+- SDK 基线与拟议程序隔离可变 AST，使用工程配置及严格函数类型检查，规范化等价联合类型诊断避免误报历史问题。
+- 编译退出结果、异常审计和废弃残留分开报告，残留说明不覆盖真实异常失败原因。
+
+### 文档与验证边界
+
+- 明确禁止应用适配模型修改工具、SDK、覆盖规则及账本；哈希检查用于误改检测，不替代执行环境的只读隔离。
+- 本机独立工程 91 组、217 处完成预览至应用和完整构建；205 处已应用，12 处保留业务／初始化契约阻塞，适配状态仍为 PARTIAL。
+- 本机模拟器冒烟及工作流新实例关闭通过；Windows 匹配 SDK 与 GLM 重放待实测，保持 EXPERIMENTAL，Scanner 保持 0.14.0。
+
+## 2.10.0 - 2026-10-08
+
+### 新增
+
+- 发现有 SDK 类型证据的静态窗口及 WindowStage，公开接口不再一并阻止非破坏性上下文复用。
+- 在已有公共依赖中统一分配受控 ContextUtils，分别注册 UIAbility 和窗口上下文，可空 getter 与身份令牌防止旧页面清除新注册。
+- Adapter 从所选 SDK 语言库解析 Intl.DateTimeFormat、format 和 weekday 类型证据，未知运行时版本要求能力判断及旧 API 回退；Scanner 保持 0.14.0。
+- 预览、应用、诊断和报告分别统计分组、计划编辑、未修复、人工决策与实际修改，附具体阻塞分类。
+
+### 修复
+
+- 用 AST 语句改写替代默认 IIFE，拒绝新增前导空语句与 void 重抛；复用工程 Logger、TAG、有效 catch，并保留调用顺序、换行及返回契约。
+- 受控服务直接复用真实 UIAbilityContext，保留 filesDir 和 cacheDir 的原用途，不新增依赖或强制类型转换。
+- 模拟器先探测命令能力，必要时通过 HDC 使用设备 UITest；仅点击布局中明确的确认控件，不猜坐标。
+- 本次启动的模拟器成功或失败均先保存证据再关闭；已有实例不关闭，停止失败独立记录，状态轮询最多 30 秒。
+
+### 验证边界
+
+- 本机逐条静态核验 103 处记录，SDK 扫描维持 217 处；候选审计不等于完整修复，仍需匹配工程、SDK 的双平台真实构建、模拟器及 GLM 验收，Windows 保持 EXPERIMENTAL。
+
+## 2.9.0 - 2026-10-08
+
+### 修复
+
+- 拟议修改同时执行所选 SDK 的类型检查和 ArkTS Linter，拒绝新增任意类型抛出、隐式返回类型和 any/unknown。
+- 生成强类型 IIFE 与 Promise 拒绝处理，缩窄同步错误类型，并复用有源码证据的已有异常处理。
+- 构建快照在回滚之前固定；真实编译结果、证据一致性、异常审计与废弃残留分别报告。
+- 只根据去除 ANSI 后解析的真实错误路径回滚关联文件事务；环境、签名和超时失败不消耗代码修复次数。
+- 重试检查前置到预览和记录阶段，日志文字、空语句、范围和哈希微调不再算新方案。
+
+### 新增
+
+- 新增 ImagePacker.packing 到 packToData 的准确重载迁移。
+- 新增 prepare-repairs、diagnose-run、输入绑定的验证凭据和阶段运行指标，减少重复查询与完整类型检查。
+- 构建尝试独立保存原始输出、进程状态、诊断和失败决策；队列引用共享诊断，不再逐组复制截断日志。
+- 新运行目录使用 workflowVersion 3；历史运行目录只读查询，不清空旧修复记录。
+
+### 验证边界
+
+- Windows 实机与 GLM5.2 重放仍需匹配 SDK 验收；不以诊断体积缩小代替实际 token 计费下降，Windows 保持 EXPERIMENTAL。
+
+## 2.8.1 - 2026-10-07
+
+### 文档
+
+- 精简 README 为安装和测试使用指南，补齐废弃 API 与行为变更两类用法，明确结果位置、验收要求和环境排障方法。
+
+## 2.8.0 - 2026-10-06
+
+### 新增
+
+- 按用户目标 SDK 平台版本校验 DevEco 最低版本，支持 API Level 简写及三段／四段 IDE 版本，过低或无法识别时返回明确的环境修复诊断。
+- doctor 支持显式目标参数，与 inspect-toolchain 统一报告实际 DevEco 版本、最低要求和兼容状态，环境不满足时不推荐扫描命令。
+
+### 修复
+
+- full、deprecated-only 和规则检查在扫描后端启动前校验 IDE 版本，环境预检不再探测版本不合格后端的帮助入口。
+
+### 文档
+
+- 移除固定要求 DevEco Studio 26 的表述，说明目标版本门槛、精确 SDK 快照要求及已有 CSV 流程边界。
+
+## 2.7.0 - 2026-10-01
+
+### 新增
+
+- 新增 doctor、preview-decisions 和 validate-run，记录实际安装版本、SDK 和实现指纹；生成准确替代、版本分支、异常处理、调用链参数注入及生命周期 Provider 的预览 JSON。
+- 新增 REPLACE_RANGE 原始快照范围编辑，统一去重和冲突预检，支持重复调用、CRLF 和可合成的嵌套修改。
+- 新增源码账本与完整组覆盖检查，禁止遗漏组、覆写成功决策或绕过应用步骤后宣称验证通过；编译修复刷新当前源码范围和多文件指纹。
+- 新增合法低版本 guardedFallbacks 审计及独立调用／分组统计；模拟器命令、原始输出和退出状态持久化保存。
+
+### 修复
+
+- Adapter 和 Scanner 共用版本解析入口，API Level 简写一致，未指定目标时直接采用工具链精确通道。
+- SDK 缺失导出按工程使用与公开导出影响分类，无关缺失仅告警；prepare 自动发现时间戳 companion 并拒绝 INCOMPLETE 证据。
+- 按完整 SDK 替代签名选取重载，Resource 参数正确转为 id；实际类型程序拒绝错误音量接收者、参数及新引入废弃枚举。
+- 上下文候选逐调用点验证，参数注入合并所有函数与调用点并保留可选参数语义；Window 通过 getUIContext 取上下文，保护无分号代码的表达式边界。
+- 异常处理校验使用保留位置的字符串／注释掩码及平衡代码块，避免 hilog 的 %{public}s 格式串和嵌套 catch 内容导致误报。
+- SDK 密集型回归按文件串行执行，避免多个完整类型程序并行造成内存争用。
+
+## 2.6.0 - 2026-09-29
+
+### 新增
+
+- 目标 SDK 按显式 target、显式扫描上限、工具链精确版本解析，完整区分 Beta、Beta1、Beta2 与 Release。
+- 新增 schema v4 废弃迁移上下文、模块 decision bundle、`record-decisions` 原子批量接口及共享／模块 Provider 候选。
+- 新增带指纹的三次编译修复队列；编辑应用改为幂等，编译失败只回滚相关文件事务并保留已成功修改。
+
+### 修复
+
+- Adapter SDK 声明证据使用跨平台路径身份并保护缺失 SourceFile，不再触发读取空对象 `text`。
+- CLI 错误输出增加 command、stage、stack、cause 和诊断产物；参考资料哈希统一 BOM 与换行符。
+- 禁止通过临时 JavaScript、`node -e` 或 workflow body 生成决策，避免 Windows 反斜杠、文件锁和 `fs global` 能力错误。
+
+## 2.5.1 - 2026-09-29
+
+### 修复
+
+- adapter 侧全部 CSV 交付件统一输出带 UTF-8 BOM 的文本：`compatibility-matrix.csv` 与适配后 CSV 不再缺失 BOM，修复 Windows Excel 双击打开时中文按 ANSI(GBK) 解码出现的乱码；矩阵换行统一为 CRLF。
+- 适配后 CSV 不再依赖源扫描 CSV 是否带 BOM，一律写入 BOM；模拟器验证回读兼容性矩阵时先剥离 BOM 再解析。
+
+## 2.5.0 - 2026-09-29
+
+### 新增
+
+- 集成扫描默认输出到工程 `.api-change-output/`，每次运行新建 `YYYYMMDDHHmmss` 时间戳子目录，CSV 与扫描 JSON 文件名携带相同时间戳（如 `apiChange_20260729082350.csv`）。
+- 扫描器新增 `--mode deprecated-only` 专项模式：行为／UX／定义变更规则不进入扫描，主 CSV 中 `Change Type` 只存在 `Deprecated API`；adapter `scan-prepare` 同步透传该参数。
+- 主 CSV 与验证 CSV 的 `Title` 列改为超链接公式：行为变更行链接官方变更文档，废弃行优先链接关联变更文档 URL、公开 `@ohos.<module>` 模块回退官方 API 参考页，验证清单行链接本地 changelog 来源文档；无法可靠构造链接时保持纯文字。
+- 原生模块构建前置自动执行 `ohpm install`（10 分钟超时），失败以 `OHPM_INSTALL_FAILED` 报错，`ohpm` 不可用时以 `OHPM_UNAVAILABLE` 提示。
+
+## 2.4.14 - 2026-09-29
+
+### 修复
+
+- SDK 声明目录增加按当前平台规范化文件路径与起始偏移构成的位置索引，Windows 反斜杠类型节点可命中正斜杠目录条目。
+- 修复 `showToast`、`packing`、`DateTimeFormat` 等调用的符号和重载均解析正确，但原始节点文件名仍使用反斜杠而无法映射 `API Symbol ID` 的漏报。
+
+## 2.4.13 - 2026-09-29
+
+### 文档
+
+- 新增仓库开发纪律 `AGENTS.md`：固定“代码修改与验证、版本号与 CHANGELOG 同步、自动提交、自动推送”四步交付流程。
+
+## 2.4.12 - 2026-09-29
+
+### 修复
+
+- SDK 符号目录查找改为同时使用 `getOriginalNode()` 的 SourceFile 和起始位置，不再混用 Windows 类型检查器克隆节点的反斜杠文件名。
+- 修复工程调用已解析到正确 SDK `api/` 声明和重载，但 `catalogEntry` 因文件名与位置来自不同节点而返回空的废弃 API 漏报。
+
+## 2.4.11 - 2026-09-29
+
+### 修复
+
+- Windows ArkTS 类型程序的编译器文件身份统一使用平台路径语义，将模块解析返回的反斜杠路径与 ArkTS parser 的正斜杠 `SourceFile.fileName` 视为同一文件。
+- 修复 SDK `api/` 模块废弃声明已正确索引，但 Windows 类型检查无法把工程调用关联到这些声明的漏报。
+
+## 2.4.10 - 2026-09-29
+
+### 修复
+
+- integrated DevEco 后端的 `--startVersion` 和 `--endVersion` 现在使用编译规则时实际选中的文件基名，而不是固定重建带 `(26)` 的旧命名。
+- 修复 Windows DevEco 26.0.0.751 已识别 `HarmonyOS_26.0.0_Release.json` 后，启动后端仍因收到 `HarmonyOS_26.0.0(26)_Release` 而报 `error[10001] Invalid endVersion`。
+
+## 2.4.9 - 2026-09-28
+
+### 修复
+
+- API 26 规则文件同时支持 `HarmonyOS_26.0.0(26)_Release.json` 和 `HarmonyOS_26.0.0_Release.json` 命名，覆盖 Windows DevEco 26.0.0.751 省略 `(26)` 的布局。
+- 目录与 JAR 的规则去重改为使用平台版本、API Level 和 Beta／Release 通道，避免两种文件名重复加载同一版本。
+
+## 2.4.8 - 2026-09-28
+
+### 修复
+
+- DevEco 同时存在展开规则目录和 project API change JAR 时，按版本文件合并两个来源；展开目录同名文件优先，JAR 仅补齐缺失版本。
+- 修复 Windows DevEco 26.0.0.751 展开目录缺少 API 26 Release 规则、但 JAR 包含该规则时误报 `INCOMPLETE_RULE_COVERAGE`。
+
+## 2.4.7 - 2026-09-28
+
+### 修复
+
+- ArkTS parser 在 Windows 上返回正斜杠 `SourceFile.fileName` 时，使用 Windows 路径语义识别所属工程模块，`Code Location` 不再混用 `components/`、`features/`、`commons/` 和模块名前缀。
+
+### 文档
+
+- 明确跨平台废弃 API 金标比较必须使用相同工程快照和完全相同的目标 SDK 快照，不直接比较 Beta 与 Release 目录。
+
+## 2.4.6 - 2026-09-28
+
+### 修复
+
+- Windows DevEco 安装包仅提供 `worker.js` 而 `index.js` 请求不存在的 `ApiScan.worker.ts` 时，在扫描器子进程内定向到已安装的 worker bundle，不修改 DevEco 目录。
+
+## 2.4.5 - 2026-09-28
+
+### 修复
+
+- DevEco `index` 后端改用配置文件中的工程路径启动模块扫描，由后端内部分批，不再将全部 ArkTS 源文件路径拼成单个 `--scanFilePaths` 命令行参数。
+- 大型工程在 Windows 上不再因 CreateProcess 命令行长度限制触发 `spawn ENAMETOOLONG`；报告仍按用户选定的源文件集合过滤。
+
+## 2.4.4 - 2026-09-28
+
+### 修复
+
+- 废弃规则审计现在使用 ArkTS parser 报告的文件名匹配 SDK 源文件，兼容 Windows 上 parser 将反斜杠规范化为正斜杠的行为。
+- SDK 声明源确实缺失时返回 `SDK_DECLARATION_SOURCE_MISSING` 及规则、符号和文件证据，不再抛出无上下文的 `undefined.text`。
+
+## 2.4.3 - 2026-09-28
+
+### 修复
+
+- 兼容 Windows API 26 Beta1 SDK 中没有 `tagName` 的 JSDoc 节点，扫描废弃声明时不再触发 `Cannot read properties of undefined (reading 'text')`。
+- 扫描失败 JSON、`diagnostics.json` 和 Adapter 错误现在保留失败阶段，方便定位工具链、规则、SDK 目录或后端扫描问题。
+
+## 2.4.2 - 2026-09-28
+
+### 修复
+
+- 行为策略来源哈希在计算前将 CRLF 和 CR 统一为 LF，避免 Windows Git checkout 导致 320 条策略全部误报过期。
+- 区分来源文档缺失与内容变更，并为参考文档和策略目录增加 LF 属性约束。
+
+## 2.4.1 - 2026-09-28
+
+### 修复
+
+- Windows 未展开 `resources/apiChange` 时，直接读取 `project-api-change-assistant` JAR 内的 `apiChange/*.json` 规则包。
+- project API change JAR 改为普通规则目录缺失时的资源后端，不要求用户修改或解压 DevEco 安装目录。
+
+## 2.4.0 - 2026-09-26
+
+### 新增
+
+- DevEco 布局改为能力探测：记录产品版本、扫描器候选、CLI 契约、规则资源、ArkTS parser 和 SDK family 实际路径。
+- Windows 缺少综合 `api-change-scan` 入口时，可使用 DevEco `index` 后端完成 ArkTS 扫描并转换原始 CSV。
+
+### 修复
+
+- `scan-prepare` 先统一发现与 SDK 分离安装的 DevEco Studio，再将解析后的 IDE 根目录传给 scanner。
+- 不再把未使用的 project API change JAR、C API JAR、JBR 和 Hvigor 作为所有扫描的启动硬门槛；C/C++ 或 Native 能力缺失时返回明确能力错误。
+- SDK 的 `openharmony`／`HarmonyOS` family、ArkTS parser 和 hdc 改为按目录内容发现，避免固定 macOS 路径。
+
+## 2.3.0 - 2026-09-24
+
+### 新增
+
+- 新增 macOS／Windows 共用的平台进程、文件和路径层，支持 Windows `.cmd/.bat`、进程树超时清理、可恢复目录替换和安全产物文件名。
+- `scan-prepare`、`prepare`、`inspect-toolchain`、scanner `scan` 与 `inspect-rules` 新增可选 DevEco Studio 根目录；`prepare` 和 `inspect-toolchain` 可显式指定 SDK。
+- 新增 Windows 10/11 x64 的工具链布局、独立 SDK、空格／中文路径、进程树和文件替换测试，以及 macOS／Windows GitHub Actions 矩阵。
+
+### 变更
+
+- 工具链发现现在记录 SDK、DevEco Studio 和各可执行文件的来源，并优先使用同一显式工具链，避免静默混用安装。
+- 内置 scanner 升级至 `0.9.0`；Windows 集成扫描、构建和模拟器能力在真实金标验收完成前标记为 `EXPERIMENTAL`。
+
+## 2.2.0 - 2026-09-24
+
+### 新增
+
+- 内置 320 条行为变更的确定性策略目录，区分代码／配置整改、代码复核和运行验证。
+- 新增 `apiChange.validation.csv`，按规则聚合视觉、布局、字体、动画和交互验收项。
+- `apiChange.scan.json` 升级为 schema v4，新增 `actionGroups` 和 `validationGroups`。
+
+### 变更
+
+- 主 CSV 中的行为变更按规则、API 和文件聚合；Adapter 从完整 JSON 恢复全部调用位置。
+- 内置 scanner 升级至 `0.8.0`，旧 schema v3 和历史 CSV 仍可读取。
+
+## 2.1.0 - 2026-09-22
+
+### 新增
+
+- 将 API 12 固定为行为／UX 变更的已适配基线，基线规则不进入 DevEco 扫描后端，排除证据写入 `coverage.json`。
+- 官方文档明确无需适配的命中新增结构化 `applicabilityProof`，保留原文字段和结论。
+
+### 变更
+
+- 内置 scanner 升级至 `0.7.0`；API 定义变更、废弃 API 全量状态和 C++ 超时非阻断机制保持不变。
+
+## 2.0.2 - 2026-09-22
+
+### 修复
+
+- 修复构建失败回滚新建文件时错误写入空内容的问题；对于 `before = null` 的反向编辑，现在会在哈希校验通过后删除该文件。
+
+## 2.0.1 - 2026-09-22
+
+### 文档
+
+- 新增中文 `README.md`，简要说明 Skill 的安装、输入、调用方式、主要输出和行为边界。
+- 明确完整 Skill 已内置 scanner，无需单独安装或复制扫描工具。
+
+## 2.0.0 - 2026-09-22
+
+### 变更
+
+- `vendor/harmonyos-api-scanner` 成为扫描引擎唯一源码；删除外部 scanner 覆盖、相邻 tools 回退和同步脚本。
+- 完整 Skill 复制和安装直接携带 scanner，缺失 vendor 时报告安装包损坏。
+- 根测试命令同时运行 adapter 与 scanner 测试；scanner 提供稳定 `src/index.mjs` 内部接口。
+- 扫描源码发现排除 Hvigor 生成的 `BuildProfile.ets`，保持构建前后输入快照稳定。
+
+### 迁移
+
+- 原 tools scanner 最后提交为 `82ec6cbbe085cae3ac8ee6dab0ef819b5c38886f`。
+- 迁移前两处源码树哈希均为 `2174072aa8551a2f1fa6fe76130edf310fc29c902d1d97c57320f7e83de82188`。
+- scanner 内部版本升级至 `0.6.0`，后续与 Skill 在同一仓库和提交中维护。
+
+## 1.9.0 - 2026-09-18
+
+### 新增
+
+- project-context schema v3 使用 ArkTS 类型检查器记录工程声明、调用边、参数值、SDK 属性身份、模块导出和生命周期候选。
+- 废弃迁移计划 schema v3 支持已有值复用、受控参数注入、生命周期初始化和未使用代码删除。
+- `verify-build` 增加废弃 API 复扫与 `deprecated-residual-audit.json`，区分项目源码和第三方依赖残留。
+
+### 变更
+
+- 新运行升级为 manifest schema v5；项目源码仍有废弃调用时最终适配状态为 PARTIAL，旧运行仍可读取和 finalize。
+- 兼容决策支持 `REPLACEMENT_CALL`、`EQUIVALENT_VALUE_REUSE` 和 `DEAD_CODE_REMOVAL`，不再强制所有修复都直接调用 `@useinstead` API。
+
+### 修复
+
+- 修复当前类缺少对象时过早标记 UNFIXED、未继续检查上游回调参数和内部调用链的问题。
+- 修复构建退出码为 0 时无法识别项目源码废弃 API 残留的问题。
+
+## 1.8.0 - 2026-09-17
+
+### 新增
+
+- 解析普通成员、静态成员、构造器、命名空间、事件和组件字段的 `@useinstead` 替代声明及其自身 `@since`，根据用户指定 compatibleSdkVersion 选择直接替换或新旧 API 版本保护。
+- OpenHarmony 与 HMS 分别使用 `sdkApiVersion` 和 `distributionOSApiVersion`；迁移计划及决策增加兼容策略和逐调用证据。
+- project-context 记录 Logger、hilog 和 deviceInfo 用法；新增日志必须复用工程 Logger 或 hilog。
+
+### 变更
+
+- 新运行升级为 schemaVersion 4，迁移计划升级为 schemaVersion 2；旧运行仍可读取和 finalize。
+- compatibleSdkVersion 低于旧 API 起始版本且没有现有保护时停止适配并请求用户确认，不自动提高配置。
+
+### 修复
+
+- 禁止使用旧 API 的废弃版本推断替代 API 起始版本。
+- 确定性拒绝新增任意 `console.*`，但不扩大范围清理未触碰的历史日志。
+- Promise 系统 API 即使没有 `@throws` 标签也必须登记 SDK 证据并使用 `.catch()`；保护分支中的新旧 API 分别校验异常证据。
+
+## 1.7.0 - 2026-09-16
+
+### 新增
+
+- 集成 scanner 0.5.0，废弃 API 按目标 SDK 全量状态检测；行为变更仍使用升级区间。
+- SDK 声明可独立作为适配证据，核对声明身份、废弃版本及完整扫描中的源码哈希。
+- 同一调用的类／成员废弃聚合为一个整改工作组，保留关联 SDK 声明，避免重复编辑。
+- 转发可信编译日志及快照参数；依赖告警仅允许升级建议／人工确认，禁止自动修改第三方源码。
+- 非增量 verify-build 可生成包含 SDK、源码、配置和日志哈希的 build-evidence.json；输入不稳定或验证失败的证据不能导入。
+
+### 修复
+
+- 修复历史废弃没有平台版本映射或没有变更 Markdown 时无法进入 SDK 证据适配流程的问题。
+- 保留旧 CSV 和运行的读取／finalize 能力，以及现有异常处理、配置保护和 C++ 超时非阻断约束。
+
+## 1.6.0 - 2026-09-15
+
+### 新增
+
+- 新运行的代码决策增加 `exceptionHandling`，核对 SDK `@throws`、返回类型、同步 try/catch、异步 `.catch()` 和真实错误日志。
+- `verify-build` 输出 `exception-audit.json`，将系统 API 异常告警映射到已应用编辑及分组。
+- 构建成功但修改行仍有未处理异常时，验证状态为 `FAILED_EXCEPTION_HANDLING`。
+
+### 变更
+
+- 新运行升级为 schemaVersion 3，并使用非增量构建，避免缓存隐藏异常告警；旧运行仍可读取和 finalize。
+- 上下文 provider 失败返回可空值，调用方必须提前结束操作，不能用断言掩盖异常。
+- Skill 版本升级至 `1.6.0`，内置扫描器保持 `0.4.0`。
+
+### 修复
+
+- 修复废弃 API 替换及获取 UIContext 时没有同步异常保护的问题。
+- 修复 Promise 系统调用仅由外层 await/try 处理、没有 `.catch()` 证据的问题。
+
+## 1.5.0 - 2026-09-14
+
+### 新增
+
+- `scan-prepare` 和 `prepare` 输出模块依赖、入口 Ability、窗口初始化及 UIContext 候选信息到 `project-context.json`。
+- 新增 `validate-deprecated-plan`，要求在处理废弃 API 前统一确定模块级上下文策略。
+- 废弃 API 决策通过 `contextStrategyId` 关联迁移计划，并跨决策检查重复的 `windowStage` provider。
+- 决策编辑支持受保护的 `CREATE_FILE`，失败时能够删除本次新建且未被外部修改的文件。
+
+### 变更
+
+- API Level 简写和完整版本统一转换为 build-profile 规范：API 24 及以前保留 `(API Level)`，API 26 及以后写纯平台版本。
+- `build-profile.json5` 只能通过 `apply-config` 修改；写入前后校验哈希和规范化后的精确值。
+- Skill 版本升级至 `1.5.0`，内置扫描器保持 `0.4.0`。
+
+### 修复
+
+- 修复 `26.0.0(26)` 被直接写入 `targetSdkVersion`，必须等待 Hvigor 报错后人工改为 `26.0.0` 的问题。
+- 修复逐个废弃 API 分组独立获取 UIContext，容易在大量业务文件中生成重复辅助函数的问题。
+
+## 1.4.0 - 2026-09-09
+
+- 增加工程适用性证明和 `NO_ADAPTATION` 结构化证据校验。
+- 内置 HarmonyOS API scanner 0.4.0。