@chengyu08/ipa-cli 0.2.3 → 0.2.5

package/README.md

@@ -22,6 +22,7 @@
 - 生成、校验和批量渲染 App Store 上架图
 - 批量扫描当前目录或多个子项目中的静态图片风险
 - 输出机器可消费的静态图片整改清单 JSON
+- 提取 IPA / APK 包中的图片、字体资源与 `Assets.car` 原文件，并按类型整理到清晰目录
 
 ## 安装要求
 
@@ -603,6 +604,8 @@ cp ./scripts/ipatool.env.example ./scripts/ipatool.env
 - `screenshots from-simulator`：从 iOS 模拟器采集一张原始截图
 - `screenshots check`：校验上架图目录的尺寸、格式、数量和命名
 - `screenshots render`：根据配置批量渲染上架图
+- `extract`：提取 IPA / APK 包中的图片、字体资源，并输出应用摘要
+- `obfuscate`：按技术栈输出 iOS 混淆方案，重点支持 Flutter、uni-app 等跨平台项目
 - `assets review`：批量扫描当前目录或多个子项目中的静态图片风险
 - `assets manifest`：输出机器可消费的静态图片整改清单 JSON
 - `assets obfuscate`：批量混淆图片资源，使哈希等指标不一致，用于降低重复图片风险
@@ -1926,6 +1929,41 @@ ipa-cli assets manifest . --scope children --output ./artifacts/assets-manifest.
 - `consolidate-duplicates`
 - `review-metadata-visuals`
 
+### `extract`
+
+提取 `.ipa` 或 `.apk` 包内可直接落盘的图片、字体资源，并按 `images/`、`fonts/`、`assets-car/` 分目录整理。命令还会额外输出 `app.json`，汇总包名、应用名、版本和主图标路径；如果识别到主图标，会在输出根目录直接生成一份 `icon.*`，便于快速查看。针对 IPA，如果检测到 `Assets.car`，还会原样导出该文件并额外生成摘要 JSON，便于后续人工复核。`assets extract` 仍保留为兼容别名。
+
+```bash
+ipa-cli extract <input> [--output <dir>] [--only all|images|fonts] [--force] [--format text|json]
+```
+
+参数：
+
+- `<input>`：`.ipa` 或 `.apk` 文件路径
+- `--output <dir>`：提取输出目录，默认是 `./<包名>-assets`
+- `--only all|images|fonts`：控制提取范围，默认 `all`
+- `--force`：输出目录非空时覆盖已有内容
+- `--format text|json`：输出格式，默认 `text`
+
+示例：
+
+```bash
+ipa-cli extract ./demo.ipa --output ./artifacts/demo-assets
+ipa-cli extract ./demo.apk --only images --format json
+```
+
+默认输出结构：
+
+```text
+demo-assets/
+  app.json
+  icon.png
+  manifest.json
+  images/
+  fonts/
+  assets-car/
+```
+
 ### `assets obfuscate`
 
 批量混淆图片资源，通过噪点注入、色彩偏移和重编码使图片的 SHA-256、感知哈希等指标不一致，从而降低被识别为重复图片的风险。
@@ -1985,6 +2023,44 @@ ipa-cli assets obfuscate ./images --format json --output ./images-obfuscated
 - 资源命名模式仅在启用 `--rename` 时修改，Assets.car 结构和页面引用关系不会被更新
 - 建议使用 `assets review` 命令重新扫描，确认各项指标差异是否足够
 
+### `obfuscate`
+
+根据 IPA 或指纹 JSON 的技术栈画像，输出对应的 iOS 混淆方案。当前重点覆盖：
+
+- Flutter：构建时 Dart 混淆 + `flutter_assets` 业务资源治理
+- uni-app：`app-plus.confusion.resources` 定向原生混淆 + 云打包 / 安心打包 + H5 资源治理
+- 其他栈：React Native / Hybrid / 原生 iOS 的通用保护与降重建议
+
+其中 Flutter 方案会明确区分：
+
+- `App.framework/App`：Dart AOT 业务产物，`--obfuscate` 主要影响这里
+- `Runner`：原生壳入口，如需变化要改壳层代码、配置、桥接或插件集合
+- `Flutter.framework`：公共运行时，更适合做技术栈识别，不是主要业务降重目标
+
+```bash
+ipa-cli obfuscate [input] [--stack auto|flutter|uni-app|react-native|hybrid|native-ios] [--format text|json|markdown]
+```
+
+参数：
+
+- `[input]`：可选，IPA 文件路径或指纹 JSON 路径；省略时必须手动传 `--stack`
+- `--stack <stack>`：技术栈，默认 `auto`
+- `--format <format>`：输出格式，默认 `text`
+
+示例：
+
+```bash
+ipa-cli obfuscate ./build/ios/ipa/MyApp.ipa
+ipa-cli obfuscate ./fingerprints/flutter.json --format markdown
+ipa-cli obfuscate --stack uni-app --format text
+```
+
+说明：
+
+- `obfuscate` 不会直接修改已构建的 IPA 二进制，而是输出按技术栈划分的可执行方案
+- 纯图片资源仍建议配合 `assets review` / `assets obfuscate` 使用
+- 若已知工程类型，优先用 `--stack` 明确指定，避免自动识别误差
+
 ### `baseline import`
 
 把现成的指纹 JSON / JSONL 导入本地基线库。
@@ -2185,6 +2261,7 @@ ipa-cli baseline list --library ./data/library --format panel
 - `screenshots from-ipa`：`text | json | panel`
 - `screenshots check`：`text | json | panel`
 - `screenshots render`：`text | json | panel`
+- `extract`：`text | json`
 - `assets review`：`text | json | panel`
 - `assets manifest`：固定输出 `json`
 - `baseline doctor`：`panel | json | tsv`
@@ -2279,6 +2356,7 @@ ipa-cli --help
 
 ```bash
 ipa-cli --help
+ipa-cli extract --help
 ipa-cli analyze --help
 ipa-cli compare --help
 ipa-cli scan --help

package/dist/src/cli.js

@@ -2,7 +2,7 @@
 import { Command } from "commander";
 import { registerActionsCommand } from "./commands/actions.js";
 import { registerAnalyzeCommand } from "./commands/analyze.js";
-import { registerAssetsCommand } from "./commands/assets.js";
+import { registerAssetsCommand, registerExtractCommand } from "./commands/assets.js";
 import { registerBaselineCommand } from "./commands/baseline.js";
 import { registerCompareCommand } from "./commands/compare.js";
 import { registerConvertCommand } from "./commands/convert.js";
@@ -10,6 +10,7 @@ import { registerDimensionAnalyzeCommand } from "./commands/dimension-analyze.js
 import { registerDoctorCommand } from "./commands/doctor.js";
 import { registerIpCommand } from "./commands/ip.js";
 import { registerKnowledgeCommand } from "./commands/knowledge.js";
+import { registerObfuscateCommand } from "./commands/obfuscate.js";
 import { registerScanCommand } from "./commands/scan.js";
 import { registerScanBatchCommand } from "./commands/scan-batch.js";
 import { registerScreenshotsCommand } from "./commands/screenshots.js";
@@ -20,10 +21,11 @@ const program = new Command();
 program
     .name("ipa-cli")
     .description("检查 IPA 的提审风险信号与相似性指标。")
-    .version("0.2.3")
+    .version("0.2.5")
     .showHelpAfterError();
 registerAnalyzeCommand(program);
 registerActionsCommand(program);
+registerExtractCommand(program);
 registerAssetsCommand(program);
 registerCompareCommand(program);
 registerConvertCommand(program);
@@ -31,6 +33,7 @@ registerDimensionAnalyzeCommand(program);
 registerDoctorCommand(program);
 registerIpCommand(program);
 registerKnowledgeCommand(program);
+registerObfuscateCommand(program);
 registerScanCommand(program);
 registerScanBatchCommand(program);
 registerScreenshotsCommand(program);

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,uBAAuB,CAAC;KACpC,OAAO,CAAC,OAAO,CAAC;KAChB,kBAAkB,EAAE,CAAC;AAExB,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,+BAA+B,CAAC,OAAO,CAAC,CAAC;AACzC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC3B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACpC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,MAAM,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAE5D,SAAS,mBAAmB,CAAC,IAAc;IACzC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC;IACzH,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,UAAU,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;QACnD,UAAU,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/commands/assets.d.ts

@@ -1,2 +1,3 @@
 import { Command } from "commander";
 export declare function registerAssetsCommand(program: Command): void;
+export declare function registerExtractCommand(program: Command): void;

package/dist/src/commands/assets.js

@@ -1,12 +1,16 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
 import { obfuscateImages, renderObfuscateReportText } from "../core/obfuscate/image-obfuscate.js";
+import { extractPackageResources, renderExtractPackageResourcesText } from "../core/package-resources.js";
 import { renderAssetsReviewText } from "../core/reporting/assets-review-text.js";
 import { renderAssetsReviewPanel } from "../core/reporting/panel.js";
 import { reviewAssetProjects } from "../core/review/assets-review.js";
 import { withProgress } from "../lib/progress.js";
 export function registerAssetsCommand(program) {
     const assets = program.command("assets").description("批量扫描静态图片风险并生成整改清单。");
+    configureExtractCommand(assets
+        .command("extract")
+        .description("提取 IPA 或 APK 包中的图片、字体资源，并输出应用摘要。"));
     assets
         .command("review")
         .description("扫描目录下的一个或多个项目，输出静态图片风险报告。")
@@ -81,6 +85,11 @@ export function registerAssetsCommand(program) {
         process.stdout.write(`${output}\n`);
     });
 }
+export function registerExtractCommand(program) {
+    configureExtractCommand(program
+        .command("extract")
+        .description("提取 IPA 或 APK 包中的图片、字体资源，并输出应用摘要。"));
+}
 function normalizeIntensity(value) {
     if (value === "low" || value === "high")
         return value;
@@ -89,6 +98,31 @@ function normalizeIntensity(value) {
 function normalizeScope(scope) {
     return scope === "cwd" ? "cwd" : "children";
 }
+function configureExtractCommand(command) {
+    command
+        .argument("<input>", "IPA 或 APK 文件路径")
+        .option("--output <dir>", "提取输出目录")
+        .option("--only <kind>", "提取类型：all|images|fonts", "all")
+        .option("--force", "输出目录非空时覆盖已有内容", false)
+        .option("--format <format>", "输出格式：text|json", "text")
+        .action(async (input, options) => {
+        const report = await withProgress("正在提取包内资源", options.format !== "json", async () => {
+            return await extractPackageResources(path.resolve(input), {
+                outputDir: options.output ? path.resolve(options.output) : undefined,
+                only: normalizeExtractKind(options.only),
+                force: options.force ?? false
+            });
+        });
+        const output = options.format === "json" ? JSON.stringify(report, null, 2) : renderExtractPackageResourcesText(report);
+        process.stdout.write(`${output}\n`);
+    });
+}
+function normalizeExtractKind(value) {
+    if (value === "images" || value === "fonts") {
+        return value;
+    }
+    return "all";
+}
 function parsePositiveInteger(value, fallback) {
     const parsed = Number.parseInt(value, 10);
     return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;

package/dist/src/commands/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/commands/assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAE3E,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2BAA2B,CAAC;SACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACxC,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,CAAC;SAC3D,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,CAAC;SAC1D,MAAM,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,CAAC;SAC1C,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA6B,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE;YAClF,OAAO,MAAM,mBAAmB,CAAC;gBAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC3B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpC,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzC,sBAAsB,EAAE,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;aACvE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,MAAM;YACvB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO;gBAC1B,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC;gBACjC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,wBAAwB,CAAC;SACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACxC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,CAAC;SAC1D,MAAM,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,CAAC;SAC1C,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA6B,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YAChE,OAAO,MAAM,mBAAmB,CAAC;gBAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC3B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpC,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACzC,sBAAsB,EAAE,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;aACvE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACxC,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,QAAQ,CAAC;SAC/D,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC;SAC9B,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;SACpC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC;SAChC,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,CAAC;SAC3C,MAAM,CAAC,WAAW,EAAE,oBAAoB,CAAC;SACzC,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;SAC3C,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAgC,EAAE,EAAE;QAC9D,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACtD,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,KAAK;YACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SACrE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAC/G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC;AAaD,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9C,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,QAAgB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/commands/assets.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/obfuscate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerObfuscateCommand(program: Command): void;

package/dist/src/commands/obfuscate.js

@@ -0,0 +1,50 @@
+import path from "node:path";
+import { loadFingerprintInput } from "./analyze.js";
+import { createObfuscationPlan, renderObfuscationPlan } from "../core/obfuscate/tech-obfuscate.js";
+export function registerObfuscateCommand(program) {
+    program
+        .command("obfuscate")
+        .description("针对不同技术栈生成 iOS 混淆方案，重点支持 Flutter、uni-app 等跨平台项目。")
+        .argument("[input]", "IPA 文件路径或指纹 JSON 路径；省略时需配合 --stack")
+        .option("--stack <stack>", "技术栈：auto|flutter|uni-app|react-native|hybrid|native-ios", "auto")
+        .option("--format <format>", "输出格式：text|json|markdown", "text")
+        .action(async (input, options) => {
+        const stack = normalizeStack(options.stack);
+        const format = normalizeFormat(options.format);
+        if (!input && stack === "auto") {
+            throw new Error("未提供输入时，必须使用 --stack 指定技术栈。");
+        }
+        const resolvedInputPath = input ? path.resolve(input) : undefined;
+        const fingerprint = resolvedInputPath
+            ? await loadFingerprintInput(resolvedInputPath, {
+                showProgress: resolvedInputPath.endsWith(".ipa") && format !== "json",
+                progressText: "正在分析技术栈并生成混淆方案"
+            })
+            : undefined;
+        const plan = createObfuscationPlan({
+            fingerprint,
+            sourcePath: resolvedInputPath,
+            requestedStack: stack
+        });
+        process.stdout.write(`${renderObfuscationPlan(plan, format)}\n`);
+    });
+}
+function normalizeStack(value) {
+    if (value === "auto" || value === "flutter" || value === "uni-app" || value === "react-native" || value === "hybrid" || value === "native-ios") {
+        return value;
+    }
+    if (value === "uniapp" || value === "uni") {
+        return "uni-app";
+    }
+    if (value === "reactnative" || value === "rn") {
+        return "react-native";
+    }
+    throw new Error(`不支持的技术栈: ${value}`);
+}
+function normalizeFormat(value) {
+    if (value === "text" || value === "json" || value === "markdown") {
+        return value;
+    }
+    throw new Error(`不支持的 obfuscate 输出格式: ${value}`);
+}
+//# sourceMappingURL=obfuscate.js.map

package/dist/src/commands/obfuscate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscate.js","sourceRoot":"","sources":["../../../src/commands/obfuscate.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAiD,MAAM,qCAAqC,CAAC;AAOlJ,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,QAAQ,CAAC,SAAS,EAAE,oCAAoC,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,EAAE,MAAM,CAAC;SAC5F,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,CAAC;SAC9D,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,OAAgC,EAAE,EAAE;QAC5E,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE/C,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,MAAM,WAAW,GAAG,iBAAiB;YACnC,CAAC,CAAC,MAAM,oBAAoB,CAAC,iBAAiB,EAAE;gBAC5C,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,MAAM;gBACrE,YAAY,EAAE,gBAAgB;aAC/B,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,IAAI,GAAG,qBAAqB,CAAC;YACjC,WAAW;YACX,UAAU,EAAE,iBAAiB;YAC7B,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAC/I,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/core/ip.js

@@ -118,7 +118,7 @@ async function resolvePublicIpLocationFromIpCn(ip, requestTextImpl) {
     const response = await requestPublicLocation(createPublicLocationUrl(ip), requestTextImpl, {
         "Cache-Control": "no-cache, no-store, max-age=0",
         Pragma: "no-cache",
-        "User-Agent": "Mozilla/5.0 (compatible; ipa-cli/0.2.3; +https://github.com/ChengYu08/ipa_cli)"
+        "User-Agent": "Mozilla/5.0 (compatible; ipa-cli/0.2.5; +https://github.com/ChengYu08/ipa_cli)"
     });
     const displayLocation = extractIpCnDisplayLocation(response.body);
     if (!displayLocation) {
@@ -135,7 +135,7 @@ async function resolvePublicIpLocationFromIpSb(ip, requestTextImpl) {
     const response = await requestPublicLocation(createPublicLocationFallbackUrl(ip), requestTextImpl, {
         "Cache-Control": "no-cache, no-store, max-age=0",
         Pragma: "no-cache",
-        "User-Agent": "ipa-cli/0.2.3"
+        "User-Agent": "ipa-cli/0.2.5"
     });
     let payload;
     try {

package/dist/src/core/obfuscate/tech-obfuscate.d.ts

@@ -0,0 +1,43 @@
+import type { AppFingerprint, TechProfile } from "../../models/fingerprint.js";
+export type ObfuscationStack = "flutter" | "uni-app" | "react-native" | "hybrid" | "native-ios" | "unknown";
+export type ObfuscationFormat = "text" | "json" | "markdown";
+type DetectionMode = "auto" | "manual";
+type DetectionConfidence = "high" | "medium" | "low";
+export interface ObfuscationPlanPhase {
+    title: string;
+    objective: string;
+    actions: string[];
+    commands: string[];
+    warnings: string[];
+    snippetLanguage?: string;
+    snippet?: string;
+}
+export interface ObfuscationPlanReference {
+    label: string;
+    url: string;
+}
+export interface ObfuscationPlan {
+    sourcePath?: string;
+    requestedStack: ObfuscationStack | "auto";
+    resolvedStack: ObfuscationStack;
+    detection: {
+        mode: DetectionMode;
+        baseProfile: TechProfile | "none";
+        confidence: DetectionConfidence;
+        reason: string;
+        signals: string[];
+    };
+    summary: string;
+    objective: string;
+    phases: ObfuscationPlanPhase[];
+    followUps: string[];
+    limitations: string[];
+    references: ObfuscationPlanReference[];
+}
+export declare function createObfuscationPlan(options: {
+    fingerprint?: AppFingerprint;
+    sourcePath?: string;
+    requestedStack?: ObfuscationStack | "auto";
+}): ObfuscationPlan;
+export declare function renderObfuscationPlan(plan: ObfuscationPlan, format: ObfuscationFormat): string;
+export {};