@zmice/zc 0.2.1 → 0.2.4

package/dist/cli/platform.js

@@ -2,12 +2,110 @@ import { InvalidArgumentError } from "commander";
 import { readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { attachPlanMetadata } from "@zmice/platform-core";
+import { resolvePlatformInstallDoctor } from "../platform-state/doctor.js";
 import { resolvePlatformInstallStatus } from "../platform-state/status.js";
 import { normalizeInstallSelector, resolveInstallTarget } from "../utils/install-target.js";
-import { resolvePlatformInstallReceiptPath, writePlatformInstallReceiptForPlan, } from "../utils/platform-install-receipt.js";
+import { deletePlatformInstallReceipt, resolvePlatformInstallReceiptPath, writePlatformInstallReceiptForPlan, } from "../utils/platform-install-receipt.js";
+import { pathExists, removeManagedPaths } from "../utils/platform-install-cleanup.js";
 import { ArtifactConflictError, importWorkspaceDistModule, resolveWorkspacePath, writeArtifacts, } from "../utils/workspace.js";
-const platformNames = ["qwen", "codex", "qoder"];
-const defaultPlatforms = ["qwen", "codex", "qoder"];
+import { QwenOfficialCliUnavailableError, installQwenExtensionFromOfficialRepoWithCli, installQwenExtensionWithOfficialCli, qwenOfficialExtensionRepoUrl, relinkQwenExtensionWithOfficialCli, resolveQwenOfficialCliReleaseBundleDir, syncQwenOfficialCliReleaseBundle, toQwenOfficialCliReleaseArtifacts, uninstallQwenExtensionWithOfficialCli, updateQwenExtensionWithOfficialCli, } from "../utils/qwen-extension-cli.js";
+const platformNames = ["qwen", "codex", "claude", "opencode"];
+function getPlanCapabilitySummary(plan) {
+    const capability = plan.capability;
+    if (!capability) {
+        return null;
+    }
+    const exposure = (() => {
+        switch (plan.platform) {
+            case "codex":
+                return {
+                    style: "skill-alias",
+                    entryPattern: "$zc-*",
+                    examples: [
+                        "zc:start -> $zc-start",
+                        "zc:product-analysis -> $zc-product-analysis",
+                        "zc:sdd-tdd -> $zc-sdd-tdd",
+                    ],
+                };
+            case "claude":
+                return {
+                    style: "slash-command",
+                    entryPattern: "/zc-*",
+                    examples: [
+                        "zc:start -> /zc-start",
+                        "zc:product-analysis -> /zc-product-analysis",
+                        "zc:sdd-tdd -> /zc-sdd-tdd",
+                    ],
+                };
+            case "opencode":
+                return {
+                    style: "slash-command",
+                    entryPattern: "/zc-*",
+                    examples: [
+                        "zc:start -> /zc-start",
+                        "zc:product-analysis -> /zc-product-analysis",
+                        "zc:sdd-tdd -> /zc-sdd-tdd",
+                    ],
+                };
+            case "qwen":
+                return {
+                    style: "namespaced-command",
+                    entryPattern: "zc:*",
+                    examples: [
+                        "zc:start -> zc:start",
+                        "zc:product-analysis -> zc:product-analysis",
+                        "zc:sdd-tdd -> zc:sdd-tdd",
+                    ],
+                };
+        }
+    })();
+    return {
+        namespace: capability.namespace,
+        surfaces: capability.surfaces,
+        entryFile: capability.entryFile?.fileName ?? null,
+        commandsDir: capability.commands?.relativeDir ?? null,
+        skillsDir: capability.skills?.relativeDir ?? null,
+        agentsDir: capability.agents?.relativeDir ?? null,
+        extensionDir: capability.extension
+            ? `${capability.extension.relativeDir}/${capability.extension.name}`
+            : null,
+        exposure,
+    };
+}
+function formatSurfaceLabel(surface) {
+    switch (surface) {
+        case "entry-file":
+            return "入口文件";
+        case "skills-dir":
+            return "skills 目录";
+        case "commands-dir":
+            return "commands 目录";
+        case "agents-dir":
+            return "agents 目录";
+        case "extension-dir":
+            return "extension 目录";
+        default:
+            return surface;
+    }
+}
+function summarizeCapability(plan) {
+    const capability = getPlanCapabilitySummary(plan);
+    if (!capability) {
+        return [];
+    }
+    return [
+        `命名空间：${capability.namespace}`,
+        `入口形式：${capability.exposure.entryPattern}`,
+        `安装面：${capability.surfaces.map((surface) => formatSurfaceLabel(surface)).join("、")}`,
+        ...(capability.entryFile ? [`入口文件：${capability.entryFile}`] : []),
+        ...(capability.commandsDir ? [`commands 目录：${capability.commandsDir}`] : []),
+        ...(capability.skillsDir ? [`skills 目录：${capability.skillsDir}`] : []),
+        ...(capability.agentsDir ? [`agents 目录：${capability.agentsDir}`] : []),
+        ...(capability.extensionDir ? [`extension 目录：${capability.extensionDir}`] : []),
+        `示例映射：${capability.exposure.examples.join("；")}`,
+    ];
+}
+const defaultPlatforms = ["qwen", "codex", "claude", "opencode"];
 function getCliVersion() {
     const packageJsonPath = new URL("../../package.json", import.meta.url);
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
@@ -19,10 +117,13 @@ function normalizeManifest(manifest) {
         assets: manifest.assets.map((asset) => ({
             id: asset.id,
             kind: asset.meta.kind,
+            name: asset.meta.name,
             platforms: asset.meta.platforms ?? defaultPlatforms,
             title: asset.meta.title,
             summary: asset.meta.description,
-            body: asset.body
+            body: asset.body,
+            tools: asset.meta.tools,
+            requires: asset.meta.requires
         }))
     };
 }
@@ -37,30 +138,38 @@ async function loadPlatformModule(platform) {
     const packageMap = {
         qwen: "packages/platform-qwen/dist/index.js",
         codex: "packages/platform-codex/dist/index.js",
-        qoder: "packages/platform-qoder/dist/index.js"
+        claude: "packages/platform-claude/dist/index.js",
+        opencode: "packages/platform-opencode/dist/index.js"
     };
     return importWorkspaceDistModule(packageMap[platform]);
 }
 function createGenerationPlan(platform, platformModule, manifest) {
+    const extensionVersion = getCliVersion();
     switch (platform) {
         case "qwen":
             if (!platformModule.createQwenGenerationPlan) {
                 throw new Error("Qwen 平台包未导出 createQwenGenerationPlan()");
             }
-            return finalizePlan(platformModule.createQwenGenerationPlan(manifest, { manifestSource: manifest.source }));
+            return finalizePlan(platformModule.createQwenGenerationPlan(manifest, { manifestSource: manifest.source, extensionVersion }));
         case "codex":
             if (!platformModule.createCodexGenerationPlan) {
                 throw new Error("Codex 平台包未导出 createCodexGenerationPlan()");
             }
-            return finalizePlan(platformModule.createCodexGenerationPlan(manifest, { manifestSource: manifest.source }));
-        case "qoder":
-            if (!platformModule.createQoderGenerationPlan) {
-                throw new Error("Qoder 平台包未导出 createQoderGenerationPlan()");
+            return finalizePlan(platformModule.createCodexGenerationPlan(manifest, { manifestSource: manifest.source, extensionVersion }));
+        case "claude":
+            if (!platformModule.createClaudeGenerationPlan) {
+                throw new Error("Claude 平台包未导出 createClaudeGenerationPlan()");
             }
-            return finalizePlan(platformModule.createQoderGenerationPlan(manifest, { manifestSource: manifest.source }));
+            return finalizePlan(platformModule.createClaudeGenerationPlan(manifest, { manifestSource: manifest.source, extensionVersion }));
+        case "opencode":
+            if (!platformModule.createOpenCodeGenerationPlan) {
+                throw new Error("OpenCode 平台包未导出 createOpenCodeGenerationPlan()");
+            }
+            return finalizePlan(platformModule.createOpenCodeGenerationPlan(manifest, { manifestSource: manifest.source, extensionVersion }));
     }
 }
-function createInstallPlan(platform, platformModule, manifest, destinationRoot, overwrite) {
+function createInstallPlan(platform, platformModule, manifest, destinationRoot, scope, overwrite) {
+    const extensionVersion = getCliVersion();
     switch (platform) {
         case "qwen":
             if (!platformModule.createQwenInstallPlan) {
@@ -69,7 +178,9 @@ function createInstallPlan(platform, platformModule, manifest, destinationRoot,
             return finalizePlan(platformModule.createQwenInstallPlan(manifest, {
                 manifestSource: manifest.source,
                 destinationRoot,
-                overwrite
+                scope,
+                overwrite,
+                extensionVersion,
             }));
         case "codex":
             if (!platformModule.createCodexInstallPlan) {
@@ -78,16 +189,31 @@ function createInstallPlan(platform, platformModule, manifest, destinationRoot,
             return finalizePlan(platformModule.createCodexInstallPlan(manifest, {
                 manifestSource: manifest.source,
                 destinationRoot,
-                overwrite
+                scope,
+                overwrite,
+                extensionVersion,
+            }));
+        case "claude":
+            if (!platformModule.createClaudeInstallPlan) {
+                throw new Error("Claude 平台包未导出 createClaudeInstallPlan()");
+            }
+            return finalizePlan(platformModule.createClaudeInstallPlan(manifest, {
+                manifestSource: manifest.source,
+                destinationRoot,
+                scope,
+                overwrite,
+                extensionVersion,
             }));
-        case "qoder":
-            if (!platformModule.createQoderInstallPlan) {
-                throw new Error("Qoder 平台包未导出 createQoderInstallPlan()");
+        case "opencode":
+            if (!platformModule.createOpenCodeInstallPlan) {
+                throw new Error("OpenCode 平台包未导出 createOpenCodeInstallPlan()");
             }
-            return finalizePlan(platformModule.createQoderInstallPlan(manifest, {
+            return finalizePlan(platformModule.createOpenCodeInstallPlan(manifest, {
                 manifestSource: manifest.source,
                 destinationRoot,
-                overwrite
+                scope,
+                overwrite,
+                extensionVersion,
             }));
     }
 }
@@ -97,6 +223,10 @@ function resolveOverwriteMode(force) {
 function resolveOutputFormat(json) {
     return json ? "json" : "text";
 }
+function mergeHints(...hints) {
+    const merged = hints.filter(Boolean);
+    return merged.length > 0 ? merged.join("；") : undefined;
+}
 function resolveScopeFromSelector(opts) {
     return normalizeInstallSelector(opts).mode;
 }
@@ -128,6 +258,10 @@ function formatActionLabel(action) {
             return "安装";
         case "update":
             return "更新";
+        case "repair":
+            return "修复";
+        case "uninstall":
+            return "卸载";
     }
 }
 function formatRootLabel(action, root, metadata) {
@@ -149,30 +283,121 @@ function formatStatusLabel(kind) {
             return "已漂移";
     }
 }
+function formatInstallMethodLabel(method) {
+    return method === "qwen-cli" ? "官方 qwen extensions CLI" : "直接写入";
+}
+function formatInstallSourceLabel(source) {
+    return source === "github-repo" ? "GitHub 扩展仓库" : "本地 bundle";
+}
+function formatBundleTypeLabel(type) {
+    return type === "release-bundle" ? "发布态扩展包" : "开发态源包";
+}
+function formatScopeFlag(scope, root) {
+    switch (scope) {
+        case "global":
+            return " --global";
+        case "project":
+            return " --project";
+        case "dir":
+            return ` --dir ${JSON.stringify(root)}`;
+    }
+}
+function buildNextStep(action, target, root, options) {
+    const scopeFlag = formatScopeFlag(options?.scope ?? "project", root);
+    switch (action) {
+        case "generate":
+            return `下一步：如需写入平台目录，运行 \`zc platform install ${target} --project\`、\`--global\` 或 \`--dir <path>\`。`;
+        case "install":
+            return options?.noop
+                ? `下一步：当前已是目标状态；如需确认细节，运行 \`zc platform status ${target}${scopeFlag} --json\`。`
+                : `下一步：运行 \`zc platform status ${target}${scopeFlag}\` 确认安装状态。`;
+        case "update":
+            return options?.noop
+                ? "下一步：当前已经是最新版本，无需额外操作。"
+                : `下一步：运行 \`zc platform status ${target}${scopeFlag}\` 确认更新结果。`;
+        case "repair":
+            return options?.noop
+                ? "下一步：当前安装健康，无需修复。"
+                : `下一步：运行 \`zc platform doctor ${target}${scopeFlag}\` 复查健康度。`;
+        case "uninstall":
+            return `下一步：如需重新安装，运行 \`zc platform install ${target}${scopeFlag}\`。`;
+        case "where":
+            return `下一步：运行 \`zc platform install ${target}${scopeFlag}\` 执行安装，或追加 \`--plan --json\` 先看计划。`;
+        case "status":
+            switch (options?.status) {
+                case "not-installed":
+                    return `下一步：运行 \`zc platform install ${target}${scopeFlag}\`。`;
+                case "update-available":
+                    return `下一步：运行 \`zc platform update ${target}${scopeFlag}\`。`;
+                case "drifted":
+                    return `下一步：先运行 \`zc platform doctor ${target}${scopeFlag}\`，再按结果选择 \`repair\` 或带 \`--force\` 的 \`update\`。`;
+                case "up-to-date":
+                    return "下一步：当前已是最新状态，无需动作。";
+                default:
+                    return null;
+            }
+        case "doctor":
+            switch (options?.health) {
+                case "healthy":
+                    return "下一步：未发现需要处理的问题。";
+                case "warning":
+                    return `下一步：优先运行 \`zc platform repair ${target}${scopeFlag}\`，再复查状态。`;
+                case "broken":
+                    return `下一步：先运行 \`zc platform repair ${target}${scopeFlag}\`；如仍异常，再查看 \`zc platform status ${target}${scopeFlag} --json\`。`;
+                default:
+                    return null;
+            }
+    }
+}
 function summarizeResult(action, target, root, result, metadata) {
     const mode = result.dryRun ? "预演完成" : "完成";
-    return [
+    const lines = [
         `${target} ${formatActionLabel(action)}${mode}`,
         formatRootLabel(action, root, metadata),
         ...(metadata?.status ? [`状态：${metadata.status}`] : []),
+        ...(metadata?.installMethod ? [`安装方式：${formatInstallMethodLabel(metadata.installMethod)}`] : []),
+        ...(metadata?.installSource ? [`安装来源：${formatInstallSourceLabel(metadata.installSource)}`] : []),
+        ...(metadata?.sourceRef ? [`来源：${metadata.sourceRef}`] : []),
+        ...(metadata?.bundleType ? [`Bundle 类型：${formatBundleTypeLabel(metadata.bundleType)}`] : []),
+        ...(metadata?.bundlePath ? [`Bundle 目录：${metadata.bundlePath}`] : []),
         ...(metadata?.receiptPath ? [`回执：${metadata.receiptPath}`] : []),
-        ...(metadata?.zcVersion ? [`zc 版本：${metadata.zcVersion}`] : []),
-        ...(metadata?.contentFingerprint ? [`内容指纹：${metadata.contentFingerprint}`] : []),
         ...(metadata?.hint ? [`提示：${metadata.hint}`] : []),
         metadata?.noop
             ? "无需写入，当前安装已满足目标状态。"
             : `新增 ${result.created}，覆盖 ${result.overwritten}，未变更 ${result.unchanged}${result.dryRun ? `，跳过写入 ${result.skipped}` : ""}`,
-    ].join("\n");
+    ];
+    const nextStep = buildNextStep(action, target, root, {
+        scope: metadata?.scope,
+        status: metadata?.status,
+        noop: metadata?.noop,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
 }
 function summarizePlan(action, target, root, plan, metadata) {
-    return [
+    const lines = [
         `${target} ${formatActionLabel(action)}计划`,
         formatRootLabel(action, root, metadata),
         ...(metadata?.status ? [`状态：${metadata.status}`] : []),
+        ...(metadata?.installSource ? [`安装来源：${formatInstallSourceLabel(metadata.installSource)}`] : []),
+        ...(metadata?.sourceRef ? [`来源：${metadata.sourceRef}`] : []),
+        ...(metadata?.bundleType ? [`Bundle 类型：${formatBundleTypeLabel(metadata.bundleType)}`] : []),
+        ...(metadata?.bundlePath ? [`Bundle 目录：${metadata.bundlePath}`] : []),
         ...(metadata?.hint ? [`提示：${metadata.hint}`] : []),
+        ...summarizeCapability(plan),
         `产物数量：${plan.artifacts.length}`,
         ...plan.artifacts.map((artifact) => `- ${artifact.path}`),
-    ].join("\n");
+    ];
+    const nextStep = buildNextStep(action, target, root, {
+        scope: metadata?.scope,
+        status: metadata?.status,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
 }
 function buildPlanPayload(action, target, root, plan, metadata) {
     return {
@@ -185,12 +410,23 @@ function buildPlanPayload(action, target, root, plan, metadata) {
         autoResolvedRoot: metadata?.autoResolvedRoot ?? false,
         hint: metadata?.hint ?? null,
         status: metadata?.status ?? null,
+        installSource: metadata?.installSource ?? null,
+        sourceRef: metadata?.sourceRef ?? null,
+        bundleType: metadata?.bundleType ?? null,
+        bundlePath: metadata?.bundlePath ?? null,
+        capability: getPlanCapabilitySummary(plan),
         artifactCount: plan.artifacts.length,
         contentFingerprint: plan.metadata?.fingerprint.value ?? null,
         overwrite: "overwrite" in plan ? plan.overwrite : null,
         artifacts: plan.artifacts,
     };
 }
+function parseGenerateBundleType(value) {
+    if (value === "release-bundle" || value === "release") {
+        return "release-bundle";
+    }
+    throw new InvalidArgumentError(`不支持的 bundle 类型：${value}。当前仅支持：release-bundle`);
+}
 function buildResultPayload(action, target, root, result, metadata) {
     return {
         mode: "result",
@@ -201,6 +437,11 @@ function buildResultPayload(action, target, root, result, metadata) {
         rootSource: metadata?.rootSource ?? (metadata?.autoResolvedRoot ? "project-root" : "explicit"),
         autoResolvedRoot: metadata?.autoResolvedRoot ?? false,
         hint: metadata?.hint ?? null,
+        installMethod: metadata?.installMethod ?? "filesystem",
+        installSource: metadata?.installSource ?? null,
+        sourceRef: metadata?.sourceRef ?? null,
+        bundleType: metadata?.bundleType ?? null,
+        bundlePath: metadata?.bundlePath ?? null,
         receiptPath: metadata?.receiptPath ?? null,
         zcVersion: metadata?.zcVersion ?? null,
         status: metadata?.status ?? null,
@@ -209,15 +450,71 @@ function buildResultPayload(action, target, root, result, metadata) {
         ...result,
     };
 }
+function shouldPreferQwenOfficialCli(target, scope) {
+    return target === "qwen" && scope === "global";
+}
+function shouldPreferQwenOfficialRepoInstall(target, scope) {
+    return shouldPreferQwenOfficialCli(target, scope);
+}
+function estimateManagedInstallResult(plan, status) {
+    if (status.kind === "not-installed") {
+        return {
+            created: plan.artifacts.length,
+            overwritten: 0,
+            unchanged: 0,
+            skipped: 0,
+            dryRun: false,
+        };
+    }
+    let created = 0;
+    let overwritten = 0;
+    let unchanged = 0;
+    for (const artifact of status.artifacts) {
+        if (artifact.plannedSha256 === null) {
+            continue;
+        }
+        if (artifact.actualSha256 === artifact.plannedSha256) {
+            unchanged += 1;
+            continue;
+        }
+        if (artifact.actualSha256 === null) {
+            created += 1;
+            continue;
+        }
+        overwritten += 1;
+    }
+    return {
+        created,
+        overwritten,
+        unchanged,
+        skipped: 0,
+        dryRun: false,
+    };
+}
 function summarizeWhere(target, root, metadata) {
-    return [
+    const lines = [
         `${target} 安装目标`,
         `范围：${metadata.scope}`,
         `解析来源：${metadata.rootSource}`,
         ...(metadata.marker ? [`命中标记：${metadata.marker}`] : []),
         `目录：${root}`,
+        ...(metadata.capability
+            ? [
+                `命名空间：${metadata.capability.namespace}`,
+                `入口形式：${metadata.capability.exposure.entryPattern}`,
+                `安装面：${metadata.capability.surfaces.map((surface) => formatSurfaceLabel(surface)).join("、")}`,
+                `示例映射：${metadata.capability.exposure.examples.join("；")}`,
+            ]
+            : []),
         ...(metadata.hint ? [`提示：${metadata.hint}`] : []),
-    ].join("\n");
+    ];
+    const nextStep = buildNextStep("where", target, root, {
+        scope: metadata.scope,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
 }
 function buildWherePayload(target, root, metadata) {
     return {
@@ -228,6 +525,7 @@ function buildWherePayload(target, root, metadata) {
         rootSource: metadata.rootSource,
         marker: metadata.marker ?? null,
         hint: metadata.hint ?? null,
+        capability: metadata.capability ?? null,
     };
 }
 function reportConflict(error, target, destinationRoot) {
@@ -240,19 +538,33 @@ function reportConflict(error, target, destinationRoot) {
     console.error("如需覆盖，请追加 --force。");
 }
 function summarizeStatus(target, root, status, metadata) {
-    return [
+    const lines = [
         `${target} 安装状态`,
         `范围：${metadata.scope}`,
         `目录：${root}`,
         `状态：${status.kind}（${formatStatusLabel(status.kind)}）`,
         `回执：${status.receiptPath}`,
-        ...(status.installedZcVersion ? [`已安装 zc 版本：${status.installedZcVersion}`] : []),
-        ...(metadata.zcVersion ? [`当前 zc 版本：${metadata.zcVersion}`] : []),
-        ...(status.installedContentFingerprint ? [`已安装内容指纹：${status.installedContentFingerprint}`] : []),
-        ...(status.contentFingerprint ? [`当前内容指纹：${status.contentFingerprint}`] : []),
+        ...(metadata.installMethod ? [`安装方式：${formatInstallMethodLabel(metadata.installMethod)}`] : []),
+        ...(metadata.installSource ? [`安装来源：${formatInstallSourceLabel(metadata.installSource)}`] : []),
+        ...(metadata.sourceRef ? [`来源：${metadata.sourceRef}`] : []),
+        ...(metadata.bundleType ? [`Bundle 类型：${formatBundleTypeLabel(metadata.bundleType)}`] : []),
+        ...(metadata.bundlePath ? [`Bundle 目录：${metadata.bundlePath}`] : []),
+        ...(metadata.recommendedInstallMethod ? [`推荐安装方式：${formatInstallMethodLabel(metadata.recommendedInstallMethod)}`] : []),
+        ...(metadata.recommendedInstallSource ? [`推荐来源：${formatInstallSourceLabel(metadata.recommendedInstallSource)}`] : []),
+        ...(metadata.recommendedSourceRef ? [`推荐来源地址：${metadata.recommendedSourceRef}`] : []),
+        ...(metadata.recommendedBundleType ? [`推荐 Bundle：${formatBundleTypeLabel(metadata.recommendedBundleType)}`] : []),
+        ...(metadata.recommendedBundlePath ? [`推荐 Bundle 目录：${metadata.recommendedBundlePath}`] : []),
         `跟踪产物：${status.summary.trackedArtifacts}，漂移：${status.summary.driftedArtifacts}，缺失：${status.summary.missingArtifacts}，待更新：${status.summary.plannedChanges}`,
         ...(metadata.hint ? [`提示：${metadata.hint}`] : []),
-    ].join("\n");
+    ];
+    const nextStep = buildNextStep("status", target, root, {
+        scope: metadata.scope,
+        status: status.kind,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
 }
 function buildStatusPayload(target, root, status, metadata) {
     return {
@@ -262,6 +574,17 @@ function buildStatusPayload(target, root, status, metadata) {
         root,
         rootSource: metadata.rootSource,
         hint: metadata.hint ?? null,
+        capability: getPlanCapabilitySummary(metadata.plan),
+        installMethod: metadata.installMethod ?? null,
+        installSource: metadata.installSource ?? null,
+        sourceRef: metadata.sourceRef ?? null,
+        bundleType: metadata.bundleType ?? null,
+        bundlePath: metadata.bundlePath ?? null,
+        recommendedInstallMethod: metadata.recommendedInstallMethod ?? null,
+        recommendedInstallSource: metadata.recommendedInstallSource ?? null,
+        recommendedSourceRef: metadata.recommendedSourceRef ?? null,
+        recommendedBundleType: metadata.recommendedBundleType ?? null,
+        recommendedBundlePath: metadata.recommendedBundlePath ?? null,
         status: status.kind,
         receiptPath: status.receiptPath,
         zcVersion: metadata.zcVersion ?? null,
@@ -272,37 +595,143 @@ function buildStatusPayload(target, root, status, metadata) {
         artifacts: status.artifacts,
     };
 }
+function summarizeDoctor(target, root, status, doctor, metadata) {
+    const lines = [
+        `${target} 安装诊断`,
+        `范围：${metadata.scope}`,
+        `目录：${root}`,
+        `状态：${status.kind}（${formatStatusLabel(status.kind)}）`,
+        `健康度：${doctor.health}`,
+        ...(doctor.issues.length > 0
+            ? doctor.issues.flatMap((issue) => [
+                `- [${issue.severity}] ${issue.code}: ${issue.message}`,
+                ...(issue.paths && issue.paths.length > 0 ? issue.paths.map((path) => `  - ${path}`) : []),
+            ])
+            : ["- 未发现需要处理的问题。"]),
+        ...(metadata.hint ? [`提示：${metadata.hint}`] : []),
+    ];
+    const nextStep = buildNextStep("doctor", target, root, {
+        scope: metadata.scope,
+        status: status.kind,
+        health: doctor.health,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
+}
+function buildDoctorPayload(target, root, status, doctor, metadata) {
+    return {
+        mode: "doctor",
+        target,
+        scope: metadata.scope,
+        root,
+        rootSource: metadata.rootSource,
+        hint: metadata.hint ?? null,
+        capability: getPlanCapabilitySummary(metadata.plan),
+        status: status.kind,
+        health: doctor.health,
+        receiptPath: status.receiptPath,
+        issues: doctor.issues,
+        summary: status.summary,
+    };
+}
+function summarizeUninstall(target, root, result, metadata) {
+    const lines = [
+        `${target} 卸载完成`,
+        formatRootLabel("uninstall", root, metadata),
+        ...(metadata.installMethod ? [`安装方式：${formatInstallMethodLabel(metadata.installMethod)}`] : []),
+        ...(metadata.installSource ? [`安装来源：${formatInstallSourceLabel(metadata.installSource)}`] : []),
+        ...(metadata.sourceRef ? [`来源：${metadata.sourceRef}`] : []),
+        ...(metadata.bundlePath ? [`Bundle 目录：${metadata.bundlePath}`] : []),
+        `回执：${metadata.receiptPath}`,
+        ...(metadata.hint ? [`提示：${metadata.hint}`] : []),
+        `移除受管产物 ${result.removedArtifacts}，原本缺失 ${result.missingArtifacts}`,
+        `Bundle：${result.bundleRemoved ? "已删除" : result.bundleMissing ? "本就不存在" : "未涉及"}`,
+        `回执：${result.receiptRemoved ? "已删除" : result.receiptMissing ? "本就不存在" : "未涉及"}`,
+    ];
+    const nextStep = buildNextStep("uninstall", target, root, {
+        scope: metadata.scope,
+    });
+    if (nextStep) {
+        lines.push(nextStep);
+    }
+    return lines.join("\n");
+}
+function buildUninstallPayload(target, root, result, metadata) {
+    return {
+        mode: "result",
+        action: "uninstall",
+        target,
+        root,
+        scope: metadata.scope ?? "project",
+        rootSource: metadata.rootSource ?? (metadata.autoResolvedRoot ? "project-root" : "explicit"),
+        autoResolvedRoot: metadata.autoResolvedRoot ?? false,
+        hint: metadata.hint ?? null,
+        installMethod: metadata.installMethod ?? null,
+        installSource: metadata.installSource ?? null,
+        sourceRef: metadata.sourceRef ?? null,
+        bundlePath: metadata.bundlePath ?? null,
+        receiptPath: metadata.receiptPath,
+        ...result,
+    };
+}
 export async function runPlatformGenerate(target, opts) {
     const format = resolveOutputFormat(opts.json);
     const outputRoot = opts.dir ? resolve(opts.dir) : resolveWorkspacePath(`.generated/${target}`);
     try {
         const manifest = await loadToolkitManifest();
         const platformModule = await loadPlatformModule(target);
-        const plan = createGenerationPlan(target, platformModule, manifest);
+        let plan = createGenerationPlan(target, platformModule, manifest);
+        let bundleType;
+        let bundlePath;
+        if (opts.bundle) {
+            if (target !== "qwen") {
+                throw new Error(`${target} 暂不支持 bundle 导出。当前仅 qwen 支持 --bundle release-bundle。`);
+            }
+            const installPlan = createInstallPlan(target, platformModule, manifest, outputRoot, "dir", resolveOverwriteMode(opts.force));
+            bundleType = opts.bundle;
+            bundlePath = outputRoot;
+            plan = {
+                ...installPlan,
+                artifacts: toQwenOfficialCliReleaseArtifacts(installPlan, outputRoot),
+            };
+        }
         if (opts.plan) {
-            emitOutput(format, buildPlanPayload("generate", target, outputRoot, {
-                ...plan,
-                artifacts: plan.artifacts.map((artifact) => ({
-                    path: join(outputRoot, artifact.path),
-                    content: artifact.content
-                }))
-            }), summarizePlan("generate", target, outputRoot, {
-                ...plan,
-                artifacts: plan.artifacts.map((artifact) => ({
-                    path: join(outputRoot, artifact.path),
-                    content: artifact.content
-                }))
+            const outputPlan = bundleType
+                ? plan
+                : {
+                    ...plan,
+                    artifacts: plan.artifacts.map((artifact) => ({
+                        path: join(outputRoot, artifact.path),
+                        content: artifact.content,
+                    })),
+                };
+            emitOutput(format, buildPlanPayload("generate", target, outputRoot, outputPlan, {
+                bundleType,
+                bundlePath,
+            }), summarizePlan("generate", target, outputRoot, outputPlan, {
+                bundleType,
+                bundlePath,
             }));
             return;
         }
-        const result = await writeArtifacts(plan.artifacts.map((artifact) => ({
-            path: join(outputRoot, artifact.path),
-            content: artifact.content
-        })), {
+        const result = await writeArtifacts((bundleType
+            ? plan.artifacts
+            : plan.artifacts.map((artifact) => ({
+                path: join(outputRoot, artifact.path),
+                content: artifact.content,
+            }))), {
             dryRun: false,
             overwrite: resolveOverwriteMode(opts.force)
         });
-        emitOutput(format, buildResultPayload("generate", target, outputRoot, result), summarizeResult("generate", target, outputRoot, result));
+        emitOutput(format, buildResultPayload("generate", target, outputRoot, result, {
+            bundleType,
+            bundlePath,
+        }), summarizeResult("generate", target, outputRoot, result, {
+            bundleType,
+            bundlePath,
+        }));
     }
     catch (error) {
         emitPlatformError(format, target, "generate", error instanceof Error ? `${target} 生成失败：${error.message}` : `${target} 生成失败。`);
@@ -315,9 +744,29 @@ function getUpdateOverwriteMode(status, force) {
     }
     return resolveOverwriteMode(force);
 }
+async function removeOptionalManagedPath(path) {
+    if (!path) {
+        return {
+            removed: false,
+            missing: false,
+        };
+    }
+    if (!(await pathExists(path))) {
+        return {
+            removed: false,
+            missing: true,
+        };
+    }
+    await removeManagedPaths([path]);
+    return {
+        removed: true,
+        missing: false,
+    };
+}
 export async function runPlatformInstall(target, opts) {
     const format = resolveOutputFormat(opts.json);
     let destinationRoot = "";
+    let fallbackHint;
     try {
         const scope = resolveScopeFromSelector(opts);
         const targetResolution = await resolveInstallTarget(target, {
@@ -331,20 +780,128 @@ export async function runPlatformInstall(target, opts) {
         const overwrite = resolveOverwriteMode(opts.force);
         const manifest = await loadToolkitManifest();
         const platformModule = await loadPlatformModule(target);
-        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, overwrite);
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, overwrite);
+        const qwenReleaseBundlePath = shouldPreferQwenOfficialCli(target, scope)
+            ? resolveQwenOfficialCliReleaseBundleDir(plan)
+            : null;
+        const qwenInstallSource = shouldPreferQwenOfficialRepoInstall(target, scope) ? "github-repo" : "local-bundle";
         if (opts.plan) {
             emitOutput(format, buildPlanPayload("install", target, destinationRoot, plan, {
                 autoResolvedRoot,
                 rootSource: targetResolution.source,
                 hint: targetResolution.hint,
                 scope,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath : null,
             }), summarizePlan("install", target, destinationRoot, plan, {
                 autoResolvedRoot,
                 rootSource: targetResolution.source,
                 hint: targetResolution.hint,
+                scope,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath : null,
             }));
             return;
         }
+        if (shouldPreferQwenOfficialCli(target, scope)) {
+            const status = await resolvePlatformInstallStatus(plan);
+            if (status.kind === "drifted" && !opts.force) {
+                emitPlatformError(format, target, "install", `${target} 安装目录已漂移。请先运行 \`zc platform status ${target}\` 检查差异，确认后追加 \`--force\` 再安装。`, {
+                    root: destinationRoot,
+                    receiptPath: status.receiptPath,
+                    status: status.kind,
+                });
+                process.exitCode = 1;
+                return;
+            }
+            try {
+                let releaseBundleDir = null;
+                if (format === "text") {
+                    console.log(`正在调用官方命令：qwen extensions ${status.kind === "not-installed" ? "install" : "update"} …`);
+                }
+                if (status.kind === "not-installed") {
+                    if (qwenInstallSource === "github-repo") {
+                        await installQwenExtensionFromOfficialRepoWithCli(qwenOfficialExtensionRepoUrl);
+                    }
+                    else {
+                        const releaseBundle = await syncQwenOfficialCliReleaseBundle(plan);
+                        releaseBundleDir = releaseBundle.bundleDir;
+                        await installQwenExtensionWithOfficialCli(releaseBundle.bundleDir);
+                    }
+                }
+                else if (status.kind !== "up-to-date") {
+                    if (qwenInstallSource === "github-repo") {
+                        await updateQwenExtensionWithOfficialCli(plan.capability?.extension?.name ?? "zc-toolkit");
+                    }
+                    else {
+                        const releaseBundle = await syncQwenOfficialCliReleaseBundle(plan);
+                        releaseBundleDir = releaseBundle.bundleDir;
+                        await uninstallQwenExtensionWithOfficialCli(releaseBundle.extensionName);
+                        await relinkQwenExtensionWithOfficialCli(releaseBundle.bundleDir);
+                    }
+                }
+                await writePlatformInstallReceiptForPlan(plan, {
+                    installedAt: new Date().toISOString(),
+                    zcVersion: getCliVersion(),
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : undefined,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : undefined,
+                    bundlePath: qwenInstallSource === "local-bundle" ? releaseBundleDir ?? qwenReleaseBundlePath ?? undefined : undefined,
+                });
+                const result = status.kind === "up-to-date"
+                    ? {
+                        created: 0,
+                        overwritten: 0,
+                        unchanged: plan.artifacts.length,
+                        skipped: 0,
+                        dryRun: false,
+                    }
+                    : estimateManagedInstallResult(plan, status);
+                emitOutput(format, buildResultPayload("install", target, destinationRoot, result, {
+                    autoResolvedRoot,
+                    rootSource: targetResolution.source,
+                    hint: targetResolution.hint,
+                    scope,
+                    receiptPath: resolvePlatformInstallReceiptPath(plan),
+                    zcVersion: getCliVersion(),
+                    contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                    status: status.kind === "up-to-date" ? status.kind : "installed",
+                    noop: status.kind === "up-to-date",
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                    bundlePath: qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath : null,
+                }), summarizeResult("install", target, destinationRoot, result, {
+                    autoResolvedRoot,
+                    rootSource: targetResolution.source,
+                    hint: targetResolution.hint,
+                    scope,
+                    receiptPath: resolvePlatformInstallReceiptPath(plan),
+                    zcVersion: getCliVersion(),
+                    contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                    status: status.kind === "up-to-date" ? `${status.kind}（${formatStatusLabel(status.kind)}）` : "installed",
+                    noop: status.kind === "up-to-date",
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                    bundlePath: qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath : null,
+                }));
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof QwenOfficialCliUnavailableError)) {
+                    throw error;
+                }
+                fallbackHint = "未检测到 qwen CLI，已回退为直接写入官方扩展目录。";
+            }
+        }
         const result = await writeArtifacts(plan.artifacts.map((artifact) => ({
             path: artifact.path,
             content: artifact.content
@@ -359,20 +916,31 @@ export async function runPlatformInstall(target, opts) {
         emitOutput(format, buildResultPayload("install", target, destinationRoot, result, {
             autoResolvedRoot,
             rootSource: targetResolution.source,
-            hint: targetResolution.hint,
+            hint: mergeHints(targetResolution.hint, fallbackHint),
             scope,
             receiptPath: resolvePlatformInstallReceiptPath(plan),
             zcVersion: getCliVersion(),
             contentFingerprint: plan.metadata?.fingerprint.value ?? null,
             status: "installed",
+            installMethod: "filesystem",
+            installSource: null,
+            sourceRef: null,
+            bundleType: null,
+            bundlePath: qwenReleaseBundlePath,
         }), summarizeResult("install", target, destinationRoot, result, {
             autoResolvedRoot,
             rootSource: targetResolution.source,
-            hint: targetResolution.hint,
+            hint: mergeHints(targetResolution.hint, fallbackHint),
+            scope,
             receiptPath: resolvePlatformInstallReceiptPath(plan),
             zcVersion: getCliVersion(),
             contentFingerprint: plan.metadata?.fingerprint.value ?? null,
             status: "installed",
+            installMethod: "filesystem",
+            installSource: null,
+            sourceRef: null,
+            bundleType: undefined,
+            bundlePath: qwenReleaseBundlePath ?? undefined,
         }));
     }
     catch (error) {
@@ -398,22 +966,53 @@ export async function runPlatformStatus(target, opts) {
         const destinationRoot = resolve(targetResolution.root);
         const manifest = await loadToolkitManifest();
         const platformModule = await loadPlatformModule(target);
-        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, "error");
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, "error");
         const status = await resolvePlatformInstallStatus(plan);
         const zcVersion = getCliVersion();
-        emitOutput(format, buildStatusPayload(target, destinationRoot, {
-            ...status,
-            zcVersion,
-        }, {
+        const installMethod = status.receipt ? (status.receipt.installMethod ?? "filesystem") : undefined;
+        const installSource = status.receipt?.installSource ?? undefined;
+        const sourceRef = status.receipt?.sourceRef ?? undefined;
+        const bundleType = status.receipt?.bundleType ?? undefined;
+        const bundlePath = status.receipt?.bundlePath ?? undefined;
+        const recommendedInstallMethod = shouldPreferQwenOfficialCli(target, scope) ? "qwen-cli" : undefined;
+        const recommendedInstallSource = shouldPreferQwenOfficialRepoInstall(target, scope) ? "github-repo" : undefined;
+        const recommendedSourceRef = recommendedInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : undefined;
+        const recommendedBundleType = shouldPreferQwenOfficialCli(target, scope) ? "release-bundle" : undefined;
+        const recommendedBundlePath = shouldPreferQwenOfficialCli(target, scope)
+            ? resolveQwenOfficialCliReleaseBundleDir(plan)
+            : undefined;
+        emitOutput(format, buildStatusPayload(target, destinationRoot, status, {
             scope,
             rootSource: targetResolution.source,
             hint: targetResolution.hint,
             zcVersion,
+            plan,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundleType,
+            bundlePath,
+            recommendedInstallMethod,
+            recommendedInstallSource,
+            recommendedSourceRef,
+            recommendedBundleType,
+            recommendedBundlePath,
         }), summarizeStatus(target, destinationRoot, status, {
             scope,
             rootSource: targetResolution.source,
             hint: targetResolution.hint,
             zcVersion,
+            plan,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundleType,
+            bundlePath,
+            recommendedInstallMethod,
+            recommendedInstallSource,
+            recommendedSourceRef,
+            recommendedBundleType,
+            recommendedBundlePath,
         }));
     }
     catch (error) {
@@ -424,6 +1023,7 @@ export async function runPlatformStatus(target, opts) {
 export async function runPlatformUpdate(target, opts) {
     const format = resolveOutputFormat(opts.json);
     let destinationRoot = "";
+    let fallbackHint;
     try {
         const scope = resolveScopeFromSelector(opts);
         const targetResolution = await resolveInstallTarget(target, {
@@ -436,9 +1036,13 @@ export async function runPlatformUpdate(target, opts) {
         destinationRoot = resolve(targetResolution.root);
         const manifest = await loadToolkitManifest();
         const platformModule = await loadPlatformModule(target);
-        const statusPlan = createInstallPlan(target, platformModule, manifest, destinationRoot, "error");
+        const statusPlan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, "error");
         const status = await resolvePlatformInstallStatus(statusPlan);
         const zcVersion = getCliVersion();
+        const qwenReleaseBundlePath = shouldPreferQwenOfficialCli(target, scope)
+            ? resolveQwenOfficialCliReleaseBundleDir(statusPlan)
+            : undefined;
+        const qwenInstallSource = shouldPreferQwenOfficialRepoInstall(target, scope) ? "github-repo" : "local-bundle";
         if (status.kind === "not-installed") {
             emitPlatformError(format, target, "update", `${target} 尚未安装到该目录。请先运行 \`zc platform install ${target}\`。`, {
                 root: destinationRoot,
@@ -465,15 +1069,26 @@ export async function runPlatformUpdate(target, opts) {
                 contentFingerprint: status.contentFingerprint ?? null,
                 status: status.kind,
                 noop: true,
+                installMethod: target === "qwen" && scope === "global" ? "qwen-cli" : undefined,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? null : null,
             }), summarizeResult("update", target, destinationRoot, result, {
                 autoResolvedRoot,
                 rootSource: targetResolution.source,
                 hint: targetResolution.hint,
+                scope,
                 receiptPath: status.receiptPath,
                 zcVersion,
                 contentFingerprint: status.contentFingerprint ?? null,
                 status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
                 noop: true,
+                installMethod: target === "qwen" && scope === "global" ? "qwen-cli" : undefined,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : undefined,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath : undefined,
             }));
             return;
         }
@@ -487,7 +1102,7 @@ export async function runPlatformUpdate(target, opts) {
             return;
         }
         const overwrite = getUpdateOverwriteMode(status, opts.force);
-        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, overwrite);
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, overwrite);
         if (opts.plan) {
             emitOutput(format, buildPlanPayload("update", target, destinationRoot, plan, {
                 autoResolvedRoot,
@@ -495,14 +1110,84 @@ export async function runPlatformUpdate(target, opts) {
                 hint: targetResolution.hint,
                 scope,
                 status: status.kind,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? null : null,
             }), summarizePlan("update", target, destinationRoot, plan, {
                 autoResolvedRoot,
                 rootSource: targetResolution.source,
                 hint: targetResolution.hint,
+                scope,
                 status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+                installSource: target === "qwen" && scope === "global" ? qwenInstallSource : null,
+                sourceRef: target === "qwen" && scope === "global" && qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                bundleType: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: target === "qwen" && scope === "global" && qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? null : null,
             }));
             return;
         }
+        if (shouldPreferQwenOfficialCli(target, scope)) {
+            try {
+                if (format === "text") {
+                    console.log("正在调用官方命令：qwen extensions update …");
+                }
+                if (qwenInstallSource === "github-repo") {
+                    await updateQwenExtensionWithOfficialCli(plan.capability?.extension?.name ?? "zc-toolkit");
+                }
+                else {
+                    const releaseBundle = await syncQwenOfficialCliReleaseBundle(plan);
+                    await uninstallQwenExtensionWithOfficialCli(releaseBundle.extensionName);
+                    await relinkQwenExtensionWithOfficialCli(releaseBundle.bundleDir);
+                }
+                await writePlatformInstallReceiptForPlan(plan, {
+                    installedAt: new Date().toISOString(),
+                    zcVersion,
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : undefined,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : undefined,
+                    bundlePath: qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? undefined : undefined,
+                });
+                const result = estimateManagedInstallResult(plan, status);
+                emitOutput(format, buildResultPayload("update", target, destinationRoot, result, {
+                    autoResolvedRoot,
+                    rootSource: targetResolution.source,
+                    hint: targetResolution.hint,
+                    scope,
+                    receiptPath: resolvePlatformInstallReceiptPath(plan),
+                    zcVersion,
+                    contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                    status: status.kind,
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                    bundlePath: qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? null : null,
+                }), summarizeResult("update", target, destinationRoot, result, {
+                    autoResolvedRoot,
+                    rootSource: targetResolution.source,
+                    hint: targetResolution.hint,
+                    scope,
+                    receiptPath: resolvePlatformInstallReceiptPath(plan),
+                    zcVersion,
+                    contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                    status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+                    installMethod: "qwen-cli",
+                    installSource: qwenInstallSource,
+                    sourceRef: qwenInstallSource === "github-repo" ? qwenOfficialExtensionRepoUrl : null,
+                    bundleType: qwenInstallSource === "local-bundle" ? "release-bundle" : null,
+                    bundlePath: qwenInstallSource === "local-bundle" ? qwenReleaseBundlePath ?? null : null,
+                }));
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof QwenOfficialCliUnavailableError)) {
+                    throw error;
+                }
+                fallbackHint = "未检测到 qwen CLI，已回退为直接写入官方扩展目录。";
+            }
+        }
         const result = await writeArtifacts(plan.artifacts.map((artifact) => ({
             path: artifact.path,
             content: artifact.content,
@@ -517,20 +1202,31 @@ export async function runPlatformUpdate(target, opts) {
         emitOutput(format, buildResultPayload("update", target, destinationRoot, result, {
             autoResolvedRoot,
             rootSource: targetResolution.source,
-            hint: targetResolution.hint,
+            hint: mergeHints(targetResolution.hint, fallbackHint),
             scope,
             receiptPath: resolvePlatformInstallReceiptPath(plan),
             zcVersion,
             contentFingerprint: plan.metadata?.fingerprint.value ?? null,
             status: status.kind,
+            installMethod: "filesystem",
+            installSource: null,
+            sourceRef: null,
+            bundleType: null,
+            bundlePath: null,
         }), summarizeResult("update", target, destinationRoot, result, {
             autoResolvedRoot,
             rootSource: targetResolution.source,
-            hint: targetResolution.hint,
+            hint: mergeHints(targetResolution.hint, fallbackHint),
+            scope,
             receiptPath: resolvePlatformInstallReceiptPath(plan),
             zcVersion,
             contentFingerprint: plan.metadata?.fingerprint.value ?? null,
             status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+            installMethod: "filesystem",
+            installSource: null,
+            sourceRef: null,
+            bundleType: undefined,
+            bundlePath: undefined,
         }));
     }
     catch (error) {
@@ -543,6 +1239,382 @@ export async function runPlatformUpdate(target, opts) {
         process.exitCode = 1;
     }
 }
+export async function runPlatformUninstall(target, opts) {
+    const format = resolveOutputFormat(opts.json);
+    try {
+        const scope = resolveScopeFromSelector(opts);
+        const targetResolution = await resolveInstallTarget(target, {
+            dir: opts.dir,
+            cwd: process.cwd(),
+            project: opts.project,
+            global: opts.global,
+        });
+        const autoResolvedRoot = targetResolution.source !== "explicit";
+        const destinationRoot = resolve(targetResolution.root);
+        const manifest = await loadToolkitManifest();
+        const platformModule = await loadPlatformModule(target);
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, "error");
+        const status = await resolvePlatformInstallStatus(plan);
+        if (!status.receipt) {
+            emitPlatformError(format, target, "uninstall", `${target} 当前目录没有受管安装回执，拒绝自动卸载。请先运行 \`zc platform status ${target}\` 检查。`, {
+                root: destinationRoot,
+                receiptPath: status.receiptPath,
+                status: status.kind,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        if (status.kind === "drifted" && !opts.force) {
+            emitPlatformError(format, target, "uninstall", `${target} 安装目录已漂移。请先运行 \`zc platform doctor ${target}\` 或 \`zc platform status ${target}\` 检查，确认后追加 \`--force\` 再卸载。`, {
+                root: destinationRoot,
+                receiptPath: status.receiptPath,
+                status: status.kind,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        const installMethod = status.receipt.installMethod ?? "filesystem";
+        const installSource = status.receipt.installSource ?? null;
+        const sourceRef = status.receipt.sourceRef ?? null;
+        const bundlePath = status.receipt.bundlePath ?? null;
+        if (opts.plan) {
+            emitOutput(format, {
+                mode: "plan",
+                action: "uninstall",
+                target,
+                root: destinationRoot,
+                scope,
+                rootSource: targetResolution.source,
+                autoResolvedRoot,
+                hint: targetResolution.hint ?? null,
+                status: status.kind,
+                receiptPath: status.receiptPath,
+                installMethod,
+                installSource,
+                sourceRef,
+                bundlePath,
+                artifactCount: status.receipt.artifacts.length,
+                artifacts: status.receipt.artifacts.map((artifact) => artifact.path),
+            }, [
+                `${target} 卸载计划`,
+                formatRootLabel("uninstall", destinationRoot, {
+                    autoResolvedRoot,
+                    rootSource: targetResolution.source,
+                    hint: targetResolution.hint,
+                }),
+                `状态：${status.kind}（${formatStatusLabel(status.kind)}）`,
+                `安装方式：${installMethod === "qwen-cli" ? "官方 qwen extensions CLI" : "直接写入"}`,
+                ...(installSource ? [`安装来源：${installSource === "github-repo" ? "GitHub 扩展仓库" : "本地 bundle"}`] : []),
+                ...(sourceRef ? [`来源：${sourceRef}`] : []),
+                `回执：${status.receiptPath}`,
+                ...(bundlePath ? [`Bundle 目录：${bundlePath}`] : []),
+                `受管产物：${status.receipt.artifacts.length}`,
+                ...status.receipt.artifacts.map((artifact) => `- ${artifact.path}`),
+            ].join("\n"));
+            return;
+        }
+        let artifactCleanup = { removed: 0, missing: 0 };
+        if (target === "qwen" && installMethod === "qwen-cli") {
+            const extensionName = plan.capability?.extension?.name ?? "zc-toolkit";
+            if (format === "text") {
+                console.log(`正在调用官方命令：qwen extensions uninstall ${extensionName} …`);
+            }
+            await uninstallQwenExtensionWithOfficialCli(extensionName);
+        }
+        else {
+            artifactCleanup = await removeManagedPaths(status.receipt.artifacts.map((artifact) => artifact.path));
+        }
+        const bundleCleanup = await removeOptionalManagedPath(bundlePath);
+        const receiptExisted = await pathExists(status.receiptPath);
+        if (receiptExisted) {
+            await deletePlatformInstallReceipt(status.receiptPath);
+        }
+        const result = {
+            removedArtifacts: artifactCleanup.removed,
+            missingArtifacts: artifactCleanup.missing,
+            bundleRemoved: bundleCleanup.removed,
+            bundleMissing: bundleCleanup.missing,
+            receiptRemoved: receiptExisted,
+            receiptMissing: !receiptExisted,
+        };
+        emitOutput(format, buildUninstallPayload(target, destinationRoot, result, {
+            autoResolvedRoot,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            scope,
+            receiptPath: status.receiptPath,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundlePath,
+        }), summarizeUninstall(target, destinationRoot, result, {
+            autoResolvedRoot,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            scope,
+            receiptPath: status.receiptPath,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundlePath,
+        }));
+    }
+    catch (error) {
+        emitPlatformError(format, target, "uninstall", error instanceof Error ? `${target} 卸载失败：${error.message}` : `${target} 卸载失败。`);
+        process.exitCode = 1;
+    }
+}
+export async function runPlatformRepair(target, opts) {
+    const format = resolveOutputFormat(opts.json);
+    try {
+        const scope = resolveScopeFromSelector(opts);
+        const targetResolution = await resolveInstallTarget(target, {
+            dir: opts.dir,
+            cwd: process.cwd(),
+            project: opts.project,
+            global: opts.global,
+        });
+        const autoResolvedRoot = targetResolution.source !== "explicit";
+        const destinationRoot = resolve(targetResolution.root);
+        const manifest = await loadToolkitManifest();
+        const platformModule = await loadPlatformModule(target);
+        const statusPlan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, "error");
+        const status = await resolvePlatformInstallStatus(statusPlan);
+        if (!status.receipt) {
+            emitPlatformError(format, target, "repair", `${target} 当前目录尚未建立受管安装状态。请先运行 \`zc platform install ${target}\`。`, {
+                root: destinationRoot,
+                receiptPath: status.receiptPath,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        const installMethod = status.receipt.installMethod ?? "filesystem";
+        const installSource = status.receipt.installSource
+            ?? (target === "qwen" && scope === "global" ? "github-repo" : undefined);
+        const sourceRef = status.receipt.sourceRef
+            ?? (installSource === "github-repo" ? qwenOfficialExtensionRepoUrl : undefined);
+        const bundlePath = status.receipt.bundlePath
+            ?? (shouldPreferQwenOfficialCli(target, scope) ? resolveQwenOfficialCliReleaseBundleDir(statusPlan) : null);
+        const bundleMissing = installSource === "local-bundle" && bundlePath ? !(await pathExists(bundlePath)) : false;
+        if (status.kind === "up-to-date" && !(target === "qwen" && installMethod === "qwen-cli" && bundleMissing)) {
+            const result = {
+                created: 0,
+                overwritten: 0,
+                unchanged: status.summary.trackedArtifacts,
+                skipped: 0,
+                dryRun: false,
+            };
+            emitOutput(format, buildResultPayload("repair", target, destinationRoot, result, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                receiptPath: status.receiptPath,
+                zcVersion: getCliVersion(),
+                contentFingerprint: status.contentFingerprint ?? null,
+                status: status.kind,
+                noop: true,
+                installMethod,
+                installSource,
+                sourceRef,
+                bundleType: status.receipt.bundleType ?? null,
+                bundlePath,
+            }), summarizeResult("repair", target, destinationRoot, result, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                receiptPath: status.receiptPath,
+                zcVersion: getCliVersion(),
+                contentFingerprint: status.contentFingerprint ?? null,
+                status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+                noop: true,
+                installMethod,
+                installSource,
+                sourceRef,
+                bundleType: status.receipt.bundleType ?? undefined,
+                bundlePath: bundlePath ?? undefined,
+            }));
+            return;
+        }
+        const overwrite = "force";
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, overwrite);
+        if (opts.plan) {
+            emitOutput(format, buildPlanPayload("repair", target, destinationRoot, plan, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                status: status.kind,
+                installSource: installSource ?? null,
+                sourceRef: sourceRef ?? null,
+                bundleType: status.receipt.bundleType ?? null,
+                bundlePath: bundlePath ?? null,
+            }), summarizePlan("repair", target, destinationRoot, plan, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+                installSource: installSource ?? null,
+                sourceRef: sourceRef ?? null,
+                bundleType: status.receipt.bundleType ?? null,
+                bundlePath: bundlePath ?? null,
+            }));
+            return;
+        }
+        if (target === "qwen" && installMethod === "qwen-cli") {
+            if (format === "text") {
+                console.log(`正在调用官方命令：qwen extensions ${installSource === "github-repo" ? "update" : bundleMissing ? "link" : "relink"} …`);
+            }
+            let repairedBundlePath;
+            if (installSource === "github-repo") {
+                await updateQwenExtensionWithOfficialCli(plan.capability?.extension?.name ?? "zc-toolkit");
+            }
+            else {
+                const releaseBundle = await syncQwenOfficialCliReleaseBundle(plan);
+                repairedBundlePath = releaseBundle.bundleDir;
+                if (bundleMissing) {
+                    await relinkQwenExtensionWithOfficialCli(releaseBundle.bundleDir);
+                }
+                else {
+                    await uninstallQwenExtensionWithOfficialCli(releaseBundle.extensionName);
+                    await relinkQwenExtensionWithOfficialCli(releaseBundle.bundleDir);
+                }
+            }
+            await writePlatformInstallReceiptForPlan(plan, {
+                installedAt: new Date().toISOString(),
+                zcVersion: getCliVersion(),
+                installMethod: "qwen-cli",
+                installSource,
+                sourceRef,
+                bundleType: installSource === "local-bundle" ? "release-bundle" : undefined,
+                bundlePath: installSource === "local-bundle" ? repairedBundlePath ?? bundlePath ?? undefined : undefined,
+            });
+            const result = status.kind === "up-to-date"
+                ? {
+                    created: 0,
+                    overwritten: 0,
+                    unchanged: plan.artifacts.length,
+                    skipped: 0,
+                    dryRun: false,
+                }
+                : estimateManagedInstallResult(plan, status);
+            emitOutput(format, buildResultPayload("repair", target, destinationRoot, result, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                receiptPath: resolvePlatformInstallReceiptPath(plan),
+                zcVersion: getCliVersion(),
+                contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                status: status.kind,
+                installMethod: "qwen-cli",
+                installSource,
+                sourceRef,
+                bundleType: installSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: installSource === "local-bundle" ? repairedBundlePath ?? bundlePath ?? null : null,
+            }), summarizeResult("repair", target, destinationRoot, result, {
+                autoResolvedRoot,
+                rootSource: targetResolution.source,
+                hint: targetResolution.hint,
+                scope,
+                receiptPath: resolvePlatformInstallReceiptPath(plan),
+                zcVersion: getCliVersion(),
+                contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+                status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+                installMethod: "qwen-cli",
+                installSource,
+                sourceRef,
+                bundleType: installSource === "local-bundle" ? "release-bundle" : null,
+                bundlePath: installSource === "local-bundle" ? repairedBundlePath ?? bundlePath ?? null : null,
+            }));
+            return;
+        }
+        const result = await writeArtifacts(plan.artifacts.map((artifact) => ({
+            path: artifact.path,
+            content: artifact.content,
+        })), {
+            dryRun: false,
+            overwrite,
+        });
+        await writePlatformInstallReceiptForPlan(plan, {
+            installedAt: new Date().toISOString(),
+            zcVersion: getCliVersion(),
+            installMethod,
+            installSource,
+            sourceRef,
+            bundleType: status.receipt.bundleType,
+            bundlePath: status.receipt.bundlePath,
+        });
+        emitOutput(format, buildResultPayload("repair", target, destinationRoot, result, {
+            autoResolvedRoot,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            scope,
+            receiptPath: resolvePlatformInstallReceiptPath(plan),
+            zcVersion: getCliVersion(),
+            contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+            status: status.kind,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundleType: status.receipt.bundleType ?? null,
+            bundlePath: status.receipt.bundlePath ?? null,
+        }), summarizeResult("repair", target, destinationRoot, result, {
+            autoResolvedRoot,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            scope,
+            receiptPath: resolvePlatformInstallReceiptPath(plan),
+            zcVersion: getCliVersion(),
+            contentFingerprint: plan.metadata?.fingerprint.value ?? null,
+            status: `${status.kind}（${formatStatusLabel(status.kind)}）`,
+            installMethod,
+            installSource,
+            sourceRef,
+            bundleType: status.receipt.bundleType ?? undefined,
+            bundlePath: status.receipt.bundlePath ?? undefined,
+        }));
+    }
+    catch (error) {
+        emitPlatformError(format, target, "repair", error instanceof Error ? `${target} 修复失败：${error.message}` : `${target} 修复失败。`);
+        process.exitCode = 1;
+    }
+}
+export async function runPlatformDoctor(target, opts) {
+    const format = resolveOutputFormat(opts.json);
+    try {
+        const scope = resolveScopeFromSelector(opts);
+        const targetResolution = await resolveInstallTarget(target, {
+            dir: opts.dir,
+            cwd: process.cwd(),
+            project: opts.project,
+            global: opts.global,
+        });
+        const destinationRoot = resolve(targetResolution.root);
+        const manifest = await loadToolkitManifest();
+        const platformModule = await loadPlatformModule(target);
+        const plan = createInstallPlan(target, platformModule, manifest, destinationRoot, scope, "error");
+        const status = await resolvePlatformInstallStatus(plan);
+        const doctor = await resolvePlatformInstallDoctor(plan, status);
+        emitOutput(format, buildDoctorPayload(target, destinationRoot, status, doctor, {
+            scope,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            plan,
+        }), summarizeDoctor(target, destinationRoot, status, doctor, {
+            scope,
+            rootSource: targetResolution.source,
+            hint: targetResolution.hint,
+            plan,
+        }));
+    }
+    catch (error) {
+        emitPlatformError(format, target, "doctor", error instanceof Error ? `${target} 诊断失败：${error.message}` : `${target} 诊断失败。`);
+        process.exitCode = 1;
+    }
+}
 export async function runPlatformWhere(target, opts) {
     const format = resolveOutputFormat(opts.json);
     try {
@@ -554,16 +1626,21 @@ export async function runPlatformWhere(target, opts) {
             global: opts.global,
         });
         const root = resolve(targetResolution.root);
+        const manifest = await loadToolkitManifest();
+        const platformModule = await loadPlatformModule(target);
+        const plan = createInstallPlan(target, platformModule, manifest, root, scope, "error");
         emitOutput(format, buildWherePayload(target, root, {
             scope,
             rootSource: targetResolution.source,
             marker: targetResolution.marker,
             hint: targetResolution.hint,
+            capability: getPlanCapabilitySummary(plan),
         }), summarizeWhere(target, root, {
             scope,
             rootSource: targetResolution.source,
             marker: targetResolution.marker,
             hint: targetResolution.hint,
+            capability: getPlanCapabilitySummary(plan),
         }));
     }
     catch (error) {
@@ -578,58 +1655,89 @@ function parsePlatformName(value) {
     throw new InvalidArgumentError(`不支持的平台：${value}。可选值：${platformNames.join(" | ")}`);
 }
 export function registerPlatformCommand(program) {
-    const platform = program.command("platform").description("平台生成和安装命令");
+    const platform = program.command("platform").description("查看、安装、更新和诊断平台内容");
     platform
         .command("generate")
         .alias("g")
-        .description("根据工具包清单生成平台产物")
-        .argument("<target>", "目标平台 (qwen|codex|qoder)", parsePlatformName)
+        .description("导出平台内容或 Qwen 发布 bundle")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
         .option("-d, --dir <dir>", "输出目录")
-        .option("--plan", "只输出产物计划，不落盘")
-        .option("-j, --json", "直接输出 JSON")
+        .option("-b, --bundle <type>", "导出指定 bundle 布局（当前仅 qwen: release-bundle）", parseGenerateBundleType)
+        .option("--plan", "只查看生成计划，不写文件")
+        .option("-j, --json", "输出 JSON")
         .option("-f, --force", "覆盖目标目录中已有但内容不同的产物")
         .action(runPlatformGenerate);
     platform
         .command("install")
         .alias("i")
-        .description("根据工具包清单生成并安装平台产物")
-        .argument("<target>", "目标平台 (qwen|codex|qoder)", parsePlatformName)
-        .option("-d, --dir <dir>", "显式安装目录")
+        .description("把平台内容安装到项目、用户级或指定目录")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "安装到指定目录")
         .option("-p, --project", "安装到当前目录向上解析出的最近项目根")
-        .option("-g, --global", "安装到官方文档定义的默认全局位置")
-        .option("--plan", "只输出安装计划，不落盘")
-        .option("-j, --json", "直接输出 JSON")
+        .option("-g, --global", "安装到官方文档定义的用户级默认位置")
+        .option("--plan", "只查看安装计划，不写文件")
+        .option("-j, --json", "输出 JSON")
         .option("-f, --force", "覆盖目标目录中已有但内容不同的产物")
         .action(runPlatformInstall);
     platform
         .command("where")
         .alias("w")
-        .description("解析平台安装目录，不执行写入")
-        .argument("<target>", "目标平台 (qwen|codex|qoder)", parsePlatformName)
-        .option("-d, --dir <dir>", "显式安装目录")
+        .description("查看平台内容会安装到哪里")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
         .option("-p, --project", "解析最近项目根")
         .option("-g, --global", "解析官方文档定义的默认全局位置")
-        .option("-j, --json", "直接输出 JSON")
+        .option("-j, --json", "输出 JSON")
         .action(runPlatformWhere);
     platform
         .command("status")
-        .description("读取安装回执并检查平台内容状态")
-        .argument("<target>", "目标平台 (qwen|codex|qoder)", parsePlatformName)
-        .option("-d, --dir <dir>", "显式安装目录")
+        .description("查看是否已安装、是否可更新、是否漂移")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
         .option("-p, --project", "解析最近项目根")
         .option("-g, --global", "解析官方文档定义的默认全局位置")
-        .option("-j, --json", "直接输出 JSON")
+        .option("-j, --json", "输出 JSON")
         .action(runPlatformStatus);
     platform
         .command("update")
-        .description("基于安装回执更新平台产物")
-        .argument("<target>", "目标平台 (qwen|codex|qoder)", parsePlatformName)
-        .option("-d, --dir <dir>", "显式安装目录")
+        .description("更新已安装的平台内容")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
         .option("-p, --project", "解析最近项目根")
         .option("-g, --global", "解析官方文档定义的默认全局位置")
-        .option("--plan", "只输出更新计划，不落盘")
-        .option("-j, --json", "直接输出 JSON")
+        .option("--plan", "只查看更新计划，不写文件")
+        .option("-j, --json", "输出 JSON")
         .option("-f, --force", "覆盖已漂移的已安装产物")
         .action(runPlatformUpdate);
+    platform
+        .command("uninstall")
+        .description("卸载受管平台内容并删除安装记录")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
+        .option("-p, --project", "解析最近项目根")
+        .option("-g, --global", "解析官方文档定义的默认全局位置")
+        .option("--plan", "只查看卸载计划，不写文件")
+        .option("-j, --json", "输出 JSON")
+        .option("-f, --force", "允许卸载已漂移的受管内容")
+        .action(runPlatformUninstall);
+    platform
+        .command("repair")
+        .description("修复漂移、缺失或官方 CLI 失配的安装")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
+        .option("-p, --project", "解析最近项目根")
+        .option("-g, --global", "解析官方文档定义的默认全局位置")
+        .option("--plan", "只查看修复计划，不写文件")
+        .option("-j, --json", "输出 JSON")
+        .action(runPlatformRepair);
+    platform
+        .command("doctor")
+        .description("诊断当前平台安装的健康度和下一步建议")
+        .argument("<target>", "目标平台 (qwen|codex|claude|opencode)", parsePlatformName)
+        .option("-d, --dir <dir>", "指定目录")
+        .option("-p, --project", "解析最近项目根")
+        .option("-g, --global", "解析官方文档定义的默认全局位置")
+        .option("-j, --json", "输出 JSON")
+        .action(runPlatformDoctor);
 }
 //# sourceMappingURL=platform.js.map