mm_ai 1.0.0

package/common/tool/knowledge/get_knowledge_detail/tool.json

@@ -0,0 +1,71 @@
+{
+  "name": "get_knowledge_detail",
+  "title": "获取常识知识详情",
+  "description": "获取常识知识详情。",
+  "category": "常识知识管理",
+  "group": "knowledge",
+  "type": "function",
+  "main": "./index.js",
+  "params": [
+    {
+      "name": "name",
+      "description": "常识知识名称(英文名, 唯一标识)",
+      "type": "string",
+      "required": true
+    }
+  ],
+  "returns": [
+    {
+      "name": "code",
+      "type": "number",
+      "description": "操作状态代码，0表示成功，其他表示失败",
+      "default": 0
+    },
+    {
+      "name": "msg",
+      "type": "string",
+      "description": "操作反馈消息，成功时返回成功提示，失败时返回错误信息",
+      "default": ""
+    },
+    {
+      "name": "knowledge",
+      "type": "object",
+      "description": "常识知识详情",
+      "required": true,
+      "properties": {
+        "name": {
+          "description": "常识知识名称(英文名, 唯一标识)",
+          "type": "string"
+        },
+        "title": {
+          "description": "常识知识标题(中文名)",
+          "type": "string"
+        },
+        "description": {
+          "description": "常识知识描述",
+          "type": "string"
+        },
+        "group": {
+          "description": "常识知识分组",
+          "type": "string"
+        },
+        "tags": {
+          "description": "常识知识标签数组",
+          "type": "array"
+        },
+        "dir": {
+          "description": "常识知识目录",
+          "type": "string"
+        },
+        "config_file": {
+          "description": "常识知识配置文件路径",
+          "type": "string"
+        },
+        "prompt_file": {
+          "description": "常识知识提示词文件路径",
+          "type": "string"
+        }
+      }
+    }
+  ]
+}

package/common/tool/knowledge/get_knowledge_list/index.js

@@ -0,0 +1,69 @@
+module.exports = {
+  /**
+   * 获取所有常识知识
+   * @returns 所有常识知识列表
+   */
+  getPrompts: function () {
+    let server = this.getServer();
+    if (!server) {
+      throw new Error('服务器实例不可用');
+    }
+    let knowledge = server.knowledge;
+    return knowledge || {};
+  },
+  /**
+   * 获取常识知识列表
+   * @param {string} group - 常识知识分组。不传时，返回所有常识知识列表。传分组时，返回该分组下的常识知识列表。
+   * @returns 常识知识列表结果
+   */
+  getPromptList(group) {
+    group = group || '';
+    let dict = this.getPrompts();
+    let knowledges = [];
+    if (group) {
+      for (let key in dict) {
+        let knowledge = dict[key];
+        let config = knowledge.config;
+        if (config.group === group) {
+          knowledges.push({
+            name: config.name,
+            title: config.title,
+            description: config.description,
+            tags: config.tags,
+            group: config.group
+          });
+        }
+      }
+    } else {
+      for (let key in dict) {
+        let knowledge = dict[key];
+        let config = knowledge.config;
+        knowledges.push({
+          name: config.name,
+          title: config.title,
+          description: config.description,
+          tags: config.tags,
+          group: config.group
+        });
+      }
+    }
+    return {
+      code: 0,
+      msg: '成功',
+      knowledges: knowledges,
+      count: knowledges.length
+    };
+  },
+  main(params) {
+    let ret;
+    try {
+      ret = this.getPromptList(params.group);
+    } catch (error) {
+      ret = {
+        code: 10000,
+        msg: '获取常识知识列表失败！原因：' + error.message
+      };
+    }
+    return ret;
+  }
+};

package/common/tool/knowledge/get_knowledge_list/tool.json

@@ -0,0 +1,39 @@
+{
+  "name": "get_knowledge_list",
+  "title": "获取常识知识列表",
+  "description": "获取常识知识列表。",
+  "category": "常识知识管理",
+  "group": "knowledge",
+  "type": "function",
+  "main": "./index.js",
+  "params": [
+    {
+      "name": "group",
+      "description": "常识知识分组。不传时，返回所有常识知识列表。传分组时，返回该分组下的常识知识列表。",
+      "type": "string",
+      "default": ""
+    }
+  ],
+  "returns": [
+    {
+      "name": "code",
+      "type": "number",
+      "description": "获取状态码，0表示成功"
+    },
+    {
+      "name": "msg",
+      "type": "string",
+      "description": "获取状态成功时为空，失败时为错误信息"
+    },
+    {
+      "name": "knowledges",
+      "type": "array",
+      "description": "常识知识列表"
+    },
+    {
+      "name": "count",
+      "type": "number",
+      "description": "常识知识数量"
+    }
+  ]
+}

package/common/tool/knowledge/knowledge_prompt_checker/index.js

@@ -0,0 +1,220 @@
+/**
+ * knowledge_prompt_checker - 常识提示词规范检测器
+ * 检查常识知识提示词（knowledge.md + knowledge.json）是否符合规范
+ */
+const fs = require('fs');
+const path = require('path');
+
+async function main(params) {
+  const { knowledge_name } = params || {};
+  
+  if (!knowledge_name) {
+    return { code: 400, msg: '缺少必填参数: knowledge_name' };
+  }
+
+  try {
+    const report = await checkKnowledgePrompt(knowledge_name);
+    return {
+      code: 0,
+      msg: '检查完成',
+      report
+    };
+  } catch (err) {
+    return { code: 500, msg: `检查失败: ${err.message}` };
+  }
+}
+
+/**
+ * 查找 knowledge 目录（通过系统API获取）
+ */
+async function findKnowledgeDir(knowledgeName) {
+  const result = await globalThis.callTool('get_knowledge_detail', { name: knowledgeName });
+  if (result && result.code === 0 && result.knowledge && result.knowledge.dir) {
+    const dir = result.knowledge.dir;
+    if (fs.existsSync(dir)) return dir;
+  }
+  return null;
+}
+
+/**
+ * 检查 knowledge.md
+ */
+function checkKnowledgeMd(knowledgeDir) {
+  const results = [];
+  const mdPath = path.join(knowledgeDir, 'knowledge.md');
+  
+  if (!fs.existsSync(mdPath)) {
+    results.push({ item: 'knowledge.md 文件存在性', status: '❌ 失败', detail: 'knowledge.md 文件不存在' });
+    return results;
+  }
+
+  const content = fs.readFileSync(mdPath, 'utf-8');
+
+  // 1. 检查内容是否为纯声明性（无步骤流程、无工具调用、无代码示例）
+  const hasSteps = /步骤|操作流程|执行步骤|操作步骤/.test(content);
+  const hasToolCalls = /`[a-z_]+`/.test(content);
+  const hasCodeExamples = /```/.test(content);
+
+  const declarativeIssues = [];
+  if (hasSteps) declarativeIssues.push('包含步骤流程');
+  if (hasToolCalls) declarativeIssues.push('包含工具调用');
+  if (hasCodeExamples) declarativeIssues.push('包含代码示例');
+
+  if (declarativeIssues.length === 0) {
+    results.push({ item: '纯声明性内容', status: '✅ 通过', detail: '内容为纯声明性，无步骤流程、工具调用、代码示例' });
+  } else {
+    results.push({ item: '纯声明性内容', status: '⚠️ 警告', detail: `检测到非声明性内容: ${declarativeIssues.join('、')}` });
+  }
+
+  // 2. 检查是否包含 YAML Frontmatter（不应有，元数据在 knowledge.json 中）
+  const hasYamlFrontmatter = /^---\s*/.test(content);
+  if (hasYamlFrontmatter) {
+    // 提取 frontmatter 内容做详细报告
+    const endMatch = content.match(/^---\s*([\s\S]*?)---/);
+    if (endMatch) {
+      const frontmatter = endMatch[1];
+      const fields = frontmatter.match(/^(\w+)\s*[:=]/gm);
+      const fieldList = fields ? fields.map(f => f.replace(/\s*[:=].*$/, '').trim()).join('、') : '未知字段';
+      results.push({ item: 'YAML Frontmatter', status: '❌ 失败', detail: `不应包含 YAML Frontmatter（--- xxx --- 头部），元数据已在 knowledge.json 中管理。检测到字段: ${fieldList}` });
+    } else {
+      results.push({ item: 'YAML Frontmatter', status: '❌ 失败', detail: '不应包含 --- 分隔符，元数据已在 knowledge.json 中管理' });
+    }
+  } else {
+    results.push({ item: 'YAML Frontmatter', status: '✅ 通过', detail: '未包含 YAML Frontmatter（--- xxx --- 头部），符合规范' });
+  }
+
+  // 3. 检查是否包含"基本信息"章节
+  if (/##\s*基本信息/.test(content)) {
+    results.push({ item: '基本信息章节', status: '❌ 失败', detail: 'knowledge.md 中不应包含"基本信息"章节' });
+  } else {
+    results.push({ item: '基本信息章节', status: '✅ 通过', detail: '未包含"基本信息"章节' });
+  }
+
+  return results;
+}
+
+/**
+ * 检查 knowledge.json
+ */
+function checkKnowledgeJson(knowledgeDir) {
+  const results = [];
+  const jsonPath = path.join(knowledgeDir, 'knowledge.json');
+  
+  if (!fs.existsSync(jsonPath)) {
+    results.push({ item: 'knowledge.json 文件存在性', status: '❌ 失败', detail: 'knowledge.json 文件不存在' });
+    return results;
+  }
+
+  const content = fs.readFileSync(jsonPath, 'utf-8');
+
+  // 1. JSON.parse 校验
+  let jsonData;
+  try {
+    jsonData = JSON.parse(content);
+    results.push({ item: 'JSON 格式校验', status: '✅ 通过', detail: 'JSON.parse 校验通过' });
+  } catch (e) {
+    results.push({ item: 'JSON 格式校验', status: '❌ 失败', detail: `JSON.parse 校验失败: ${e.message}` });
+    return results;
+  }
+
+  // 2. 必填字段检查：name/title/description/group/tags
+  const requiredFields = ['name', 'title', 'description', 'group', 'tags'];
+  const missingFields = requiredFields.filter(f => !(f in jsonData));
+  if (missingFields.length === 0) {
+    results.push({ item: '必填字段', status: '✅ 通过', detail: '包含 name/title/description/group/tags 所有字段' });
+  } else {
+    results.push({ item: '必填字段', status: '❌ 失败', detail: `缺少字段: ${missingFields.join('、')}` });
+  }
+
+  // 3. 检查是否包含 prompt_file 字段（不应有，系统默认生成）
+  if ('prompt_file' in jsonData) {
+    results.push({ item: 'prompt_file 字段', status: '⚠️ 警告', detail: '不应包含 prompt_file 字段（系统默认生成）' });
+  } else {
+    results.push({ item: 'prompt_file 字段', status: '✅ 通过', detail: '未包含 prompt_file 字段' });
+  }
+
+  // 额外：检查 tags 是否是数组
+  if (jsonData.tags && Array.isArray(jsonData.tags)) {
+    if (jsonData.tags.length > 0) {
+      results.push({ item: 'tags 数组', status: '✅ 通过', detail: `tags 数组不为空，共 ${jsonData.tags.length} 个标签` });
+    } else {
+      results.push({ item: 'tags 数组', status: '⚠️ 警告', detail: 'tags 数组为空，应填写具体标签' });
+    }
+  } else if (jsonData.tags) {
+    results.push({ item: 'tags 数组', status: '⚠️ 警告', detail: 'tags 应为数组格式' });
+  }
+
+  return results;
+}
+
+/**
+ * 生成 Markdown 格式的检查报告
+ */
+function generateReport(knowledgeName, mdResults, jsonResults) {
+  let report = `# 常识提示词规范检测报告\n\n`;
+  report += `**知识名称**: \`${knowledgeName}\`\n\n`;
+  report += `**检测时间**: ${new Date().toLocaleString()}\n\n`;
+  report += `---\n\n`;
+
+  const allResults = [...(mdResults || []), ...(jsonResults || [])];
+  const passed = allResults.filter(r => r.status === '✅ 通过').length;
+  const warned = allResults.filter(r => r.status.includes('⚠️')).length;
+  const failed = allResults.filter(r => r.status.includes('❌')).length;
+  const total = allResults.length;
+
+  report += `## 📊 总评\n\n`;
+  report += `| 项目 | 数量 |\n`;
+  report += `|:----|:----|\n`;
+  report += `| 总检测项 | ${total} |\n`;
+  report += `| ✅ 通过 | ${passed} |\n`;
+  report += `| ⚠️ 警告 | ${warned} |\n`;
+  report += `| ❌ 失败 | ${failed} |\n\n`;
+
+  if (failed > 0) {
+    report += `> ⚠️ 存在 ${failed} 项失败，需要修复后才能通过规范检查。\n\n`;
+  }
+
+  report += `---\n\n`;
+
+  // knowledge.md 检查
+  report += `## 📄 knowledge.md 检查\n\n`;
+  report += `| 检查项 | 结果 | 说明 |\n`;
+  report += `|:-----|:----|:----|\n`;
+  if (mdResults) {
+    for (const r of mdResults) {
+      report += `| ${r.item} | ${r.status} | ${r.detail} |\n`;
+    }
+  }
+
+  report += `\n---\n\n`;
+
+  // knowledge.json 检查
+  report += `## 📋 knowledge.json 检查\n\n`;
+  report += `| 检查项 | 结果 | 说明 |\n`;
+  report += `|:-----|:----|:----|\n`;
+  if (jsonResults) {
+    for (const r of jsonResults) {
+      report += `| ${r.item} | ${r.status} | ${r.detail} |\n`;
+    }
+  }
+
+  report += `\n---\n\n`;
+  report += `*报告由 knowledge_prompt_checker 自动生成*\n`;
+
+  return report;
+}
+
+async function checkKnowledgePrompt(knowledgeName) {
+  const knowledgeDir = await findKnowledgeDir(knowledgeName);
+  
+  if (!knowledgeDir) {
+    return `# 常识提示词规范检测报告\n\n**知识名称**: \`${knowledgeName}\`\n\n**检测结果**: ❌ 未找到该知识目录\n\n请确认知识名称是否正确，知识文件应位于 \`common/knowledge/{分类}/{知识名}/\` 目录下。`;
+  }
+
+  const mdResults = checkKnowledgeMd(knowledgeDir);
+  const jsonResults = checkKnowledgeJson(knowledgeDir);
+  
+  return generateReport(knowledgeName, mdResults, jsonResults);
+}
+
+module.exports = { main };

package/common/tool/knowledge/knowledge_prompt_checker/tool.json

@@ -0,0 +1,32 @@
+{
+  // 工具名称
+  "name": "knowledge_prompt_checker",
+  // 工具标题(显示的中文名)
+  "title": "常识提示词规范检测器",
+  // 工具描述
+  "description": "检查常识知识提示词（knowledge.md + knowledge.json）是否符合规范。触发关键词：常识知识检查、knowledge检查、知识规范检测",
+  // 工具分组
+  "category": "常识知识管理",
+  // 工具分组
+  "group": "knowledge",
+  // 工具类型, 默认为"function"
+  "type": "function",
+  // 工具主文件路径
+  "main": "./index.js",
+  // 工具是否严格模式参数校验
+  "strict": true,
+  // 工具参数是否允许额外字段
+  "add_params": false,
+  // 工具参数
+  "params": [],
+  // 工具返回值
+  "returns": [],
+  // 工具排序
+  "sort": 10,
+  // 工具状态, 0表示未启用, 1表示启用
+  "state": 1,
+  // 工具显示, 0表示不显示, 1表示显示
+  "show": 0,
+  // 是否结束
+  "end": false
+}

package/common/tool/knowledge/read_knowledge/index.js

@@ -0,0 +1,43 @@
+module.exports = {
+  /**
+   * 获取常识知识集合
+   * @param {string} knowledge_name - 常识知识名称(英文名, 唯一标识)
+   * @returns {object} 常识知识对象
+     */
+  getPrompt(knowledge_name) {
+    let knowledge = this.getServer().knowledge[knowledge_name];
+    return knowledge;
+  },
+  /**
+   * 读取常识知识详细内容
+   * @param {string} knowledge_name - 常识知识名称(英文名, 唯一标识)
+   * @returns {string} 常识知识详细内容
+   */
+  readPrompt(knowledge_name) {
+    let knowledge = this.getPrompt(knowledge_name);
+    if (!knowledge) {
+      throw new Error(`常识知识${knowledge_name}不存在`);
+    }
+    return knowledge.getPrompt();
+  },
+  /**
+   * 主函数
+   * @param {Object} params - 参数对象
+   * @param {string} params.knowledge_name - 常识知识名称(英文名, 唯一标识)
+   */
+  async main(params) {
+    try {
+      let content = this.readPrompt(params.knowledge_name);
+      return {
+        code: 0,
+        msg: '成功',
+        knowledge: content
+      };
+    } catch (error) {
+      return {
+        code: 10000,
+        msg: error.message
+      };
+    }
+  }
+}

package/common/tool/knowledge/read_knowledge/tool.json

@@ -0,0 +1,34 @@
+{
+  "name": "read_knowledge",
+  "title": "读取常识知识",
+  "description": "读取常识知识的内容。当需要了解某个领域的常识规范或约定时，使用该工具读取常识知识的内容。",
+  "category": "常识知识管理",
+  "group": "knowledge",
+  "type": "function",
+  "main": "./index.js",
+  "params": [
+    {
+      "name": "knowledge_name",
+      "description": "常识知识名称（英文名，唯一标识）",
+      "type": "string",
+      "required": true
+    }
+  ],
+  "returns": [
+    {
+      "name": "code",
+      "type": "number",
+      "description": "获取状态码，0表示成功"
+    },
+    {
+      "name": "msg",
+      "type": "string",
+      "description": "获取状态成功时为空，失败时为错误信息"
+    },
+    {
+      "name": "knowledge",
+      "type": "string",
+      "description": "常识知识内容"
+    }
+  ]
+}

package/common/tool/knowledge/set_knowledge/index.js

@@ -0,0 +1,74 @@
+module.exports = {
+  /**
+   * 获取常识知识
+   * @param {string} name 常识知识名称(由英文+数字+下划线组成)
+   * @returns {object} 常识知识对象
+   * @throws {Error} 常识知识不存在
+   */
+  getPrompt: function (name) {
+    let knowledge = this.getServer().knowledge[name];
+    if (!knowledge) {
+      throw new Error(`常识知识 ${name} 不存在`);
+    }
+    return knowledge;
+  },
+  /**
+   * 修改常识知识
+   * @param {object} config 常识知识配置对象
+   * @param {string} config.name 常识知识名称(由英文+数字+下划线组成)
+   * @param {string} config.title 常识知识标题(显示用的中文名称)
+   * @param {string} config.description 常识知识描述
+   * @param {string} config.group 常识知识分组
+   * @param {array} config.tags 常识知识标签
+   * @param {string} config.content 常识知识内容
+   * @returns {object} 常识知识对象
+   * @throws {Error} 常识知识不存在
+   */
+  setPrompt: function (config) {
+    let knowledge = this.getPrompt(config.name);
+    if (config.title) {
+      knowledge.config.title = config.title;
+    }
+    if (config.description) {
+      knowledge.config.description = config.description;
+    }
+    if (config.group) {
+      knowledge.config.group = config.group;
+    }
+    if (config.tags) {
+      knowledge.config.tags = config.tags;
+    }
+    if (config.content) {
+      knowledge.setPrompt(config.content);
+    }
+    return knowledge;
+  },
+  /**
+  * 主要逻辑
+  * @param {object} params 参数
+  * @param {string} params.name 常识知识名称(由英文+数字+下划线组成)
+  * @param {string} params.title 常识知识标题(显示用的中文名称)
+  * @param {string} params.description 常识知识描述
+  * @param {string} params.group 常识知识分组
+  * @param {array} params.tags 常识知识标签
+  * @param {string} params.content 常识知识内容
+  */
+  async main(params) {
+    let ret;
+    try {
+      let knowledge = await this.setPrompt(params);
+      ret = {
+        code: 0,
+        msg: `常识知识${params.name}修改成功`,
+        knowledge: knowledge.getDetail()
+      };
+    }
+    catch (error) {
+      ret = {
+        code: 10000,
+        msg: error.message
+      }
+    }
+    return ret;
+  }
+};

package/common/tool/knowledge/set_knowledge/tool.json

@@ -0,0 +1,83 @@
+{
+  "name": "set_knowledge",
+  "title": "修改常识知识",
+  "description": "实现修改已存在的常识知识。仅限技能导师可用。",
+  "category": "常识知识管理",
+  "group": "knowledge",
+  "type": "function",
+  "main": "./index.js",
+  "params": [
+    {
+      "name": "name",
+      "description": "常识知识名称(英文名, 唯一标识)",
+      "type": "string",
+      "required": true
+    },
+    {
+      "name": "title",
+      "type": "string",
+      "description": "常识知识标题(中文名)，要修改才填写。"
+    },
+    {
+      "name": "group",
+      "type": "string",
+      "description": "常识知识分组(英文名)，要修改才填写。"
+    },
+    {
+      "name": "description",
+      "type": "string",
+      "description": "常识知识描述，简单介绍该常识知识。要修改才填写。"
+    },
+    {
+      "name": "tags",
+      "type": "array",
+      "description": "常识知识标签数组，用于关联技能/智能体。要修改才填写。",
+      "default": [],
+      "item": {
+        "type": "string"
+      }
+    },
+    {
+      "name": "content",
+      "type": "string",
+      "description": "常识知识内容，使用Markdown格式编写。要修改才填写。"
+    }
+  ],
+  "returns": [
+    {
+      "name": "code",
+      "type": "number",
+      "description": "操作状态代码，0表示成功，其他表示失败",
+      "default": 0
+    },
+    {
+      "name": "msg",
+      "type": "string",
+      "description": "操作反馈消息，成功时返回成功提示，失败时返回错误信息",
+      "default": ""
+    },
+    {
+      "name": "knowledge",
+      "type": "object",
+      "description": "常识知识对象，包含常识知识信息",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "常识知识名称(英文名, 唯一标识)"
+        },
+        "title": {
+          "type": "string",
+          "description": "常识知识标题(中文名)"
+        },
+        "group": {
+          "type": "string",
+          "description": "常识知识分组(英文名)"
+        },
+        "dir": {
+          "type": "string",
+          "description": "常识知识目录"
+        }
+      }
+    }
+  ]
+}