iStoreOS 插件安装助手 V1.1.1

iStoreOS 插件安装助手 V1.1.1

发布日期：2026-11-07（Asia/Taipei）。V1.1.1 是兼容性修复版本。

主要修复

• 修复部分精简 OpenWrt / ImmortalWrt 固件没有 SFTP subsystem 时，本地插件无法上传的问题。SFTP 不可用时自动安全使用 SCP，不需要用户额外安装 openssh-sftp-server 或修改 SSH 配置。
• 仅在明确确认 SFTP subsystem / channel 不可用时切换；认证失败、Host Key 异常、网络断开、连接超时不会触发 SCP fallback。.run / .ipk / .apk 共用上传链，继续检查远端文件存在、大小和 SHA256。
• 无 SFTP 环境下，安装日志与退出状态通过已有受信任 SSH 增量读取 stdout / stderr / exit.code，保持完整安装验证、包快照、独立结果验证和清理。未知状态不会被当作成功。
• 修复部分 Windows / .NET Framework 环境连接 SSH 时出现 MAC error 的问题。基于 SSH.NET 2026.0.0，仅合入官方已合并的 Issue #1829 / PR #1830 修复；patched DLL 可重复构建。
• 增强 SSH 错误分类及 Server / KEX / HostKey / Cipher / MAC / Compression 协商日志，便于定位不同设备的连接兼容问题。未协商字段不会被猜测，不记录密码、私钥或会话密钥。
• 未为了兼容性加入 ssh-dss、MD5 MAC、截短 MAC 等弱算法；不改变现有 SSH 算法优先级，保持既有 Host Key 信任规则。

patched SSH.NET DLL SHA256：

31c62881cf8375b47118ab11a620c85d8208ae86b93f418f58ff2c79605ad481

保留的功能

• 本地 .run、.ipk、.apk 单文件选择与拖入；识别 OPKG / APK，检查包信息与设备兼容性。
• 软件源检测、安装前后包快照、安装结果验证、日志保存及断线后的原任务监测。
• 原始 menu.sh 插件维护终端、键盘输入、复制粘贴、UTF-8 和 PTY 尺寸同步。
• 设备 GitHub Raw 直连优先；电脑代理通过独立 SSH #2 临时隧道运行，结束后清理，保留首页 SSH #1。

验证范围与使用

RC1 已完成真实用户测试，用户确认此前主要问题基本解决。本地 .run / IPK、插件维护终端及电脑代理沿用已完成的 N1 实机验收记录；本地 APK 已完成离线测试和真实样本解析，尚未实机安装验收。没有将用户总体反馈扩大为所有设备、固件和故障场景均已验证。

无 SFTP fallback 适用于本地安装链；插件维护菜单准备仍使用现有 SFTP 上传。仅允许当前库不支持的算法的定制 SSH 服务器仍可能无法连接。Windows 7 SP1 x64 是兼容目标，尚未完成专项实机验收。

内部版本 1.1.1，程序集 / 文件版本 1.1.1.0。下载 ZIP 和 SHA256SUMS.txt 后校验，完整解压到新目录运行 iStoreOS.PluginHelper.exe，保留全部 14 个运行时 DLL 与许可证，避免混用旧依赖。推荐 Windows 10 / 11 x64 + .NET Framework 4.8。

正式版本完整离线回归：1431 passed / 0 failed；Release x64：0 warnings / 0 errors。测试保留 .run / IPK / APK、SFTP、SCP fallback、SSH monitor、Host Key、PTY 菜单与电脑代理等覆盖。

正式文件：iStoreOS.PluginHelper-v1.1.1-win-x64.zip、SHA256SUMS.txt。

源码中的构建、完整回归、ZIP 内容与解压启动检查记录见 V1.1.1 最终验证报告。第三方固定来源和可复现构建文件随源码提供，ZIP 内保留许可证及来源说明。

iStoreOS 插件安装助手 V1.1.0

iStoreOS 插件安装助手 V1.1.0

发布日期：2026-10-29（Asia/Taipei）。V1.1.0 已正式发布。

主要变化

• 首页支持选择或拖入 .run、.ipk、.apk 本地安装包。
• 自动识别 OPKG / APK；IPK 只允许 OPKG，APK 只允许 apk-tools 设备。Android APK 不受支持。
• 原生包读取包内名称、完整版本、架构和安装大小，严格检查包管理器 / 架构；IPK all、APK noarch 分别按无关架构处理。
• 复用软件源检测、真实 package update、空间检查、SFTP、两端 SHA256、安装前后包快照和独立结果验证；原生包必须通过远端 SHA256，并精确核对目标完整版本。
• .run 保持 SDK / 架构规则、Makeself 校验及作者原始安装器执行链。
• 安装日志的共用描述统一为“安装包 / 安装器”；格式专属校验和真实执行命令仍准确显示。
• “插件维护”打开原项目菜单终端，支持输入、复制粘贴、滚动、UTF-8、窗口尺寸与 PTY 同步，以及退出状态和最终输出排空。
• 连接后后台优先检测设备 GitHub Raw 直连；直连失败时检查 Windows localhost HTTP 代理。点击维护入口时再次复核，API 仅作诊断。
• 电脑代理使用专用 SSH #2 承载 N1 回环端口 17890 转发；代理环境仅供本次 menu.sh 及子进程使用。关闭时释放 SSH #2 并检查端口，保留首页 SSH #1；直连不创建隧道。
• 首页 SSH 按钮支持“连接 / 断开”，安装或维护期间禁止断开，断开清除当前设备与维护状态。
• 删除旧七插件按钮页面、专属版本扫描、单脚本执行与软件源子窗口，保留当前菜单复用能力。
• 成功安装后保留选中的可用官方源，失败继续原有恢复流程；未知安装状态不重复派发或提前清理。

验收范围

以下实机验收结论依据用户在 V1.1 发布收尾任务中的明确确认；本轮只做版本、文案、离线回归和打包，未重新执行设备安装。

能力	验收状态
本地 .run 安装	已完成 N1 实机验收
本地 .ipk 安装	已完成 N1 实机验收
本地 .apk 安装	已完成离线测试和真实样本解析，尚未实机安装验收
插件维护终端	已完成 N1 实机验收
电脑代理模式	已完成 N1 实机验收

包管理器是 APK 的设备执行 .run 的历史成功记录，不等同于本地 .apk 安装验收。APK 当前结论仅包括离线测试及真实 apk-tools 样本元数据解析，不承诺所有 APK、固件或依赖组合均可安装。N1 验收结论不扩展到所有硬件和 Windows 版本；未提供的包名、耗时和操作明细不作推断。

最终离线验证

• Release x64：0 warning / 0 error。
• 完整回归：1184 passed / 0 failed，覆盖安装、IPK/APK、软件源、SSH、电脑代理、终端菜单和清理边界。
• 内部版本、窗口和日志版本：1.1.0 / V1.1.0；AssemblyVersion、FileVersion 与应用 manifest：1.1.0.0。
• 本轮未改变安装、菜单或代理业务逻辑；发布文案与版本测试同步更新。

发布文件

• iStoreOS.PluginHelper-v1.1.0-win-x64.zip
• SHA256SUMS.txt

本地输出目录：artifacts/release/v1.1.0/。SHA256SUMS 记录 ZIP 的最终 SHA256。ZIP 包含 EXE、config、14 个运行时 DLL、README、本文、项目许可证及第三方许可文本，不包含测试、POC、调试符号、用户凭据或已下载的插件 / 上游脚本。

解压到独立目录后运行 EXE，保留 DLL、config 和许可证文件。运行环境为 Windows x64 + .NET Framework 4.8；推荐 Windows 10 / 11。Windows 7 SP1 x64 为兼容目标，尚未完成专项实机验收。程序尚未代码签名，可能出现 SmartScreen 提示。

保留的边界

• 原生包的依赖、ABI、签名和实际可用空间由设备包管理器进一步校验；不自动添加 --force-* 或 --allow-untrusted。
• 菜单从 upstream main 下载原始 menu.sh / LICENSE；main 可变化，SHA256 确认本次字节传输一致，不代表固定上游版本或来源可信。
• 未知状态保留远端任务；关闭终端或隧道不证明所有远端派生操作已停止。首页 SSH 已断时，端口释放可能只能记录为未知。
• 不自动启用插件，不修改永久代理 / 软件源以实现电脑代理；首次安装需要时的官方源切换沿用既有策略。

项目自有源码采用 MIT License；第三方组件按各自许可证分发，见随包 THIRD-PARTY-NOTICES.md 与 licenses/。详细离线日志、包检查和哈希见本地 artifacts/v1.1.0-final-20261029/；源码工作区的最终检查报告为 docs/V1.1.0-release-final-验证报告.md。

iStoreOS 插件安装助手 V1.0.2

iStoreOS 插件安装助手 V1.0.2

V1.0.2 主要完善 ARM64 / OPKG 环境下的真实安装兼容性，并优化坏软件源场景下的安装体验，同时保持原有 x86_64 / APK 安装链。

主要变化

• 修复精简 OpenWrt / BusyBox 环境因缺少 stat、nohup 等工具导致安装前失败的问题。
• 安装器日志与结束状态通过受信任 SFTP 直接读取，不再依赖 Runner / Poll 中的 base64 / dd。
• 安装期间复用单条 SFTP 监测连接，断线时可重新连接同一 session，不重复执行 .run。
• 软件源使用 QuickStart 动态候选，不维护自定义镜像数据库。
• 当前源异常时使用 Canary、延迟筛选和 FULL 验证选择可靠镜像；健康当前源保持不变。
• 保留真实 apk update / opkg update 作为安装前最终 Gate。
• 临时换源安装完成后恢复安装前原始官方 distfeeds。
• Package Snapshot 保留完整数据用于验证，日志只输出数量、真实变化项及阶段 Timing Summary。
• 保留 SHA256、Makeself、Package Diff、独立主 package 验证及临时目录安全策略。

实机验证

ARM64 / OPKG：N1，iStoreOS 24.10.8，SDK 24.10，aarch64_cortex-a53。

• PassWall 26.10.16：SuccessVerified，Timing Total 64418 ms。
• OpenClash 0.47.156：SuccessVerified，Timing Total 52139 ms。
• daede 1.15-r6：SuccessVerified，Timing Total 61968 ms。

以上安装的监测 SFTP connection count 均为 1。不可用的 Tencent Cloud 当前源被识别后，工具从动态候选选择 CERNET，通过真实 opkg update，安装后成功恢复原始 Tencent Cloud distfeeds。

x86_64 / APK：iStoreOS 25.12.5，SDK 25.12，x86_64。

• daede 1.14.7-r23：SuccessVerified，Timing Total 22669 ms。
• 监测 SFTP connection count 为 1；当前 CERNET 健康，没有切源，source modification=False、source restore=False。

本次通过通用 OpenWrt / BusyBox / 架构语义适配改善 ARM64 / OPKG 环境兼容性，并在 N1 aarch64_cortex-a53 上完成真实安装验证；不保证所有 ARM 设备或固件兼容。

验证

• 611 tests passed / 0 failed。
• 离线 Runner Smoke 12 / 12。
• Release x64：0 warning / 0 error。
• 正式化阶段仅调整版本显示、发布文档和打包元数据，安装行为与已实机验收的测试基线一致，没有再次执行真实 .run。

性能数据仅代表本次测试环境，不作为其他设备或网络环境的性能保证。

下载

• iStoreOS.PluginHelper-v1.0.2-win-x64.zip
• SHA256SUMS.txt

解压后运行 EXE，并保留 DLL、config 和许可证文件。运行环境为 Windows x64 + .NET Framework 4.8；Windows 7 SP1 x64 为兼容目标，尚未完成专项实机验收。

iStoreOS 插件安装助手 V1.0.1

iStoreOS 插件安装助手 V1.0.1

V1.0.1 修复 ARM64 架构兼容性误判：插件文件名使用 aarch64 / aarch64_a53，设备返回 aarch64_cortex-a53 时，现在能正确判断兼容。这是兼容性修复，不增加安装功能，也不针对设备型号或路由器 IP 建立特例。

• 支持 aarch64_a53 ↔ aarch64_cortex-a53、aarch64_a72 ↔ aarch64_cortex-a72 别名语义匹配，保留原始架构用于显示和日志。
• bare aarch64 可识别明确属于 ARM64 的设备家族。
• A53 / A72 继续严格区分，A72 插件不会放行到 A53。
• aarch64_generic 插件保持安全规则，只匹配 generic 设备。
• SDK 继续严格匹配，安装核心未修改。

按“插件 → 设备”判断：

插件标记	允许的设备架构
x86_64	x86_64
aarch64	aarch64，或以 aarch64_ 开头且后缀非空的设备架构
aarch64_a53 / aarch64_cortex-a53	Cortex-A53；另保留作者已知 A53 → aarch64_generic 规则
aarch64_a72 / aarch64_cortex-a72	Cortex-A72
aarch64_generic	aarch64_generic

A53 → generic 特例只属于 Are-u-ok ARM64 compatibility rule，不代表所有 OpenWrt 软件包具有同样 ABI 兼容性。A72 不放行到 A53 / generic，generic 包不放行到 Cortex-A53 / A72。原始架构仍用于显示和日志，SDK 必须一致。

验证结果：386 passed / 0 failed，原有 264 项测试全部保留，新增 122 项。Release x64：0 warning / 0 error。

用户已在 N1（iStoreOS 24.10.8 / SDK 24.10 / aarch64_cortex-a53 / OPKG）实机确认：OpenClash、daede、PassWall、SSR-Plus 四个指定文件均为 Compatible；A72 文件名反例为 Incompatible。本次仅验收兼容性，未执行真实 .run。

安装核心、SSH、软件源和 UI 样式保持，没有解析或解包安装器内部 APK / IPK。

附件为 iStoreOS.PluginHelper-v1.0.1-win-x64.zip 与 SHA256SUMS.txt。正式 ZIP 直接复制已实机验收的同一个测试 ZIP，没有重新构建、测试或打包，复制前后 SHA256 相同：

bce9c60cfc3c2edb306af1edd944a6ad3ab4209ee0c372e03f59c4baf029f3e4

下载 ZIP 后解压运行 iStoreOS.PluginHelper.exe；UI 显示 V1.0.1。AssemblyVersion 为 1.0.0.0，FileVersion 为 1.0.1.0，InformationalVersion 为 1.0.1。运行环境仍为 Windows x64 / .NET Framework 4.8，Windows 7 SP1 x64 为兼容目标，尚未完成专项实机验收。

iStoreOS 插件安装助手 V1.0

iStoreOS 插件安装助手 V1.0

这是什么

Windows 下用于辅助安装本地 Are-u-ok .run 插件到 iStoreOS 的开源工具，项目自有源码采用 MIT License。

主要功能

• 自动识别设备 SDK、架构及 APK / OPKG，检查安装包兼容性。
• 检查网络、时间、空间和包管理器状态，探测 QuickStart 动态软件源并有限重试。
• SFTP 上传，SHA256 / Makeself 校验，执行作者安装包并独立验证结果。
• Package Diff、原官方源恢复、临时目录清理，以及独立高级信息 / 日志窗口。

使用方法

下载 iStoreOS.PluginHelper-v1.0.0-win-x64.zip，解压运行 iStoreOS.PluginHelper.exe。

连接路由器 → 选择 / 拖入匹配的 .run → 点击“安装插件” → 等待结果。

请从插件作者官方发布渠道获取安装包。安装框架通用，不局限于已实测插件。

已实测

• PassWall 26.9.16
• OpenWrt-momo 1.2.1

两者均通过同一套通用安装链路完成真实安装；正式打包阶段未重复安装。

系统要求

推荐 Windows 10 / Windows 11 x64，运行环境为 .NET Framework 4.8。Windows 7 SP1 x64 + .NET Framework 4.8 属兼容目标，尚未完成专项实机验收。

注意

• 插件安装脚本来自插件作者，工具不自动启用代理插件或修改代理配置。
• SSH 密码不保存到磁盘，关闭程序后释放会话引用。
• 软件未代码签名，Windows 可能显示 SmartScreen 提示。
• 保留解压目录中的 DLL、config 和许可文件。校验文件为 SHA256SUMS.txt。
• 如遇异常，打开“高级信息 → 完整日志”，保存日志用于排查。