@chengyu08/ipa-cli 0.2.4 → 0.2.6

package/README.md

@@ -596,6 +596,7 @@ cp ./scripts/ipatool.env.example ./scripts/ipatool.env
 - `scan`：把目标样本与本地基线库做 Top N 检索
 - `smoke`：执行 `analyze + scan + Top1 compare` 的端到端冒烟检查
 - `upload`：使用 Apple Transporter 将 IPA 上传到 App Store Connect
+- `setup init`：一键安装 Codex / Claude / CodeGraph / RTK，并合并全局 skills / 插件快照
 - `actions init-ios-build`：初始化 GitHub Actions iOS 构建模板、签名目录和 Secrets 说明
 - `convert pdf-to-png`：将单个 PDF 文件转换为 PNG 图片
 - `convert png-to-pdf`：将单张 PNG 或目录内多张 PNG 合并为 PDF
@@ -820,6 +821,27 @@ ipa-cli upload ./dist/export --dry-run
 
 如果你已经提前配置了 `ASC_APPLE_ID` / `ASC_APP_PASSWORD` 或 `ASC_API_KEY` / `ASC_API_ISSUER` / `ASC_PRIVATE_KEY_FILE`，通常不再需要重复传认证参数。
 
+### `setup`
+
+为新机器初始化 agent 开发环境：缺失时安装 `codex` / `claude` / `codegraph` / `rtk`，并把包内置的全局 skills、Claude 插件快照合并到用户目录。已存在的工具会跳过安装，已有配置文件不会被覆盖。
+
+```bash
+ipa-cli setup init [--dry-run] [--format text|json]
+```
+
+示例：
+
+```bash
+ipa-cli setup init
+ipa-cli setup init --dry-run
+```
+
+如果需要在当前维护机器上刷新内置的全局 skills / 插件快照，可执行：
+
+```bash
+npm run setup:bundle
+```
+
 ### `actions`
 
 初始化 GitHub Actions iOS 构建模板，并生成签名材料目录、Secrets 模板和指导文档。
@@ -852,6 +874,20 @@ ipa-cli actions init-ios-build ./YourProject --bundle-id com.example.app --schem
 - `ci/github-actions/ios-build/secrets.example.env`
 - `ci/github-actions/ios-build/signing/`
 
+生成的 workflow 默认使用 `macos-latest`。Flutter 项目会安装 stable channel 的最新版本，并默认用 `flutter build ipa --release --export-options-plist=...` 打包；手动触发 workflow 时可以填写 `flutter_version` 固定 Flutter 版本，填写 `flutter_build_name` 固定版本名，留空就读取 `pubspec.yaml`。如果某个项目不适配 `flutter build ipa`，把 `flutter_build_mode` 切到 `xcodebuild-archive`，会改走 `flutter build ios --release --no-codesign` + `xcodebuild archive` / `xcodebuild -exportArchive`。需要指定 Xcode 时，可以填写 `xcode_path`，例如 `/Applications/Xcode_26.3.app`。
+
+最低心智操作：
+
+```bash
+ipa-cli actions init-ios-build ./YourProject
+# 把 .p12 放到 ci/github-actions/ios-build/signing/certs/
+# 把 .mobileprovision 放到 ci/github-actions/ios-build/signing/profiles/
+./ci/github-actions/ios-build/signing/scripts/print-secrets.sh
+./ci/github-actions/ios-build/signing/scripts/print-secrets.sh --apply
+```
+
+不带参数运行 `print-secrets.sh` 会自动识别目录里唯一的 `.p12` / `.mobileprovision`，询问一次 `.p12` 导出密码，然后把对应 key/value 写入 `ci/github-actions/ios-build/secrets.example.env`。`--apply` 会先同步这个文件，再用 GitHub CLI 直接写入 4 个 Repository secrets。没有 GitHub CLI 时，可以从 `secrets.example.env` 手动复制。
+
 其中 README 会明确写出：
 
 - `.cer`、`.p12`、`.mobileprovision` 分别放哪里

package/assets/setup/manifest.json

@@ -0,0 +1,9 @@
+{
+  "version": 1,
+  "generatedFrom": "current-machine-global-agent-state",
+  "notes": [
+    "payload.tar.gz contains bundled skills and Claude plugin snapshots",
+    "templates contain portable default configs for fresh Codex and Claude installs",
+    "existing configs are intentionally left untouched by setup init"
+  ]
+}

package/assets/setup/templates/claude/.claude.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "codegraph": {
+      "type": "stdio",
+      "command": "codegraph",
+      "args": [
+        "serve",
+        "--mcp"
+      ]
+    }
+  }
+}

package/assets/setup/templates/claude/CLAUDE.md

@@ -0,0 +1,12 @@
+@RTK.md
+
+<!-- CODEGRAPH_START -->
+## CodeGraph
+
+In repositories indexed by CodeGraph (a `.codegraph/` directory exists at the repo root), reach for it BEFORE grep/find or reading files when you need to understand or locate code:
+
+- **MCP tools** (when available): `codegraph_explore` answers most code questions in one call — the relevant symbols' verbatim source plus the call paths between them. `codegraph_node` returns one symbol's source + callers, or reads a whole file with line numbers. If the tools are listed but deferred, load them by name via tool search.
+- **Shell** (always works): `codegraph explore "<symbol names or question>"` and `codegraph node <symbol-or-file>` print the same output.
+
+If there is no `.codegraph/` directory, skip CodeGraph entirely — indexing is the user's decision.
+<!-- CODEGRAPH_END -->

package/assets/setup/templates/claude/RTK.md

@@ -0,0 +1,29 @@
+# RTK - Rust Token Killer
+
+**Usage**: Token-optimized CLI proxy (60-90% savings on dev operations)
+
+## Meta Commands (always use rtk directly)
+
+```bash
+rtk gain              # Show token savings analytics
+rtk gain --history    # Show command usage history with savings
+rtk discover          # Analyze Claude Code history for missed opportunities
+rtk proxy <cmd>       # Execute raw command without filtering (for debugging)
+```
+
+## Installation Verification
+
+```bash
+rtk --version         # Should show: rtk X.Y.Z
+rtk gain              # Should work (not "command not found")
+which rtk             # Verify correct binary
+```
+
+⚠️ **Name collision**: If `rtk gain` fails, you may have reachingforthejack/rtk (Rust Type Kit) installed instead.
+
+## Hook-Based Usage
+
+All other commands are automatically rewritten by the Claude Code hook.
+Example: `git status` → `rtk git status` (transparent, 0 tokens overhead)
+
+Refer to CLAUDE.md for full command reference.

package/assets/setup/templates/claude/settings.json

@@ -0,0 +1,32 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "mcp__codegraph__codegraph_explore",
+      "mcp__codegraph__codegraph_search",
+      "mcp__codegraph__codegraph_node",
+      "mcp__codegraph__codegraph_callers",
+      "mcp__codegraph__codegraph_callees",
+      "mcp__codegraph__codegraph_impact",
+      "mcp__codegraph__codegraph_files",
+      "mcp__codegraph__codegraph_status"
+    ]
+  },
+  "enabledPlugins": {
+    "swift-lsp@claude-plugins-official": true
+  },
+  "effortLevel": "high",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "rtk hook claude"
+          }
+        ]
+      }
+    ]
+  }
+}

package/assets/setup/templates/codex/AGENTS.md

@@ -0,0 +1,12 @@
+@RTK.md
+
+<!-- CODEGRAPH_START -->
+## CodeGraph
+
+In repositories indexed by CodeGraph (a `.codegraph/` directory exists at the repo root), reach for it BEFORE grep/find or reading files when you need to understand or locate code:
+
+- **MCP tools** (when available): `codegraph_explore` answers most code questions in one call — the relevant symbols' verbatim source plus the call paths between them. `codegraph_node` returns one symbol's source + callers, or reads a whole file with line numbers. If the tools are listed but deferred, load them by name via tool search.
+- **Shell** (always works): `codegraph explore "<symbol names or question>"` and `codegraph node <symbol-or-file>` print the same output.
+
+If there is no `.codegraph/` directory, skip CodeGraph entirely — indexing is the user's decision.
+<!-- CODEGRAPH_END -->

package/assets/setup/templates/codex/RTK.md

@@ -0,0 +1,32 @@
+# RTK - Rust Token Killer (Codex CLI)
+
+**Usage**: Token-optimized CLI proxy for shell commands.
+
+## Rule
+
+Always prefix shell commands with `rtk`.
+
+Examples:
+
+```bash
+rtk git status
+rtk cargo test
+rtk npm run build
+rtk pytest -q
+```
+
+## Meta Commands
+
+```bash
+rtk gain            # Token savings analytics
+rtk gain --history  # Recent command savings history
+rtk proxy <cmd>     # Run raw command without filtering
+```
+
+## Verification
+
+```bash
+rtk --version
+rtk gain
+which rtk
+```

package/assets/setup/templates/codex/config.toml

@@ -0,0 +1,38 @@
+model_provider = "xai"
+model = "gpt-5.4"
+model_reasoning_effort = "xhigh"
+plan_mode_reasoning_effort = "xhigh"
+model_reasoning_summary = "none"
+model_context_window = 1050000
+model_auto_compact_token_limit = 945000
+stream_idle_timeout_ms = 900000
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+suppress_unstable_features_warning = true
+personality = "pragmatic"
+
+[model_providers.xai]
+name = "OpenAI"
+base_url = "https://api.xairouter.com"
+wire_api = "responses"
+requires_openai_auth = false
+env_key = "XAI_API_KEY"
+supports_websockets = true
+
+[features]
+responses_websockets_v2 = true
+remote_connections = true
+js_repl = false
+memories = true
+
+[desktop]
+localeOverride = "zh-CN"
+
+[memories]
+generate_memories = true
+use_memories = true
+disable_on_external_context = true
+
+[mcp_servers.codegraph]
+command = "codegraph"
+args = ["serve", "--mcp"]

package/dist/src/cli.js

@@ -10,18 +10,20 @@ 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 { registerNamingCommand } from "./commands/naming.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";
 import { registerSchemaCommand } from "./commands/schema.js";
 import { registerSmokeCommand } from "./commands/smoke.js";
+import { registerSetupCommand } from "./commands/setup.js";
 import { registerUploadCommand } from "./commands/upload.js";
 const program = new Command();
 program
     .name("ipa-cli")
     .description("检查 IPA 的提审风险信号与相似性指标。")
-    .version("0.2.4")
+    .version("0.2.5")
     .showHelpAfterError();
 registerAnalyzeCommand(program);
 registerActionsCommand(program);
@@ -33,6 +35,7 @@ registerDimensionAnalyzeCommand(program);
 registerDoctorCommand(program);
 registerIpCommand(program);
 registerKnowledgeCommand(program);
+registerNamingCommand(program);
 registerObfuscateCommand(program);
 registerScanCommand(program);
 registerScanBatchCommand(program);
@@ -40,6 +43,7 @@ registerScreenshotsCommand(program);
 registerSchemaCommand(program);
 registerSmokeCommand(program);
 registerBaselineCommand(program);
+registerSetupCommand(program);
 registerUploadCommand(program);
 await program.parseAsync(normalizeLegacyArgv(process.argv));
 function normalizeLegacyArgv(argv) {

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":"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"}

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

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

package/dist/src/commands/naming.js

@@ -0,0 +1,51 @@
+import { generateRandomNamingEntries } from "../core/naming.js";
+import { formatPanel } from "../core/reporting/terminal.js";
+export function registerNamingCommand(program) {
+    program
+        .command("naming")
+        .description("随机生成包名与英文应用项目名。")
+        .option("--count <n>", "生成数量，默认 1", "1")
+        .option("--prefix <prefix>", "bundle 前缀，默认 com", "com")
+        .option("--format <format>", "输出格式：text|json", "text")
+        .action(async (options) => {
+        const format = normalizeFormat(options.format);
+        const count = normalizePositiveInteger(options.count, 1);
+        const items = generateRandomNamingEntries({
+            count,
+            prefix: options.prefix
+        });
+        if (format === "json") {
+            process.stdout.write(`${JSON.stringify({
+                count,
+                items
+            }, null, 2)}\n`);
+            return;
+        }
+        process.stdout.write(`${renderNamingText(items)}\n`);
+    });
+}
+function renderNamingText(items) {
+    return items
+        .map((item, index) => formatPanel(items.length === 1 ? "随机命名" : `随机命名 #${index + 1}`, [
+        ["Bundle ID", item.bundleId],
+        ["Project Name", item.projectName]
+    ]))
+        .join("\n\n");
+}
+function normalizeFormat(value) {
+    if (value === "json") {
+        return "json";
+    }
+    return "text";
+}
+function normalizePositiveInteger(value, fallback) {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`count 必须是正整数: ${value}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=naming.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../src/commands/naming.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAA0B,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAU5D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,CAAC;SACvC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,CAAC;SACtD,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,2BAA2B,CAAC;YACxC,KAAK;YACL,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CACf;gBACE,KAAK;gBACL,KAAK;aACN,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA0B;IAClD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,WAAW,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE,EAAE;QAC9D,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC5B,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC;KACnC,CAAC,CACH;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAyB,EAAE,QAAgB;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

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

package/dist/src/commands/setup.js

@@ -0,0 +1,32 @@
+import { renderSetupReport, setupMachineEnvironment } from "../core/setup.js";
+export function registerSetupCommand(program) {
+    const setup = program.command("setup").description("初始化新机器上的 Codex / Claude / CodeGraph / RTK 及全局 skills。");
+    setup
+        .command("init")
+        .description("一键安装缺失工具，并合并全局 skills / 插件快照；已有工具不覆盖原配置。")
+        .option("--dry-run", "只输出计划，不执行安装或写文件", false)
+        .option("--format <format>", "输出格式：text|json", "text")
+        .action(async (options) => {
+        const format = normalizeSetupFormat(options.format);
+        const report = await setupMachineEnvironment({
+            dryRun: options.dryRun ?? false,
+            format
+        });
+        if (format === "json") {
+            process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(`${renderSetupReport(report)}\n`);
+        }
+        if (report.tools.some((tool) => tool.action === "failed")) {
+            process.exitCode = 1;
+        }
+    });
+}
+function normalizeSetupFormat(value) {
+    if (value === "text" || value === "json") {
+        return value;
+    }
+    throw new Error(`不支持的 setup 输出格式: ${value}`);
+}
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/commands/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAoB,MAAM,kBAAkB,CAAC;AAOhG,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,uDAAuD,CAAC,CAAC;IAE5G,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC;SAC7C,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;YAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC"}