chore: 发布 1.11.0

.github/release-notes/versions/1.11.0.md

@@ -0,0 +1,85 @@
+### 重点新增：完整 MCP Server
+
+- 新增 `shellsmith-mcp`，通过本地 stdio 向其他 Agent 暴露 Shellsmith 当前全部 CLI 能力；不包含独立 Agent、模型调用或 UI，加固核心仍由 `shield` CLI 执行。
+- 提供 16 个 MCP 工具：
+  - 版本与检查：`shellsmith_version`、`shellsmith_check_apk`、`shellsmith_check_aab`、`shellsmith_check_ios`、`shellsmith_check_keystore`
+  - 加固与签名：`shellsmith_protect_apk`、`shellsmith_protect_aab`、`shellsmith_protect_xop`、`shellsmith_protect_ios`、`shellsmith_sign_apk`
+  - 安装与报告：`shellsmith_install_apks`、`shellsmith_read_report`
+  - 任务管理：`shellsmith_job_status`、`shellsmith_job_result`、`shellsmith_job_cancel`、`shellsmith_job_list`
+- 长任务立即返回 `job_id`；支持进度通知、状态查询、终态结果、取消和进程树回收，不阻塞 MCP 请求循环。
+- `shellsmith_protect_apk` 支持加固与自动签名组成同一任务；自动签名前会校验输入 APK、keystore 与 `runtime_cert_sha256` 的证书一致性，避免载荷绑定证书与最终签名证书不一致。
+- MCP 参数不接受明文密码：只接受 `password_env` / `key_password_env` / `byos_api_key_env`，密码从 MCP 进程环境读取。
+- 加固、签名和安装要求显式 `confirm: true`；原地覆盖还要求 `allow_in_place: true`。
+- 支持 `--allow-root` / `SHELLSMITH_MCP_ALLOWED_ROOTS` 路径白名单；输入、输出、iOS 配置引用、工程 bundle 内部链接和报告路径都会校验真实位置。
+- 同步检查移出协议读循环并支持超时；MCP 关闭 stdin、收到 `exit` 或 `shutdown` 时，会取消并回收活动任务和同步检查。
+- 默认本地运行、离线处理；不上传 APK、AAB、证书、密码或报告。BYOS 仅在显式配置时访问用户自建服务。
+
+### GitHub Release 新增 CLI + MCP 完整包
+
+- Release 成功后自动构建并上传 Linux x86_64、macOS universal、Windows x86_64 的 `Shellsmith-cli-<version>-<platform>` 包。
+- 包内同时包含 `shield` 和 `shellsmith-mcp`，以及 apktool、apksigner、XOP PVM2 packer、runtime resources、许可证和 README。
+- 生成 SHA-256 校验和；`shellsmith-mcp` 默认自动查找同目录 `shield`，解压后无需额外传 `--cli`。
+- Release 说明改为带引号模板渲染，修复反引号被 shell 执行、说明文字丢字的问题。
+
+### Android 加固与性能
+
+- 优化 PVM2 字符串处理：增加 ASCII 字符串快速路径，减少通用编码路径的分配和拷贝。
+- 优化静态零参数跳板，移除不必要的 `NEW_ARRAY` 指令。
+- 分配探针结果：生产字符串处理从 **176.62 B/次降至 48.53 B/次（-72.5%）**，GC 次数从 **8.0 降至 5.67**（BRP-AN00 / API 35 / arm64 测试环境）。
+- DEXB v6 格式、PVM2 协议版本和加固产物结构未改变；性能收益需要重新执行加固后生效。
+
+### 签名与产物生命周期
+
+- 统一 APK/AAB 签名文件生命周期：暂存 APK、V4 `.idsig`、保护报告和旧附件按同一事务提交；失败时恢复旧产物，避免半替换状态。
+- 修复签名取消和失败清理：口令文件、暂存 APK、报告、V4 附件和恢复目录按实际使用路径清理；回滚失败时明确保留恢复副本，MCP 任务清理不会删除该副本。
+- V4 签名附件随最终产物正确迁移；关闭 V4 时清理旧附件，开启时验证附件非空。
+- 修复签名凭证编码、密码文件传递、Swift 启动入口定位、条件编译识别和取消读取竞态。
+- iOS 工作副本、签名取消和凭据传递路径统一；拒绝条件编译包装的 UIKit 回调，保留迟到取消错误。
+- 普通 `shellsmith_sign_apk` 只在保护报告实际存在时返回 `report`，不再返回不存在的 `.protection.json`。
+- 自定义 `apksigner` 现在贯穿证书预检和最终签名：`sign.apksigner` 优先，未填写时沿用顶层 `apksigner`。
+- `check-keystore` 的密码支持 `MOCIKA_SHIELD_KS_PASS` 环境变量，密码不进入 argv。
+
+### iOS 加固与检查
+
+- 修复 `protect-ios --ios-config` 与全局 `--config` 的 clap 参数 ID 冲突；合法 iOS TOML 不再被当作通用 CLI 配置读取。
+- iOS 配置中的 `project.path`、实际启用的 `project.entrypoint`、`confidential.config` 以及工程/工作区内部文件均受允许目录约束。
+- 支持 `.xcodeproj` / `.xcworkspace` 主入口别名：按原始入口扩展名识别工程类型，再校验规范化后的真实路径。
+- 修复 workspace 扫描边界：只允许 workspace 时不再读取同级工程；需要开放源码根目录时会明确提示。
+- 目录链接按 CLI 遍历语义递归校验，覆盖链接目标内部的 `project.pbxproj` 和 scheme 链接；使用深度/条目限制并保留循环保护。
+- `.git`、`Pods`、`.build`、`DerivedData` 的跳过规则统一应用于普通目录和目录链接。
+- CocoaPods 预检实际读取的 `Podfile.lock`、`Pods/Manifest.lock` 以及内部 workspace 父工程 `project.pbxproj` 会在读取前校验路径和普通文件类型。
+- 修复大小写不敏感文件系统上的绕过：按 CLI 实际打开的小写路径检查 `project.pbxproj` / `contents.xcworkspacedata`，大写目录项也会被正确识别。
+- 命名管道、设备文件、同名目录等非普通文件会立即拒绝，不再阻塞检查或保护预检；必需文件的失效链接明确报错，无关的失效普通文件链接保持忽略。
+- `compat` 模式不再校验实际不会使用的 `entrypoint` / Swift Confidential 配置；`balanced` / `strict` 保持原有启用语义。
+- 修复 `check-ios` 多行 JSON 报告被截断成单个字符串的问题；现在完整保留 `project_path`、`source_root`、`schemes`、`targets`、`xcode`、`checks` 等字段。
+- 修正 macOS 上共享 scheme、CocoaPods 依赖和 iOS 工程路径检查的错误处理。
+
+### BYOS 桌面配置
+
+- 桌面端重启后会恢复上次选择的 BYOS 服务或本地离线模式。
+- BYOS 服务详情和构建 API key 加密保存在本地；编辑服务时留空 key 会沿用已保存的凭据。
+- 加固任务仍按提交时固定的 BYOS 配置执行，不会因运行中切换界面选项而改变本次任务。
+- 被加固的 APK 每次启动仍按服务端策略取钥；本版本不改变 BYOS 协议和运行时授权模型。
+
+### MCP 安全与任务生命周期修复
+
+- 同步检查、异步任务和 MCP 退出统一使用独立进程组/进程树回收；Windows 使用 `taskkill /PID <pid> /T /F`。
+- 子进程显式移除继承的 BYOS/keystore 密码环境变量，再按任务注入，避免普通离线任务被父进程预设的 BYOS key 破坏。
+- 取消时由 MCP 持有任务私有 `TMPDIR` 和暂存根目录，任务结束后清理口令和 staging；签名回滚保留的恢复副本位于输出目录，不受清理影响。
+- 修复同步检查阻塞取消、持有任务锁等待进程退出、stdout 提前关闭后无法取消等问题。
+- 相对 `--cli ./bin/shield` 路径会先按 MCP 启动目录解析，再切换子进程工作目录；裸程序名仍通过 `PATH` 查找。
+
+### 工程与发布
+
+- 新增 MCP 测试：协议初始化、工具清单、检查、加固、自动签名、任务取消、失败结果、进度通知、路径白名单、符号链接逃逸、秘密环境变量、FIFO/非普通文件、iOS 配置/工程路径、兼容性回归等。
+- 新增 CLI/MCP 发布包构建与校验工作流；Release 说明、CLI 本地发布脚本、Makefile 和构建文档同步更新。
+- 新增 `SHELLSMITH_MCP_SYNC_TIMEOUT_SECS`（默认 600 秒）控制同步检查超时。
+- 未自动升级依赖；Dependabot 依赖升级 PR 已关闭并删除分支，避免在发布周期内引入未经验证的依赖变更。
+
+### 升级说明
+
+- MCP 用户需要更新 `shellsmith-mcp` 及其配套 `shield` CLI；如果使用发布页的 CLI 包，直接下载新的 `Shellsmith-cli-<version>-<platform>` 包即可。
+- PVM2 字符串/跳板性能优化只对重新加固后的 APK 生效；已加固产物无需仅因本版本重新加固。
+- iOS 路径校验比旧版本更严格：如果工程实际源码根目录、CocoaPods 锁文件或工程内部链接位于 `--allow-root` 之外，需要显式增加对应允许目录。
+- 普通签名结果不再包含不存在的保护报告；如果输入 APK 带有保护报告，签名后仍会返回实际迁移后的报告路径。
+- DEXB 格式、PVM2 协议、BYOS 协议和 Android/iOS 运行时资源版本未改变。

apps/shellsmith-mcp/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "shellsmith-mcp"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 authors = ["MocikaDev"]
 license = "MIT OR Apache-2.0"

apps/shield-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "shield-cli"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 authors = ["MocikaDev"]
 license = "MIT OR Apache-2.0"

apps/shield-gui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocika-shield-gui",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "license": "MIT OR Apache-2.0",
   "private": true,
   "type": "module",

apps/shield-gui/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "mocika-shield"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 publish = false

apps/shield-gui/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Shellsmith",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "identifier": "dev.mocika.shield-gui",
   "build": {
     "beforeDevCommand": "npm run dev -- --host 127.0.0.1",

apps/shield-gui/src/hooks/use-about-page.ts

@@ -9,7 +9,7 @@ type AppInfo = {
 };
 
 const defaultAppInfo: AppInfo = {
-  version: "1.10.1",
+  version: "1.11.0",
   git_hash: "dev",
   build_date: "unknown",
 };

crates/shield-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "shield-core"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 authors = ["MocikaDev"]
 license = "MIT OR Apache-2.0"

shield-stub/compat/api19-rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "mocikashield-api19"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 build = "../../src/main/rust/build.rs"

shield-stub/src/main/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "mocikashield"
-version = "1.10.1"
+version = "1.11.0"
 edition = "2021"
 license = "MIT OR Apache-2.0"