@tomflow/proflow-platform-cli 0.1.39 → 0.1.41

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-platform-cli
 
+## 0.1.41
+
+### Patch Changes
+
+- Harden Deployment Closeout: fail closed on partial installs and package-manager conflicts, normalize Git workspace isolation, make Dev Tunnel status fast and resumable without fabricating login failures, and align Browser Extension setup/conformance behavior.
+
+## 0.1.40
+
+### Patch Changes
+
+- Ignore governed non-Module tool packages during Registry module discovery so Fresh install remains fixed at 23 active modules.
+
 ## 0.1.39
 
 ### Patch Changes

package/dist/deployment/adapter.d.ts

@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.39";
+            readonly moduleVersion: "0.1.40";
         };
         observedEffects: never[];
     }>;
@@ -16,7 +16,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.39";
+            readonly moduleVersion: "0.1.40";
         };
         observedEffects: never[];
     }>;
@@ -26,7 +26,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.39";
+            moduleVersion: "0.1.40";
             data: {
                 readonly setupStatus: "READY";
                 readonly runtimeStatus: "NOT_APPLICABLE";
@@ -40,7 +40,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.39";
+            readonly moduleVersion: "0.1.40";
         };
         observedEffects: never[];
     }>;
@@ -50,7 +50,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.39";
+            moduleVersion: "0.1.40";
             data: {
                 docs: string;
             };
@@ -63,7 +63,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.39";
+            readonly moduleVersion: "0.1.40";
         };
         observedEffects: never[];
     }>;
@@ -73,7 +73,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "platform-cli";
-            readonly moduleVersion: "0.1.39";
+            readonly moduleVersion: "0.1.40";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "platform-cli";
     readonly packageName: "@tomflow/proflow-platform-cli";
-    readonly moduleVersion: "0.1.39";
+    readonly moduleVersion: "0.1.40";
     readonly kind: "cli";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "platform-cli",
     packageName: "@tomflow/proflow-platform-cli",
-    moduleVersion: "0.1.39",
+    moduleVersion: "0.1.40",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 import { readFile, realpath, stat } from "node:fs/promises";
 import { resolve } from "node:path";
-import { moduleDocsDataSchema, moduleSetupPlanDataSchema, moduleStatusObservationSchema, readModuleSharedFacts, } from "@tomflow/proflow-module-contract";
+import { moduleDocsDataSchema, moduleSetupPlanDataSchema, moduleStatusObservationSchema, } from "@tomflow/proflow-module-contract";
 import { descriptor as platformCliDescriptor } from "../deployment/descriptor.js";
+import { FROZEN_DEPLOYMENT_INSTALL_ORDER } from "./deployment-order.js";
 import { AutoModuleCatalog, discoverModules } from "./discovery/discover.js";
 import { InstalledModuleCatalog } from "./discovery/installed.js";
 import { PlatformError } from "./errors.js";
-import { observeWorkspaceInstalledVersion, removeWorkspacePackages, syncWorkspacePackages, } from "./install/package-manager.js";
+import { observeWorkspaceInstalledVersion, preflightWorkspacePackageManager, removeWorkspacePackages, syncWorkspacePackages, } from "./install/package-manager.js";
 import { cleanOwnedPnpmPolicy, observeMinimumReleaseAgeExclude, recordPnpmPolicyOwnership, } from "./install/pnpm-policy.js";
 import { installModulesThin, observeDocs, observeStatuses, setupModulesThin, startModulesThin, stopModulesThin, uninstallModulesThin, } from "./lifecycle/index.js";
+import { ensureWorkspaceStateIsGitIgnored } from "./persistence/git-isolation.js";
 import { ensureWorkspaceMetadata } from "./persistence/workspace-metadata.js";
 import { reportProgress } from "./progress.js";
 import { discoverRegistryModules, PRO_FLOW_PACKAGE_PREFIX, } from "./registry/index.js";
@@ -23,6 +25,25 @@ const COMMANDS = [
     "start",
     "stop",
 ];
+function editDistance(left, right) {
+    const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+    for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
+        const current = [leftIndex];
+        for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
+            current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (previous[rightIndex] ?? 0) + 1, (previous[rightIndex - 1] ?? 0) +
+                (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1));
+        }
+        previous.splice(0, previous.length, ...current);
+    }
+    return previous[right.length] ?? Number.POSITIVE_INFINITY;
+}
+function commandSuggestion(raw) {
+    const ranked = COMMANDS.map((command) => ({
+        command,
+        distance: editDistance(raw.toLowerCase(), command),
+    })).sort((left, right) => left.distance - right.distance);
+    return ranked[0] && ranked[0].distance <= 2 ? ranked[0].command : undefined;
+}
 function parseArgs(argv) {
     let workspace, moduleRef;
     let special;
@@ -68,8 +89,12 @@ function parseArgs(argv) {
     if (positional.length !== 1)
         throw new PlatformError("INVALID_REQUEST", "commands accept no positional arguments");
     const raw = positional[0] ?? "";
-    if (!COMMANDS.includes(raw))
-        throw new PlatformError("INVALID_REQUEST", `unknown command ${raw}`);
+    if (!COMMANDS.includes(raw)) {
+        const suggestion = commandSuggestion(raw);
+        throw new PlatformError("INVALID_REQUEST", suggestion
+            ? `未知命令 ${raw}。你是否想运行 platform ${suggestion}？`
+            : `未知命令 ${raw}。运行 platform --help 查看可用命令。`);
+    }
     const command = raw;
     if (moduleRef !== undefined && command !== "setup" && command !== "docs")
         throw new PlatformError("INVALID_REQUEST", "--module is only valid with setup or docs");
@@ -132,17 +157,24 @@ function batchStatus(result) {
         return "ACTION_REQUIRED";
     return "FAILED";
 }
-async function handleStatus(root, runtime) {
-    reportProgress(runtime.onProgress, {
-        command: "status",
-        phase: "status",
-        status: "STARTED",
-        message: "正在读取模块状态",
-    });
-    const { catalog, modules } = await buildContext(root);
+function missingFrozenModules(modules) {
+    const observed = new Set(modules.map((module) => module.moduleRef));
+    const hasCurrentPlatformSurface = FROZEN_DEPLOYMENT_INSTALL_ORDER.some((moduleRef) => observed.has(moduleRef));
+    if (!hasCurrentPlatformSurface)
+        return [];
+    return FROZEN_DEPLOYMENT_INSTALL_ORDER.filter((moduleRef) => !observed.has(moduleRef));
+}
+function assertInstalledModules(modules) {
+    if (modules.length === 0)
+        throw new PlatformError("PLATFORM_NOT_INSTALLED", "ProFlow 尚未安装。请先运行 platform install。");
+    const missing = missingFrozenModules(modules);
+    if (missing.length > 0)
+        throw new PlatformError("PLATFORM_INSTALL_INCOMPLETE", `ProFlow 安装不完整，缺少 ${missing.length} 个核心模块。请重新运行 platform install。`);
+}
+async function collectModuleStatuses(catalog, modules, root) {
     const observed = await observeStatuses(catalog, modules, root);
     const byRef = new Map(modules.map((module) => [module.moduleRef, module]));
-    const output = observed.map((item) => {
+    return observed.map((item) => {
         if (item.result.status !== "SUCCEEDED")
             throw new PlatformError("COMMAND_FAILED", `module ${item.moduleRef} status observation did not return SUCCEEDED`);
         const parsed = moduleStatusObservationSchema.safeParse(item.result.data);
@@ -164,13 +196,54 @@ async function handleStatus(root, runtime) {
                 : { externalAvailabilityClaim: item.externalAvailabilityClaim }),
         };
     });
+}
+async function handleStatus(root, runtime) {
+    reportProgress(runtime.onProgress, {
+        command: "status",
+        phase: "status",
+        status: "STARTED",
+        message: "正在读取模块状态",
+    });
+    const { catalog, modules } = await buildContext(root);
+    if (modules.length === 0) {
+        reportProgress(runtime.onProgress, {
+            command: "status",
+            phase: "status",
+            status: "SUCCEEDED",
+            message: "ProFlow 尚未安装",
+        });
+        return outcome("status", "SUCCEEDED", root, {
+            installed: false,
+            installState: "NOT_INSTALLED",
+            modules: [],
+        });
+    }
+    const missing = missingFrozenModules(modules);
+    if (missing.length > 0) {
+        reportProgress(runtime.onProgress, {
+            command: "status",
+            phase: "status",
+            status: "SUCCEEDED",
+            message: `ProFlow 安装不完整，缺少 ${missing.length} 个核心模块`,
+        });
+        return outcome("status", "SUCCEEDED", root, {
+            installed: true,
+            installState: "INCOMPLETE",
+            missingModules: missing,
+            modules: [],
+        });
+    }
+    const output = await collectModuleStatuses(catalog, modules, root);
     reportProgress(runtime.onProgress, {
         command: "status",
         phase: "status",
         status: "SUCCEEDED",
         message: `已读取 ${output.length} 个模块状态`,
     });
-    return outcome("status", "SUCCEEDED", root, { modules: output });
+    return outcome("status", "SUCCEEDED", root, {
+        installed: true,
+        modules: output,
+    });
 }
 async function handleDocs(root, parsed, runtime) {
     reportProgress(runtime.onProgress, {
@@ -268,6 +341,7 @@ async function handleInstall(root, runtime) {
         status: "STARTED",
         message: "正在校验 Workspace",
     });
+    const gitIsolation = await ensureWorkspaceStateIsGitIgnored(root);
     const metadata = await ensureWorkspaceMetadata(root);
     reportProgress(runtime.onProgress, {
         command: "install",
@@ -298,6 +372,7 @@ async function handleInstall(root, runtime) {
             command: "install",
             phase: "registry",
             kind: "detail",
+            retention: "REPLACE",
             status: "SUCCEEDED",
             current,
             total,
@@ -352,6 +427,7 @@ async function handleInstall(root, runtime) {
     await recordPnpmPolicyOwnership(root, pnpmPolicyBefore);
     await validateInstalledPackageSet(root, discovered.candidates, previousManaged);
     const { catalog, modules } = await buildContext(root);
+    assertInstalledModules(modules);
     reportProgress(runtime.onProgress, {
         command: "install",
         phase: "validation",
@@ -368,11 +444,12 @@ async function handleInstall(root, runtime) {
             version: item.moduleVersion,
         })),
         workspace: metadata,
+        gitIsolation,
         modules: moduleInstall,
         next: "platform status",
     });
 }
-const usefulPackageOutput = /(?:resolved|downloaded|reused|linked|added|removed|packages:|progress:|warn|warning|error|ERR_|done|completed|audited|changed)/i;
+const usefulPackageOutput = /(?:warn|warning|error|ERR_)/i;
 function reportPackageManagerOutput(runtime, command, output) {
     if (!usefulPackageOutput.test(output.line))
         return;
@@ -415,6 +492,8 @@ async function workspaceProFlowDependencies(root) {
 }
 async function handleUninstall(root, runtime) {
     const packageNames = await workspaceProFlowDependencies(root);
+    if (packageNames.length > 0)
+        await preflightWorkspacePackageManager(root, runtime.executableAvailable);
     const { catalog, modules } = await buildContext(root);
     const moduleUninstall = await uninstallModulesThin(catalog, modules, root, runtime.onProgress);
     if (!moduleUninstall.completed)
@@ -450,6 +529,7 @@ async function handleSetup(root, parsed, runtime) {
         message: "正在分析模块配置",
     });
     const { catalog, modules } = await buildContext(root);
+    assertInstalledModules(modules);
     const interaction = runtime.setupInteraction;
     const inputByModule = new Map();
     const approvedSteps = new Set();
@@ -475,24 +555,17 @@ async function handleSetup(root, parsed, runtime) {
         const action = actionable?.result.actionRequired;
         if (!actionable || !action)
             break;
-        let modelIds;
-        if (actionable.moduleRef === "model-runtime") {
-            const facts = await readModuleSharedFacts({ workspaceRoot: root }, "model-provider-api");
-            const inventory = facts?.models;
-            if (Array.isArray(inventory))
-                modelIds = inventory.flatMap((item) => {
-                    if (typeof item === "string")
-                        return [item];
-                    if (isRecord(item) && typeof item.id === "string")
-                        return [item.id];
-                    return [];
-                });
-        }
+        const actionData = isRecord(actionable.result.data)
+            ? actionable.result.data
+            : undefined;
+        const options = Array.isArray(actionData?.candidates)
+            ? actionData.candidates.filter((item) => typeof item === "string")
+            : undefined;
         const collected = await interaction.collect({
             moduleRef: actionable.moduleRef,
             action: action.action,
             description: action.description,
-            ...(modelIds?.length ? { modelIds } : {}),
+            ...(options?.length ? { options } : {}),
         });
         if (!collected)
             break;
@@ -516,8 +589,10 @@ async function handleSetup(root, parsed, runtime) {
         status: result.completed ? "SUCCEEDED" : "ACTION_REQUIRED",
         message: result.completed ? "模块配置已就绪" : "配置清单已生成",
     });
+    const moduleStatuses = await collectModuleStatuses(catalog, modules, root);
     return outcome("setup", batchStatus(result), root, {
         ...result,
+        moduleStatuses,
         ...(parsed.moduleRef === undefined
             ? {}
             : { targetModuleRef: parsed.moduleRef }),
@@ -525,6 +600,7 @@ async function handleSetup(root, parsed, runtime) {
 }
 async function handleStart(root, runtime) {
     const { catalog, modules } = await buildContext(root);
+    assertInstalledModules(modules);
     const result = await startModulesThin(catalog, modules, root, runtime.onProgress);
     return outcome("start", batchStatus(result), root, result);
 }
@@ -628,87 +704,112 @@ function humanTheme(options = {}) {
         failure: (value) => paint("red", value),
     };
 }
+function journeyState(entries) {
+    if (entries.length === 0 ||
+        entries.some((item) => item.setupStatus === "FAILED" || item.runtimeStatus === "FAILED"))
+        return "FAILED";
+    if (entries.some((item) => item.setupStatus === "ACTION_REQUIRED"))
+        return "ACTION_REQUIRED";
+    if (entries.some((item) => item.setupStatus === "BLOCKED"))
+        return "BLOCKED";
+    return entries.every((item) => item.setupStatus === "READY")
+        ? "READY"
+        : "BLOCKED";
+}
+function setupJourney(modules) {
+    const byRef = new Map(modules.map((item) => [String(item.moduleRef), item]));
+    return [
+        { label: "浏览器扩展", refs: ["execution-browser-extension"] },
+        { label: "远程连接", refs: ["dev-tunnel"] },
+        {
+            label: "模型服务与 FAST / THINK",
+            refs: ["model-provider-api", "model-runtime"],
+        },
+    ].map(({ label, refs }) => {
+        const entries = refs.flatMap((ref) => {
+            const item = byRef.get(ref);
+            return item ? [item] : [];
+        });
+        const issues = entries.flatMap((item) => Array.isArray(item.issues) ? item.issues.filter(isRecord) : []);
+        return {
+            label,
+            state: journeyState(entries),
+            modules: entries,
+            ...(issues[0] ? { issue: issues[0] } : {}),
+        };
+    });
+}
 function renderStatus(data, theme) {
     if (!isRecord(data) || !Array.isArray(data.modules))
-        return "未发现模块。";
-    const setupLabels = {
-        READY: "已就绪",
-        ACTION_REQUIRED: "需要操作",
-        BLOCKED: "等待依赖",
-        FAILED: "失败",
-    };
-    const runtimeLabels = {
-        RUNNING: "运行中",
-        STOPPED: "已停止",
-        FAILED: "运行失败",
-        NOT_APPLICABLE: "无独立进程",
-    };
+        return "无法读取状态。";
     const modules = data.modules.filter(isRecord);
-    const productOrder = new Map([
-        ["execution-browser-extension", 0],
-        ["dev-tunnel", 1],
-        ["model-provider-api", 2],
-    ]);
-    const orderedProblems = (entries) => [...entries].sort((a, b) => (productOrder.get(String(a.moduleRef)) ?? 100) -
-        (productOrder.get(String(b.moduleRef)) ?? 100));
-    const failedModules = modules.filter((item) => item.setupStatus === "FAILED" || item.runtimeStatus === "FAILED");
-    const actionModules = orderedProblems(modules.filter((item) => item.setupStatus === "ACTION_REQUIRED" &&
-        item.runtimeStatus !== "FAILED"));
-    const blockedModules = orderedProblems(modules.filter((item) => item.setupStatus === "BLOCKED" && item.runtimeStatus !== "FAILED"));
-    const running = modules.filter((item) => item.setupStatus === "READY" && item.runtimeStatus === "RUNNING");
-    const healthy = modules.filter((item) => item.setupStatus === "READY" &&
-        item.runtimeStatus !== "RUNNING" &&
-        item.runtimeStatus !== "FAILED");
-    const lines = [theme.title("ProFlow 状态"), ""];
-    const renderProblems = (title, entries, tone, icon) => {
-        if (entries.length === 0)
-            return;
-        lines.push(theme.section(title), "");
-        for (const raw of entries) {
-            const moduleRef = String(raw.moduleRef);
-            const setupStatus = String(raw.setupStatus);
-            const runtimeStatus = String(raw.runtimeStatus);
-            const runtimeLabel = raw.externalAvailabilityClaim === "AVAILABLE"
-                ? "外部资源可用"
-                : (runtimeLabels[runtimeStatus] ?? "未知");
-            lines.push(`${tone(icon)} ${theme.section(moduleRef)}  ${theme.muted(String(raw.version))}`);
-            lines.push(`  ${tone(setupLabels[setupStatus] ?? "未知")} · ${runtimeLabel}`);
-            const issues = Array.isArray(raw.issues)
-                ? raw.issues.filter(isRecord)
-                : [];
-            for (const issue of issues) {
-                lines.push(`  原因：${String(issue.message)}`);
-                if (Array.isArray(issue.relatedModuleRefs) &&
-                    issue.relatedModuleRefs.length > 0)
-                    lines.push(`  依赖：${issue.relatedModuleRefs.map(String).join("、")}`);
-                if (setupStatus !== "BLOCKED")
-                    lines.push(`  下一步：${theme.command(String(issue.nextCommand))}`);
-            }
-            lines.push("");
-        }
-    };
-    renderProblems("失败", failedModules, theme.failure, "✕");
-    renderProblems("需要操作", actionModules, theme.warning, "◆");
-    renderProblems("等待依赖", blockedModules, theme.info, "◇");
-    const compact = (title, entries, symbol) => {
-        if (entries.length === 0)
-            return;
-        lines.push(theme.section(title), "");
-        for (const item of entries) {
-            const runtime = item.externalAvailabilityClaim === "AVAILABLE"
-                ? "外部资源可用"
-                : (runtimeLabels[String(item.runtimeStatus)] ?? "未知");
-            lines.push(`${theme.success(symbol)} ${String(item.moduleRef).padEnd(32)} ${theme.muted(String(item.version).padEnd(9))} ${runtime}`);
+    if (data.installState === "INCOMPLETE") {
+        const missing = Array.isArray(data.missingModules)
+            ? data.missingModules.filter((item) => typeof item === "string")
+            : [];
+        return [
+            theme.title("ProFlow 状态"),
+            "",
+            theme.warning("ProFlow 安装不完整。"),
+            ...(missing.length > 0 ? [`缺少 ${missing.length} 个核心模块。`] : []),
+            `下一步：${theme.command("platform install")}`,
+            "",
+            "PLATFORM_READY=NO",
+        ].join("\n");
+    }
+    if (data.installed === false || modules.length === 0)
+        return [
+            theme.title("ProFlow 状态"),
+            "",
+            theme.warning("ProFlow 尚未安装。"),
+            `下一步：${theme.command("platform install")}`,
+            "",
+            "PLATFORM_READY=NO",
+        ].join("\n");
+    const journey = setupJourney(modules);
+    const completed = journey.filter((step) => step.state === "READY").length;
+    const current = journey.find((step) => step.state !== "READY");
+    const running = modules.filter((item) => item.runtimeStatus === "RUNNING");
+    const platformReady = modules.every((item) => item.setupStatus === "READY" && item.runtimeStatus !== "FAILED");
+    const internalProblem = modules.find((item) => item.setupStatus !== "READY" || item.runtimeStatus === "FAILED");
+    const lines = [
+        theme.title("ProFlow 状态"),
+        "",
+        `${theme.section("配置进度")}  ${completed}/3`,
+        ...journey.map((step, index) => {
+            const marker = step.state === "READY"
+                ? theme.success("✓")
+                : step === current
+                    ? step.state === "FAILED"
+                        ? theme.failure("✕")
+                        : theme.warning("→")
+                    : theme.muted("○");
+            const label = step.state === "READY"
+                ? "已完成"
+                : step === current
+                    ? step.state === "FAILED"
+                        ? "验证失败"
+                        : "当前步骤"
+                    : "后续步骤";
+            return `${marker} ${index + 1}/3 ${step.label} · ${label}`;
+        }),
+    ];
+    if (current) {
+        lines.push("", theme.section(`当前处理：${current.label}`));
+        if (current.issue?.message)
+            lines.push(`原因：${String(current.issue.message)}`);
+        lines.push(`下一步：${theme.command("platform setup")}`);
+    }
+    else {
+        lines.push("", theme.success("三个核心配置步骤均已完成。"));
+        if (internalProblem) {
+            const issue = Array.isArray(internalProblem.issues)
+                ? internalProblem.issues.filter(isRecord)[0]
+                : undefined;
+            lines.push(theme.warning("仍有内部能力尚未闭环。"), ...(issue?.message ? [`原因：${String(issue.message)}`] : []), `下一步：${theme.command("platform setup")}`);
         }
-        lines.push("");
-    };
-    compact("运行中", running, "●");
-    compact("已就绪", healthy, "○");
-    const ready = healthy.length + running.length;
-    const action = modules.filter((item) => item.setupStatus === "ACTION_REQUIRED" && item.runtimeStatus !== "FAILED").length;
-    const failed = failedModules.length;
-    const blocked = modules.filter((item) => item.setupStatus === "BLOCKED" && item.runtimeStatus !== "FAILED").length;
-    lines.push(theme.section("汇总"), `${theme.success(`${ready} 配置已完成`)} · ${theme.warning(`${action} 根阻塞`)} · ${theme.info(`${blocked} 下游等待`)} · ${failed > 0 ? theme.failure(`${failed} 失败`) : `${failed} 失败`} · ${running.length} 个真实进程运行中`, `PLATFORM_READY=${action === 0 && blocked === 0 && failed === 0 ? "YES" : "NO"}`);
+    }
+    lines.push("", `${running.length} 个真实服务进程运行中`, `PLATFORM_READY=${platformReady ? "YES" : "NO"}`);
     return lines.join("\n");
 }
 function renderTerminalMarkdown(source, theme) {
@@ -742,15 +843,19 @@ function renderDocs(data, theme) {
     if (!isRecord(data) || !Array.isArray(data.modules))
         return "未发现模块文档。";
     if (data.indexOnly === true) {
-        const modules = data.modules.filter(isRecord);
         return [
             theme.title("ProFlow 帮助"),
             "",
-            "先运行 platform status 查看当前状态；需要某项详细说明时使用：",
-            `  ${theme.command("platform docs --module <模块名>")}`,
+            "ProFlow 会自动完成内部模块的安装、依赖准备和验证。",
             "",
-            theme.section(`可用文档（${modules.length}）`),
-            ...modules.map((item) => `  ${String(item.moduleRef).padEnd(34)} ${theme.muted(String(item.version ?? ""))}`),
+            theme.section("推荐流程"),
+            `  ${theme.command("platform install")}`,
+            `  ${theme.command("platform setup")}`,
+            `  ${theme.command("platform start")}`,
+            "",
+            theme.section("当前需要帮助？"),
+            `  运行 ${theme.command("platform status")} 查看唯一的下一步。`,
+            `  配置未完成时运行 ${theme.command("platform setup")} 继续向导。`,
         ].join("\n");
     }
     const lines = [theme.title("ProFlow 模块文档")];
@@ -794,7 +899,10 @@ function renderSetup(data, theme) {
         else
             needsAction += 1;
         lines.push(`${status === "FAILED" ? theme.failure("✕") : theme.warning("◆")} ${theme.section(setupModuleLabel(moduleRef))}`);
-        const plan = moduleSetupPlanDataSchema.safeParse(raw.result.data);
+        const planData = isRecord(raw.result.data) && Array.isArray(raw.result.data.steps)
+            ? { steps: raw.result.data.steps }
+            : raw.result.data;
+        const plan = moduleSetupPlanDataSchema.safeParse(planData);
         if (plan.success) {
             const currentStep = plan.data.steps.find((step) => step.state === "BLOCKED") ??
                 plan.data.steps.find((step) => step.state === "TODO");
@@ -841,19 +949,38 @@ function renderSetup(data, theme) {
     const dependencyBlockers = Array.isArray(data.blockers)
         ? data.blockers.filter(isRecord)
         : [];
-    for (const item of dependencyBlockers) {
+    for (const item of dependencyBlockers.slice(0, 1)) {
         const moduleRef = String(item.moduleRef ?? "unknown");
         if (renderedModuleRefs.has(moduleRef))
             continue;
         blocked += 1;
-        lines.push(`${theme.info("◇")} ${theme.section(moduleRef)}`, `  原因：${typeof item.reason === "string" ? item.reason : "等待上游 Module 就绪"}`, `  下一步：${theme.command(typeof item.nextCommand === "string" ? item.nextCommand : `platform setup --module ${moduleRef}`)}`, "");
+        lines.push(`${theme.info("◇")} ${theme.section(setupModuleLabel(moduleRef))}`, `  原因：${typeof item.reason === "string" ? item.reason : "等待上游 Module 就绪"}`, `  下一步：${theme.command("platform setup")}`, "");
     }
     const targetModuleRef = typeof data.targetModuleRef === "string" ? data.targetModuleRef : undefined;
     if (needsAction === 0 && blocked === 0)
         lines.push(targetModuleRef
             ? `${setupModuleLabel(targetModuleRef)}配置已就绪。`
             : "全部模块均已就绪。");
-    lines.push(theme.section("汇总"), `汇总：${theme.success(`${ready} 个已就绪`)}，${theme.warning(`${needsAction} 个需要操作`)}，${blocked > 0 ? theme.failure(`${blocked} 个系统阻塞`) : `${blocked} 个系统阻塞`}`);
+    const snapshot = Array.isArray(data.moduleStatuses)
+        ? data.moduleStatuses.filter(isRecord)
+        : [];
+    if (snapshot.length > 0) {
+        const journey = setupJourney(snapshot);
+        const completed = journey.filter((step) => step.state === "READY").length;
+        const current = journey.find((step) => step.state !== "READY");
+        lines.push(theme.section("配置进度"), `${completed}/3 个核心步骤已完成`, ...(current
+            ? [
+                `当前处理：${current.label}`,
+                ...(current.issue?.message
+                    ? [`原因：${String(current.issue.message)}`]
+                    : []),
+                `下一步：${theme.command("platform setup")}`,
+            ]
+            : [theme.success("全部核心配置已完成。")]));
+    }
+    else {
+        lines.push(theme.section("汇总"), `汇总：${theme.success(`${ready} 个已就绪`)}，${theme.warning(`${needsAction} 个需要操作`)}，${blocked > 0 ? theme.failure(`${blocked} 个系统阻塞`) : `${blocked} 个系统阻塞`}`);
+    }
     return lines.join("\n").trimEnd();
 }
 function renderHelp(theme, command) {
@@ -871,12 +998,12 @@ function renderHelp(theme, command) {
             description: "查看模块配置与运行状态",
         },
         setup: {
-            usage: "platform setup [--workspace <路径>] [--module <模块名>]",
-            description: "自动配置并列出全部剩余步骤",
+            usage: "platform setup [--workspace <路径>]",
+            description: "按顺序完成当前唯一配置步骤",
         },
         docs: {
-            usage: "platform docs [--workspace <路径>] [--module <模块名>]",
-            description: "查看文档索引，或阅读一个模块的详细文档",
+            usage: "platform docs [--workspace <路径>]",
+            description: "查看当前使用帮助",
         },
         start: {
             usage: "platform start [--workspace <路径>]",
@@ -912,12 +1039,11 @@ function renderHelp(theme, command) {
         "",
         theme.section("公共参数"),
         "  --workspace <路径>       指定 ProFlow Workspace",
-        "  setup --module <模块名>  只查看指定模块的配置步骤",
         "  -h, --help               显示帮助",
         "  -v, --version            显示版本",
         "",
         theme.section("推荐流程"),
-        `  ${theme.command("install → status → docs → setup → start → status → stop")}`,
+        `  ${theme.command("install → setup → start")}`,
         "",
         theme.section("配置入口"),
         `  ${theme.command("platform setup")}`,
@@ -951,38 +1077,21 @@ export function renderHumanResult(result, options = {}) {
                 ["dev-tunnel", 1],
                 ["model-provider-api", 2],
             ]);
-            const groups = [
-                { status: "FAILED", title: "失败", icon: "✕", tone: theme.failure },
-                {
-                    status: "ACTION_REQUIRED",
-                    title: "当前根阻塞",
-                    icon: "◆",
-                    tone: theme.warning,
-                },
-                { status: "BLOCKED", title: "下游等待", icon: "◇", tone: theme.info },
-            ];
-            const lines = [theme.failure("平台未启动：存在未就绪模块"), ""];
-            for (const group of groups) {
-                const entries = blockers
-                    .filter((item) => item.setupStatus === group.status)
+            const lines = [theme.failure("平台未启动：配置尚未完成"), ""];
+            let current;
+            for (const status of ["FAILED", "ACTION_REQUIRED", "BLOCKED"]) {
+                current = blockers
+                    .filter((item) => item.setupStatus === status)
                     .sort((a, b) => (productOrder.get(String(a.moduleRef)) ?? 100) -
-                    (productOrder.get(String(b.moduleRef)) ?? 100));
-                if (entries.length === 0)
-                    continue;
-                lines.push(theme.section(group.title));
-                for (const item of entries) {
-                    lines.push(`${group.tone(group.icon)} ${theme.section(String(item.moduleRef))}`, `  原因：${typeof item.reason === "string" ? item.reason : "模块尚未就绪"}`);
-                    if (group.status !== "BLOCKED")
-                        lines.push(`  下一步：${theme.command(typeof item.nextCommand === "string" ? item.nextCommand : `platform setup --module ${String(item.moduleRef)}`)}`);
-                }
-                lines.push("");
+                    (productOrder.get(String(b.moduleRef)) ?? 100))[0];
+                if (current)
+                    break;
+            }
+            if (current) {
+                const moduleRef = String(current.moduleRef);
+                lines.push(`${current.setupStatus === "FAILED" ? theme.failure("✕") : theme.warning("◆")} ${theme.section(setupModuleLabel(moduleRef))}`, `原因：${typeof current.reason === "string" ? current.reason : "当前配置尚未完成"}`, "");
             }
-            const readyCount = Array.isArray(result.data.results)
-                ? result.data.results.filter((item) => isRecord(item) &&
-                    isRecord(item.result) &&
-                    item.result.status === "SUCCEEDED").length - blockers.length
-                : 0;
-            lines.push(theme.section("检查汇总"), `${Math.max(0, readyCount)} 配置已完成 · ${blockers.filter((item) => item.setupStatus === "ACTION_REQUIRED").length} 根阻塞 · ${blockers.filter((item) => item.setupStatus === "BLOCKED").length} 下游等待 · 0 个真实进程启动`, "PLATFORM_READY=NO", `处理方式：${theme.command(`platform setup${result.workspaceRoot ? ` --workspace "${result.workspaceRoot}"` : ""}`)}`);
+            lines.push("PLATFORM_READY=NO", `处理方式：${theme.command(`platform setup${result.workspaceRoot ? ` --workspace "${result.workspaceRoot}"` : ""}`)}`);
             return lines.join("\n");
         }
     }
@@ -992,7 +1101,8 @@ export function renderHumanResult(result, options = {}) {
             `${theme.failure("│")} ${theme.section(result.error.code)}`,
             `${theme.failure("│")} ${result.error.message}`,
             theme.failure("╰─ 请根据提示修复后重试"),
-            ...(result.error.category === "USAGE"
+            ...(result.error.category === "USAGE" &&
+                !result.error.message.includes("你是否想运行")
                 ? ["", renderHelp(theme, result.error.helpCommand)]
                 : []),
         ].join("\n");

package/dist/src/errors.d.ts

@@ -1,4 +1,4 @@
-export declare const platformErrorCodes: readonly ["INVALID_REQUEST", "DESCRIPTOR_INVALID", "DUPLICATE_IDENTITY", "DEPENDENCY_UNRESOLVED", "DEPENDENCY_INCOMPATIBLE", "DEPENDENCY_CYCLE", "WORKSPACE_NOT_FOUND", "WORKSPACE_INSTANCE_INVALID", "PACKAGE_MANAGER_UNSUPPORTED", "PACKAGE_MANAGER_CONFLICT", "PACKAGE_MANAGER_UNAVAILABLE", "UNINSTALL_FAILED", "REGISTRY_UNAVAILABLE", "REGISTRY_AUTH_REQUIRED", "REGISTRY_RESPONSE_INVALID", "PACKAGE_NOT_FOUND", "PACKAGE_NOT_PROFLOW", "COMMAND_FAILED"];
+export declare const platformErrorCodes: readonly ["INVALID_REQUEST", "DESCRIPTOR_INVALID", "DUPLICATE_IDENTITY", "DEPENDENCY_UNRESOLVED", "DEPENDENCY_INCOMPATIBLE", "DEPENDENCY_CYCLE", "WORKSPACE_NOT_FOUND", "WORKSPACE_INSTANCE_INVALID", "WORKSPACE_STATE_NOT_ISOLATED", "PACKAGE_MANAGER_UNSUPPORTED", "PACKAGE_MANAGER_CONFLICT", "PACKAGE_MANAGER_UNAVAILABLE", "UNINSTALL_FAILED", "REGISTRY_UNAVAILABLE", "REGISTRY_AUTH_REQUIRED", "REGISTRY_RESPONSE_INVALID", "PACKAGE_NOT_FOUND", "PACKAGE_NOT_PROFLOW", "PLATFORM_NOT_INSTALLED", "PLATFORM_INSTALL_INCOMPLETE", "COMMAND_FAILED"];
 export type PlatformErrorCode = (typeof platformErrorCodes)[number];
 export declare class PlatformError extends Error {
     readonly code: PlatformErrorCode;

package/dist/src/errors.js

@@ -7,6 +7,7 @@ export const platformErrorCodes = [
     "DEPENDENCY_CYCLE",
     "WORKSPACE_NOT_FOUND",
     "WORKSPACE_INSTANCE_INVALID",
+    "WORKSPACE_STATE_NOT_ISOLATED",
     "PACKAGE_MANAGER_UNSUPPORTED",
     "PACKAGE_MANAGER_CONFLICT",
     "PACKAGE_MANAGER_UNAVAILABLE",
@@ -16,6 +17,8 @@ export const platformErrorCodes = [
     "REGISTRY_RESPONSE_INVALID",
     "PACKAGE_NOT_FOUND",
     "PACKAGE_NOT_PROFLOW",
+    "PLATFORM_NOT_INSTALLED",
+    "PLATFORM_INSTALL_INCOMPLETE",
     "COMMAND_FAILED",
 ];
 export class PlatformError extends Error {

package/dist/src/install/package-manager.d.ts

@@ -38,3 +38,4 @@ export declare function removeWorkspacePackages(options: {
     onOutput?: (line: PackageCommandOutput) => void;
 }): Promise<WorkspacePackageMutationResult>;
 export declare function observeWorkspaceInstalledVersion(workspaceRoot: string, packageName: string): Promise<string | undefined>;
+export declare function preflightWorkspacePackageManager(workspaceRoot: string, executableAvailable?: (command: string) => boolean): Promise<WorkspacePackageManagerSelection>;

package/dist/src/install/package-manager.js

@@ -157,7 +157,7 @@ export async function syncWorkspacePackages(options) {
     }
     await ensureWorkspaceManifest(options.workspaceRoot);
     const runner = options.runner ?? systemPackageCommandRunner();
-    const manager = await requireWorkspacePackageManager(options.workspaceRoot, options.executableAvailable ?? findExecutable);
+    const manager = await preflightWorkspacePackageManager(options.workspaceRoot, options.executableAvailable ?? findExecutable);
     const targets = [...options.packages].sort((a, b) => a.packageName.localeCompare(b.packageName));
     const specs = targets.map((item) => `${item.packageName}@${item.version}`);
     await writeManagedPackageSet(options.workspaceRoot, targets);
@@ -212,7 +212,7 @@ export async function removeWorkspacePackages(options) {
         return { packageManager: "npm", packages: [] };
     }
     const runner = options.runner ?? systemPackageCommandRunner();
-    const manager = await requireWorkspacePackageManager(options.workspaceRoot, options.executableAvailable ?? findExecutable);
+    const manager = await preflightWorkspacePackageManager(options.workspaceRoot, options.executableAvailable ?? findExecutable);
     const args = await batchPackageManagerArgs(runner, manager, options.workspaceRoot, "remove", packageNames);
     try {
         await runner.run(manager.name, args, options.workspaceRoot, options.onOutput);
@@ -253,7 +253,7 @@ async function ensureWorkspaceManifest(workspaceRoot) {
     }
     await atomicWrite(path, `${JSON.stringify({ private: true }, null, 2)}\n`);
 }
-async function requireWorkspacePackageManager(workspaceRoot, executableAvailable) {
+export async function preflightWorkspacePackageManager(workspaceRoot, executableAvailable = findExecutable) {
     const manager = await readWorkspacePackageManagerSelection(workspaceRoot);
     if (!executableAvailable(manager.name)) {
         throw new PlatformError("PACKAGE_MANAGER_UNAVAILABLE", `workspace package manager ${manager.name} is not available on PATH`);

package/dist/src/lifecycle/thin.js

@@ -87,6 +87,8 @@ async function runOrdered(catalog, modules, workspaceRoot, command, reverse, rep
         reportProgress(reporter, {
             command,
             phase: command,
+            kind: "detail",
+            retention: "REPLACE",
             current: index + 1,
             total: modulesInOrder.length,
             moduleRef: module.moduleRef,
@@ -100,6 +102,8 @@ async function runOrdered(catalog, modules, workspaceRoot, command, reverse, rep
         reportProgress(reporter, {
             command,
             phase: command,
+            kind: "detail",
+            retention: "REPLACE",
             current: index + 1,
             total: modulesInOrder.length,
             moduleRef: module.moduleRef,
@@ -222,6 +226,8 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
         reportProgress(reporter, {
             command: "setup",
             phase: "setup",
+            kind: "detail",
+            retention: "REPLACE",
             current: index + 1,
             total: modulesInOrder.length,
             moduleRef: module.moduleRef,
@@ -240,6 +246,8 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
             reportProgress(reporter, {
                 command: "setup",
                 phase: "setup",
+                kind: "detail",
+                retention: "REPLACE",
                 current: index + 1,
                 total: modulesInOrder.length,
                 moduleRef: module.moduleRef,
@@ -254,6 +262,8 @@ export async function setupModulesThin(catalog, modules, workspaceRoot, target,
         reportProgress(reporter, {
             command: "setup",
             phase: "setup",
+            kind: "detail",
+            retention: "REPLACE",
             current: index + 1,
             total: modulesInOrder.length,
             moduleRef: module.moduleRef,

package/dist/src/persistence/git-isolation.d.ts

@@ -0,0 +1,4 @@
+export declare function ensureWorkspaceStateIsGitIgnored(workspaceRoot: string): Promise<{
+    gitRepository: boolean;
+    changed: boolean;
+}>;

package/dist/src/persistence/git-isolation.js

@@ -0,0 +1,52 @@
+import { execFile } from "node:child_process";
+import { mkdir, readFile, realpath, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+import { PlatformError } from "../errors.js";
+const execute = promisify(execFile);
+async function git(root, args) {
+    try {
+        const result = await execute("git", ["-C", root, ...args], {
+            encoding: "utf8",
+        });
+        return result.stdout.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function ensureWorkspaceStateIsGitIgnored(workspaceRoot) {
+    const topLevel = await git(workspaceRoot, ["rev-parse", "--show-toplevel"]);
+    const gitDirectoryValue = await git(workspaceRoot, [
+        "rev-parse",
+        "--absolute-git-dir",
+    ]);
+    if (!topLevel || !gitDirectoryValue)
+        return { gitRepository: false, changed: false };
+    if (await git(workspaceRoot, ["check-ignore", ".proflow/workspace.json"]))
+        return { gitRepository: true, changed: false };
+    const [canonicalTopLevel, canonicalWorkspaceRoot] = await Promise.all([
+        realpath(topLevel).catch(() => topLevel),
+        realpath(workspaceRoot).catch(() => workspaceRoot),
+    ]);
+    const excludePath = resolve(gitDirectoryValue, "info", "exclude");
+    const workspaceRelative = relative(canonicalTopLevel, canonicalWorkspaceRoot).replaceAll("\\", "/");
+    const pattern = `/${workspaceRelative ? `${workspaceRelative}/` : ""}.proflow/`;
+    let existing = "";
+    try {
+        existing = await readFile(excludePath, "utf8");
+    }
+    catch {
+        // A new repository may not have an info/exclude file yet.
+    }
+    if (!existing.split(/\r?\n/).includes(pattern)) {
+        await mkdir(dirname(excludePath), { recursive: true });
+        const prefix = existing.length === 0 || existing.endsWith("\n")
+            ? existing
+            : `${existing}\n`;
+        await writeFile(excludePath, `${prefix}# ProFlow managed workspace state\n${pattern}\n`, "utf8");
+    }
+    if (!(await git(workspaceRoot, ["check-ignore", ".proflow/workspace.json"])))
+        throw new PlatformError("WORKSPACE_STATE_NOT_ISOLATED", "无法确保 .proflow 工作区状态被 Git 忽略；安装已安全停止。");
+    return { gitRepository: true, changed: true };
+}

package/dist/src/registry/npm-registry.d.ts

@@ -1,6 +1,7 @@
 export declare const PRO_FLOW_SCOPE = "@tomflow";
 export declare const PRO_FLOW_PACKAGE_PREFIX = "@tomflow/proflow-";
 export declare const RETIRED_PRO_FLOW_PACKAGES: Set<string>;
+export declare const PRO_FLOW_TOOL_PACKAGES: Set<string>;
 export interface NpmCommandResult {
     stdout: string;
     stderr: string;
@@ -28,6 +29,7 @@ export interface RegistryDiscoveryResult {
     candidates: RegistryModuleCandidate[];
     rejected: RegistryRejectedPackage[];
     retired: string[];
+    tools: string[];
 }
 export declare function systemNpmRunner(): NpmCommandRunner;
 export declare function resolveScopeRegistry(workspaceRoot: string, runner?: NpmCommandRunner): Promise<string>;

package/dist/src/registry/npm-registry.js

@@ -9,6 +9,9 @@ export const PRO_FLOW_PACKAGE_PREFIX = "@tomflow/proflow-";
 export const RETIRED_PRO_FLOW_PACKAGES = new Set([
     "@tomflow/proflow-chatgpt-carrier",
 ]);
+export const PRO_FLOW_TOOL_PACKAGES = new Set([
+    "@tomflow/proflow-devtunnel-cli",
+]);
 export function systemNpmRunner() {
     return {
         async run(args, cwd, timeoutMs) {
@@ -46,7 +49,8 @@ export async function discoverRegistryModules(options) {
         ? await searchPackageNames(options.workspaceRoot, registry, runner)
         : [validateRequestedPackageName(options.packageName)];
     const retired = names.filter((name) => RETIRED_PRO_FLOW_PACKAGES.has(name));
-    const activeNames = names.filter((name) => !RETIRED_PRO_FLOW_PACKAGES.has(name));
+    const tools = names.filter((name) => PRO_FLOW_TOOL_PACKAGES.has(name));
+    const activeNames = names.filter((name) => !RETIRED_PRO_FLOW_PACKAGES.has(name) && !PRO_FLOW_TOOL_PACKAGES.has(name));
     options.onSearchComplete?.(activeNames.length);
     const candidates = [];
     const rejected = [];
@@ -75,7 +79,7 @@ export async function discoverRegistryModules(options) {
     await Promise.all(Array.from({ length: Math.min(4, activeNames.length) }, () => worker()));
     candidates.sort((left, right) => left.packageName.localeCompare(right.packageName));
     rejected.sort((left, right) => left.packageName.localeCompare(right.packageName));
-    return { registry, candidates, rejected, retired };
+    return { registry, candidates, rejected, retired, tools };
 }
 async function searchPackageNames(workspaceRoot, registry, runner) {
     const result = await runner.run([

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

@@ -2,7 +2,7 @@ export type SetupActionRequest = {
     moduleRef: string;
     action: string;
     description: string;
-    modelIds?: readonly string[];
+    options?: readonly string[];
 };
 export interface SetupInteraction {
     begin(): void;

package/dist/src/setup/interaction.js

@@ -1,9 +1,8 @@
-import { autocomplete, cancel, confirm, intro, isCancel, outro, password, text, } from "@clack/prompts";
+import { cancel, confirm, intro, isCancel, outro, password, select, text, } from "@clack/prompts";
 const stepPrompts = {
-    "execution-browser-extension": "下一步将打开 Chrome，并引导你加载浏览器扩展。按 Enter 继续。",
-    "dev-tunnel": "下一步将检查远程连接；如需登录，会打开 GitHub 授权。按 Enter 继续。",
-    "model-provider-api": "下一步配置 OpenAI-compatible 模型服务地址。按 Enter 继续。",
-    "model-runtime": "下一步从真实模型列表选择 FAST 与 THINK。按 Enter 继续。",
+    "dev-tunnel": "下一步将检查远程连接；如需登录，会打开 GitHub 授权。是否继续？",
+    "model-provider-api": "下一步配置 OpenAI-compatible 模型服务地址。是否继续？",
+    "model-runtime": "下一步验证模型能力并配置 FAST 与 THINK。是否继续？",
 };
 function cancelled(value) {
     if (!isCancel(value))
@@ -71,29 +70,26 @@ async function providerCredential() {
         return undefined;
     return { providerCredential: String(value) };
 }
-async function modelRoles(modelIds) {
+async function modelRole(role, modelIds) {
     const options = modelIds.map((id) => ({ value: id, label: id }));
-    const fastModel = await autocomplete({
-        message: "选择 FAST 模型（快速、低延迟）",
-        placeholder: "输入关键字搜索模型",
+    const selected = await select({
+        message: role === "fast"
+            ? "选择 FAST 模型（快速、低延迟）"
+            : "选择 THINK 模型（复杂分析与推理）",
         options,
+        showInstructions: false,
     });
-    if (cancelled(fastModel))
-        return undefined;
-    const reasonModel = await autocomplete({
-        message: "选择 THINK 模型（复杂分析与推理）",
-        placeholder: "输入关键字搜索模型",
-        options,
-    });
-    if (cancelled(reasonModel))
+    if (cancelled(selected))
         return undefined;
     const approved = await confirm({
-        message: `确认 FAST=${String(fastModel)}，THINK=${String(reasonModel)}？`,
+        message: `确认将 ${String(selected)} 用作 ${role === "fast" ? "FAST" : "THINK"} 模型？`,
         initialValue: true,
     });
     if (cancelled(approved) || approved !== true)
         return undefined;
-    return { fastModel: String(fastModel), reasonModel: String(reasonModel) };
+    return role === "fast"
+        ? { fastModel: String(selected) }
+        : { reasonModel: String(selected) };
 }
 export function createClackSetupInteraction() {
     return {
@@ -111,14 +107,26 @@ export function createClackSetupInteraction() {
             return !cancelled(approved) && approved === true;
         },
         async collect(request) {
+            if (request.action === "confirm-browser-developer-mode") {
+                const approved = await confirm({
+                    message: "步骤 1/2：已经在 Chrome 中开启“开发者模式”了吗？",
+                    initialValue: true,
+                });
+                if (cancelled(approved) || approved !== true)
+                    return undefined;
+                return { developerModeConfirmed: true };
+            }
             if (request.action === "provide-provider-endpoint") {
                 return providerEndpoint();
             }
             if (request.action === "provide-provider-credential") {
                 return providerCredential();
             }
-            if (request.action.startsWith("select-") && request.modelIds?.length) {
-                return modelRoles(request.modelIds);
+            if (request.action === "select-fast-model" && request.options?.length) {
+                return modelRole("fast", request.options);
+            }
+            if (request.action === "select-reason-model" && request.options?.length) {
+                return modelRole("reason", request.options);
             }
             return undefined;
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-cli",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "platform-cli",
 	"packageName": "@tomflow/proflow-platform-cli",
-	"moduleVersion": "0.1.39",
+	"moduleVersion": "0.1.41",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",