[qiyinxi]

改动

• 电脑检查里补全组件：组件一项没通过时，建议下面就是「补全组件」。点了打开许可协议对话框：先选下载源（自动、googledownloads_cn、tencent、google、自定义地址），对话框从这个源取《Android 软件开发套件许可协议》全文；换源或改自定义地址就重新取，取不到时错误留在对话框里，可以重新获取或换源。同意后开始下载，这一项下面显示每个组件的进度（字节数、百分比、速度、剩余时间）和「取消」；失败时写明原因和建议，按钮变成「重试」；完成后自动重新检查。主页横幅上的「补全组件」走同一个对话框。
• 同意的就是下载的那份协议：对话框把看过的全文的 SHA-256 带给 POST /api/components/fetch（必须带），后台补全时从同一个源取到的协议对不上，就以 components_rejected 停下，什么也不存、不下。日志写「已在管理器里同意许可协议」。组件文件照旧按程序里写好的 SHA-1 和大小核对，换哪个源都一样。
• 组件与问题反馈面板（设置里）：组件部分只显示状态和「去电脑检查补全」；可选组件标「（可选）」，没装写「未安装」。「收集问题信息」做完显示问题包路径、可以在资源管理器里打开所在文件夹（按任务打开，不接受页面给的路径），并显示后端给的隐私提示；「复制配置信息」复制到剪贴板并显示出来。
• 记住组件下载源（管理器和命令行记住组件下载源，设置页里可以选 ModAVD#120）：按 Windows 用户存在 %LOCALAPPDATA%\ModAVD\components-settings.json。设置页「组件下载源」和更新源并排：选内置源就保存，选自定义地址时填地址再保存。modavd components source [auto|googledownloads_cn|tencent|google] 查看、修改，--json 带上当前值（没有自定义地址时 mirror_urls 是 []）。界面和 components fetch 不带 --mirror / --mirror-url 时都用它；下载前那一行「下载源：」写明这次的源是参数给的、保存的设置、管理器里选的，还是默认。
• 命令行只在控制台里问：components fetch 还没存过源、stdin 是控制台时，用编号问一次并记住（直接回车是自动并记住，读到结尾只这次用自动）；--json、--accept-license、管道、文件、NUL 都不问、不保存，echo y | modavd components fetch 的 y 照旧回答许可协议。
• 自定义地址用 net/url 校验：http(s)、有主机名，不收用户名密码、?、# 和空格，最多 16 个、每个 2048 个字符以内。设置文件被改坏或写了不认识的值，读出来按没设置处理；旧的 downloads\source.txt 内容不认识时忽略。
• 检查页、命令行帮助、README 和开发用的 mock 的提示文字改成「在管理器里点『补全组件』，或运行 tools\modavd.exe components fetch」。现有命令行参数、退出码和 --json 输出不变。

测试

• gofmt -l . 没有输出；go vet ./... 在 windows、darwin/arm64、linux/amd64 三个平台都过，三个平台都编得过；Windows 上 go test ./... 全过；node --test 的两个脚本测试也过。
• cli、ui、components 三个包的测试用 TestMain 把 LOCALAPPDATA（非 Windows 还有 XDG_CONFIG_HOME、HOME）指到临时目录，后端用假执行器和临时根目录，不读写真实的 %LOCALAPPDATA%\ModAVD。
• 变异检查：每次只改坏一处、跑这几个包自己的测试，共 30 处：审查时的 19 处（其中 M04、M05、M06、M10、M11、M12 六处原来测试不挂）加这次新代码的 11 处，30 处测试都挂了。改坏的地方：
  • 选源和记住源：保存的源没用上、菜单的答案没存、编号对错、--accept-license 和 --json 时也弹菜单、读设置不校验、存设置不校验或没存上、读到结尾也存了默认、NUL 和管道当成控制台；
  • 许可协议：accept_license 为 false 也放行、真后端不拒绝没同意的请求、不带 license_sha256 也放行、哈希没传到补全、协议对不上也照下、取协议时不看请求里的源；
  • 下载源传到下载：请求里的源被忽略、真后端没把 Mirror / MirrorURLs 传下去、自定义地址不查协议、收带用户名密码的地址、旧 source.txt 不认识时直接失败；
  • 锁和校验：界面里补全和开机互斥（两个方向）、界面和命令行共用的文件锁、下载后和复用旧压缩包时的 SHA-1；
  • 日志和打开文件夹：诊断任务用了服务器总日志、许可协议全文按 Info 记、问题包不在了也去打开。
• 界面：用 --dev --no-window 同样的 ui.Run 起管理器（错误打到控制台，不弹框），LOCALAPPDATA 指到临时目录，根目录是假的（不放 emulator.exe，mas-avd.json 里 adb 端口设在 18600 段以外，不碰 5037、20049、20050），在浏览器里看过：
  • 模拟后端：电脑检查组件一项的「补全组件」→ 许可协议（自动、自定义地址各取各的全文）→ 进度和取消（取消按钮不再被重建）→ 第一次失败显示原因和「重试」→ 重试时记得上次选的源 → 完成后自动重新检查、组件一项通过；活动里标题是「补全组件」；设置页选内置源当场保存、重新打开还是它；面板的收集问题信息、在资源管理器里显示、复制配置信息（剪贴板换成了假的）。
  • 真后端：默认源取到 googledownloads.cn 的真实全文；自定义地址指向连不上的端口时错误留在对话框里；指向本机假镜像时显示的是假镜像自己的协议文本，同意后补全从同一个源开始，在假根目录上按预期失败并显示「重试」；设置页选 tencent 后设置文件和 modavd --json components source 都是 tencent；横幅进来、保存的源连不上时对话框照样打开。
  • 命令行：echo y | modavd components fetch 和 < NUL 都不弹菜单、不保存。

AUTO-MAS 要跟着改的（本 PR 不改）

对照 AUTO-MAS 上游 dev 00ce51042。都改成「在 ModAVD 管理器的电脑检查里点『补全组件』，或运行 tools\modavd.exe components fetch」这个意思：

• app/utils/common/emulator2/avd/__init__.py:24 的文档字符串；
• app/utils/common/emulator2/avd/components.py:23、:71、:73（给用户看的提示）、:503；
• app/utils/common/emulator2/avd/precheck.py:27、:221；
• app/utils/common/emulator2/detect.py:81；
• app/api/emulator/instances.py:64、:397（接口字段描述）；
• res/i18n/zh_CN.json、en.json、ja.json 的 core.emulator2.reason.components_missing（en、ja 现在写的是「用完整的测试包」）；
• 前端 frontend/src/api/models/Emulator2AvdStatusOut.ts、Emulator2SearchItem.ts 是按 instances.py 的接口描述用 OpenAPI 生成的，改完 instances.py 重新生成，不手改；
• 去掉随包的三个批处理和三个脚本，补全组件和问题反馈改由管理器和命令行做 ModAVD#119 删掉随包的 bat 以后：app/utils/common/emulator2/avd/update_stage.py:42 文档字符串里的「两个 bat」。

已知没修的

• 审查意见 P3 g 的后半：收集完以后显示的是后端的隐私提示（report.PrivacyNote），它照 collect-info.ps1 逐字搬来、有对拍测试，第一句还写着「脚本不会上传」。等 去掉随包的三个批处理和三个脚本，补全组件和问题反馈改由管理器和命令行做 ModAVD#119 删掉脚本时一起改，issue 草稿已交给维护者。
• 审查意见 P3 j：feat: 增加按实例诊断模式与有界现场保留 #78 已在 main 上，和它的冲突（两边都新加了 internal/ui/diagnostics_test.go）在合并提交 34d8c8f 里解掉了：feat: 增加按实例诊断模式与有界现场保留 #78 那份留在原文件名，本 PR 那份原样挪到 internal/ui/diag_jobs_test.go。macOS：补全固定版本 SDK 组件下载与安装 #72 也改了 internal/components/fetch.go，后合的那个要解冲突。
  Refs 随包的三个 .bat 改成先调 modavd 命令行（等管理器 0.3.0 进包） ModAVD#45
  Refs 管理器和命令行记住组件下载源，设置页里可以选 ModAVD#120