xtep-workspace 1.10.10

package/dist/services/GuidanceService.js

@@ -0,0 +1,259 @@
+// src/services/GuidanceService.ts
+// 引导内容生成服务 - 场景检测与内容生成
+import { getGuidanceConfig } from "../prompts/guidanceContent.js";
+/**
+ * 引导服务
+ * 实现场景检测和引导内容生成
+ */
+export class GuidanceService {
+    /**
+     * 检测当前场景
+     * @param context 当前操作上下文
+     * @returns 检测到的场景类型
+     */
+    detectScenario(context) {
+        // 1. 优先检查错误场景
+        if (context.error) {
+            return this.detectErrorScenario(context);
+        }
+        // 2. 检查工具名称，确定操作类型
+        const toolName = context.toolName;
+        if (!toolName) {
+            return "unknown";
+        }
+        // 3. 根据工具名称分发到具体的检测逻辑
+        switch (toolName) {
+            case "workspace_init":
+                return "workspace_init";
+            case "workspace_archive":
+                return "workspace_archived";
+            case "workspace_restore":
+                return "workspace_restored";
+            case "node_create":
+                return this.detectNodeCreateScenario(context);
+            case "node_transition":
+                return this.detectNodeTransitionScenario(context);
+            case "node_get":
+            case "context_get":
+                return this.detectContextScenario(context);
+            default:
+                return "unknown";
+        }
+    }
+    /**
+     * 检测错误场景
+     */
+    detectErrorScenario(context) {
+        const errorCode = context.error?.code;
+        if (!errorCode) {
+            return "unknown";
+        }
+        // 映射错误代码到场景
+        if (errorCode === "INVALID_TRANSITION") {
+            return "error_invalid_transition";
+        }
+        if (errorCode === "EXECUTION_HAS_CHILDREN") {
+            return "error_execution_has_children";
+        }
+        if (errorCode === "WORKSPACE_NOT_FOUND" ||
+            errorCode === "NODE_NOT_FOUND") {
+            return "error_workspace_not_found";
+        }
+        return "unknown";
+    }
+    /**
+     * 检测节点创建场景
+     */
+    detectNodeCreateScenario(context) {
+        const nodeType = context.nodeType;
+        const nodeRole = context.nodeRole;
+        // 信息收集节点优先识别
+        if (nodeRole === "info_collection") {
+            return "node_create_info_collection";
+        }
+        // 根据节点类型
+        if (nodeType === "planning") {
+            return "node_create_planning";
+        }
+        if (nodeType === "execution") {
+            return "node_create_execution";
+        }
+        return "unknown";
+    }
+    /**
+     * 检测节点状态转换场景
+     */
+    detectNodeTransitionScenario(context) {
+        const action = context.toolInput?.action;
+        const nodeType = context.nodeType;
+        const nodeStatus = context.nodeStatus;
+        const hasChildren = context.hasChildren;
+        if (!action || !nodeType) {
+            return "unknown";
+        }
+        // 检查 reopen 已有子节点的情况
+        if (action === "reopen" && hasChildren) {
+            return "node_reopen_with_children";
+        }
+        // 检查是否是根节点首次 start
+        if (action === "start" &&
+            nodeType === "planning" &&
+            nodeStatus === "pending" &&
+            context.extra?.isRootNode) {
+            return "workspace_first_planning";
+        }
+        // 执行节点状态转换
+        if (nodeType === "execution") {
+            switch (action) {
+                case "start":
+                    return "execution_start";
+                case "complete":
+                    return "execution_complete";
+                case "fail":
+                    return "execution_fail";
+                default:
+                    return "unknown";
+            }
+        }
+        // 规划节点状态转换
+        if (nodeType === "planning") {
+            switch (action) {
+                case "start":
+                    return "planning_start";
+                case "complete":
+                    return "planning_complete";
+                default:
+                    return "unknown";
+            }
+        }
+        // 规划节点进入 monitoring
+        if (nodeType === "planning" && nodeStatus === "monitoring") {
+            return "planning_monitoring";
+        }
+        return "unknown";
+    }
+    /**
+     * 检测上下文查询场景
+     * 用于检测特殊情况（如缺少信息收集节点、文档派发等）
+     */
+    detectContextScenario(context) {
+        // 检查是否有 actionRequired
+        if (context.toolOutput?.actionRequired) {
+            const actionRequired = context.toolOutput.actionRequired;
+            if (actionRequired.confirmationToken) {
+                return "confirmation_required";
+            }
+            return "actionRequired_triggered";
+        }
+        // 检查是否缺少信息收集节点
+        if (context.extra?.needsInfoCollection) {
+            return "info_collection_missing";
+        }
+        // 检查是否缺少文档派发
+        if (context.extra?.docsNotDispatched) {
+            return "docs_派发_missing";
+        }
+        return "unknown";
+    }
+    /**
+     * 生成引导内容
+     * @param scenario 场景类型
+     * @param level 引导级别
+     * @param context 上下文数据（用于动态填充）
+     * @returns 引导内容
+     */
+    generate(scenario, level, context) {
+        const config = this.getConfig(scenario);
+        if (!config) {
+            return {
+                level,
+                scenario,
+                content: "未找到对应的引导内容配置",
+                expandable: false,
+            };
+        }
+        // 根据级别选择内容
+        let content;
+        let expandable;
+        switch (level) {
+            case 0:
+                content = config.l0;
+                expandable = true;
+                break;
+            case 1:
+                content = config.l1;
+                expandable = true;
+                break;
+            case 2:
+                content = config.l2;
+                expandable = false;
+                break;
+            default:
+                content = config.l0;
+                expandable = true;
+        }
+        // 动态替换占位符（如果有 context）
+        if (context) {
+            content = this.replacePlaceholders(content, context);
+        }
+        return {
+            level,
+            scenario,
+            content,
+            expandable,
+            expandTo: expandable && level < 2 ? scenario : undefined,
+            relatedHelpTopics: config.relatedHelpTopics,
+            metadata: config.metadata,
+        };
+    }
+    /**
+     * 替换内容中的占位符
+     */
+    replacePlaceholders(content, context) {
+        let result = content;
+        // 替换节点类型
+        if (context.nodeType) {
+            result = result.replace(/\{nodeType\}/g, context.nodeType);
+        }
+        // 替换节点状态
+        if (context.nodeStatus) {
+            result = result.replace(/\{nodeStatus\}/g, context.nodeStatus);
+        }
+        // 替换错误信息
+        if (context.error) {
+            result = result.replace(/\{errorCode\}/g, context.error.code);
+            result = result.replace(/\{errorMessage\}/g, context.error.message);
+        }
+        return result;
+    }
+    /**
+     * 获取场景的完整配置
+     * @param scenario 场景类型
+     * @returns 引导配置
+     */
+    getConfig(scenario) {
+        return getGuidanceConfig(scenario);
+    }
+    /**
+     * 便捷方法：直接获取指定场景和级别的内容
+     * @param scenario 场景类型
+     * @param level 引导级别（默认 L0）
+     * @param context 上下文数据
+     * @returns 引导内容字符串，如果未找到则返回空字符串
+     */
+    getContent(scenario, level = 0, context) {
+        const guidance = this.generate(scenario, level, context);
+        return guidance.content;
+    }
+    /**
+     * 便捷方法：从上下文自动检测场景并生成引导
+     * @param context 上下文数据
+     * @param level 引导级别（默认 L0）
+     * @returns 引导内容
+     */
+    generateFromContext(context, level = 0) {
+        const scenario = this.detectScenario(context);
+        return this.generate(scenario, level, context);
+    }
+}
+//# sourceMappingURL=GuidanceService.js.map

package/dist/services/GuidanceService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceService.js","sourceRoot":"","sources":["../../src/services/GuidanceService.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,uBAAuB;AAUvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,cAAc,CAAC,OAAwB;QACrC,cAAc;QACd,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAElC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,sBAAsB;QACtB,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,gBAAgB;gBACnB,OAAO,gBAAgB,CAAC;YAE1B,KAAK,mBAAmB;gBACtB,OAAO,oBAAoB,CAAC;YAE9B,KAAK,mBAAmB;gBACtB,OAAO,oBAAoB,CAAC;YAE9B,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAEhD,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;YAEpD,KAAK,UAAU,CAAC;YAChB,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAE7C;gBACE,OAAO,SAAS,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAwB;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAEtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,YAAY;QACZ,IAAI,SAAS,KAAK,oBAAoB,EAAE,CAAC;YACvC,OAAO,0BAA0B,CAAC;QACpC,CAAC;QAED,IAAI,SAAS,KAAK,wBAAwB,EAAE,CAAC;YAC3C,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,IACE,SAAS,KAAK,qBAAqB;YACnC,SAAS,KAAK,gBAAgB,EAC9B,CAAC;YACD,OAAO,2BAA2B,CAAC;QACrC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,wBAAwB,CAC9B,OAAwB;QAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAElC,aAAa;QACb,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACnC,OAAO,6BAA6B,CAAC;QACvC,CAAC;QAED,SAAS;QACT,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,4BAA4B,CAClC,OAAwB;QAExB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,MAAgB,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAExC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qBAAqB;QACrB,IAAI,MAAM,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;YACvC,OAAO,2BAA2B,CAAC;QACrC,CAAC;QAED,mBAAmB;QACnB,IACE,MAAM,KAAK,OAAO;YAClB,QAAQ,KAAK,UAAU;YACvB,UAAU,KAAK,SAAS;YACxB,OAAO,CAAC,KAAK,EAAE,UAAU,EACzB,CAAC;YACD,OAAO,0BAA0B,CAAC;QACpC,CAAC;QAED,WAAW;QACX,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,OAAO;oBACV,OAAO,iBAAiB,CAAC;gBAC3B,KAAK,UAAU;oBACb,OAAO,oBAAoB,CAAC;gBAC9B,KAAK,MAAM;oBACT,OAAO,gBAAgB,CAAC;gBAC1B;oBACE,OAAO,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QAED,WAAW;QACX,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,OAAO;oBACV,OAAO,gBAAgB,CAAC;gBAC1B,KAAK,UAAU;oBACb,OAAO,mBAAmB,CAAC;gBAC7B;oBACE,OAAO,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,QAAQ,KAAK,UAAU,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YAC3D,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,OAAwB;QACpD,uBAAuB;QACvB,IAAI,OAAO,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC;YACvC,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,cAGzC,CAAC;YACF,IAAI,cAAc,CAAC,iBAAiB,EAAE,CAAC;gBACrC,OAAO,uBAAuB,CAAC;YACjC,CAAC;YACD,OAAO,0BAA0B,CAAC;QACpC,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;YACvC,OAAO,yBAAyB,CAAC;QACnC,CAAC;QAED,aAAa;QACb,IAAI,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC;YACrC,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CACN,QAA0B,EAC1B,KAAoB,EACpB,OAAyB;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK;gBACL,QAAQ;gBACR,OAAO,EAAE,cAAc;gBACvB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,WAAW;QACX,IAAI,OAAe,CAAC;QACpB,IAAI,UAAmB,CAAC;QAExB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,CAAC;gBACJ,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,CAAC;gBACJ,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,CAAC;gBACJ,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpB,UAAU,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR;gBACE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,OAAO;YACL,KAAK;YACL,QAAQ;YACR,OAAO;YACP,UAAU;YACV,QAAQ,EAAE,UAAU,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACxD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,OAAe,EACf,OAAwB;QAExB,IAAI,MAAM,GAAG,OAAO,CAAC;QAErB,SAAS;QACT,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAED,SAAS;QACT,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;QAED,SAAS;QACT,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAA0B;QAClC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CACR,QAA0B,EAC1B,QAAuB,CAAC,EACxB,OAAyB;QAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CACjB,OAAwB,EACxB,QAAuB,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/services/HealthService.d.ts

@@ -0,0 +1,43 @@
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { HealthReport } from "../types/health.js";
+import type { WorkspaceService } from "./WorkspaceService.js";
+/**
+ * 健康检测服务
+ * 提供工作区健康状态检测功能
+ */
+export declare class HealthService {
+    private json;
+    private fs;
+    private static readonly DIAGNOSTIC_TOKEN;
+    private currentCodeVersion;
+    private workspaceService?;
+    constructor(json: JsonStorage, fs: FileSystemAdapter);
+    /**
+     * 设置 WorkspaceService 依赖（用于警告标记管理）
+     */
+    setWorkspaceService(workspaceService: WorkspaceService): void;
+    /**
+     * 获取当前代码版本
+     */
+    private getCurrentCodeVersion;
+    /**
+     * 获取诊断指南路径
+     */
+    getGuidePath(): string;
+    /**
+     * 验证诊断令牌
+     */
+    validateToken(token: string): boolean;
+    /**
+     * 执行健康检测
+     * @param workspaceId 可选，指定则只检测该工作区
+     * @returns 健康报告
+     */
+    checkHealth(workspaceId?: string): Promise<HealthReport>;
+    /**
+     * 检测单个工作区
+     */
+    private checkWorkspace;
+}
+//# sourceMappingURL=HealthService.d.ts.map

package/dist/services/HealthService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthService.d.ts","sourceRoot":"","sources":["../../src/services/HealthService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAsC,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;GAGG;AACH,qBAAa,aAAa;IAMtB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,EAAE;IANZ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IAC/D,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAGlC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,iBAAiB;IAG/B;;OAEG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI;IAI7D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,YAAY,IAAI,MAAM;IAMtB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;OAIG;IACG,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0D9D;;OAEG;YACW,cAAc;CAyK7B"}

package/dist/services/HealthService.js

@@ -0,0 +1,276 @@
+// src/services/HealthService.ts
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { createRequire } from "module";
+/**
+ * 健康检测服务
+ * 提供工作区健康状态检测功能
+ */
+export class HealthService {
+    json;
+    fs;
+    static DIAGNOSTIC_TOKEN = "HEALTH_CHECK_2025";
+    currentCodeVersion = null;
+    workspaceService;
+    constructor(json, fs) {
+        this.json = json;
+        this.fs = fs;
+    }
+    /**
+     * 设置 WorkspaceService 依赖（用于警告标记管理）
+     */
+    setWorkspaceService(workspaceService) {
+        this.workspaceService = workspaceService;
+    }
+    /**
+     * 获取当前代码版本
+     */
+    getCurrentCodeVersion() {
+        if (this.currentCodeVersion)
+            return this.currentCodeVersion;
+        try {
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = dirname(__filename);
+            const require = createRequire(import.meta.url);
+            const pkg = require(join(__dirname, "..", "..", "package.json"));
+            this.currentCodeVersion = pkg.version;
+            return this.currentCodeVersion;
+        }
+        catch {
+            return "0.0.0";
+        }
+    }
+    /**
+     * 获取诊断指南路径
+     */
+    getGuidePath() {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        return join(__dirname, "..", "..", "plugin", "docs", "diagnostic-guide.md");
+    }
+    /**
+     * 验证诊断令牌
+     */
+    validateToken(token) {
+        return token === HealthService.DIAGNOSTIC_TOKEN;
+    }
+    /**
+     * 执行健康检测
+     * @param workspaceId 可选，指定则只检测该工作区
+     * @returns 健康报告
+     */
+    async checkHealth(workspaceId) {
+        const index = await this.json.readIndex();
+        const issues = [];
+        const workspaceResults = [];
+        // 确定检测范围
+        const workspaces = workspaceId
+            ? index.workspaces.filter(ws => ws.id === workspaceId)
+            : index.workspaces.filter(ws => ws.status !== "error");
+        // 并行检测所有工作区
+        const results = await Promise.all(workspaces.map(ws => this.checkWorkspace(ws)));
+        for (const result of results) {
+            workspaceResults.push(result);
+            issues.push(...result.issues);
+            // 更新警告标记
+            if (this.workspaceService) {
+                if (result.status === "healthy") {
+                    // 检测通过，清除警告标记
+                    await this.workspaceService.clearWarningFlag(result.workspaceId);
+                }
+                else if (result.issues.length > 0) {
+                    // 检测到问题，设置警告标记
+                    await this.workspaceService.setWarningFlag(result.workspaceId, result.issues);
+                }
+            }
+        }
+        // 统计
+        const healthyCount = workspaceResults.filter(r => r.status === "healthy").length;
+        const warningCount = workspaceResults.filter(r => r.status === "warning").length;
+        const errorCount = workspaceResults.filter(r => r.status === "error").length;
+        // 确定整体状态
+        let status = "healthy";
+        if (errorCount > 0) {
+            status = "error";
+        }
+        else if (warningCount > 0) {
+            status = "warning";
+        }
+        return {
+            status,
+            checkedAt: new Date().toISOString(),
+            codeVersion: this.getCurrentCodeVersion(),
+            issues,
+            summary: {
+                totalWorkspaces: workspaceResults.length,
+                healthyWorkspaces: healthyCount,
+                warningWorkspaces: warningCount,
+                errorWorkspaces: errorCount,
+            },
+        };
+    }
+    /**
+     * 检测单个工作区
+     */
+    async checkWorkspace(entry) {
+        const issues = [];
+        const { id, name, dirName, projectRoot, status } = entry;
+        const wsDirName = dirName || id;
+        // 跳过 error 状态的工作区
+        if (status === "error") {
+            return {
+                workspaceId: id,
+                workspaceName: name,
+                status: "error",
+                issues: [{
+                        type: "dir_missing",
+                        severity: "error",
+                        target: id,
+                        message: entry.errorInfo?.message || "工作区已标记为错误状态",
+                        suggestion: "检查错误详情并尝试修复或删除",
+                    }],
+            };
+        }
+        const isArchived = status === "archived";
+        // 1. 目录存在检测
+        const workspacePath = isArchived
+            ? this.fs.getArchivePath(projectRoot, wsDirName)
+            : this.fs.getWorkspacePath(projectRoot, wsDirName);
+        if (!(await this.fs.exists(workspacePath))) {
+            issues.push({
+                type: "dir_missing",
+                severity: "error",
+                target: id,
+                message: `工作区目录不存在: ${workspacePath}`,
+                suggestion: "从备份恢复或删除该工作区",
+            });
+            return {
+                workspaceId: id,
+                workspaceName: name,
+                status: "error",
+                issues,
+            };
+        }
+        // 2. 配置文件检测
+        const configPath = isArchived
+            ? `${this.fs.getArchivePath(projectRoot, wsDirName)}/workspace.json`
+            : this.fs.getWorkspaceConfigPath(projectRoot, wsDirName);
+        if (!(await this.fs.exists(configPath))) {
+            issues.push({
+                type: "config_corrupt",
+                severity: "error",
+                target: id,
+                message: "配置文件不存在: workspace.json",
+                suggestion: "从备份恢复配置文件",
+            });
+        }
+        else {
+            try {
+                const content = await this.fs.readFile(configPath);
+                JSON.parse(content);
+            }
+            catch {
+                issues.push({
+                    type: "config_corrupt",
+                    severity: "error",
+                    target: id,
+                    message: "配置文件 JSON 格式无效",
+                    suggestion: "从备份恢复或手动修复配置文件",
+                });
+            }
+        }
+        // 3. 图文件检测
+        const graphPath = isArchived
+            ? this.fs.getGraphPathWithArchive(projectRoot, wsDirName, true)
+            : this.fs.getGraphPath(projectRoot, wsDirName);
+        if (!(await this.fs.exists(graphPath))) {
+            issues.push({
+                type: "graph_corrupt",
+                severity: "error",
+                target: id,
+                message: "图文件不存在: graph.json",
+                suggestion: "从备份恢复图文件",
+            });
+        }
+        else {
+            try {
+                const content = await this.fs.readFile(graphPath);
+                const graph = JSON.parse(content);
+                // 4. 版本检测
+                if (graph.lastWriteCodeVersion) {
+                    const currentVersion = this.getCurrentCodeVersion();
+                    const dataVersion = graph.lastWriteCodeVersion;
+                    const [dataMajor, dataMinor] = dataVersion.split(".").map(Number);
+                    const [curMajor, curMinor] = currentVersion.split(".").map(Number);
+                    if (dataMajor > curMajor || (dataMajor === curMajor && dataMinor > curMinor)) {
+                        issues.push({
+                            type: "version_mismatch",
+                            severity: "warning",
+                            target: id,
+                            message: `数据版本 ${dataVersion} 高于当前代码版本 ${currentVersion}`,
+                            suggestion: "升级 xtep-workspace 或使用兼容版本",
+                        });
+                    }
+                }
+                // 5. 节点完整性检测
+                const nodesDir = isArchived
+                    ? `${this.fs.getArchivePath(projectRoot, wsDirName)}/nodes`
+                    : this.fs.getNodesDir(projectRoot, wsDirName);
+                if (graph.nodes) {
+                    for (const [nodeId, node] of Object.entries(graph.nodes)) {
+                        const nodeMeta = node;
+                        const nodeDirName = nodeMeta.dirName || nodeId;
+                        const nodePath = `${nodesDir}/${nodeDirName}`;
+                        if (!(await this.fs.exists(nodePath))) {
+                            issues.push({
+                                type: "node_corrupt",
+                                severity: "error",
+                                target: nodeId,
+                                message: `节点目录不存在: ${nodeDirName}`,
+                                suggestion: "从备份恢复或删除该节点",
+                            });
+                        }
+                        else {
+                            const infoPath = `${nodePath}/Info.md`;
+                            if (!(await this.fs.exists(infoPath))) {
+                                issues.push({
+                                    type: "node_corrupt",
+                                    severity: "warning",
+                                    target: nodeId,
+                                    message: `节点 Info.md 缺失: ${nodeDirName}`,
+                                    suggestion: "可尝试重建节点信息文件",
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                issues.push({
+                    type: "graph_corrupt",
+                    severity: "error",
+                    target: id,
+                    message: "图文件 JSON 格式无效",
+                    suggestion: "从备份恢复或手动修复图文件",
+                });
+            }
+        }
+        // 确定状态
+        const hasError = issues.some(i => i.severity === "error");
+        const hasWarning = issues.some(i => i.severity === "warning");
+        let wsStatus = "healthy";
+        if (hasError) {
+            wsStatus = "error";
+        }
+        else if (hasWarning) {
+            wsStatus = "warning";
+        }
+        return {
+            workspaceId: id,
+            workspaceName: name,
+            status: wsStatus,
+            issues,
+        };
+    }
+}
+//# sourceMappingURL=HealthService.js.map

package/dist/services/HealthService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthService.js","sourceRoot":"","sources":["../../src/services/HealthService.ts"],"names":[],"mappings":"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"}

package/dist/services/InstallationService.d.ts

@@ -0,0 +1,62 @@
+import type { InstallationMeta, PlatformType, PlatformInstallation } from "../types/settings.js";
+/**
+ * 安装服务
+ * 管理安装元信息文件 ~/.xtep-workspace/installation-meta.json
+ * 用于跟踪各平台组件的安装状态和版本
+ */
+export declare class InstallationService {
+    private metaPath;
+    private packageVersion;
+    constructor();
+    /**
+     * 获取包版本号
+     */
+    private loadPackageVersion;
+    /**
+     * 获取元信息文件路径
+     */
+    getPath(): string;
+    /**
+     * 获取当前包版本
+     */
+    getPackageVersion(): string;
+    /**
+     * 读取安装元信息
+     * 如果文件不存在，返回默认结构
+     */
+    read(): Promise<InstallationMeta>;
+    /**
+     * 写入安装元信息
+     */
+    write(meta: InstallationMeta): Promise<void>;
+    /**
+     * 更新指定平台的安装信息
+     */
+    updatePlatform(platform: PlatformType, info: Partial<PlatformInstallation>): Promise<InstallationMeta>;
+    /**
+     * 合并组件信息
+     */
+    private mergeComponent;
+    /**
+     * 更新单个组件
+     */
+    updateComponent(platform: PlatformType, component: string, installed: boolean, version?: string): Promise<InstallationMeta>;
+    /**
+     * 获取指定平台的安装信息
+     */
+    getPlatform(platform: PlatformType): Promise<PlatformInstallation | undefined>;
+    /**
+     * 检查平台组件版本
+     * 返回需要更新的组件列表
+     */
+    checkComponentUpdates(platform: PlatformType): Promise<Array<{
+        component: string;
+        installedVersion: string;
+        currentVersion: string;
+    }>>;
+    /**
+     * 创建默认的元信息结构
+     */
+    private createDefaultMeta;
+}
+//# sourceMappingURL=InstallationService.d.ts.map

package/dist/services/InstallationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallationService.d.ts","sourceRoot":"","sources":["../../src/services/InstallationService.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAG9B;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;;IAS/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAqBvC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAClC,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;IAgC5B;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAKpF;;;OAGG;IACG,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QACjE,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IA0BH;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAY1B"}