dsh-app-updater 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.2.0] — 2026-10-31
+
+### 新增
+
+- **运行环境识别**（`lib/platform.js`）：识别 Windows / macOS / 其它系统、具体版本与名称
+  （`Windows 11（build 26300）`、`macOS 15（Sequoia）`）、CPU 架构（ARM64 / x64 / Intel / x86），
+  并记录 CPU 型号与线程数。Windows on ARM 上跑 x64 的 Node 时，靠 `PROCESSOR_ARCHITEW6432`
+  仍能还原出真实架构，而不是被骗成 x64。
+- **按架构挑选安装包**：Windows 侧把识别到的架构传给 winget 的 `--architecture`，让「官网全量包」
+  与当前系统/芯片匹配；清单里没有该架构的安装包时自动退回自动匹配，并在日志里说明。
+  macOS 侧由 Homebrew 按本机架构取对应 cask。新增开关「按本机架构安装包」（默认开启）。
+- **macOS 更新引擎（Homebrew cask）**：用 `brew list --cask --versions` 拿已装版本、
+  `brew outdated --json=v2 --cask --greedy` 拿可升级版本，`brew upgrade --cask <token>` 更新；
+  演练模式改用 `brew fetch --cask <token>`，只下载安装包不安装。没有 Homebrew 时明确报告
+  「不可用」，而不是假装能更新。
+- **界面**：状态行与设置面板新增「运行环境」（系统 · 架构 · 引擎）；引擎不可用时红字给出原因；
+  应用来源新增 `homebrew` 徽章。
+- `/health.json` 增加 `version` / `env` / `envSummary` / `engine` / `capabilities`；
+  `state.json` 同步带出这些字段。
+
+### 说明
+
+- macOS 路径无法在开发机（Windows）上真机验证，因此识别与 Homebrew 输出解析均以注入式单测覆盖
+  （`test/unit.mjs` 共 66 项），安装/更新命令按 Homebrew 官方 CLI 行为编写。
+- 扫描/更新接口按平台放行：Windows 与 macOS 通过，其它系统返回 400 并说明原因。
+
 ## [1.0.0] — 2026-10-31
 
 首个可用版本。

package/CONTRACT.md

@@ -10,7 +10,8 @@ dsh-app-updater/
 ├─ cordis.patch.yml      # insert 行：id=dsh-app-updater, name=dsh-app-updater
 ├─ lib/
 │  ├─ index.js           # 宿主半身：cordis 插件，注册 /dsh-app-updater/* 路由
-│  ├─ engine.js          # 扫描 / 下载 / 安装编排
+│  ├─ platform.js        # 运行环境识别：Windows / macOS、版本、CPU 架构、引擎选择
+│  ├─ engine.js          # 扫描 / 下载 / 安装编排（Windows=winget / macOS=Homebrew）
 │  ├─ winget.js          # winget 定位、调用、表格解析
 │  ├─ registry.js        # 注册表 Uninstall 键枚举（覆盖 winget 未收录的应用）
 │  ├─ version.js         # 版本比较（Windows 风格 1.2.3.4 + 字母后缀）
@@ -19,6 +20,14 @@ dsh-app-updater/
 └─ README.md
 ```
 
+## 运行环境与引擎
+
+- `platform.js` 输出 `env`：`{ platform, family: windows|macos|other, osName, osVersion, osBuild, arch: arm64|x64|x86, archLabel, wingetArch, cpuModel, cpuCount }`。
+- 引擎：Windows → `winget`；macOS → `homebrew`；其它 → `none`（扫描/更新接口返回 400）。
+- 架构匹配：`settings.matchSystemArch !== false` 时，Windows 侧把 `env.wingetArch` 传给
+  `winget download/upgrade --architecture`；清单缺该架构时自动退回自动匹配并写日志。
+  macOS 侧由 Homebrew 决定 cask 架构。
+
 ## 宿主 HTTP 路由
 
 全部 `kind: "exact"`，前缀 `/dsh-app-updater/`。写操作要求 loopback + `confirm: true`。
@@ -29,13 +38,17 @@ dsh-app-updater/
 {
   "ok": true,
   "platform": "win32",
+  "env": { "platform": "win32", "family": "windows", "osName": "Windows 11", "osVersion": "10.0.26300", "osBuild": "26300", "arch": "x64", "archLabel": "x64（AMD64）", "wingetArch": "x64", "cpuModel": "13th Gen Intel(R) Core(TM) i7-13700K", "cpuCount": 24 },
+  "envSummary": "Windows 11（build 26300） · x64（AMD64）",
+  "engine": { "id": "winget", "available": true, "version": "1.29.380" },
+  "capabilities": { "scan": true, "update": true, "checkVersions": true, "storeAppsIncluded": true, "note": "" },
   "winget": { "available": true, "version": "v1.29.380", "path": "C:\\...\\winget.exe" },
   "phase": "idle",                 // idle | scanning | updating
   "scan": { "running": false, "startedAt": 0, "finishedAt": 0, "error": null },
   "update": { "running": false, "total": 0, "done": 0, "current": null, "error": null },
-  "apps": { "scannedAt": 0, "stats": { "total": 0, "upgradable": 0, "unsupported": 0 }, "items": [] },
+  "apps": { "scannedAt": 0, "stats": { "total": 0, "upgradable": 0, "unsupported": 0 }, "items": [], "engine": "winget" },
   "log": [ { "at": 0, "level": "info|warn|error|success", "text": "..." } ],
-  "settings": { "includeStoreApps": true, "includeRegistryOnly": true, "downloadDir": "", "keepInstallers": true, "hashFallbackUpgrade": true, "dryRun": false }
+  "settings": { "includeStoreApps": true, "includeRegistryOnly": true, "downloadDir": "", "keepInstallers": true, "hashFallbackUpgrade": true, "dryRun": false, "matchSystemArch": true }
 }
 ```
 
@@ -43,17 +56,17 @@ dsh-app-updater/
 
 ```jsonc
 {
-  "id": "Google.Chrome",            // winget id；纯注册表项为 "reg:<GUID 或 key 尾段>"
+  "id": "Google.Chrome",            // winget id；注册表项 "reg:<key>"；macOS "brew:<cask token>"
   "name": "Google Chrome",
   "version": "155.0.8059.85",       // 已安装版本，未知时 ""
   "available": "156.0.8078.48",     // 可升级到的版本，无更新时 ""
   "publisher": "Google LLC",
-  "source": "winget",               // winget | msstore | registry
+  "source": "winget",               // winget | msstore | registry | homebrew
   "installLocation": "C:\\Program Files\\Google\\Chrome\\Application",
   "hasUpdate": true,
   "updateSupported": true,          // 本插件能否驱动更新
   "reason": null,                   // null | "not-in-catalog" | "unknown-version" | "pinned" | "store-managed" | "system-component"
-  "kind": "exe"                     // exe | msi | msix | inno | null（未知）
+  "kind": "exe"                     // exe | msi | msix | inno | cask | null（未知）
 }
 ```
 

package/README.en.md

@@ -1,28 +1,34 @@
 # dsh-app-updater — App Updater for DeepSeek Harness
 
 **English** | [简体中文](README.md)
-![version](https://img.shields.io/badge/version-1.0.0-4b6fff?style=flat-square)
+[![npm](https://img.shields.io/npm/v/dsh-app-updater?style=flat-square&label=npm&color=0891b2&logo=npm)](https://www.npmjs.com/package/dsh-app-updater)
 ![license](https://img.shields.io/badge/license-MIT-2f6f4f?style=flat-square)
 ![platform](https://img.shields.io/badge/platform-Windows-7da1de?style=flat-square)
 ![dsh-plugin](https://img.shields.io/badge/DSH-plugin-263146?style=flat-square)
 
 
-Detect every installed Windows application that has a newer version, then update them
+Detect every installed application that has a newer version, then update them
 with one click — downloading the **full installer from each vendor's own website** and
 installing it silently. **The detected applications are never launched.**
+Windows (winget) and macOS (Homebrew), architecture-aware: ARM64 and x64/Intel installers are
+chosen to match the machine.
 
 Where to find it: DeepSeek Harness → Settings → **应用更新 (App Updater)**
 
 ## Install
 
 ```bash
-# straight from the source repository
-dsh plugin --profile web add github:19952730389/dsh-app-updater
+# npm package (recommended; also one-click installable from the plugin center)
+dsh plugin --profile web add dsh-app-updater
 ```
 
-Prebuilt `.tgz` (see [Releases](https://github.com/19952730389/dsh-app-updater/releases)):
+Without npm, install from source or from the prebuilt tarball:
 
 ```bash
+# source repository
+dsh plugin --profile web add github:19952730389/dsh-app-updater
+
+# prebuilt tgz (see Releases)
 dsh plugin --profile web add https://github.com/19952730389/dsh-app-updater/releases/latest/download/dsh-app-updater.tgz
 ```
 
@@ -88,6 +94,7 @@ State file: `%USERPROFILE%\.dsh\dsh-app-updater\state.json`
 | `keepInstallers` | `true` | Keep the installer after a successful update. |
 | `hashFallbackUpgrade` | `true` | Fall back to `winget upgrade` when the download fails. |
 | `dryRun` | `false` | **Rehearsal mode**: download the vendor's full installer but never install it. |
+| `matchSystemArch` | `true` | Match the installer to the detected system and CPU architecture (Windows passes `--architecture`; macOS is resolved by Homebrew). |
 
 Everything above is editable from the plugin's own settings panel inside the settings page.
 The panel also accepts API calls:
@@ -113,18 +120,41 @@ curl -X POST -H "Content-Type: application/json" \
 
 ## Requirements
 
-- **Windows** with `winget.exe` (Microsoft App Installer). Without winget the plugin can still
+- **Windows**: `winget.exe` (Microsoft App Installer). Without winget the plugin can still
   list registry apps, but cannot tell whether they are up to date.
+- **macOS**: `brew` ([Homebrew](https://brew.sh)). Without Homebrew the plugin reports the engine
+  as unavailable instead of pretending it can update anything.
 - No third-party npm dependencies: the host half uses Node built-ins only, the browser half
   only the host-provided `react`.
 
+## Supported systems and architectures
+
+The plugin detects its own environment at startup and picks the installer that matches it:
+
+| System | Architecture | Engine | Notes |
+|---|---|---|---|
+| Windows 10 / 11 | x64 / ARM64 / x86 | **winget** | the detected architecture is passed as `winget --architecture`; if the manifest has no installer for it, the plugin falls back to automatic matching and says so in the log |
+| macOS 11+ | Apple Silicon / Intel | **Homebrew casks** | Homebrew itself resolves the right cask for the machine; without Homebrew the engine is reported unavailable |
+| anything else | — | none | the scan/update routes answer 400 with the reason |
+
+The result is shown in the status line and in the settings panel's “运行环境 / Environment” row, e.g.
+`Windows 11（build 26300） · x64（AMD64） · winget 1.29.380` or
+`macOS 15（Sequoia） · Apple Silicon（ARM64） · Homebrew 4.5.0`.
+
+The “按本机架构安装包 / match system architecture” switch (on by default) can be turned off to hand
+the choice back to winget; Homebrew always resolves for the local architecture.
+
+> The macOS/Homebrew path follows Homebrew's documented CLI behaviour and its detection and parsing
+> logic are covered by unit tests, but it has not been verified on a real Mac — this plugin is
+> developed on Windows. Please open an issue if something misbehaves there.
+
 ## HTTP API (host half)
 
 | Method | Path | Purpose |
 |---|---|---|
 | GET | `/dsh-app-updater/state.json` | Status, inventory, log, settings |
 | GET | `/dsh-app-updater/apps.json` | Inventory and statistics only |
-| GET | `/dsh-app-updater/health.json` | Self-check (route count, data directory) |
+| GET | `/dsh-app-updater/health.json` | Self-check: version, environment, engine, capabilities, route count, data directory |
 | POST | `/dsh-app-updater/scan` | `{confirm:true, force:true}` start scanning |
 | POST | `/dsh-app-updater/update` | `{confirm:true, ids:[...]}` start the update queue |
 | POST | `/dsh-app-updater/cancel` | `{confirm:true}` cancel items not yet started |
@@ -153,7 +183,7 @@ Then add `dsh-app-updater` to `dsh.profile.bundles` in the profile's `package.js
 ## Tests
 
 ```bash
-node test/unit.mjs     # 36 checks: table parsing, version compare, manifest & switch parsing
+node test/unit.mjs     # 66 checks: table parsing, version compare, manifest & switches, OS/arch detection, Homebrew parsing
 node test/render.mjs   # 32 checks: settings panel, rehearsal banner, column drag, request bodies
 node test/harness.mjs --scan   # boots the host half against a fake cordis ctx + real HTTP
 ```

package/README.md

@@ -1,27 +1,32 @@
 # dsh-app-updater — 应用更新（DSH 插件）
 
-检测本机**所有已安装的 Windows 应用**是否有新版本，并从各自**官网下载完整安装包**一键静默更新。
+检测本机**所有已安装应用**是否有新版本，并从各自**官网下载完整安装包**一键静默更新。
 检测过程**不需要打开被检测的软件**。
+自动识别 **Windows / macOS** 与 **ARM64 / x64（Intel）** 架构，按当前系统与芯片挑选对应的安装包。
 
 入口：DeepSeek Harness → 设置 → **应用更新**
 
 ## 安装
 
 ```bash
-# 从源码仓库安装（复制即可）
-dsh plugin --profile web add github:19952730389/dsh-app-updater
+# npm 包（推荐，插件中心同样可一键安装）
+dsh plugin --profile web add dsh-app-updater
 ```
 
-发行 `.tgz` 见 [Releases](https://github.com/19952730389/dsh-app-updater/releases)：
+不想走 npm，也可以用源码或发行包：
 
 ```bash
+# 源码仓库
+dsh plugin --profile web add github:19952730389/dsh-app-updater
+
+# 预构建 tgz（见 Releases）
 dsh plugin --profile web add https://github.com/19952730389/dsh-app-updater/releases/latest/download/dsh-app-updater.tgz
 ```
 
 装好后重启 DSH，在 **设置 → 应用更新** 使用。桌面端（Electron 托管的 `desktop` profile）不允许
 `dsh plugin` 直接改写，需在 profile 的 `node_modules` 下建 junction 并手动补 `bundles`。
 
-![version](https://img.shields.io/badge/version-1.0.0-4b6fff?style=flat-square)
+[![npm](https://img.shields.io/npm/v/dsh-app-updater?style=flat-square&label=npm&color=0891b2&logo=npm)](https://www.npmjs.com/package/dsh-app-updater)
 ![license](https://img.shields.io/badge/license-MIT-2f6f4f?style=flat-square)
 ![platform](https://img.shields.io/badge/platform-Windows-7da1de?style=flat-square)
 ![dsh-plugin](https://img.shields.io/badge/DSH-plugin-263146?style=flat-square)
@@ -91,6 +96,7 @@ dsh plugin --profile web add https://github.com/19952730389/dsh-app-updater/rele
 | `keepInstallers` | `true` | 更新后保留安装包；`false` 则在安装完成后删掉该应用刚下载的包。 |
 | `hashFallbackUpgrade` | `true` | 下载失败时退回 `winget upgrade` 兜底。 |
 | `dryRun` | `false` | **演练模式**：只下载官网全量安装包、不执行安装。用来先看会装什么。 |
+| `matchSystemArch` | `true` | 按识别到的系统与芯片架构挑选安装包（Windows 传 `--architecture`；macOS 由 Homebrew 决定）。 |
 
 用 API 改设置（等价于设置面板，适合脚本化）：
 
@@ -118,7 +124,8 @@ curl -X POST -H "Content-Type: application/json" \
 
 ## 依赖
 
-- **Windows**（`winget.exe`，即 Microsoft「应用安装程序 / App Installer」）。没装 winget 时插件仍能列出注册表里的应用，但无法判断是否有新版本。
+- **Windows**：`winget.exe`（Microsoft「应用安装程序 / App Installer」）。没装 winget 时插件仍能列出注册表里的应用，但无法判断是否有新版本。
+- **macOS**：`brew`（[Homebrew](https://brew.sh)）。没装 Homebrew 时明确报告引擎不可用，不会假装能更新。
 - 不需要任何第三方 npm 依赖；宿主半身只用 Node 内置模块，浏览器半身只用宿主提供的 `react`。
 
 ## 接口（宿主半身）
@@ -127,7 +134,7 @@ curl -X POST -H "Content-Type: application/json" \
 |---|---|---|
 | GET | `/dsh-app-updater/state.json` | 当前状态、应用清单、日志、设置 |
 | GET | `/dsh-app-updater/apps.json` | 只取应用清单与统计 |
-| GET | `/dsh-app-updater/health.json` | 自检（路由数、数据目录） |
+| GET | `/dsh-app-updater/health.json` | 自检：版本、运行环境、引擎与能力、路由数、数据目录 |
 | POST | `/dsh-app-updater/scan` | `{confirm:true, force:true}` 开始扫描 |
 | POST | `/dsh-app-updater/update` | `{confirm:true, ids:[...]}` 开始更新队列 |
 | POST | `/dsh-app-updater/cancel` | `{confirm:true}` 取消未开始项 |
@@ -153,11 +160,30 @@ dsh plugin --profile <profile> add link:/path/to/dsh-app-updater
 ## 测试
 
 ```bash
-node test/unit.mjs              # 36 项：定宽表格解析、版本比较、安装包清单与静默参数
+node test/unit.mjs              # 66 项：定宽表格解析、版本比较、清单与静默参数、系统/架构识别、Homebrew 解析
 node test/render.mjs            # 32 项：设置面板、演练提示、列宽拖拽、请求体
 node test/harness.mjs --scan    # 用假 cordis ctx + 真 HTTP 把宿主半身跑起来
 ```
 
+## 支持的系统与架构
+
+插件启动时会识别本机环境，并据此挑选对应架构的安装包：
+
+| 系统 | 架构 | 更新引擎 | 说明 |
+|---|---|---|---|
+| Windows 10 / 11 | x64 / ARM64 / x86 | **winget** | 把识别到的架构传给 `winget --architecture`；清单没有该架构的包时自动退回自动匹配并记录日志 |
+| macOS 11+ | Apple Silicon / Intel | **Homebrew cask** | Homebrew 自己按本机架构取 cask；没有 Homebrew 时明确报告引擎不可用 |
+| 其它 | — | 无 | 扫描/更新接口返回 400 并说明原因 |
+
+识别结果会显示在状态行与设置面板的「运行环境」里，例如
+`Windows 11（build 26300） · x64（AMD64） · winget 1.29.380` 或
+`macOS 15（Sequoia） · Apple Silicon（ARM64） · Homebrew 4.5.0`。
+
+还可以在设置面板里关掉「按本机架构安装包」——关闭后把选择权交回 winget 自己（Homebrew 一直按本机架构）。
+
+> macOS 的 Homebrew 路径是按 Homebrew 官方 CLI 行为实现的，识别与解析逻辑有单测覆盖；
+> 但本插件主要在 Windows 上开发，macOS 上的安装/更新没有真机验证过，遇到问题请开 Issue。
+
 ## 卸载
 
 1. 从 profile 的 `package.json` 里删掉 `dsh.profile.bundles` 中的 `dsh-app-updater` 与 `dependencies` 中的对应条目。

package/RELEASING.md

@@ -0,0 +1,63 @@
+# 发版流程
+
+这个仓库同时是 **GitHub 插件源码** 和 **npm 包 `dsh-app-updater`**，两者版本必须一致。
+
+## 1. 改版本号与更新日志
+
+```bash
+# package.json 的 version 改成新版本，例如 1.0.1
+# CHANGELOG.md 顶部加一节（遵循 keep-a-changelog 的写法）
+```
+
+## 2. 本地自测
+
+```bash
+npm test                       # unit 36 项 + render 32 项
+node test/harness.mjs --scan   # 宿主半身跑真实 HTTP（需要 Windows + winget）
+```
+
+## 3. 发布到 npm
+
+npm 目前要求发布必须通过 2FA，或使用**开启 Bypass 2FA 的 Granular Access Token**：
+
+```bash
+# 方式 A：账号已开 2FA
+npm publish --access public --otp=<6 位动态码>
+
+# 方式 B：用带 Bypass 2FA 的 token（写入临时 userconfig，别写进仓库）
+npm publish --access public --userconfig=<某个仓库外的 .npmrc>
+```
+
+> 注意：带 Bypass 2FA 的令牌可以做发布，但**不能**做 `npm unpublish` / 账号类操作，
+> 那些仍然需要在网页上以 2FA 完成。
+
+## 4. 打 GitHub Release（附预构建包）
+
+```bash
+npm pack --silent                       # 产出 dsh-app-updater-<version>.tgz
+mv dsh-app-updater-*.tgz dsh-app-updater.tgz   # 资产名不要带版本号
+gh release create v<version> dsh-app-updater.tgz \
+  --title "v<version>" --notes-file <(sed -n '/^## \[<version>\]/,/^## \[/p' CHANGELOG.md)
+```
+
+资产名必须**不带版本号**：README 与各插件市场用的是
+`releases/latest/download/dsh-app-updater.tgz`，`latest/download/` 只解析 `latest`，
+文件名是按字面取的——一旦资产名带版本号，下一次发版这个链接就会 404。
+如果确实想让文件名带版本号，就把链接改成钉住 tag 的形式（`releases/download/v1.0.0/…`）。
+
+## 5. 市场收录怎么更新
+
+- **dsh-plugin.org / dshopen.org / awesome-dsh-plugin**：仓库更新后它们按各自刷新周期同步，
+  一般不需要重新提交；条目信息（版本、Star、更新时间）会自动跟上。
+- **dsh.works / DSH.SO / DSH STORE**：全部自动抓取，无需任何操作。
+- **DSH Plugin Index（realoiyo.github.io）**：只抓 npm 包，`npm publish` 后下次重建即更新。
+- 提交入口（首次收录用）：
+  - dsh-plugin.org → https://github.com/dshplugin/dsh-plugin-hub/issues （模板见其 submit 页）
+  - dshopen.org → https://github.com/polang233/dsh-plugin-index/issues/new?template=plugin-add.yml
+  - awesome-dsh-plugin → 向仓库提 PR，新增 `data/plugins/<owner>__<repo>.yml`（见其 contributing.md）
+
+## 6. 本地开发时的桌面端安装
+
+Electron 托管的 `desktop` profile 不接受 `dsh plugin` 写入。做法是在
+`<profile>/node_modules` 下建立指向本仓库的目录 junction，并把包名加进 profile
+`package.json` 的 `dsh.profile.bundles` 与 `dependencies`，重启 DSH 生效。

package/lib/client.js

@@ -47,6 +47,11 @@ window.__ModuleLoader__.load({
         hint: "只从官网下载完整安装包，不执行安装",
         warn: true,
       },
+      {
+        key: "matchSystemArch",
+        label: "按本机架构安装包",
+        hint: "按当前系统与芯片（Windows ARM64 / x64、Apple Silicon / Intel）挑选对应安装包",
+      },
       {
         key: "hashFallbackUpgrade",
         label: "下载失败时回退 winget",
@@ -76,6 +81,14 @@ window.__ModuleLoader__.load({
       winget: "winget",
       msstore: "msstore",
       registry: "registry",
+      homebrew: "homebrew",
+    };
+
+    /** 引擎显示名 */
+    const ENGINE_TEXT = {
+      winget: "winget",
+      homebrew: "Homebrew",
+      none: "无可用更新引擎",
     };
 
     /* ------------------------------------------------------------------ *
@@ -151,6 +164,8 @@ window.__ModuleLoader__.load({
       ".appupd-badge-winget{border-color:rgba(79,140,255,.55);color:var(--dsw-alias-brand-primary,#4f8cff);}",
       ".appupd-badge-msstore{border-color:rgba(52,211,153,.55);color:#34d399;}",
       ".appupd-badge-registry{border-color:rgba(148,163,184,.5);}",
+      ".appupd-badge-homebrew{border-color:rgba(251,191,36,.55);color:#fbbf24;}",
+      ".appupd-envline{font-size:12px;color:var(--dsw-alias-label-primary,#f3f4f6);word-break:break-word;}",
       ".appupd-state-new{font-weight:600;color:var(--dsw-alias-brand-primary,#4f8cff);white-space:nowrap;}",
       ".appupd-state-ok{color:#34d399;white-space:nowrap;}",
       ".appupd-state-none{color:var(--dsw-alias-label-secondary,#9ca3af);white-space:nowrap;}",
@@ -267,6 +282,14 @@ window.__ModuleLoader__.load({
       return REASON_TEXT[r] || String(r);
     }
 
+    /** 引擎状态文案：winget 1.29.380 / Homebrew 4.5.0 / 无可用更新引擎 */
+    function engineTextOf(engine) {
+      if (!engine || !engine.id) return "引擎状态未知";
+      const name = ENGINE_TEXT[engine.id] || engine.id;
+      if (engine.available === false) return name + " 不可用";
+      return engine.version ? name + " " + engine.version : name + " 可用";
+    }
+
     /* ---------------- 本地偏好（列宽 / 面板展开） ---------------- */
 
     /** localStorage 包装：不可用（隐私模式、无 window）时静默降级为默认值。 */
@@ -596,6 +619,15 @@ window.__ModuleLoader__.load({
       const winget = (state && state.winget) || null;
       const platform = state && state.platform;
 
+      /* 运行环境（系统 / 架构）与更新引擎 */
+      const env = (state && state.env) || null;
+      const engine = (state && state.engine) || null;
+      const caps = (state && state.capabilities) || null;
+      const envSummary =
+        (state && state.envSummary) ||
+        (env ? [env.osName || env.platform, env.archLabel].filter(Boolean).join(" · ") : "环境未知");
+      const engineText = !state ? "" : engineTextOf(engine);
+
       const filtered = react.useMemo(() => {
         if (!items) return [];
         const q = query.trim().toLowerCase();
@@ -922,6 +954,30 @@ window.__ModuleLoader__.load({
           ? h(
               "div",
               { className: "appupd-panel-body" },
+              h(
+                "div",
+                { className: "appupd-field" },
+                h("div", { className: "appupd-field-label" }, "运行环境"),
+                h(
+                  "div",
+                  { className: "appupd-field-main" },
+                  h(
+                    "div",
+                    { className: "appupd-field-row" },
+                    h("span", { className: "appupd-envline" }, envSummary + (engineText ? " · " + engineText : ""))
+                  ),
+                  env && env.cpuModel
+                    ? h(
+                        "div",
+                        { className: "appupd-hint" },
+                        env.cpuModel + (env.cpuCount ? " · " + env.cpuCount + " 线程" : "")
+                      )
+                    : null
+                )
+              ),
+              caps && !caps.scan && caps.note
+                ? h("div", { className: "appupd-err", style: { fontSize: 12 } }, caps.note)
+                : null,
               h(
                 "div",
                 { className: "appupd-field" },
@@ -1039,16 +1095,18 @@ window.__ModuleLoader__.load({
           ? h("span", null, loadError ? h("span", { className: "appupd-err" }, "无法连接宿主：" + loadError) : "正在读取状态…")
           : h(
               "span",
-              null,
-              winget && winget.available === false
-                ? h("span", { className: "appupd-err" }, "未检测到 winget，无法检测更新")
-                : h(
-                    "span",
-                    { className: "appupd-status-strong" },
-                    winget && winget.version ? "winget " + winget.version : winget && winget.available ? "winget 可用" : "winget 状态未知"
-                  )
+              engine && engine.available === false ? { className: "appupd-err" } : null,
+              engineText
             ),
         state ? h("span", { className: "appupd-sep" }, "·") : null,
+        state
+          ? h(
+              "span",
+              { className: "appupd-status-strong", title: "操作系统与 CPU 架构" },
+              envSummary
+            )
+          : null,
+        state ? h("span", { className: "appupd-sep" }, "·") : null,
         state
           ? h("span", null, "上次扫描：" + fmtRel(apps && apps.scannedAt, now))
           : null,
@@ -1061,7 +1119,7 @@ window.__ModuleLoader__.load({
             )
           : null,
         scanning ? h("span", null, "扫描中…") : null,
-        platform && platform !== "win32" ? h("span", { className: "appupd-err" }, "仅支持 Windows") : null,
+        caps && caps.note ? h("span", { className: "appupd-err" }, caps.note) : null,
         loadError && state ? h("span", { className: "appupd-err" }, "（状态刷新失败：" + loadError + "）") : null
       );