mm_cmd 1.1.2 → 1.1.4

package/README.md

@@ -8,4 +8,13 @@
 2. 后端先进行基础的指令判断（内容是否匹配有指令关键词），判断消息是否为指令。
 3. 如果是指令，则执行指令处理。
 4. 如果不是指令，再交由AI判断是否为指令。
-5. 如果AI判断为指令，则执行指令处理。
+5. 如果AI判断为指令，则执行指令处理。
+
+## 工具契约（LLM 可调用）
+
+本模块 `tool/` 下登记以下工具契约，实现位于 `lib/tools/<name>/`，`tool/<name>/index.js` 仅为薄适配层。
+其它模块可直接 `require('<pkg>').tools.<name>` 复用实现，无需经过工具注册面。
+
+| 工具名 | 标题 | 说明 |
+| --- | --- | --- |
+| `command` | 聊天指令匹配与执行 | 指令清单、命中判断、按消息执行 |

package/index.js

@@ -1,7 +1,7 @@
-const Admin = require('mm_corejs').Admin;
+const { reg } = require('mm_admin');
 const Manager = require('./lib/manager');
 
-let admin = new Admin();
+const admin = reg('mm_cmd');
 admin.setClass(Manager);
 
 module.exports = {
@@ -9,9 +9,10 @@ module.exports = {
   Manager,
   admin,
   cmdAdmin(scope, config) {
-    if (!scope) {
-      scope = 'os';
-    }
-    return admin.get(scope, config);
+    return admin.get(scope || 'os', config);
   }
-};
+};
+
+/* mm-tool-logic-export 工具能力层：其它模块可 require("mm_cmd").tools.<name> 直接引用 */
+Object.defineProperty(module.exports, 'tools', { enumerable: true, configurable: true,
+  get: function () { return require('./lib/tools'); } });

package/lib/tools/command/index.js

@@ -0,0 +1,39 @@
+'use strict';
+/**
+ * command —— 聊天指令匹配与执行工具
+ * 复用模块 Cmd 实例：match 走关键字匹配，run 走完整指令分发，不重写分发逻辑。
+ */
+const { cmdAdmin } = require('../../../index.js');
+
+async function main(params, ctx, options) {
+  void options;
+  const p = params || {};
+  const action = p.action || 'list';
+  const done = (data) => { ctx.output = data; return data; };
+
+  try {
+    const inst = cmdAdmin(p.scope || 'os');
+
+    if (action === 'list') {
+      const list = Object.keys(inst.methods || {});
+      return done({ code: 0, msg: '成功', count: list.length, list });
+    }
+
+    if (action === 'match') {
+      if (!p.content) throw new TypeError('content 不能为空');
+      return done({ code: 0, msg: '成功', matched: !!inst.match(p.content) });
+    }
+
+    if (action === 'run') {
+      if (!p.content) throw new TypeError('content 不能为空');
+      const result = await inst.run({ content: p.content }, p.db);
+      return done({ code: 0, msg: '执行完成', result });
+    }
+
+    return done({ code: 10001, msg: '不支持的操作: ' + action });
+  } catch (error) {
+    return done({ code: 10000, msg: '执行失败：' + error.message, error: { name: error.name, message: error.message } });
+  }
+}
+
+module.exports = { main };

package/lib/tools/index.js

@@ -0,0 +1,16 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+/** 模块能力层：懒加载工具实现，避免模块入口被 require 时加载全部实现 */
+module.exports = new Proxy({}, {
+  get(_t, key) {
+    if (typeof key !== 'string') return undefined;
+    if (!fs.existsSync(path.join(__dirname, key, 'index.js'))) return undefined;
+    return require('./' + key);
+  },
+  has(_t, key) {
+    return typeof key === 'string' && fs.existsSync(path.join(__dirname, key, 'index.js'));
+  },
+  ownKeys() { return fs.readdirSync(__dirname, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name); },
+  getOwnPropertyDescriptor(_t, key) { return this.has(_t, key) ? { enumerable: true, configurable: true } : undefined; }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_cmd",
-    "version": "1.1.2",
+    "version": "1.1.4",
     "description": "指令框架，用于以聊天的方式操作程序，前端发送字符串，后端判断是否为指令并执行（基于 mm_corejs，内置管理器池，无全局/原型扩展依赖）",
     "main": "index.js",
     "repository": {
@@ -16,12 +16,12 @@
         "chat",
         "指令管理器"
     ],
-    "layer": "infra",
-    "group": "in_adapter",
+    "layer": "interface",
+    "group": "inbound",
     "author": "邱文武",
     "license": "ISC",
     "dependencies": {
-        "mm_corejs": "^1.1.4",
+        "mm_admin": "^1.1.0",
         "mm_mod": "^1.0.1",
         "mm_matchs": "^1.1.10"
     },

package/tool/command/index.js

@@ -0,0 +1,7 @@
+'use strict';
+/**
+ * command —— 工具契约适配层
+ * 业务实现归位于模块 lib/tools/command/，本文件只把模块能力暴露给加载器。
+ * 其它模块可直接 require('mm_cmd').tools.command 复用。
+ */
+module.exports = require('../../lib/tools/command');

package/tool/command/tool.json

@@ -0,0 +1,73 @@
+{
+  "name": "command",
+  "title": "聊天指令匹配与执行",
+  "description": "基于 mm_cmd 的指令框架能力：判断一段聊天文本是否为已注册指令、列出已注册的指令方法、以消息对象执行指令并返回反馈内容。适用场景：验证用户输入会不会命中指令、在非 IM 场景复用指令脚本、排查指令未注册。工作流提示：match 只传 content；run 传 content，可选 db 作为会话库标识。",
+  "category": "指令框架",
+  "group": "cmd",
+  "type": "function",
+  "main": "./index.js",
+  "params": {
+    "type": "object",
+    "properties": {
+      "action": {
+        "type": "string",
+        "description": "操作类型: list(列出指令方法)/match(匹配指令)/run(执行指令)",
+        "enum": [
+          "list",
+          "match",
+          "run"
+        ],
+        "default": "list"
+      },
+      "content": {
+        "type": "string",
+        "description": "聊天文本内容(match/run 必填)"
+      },
+      "db": {
+        "type": "string",
+        "description": "会话库标识，传给指令方法的第二参数(run 可选)"
+      },
+      "scope": {
+        "type": "string",
+        "description": "实例作用域，缺省 os",
+        "default": "os"
+      }
+    },
+    "required": [
+      "action"
+    ]
+  },
+  "returns": {
+    "type": "object",
+    "properties": {
+      "code": {
+        "type": "number",
+        "description": "0 表示成功，1xxxx 表示业务/执行异常"
+      },
+      "msg": {
+        "type": "string",
+        "description": "结果描述"
+      },
+      "list": {
+        "type": "array",
+        "description": "已注册的指令方法名(list)"
+      },
+      "count": {
+        "type": "number",
+        "description": "指令方法数量(list)"
+      },
+      "matched": {
+        "type": "boolean",
+        "description": "是否命中指令(match)"
+      },
+      "result": {
+        "description": "指令执行结果(run)"
+      },
+      "error": {
+        "type": "object",
+        "description": "异常对象 { name, message }"
+      }
+    }
+  },
+  "handler": "manager"
+}