@visualization-hub/dev-mcp 1.0.0

package/dist/tools/inspection.tools.d.ts

@@ -0,0 +1,29 @@
+export declare function handleGetProjectFiles(args: {
+    project_name: string;
+    name?: string;
+    version?: string;
+}): Promise<{
+    success: boolean;
+    tree: any;
+}>;
+export declare function handleGetFileContent(args: {
+    project_name: string;
+    file_path: string;
+    name?: string;
+    path?: string;
+    version?: string;
+}): Promise<{
+    success: boolean;
+    file_path: string;
+    content: any;
+}>;
+export declare function handleGrepSourceCode(args: {
+    query: string;
+    project_name?: string;
+    file_pattern?: string;
+}): Promise<{
+    success: boolean;
+    matches: any;
+    total_matches: any;
+}>;
+//# sourceMappingURL=inspection.tools.d.ts.map

package/dist/tools/inspection.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.tools.d.ts","sourceRoot":"","sources":["../../src/tools/inspection.tools.ts"],"names":[],"mappings":"AAEA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;GAU1G;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;GAY3I;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;;;;GAU/G"}

package/dist/tools/inspection.tools.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGetProjectFiles = handleGetProjectFiles;
+exports.handleGetFileContent = handleGetFileContent;
+exports.handleGrepSourceCode = handleGrepSourceCode;
+const inspection_api_1 = require("../client/inspection-api");
+async function handleGetProjectFiles(args) {
+    const name = args.project_name || args.name;
+    if (!name) {
+        throw new Error('[参数错误] project_name 为必填项');
+    }
+    const result = await (0, inspection_api_1.getProjectFiles)(name, args.version);
+    return {
+        success: true,
+        tree: result.tree || result
+    };
+}
+async function handleGetFileContent(args) {
+    const name = args.project_name || args.name;
+    const filePath = args.file_path || args.path;
+    if (!name || !filePath) {
+        throw new Error('[参数错误] project_name 和 file_path 均为必填项');
+    }
+    const result = await (0, inspection_api_1.getFileContent)(name, filePath, args.version);
+    return {
+        success: true,
+        file_path: filePath,
+        content: result.content ?? result
+    };
+}
+async function handleGrepSourceCode(args) {
+    if (!args.query) {
+        throw new Error('[参数错误] query 检索关键词或正则表达式为必填项');
+    }
+    const result = await (0, inspection_api_1.grepSourceCode)(args);
+    return {
+        success: true,
+        matches: result.matches || result,
+        total_matches: result.total_matches ?? (Array.isArray(result) ? result.length : 0)
+    };
+}
+//# sourceMappingURL=inspection.tools.js.map

package/dist/tools/inspection.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.tools.js","sourceRoot":"","sources":["../../src/tools/inspection.tools.ts"],"names":[],"mappings":";;AAEA,sDAUC;AAED,oDAYC;AAED,oDAUC;AAtCD,6DAA2F;AAEpF,KAAK,UAAU,qBAAqB,CAAC,IAA+D;IACzG,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM;KAC5B,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,IAAiG;IAC1I,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;KAClC,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,IAAqE;IAC9G,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;QACjC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/tools/scaffolding.tool.d.ts

@@ -0,0 +1,23 @@
+export interface ICreateProjectArgs {
+    projectName: string;
+    pageType: string;
+    title: string;
+    description?: string;
+    libraries?: string[];
+    targetDir?: string;
+    author?: string;
+    overwrite?: boolean;
+}
+/**
+ * create_component_project: 一键在本地创建可直接构建与运行的 Vue 3 组件工程脚手架
+ */
+export declare function handleCreateComponentProject(args: ICreateProjectArgs): Promise<{
+    success: boolean;
+    message: string;
+    project_dir: string;
+    project_name: string;
+    page_type: string;
+    created_files: string[];
+    next_steps: string[];
+}>;
+//# sourceMappingURL=scaffolding.tool.d.ts.map

package/dist/tools/scaffolding.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolding.tool.d.ts","sourceRoot":"","sources":["../../src/tools/scaffolding.tool.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;GAiE1E"}

package/dist/tools/scaffolding.tool.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCreateComponentProject = handleCreateComponentProject;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const template_engine_1 = require("../templates/template-engine");
+const config_1 = require("../config");
+/**
+ * create_component_project: 一键在本地创建可直接构建与运行的 Vue 3 组件工程脚手架
+ */
+async function handleCreateComponentProject(args) {
+    const { projectName, pageType, title, description, libraries, author, overwrite } = args;
+    if (!projectName || !/^[a-z0-9-_]+$/.test(projectName)) {
+        throw new Error(`[参数错误] projectName "${projectName}" 不合法，仅允许小写字母、数字、中划线和下划线 (^[a-z0-9-_]+$)`);
+    }
+    const validPageTypes = ['cesium', 'three', 'openlayers', 'echarts', 'mapbox', 'maplibre', 'webgl', 'canvas', 'common'];
+    if (!pageType || !validPageTypes.includes(pageType.toLowerCase())) {
+        throw new Error(`[参数错误] pageType "${pageType}" 不合法，有效值: [${validPageTypes.join(', ')}]`);
+    }
+    if (!title) {
+        throw new Error('[参数错误] title 中文显示标题为必填项');
+    }
+    const config = (0, config_1.getConfig)();
+    const baseDir = args.targetDir ? path_1.default.resolve(args.targetDir) : path_1.default.resolve(config.workspaceDir, projectName);
+    if (fs_1.default.existsSync(baseDir) && !overwrite) {
+        const existingFiles = fs_1.default.readdirSync(baseDir);
+        if (existingFiles.length > 0) {
+            throw new Error(`[目标目录已存在] 路径 "${baseDir}" 非空，若需强制覆盖请设置 overwrite: true`);
+        }
+    }
+    fs_1.default.mkdirSync(baseDir, { recursive: true });
+    const generatedFiles = (0, template_engine_1.generateProjectFiles)({
+        projectName,
+        pageType: pageType.toLowerCase(),
+        title,
+        description,
+        libraries,
+        author
+    });
+    const createdFilePaths = [];
+    for (const f of generatedFiles) {
+        const fullPath = path_1.default.join(baseDir, f.relativePath);
+        const parentDir = path_1.default.dirname(fullPath);
+        if (!fs_1.default.existsSync(parentDir)) {
+            fs_1.default.mkdirSync(parentDir, { recursive: true });
+        }
+        fs_1.default.writeFileSync(fullPath, f.content, 'utf-8');
+        createdFilePaths.push(f.relativePath);
+    }
+    return {
+        success: true,
+        message: `组件工程 [${projectName}] 成功生成在 ${baseDir}`,
+        project_dir: baseDir,
+        project_name: projectName,
+        page_type: pageType,
+        created_files: createdFilePaths,
+        next_steps: [
+            `1. 进入工程目录: cd "${baseDir}"`,
+            `2. (可选) 安装依赖: npm install`,
+            `3. 编写业务逻辑: 修改 src/index.vue, src/index.ts, src/index.less`,
+            `4. 本地编译打包: 调用 build_component_project(projectDir: "${baseDir}")`,
+            `5. 沙箱合规自检: 调用 check_sandbox_compliance(projectDir: "${baseDir}")`,
+            `6. 极速发布平台: 调用 upload_component_project(projectDir: "${baseDir}")`
+        ]
+    };
+}
+//# sourceMappingURL=scaffolding.tool.js.map

package/dist/tools/scaffolding.tool.js.map

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

package/dist/tools/transfer.tools.d.ts

@@ -0,0 +1,50 @@
+export interface IUploadProjectArgs {
+    projectDir: string;
+    uploadType?: 'test' | 'final';
+    changelog?: string;
+    skipPreflight?: boolean;
+}
+export interface IDownloadProjectArgs {
+    projectName: string;
+    version?: string;
+    targetDir?: string;
+}
+export interface IDeleteVersionArgs {
+    projectName: string;
+    version: string;
+}
+/**
+ * upload_component_project: 本地打包并极速直传至知识库平台 (耗时 < 0.1s，0 Token)
+ */
+export declare function handleUploadComponentProject(args: IUploadProjectArgs): Promise<{
+    success: boolean;
+    message: string;
+    project_name: any;
+    version: any;
+    upload_type: "test" | "final";
+    preview_url: any;
+    zip_size: string;
+    duration_ms: number;
+    detail: any;
+}>;
+/**
+ * download_component_project: 从知识库拉取组件 ZIP 并直接就地解压为可二次开发的工程
+ */
+export declare function handleDownloadComponentProject(args: IDownloadProjectArgs): Promise<{
+    success: boolean;
+    message: string;
+    project_name: string;
+    target_dir: string;
+    version: string;
+    zip_size: string;
+    duration_ms: number;
+}>;
+/**
+ * delete_version: 删除指定组件版本
+ */
+export declare function handleDeleteVersion(args: IDeleteVersionArgs): Promise<{
+    success: boolean;
+    message: string;
+    result: any;
+}>;
+//# sourceMappingURL=transfer.tools.d.ts.map

package/dist/tools/transfer.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.tools.d.ts","sourceRoot":"","sources":["../../src/tools/transfer.tools.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;GAqD1E;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,oBAAoB;;;;;;;;GA8B9E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB;;;;GAYjE"}

package/dist/tools/transfer.tools.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleUploadComponentProject = handleUploadComponentProject;
+exports.handleDownloadComponentProject = handleDownloadComponentProject;
+exports.handleDeleteVersion = handleDeleteVersion;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const archive_1 = require("../utils/archive");
+const transfer_api_1 = require("../client/transfer-api");
+const compliance_tool_1 = require("./compliance.tool");
+const config_1 = require("../config");
+/**
+ * upload_component_project: 本地打包并极速直传至知识库平台 (耗时 < 0.1s，0 Token)
+ */
+async function handleUploadComponentProject(args) {
+    const { projectDir, uploadType = 'test', changelog = '', skipPreflight = false } = args;
+    if (!projectDir) {
+        throw new Error('[参数错误] projectDir 为必填项');
+    }
+    const absDir = path_1.default.resolve(projectDir);
+    if (!fs_1.default.existsSync(absDir)) {
+        throw new Error(`[路径错误] 目标工程目录不存在: ${absDir}`);
+    }
+    const pjPath = path_1.default.join(absDir, 'project.json');
+    if (!fs_1.default.existsSync(pjPath)) {
+        throw new Error(`[缺少元数据清单] 工程根目录下未找到 project.json: ${absDir}`);
+    }
+    // Pre-Flight 自动化防呆前置检查
+    if (!skipPreflight) {
+        const complianceRes = await (0, compliance_tool_1.handleCheckSandboxCompliance)({ projectDir: absDir });
+        if (!complianceRes.is_eligible_for_upload) {
+            throw new Error(`[Pre-Flight 沙箱合规校验未通过 (得分: ${complianceRes.total_score}/100)]:\n` +
+                complianceRes.recommendations.join('\n') +
+                `\n\n提示: 请修复上述违规项后再行上传，或传入 skipPreflight: true 强制上传。`);
+        }
+    }
+    const startTime = Date.now();
+    // 1. 本地内存打包 ZIP
+    const zipBuffer = (0, archive_1.zipDirectoryToBuffer)(absDir);
+    // 2. 物理流式上传
+    const uploadResult = await (0, transfer_api_1.uploadProjectZip)({
+        zipBuffer,
+        changelog,
+        upload_project_type: uploadType
+    });
+    const durationMs = Date.now() - startTime;
+    return {
+        success: true,
+        message: `组件发布成功！(上传耗时 ${(durationMs / 1000).toFixed(3)}s)`,
+        project_name: uploadResult.project?.name || uploadResult.name,
+        version: uploadResult.version?.version || uploadResult.version,
+        upload_type: uploadType,
+        preview_url: uploadResult.preview_url,
+        zip_size: `${(zipBuffer.length / 1024).toFixed(2)} KB`,
+        duration_ms: durationMs,
+        detail: uploadResult
+    };
+}
+/**
+ * download_component_project: 从知识库拉取组件 ZIP 并直接就地解压为可二次开发的工程
+ */
+async function handleDownloadComponentProject(args) {
+    const { projectName, version, targetDir } = args;
+    if (!projectName) {
+        throw new Error('[参数错误] projectName 为必填项');
+    }
+    const config = (0, config_1.getConfig)();
+    const absTargetDir = targetDir
+        ? path_1.default.resolve(targetDir)
+        : path_1.default.resolve(config.workspaceDir, projectName);
+    const startTime = Date.now();
+    // 1. 下载 ZIP 二进制流
+    const zipBuffer = await (0, transfer_api_1.downloadProjectZip)(projectName, version);
+    // 2. 就地解压
+    (0, archive_1.extractZipBufferToDirectory)(zipBuffer, absTargetDir);
+    const durationMs = Date.now() - startTime;
+    return {
+        success: true,
+        message: `组件 [${projectName}] 成功下载并就地解压至: ${absTargetDir}`,
+        project_name: projectName,
+        target_dir: absTargetDir,
+        version: version || 'latest',
+        zip_size: `${(zipBuffer.length / 1024).toFixed(2)} KB`,
+        duration_ms: durationMs
+    };
+}
+/**
+ * delete_version: 删除指定组件版本
+ */
+async function handleDeleteVersion(args) {
+    const { projectName, version } = args;
+    if (!projectName || !version) {
+        throw new Error('[参数错误] projectName 和 version 均为必填项');
+    }
+    const result = await (0, transfer_api_1.deleteProjectVersion)(projectName, version);
+    return {
+        success: true,
+        message: `版本 [${projectName} v${version}] 已成功删除`,
+        result
+    };
+}
+//# sourceMappingURL=transfer.tools.js.map

package/dist/tools/transfer.tools.js.map

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

package/dist/utils/archive.d.ts

@@ -0,0 +1,16 @@
+export interface IZipOptions {
+    excludes?: string[];
+}
+/**
+ * 将本地目录打包为内存 ZIP Buffer
+ */
+export declare function zipDirectoryToBuffer(sourceDir: string, options?: IZipOptions): Buffer;
+/**
+ * 解压 ZIP Buffer 到本地指定目录
+ */
+export declare function extractZipBufferToDirectory(zipBuffer: Buffer, targetDir: string): void;
+/**
+ * 解压本地 ZIP 文件到指定目录
+ */
+export declare function extractZipFileToDirectory(zipFilePath: string, targetDir: string): void;
+//# sourceMappingURL=archive.d.ts.map

package/dist/utils/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/utils/archive.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CA6BrF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOtF"}

package/dist/utils/archive.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zipDirectoryToBuffer = zipDirectoryToBuffer;
+exports.extractZipBufferToDirectory = extractZipBufferToDirectory;
+exports.extractZipFileToDirectory = extractZipFileToDirectory;
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const DEFAULT_EXCLUDES = ['node_modules', '.git', '.DS_Store', 'Thumbs.db'];
+/**
+ * 将本地目录打包为内存 ZIP Buffer
+ */
+function zipDirectoryToBuffer(sourceDir, options) {
+    const absSource = path_1.default.resolve(sourceDir);
+    if (!fs_1.default.existsSync(absSource)) {
+        throw new Error(`打包源目录不存在: ${absSource}`);
+    }
+    const zip = new adm_zip_1.default();
+    const excludes = options?.excludes || DEFAULT_EXCLUDES;
+    function addFolderRecursively(currentPath, zipPath) {
+        const items = fs_1.default.readdirSync(currentPath);
+        for (const item of items) {
+            if (excludes.includes(item))
+                continue;
+            const itemPath = path_1.default.join(currentPath, item);
+            const stat = fs_1.default.statSync(itemPath);
+            const currentZipPath = zipPath ? `${zipPath}/${item}` : item;
+            if (stat.isDirectory()) {
+                addFolderRecursively(itemPath, currentZipPath);
+            }
+            else {
+                const fileContent = fs_1.default.readFileSync(itemPath);
+                zip.addFile(currentZipPath, fileContent);
+            }
+        }
+    }
+    addFolderRecursively(absSource, '');
+    return zip.toBuffer();
+}
+/**
+ * 解压 ZIP Buffer 到本地指定目录
+ */
+function extractZipBufferToDirectory(zipBuffer, targetDir) {
+    const absTarget = path_1.default.resolve(targetDir);
+    if (!fs_1.default.existsSync(absTarget)) {
+        fs_1.default.mkdirSync(absTarget, { recursive: true });
+    }
+    const zip = new adm_zip_1.default(zipBuffer);
+    zip.extractAllTo(absTarget, true);
+}
+/**
+ * 解压本地 ZIP 文件到指定目录
+ */
+function extractZipFileToDirectory(zipFilePath, targetDir) {
+    const absZip = path_1.default.resolve(zipFilePath);
+    if (!fs_1.default.existsSync(absZip)) {
+        throw new Error(`ZIP 文件不存在: ${absZip}`);
+    }
+    const buffer = fs_1.default.readFileSync(absZip);
+    extractZipBufferToDirectory(buffer, targetDir);
+}
+//# sourceMappingURL=archive.js.map

package/dist/utils/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/utils/archive.ts"],"names":[],"mappings":";;;;;AAaA,oDA6BC;AAKD,kEAQC;AAKD,8DAOC;AAnED,sDAA6B;AAC7B,4CAAoB;AACpB,gDAAwB;AAMxB,MAAM,gBAAgB,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAE5E;;GAEG;AACH,SAAgB,oBAAoB,CAAC,SAAiB,EAAE,OAAqB;IAC3E,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,iBAAM,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,gBAAgB,CAAC;IAEvD,SAAS,oBAAoB,CAAC,WAAmB,EAAE,OAAe;QAChE,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEtC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAE7D,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,WAAW,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBAC9C,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,SAAiB,EAAE,SAAiB;IAC9E,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,iBAAM,CAAC,SAAS,CAAC,CAAC;IAClC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;IAC9E,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,YAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,2BAA2B,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Stdio 专用日志输出工具
+ * 注意: stdio MCP 协议依赖 stdout 传输 JSON-RPC 报文，所有内部日志必须通过 stderr 输出，防止破坏协议报文。
+ */
+export declare const logger: {
+    info: (msg: string, ...args: any[]) => void;
+    warn: (msg: string, ...args: any[]) => void;
+    error: (msg: string, ...args: any[]) => void;
+    success: (msg: string, ...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,MAAM;gBACL,MAAM,WAAW,GAAG,EAAE;gBAGtB,MAAM,WAAW,GAAG,EAAE;iBAGrB,MAAM,WAAW,GAAG,EAAE;mBAGpB,MAAM,WAAW,GAAG,EAAE;CAGtC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * MCP Stdio 专用日志输出工具
+ * 注意: stdio MCP 协议依赖 stdout 传输 JSON-RPC 报文，所有内部日志必须通过 stderr 输出，防止破坏协议报文。
+ */
+exports.logger = {
+    info: (msg, ...args) => {
+        console.error(`[Dev-MCP INFO] ${msg}`, ...args);
+    },
+    warn: (msg, ...args) => {
+        console.error(`[Dev-MCP WARN] ${msg}`, ...args);
+    },
+    error: (msg, ...args) => {
+        console.error(`[Dev-MCP ERROR] ${msg}`, ...args);
+    },
+    success: (msg, ...args) => {
+        console.error(`[Dev-MCP SUCCESS] ${msg}`, ...args);
+    }
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;QACpC,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;QACpC,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@visualization-hub/dev-mcp",
+  "version": "1.0.0",
+  "description": "Visualization Hub Developer MCP Toolkit - Full-Lifecycle Local Dev, Build, Compliance Checking & Instant Upload",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "viz-dev-mcp": "./bin/viz-dev-mcp.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc -w",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "visualization",
+    "vue3",
+    "vite",
+    "developer-tools"
+  ],
+  "author": "Visualization Hub Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.0",
+    "@vitejs/plugin-vue": "^5.1.2",
+    "adm-zip": "^0.5.16",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7",
+    "form-data": "^4.0.2",
+    "less": "^4.2.0",
+    "visualization-project-knowledge-base": "file:..",
+    "vite": "^5.4.2",
+    "vue": "^3.4.38"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/node": "^22.13.5",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  }
+}