@yufengtadian/freedom-cli 1.13.2 → 1.13.3

package/LICENSE

@@ -0,0 +1,40 @@
+Freedom —— 专有软件许可（Proprietary License）
+
+Copyright (c) 2026 YUfeng12TA（邮箱与 GitHub 账号见仓库 https://github.com/YUfeng12TA/freedom ）
+
+本仓库（下称「本软件」）为闭源专有软件：**不适用 MIT、Apache、GPL 等任何开源许可**。
+本文件同时随 npm 包 `@yufengtadian/freedom-cli` 分发（包目录内 `LICENSE` 与本文件同文）。
+
+## 1. 授权范围（你可以做什么）
+
+- 安装与使用本软件（CLI、Freedom Desktop、预编译壳）于任意数量的个人 / 团队 / 商用设备。
+- 用本软件打包、签名、分发、销售**你自己的应用**：你的前端代码、后端代码、`resources/`
+  内容与应用数据归你所有，无需就产物向许可方付费、开源或署名。
+- 出于自身部署、审计与安全研究目的**阅读**随包分发的源码（见第 4 条的边界）。
+
+## 2. 限制（未经许可方书面同意不得做什么）
+
+- 再分发本软件源码、预编译壳、npm 包内容物，或任何衍生 / 修改版本（第 4 条的第三方组件除外）。
+- 移除、遮盖或改动版权声明、许可文本与完整性校验信息。
+- 将本软件或其副本作为独立产品对外销售、托管、转许可或用于构建竞争性打包工具。
+- 绕过 FRDM2 加密容器与反调试机制，对他人分发的产物提取源码，或将该成果对外发布
+  （安全研究请走 `SECURITY.md` 的披露通道）。
+
+## 3. 第三方组件不受本文件改写
+
+- `third_party/webview_go/`（及其在 `freedom-cli/templates/go/` 下的镜像副本）为
+  [webview_go](https://github.com/webview/webview_go) 的上游补丁副本，沿用其 **MIT** 许可
+  （原文见该目录 `LICENSE`），改动记录见同目录 `FREEDOM-PATCH.md`。
+- Go、Node.js、WebView2 SDK、WebKitGTK/GTK、NSIS、rcedit 等各自按其许可证使用。
+- 本文件不对这些组件施加任何额外限制。
+
+## 4. 免责与无担保
+
+本软件按「现状」提供，不含任何明示或暗示的担保。FRDM2 容器、完整性清单与反调试检测的设计
+目标是**提高逆向成本**，不是可信执行环境，不构成「不可逆向」的承诺（详见 `SECURITY.md`）。
+在适用法律允许的最大范围内，许可方不对因使用或无法使用本软件造成的任何损害承担责任。
+
+## 5. 条款变更与联系
+
+许可条款可能在新版本中调整，以你所获得版本随附的本文件为准。商用授权、白标或源码买断等
+需求，请通过仓库 GitHub Issues 与许可方联系。

package/README.md

@@ -1,6 +1,6 @@
 # freedom-cli
 
-Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.13.2）。
+Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.13.3）。
 
 基于自研 Freedom WebView 壳层（对标 Wails / Tauri）：前端完全自由、后端可任意语言、渲染复用系统 WebView（Windows WebView2 / macOS WKWebView / Linux WebKitGTK），产物为单个可执行文件 + resources 目录，前端页面内存加载，不占本地端口。
 
@@ -12,6 +12,7 @@ Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌
 - **销毁竞态收口**：修复 webview2 在 `Destroy` 中泵出滞留 dispatch 回调导致的随机崩溃（0xc0000005，多窗口 / 快速关闭场景），回收后所有排队回调按拆除旗标自我作废，并配套红绿回归测试；
 - **v1.13.1**：文档同步（本 README 更新至 v1.13.x 真实现状、壳 CI 章节勘误），无功能与壳二进制变更。
 - **v1.13.2 反逆向加固（FRDM2）**：容器升 FRDM2（构建期随机盐 + PBKDF2 60 万次 + enc/mac 域分离 + MAC 覆盖容器头部），主密钥改为掩码表运行时组装（壳二进制 `strings` 直取不到），`backend/**` 后端源码一并入容器并在运行期解密到私有临时目录（退出即删、崩溃残留按 PID 回收），前端产物 `sourceMappingURL` 构建期抹除，anti-debug 扩到六道信号，本地与 CI 壳统一 `-trimpath -s -w`。**旧版本 CLI 产出的 FRDM1 资源包在新壳上明确拒绝运行（不静默降级），须重新 `freedom build`**；三平台壳随本版本经 CI 重编发布。
+- **v1.13.3 内置工具链扩展 + 加固与健壮性收口**：新增 `freedom toolchain status|install|optimize|clear`，探测 / 安装 / 优化 C++（MSVC / MinGW / clang）、Rust、Go 三条工具链并按平台映射到 winget / brew / apt；探测结论缓存（绑 PATH 指纹 + 7 天 TTL）**只缓存成功**，即「检测到配置好就不再实探」，刚装好的工具当场可识别，`install` 默认只打印命令、`--apply` 才执行。同轮收口：Windows 第七道反调试信号（`DR0–DR3` 硬件断点）、SIGTERM / `CTRL_CLOSE_EVENT` 退出清扫通道（临时目录不再等下次启动回收）、`.integrity` 缺失即拒绝启动、Linux WebKitGTK 4.1 构建路径自动注入 `-tags=webkit2_41`、`shell build` / `shell download` 成功却非零退出的退出码修正、产物自检不再把 `.integrity` 大小说成 0 B。许可改为闭源专有许可（详见根 `LICENSE`）。
 
 **v1.12.17 安全模式全面落地**：三档安全模式 `freedom security <none|basic|high>` 正式随包分发——high 档把 resources 加密为 `app.bin`（AES-256-CTR + HMAC-SHA256 + PBKDF2 密钥派生），配合 `.integrity` 完整性校验、anti-debug 与进程隐藏，磁盘无明文、篡改即拒运行；三平台预编译壳经 CI 重建分发，补齐 v1.12.16 仅重编 win-x64 壳的缺口。
 
@@ -138,6 +139,13 @@ mac 用户解压 `.app.zip` 即得 `.app`，拖入 `/Applications` 即可直接
 
 **预编译壳的来源与 CI**：`webview_go` 依赖各系统自带 WebView 框架，**无法交叉编译**，三平台壳必须在对应平台本机编译。自 v1.13.0 起由仓库 `.github/workflows/build.yml` 统一承担：推送 `vX.Y.Z` tag → 三平台 runner 编译通用壳 → `release` job 自动创建 GitHub Release 并上传资产 `freedom-shell-<plat>`，供 `freedom shell download` 按「`v<包版本>` tag + 同名资产」拉取（Intel Mac 已不支持，见 `nativePlatform()` 的明确报错）。发版顺序：先推 GitHub tag、等 Release 资产就绪，再 `npm publish` 同版本——保证 shell 下载默认源始终可用（紧急时可设 `FREEDOM_SHELL_TAG` 指向既有 tag）。
 
+**平台名写法与下载回退**：`--platform` 与 `freedom shell download/build` 接受别名与架构后缀——
+`win` / `windows` / `mac` / `macos` / `osx` / `ubuntu` / `linux-x86_64` / `mac-arm64` 等统一归一到
+`win-x64` / `darwin-arm64` / `linux-x64`；无法支持的组合（`win-x86`、`darwin-x64`、`plan9`）直接报「未知平台」并给出可选值，不做猜测。
+下载有两条路径：先试直连 `releases/download`，不通（超时 / 代理 / 网络策略）时自动回退 GitHub Release API 资产端点；
+两条都不通则错误信息分别给出两端点与手工放置目录（`FREEDOM_SHELL_DIR` 可覆写壳目录，私有镜像另见 `FREEDOM_SHELL_REPO` / `FREEDOM_SHELL_BASE` / `FREEDOM_GITHUB_API`），
+GitHub 限流时可带 `FREEDOM_GITHUB_TOKEN`。
+
 产物目录可在 `freedom.config.js` 的 `outDir` 中调整：默认 `'dist'`，设为 `'.'` 则直接输出到项目根目录（dist 的上级），设为任意相对 / 绝对路径亦可。输出到项目根目录时会自动跳过 `index.html` 副本，避免覆盖项目源文件。
 
 ```bash
@@ -213,7 +221,10 @@ freedom build                        # 读取配置中的 security 值
 - 另内置 **anti-debug**：`IsDebuggerPresent`、`CheckRemoteDebuggerPresent`、直读 `PEB.BeingDebugged`、`NtQueryInformationProcess` 的 `ProcessDebugPort` / `ProcessDebugObjectHandle` / `ProcessDebugFlags` 共六道独立信号，任一确证即静默退出（退出码 77），在资源解密前后各检测一次；所有探测遵循"取不到即视为未命中"，杜绝误杀；
 - 进程隐藏加固（`-H windowsgui`，无控制台窗口）。
 
-**加固上限说明**：`high` 大幅提高破解门槛，但**任何客户端可执行程序都无法做到绝对不可破解**——密钥最终存在于壳二进制与运行时内存中，反调试只抬升动态分析成本、不是不可绕过的墙。真正敏感的密钥与业务逻辑仍应留在服务端。
+**加固上限说明**：`high` 大幅提高破解门槛，但**任何客户端可执行程序都无法做到绝对不可破解**——密钥最终存在于壳二进制与运行时内存中，反调试只抬升动态分析成本、不是不可绕过的墙。真正敏感的密钥与业务逻辑仍应留在服务端。**误报可关**：反调试在 CI、自动化测试、远程桌面、部分虚拟化环境可能把正常运行判成被附加调试器
+（命中即静默退出，码 77）。这类场景设 `FREEDOM_DISABLE_ANTIDEBUG=1`，或在壳层源码里 `Config{DisableAntiDebug: true}`
+后 `freedom shell build`——只关探测，容器解密与 `.integrity` 完整性校验照旧生效（那两道才是源码保护的本体）。
+`resources/config.json` 里刻意不提供此开关：打包产物里的配置运行期可被第三方替换，给开关等于递刀。
 
 **互斥规则**：切换安全模式重新构建时，CLI 会自动清理另一模式的遗留产物（`app.bin`/`.integrity` 与明文 `index.html`/`config.json`/`backend/` 只能存其一），避免壳误加载旧资源。
 
@@ -231,7 +242,10 @@ window.freedom.window.minimize();                       // 窗口控制
 
 - Node.js >= 18
 - 不需要 Go 工具链（壳层为随包分发的预编译二进制）
-- 可选：`freedom shell build` 需本机 Go（含 CGO，Windows 需 MSVC 编译环境），仅用于亲自编译壳
+- 可选：`freedom shell build` 需本机 Go（含 CGO，Windows 需 MSVC 编译环境），仅用于亲自编译壳。
+  Linux 侧需 WebKitGTK + GTK3 开发库，`4.0` 与 `4.1` 二选一（Ubuntu 24.04+/Debian 13+ 只有 4.1：
+  `sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev`）；
+  仅有 4.1 时 `freedom shell build` 会自动为编译加 `-tags webkit2_41`，无需手工干预（探测见 `lib/webkit.js`）。
 - `.dmg` 打包需在 macOS 上执行（依赖系统 hdiutil）；`.app.zip` 在任意平台均可直接产出
 
 ## 命令
@@ -248,13 +262,17 @@ freedom security <none|basic|high>     # 设置安全模式（写入配置）
 freedom icon <path>                    # 设置应用图标（Windows 用 .ico，macOS 用 .icns）
 freedom config [get|set]
 freedom shell list|download <platform>|build <platform>
+freedom toolchain status [--refresh] [--home <dir>]        # 探测 Go / Rust / C++ 工具链（成功结论才缓存，绑 PATH 指纹）
+freedom toolchain install [go,rust,cpp|missing] [--apply]  # 默认只打印安装命令，加 --apply 才执行
+freedom toolchain optimize [--apply]                       # 国内网络迹象下换 Go/Rust 镜像源（改配置前留 .bak）
+freedom toolchain clear                                   # 清空探测缓存（~/.freedom/toolchain-cache.json）
 freedom dmg [--platform <plat>]      # 在 macOS 上把 .app 打包为 .dmg
 freedom keygen [--force]             # 生成应用自更新 ed25519 密钥对（私钥留 .freedom/keys/，公钥进配置）
 freedom manifest --artifact <产物> --url <下载地址> [--version x] [--notes txt]  # 产出签名更新清单 dist/latest.json
-freedom agents [--home <dir>]         # Agent 集成支持矩阵（本机磁盘证据判定 ready/convention/unknown）
+freedom agents [--home <dir>]         # Agent 集成支持矩阵（本机磁盘证据判定「是否安装 + 目标文件状态」）
 freedom agents install --what <mcp|skill> --agent <key|all>   # 等价于下面两条
-freedom skill install --agent <key|all> [--dry-run] [--skills-dir <path>]
-freedom mcp install --agent <key|all> [--dry-run] [--config <path> --format json|toml|yaml]
+freedom skill install --agent <key|all> [--dry-run] [--force] [--skills-dir <path>]
+freedom mcp install --agent <key|all> [--dry-run] [--force] [--config <path> --format json|toml|toml-aot|yaml]
 freedom mcp serve                    # stdio MCP 服务本体（一般由 agent 自动拉起）
 freedom version                     # 显示版本并检测最新版本
 freedom update                      # 检查新版本并给出升级命令（同 check-update）
@@ -284,16 +302,22 @@ freedom help
   NDJSON 协议、CLI 命令、坑清单）复制进各 agent 的 skills 目录。
 - `freedom mcp install --agent <key|all>`：把 `freedom mcp serve` 注册进各 agent 的 MCP 配置。
   MCP 工具面：`freedom_build / init / verify / config / shell / release / agents / guide`。
-- `freedom agents [--home <dir>]`：打印支持矩阵。**是否可写一律按本机磁盘证据判定**——
-  `ready`（配置文件已在，合并写入）/ `convention`（仅主目录在，按同族约定新建并明确提示）/
-  `unknown`（本机无足迹，只输出可粘贴片段，绝不凭记忆造路径）。`--home` 换一棵家目录树预览取证结果。
+- `freedom agents [--home <dir>]`：打印支持矩阵。**安装检测门（v1.13.2 起）**——只有本机检出该
+  agent 的**安装足迹**（配置文件在 / 注册表声明的专属目录在 / PATH 里有它的可执行）才允许写入；
+  未检出即 `not-installed`，只输出可粘贴片段，**绝不新建目录、绝不凭记忆造路径**。
+  「父目录存在」不算证据（HOME 与 `AppData/Roaming` 恒在，据此写入＝往没装的东西里写）。
+  `--home` 换一棵家目录树预览取证结果。
+- 逃生通道两条：`--force`（明知该 agent 装着但足迹未被覆盖，强行写入并显式告警）、
+  `--config <真实路径>` / `--skills-dir <真实目录>`（按你指定的路径写，绕开候选路径推断）。
 - `freedom agents install --what <mcp|skill> --agent <key|all>`：上面两条安装入口的合并写法，
   不带 `--what` 时默认 `mcp`；`agents <其它子命令>` 直接报错退出，不会静默回落成矩阵。
 - 写入是**幂等合并**：保留既有其它 server 条目，二次安装原地替换不产生重复；改前留 `<file>.bak` 备份；
-  `--dry-run` 只预览不落盘。未取证的 agent 用 `--config <真实路径> --format <json|toml|yaml>` 覆写。
-- 已按本机取证登记的 agent：Claude Code / Claude Desktop / Codex CLI / Qoder / CodeBuddy / Zcode / Cursor /
-  Hermes（YAML）等；其余（Trae、OpenCode、Gemini CLI、Pi、Tianshu、WorkBuddy、DeepSeek harness、Oh My Pi）
-  在无足迹的机器上一律降级为片段 + 覆写通道。
+  `--dry-run` 只预览不落盘。
+- 已登记的 agent（17 个）：Claude Code / Claude Desktop / Codex CLI / Qoder / CodeBuddy / Zcode / Cursor /
+  Hermes（YAML）/ Tianshu / Pi / WorkBuddy / OpenCode / Gemini CLI / DeepSeek Harness / Oh My Pi / Trae /
+  **Reasonix**。其中 **Reasonix** 的 MCP 配置是 TOML **数组表** `[[plugins]]`（按 `name = "freedom"` 定位条目，
+  与既有 `computer-use` 等插件共存），格式取自本机 `%APPDATA%/reasonix/config.toml` 实况；
+  技能装在 `~/.reasonix/skills/freedom`。未被登记或无足迹的布局用 `--format <json|toml|toml-aot|yaml>` 覆写。
 
 ## 开发热更（freedom dev）
 
@@ -336,5 +360,11 @@ export default {
 
 ## License
 
-MIT
+本工具与其源码为**闭源专有软件**，完整条款见包内 `LICENSE`（不适用 MIT）。要点：
+
+- 你可以自由安装使用，并用它打包 / 销售你自己的应用——**你的前端、后端与产物归你所有**，无需开源或署名；
+- 未经许可方书面同意，不得再分发本包内容物、源码或衍生版本，也不得移除版权与许可声明；
+- 唯一沿用开源许可的部分是内嵌第三方 `webview_go`（MIT，见 `templates/go/third_party/webview_go/LICENSE`）。
+
+商用授权与定制需求请通过仓库 GitHub Issues 联系。
 

package/lib/agents.js

@@ -3,9 +3,14 @@
 // freedom agents / skill / mcp —— 把 Freedom 使用技能与 MCP 服务装进各家 Agent
 //
 // 设计纪律（铁律 19）：注册表只登记「候选路径 + 写入格式」，是否可写一律在安装时按磁盘
-// 证据判定——配置文件存在 = ready（合并写入，保留既有条目、写前 .bak 备份）；目录存在但
-// 配置文件缺失 = create（新建后写入）；皆无 = unverified，只打印可粘贴片段，绝不凭记忆
-// 造路径。未取证的 agent 与任意私有布局经 --config <path> --format <json|toml|yaml> 覆写。
+// 证据判定。安装检测门（R4 起，用户裁定）：**只有检出该 agent 确实装在本机**（配置文件在
+// / agent 家目录在 / PATH 里有它的可执行 / 注册表声明的额外足迹）才允许写入；仅凭「父目录
+// 在」不构成证据——HOME 与 AppData/Roaming 恒在，按同族约定新建等于往没装的东西里写。
+// 未检出的 agent 一律 skipped(not-installed)，只打印可粘贴片段，绝不凭记忆造路径。
+// 覆写通道：--force（明知在但足迹未覆盖）、--config / --skills-dir（用户指定真实路径）。
+//
+// 写入档位：配置文件存在 = ready（合并写入，保留既有条目、写前 .bak 备份）；
+// 目录不存在则按需创建后再合并。
 //
 // 幂等：同一 server 名 / 同一 skill 目录重复安装为原地替换，不产生重复条目。
 
@@ -18,31 +23,91 @@ const { paint, ok, err, warn, dim, bold, section, C } = theme;
 
 const SERVER_NAME = 'freedom';
 
-// mcp: { file: 相对 HOME 的配置文件, format: json|toml|yaml, path: JSON/YAML 容器键路径 }
+// mcp: { file: 相对 HOME 的配置文件, format: json|toml|yaml|toml-aot, path: JSON/YAML 容器键路径,
+//        section: toml-aot 的数组表名, key: toml-aot 用于定位条目的字段 }
 // skills: 相对 HOME 的 skill 根目录（每个 agent 一个）
+// home / evidence: 该 agent 的专属目录与额外安装足迹（可选，安装检测门的证据）
 const AGENTS = [
   { key: 'claude-code', name: 'Claude Code', mcp: { file: '.claude.json', format: 'json', path: ['mcpServers'] }, skills: '.claude/skills' },
-  { key: 'claude-desktop', name: 'Claude Desktop', mcp: { file: 'AppData/Roaming/Claude/claude_desktop_config.json', format: 'json', path: ['mcpServers'] }, skills: 'AppData/Roaming/Claude/skills' },
-  { key: 'codex', name: 'Codex CLI', mcp: { file: '.codex/config.toml', format: 'toml' }, skills: '.codex/skills' },
+  { key: 'claude-desktop', name: 'Claude Desktop', home: 'AppData/Roaming/Claude', mcp: { file: 'AppData/Roaming/Claude/claude_desktop_config.json', format: 'json', path: ['mcpServers'] }, skills: 'AppData/Roaming/Claude/skills' },
+  { key: 'codex', name: 'Codex CLI', bin: 'codex', mcp: { file: '.codex/config.toml', format: 'toml' }, skills: '.codex/skills' },
   { key: 'qoder', name: 'Qoder', mcp: { file: '.qoder/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.qoder/skills' },
   { key: 'codebuddy', name: 'CodeBuddy', mcp: { file: '.codebuddy/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.codebuddy/skills' },
-  { key: 'zcode', name: 'Zcode', mcp: { file: '.zcode/cli/config.json', format: 'json', path: ['mcp', 'servers'] }, skills: '.zcode/skills' },
+  { key: 'zcode', name: 'Zcode', home: '.zcode', mcp: { file: '.zcode/cli/config.json', format: 'json', path: ['mcp', 'servers'] }, skills: '.zcode/skills' },
   { key: 'cursor', name: 'Cursor', mcp: { file: '.cursor/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.cursor/skills' },
   { key: 'hermes', name: 'Hermes', mcp: { file: '.hermes/config.yaml', format: 'yaml', path: ['mcp_servers'] }, skills: '.hermes/skills' },
   { key: 'tianshu', name: 'Tianshu Harness', mcp: { file: '.tianshu/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.tianshu/skills' },
   { key: 'pi', name: 'Pi Agent', mcp: { file: '.pi/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.pi/skills' },
   { key: 'workbuddy', name: 'WorkBuddy', mcp: { file: '.workbuddy/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.workbuddy/skills' },
-  { key: 'opencode', name: 'OpenCode', mcp: { file: '.config/opencode/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.opencode/skills' },
+  { key: 'opencode', name: 'OpenCode', home: '.config/opencode', mcp: { file: '.config/opencode/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.opencode/skills' },
   { key: 'gemini-cli', name: 'Gemini CLI', mcp: { file: '.gemini/settings.json', format: 'json', path: ['mcpServers'] }, skills: '.gemini/skills' },
   { key: 'deepseek-harness', name: 'DeepSeek Harness', mcp: { file: '.deepseek/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.deepseek/skills' },
   { key: 'oh-my-pi', name: 'Oh My Pi', mcp: { file: '.oh-my-pi/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.oh-my-pi/skills' },
   { key: 'trae', name: 'Trae', mcp: { file: '.trae/mcp.json', format: 'json', path: ['mcpServers'] }, skills: '.trae/skills' },
+  // Reasonix（本机取证 2026-09-25：%APPDATA%/reasonix/config.toml 第 288 行起
+  // 「External MCP servers …」+ [[plugins]] name/type/command 实例；该文件注释明示
+  // command/args/env/url/headers 支持 ${VAR} 展开 → args 字段存在）。
+  {
+    key: 'reasonix',
+    name: 'Reasonix',
+    home: 'AppData/Roaming/reasonix',
+    mcp: { file: 'AppData/Roaming/reasonix/config.toml', format: 'toml-aot', section: 'plugins', key: 'name' },
+    skills: '.reasonix/skills',
+    evidence: ['AppData/Roaming/reasonix-studio.exe', '.reasonix'],
+  },
 ];
 
 function homeDir() {
   return process.env.FREEDOM_AGENT_HOME || os.homedir();
 }
 
+// PATH 探测（每轮安装只扫一次，缓存于 Map）：返回命中的可执行全路径或 null
+function makeWhich() {
+  const dirs = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+  const exts = process.platform === 'win32'
+    ? (process.env.PATHEXT || '.EXE;.CMD;.BAT;.PS1').split(';').concat([''])
+    : [''];
+  const cache = new Map();
+  return (names) => {
+    for (const n of names) {
+      if (cache.has(n)) {
+        const hit = cache.get(n);
+        if (hit) return hit;
+        continue;
+      }
+      let found = null;
+      for (const d of dirs) {
+        for (const e of exts) {
+          const cand = path.join(d, n + e);
+          try { if (fs.statSync(cand).isFile()) { found = cand; break; } } catch (err) { /* 不在该目录 */ }
+        }
+        if (found) break;
+      }
+      cache.set(n, found);
+      if (found) return found;
+    }
+    return null;
+  };
+}
+
+// 安装检测门：该 agent 是否真的装在本机（只认真实足迹，不认「父目录恒在」）
+// home / evidence 为显式声明的专属目录与足迹，不做推断——'AppData/Roaming' 这类公共父目录恒在，
+// 推断即假阳性（未安装也被判为已安装）。
+function detect(agent, which) {
+  const home = homeDir();
+  const ev = [];
+  if (fs.existsSync(path.join(home, agent.mcp.file))) ev.push(`配置文件 ${agent.mcp.file}`);
+  if (agent.home && fs.existsSync(path.join(home, agent.home))) ev.push(`目录 ${agent.home}`);
+  for (const rel of agent.evidence || []) {
+    if (fs.existsSync(path.join(home, rel))) ev.push(`足迹 ${rel}`);
+  }
+  if (agent.bin) {
+    const exe = which([agent.bin]);
+    if (exe) ev.push(`PATH ${path.basename(exe)}`);
+  }
+  return { installed: ev.length > 0, evidence: ev };
+}
+
 function skillSource() {
   return path.join(packageRoot(), 'skill', 'freedom');
 }
@@ -73,20 +138,19 @@ function resolveAgentKeys(raw) {
 }
 
 // ---- 状态探测（全部基于本轮磁盘证据） ----
-function probe(agent) {
+function probe(agent, which) {
   const home = homeDir();
   const mcpFile = path.join(home, agent.mcp.file);
   const skillsDir = path.join(home, agent.skills);
-  // ready = 路径本机取证；convention = 仅 agent 主目录在（按同族约定新建，标注提示）；unknown = 无足迹（只给片段）
-  const mcpState = fs.existsSync(mcpFile) ? 'ready'
-    : (fs.existsSync(path.dirname(mcpFile)) ? 'convention' : 'unknown');
-  const skillState = fs.existsSync(skillsDir) ? 'ready'
-    : (fs.existsSync(path.dirname(skillsDir)) ? 'convention' : 'unknown');
-  return { mcpFile, skillsDir, mcpState, skillState };
+  // ready = 目标文件本机取证；create = 目录不在（安装时新建后合并写入）
+  const mcpState = fs.existsSync(mcpFile) ? 'ready' : 'create';
+  const skillState = fs.existsSync(skillsDir) ? 'ready' : 'create';
+  return { mcpFile, skillsDir, mcpState, skillState, detected: detect(agent, which) };
 }
 
 function matrix() {
-  return AGENTS.map((a) => ({ key: a.key, name: a.name, ...probe(a) }));
+  const which = makeWhich();
+  return AGENTS.map((a) => ({ key: a.key, name: a.name, ...probe(a, which) }));
 }
 
 // ---- JSON 配置：按键路径 upsert，保留其余条目 ----
@@ -136,6 +200,47 @@ function upsertToml(text, name, def) {
   return { text: out.join('\n').replace(/\n*$/, '\n'), had };
 }
 
+// ---- TOML 数组表：[[section]] 条目按 key 字段定位（Reasonix 的 [[plugins]] 用 name） ----
+function aotBlock(section, def) {
+  const lines = [`[[${section}]]`];
+  for (const [k, v] of Object.entries(def)) lines.push(`${k} = ${tomlValue(v)}`);
+  return lines;
+}
+
+function upsertTomlAoT(text, section, keyField, keyVal, def) {
+  const lines = text.split(/\r?\n/);
+  const header = `[[${section}]]`;
+  const starts = [];
+  for (let i = 0; i < lines.length; i++) if (lines[i].trim() === header) starts.push(i);
+  const blockEnd = (i) => {
+    let j = i + 1;
+    while (j < lines.length && !/^\s*\[/.test(lines[j])) j++;
+    return j;
+  };
+  const keyRe = new RegExp(`^\\s*${keyField}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|(.+?))\\s*$`);
+  for (const s of starts) {
+    let hit = false;
+    for (let i = s + 1; i < blockEnd(s); i++) {
+      const m = lines[i].match(keyRe);
+      if (!m) continue;
+      const raw = m[1] !== undefined ? m[1] : m[2] !== undefined ? m[2] : m[3];
+      if (String(raw).trim() === keyVal) hit = true;
+    }
+    if (!hit) continue;
+    const out = [...lines.slice(0, s), ...aotBlock(section, def), ...lines.slice(blockEnd(s))];
+    return { text: out.join('\n').replace(/\n*$/, '\n'), had: true };
+  }
+  let out;
+  if (starts.length) {
+    const last = starts[starts.length - 1];
+    const end = blockEnd(last);
+    out = [...lines.slice(0, end), '', ...aotBlock(section, def), ...lines.slice(end)];
+  } else {
+    out = [...lines, '', ...aotBlock(section, def)];
+  }
+  return { text: out.join('\n').replace(/\n*$/, '\n'), had: false };
+}
+
 // ---- YAML：mcp_servers: 下按缩进 upsert 一个条目 ----
 function yamlEntry(indent, name, def) {
   const p = ' '.repeat(indent);
@@ -194,41 +299,59 @@ function backup(file) {
 
 function snippet(agent, what) {
   if (what === 'mcp') {
-    const body = JSON.stringify({ [SERVER_NAME]: serverDef() }, null, 2);
-    if (agent.mcp.format === 'toml') {
-      return [`  ${dim('# 无 mcp_servers 块，手工追加到 ~/.codex/config.toml：')}`, ...tomlBlock(SERVER_NAME, serverDef()).trimEnd().split('\n').map((l) => '  ' + dim(l))];
+    const fmt = agent.mcp.format;
+    if (fmt === 'toml') {
+      return [`  ${dim(`手工追加到 ${agent.mcp.file}：`)}`, ...tomlBlock(SERVER_NAME, serverDef()).trimEnd().split('\n').map((l) => '  ' + dim(l))];
     }
+    if (fmt === 'toml-aot') {
+      const block = aotBlock(agent.mcp.section || 'plugins', { name: SERVER_NAME, type: 'stdio', ...serverDef() });
+      return [`  ${dim(`手工追加到 ${agent.mcp.file}（数组表按 ${agent.mcp.key || 'name'} 定位条目）：`)}`, ...block.map((l) => '  ' + dim(l))];
+    }
+    const body = JSON.stringify({ [SERVER_NAME]: serverDef() }, null, 2);
     return [
-      `  ${dim('目标配置文件未取证，请把以下条目并入你的 MCP 配置（容器键通常是 mcpServers / mcp.servers）：')}`,
+      `  ${dim('请把以下条目并入你的 MCP 配置（容器键通常是 mcpServers / mcp.servers）：')}`,
       ...body.split('\n').map((l) => `  ${dim(l)}`),
       `  ${dim(`或指定路径直接写入：freedom mcp install --agent ${agent.key} --config <path> --format json|toml|yaml`)}`,
     ];
   }
   return [
-    `  ${dim('未发现该 agent 的 skill 目录，手工复制：')}`,
-    `  ${dim(`${skillSource()}  →  <agent skills 根目录>/freedom`)}`,
+    `  ${dim('手工复制技能目录：')}`,
+    `  ${dim(`${skillSource()}  →  ${path.join(homeDir(), agent.skills)}${'\\'}freedom`)}`,
     `  ${dim(`或指定目录直接安装：freedom skill install --agent ${agent.key} --skills-dir <path>`)}`,
   ];
 }
 
+// 安装检测门裁定：显式覆写通道 / --force / 足迹命中，三者皆无则不写
+function gateOf(agent, pr, explicit, force) {
+  if (explicit) return { pass: true, reason: '' };
+  if (force) return { pass: true, reason: `${warn(`未检出安装足迹（${[
+    path.join(homeDir(), agent.mcp.file), path.join(homeDir(), agent.skills),
+  ].join(' / ')}），按 --force 强行写入；若该 agent 并未安装，请自行删除。`)}` };
+  if (pr.detected.installed) return { pass: true, reason: dim(`已检出：${pr.detected.evidence.join('；')}`) };
+  return { pass: false, reason: '' };
+}
+
 // ---- 安装主流程 ----
-function installMcpOne(agent, { config, format, dryRun }) {
-  const pr = probe(agent);
+function installMcpOne(agent, { config, format, dryRun, force, which }) {
+  const pr = probe(agent, which);
+  const gate = gateOf(agent, pr, config, force);
+  if (!gate.pass) {
+    return { agent, state: 'not-installed', lines: [`  ${warn(`${agent.key}: 本机未检出安装足迹 → 依检测门不写入（只给可粘贴片段）`)}`, ...snippet(agent, 'mcp')] };
+  }
   const file = config || pr.mcpFile;
   const fmt = format || agent.mcp.format;
   const cpath = agent.mcp.path || ['mcpServers'];
 
-  if (!config && pr.mcpState === 'unknown') {
-    return { agent, state: 'snippet', lines: [`  ${warn(`${agent.key}: 未找到配置目录 ${path.dirname(pr.mcpFile)}（未取证，不写入）`)}`, ...snippet(agent, 'mcp')] };
-  }
-  const text = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : (fmt === 'json' ? '{}\n' : fmt === 'toml' ? '' : '');
+  const text = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : (fmt === 'json' ? '{}\n' : '');
   const up = fmt === 'toml' ? upsertToml(text, SERVER_NAME, serverDef())
-    : fmt === 'yaml' ? upsertYaml(text, cpath, SERVER_NAME, serverDef())
-      : fmt === 'json' ? upsertJson(text, cpath, SERVER_NAME, serverDef())
-        : (() => { throw new Error(`不支持的 --format：${fmt}（可选 json|toml|yaml）`); })();
+    : fmt === 'toml-aot' ? upsertTomlAoT(text, agent.mcp.section || 'plugins', agent.mcp.key || 'name', SERVER_NAME,
+      { name: SERVER_NAME, type: 'stdio', ...serverDef() })
+      : fmt === 'yaml' ? upsertYaml(text, cpath, SERVER_NAME, serverDef())
+        : fmt === 'json' ? upsertJson(text, cpath, SERVER_NAME, serverDef())
+          : (() => { throw new Error(`不支持的 --format：${fmt}（可选 json|toml|toml-aot|yaml）`); })();
 
   if (dryRun) {
-    return { agent, state: up.had ? 'replace(dry)' : 'add(dry)', lines: [`  ${dim(`${file} · ${fmt} · ${up.had ? '替换既有条目' : '新增条目'}`)}`] };
+    return { agent, state: up.had ? 'replace(dry)' : 'add(dry)', lines: [`  ${dim(`${file} · ${fmt} · ${up.had ? '替换既有条目' : '新增条目'}`)} ${gate.reason}`] };
   }
   const bak = backup(file);
   fs.writeFileSync(file, up.text, 'utf8');
@@ -236,37 +359,38 @@ function installMcpOne(agent, { config, format, dryRun }) {
     agent,
     state: up.had ? 'replaced' : 'added',
     lines: [`  ${ok(`${file}`)} ${dim(`· ${fmt} · ${up.had ? '已替换既有 freedom 条目' : '已写入'}${bak ? ` · 备份 ${path.basename(bak)}` : ''}`)}`,
-      ...(config || pr.mcpState === 'ready' ? [] : [`  ${warn('该路径按同族约定新建（本机未取证）；若该 agent 不读此文件，请用 --config 指定真实路径。')}`]),
+      ...(gate.reason ? [`  ${gate.reason}`] : []),
       `  ${dim(`重启 ${agent.name} 后生效；未自动信任前请在该 agent 内确认。`)}`],
   };
 }
 
-function installSkillOne(agent, { skillsDir, dryRun }) {
-  const pr = probe(agent);
+function installSkillOne(agent, { skillsDir, dryRun, force, which }) {
+  const pr = probe(agent, which);
   const src = skillSource();
   if (!fs.existsSync(src)) throw new Error(`技能源缺失：${src}`);
-  const destBase = skillsDir || pr.skillsDir;
-  if (!skillsDir && pr.skillState === 'unknown') {
-    return { agent, state: 'snippet', lines: [`  ${warn(`${agent.key}: 未找到 skill 根目录 ${destBase}（未取证，不写入）`)}`, ...snippet(agent, 'skill')] };
+  const gate = gateOf(agent, pr, skillsDir, force);
+  if (!gate.pass) {
+    return { agent, state: 'not-installed', lines: [`  ${warn(`${agent.key}: 本机未检出安装足迹 → 依检测门不写入（只给可粘贴片段）`)}`, ...snippet(agent, 'skill')] };
   }
+  const destBase = skillsDir || pr.skillsDir;
   const dest = path.join(destBase, 'freedom');
-  if (dryRun) return { agent, state: 'dry', lines: [`  ${dim(`${src} → ${dest}`)}`] };
+  if (dryRun) return { agent, state: 'dry', lines: [`  ${dim(`${src} → ${dest}`)} ${gate.reason}`] };
   if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
   copyDir(src, dest);
   return {
     agent,
     state: 'installed',
     lines: [`  ${ok(dest)}`,
-      ...(skillsDir || pr.skillState === 'ready' ? [] : [`  ${warn('该 skill 根目录按同族约定新建（本机未取证）；若不被读取，请用 --skills-dir 指定真实目录。')}`])],
+      ...(gate.reason ? [`  ${gate.reason}`] : [])],
   };
 }
 
-async function install({ what = 'mcp', agent = 'all', dryRun = false, config = null, format = null, skillsDir = null, home = null } = {}) {
+async function install({ what = 'mcp', agent = 'all', dryRun = false, config = null, format = null, skillsDir = null, force = false, home = null } = {}) {
   const prevHome = process.env.FREEDOM_AGENT_HOME;
   if (home) process.env.FREEDOM_AGENT_HOME = path.resolve(home);
   let out;
   try {
-    out = await installRun({ what, agent, dryRun, config, format, skillsDir });
+    out = await installRun({ what, agent, dryRun, config, format, skillsDir, force });
   } finally {
     if (prevHome === undefined) delete process.env.FREEDOM_AGENT_HOME;
     else process.env.FREEDOM_AGENT_HOME = prevHome;
@@ -274,7 +398,7 @@ async function install({ what = 'mcp', agent = 'all', dryRun = false, config = n
   return out;
 }
 
-async function installRun({ what, agent, dryRun, config, format, skillsDir }) {
+async function installRun({ what, agent, dryRun, config, format, skillsDir, force }) {
   if (config) config = path.resolve(config);
   if (skillsDir) skillsDir = path.resolve(skillsDir);
   const keys = resolveAgentKeys(agent);
@@ -282,37 +406,43 @@ async function installRun({ what, agent, dryRun, config, format, skillsDir }) {
   const results = [];
   console.log(section(what === 'skill' ? '安装 Freedom 使用技能' : '注册 Freedom MCP 服务'));
   if (dryRun) console.log(`  ${warn('--dry-run 预览模式：不写任何文件')}`);
+  const which = makeWhich();
   for (const key of keys) {
     const a = agentByKey(key);
     const fn = what === 'skill' ? installSkillOne : installMcpOne;
     let r;
     try {
-      r = fn(a, { config, format, dryRun, skillsDir });
+      r = fn(a, { config, format, dryRun, skillsDir, force, which });
     } catch (e) {
       r = { agent: a, state: 'failed', lines: [`  ${err(`${key}: ${e.message}`)}`] };
     }
-    results.push({ key, state: r.state });
-    console.log(`${paint(`${r.state.padEnd(9)}`, C.fg.cyan, C.bold)} ${bold(a.name)} ${dim(`(${key})`)}`);
+    results.push({ key, state: r.state, detected: probe(a, which).detected.installed });
+    console.log(`${paint(`${r.state.padEnd(13)}`, C.fg.cyan, C.bold)} ${bold(a.name)} ${dim(`(${key})`)}`);
     for (const l of r.lines) console.log(l);
   }
   const bad = results.filter((x) => x.state === 'failed').length;
+  const skipped = results.filter((x) => x.state === 'not-installed').length;
   console.log('');
-  console.log(`  ${dim('汇总：')}${results.length} 个 agent${bad ? `，${err(`${bad} 个失败`)}` : ''}${dryRun ? ` ${dim('（预览，未落盘）')}` : ''}`);
+  console.log(`  ${dim('汇总：')}${results.length} 个 agent${skipped ? `，${paint(`${skipped} 个未检出安装（未写入）`, C.fg.yellow)}` : ''}${bad ? `，${err(`${bad} 个失败`)}` : ''}${dryRun ? ` ${dim('（预览，未落盘）')}` : ''}`);
   return { results, code: bad ? 1 : 0 };
 }
 
 // 打印支持矩阵（freedom agents）
 function printMatrix() {
   console.log(section('Agent 集成支持矩阵'));
-  console.log(`  ${dim('ready=配置文件/技能目录已存在（合并写入）  convention=仅主目录在（按同族约定新建并提示）  unknown=本机未取证（仅打印片段）')}`);
+  console.log(`  ${dim('安装门=本机是否检出该 agent 的足迹（配置文件／声明目录／PATH 可执行）；未检出只打印片段、不写入（可 --force 覆写）')}`);
+  console.log(`  ${dim('MCP/SKILL 列：ready=目标已存在（合并写入）  create=安装时新建目录后写入')}`);
   console.log('');
   for (const r of matrix()) {
-    const cell = (s) => (s === 'ready' ? `${ok('ready  ')}` : s === 'convention' ? `${paint('conventn ', C.fg.yellow)}` : dim('unknown'));
-    console.log(`  ${paint(r.key.padEnd(17), C.fg.cyan, C.bold)} MCP ${cell(r.mcpState)} ${dim(r.mcpFile)}  · SKILL ${cell(r.skillState)} ${dim(r.skillsDir)}`);
+    const cell = (s) => (s === 'ready' ? `${ok('ready ')}` : paint('create ', C.fg.yellow));
+    const gate = r.detected.installed ? ok('已安装') : dim('未检出');
+    const basis = r.detected.installed ? dim(`（${r.detected.evidence.join('；')}）`) : dim('（需 --force 或 --config/--skills-dir）');
+    console.log(`  ${paint(r.key.padEnd(17), C.fg.cyan, C.bold)} ${gate} ${basis}`);
+    console.log(`  ${' '.repeat(18)}MCP ${cell(r.mcpState)} ${dim(r.mcpFile)}  · SKILL ${cell(r.skillState)} ${dim(r.skillsDir)}`);
   }
   console.log('');
-  console.log(`  ${dim('用法：')}${paint('freedom skill install --agent all', C.fg.white)}  /  ${paint('freedom mcp install --agent <key> [--dry-run] [--config <path> --format <json|toml|yaml>]', C.fg.white)}`);
+  console.log(`  ${dim('用法：')}${paint('freedom skill install --agent all', C.fg.white)}  /  ${paint('freedom mcp install --agent <key> [--dry-run] [--force] [--config <path> --format <json|toml|toml-aot|yaml>]', C.fg.white)}`);
   return 0;
 }
 
-module.exports = { install, printMatrix, upsertJson, upsertToml, upsertYaml };
+module.exports = { install, printMatrix, upsertJson, upsertToml, upsertTomlAoT, upsertYaml, detect, makeWhich };

package/lib/build.js

@@ -32,6 +32,7 @@ const {
   isMacPlat,
   platformExeName,
   nativePlatform,
+  normalizePlatform,
   localShellPath,
 } = require('./utils');
 const { hasShell, downloadShell, validateLocalShell } = require('./shell');
@@ -60,12 +61,12 @@ function run(cmd, args, opts = {}) {
   return res;
 }
 
-// --platform 解析：支持逗号 / 中英文逗号 / 空白分隔多平台；win|mac|linux|all 或平台 key（win-x64 等）。
+// --platform 解析：支持逗号 / 中英文逗号 / 空白分隔多平台；win|mac|linux|all 或平台 key
+// （win-x64 等，别名口径与 freedom shell 子命令统一走 utils.normalizePlatform）。
 // 多平台去重保留顺序。all 仅取可分发平台（DIST_PLATFORMS）：linux-arm64 无 CI 资产，
 // 若列入 all 会在 build 时 404 拖垮整个全量构建（历史 bug B41）。
 function parsePlatforms(raw) {
   if (!raw) return [nativePlatform()];
-  const keyMap = { win: 'win-x64', mac: 'darwin-arm64', linux: 'linux-x64' };
   const seen = [];
   const push = (p) => {
     if (!ALL_PLATFORMS.includes(p)) {
@@ -81,7 +82,7 @@ function parsePlatforms(raw) {
     if (v === 'all') {
       for (const p of DIST_PLATFORMS) push(p);
     } else {
-      push(keyMap[v] || v);
+      push(normalizePlatform(v) || v);
     }
   }
   if (seen.length === 0) {
@@ -140,7 +141,7 @@ async function build(projectDir, opts = {}) {
     html = fs.readFileSync(distHtml, 'utf8');
     warnIfNotSingleFile(html, distHtml);
   }
-  const configJSON = renderConfigJSON(cfg, name);
+  const configJSON = renderConfigJSON(cfg, name, version);
   // 安全模式：--security 优先于 freedom.config.js 的 security 字段，默认 none。
   //   none  = 明文资源（默认，兼容历史产物）
   //   basic = 明文资源 + 构建期安全提示（剥符号 / 混淆，后续可用高模式加密）
@@ -470,7 +471,10 @@ async function buildInstaller({ plat, name, version, targetDir, exeName }) {
   const artifacts = [];
 
   const zipPath = path.join(targetDir, `${name}-${plat}-portable.zip`);
-  const tmpPath = path.join(path.dirname(targetDir), `.freedom-portable-${process.pid}.zip`);
+  // 中间 zip 必须带平台后缀：多平台打包是并发的（emitPlatform 跑在 Promise.all 里），
+  // 而各 plat 的 targetDir 同级，只按 pid 命名会让 A 平台的 zipDir 覆写 B 平台正在 rename 的
+  // 临时文件——结果是 A 的 portable.zip 里装着 B 的二进制（静默错平台产物）或 ENOENT 崩在成功提示之后。
+  const tmpPath = path.join(path.dirname(targetDir), `.freedom-portable-${plat}-${process.pid}.zip`);
   zipDir(tmpPath, targetDir);
   await fsp.rename(tmpPath, zipPath);
   artifacts.push(zipPath);
@@ -530,9 +534,12 @@ function appVersionFromPkg(dir) {
 }
 
 // 渲染 resources/config.json（与壳 resources.go 的 runtimeConfigFile 字段对齐）
-function renderConfigJSON(cfg, name) {
+function renderConfigJSON(cfg, name, version) {
   const obj = {
     name,
+    // 应用自己的版本必须随产物落盘：通用壳编译期注入的 freedom.Version 是「壳」的版本域，
+    // 自更新拿它跟应用清单比，结果是「永远 uncomparable」或「下完更新还是同一个壳」。
+    version: version || undefined,
     title: cfg.title || cfg.name || name,
     titlebar: cfg.titlebar || 'frameless',
     width: intVal(cfg.width, 1024),
@@ -562,6 +569,14 @@ function renderConfigJSON(cfg, name) {
       requireSignature: cfg.updater.requireSignature === true ? true : undefined,
     };
   }
+  // 能力收口透传：壳在 Config.Capabilities 未编译设置时才采用这里的白/黑名单
+  // （capability.go 在 sys/tray/window 三桥派发前判定，拒绝零副作用）。
+  const caps = cfg.capabilities;
+  if (caps && (Array.isArray(caps.allow) || Array.isArray(caps.deny))) {
+    const allow = (caps.allow || []).filter((s) => typeof s === 'string' && s);
+    const deny = (caps.deny || []).filter((s) => typeof s === 'string' && s);
+    if (allow.length || deny.length) obj.capabilities = { allow, deny };
+  }
   return JSON.stringify(obj, null, 2);
 }
 
@@ -721,4 +736,4 @@ function stripSourceMapRefs(html) {
   return { html: out, stripped };
 }
 
-module.exports = { build, parsePlatforms };
+module.exports = { build, parsePlatforms, renderConfigJSON };