0.5.6 · Restore fix 1 / 恢复修复版 1

0.5.6 · Restore fix 1 — 2026-10-16

This update targets recovery failures in recognized toolkit installations. Before withdrawal it blocks saved reapplication, waits for capture to finish, leaves AF-C/AFT through the stock focus interface, verifies idle, then runs the existing guarded Restore-all worker. Completed transient refusals have bounded retries; a lost USB reply never starts a second writer automatically. R01–R12 distinguish preparation, validation and communication failures.

Recognized older installations can use Connected → Restore original without first installing newer features. Exact known manifests, original backups, ownership and file hashes must still validate. Unknown modifications and damaged backups remain refused.

Known unresolved issue: Eye layout validation can fail, and when Eye is installed this can also prevent Tracking Autofocus from enabling. This recovery update does not fix that installation/activation issue. Camera payloads, native helpers and the old recovery catalogue are unchanged.

Validation: 380 of 382 offline regressions pass; two stock-region simulations were unavailable and are not counted as passes. Additional UI/package, focused recovery, cross-version and host/file-restore checks passed. Physical-camera recovery and native Windows/driver validation remain pending.

This is a manually downloaded prerelease. The project is completely free.

---

中文更新说明

本次针对已识别旧版安装的恢复失败：恢复前阻止保存设置重新应用，等待拍摄完成，通过原厂对焦接口退出 AF-C／AFT 并确认空闲，再执行原有严格撤回流程。已明确结束的临时拒绝有限重试；USB 回包丢失时不自动启动第二次写入，并提供 R01–R12 诊断。

已识别的旧版可直接使用“已连接 → 恢复原状”，无需先安装新版功能；仍须通过固定清单、原始备份、运行归属和文件哈希校验，未知修改及损坏备份会停止。

已知未修复：眼部布局校验失败可能连带阻止追踪自动对焦开启。本次只修恢复流程，没有修复该安装／启用问题。 相机载荷、原生 helper 及旧版恢复清单未改动。

382 项离线回归中 380 项通过，两项原厂区域仿真不可用，未计为通过；另有界面、恢复、跨版本及桌面文件恢复检查通过。故障相机实测及 Windows 原生／真实驱动验证仍待完成。

本项目完全免费，当前为手动下载预发布。

0.5.0 测试版 — macOS Test3 / Windows Test4

下载 / Downloads

• Mac：0.5.0 Test3 — macOS 13+，Apple Silicon / Intel 通用包
• Windows：0.5.0 Test4 — Windows 10 / 11 x64 完整包

已知 Bug（正在修复中）：使用像素位移后，照片格式会被调整为 RAW，且不会自动恢复原来的照片格式。

Known bug — fix in progress: after using Pixel Shift, the photo format is changed to RAW and does not automatically return to the previous format.

这是测试版发布，包含上面两个不同测试修订的原始安装包。原包不重新打包；SHA-256 见附件 SHA256SUMS。包内“仅本地交付／不发布”是构建时的历史说明，本次由维护者决定公开这两个测试包。

功能与使用

面向第一代 X2D 100C / 907X & CFV 100C、原厂固件 4.2.0。保留 AF-C、追踪自动对焦、三档对焦加速、眼部识别和后屏自动亮度，增加独立的像素位移安装选项，默认不勾选。像素位移通过驱动模式使用，提供 4／6／16 张 RAW 序列，需另在电脑合成。

Mac Test3 修订实际拍摄张数同步、参数读取超时重试等；Windows Test4 另外修订状态读取期间用户开关命令被丢弃的问题。完整使用说明在对应 ZIP 中。

升级前务必先用原电脑、原软件版本执行“一键恢复原状”，确认完成后再更换电脑端软件并重新安装扩展。 参见升级顺序与风险告知。

验证范围

本次上传重新核对原包 SHA-256、字节数及 ZIP CRC，均通过；没有重建软件或操作相机。历史构建记录：Mac Test3 的离线套件 328 项、无跳过；Windows Test4 为 343 项、无跳过，并有解压包回归检查。历史记录中的硬件、USB 与 Win32 输入存在明确替身，不能视为实机验收。

Mac Test3 有用户反馈使用正常；RAW 张数与光学效果未量化。Windows 原生启动、真实驱动及相机验收仍待完成，907X / CFV 的实机验证也待完成。此预发布不替代 0.4.17 稳定版入口。

These are the original Mac Test3 and Windows Test4 test packages. Existing build records describe offline checks with substituted hardware inputs; this upload rechecked archive hashes and integrity only. Native Windows/device and CFV validation remain pending. Restore using the original computer and original app version before upgrading. The local-only wording inside the original packages predates this public prerelease.

本项目完全免费，下载及使用不需要付款。This project is free to download and use. 各组件保留包内原有许可。

0.4.17 — 三档速度可选 / Three selectable focus speeds

升级前必读 / Read before upgrading

**务必、务必、务必：相机已安装本工具扩展时，升级软件前先使用原电脑、原软件版本执行“一键恢复原状”，确认恢复完成后，再升级电脑端软件并重新安装相机扩展。**虽然本软件支持相同软件版本下跨电脑恢复，为避免一切不必要的麻烦，升级时仍务必先用原电脑原版本恢复。完成恢复前，不要卸载、覆盖或删除原软件及备份。

If your camera already has this toolkit's extension, you must run “Restore original” using the original computer and original Software version before upgrading the desktop Software. Confirm completion, then upgrade and reinstall the camera extension. Recovery on another computer is supported with the same Software version; nevertheless, always use the original computer and original version first to avoid unnecessary problems. Do not uninstall, overwrite or delete the original Software or backups before recovery completes.

升级顺序 / Upgrade procedure · English risk notice and disclaimer · 中文风险告知与免责声明

Documentation notice updated on 12 October 2026; published application packages are unchanged. 本提醒于 2026-10-12 更新，仅修改说明，不改变已发布软件包。

Three selectable focus speeds / 三档速度可选

Provide Low, Medium and High focus speed choices, offering a gentler acceleration option for older lenses. The native vertical scrolling picker sits below Focus Speed Boost, uses orange highlighting, and stays gray and unavailable while acceleration is off. The selected level survives disabling and restart; Restore clears it.

新增低、中、高三档对焦速度可选，提供对老镜头更友好的温和加速选择。原厂上下滑动选择器位于对焦加速开关下方，使用橙色高亮；关闭加速时保持灰色不可选。关闭及重启保留档位，恢复原状时清除。

Level / 档位	Type 0	Type 1	Type 2
Low / 低	1.5	1.5	1.5
Medium (default) / 中（默认）	2.5	2	1.5
High / 高	3	3	2

Multipliers describe motor-control parameters, not measured overall autofocus gains or a lens-safety guarantee. 原有老镜头提醒保留；倍率不代表实测整体对焦提升或已验证镜头安全。

Download and update / 下载及更新

• Windows 10/11 x64: download the Windows ZIP below and extract the complete folder.
• macOS 13+ (Apple silicon / Intel): download the Mac universal ZIP below and extract it completely.
• Stable 0.4.12 can find this update. 0.5.0 private-beta users will not receive it; the beta update repository remains separate.
• 公开稳定版可检查到本次更新；0.5.0 内测用户不会收到更新。先在原电脑使用原软件版本恢复原有扩展，确认完成后再升级电脑端，最后点击已连接 → 一键安装安装新版相机菜单。
• If a camera has private-beta modifications, first restore using the original computer and original beta app before upgrading or installing the stable version. 相机若装有内测扩展，务必先在原电脑使用安装当前扩展的原内测 App 恢复，确认完成后再升级或安装稳定版。

Built from original 0.4.12, retaining AF-C, Focus Speed Boost and Auto Brightness. The published application and camera-payload bytes match the locally tested build; only ZIP instructions are updated. The retained stable-speed-test-1 internal label identifies that verified build.

Validation / 验证

215 full offline tests, 4,206 machine-code cases, 14 complete Restore scenarios, three-language stock Qt selector checks and native Mac selection checks passed. Archive, payload, 76 Mach-O and 38 PE audits passed. Hardware/backend inputs are substituted; native Windows/CFV, camera touch/GPU and optical testing remain pending. See validation details.

本地完整回归与原厂控件检查通过；Windows 为本地交叉构建及静态／离线核验，实机表现仍待验证。

Free project / 免费项目

This toolkit is free. Do not pay anyone for this software or installation services without the author's separate permission. Professional photography remains allowed under the project license.

本工具免费提供。未经作者单独许可，不得出售软件或收费提供安装服务；正常商业摄影使用不受影响。

欢迎交流 / Discussion and contributions

欢迎交流、分享研究发现和使用反馈。欢迎通过 Issues 讨论问题与建议，也欢迎提交 Pull Requests 改进代码、文档和测试。

Discussion, research findings and feedback are welcome. Please use Issues for questions and suggestions, and submit Pull Requests to improve code, documentation and tests.

0.4.12 — 稳定基础版恢复下载 / Stable baseline restored

0.4.12 稳定基础版重新上架 · 2026-10-07

这是我之前发布的 0.4.12 版本，现在重新提供下载，请大家先暂用这一版。它保留 AF-C、对焦加速和后屏自动亮度，人眼识别、人脸追踪对焦和像素位移暂不提供。

这次收到相机异常反馈后，我花了一整天排查。后来补充的安装历史表明，相关相机此前安装过另一位作者的补丁，修改了保存在相机的持久化配置。常规重刷固件不会清空这份配置，因此即使重新升级固件，其对相机系统的修改依旧保留；这并非永久无法恢复，我可以为已经出现问题的用户提供恢复帮助。最初缺少这部分信息，我把第三方补丁留下的状态误当成了我们旧版软件的问题，排查和开发方向因此走偏。

后续修补不断叠加，让软件越来越复杂，也引入了新的稳定性问题。这部分责任在我，向大家道歉。现在先回到我重新试装确认正常的 0.4.12 基础版本。

之前承诺的人眼识别、人脸追踪对焦和像素位移，将全部重新规划、重新开发。感谢大家理解。

下载与使用

• Mac 保留原始 0.4.12 安装包。Windows 包仅去除 DLL 中的本机构建路径并同步校验值，版本号、可执行代码和相机载荷不变；未新增 Windows 实机验证。
• 正在使用 0.4.13 及以上版本的用户，请手动下载、完整解压并打开 0.4.12；自动更新不会降级。
• 安装过其他作者补丁的用户，请先用对应工具恢复原厂 4.2.0；0.4.12 仅撤回本工具认识的改动，不能保证清理其他补丁的人眼设置。
• 本项目完全免费，下载和使用无需付款。

English

The original 0.4.12 Mac universal and Windows x64 packages are available again as the recommended stable baseline. The Mac package is unchanged. The Windows package redacts a DLL build-path constant and updates its integrity hashes; executable code, camera payloads and version numbers are unchanged. No new native Windows device validation was performed. The maintainer reports successful reinstallation on their own Mac/camera; this does not establish new native Windows or CFV validation.

After receiving reports of camera issues this time, I spent an entire day investigating. The installation history provided later showed that the affected cameras had previously been patched with another author's tool, which modified persistent configuration stored on the cameras. A normal firmware reflash does not clear this configuration, so those modifications to the camera system remain even after reinstalling the firmware. This does not mean they are permanently irreversible; I can help affected users restore their cameras. Without that information at the outset, I mistook the state left by the third-party patch for a problem in our older software, which sent the investigation and development in the wrong direction.

Subsequent toolkit changes also introduced their own stability failures. Eye Recognition, Face Tracking Autofocus and Pixel Shift are deferred for fresh development. Version 0.4.12 supplies AF-C, focus acceleration and auto rear brightness only.

Users of 0.4.13 or later must download and replace the desktop app manually because the updater does not downgrade. Restore another author's patch using its own tool first; 0.4.12 is not a universal patch-recovery or Eye-cleanup tool. Download and use remain free.

---

原发布记录 / Original release notes

Fix focus UI state / 修复对焦界面状态

• When either Tweaks or AF-C is OFF, retain the original two-item focus popup, original captions/icons and original liveview visibility rules. Stock focus compiled caches and AOT callbacks remain untouched.

• When both switches are ON, load the private three-mode popup and synchronize AF-S, AF-C and MF icons across the control screen and liveview, including disabled icons. Turning the feature off restores the original dynamic bindings.

• Preserve 0.4.11 upgrade/restoration records for all seven feature selections and all three languages. Mac and Windows include the same camera payload fix.

• Validation: 202 offline tests passed; clean source: 172 passed, 30 skipped. Qt 6.4.1 checks cover three languages, the actual two-switch gate, original stock sources, repeated switching, mode icons and restoration. Mac native launch, 76 Mach-O / 38 PE dependency audits, package/recovery hashes and updater extraction checks passed. Physical camera installation/visual behavior and native Windows execution remain pending.

• “耍起功能”或 AF-C 任一开关关闭时，使用原厂两项对焦弹窗、原厂文案和图标、原厂取景显示规则，不再在启动时替换原厂对焦缓存。

• 两个开关都开启时，加载三模式弹窗，主页与实时取景同步显示 AF-S／AF-C／MF 和灰色图标；关闭后恢复原厂动态绑定。

• 保留 0.4.11 七种功能组合、三种语言的升级与恢复记录。Mac 和 Windows 使用相同的相机端修复。

• 202 项离线测试通过；干净源码 172 项通过、30 项跳过。三语言 Qt 回归、Mac 原生启动、依赖审计、安装包与恢复哈希、更新解压检查通过。相机实机安装和视觉行为、Windows 原生运行仍待验证。

Updating the desktop app alone does not update the camera. Connect the camera and use Install to apply this fix; a recognized older installation requires the app's restore/reinstall confirmation.
仅更新桌面软件不会改变机内界面。更新后连接相机并使用“一键安装”写入修复；已识别的旧版会按软件提示确认恢复并重新安装。

Extract the entire ZIP before opening the app. 完整解压 ZIP 后再启动软件。 SHA-256 checksums are in SHA256SUMS.

0.4.11 · 选择安装界面与菜单资源加载修正

Mac and Windows now use the confirmed selectable interface: a left log card, separated feature rows, an installation summary and matching rounded controls. Select AF-C, focus acceleration and rear brightness independently. Unselected camera rows are hidden; unselected AF-C leaves stock focus resources untouched and unselected brightness omits its runtime.

Address the user-reported FOCUS_RESOURCE_API_MISSING by locating the stock GUI's local static Qt resource functions only after exact code-fingerprint checks. Previous 0.4.9/0.4.10 manifests and recovery bytes are retained. If an old install reported this error, keep the connection and use Restore original before checking and installing this version.

201 offline tests pass with exact local payloads; clean source passes 172 and skips 29. Native Mac selection/Settings, nine Windows shared-layout previews, Qt page/mask checks, 76 Mach-O and 38 PE audits, 32 current payload variants, 66 recovery files and updater extraction checks pass. Native Windows execution and corrected preload/menu loading on a physical camera remain pending. No camera was installed, restored or restarted during this update.

Mac：macOS 13+，Apple 芯片与 Intel 通用。Windows：Windows 10/11 64 位。下载后完整解压再运行。

正式采用确认的新版界面：左侧日志卡片、独立勾选功能、功能行分隔线、浅灰安装摘要和统一圆角控件。语言选择在操作后继续保持圆角；未选择的相机功能行隐藏，开关默认关闭。

针对 FOCUS_RESOURCE_API_MISSING 导致的菜单缺失，补上原厂 Qt 本地静态资源函数定位及精确代码指纹校验。保留 0.4.9／0.4.10 恢复文件。若旧版安装已报此错误，请保持连接，先使用“恢复原状”，再用新版检查并安装。未知修改仍需用原修改工具恢复原厂。

201 项离线测试及两平台安装包检查通过；Windows 原生运行、新预载的相机重启与实际菜单仍待实机验证。本次没有安装、恢复或重启相机。

0.4.10 — Camera integrity checks and focus guidance

Camera checks and focus guidance

• Verify the specified stock UI, focus/display binaries and startup configurations before installation. A recognized existing installation must also pass backup, configuration, file-ledger and actual payload checks; a ready service or menu receipt alone is insufficient.
• Stop on unknown modifications and tell the user to restore stock 4.2.0 using the original modification tool. A modified GUI now produces this guidance instead of a generic USB error. This toolkit does not overwrite or restore unknown modifications.
• Put the orange focus-acceleration description inside its feature row on Mac and Windows: it can be installed, but older-lens users are advised not to enable it in the camera.
• Camera payloads are unchanged from 0.4.9. Selectable feature installation is not included in this release.

195 tests pass with the exact local payloads; clean source passes 167 and skips 28. Three native Mac language previews, nine Windows layout previews, 76 Mac/38 Windows binary audits and package/update extraction checks pass. The checks cover specified files, not the entire firmware or live process memory. Expanded checks on real X2D/CFV hardware and native Windows execution remain pending; no camera installation, restoration or reboot was performed for this release.

Existing 0.4.9 camera installations do not need reinstallation for this desktop update. Use Settings → Check for Updates → Download and Install Update, or extract the complete ZIP below.

相机检查与对焦加速提示

• 安装前核验指定的原厂界面、对焦／显示程序与启动配置。已识别安装还须通过备份、配置、文件记录和实际文件哈希检查，不能只凭服务或菜单回执判定正常。
• 发现未知修改即停止操作，提示先用原修改工具恢复原厂 4.2.0。修改过的 GUI 不再笼统显示 USB 错误。本工具不会覆盖或恢复未知修改。
• Mac／Windows 橙色说明移入对焦加速功能行：“对焦加速通过将镜头转速提高三倍实现，可安装，但不建议老镜头用户在相机内开启该功能。”
• 相机载荷与 0.4.9 相同，本次发布不包含选择安装功能。

带精确本地载荷的 195 项测试通过；纯源码 167 项通过、28 项跳过。三种 Mac 原生语言预览、九份 Windows 布局预览、76 个 Mac／38 个 Windows 二进制及安装包／更新解压检查通过。检查只覆盖指定文件，不代表整个固件或运行内存均为原厂。新增检查仍待 X2D／CFV 实机和 Windows 原生运行验证；本次没有安装、恢复或重启相机。

已有 0.4.9 相机安装无需因本次桌面更新重装。可在“设置 → 检查更新 → 下载并安装更新”升级，或下载下方 ZIP 并完整解压。

0.4.9 — Focus UI update

Focus UI update

• Add the reviewed second-generation AF-S, AF-C and MF icons to the focus popup and liveview using the App's existing preload route.
• Keep the first-generation fonts and borders. The popup shows AF-S/MF while the AF-C feature is off, and AF-S/AF-C/MF when it is on; enabling the feature does not change the selected focus mode.
• Preserve Simplified Chinese, Traditional Chinese and English labels and the accepted liveview badge appearance.
• Keep the stock GUI check and existing upgrade/restore behavior. The new App preload route has passed offline checks but still needs physical camera validation.

Validation

184 local-payload tests pass; clean source passes 155 and skips 29 that require excluded build inputs. Qt 6.4.1 checks cover 18 icons and all three languages. Mac universal and Windows x64 package audits pass. Camera-side behavior of this new App route has not yet been tested.

对焦界面更新

• 通过 App 原有预载流程加入已验收的 AF-S、AF-C、MF 二代图标，覆盖对焦弹窗和实时取景。
• 保留一代字体与边框。AF-C 功能关闭时显示 AF-S/MF，开启时显示 AF-S/AF-C/MF；开启功能不会改变当前对焦模式。
• 保留简体中文、繁体中文和英文文案，以及已验收的实时取景图标底框样式。
• 保留原有 GUI 校验和升级/恢复流程。新版 App 预载路径已通过离线检查，仍待相机实机验证。

验证

带本地载荷的 184 项测试通过；纯源码 155 项通过、29 项因缺少构建输入跳过。Qt 6.4.1 检查覆盖 18 个图标和三种语言。Mac 通用版与 Windows x64 安装包检查通过。新版 App 路径尚未在相机上实测。

0.4.8 · Focus acceleration guidance

Download Windows 10/11 x64 ZIP · Download macOS 13+ Universal ZIP

Extract the whole ZIP, or update through Settings → Check for Updates → Download and Install Update.

Replace the desktop lens-change warning with: Focus acceleration works by tripling lens motor speed. Not recommended for older lenses. Rename the Chinese label to 对焦加速 / 對焦加速; the English feature names remain unchanged. The same guidance appears below the camera switch with stock-sized gray description text and automatic wrapping in all three languages.

After upgrading the desktop app, use Connected → Install to apply the new camera text. A recognized old installation is restored first after confirmation. The exact 0.4.7 manifest and all three languages' old bytes are retained for upgrade and interrupted restoration. Focus acceleration parameters, native libraries and service scripts are unchanged.

Validation: 173 offline tests passed; clean source: 146 passed, 27 skipped because excluded inputs are absent. Nine packaged camera layout/touch cases, three native Mac language previews, nine Windows layout previews, universal Mac dependencies, 38 Windows PE files, payload/recovery hashes and package notices passed checks. Native Windows rendering and physical camera/lens behavior remain pending. No camera was operated during development; removing the warning does not establish a hardware lens-change test.

---

下载 Windows 10/11 64 位 ZIP · 下载 macOS 13+ Apple 芯片 / Intel 通用 ZIP

下载后完整解压，或通过“设置 → 手动检查更新 → 下载并安装更新”升级。

删除电脑端换镜头警告，统一改为：对焦加速通过将镜头转速提高三倍实现，不建议老镜头用户开启。 中文名称改为“对焦加速 / 對焦加速”，英文名称不变。相机开关下方同步增加说明，使用原厂大小的灰色文字，简体、繁体和英文均自动换行。

电脑端更新后，点击“已连接 → 一键安装”更新相机文案。 识别到旧安装时，经确认先恢复再安装。保留 0.4.7 的精确清单及三种语言的旧文件，支持升级和中断恢复；对焦加速参数、功能二进制及服务脚本未改动。

验证：173 项完整离线测试通过；纯源码为 146 项通过、27 项因缺少外部输入跳过。九份相机布局/触控检查、三种语言的 Mac 原生预览、九份 Windows 布局预览、Mac 通用依赖、38 份 Windows PE 文件、载荷与恢复哈希及包内许可校验通过。Windows 原生显示及相机/镜头行为仍待验证；开发时未操作相机，删除警告不代表实机换镜头已通过测试。

v0.4.7 — Traditional Chinese / 繁體中文

Download / 下载安装包

• Windows 10/11 (64-bit) / 下载 Windows 版
• macOS 13+ (Apple silicon and Intel) / 下载 Mac 版

Extract the complete ZIP before opening the app. 下载后请完整解压，再启动软件。 SHA-256 checksums / 校验文件

---

Traditional Chinese support / 繁體中文支援

The toolkit now offers Simplified Chinese, Traditional Chinese and English in Settings on macOS and Windows. Buttons, instructions, status messages, logs and the remembered language choice follow the selected language. Install writes matching camera menu text, including feature labels and camera-side messages. When replacing an installed language, the app asks for restore-and-reinstall confirmation in the target language.

• Update the desktop app through Settings → Check for Updates → Download and Install Update, or download and extract the complete ZIP below.
• To change an existing camera menu to Traditional Chinese, select 繁體中文 in Settings, click Connected, then Install. Keep the camera connected through restoration, installation and reboot verification.
• Existing Simplified Chinese and English camera installs remain recognizable for restoration and upgrade. The camera's functional binaries are unchanged from 0.4.6; users keeping their current camera language do not need to reinstall.

Validation: 171 offline tests passed with local payload inputs; clean source passed 146 with 25 payload-dependent skips. Both packages were extracted through the application's update validator, and the catalog, camera file hashes, Mac dependencies and 38 Windows PE files were checked. Native Windows Traditional Chinese layout and installation on a physical camera remain unverified. No camera or driver was accessed during development.

Changelog · Validation

---

工具包的 Mac 与 Windows 设置页新增简体中文、繁體中文和 English 三种语言。界面按钮、操作说明、状态、日志及保存的语言选择会随之切换。一键安装会写入对应语言的相机菜单文字，包括功能名称与相机内提示。替换已安装语言时，软件会用目标语言提示恢复和重新安装。

• 可在“设置 → 手动检查更新 → 下载并安装更新”中升级桌面软件，也可下载并完整解压下方 ZIP。
• 要将已有相机菜单改成繁体，请先在设置中选择“繁體中文”，点击“已连接 → 一键安装”，并保持相机连接直到恢复、安装和重启校验全部完成。
• 已安装的简体中文和英文版本仍可识别、恢复和升级。相机功能二进制文件与 0.4.6 相同；若保留原有相机语言，无需重新安装。

验证：带本地载荷的 171 项离线测试通过；纯源码通过 146 项，25 项因缺少未公开载荷跳过。两个安装包通过软件自身的解包及版本校验，翻译表、相机文件哈希、Mac 依赖和 38 份 Windows PE 文件均已检查。Windows 原生繁体布局与相机实装仍待验证；开发期间没有访问相机或电脑驱动。

0.4.6 — Windows ADB startup fix

Windows ADB startup fix / Windows ADB 启动修复

0.4.5 could report “The private local ADB port is unavailable” before installation or restoration could start. Its private ADB listener used a numeric host form that ADB does not support. 0.4.6 uses the supported localhost listener and retains private-process cleanup.

• Separate unsupported connection parameters, access denial and port conflicts in the bilingual diagnostics.
• Update through Settings → Check for Updates → Download and Install Update, or download and extract the complete ZIP below. Then retry Connected → Install or Restore original as appropriate.
• Camera payloads are unchanged from 0.4.3/0.4.4/0.4.5. A successfully installed camera extension does not need reinstallation for this desktop fix. The Mac package advances to the same version; Mac operation is unchanged.

Validation: 169 offline tests passed; clean source: 143 passed, 26 skipped. Mac universal dependencies, 38 Windows PE files, archive extraction/application identity and unchanged camera payloads were verified. Native Windows ADB startup and camera install/restore still require user/device confirmation. No camera or driver was accessed during development. Older release archives are unchanged.

Changelog · Validation

---

0.4.5 在准备安装或恢复时，可能提示“ADB 独立本机端口无法使用”。原因是独立 ADB 监听地址使用了不受支持的数字主机写法。0.4.6 已改用受支持的 localhost 监听，保留独立进程及结束后自动清理。

• 中英文错误提示区分通信参数不兼容、访问被拒绝和端口冲突。
• 在设置 → 检查更新 → 下载并安装更新中升级，或完整下载并解压下方安装包。升级后重新点击已连接，再按需点击一键安装或一键恢复原状。
• 相机载荷与 0.4.3/0.4.4/0.4.5 相同。已成功安装扩展的相机无需为这次修复重装；Mac 同步版本号，操作行为保持不变。

验证：完整离线测试 169 项通过；纯源码 143 项通过、26 项跳过。Mac 通用依赖、38 份 Windows PE 文件、安装包解压与应用身份，以及相机载荷未改变均已检查。Windows 原生 ADB 启动和相机安装/恢复仍待用户或实机确认；开发期间没有访问相机或驱动，历史发布包保持不变。

欢迎交流 / Discussion and contributions

欢迎交流、分享研究发现和使用反馈。欢迎通过 Issues 讨论问题与建议，也欢迎提交 Pull Requests 改进代码、文档和测试。

Discussion, research findings and feedback are welcome. Please use Issues for questions and suggestions, and submit Pull Requests to improve code, documentation and tests.