m8-mcp-server 1.0.1 → 1.0.2

package/dist/docs/loader.js

@@ -0,0 +1,165 @@
+/**
+ * 文档加载器
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 负责加载编码规范、组件文档、工具文档和典型案例
+ */
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// 获取当前模块的目录路径
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 资源目录路径
+const RESOURCES_DIR = join(__dirname, '../../resources');
+/**
+ * 读取 JSON 文件
+ * @param filePath 文件路径
+ * @returns 解析后的 JSON 对象
+ */
+function readJsonFile(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            console.warn(`文件不存在: ${filePath}`);
+            return null;
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`读取文件失败: ${filePath}`, error);
+        return null;
+    }
+}
+/**
+ * 加载编码规范文档
+ * @returns 编码规范文档映射
+ */
+export function loadStandards() {
+    const standards = new Map();
+    const standardsDir = join(RESOURCES_DIR, 'standards');
+    if (!existsSync(standardsDir)) {
+        console.warn(`编码规范目录不存在: ${standardsDir}`);
+        return standards;
+    }
+    const files = readdirSync(standardsDir).filter(f => f.endsWith('.json') && f !== 'index.json');
+    for (const file of files) {
+        const filePath = join(standardsDir, file);
+        const doc = readJsonFile(filePath);
+        if (doc) {
+            standards.set(doc.category, doc);
+        }
+    }
+    return standards;
+}
+/**
+ * 加载 UI 组件文档
+ * @returns 组件文档映射
+ */
+export function loadComponents() {
+    const components = new Map();
+    const componentsDir = join(RESOURCES_DIR, 'components');
+    if (!existsSync(componentsDir)) {
+        console.warn(`组件目录不存在: ${componentsDir}`);
+        return components;
+    }
+    const files = readdirSync(componentsDir).filter(f => f.endsWith('.json') && f !== 'index.json');
+    for (const file of files) {
+        const filePath = join(componentsDir, file);
+        const doc = readJsonFile(filePath);
+        if (doc) {
+            // 同时用 id 和 name 作为键，方便查找
+            components.set(doc.id, doc);
+            components.set(doc.name, doc);
+            // 不带 em- 前缀的名称也作为键
+            if (doc.name.startsWith('em-')) {
+                components.set(doc.name.replace('em-', ''), doc);
+            }
+        }
+    }
+    return components;
+}
+/**
+ * 加载 Util 工具文档
+ * @returns 工具文档映射
+ */
+export function loadUtils() {
+    const utils = new Map();
+    const utilsDir = join(RESOURCES_DIR, 'utils');
+    if (!existsSync(utilsDir)) {
+        console.warn(`工具目录不存在: ${utilsDir}`);
+        return utils;
+    }
+    const files = readdirSync(utilsDir).filter(f => f.endsWith('.json') && f !== 'index.json');
+    for (const file of files) {
+        const filePath = join(utilsDir, file);
+        const doc = readJsonFile(filePath);
+        if (doc) {
+            utils.set(doc.category, doc);
+        }
+    }
+    return utils;
+}
+/**
+ * 加载典型案例文档
+ * @returns 案例文档数组
+ */
+export function loadCases() {
+    const cases = [];
+    const casesDir = join(RESOURCES_DIR, 'cases');
+    if (!existsSync(casesDir)) {
+        console.warn(`案例目录不存在: ${casesDir}`);
+        return cases;
+    }
+    const files = readdirSync(casesDir).filter(f => f.endsWith('.json') && f !== 'index.json');
+    for (const file of files) {
+        const filePath = join(casesDir, file);
+        const doc = readJsonFile(filePath);
+        if (doc) {
+            cases.push(doc);
+        }
+    }
+    return cases;
+}
+/**
+ * 加载所有文档并构建索引
+ * @returns 文档索引
+ */
+export function loadAllDocuments() {
+    return {
+        standards: loadStandards(),
+        components: loadComponents(),
+        utils: loadUtils(),
+        apis: new Map(), // API 文档暂时为空，后续可扩展
+        cases: loadCases()
+    };
+}
+/**
+ * 获取所有已加载的编码规范类型
+ * @param standards 编码规范映射
+ * @returns 规范类型数组
+ */
+export function getStandardTypes(standards) {
+    return Array.from(standards.keys());
+}
+/**
+ * 获取所有已加载的组件名称
+ * @param components 组件映射
+ * @returns 组件名称数组（去重）
+ */
+export function getComponentNames(components) {
+    const names = new Set();
+    for (const doc of components.values()) {
+        names.add(doc.name);
+    }
+    return Array.from(names);
+}
+/**
+ * 获取所有已加载的 Util 分类
+ * @param utils 工具映射
+ * @returns 分类数组
+ */
+export function getUtilCategories(utils) {
+    return Array.from(utils.keys());
+}
+//# sourceMappingURL=loader.js.map

package/dist/docs/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/docs/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AASpC,cAAc;AACd,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS;AACT,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAEzD;;;;GAIG;AACH,SAAS,YAAY,CAAI,QAAgB;IACvC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAC;IAE/F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAoB,QAAQ,CAAC,CAAC;QACtD,IAAI,GAAG,EAAE,CAAC;YACR,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAC;IAEhG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,YAAY,CAAiB,QAAQ,CAAC,CAAC;QACnD,IAAI,GAAG,EAAE,CAAC;YACR,yBAAyB;YACzB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC5B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC9B,mBAAmB;YACnB,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAC;IAE3F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CAAU,QAAQ,CAAC,CAAC;QAC5C,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAC;IAE3F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CAAU,QAAQ,CAAC,CAAC;QAC5C,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,SAAS,EAAE,aAAa,EAAE;QAC1B,UAAU,EAAE,cAAc,EAAE;QAC5B,KAAK,EAAE,SAAS,EAAE;QAClB,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,mBAAmB;QACpC,KAAK,EAAE,SAAS,EAAE;KACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAyC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAuC;IACvE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA2B;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/docs/search.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 文档搜索功能
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现文档的关键词搜索和分类过滤
+ */
+import type { SearchOptions, SearchResult, DocumentIndex } from '../types/index.js';
+/**
+ * 搜索文档
+ * @param index 文档索引
+ * @param query 搜索关键词
+ * @param options 搜索选项
+ * @returns 搜索结果数组
+ */
+export declare function searchDocs(index: DocumentIndex, query: string, options?: SearchOptions): SearchResult[];
+/**
+ * 获取搜索结果的摘要信息
+ * @param results 搜索结果
+ * @returns 摘要字符串
+ */
+export declare function getSearchSummary(results: SearchResult[]): string;
+/**
+ * 格式化搜索结果为文本
+ * @param results 搜索结果
+ * @returns 格式化的文本
+ */
+export declare function formatSearchResults(results: SearchResult[]): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/docs/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/docs/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAEZ,aAAa,EACd,MAAM,mBAAmB,CAAC;AAa3B;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,EAAE,CAyHhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAiBhE;AAkBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAmBnE"}

package/dist/docs/search.js

@@ -0,0 +1,196 @@
+/**
+ * 文档搜索功能
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现文档的关键词搜索和分类过滤
+ */
+/**
+ * 检查文本是否包含关键词（不区分大小写）
+ * @param text 要检查的文本
+ * @param keyword 关键词
+ * @returns 是否包含
+ */
+function containsKeyword(text, keyword) {
+    if (!text)
+        return false;
+    return text.toLowerCase().includes(keyword.toLowerCase());
+}
+/**
+ * 搜索文档
+ * @param index 文档索引
+ * @param query 搜索关键词
+ * @param options 搜索选项
+ * @returns 搜索结果数组
+ */
+export function searchDocs(index, query, options) {
+    const results = [];
+    const category = options?.category;
+    const limit = options?.limit ?? 10;
+    // 搜索编码规范
+    if (!category || category === 'standard') {
+        for (const [, doc] of index.standards) {
+            // 搜索规范标题
+            if (containsKeyword(doc.title, query) || containsKeyword(doc.description, query)) {
+                results.push({
+                    title: doc.title,
+                    category: 'standard',
+                    description: doc.description || '',
+                    content: `包含 ${doc.rules.length} 条规则`
+                });
+            }
+            // 搜索具体规则
+            for (const rule of doc.rules) {
+                if (containsKeyword(rule.title, query) || containsKeyword(rule.description, query)) {
+                    results.push({
+                        title: `${doc.title} - ${rule.title}`,
+                        category: 'standard',
+                        description: rule.description,
+                        content: rule.correctExample || ''
+                    });
+                }
+            }
+        }
+    }
+    // 搜索 UI 组件
+    if (!category || category === 'ui-component') {
+        const seenComponents = new Set();
+        for (const [, doc] of index.components) {
+            // 避免重复（因为同一个组件可能有多个键）
+            if (seenComponents.has(doc.id))
+                continue;
+            seenComponents.add(doc.id);
+            if (containsKeyword(doc.name, query) ||
+                containsKeyword(doc.title, query) ||
+                containsKeyword(doc.description, query)) {
+                results.push({
+                    title: `${doc.name} (${doc.title})`,
+                    category: 'ui-component',
+                    description: doc.description,
+                    content: `Props: ${doc.props.length}, Events: ${doc.events.length}`
+                });
+            }
+        }
+    }
+    // 搜索 Util 工具
+    if (!category || category === 'util-tool') {
+        for (const [, doc] of index.utils) {
+            // 搜索分类
+            if (containsKeyword(doc.title, query) || containsKeyword(doc.description, query)) {
+                results.push({
+                    title: `Util.${doc.category}`,
+                    category: 'util-tool',
+                    description: doc.description || doc.title,
+                    content: `包含 ${doc.methods.length} 个方法`
+                });
+            }
+            // 搜索具体方法
+            for (const method of doc.methods) {
+                if (containsKeyword(method.name, query) || containsKeyword(method.description, query)) {
+                    results.push({
+                        title: `Util.${doc.category === 'common' ? '' : doc.category + '.'}${method.name}`,
+                        category: 'util-tool',
+                        description: method.description,
+                        content: method.examples?.[0]?.code || ''
+                    });
+                }
+            }
+        }
+    }
+    // 搜索典型案例
+    if (!category || category === 'typical-case') {
+        for (const doc of index.cases) {
+            if (containsKeyword(doc.title, query) || containsKeyword(doc.description, query)) {
+                results.push({
+                    title: doc.title,
+                    category: 'typical-case',
+                    description: doc.description,
+                    content: `Vue${doc.vueVersion} 版本`
+                });
+            }
+        }
+    }
+    // 搜索 EJS API（如果有）
+    if (!category || category === 'ejs-api') {
+        for (const [, doc] of index.apis) {
+            if (containsKeyword(doc.module, query) || containsKeyword(doc.description, query)) {
+                results.push({
+                    title: `ejs.${doc.module}`,
+                    category: 'ejs-api',
+                    description: doc.description,
+                    content: `包含 ${doc.methods.length} 个方法`
+                });
+            }
+            // 搜索具体方法
+            for (const method of doc.methods) {
+                if (containsKeyword(method.name, query) || containsKeyword(method.description, query)) {
+                    results.push({
+                        title: `ejs.${doc.module}.${method.name}`,
+                        category: 'ejs-api',
+                        description: method.description,
+                        content: method.examples?.[0]?.code || ''
+                    });
+                }
+            }
+        }
+    }
+    // 限制结果数量
+    return results.slice(0, limit);
+}
+/**
+ * 获取搜索结果的摘要信息
+ * @param results 搜索结果
+ * @returns 摘要字符串
+ */
+export function getSearchSummary(results) {
+    if (results.length === 0) {
+        return '未找到匹配的文档。请尝试其他关键词或检查拼写。';
+    }
+    const categoryCounts = {};
+    for (const result of results) {
+        categoryCounts[result.category] = (categoryCounts[result.category] || 0) + 1;
+    }
+    const parts = [];
+    for (const [category, count] of Object.entries(categoryCounts)) {
+        const categoryName = getCategoryDisplayName(category);
+        parts.push(`${categoryName}: ${count}`);
+    }
+    return `找到 ${results.length} 条结果 (${parts.join(', ')})`;
+}
+/**
+ * 获取分类的显示名称
+ * @param category 分类标识
+ * @returns 显示名称
+ */
+function getCategoryDisplayName(category) {
+    const names = {
+        'ejs-api': 'EJS API',
+        'ui-component': 'UI 组件',
+        'util-tool': 'Util 工具',
+        'typical-case': '典型案例',
+        'standard': '编码规范'
+    };
+    return names[category] || category;
+}
+/**
+ * 格式化搜索结果为文本
+ * @param results 搜索结果
+ * @returns 格式化的文本
+ */
+export function formatSearchResults(results) {
+    if (results.length === 0) {
+        return '未找到匹配的文档。请尝试其他关键词或检查拼写。';
+    }
+    const lines = [getSearchSummary(results), ''];
+    for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        lines.push(`${i + 1}. **${result.title}**`);
+        lines.push(`   分类: ${getCategoryDisplayName(result.category)}`);
+        lines.push(`   描述: ${result.description}`);
+        if (result.content) {
+            lines.push(`   ${result.content}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=search.js.map

package/dist/docs/search.js.map

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

package/dist/docs/standards.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 编码规范查询
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现编码规范信息的查询功能
+ */
+import type { CodingStandardDoc, CodingRule, StandardType } from '../types/index.js';
+/**
+ * 获取编码规范
+ * @param standards 规范文档映射
+ * @param type 规范类型
+ * @returns 规范文档或 null
+ */
+export declare function getCodingStandard(standards: Map<string, CodingStandardDoc>, type: StandardType): CodingStandardDoc | CodingStandardDoc[] | null;
+/**
+ * 按关键词过滤规则
+ * @param doc 规范文档
+ * @param keyword 关键词
+ * @returns 过滤后的规则数组
+ */
+export declare function filterRulesByKeyword(doc: CodingStandardDoc, keyword: string): CodingRule[];
+/**
+ * 获取所有可用的规范类型
+ * @param standards 规范文档映射
+ * @returns 类型数组
+ */
+export declare function getAvailableStandardTypes(standards: Map<string, CodingStandardDoc>): string[];
+/**
+ * 格式化编码规范为文本
+ * @param doc 规范文档或文档数组
+ * @param keyword 可选的关键词过滤
+ * @returns 格式化的文本
+ */
+export declare function formatCodingStandard(doc: CodingStandardDoc | CodingStandardDoc[], keyword?: string): string;
+/**
+ * 获取规范摘要
+ * @param standards 规范文档映射
+ * @returns 摘要文本
+ */
+export declare function getStandardsSummary(standards: Map<string, CodingStandardDoc>): string;
+//# sourceMappingURL=standards.d.ts.map

package/dist/docs/standards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards.d.ts","sourceRoot":"","sources":["../../src/docs/standards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACzC,IAAI,EAAE,YAAY,GACjB,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAahD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAOd;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,EAAE,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,EAC5C,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA4ER;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAWrF"}

package/dist/docs/standards.js

@@ -0,0 +1,134 @@
+/**
+ * 编码规范查询
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现编码规范信息的查询功能
+ */
+/**
+ * 获取编码规范
+ * @param standards 规范文档映射
+ * @param type 规范类型
+ * @returns 规范文档或 null
+ */
+export function getCodingStandard(standards, type) {
+    if (type === 'all') {
+        return Array.from(standards.values());
+    }
+    // 处理 project-structure 类型映射
+    const typeMap = {
+        'project-structure': 'project-structure',
+        'project': 'project-structure'
+    };
+    const normalizedType = typeMap[type] || type;
+    return standards.get(normalizedType) || null;
+}
+/**
+ * 按关键词过滤规则
+ * @param doc 规范文档
+ * @param keyword 关键词
+ * @returns 过滤后的规则数组
+ */
+export function filterRulesByKeyword(doc, keyword) {
+    const normalized = keyword.toLowerCase();
+    return doc.rules.filter(rule => rule.title.toLowerCase().includes(normalized) ||
+        rule.description.toLowerCase().includes(normalized) ||
+        rule.id.toLowerCase().includes(normalized));
+}
+/**
+ * 获取所有可用的规范类型
+ * @param standards 规范文档映射
+ * @returns 类型数组
+ */
+export function getAvailableStandardTypes(standards) {
+    return Array.from(standards.keys());
+}
+/**
+ * 格式化编码规范为文本
+ * @param doc 规范文档或文档数组
+ * @param keyword 可选的关键词过滤
+ * @returns 格式化的文本
+ */
+export function formatCodingStandard(doc, keyword) {
+    const lines = [];
+    if (Array.isArray(doc)) {
+        // 格式化所有规范的摘要
+        lines.push('# M8 编码规范汇总');
+        lines.push('');
+        for (const d of doc) {
+            lines.push(`## ${d.title}`);
+            lines.push('');
+            lines.push(d.description || '');
+            lines.push('');
+            lines.push(`包含 ${d.rules.length} 条规则`);
+            lines.push('');
+            // 列出前 5 条规则
+            const rulesToShow = d.rules.slice(0, 5);
+            for (const rule of rulesToShow) {
+                lines.push(`- ${rule.title}`);
+            }
+            if (d.rules.length > 5) {
+                lines.push(`- ... 还有 ${d.rules.length - 5} 条规则`);
+            }
+            lines.push('');
+        }
+        lines.push('使用 `get_coding_standard` 工具并指定 `type` 参数可获取具体类型的详细规范。');
+    }
+    else {
+        // 格式化单个规范
+        lines.push(`# ${doc.title}`);
+        lines.push('');
+        lines.push(doc.description || '');
+        lines.push('');
+        const rules = keyword ? filterRulesByKeyword(doc, keyword) : doc.rules;
+        if (keyword && rules.length === 0) {
+            lines.push(`未找到包含关键词 "${keyword}" 的规则。`);
+            lines.push('');
+            lines.push('所有可用规则:');
+            for (const rule of doc.rules) {
+                lines.push(`- ${rule.title}`);
+            }
+        }
+        else {
+            if (keyword) {
+                lines.push(`找到 ${rules.length} 条包含 "${keyword}" 的规则:`);
+                lines.push('');
+            }
+            for (const rule of rules) {
+                lines.push(`## ${rule.title}`);
+                lines.push('');
+                lines.push(rule.description);
+                lines.push('');
+                if (rule.correctExample) {
+                    lines.push('### ✅ 正确示例');
+                    lines.push('```');
+                    lines.push(rule.correctExample);
+                    lines.push('```');
+                    lines.push('');
+                }
+                if (rule.incorrectExample) {
+                    lines.push('### ❌ 错误示例');
+                    lines.push('```');
+                    lines.push(rule.incorrectExample);
+                    lines.push('```');
+                    lines.push('');
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 获取规范摘要
+ * @param standards 规范文档映射
+ * @returns 摘要文本
+ */
+export function getStandardsSummary(standards) {
+    const lines = ['# M8 编码规范', ''];
+    for (const [type, doc] of standards) {
+        lines.push(`- **${doc.title}** (${type}): ${doc.rules.length} 条规则`);
+    }
+    lines.push('');
+    lines.push('使用 `get_coding_standard` 工具获取详细规范。');
+    return lines.join('\n');
+}
+//# sourceMappingURL=standards.js.map

package/dist/docs/standards.js.map

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

package/dist/docs/utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Util 工具信息查询
+ * @作者 M8 Team
+ * @创建时间 2024-12-29
+ * @描述 实现 Util 工具方法信息的查询功能
+ */
+import type { UtilDoc, UtilMethod } from '../types/index.js';
+/**
+ * 获取 Util 分类信息
+ * @param utils Util 文档映射
+ * @param category 分类名称
+ * @returns Util 分类信息或 null
+ */
+export declare function getUtilInfo(utils: Map<string, UtilDoc>, category: string): UtilDoc | null;
+/**
+ * 获取 Util 方法信息
+ * @param utils Util 文档映射
+ * @param category 分类名称
+ * @param methodName 方法名称
+ * @returns Util 方法信息或 null
+ */
+export declare function getUtilMethodInfo(utils: Map<string, UtilDoc>, category: string, methodName: string): UtilMethod | null;
+/**
+ * 获取所有可用的 Util 分类
+ * @param utils Util 文档映射
+ * @returns 分类名称数组
+ */
+export declare function getAvailableCategories(utils: Map<string, UtilDoc>): string[];
+/**
+ * 格式化 Util 信息为文本
+ * @param doc Util 文档
+ * @param methodName 可选的方法名称
+ * @returns 格式化的文本
+ */
+export declare function formatUtilInfo(doc: UtilDoc, methodName?: string): string;
+/**
+ * 搜索 Util 方法
+ * @param utils Util 文档映射
+ * @param query 搜索关键词
+ * @returns 匹配的方法列表
+ */
+export declare function searchUtilMethods(utils: Map<string, UtilDoc>, query: string): Array<{
+    category: string;
+    method: UtilMethod;
+}>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/docs/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,GAAG,IAAI,CAGhB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,IAAI,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAqExE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAgBjD"}