mm_admin 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -149,3 +149,12 @@ npm test
149
149
  - 实例池按名称缓存,提供 `get` / `getAsync` / `has` / `del` / `clear` / `keys` / `values` 及 `size`
150
150
  - 实例创建钩子仅在异步获取新实例时执行
151
151
  - 新增测试与示例,测试覆盖率 100%
152
+
153
+ ## 工具契约(LLM 可调用)
154
+
155
+ 本模块 `tool/` 下登记以下工具契约,实现位于 `lib/tools/<name>/`,`tool/<name>/index.js` 仅为薄适配层。
156
+ 其它模块可直接 `require('<pkg>').tools.<name>` 复用实现,无需经过工具注册面。
157
+
158
+ | 工具名 | 标题 | 说明 |
159
+ | --- | --- | --- |
160
+ | `admin_pool` | 管理器实例池自省 | 注册表清单、实例键、密钥与注销 |
package/index.js CHANGED
@@ -68,3 +68,7 @@ module.exports = {
68
68
  setSecret,
69
69
  list
70
70
  };
71
+
72
+ /* mm-tool-logic-export 工具能力层:其它模块可 require("mm_admin").tools.<name> 直接引用 */
73
+ Object.defineProperty(module.exports, 'tools', { enumerable: true, configurable: true,
74
+ get: function () { return require('./lib/tools'); } });
package/lib/admin.js CHANGED
@@ -144,6 +144,25 @@ class Admin {
144
144
  return manager;
145
145
  }
146
146
 
147
+ /**
148
+ * 注册已创建的管理器实例
149
+ * 用于宿主应用注入自定义实例(如带特殊配置的存储),后续 get 直接返回该实例。
150
+ * @param {string} name 管理器名称
151
+ * @param {Object} instance 实例
152
+ * @returns {Object} 注册的实例
153
+ * @throws {Error} 名称或实例非法时抛错
154
+ */
155
+ set(name, instance) {
156
+ if (!name) {
157
+ throw new Error('管理器名称不能为空');
158
+ }
159
+ if (!instance || typeof instance !== 'object') {
160
+ throw new Error('实例不能为空');
161
+ }
162
+ this.#map.set(name, instance);
163
+ return instance;
164
+ }
165
+
147
166
  /**
148
167
  * 判断管理器实例是否存在
149
168
  * @param {string} name 管理器名称
@@ -0,0 +1,45 @@
1
+ 'use strict';
2
+ /**
3
+ * admin_pool —— 管理器实例池自省工具
4
+ * 复用模块的全局注册表(reg/list/unreg/setSecret),不维护第二份实例表。
5
+ */
6
+ const adminMod = require('../../../index.js');
7
+
8
+ async function main(params, ctx, options) {
9
+ void options;
10
+ const p = params || {};
11
+ const action = p.action || 'registry';
12
+ const done = (data) => { ctx.output = data; return data; };
13
+
14
+ try {
15
+ if (action === 'registry') {
16
+ const registry = adminMod.list();
17
+ return done({ code: 0, msg: '成功', count: registry.length, registry });
18
+ }
19
+
20
+ if (action === 'inspect') {
21
+ if (!p.name) throw new TypeError('name 不能为空');
22
+ const admin = adminMod.reg(p.name);
23
+ const keys = typeof admin.keys === 'function' ? admin.keys() : [];
24
+ return done({ code: 0, msg: '成功', name: p.name, exists: true, count: keys.length, keys });
25
+ }
26
+
27
+ if (action === 'secret') {
28
+ if (!p.secret) throw new TypeError('secret 不能为空');
29
+ const ok = adminMod.setSecret(p.secret);
30
+ return done({ code: 0, msg: ok ? '密钥已设置' : '密钥已存在或为空,设置失败', ok });
31
+ }
32
+
33
+ if (action === 'unreg') {
34
+ if (!p.name) throw new TypeError('name 不能为空');
35
+ const ok = adminMod.unreg(p.name, p.secret);
36
+ return done({ code: 0, msg: ok ? '注销成功' : '注销失败:需提供正确的全局密钥', name: p.name, ok });
37
+ }
38
+
39
+ return done({ code: 10001, msg: '不支持的操作: ' + action });
40
+ } catch (error) {
41
+ return done({ code: 10000, msg: '执行失败:' + error.message, error: { name: error.name, message: error.message } });
42
+ }
43
+ }
44
+
45
+ module.exports = { main };
@@ -0,0 +1,16 @@
1
+ 'use strict';
2
+ const fs = require('fs');
3
+ const path = require('path');
4
+ /** 模块能力层:懒加载工具实现,避免模块入口被 require 时加载全部实现 */
5
+ module.exports = new Proxy({}, {
6
+ get(_t, key) {
7
+ if (typeof key !== 'string') return undefined;
8
+ if (!fs.existsSync(path.join(__dirname, key, 'index.js'))) return undefined;
9
+ return require('./' + key);
10
+ },
11
+ has(_t, key) {
12
+ return typeof key === 'string' && fs.existsSync(path.join(__dirname, key, 'index.js'));
13
+ },
14
+ ownKeys() { return fs.readdirSync(__dirname, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name); },
15
+ getOwnPropertyDescriptor(_t, key) { return this.has(_t, key) ? { enumerable: true, configurable: true } : undefined; }
16
+ });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mm_admin",
3
- "version": "1.1.0",
3
+ "version": "1.2.0",
4
4
  "description": "管理器实例池模块,基于 Map 按名称缓存管理器实例,提供同步/异步获取、创建钩子、删除与清空(setClass/get/del/clear/keys/values),并通过全局注册表统一管理 Admin 实例(reg/unreg/list/setSecret)。",
5
5
  "keywords": [
6
6
  "mm_mod",
@@ -19,7 +19,8 @@
19
19
  "files": [
20
20
  "index.js",
21
21
  "lib",
22
- "example"
22
+ "example",
23
+ "tool"
23
24
  ],
24
25
  "directories": {
25
26
  "example": "example",
@@ -0,0 +1,7 @@
1
+ 'use strict';
2
+ /**
3
+ * admin_pool —— 工具契约适配层
4
+ * 业务实现归位于模块 lib/tools/admin_pool/,本文件只把模块能力暴露给加载器。
5
+ * 其它模块可直接 require('mm_admin').tools.admin_pool 复用。
6
+ */
7
+ module.exports = require('../../lib/tools/admin_pool');
@@ -0,0 +1,78 @@
1
+ {
2
+ "name": "admin_pool",
3
+ "title": "管理器实例池自省",
4
+ "description": "基于 mm_admin 的实例池能力:列出当前进程内已注册的 Admin 实例名、判断某个实例是否存在、查看实例内已缓存的实例数量、设置全局密钥或注销实例。适用场景:排查管理器实例为何取不到、确认模块是否已注册、清理实例池。",
5
+ "category": "内核运行时",
6
+ "group": "kernel",
7
+ "type": "function",
8
+ "main": "./index.js",
9
+ "params": {
10
+ "type": "object",
11
+ "properties": {
12
+ "action": {
13
+ "type": "string",
14
+ "description": "操作类型: registry(已注册实例)/inspect(查看实例)/secret(设置密钥)/unreg(注销实例)",
15
+ "enum": [
16
+ "registry",
17
+ "inspect",
18
+ "secret",
19
+ "unreg"
20
+ ],
21
+ "default": "registry"
22
+ },
23
+ "name": {
24
+ "type": "string",
25
+ "description": "实例名称(inspect/unreg 必填)"
26
+ },
27
+ "secret": {
28
+ "type": "string",
29
+ "description": "全局密钥(secret/unreg 必填),只允许设置一次"
30
+ },
31
+ "scope": {
32
+ "type": "string",
33
+ "description": "作用域(inspect 可选),缺省取该实例已缓存的全部键"
34
+ }
35
+ },
36
+ "required": [
37
+ "action"
38
+ ]
39
+ },
40
+ "returns": {
41
+ "type": "object",
42
+ "properties": {
43
+ "code": {
44
+ "type": "number",
45
+ "description": "0 表示成功,1xxxx 表示业务/执行异常"
46
+ },
47
+ "msg": {
48
+ "type": "string",
49
+ "description": "结果描述"
50
+ },
51
+ "registry": {
52
+ "type": "array",
53
+ "description": "已注册实例名列表"
54
+ },
55
+ "count": {
56
+ "type": "number",
57
+ "description": "数量"
58
+ },
59
+ "exists": {
60
+ "type": "boolean",
61
+ "description": "实例是否存在"
62
+ },
63
+ "keys": {
64
+ "type": "array",
65
+ "description": "该实例已缓存的键(inspect)"
66
+ },
67
+ "ok": {
68
+ "type": "boolean",
69
+ "description": "操作是否成功"
70
+ },
71
+ "error": {
72
+ "type": "object",
73
+ "description": "异常对象 { name, message }"
74
+ }
75
+ }
76
+ },
77
+ "handler": "manager"
78
+ }