mm_os 3.3.0 → 4.0.0

package/core/com/plugin/index.js

@@ -1,259 +0,0 @@
-const compressing = require('compressing');
-const Index = require('mm_machine').Index;
-const Drive = require('./drive');
-
-/**
- * Plugin插件类
- * @extends {Index}
- * @class 
- */
-class Plugin extends Index {
-	/**
-	 * 构造函数
-	 * @param {Object} scope 作用域
-	 * @param {String} title 标题
-	 * @constructor
-	 */
-	constructor(scope, title) {
-		super(scope, __dirname);
-		this.Drive = Drive;
-		this.type = "plugin";
-		this.title = title;
-		// 默认启用热更新
-		this.mode = 3;
-	}
-}
-
-/**
- * 聊天（通过聊天的方式驱动插件, 用于机器人开发）
- * @param {String} from_user 发送消息人
- * @param {String} to_user 接收消息人
- * @param {String} content 内容
- * @param {String} group 群组 如果是个人，群组为空
- * @param {Number} type 群类型, 1永久会话/群、2临时会话/群
- * @param {String} msg_type 消息类型, event事件型、message消息型。默认消息型
- * @param {Object} 数据管理器
- * @return {String} 回复内容
- */
-Plugin.prototype.chat = async function(from_user, to_user, group, content, type, msg_type, db) {
-	var ret = "";
-	var lt = this.list;
-	for (var i = 0, o; o = lt[i++];) {
-		if (o.config.state === 1) {
-			ret = await o.chat(from_user, to_user, group, content, type, msg_type, db);
-			if (ret) {
-				break;
-			}
-		}
-	}
-	return ret;
-};
-
-/**
- * 初始化插件
- * @param {Object} option 配置参数
- * @return {String} 执行结果
- */
-Plugin.prototype.init = function(option) {
-	var ret = "";
-	var lt = this.list;
-	for (var i = 0, o; o = lt[i++];) {
-		ret = o.exec('init', option);
-	}
-	return ret;
-};
-
-/**
- * 加载插件
- * @param {String} path 检索路径
- * @param {Boolean} accurate 是否精确路径
- */
-Plugin.prototype.update_config_all = async function(path, accurate) {
-	var dir_plugin;
-	if (accurate) {
-		dir_plugin = path;
-	} else {
-		if (!path) {
-			path = '/app/' + this.scope;
-		}
-		dir_plugin = path + "/plugin/";
-	}
-	if (dir_plugin.hasDir()) {
-		var list_scope = $.dir.get(dir_plugin);
-		// 遍历目录路径
-		for (var i = 0, o; o = list_scope[i++];) {
-			var file = './plugin.json'.fullname(o);
-			if (file.hasFile()) {
-				await this.load_file(file, true);
-			}
-		}
-	}
-};
-
-/**
- * 压缩插件
- * @param {Object} name 插件名称
- * @returns {Boolean} 返回压缩路径
- */
-Plugin.prototype.zip = async function(name) {
-	var plus = this.get(name);
-	if (plus) {
-		return await plus.zip();
-	}
-	return null;
-}
-
-/**
- * 解压插件
- * @param {Object} file 插件压缩文件
- * @returns {Boolean} 返回解压结果
- */
-Plugin.prototype.unzip = async function(file) {
-	var name = file.basename().left(".");
-	var dir = `/cache/plugin/${name}`.fullname();
-	dir.addDir();
-	var ret;
-	try {
-		await compressing.zip.uncompress(file, dir);
-		ret = {
-			file,
-			dir
-		};
-	} catch (err) {
-		$.log.error("插件解压失败！", err);
-	}
-	return ret;
-}
-
-/**
- * 卸载插件
- * @param {String} name 插件名称
- * @returns {String} 返回卸载路径
- */
-Plugin.prototype.uninstall = async function(name) {
-	var plus = this.get(name);
-	if (plus) {
-		await plus.exec('uninstall');
-		var obj = this.del(name, true);
-		if (obj) {
-			var file = obj.filename;
-			// 删除目录
-			file.dirname().delDir();
-			return file
-		}
-	}
-	return null;
-}
-
-/**
- * 复制目录
- * @param {String} dir_src 原路径
- * @param {String} dir 新路径
- * @returns {Object} 返回复制结果
- */
-Plugin.prototype.copy_dir = function(dir_src, dir) {
-	return new Promise((resolve, reject) => {
-		$.dir.copy(dir_src, dir, () => {
-			resolve({
-				dir_src,
-				dir
-			});
-		});
-	});
-}
-
-/**
- * 安装插件
- * @param {String} file 插件压缩文件
- * @returns {Object} 返回解压结果
- */
-Plugin.prototype.install = async function(file) {
-	var ret = await this.unzip(file);
-	if (ret) {
-		var dirs = $.dir.get(ret.dir);
-		if (dirs.length) {
-			var dir_src = dirs[0];
-			var file = "./plugin.json".fullname(dir_src);
-			var config = file.loadJson();
-			if (config) {
-				var app = config.app || 'sys';
-				var name = config.name;
-				if (name) {
-					var dir = `/app/${app}/plugin/${name}`;
-					await this.copy_dir(dir_src, dir);
-					var cs = $.pool.plugin[app];
-					if (cs) {
-						await cs.update(`/app/${app}/`.fullname());
-						await cs.exec(name, 'install');
-						setTimeout(() => {
-							ret.dir.delDir();
-						}, 3000)
-					}
-					return {
-						app,
-						name,
-						dir_src,
-						dir
-					}
-				}
-			}
-		}
-	}
-}
-
-// /**
-//  * 更新插件
-//  * @param {String} name 插件名称
-//  * @returns {Object} 返回更新结果
-//  */
-// Plugin.prototype.update = async function(name) {
-// 	var plus = this.get(name);
-// 	if (plus) {
-// 		var cg = plus.config;
-// 		// 先将配置缓存
-// 		var file = `/cache/config/${cg.app}_${cg.name}.json`;
-// 		file.saveJson(cg);
-
-// 		var dir = plus.filename.dirname();
-
-// 		// 判断是否存在git仓库
-// 		if (cg.git) {
-// 			if (dir.hasDir('.git')) {
-// 				// "git fetch";
-// 				// "git reset --hard origin/master"
-// 			}
-// 		}
-// 	} else {
-// 		ret = $.ret.error("更新失败！原因：插件不存在");
-// 	}
-// }
-
-module.exports = Plugin;
-
-
-/**
- * 创建全局管理器
- */
-if (!$.pool.plugin) {
-	$.pool.plugin = {};
-}
-
-function plugin_admin(scope, title) {
-	if (!scope) {
-		scope = $.val.scope + '';
-	}
-	var obj = $.pool.plugin[scope];
-	if (!obj) {
-		$.pool.plugin[scope] = new Plugin(scope, title);
-		obj = $.pool.plugin[scope];
-	}
-	return obj;
-}
-
-/**
- * plugin管理器, 用于管理插件
- * @param {string} scope 作用域
- * @param {string} title 标题
- * @return {Object} 返回一个缓存类
- */
-$.plugin_admin = plugin_admin;

package/core/com/plugin/script.js

@@ -1,213 +0,0 @@
-/**
- * @fileOverview {0}
- * @author <a href="作者主页地址">插件作者</a>
- * @version 1.0
- */
-
-/**
- * 插件对象
- */
-module.exports = {
-	/**
-	 * 安装，把插件安装到系统中，在安装时执行
-	 * @param {Object} option 配置参数
-	 * @param {String} option.path 插件安装路径
-	 * @param {Object} option.config 插件配置信息
-	 * @param {String} option.version 插件版本号
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：路径不存在、版本不兼容、依赖缺失等
-	 */
-	install(option) {
-		var msg = null;
-		// 此处常用于更新文件和导入数据库等操作。通常为一次操作
-		return msg;
-	},
-	/**
-	 * 加载插件，当脚本被引入时会执行
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null, 否则返回错误提示。常见错误：依赖模块加载失败、模块冲突等
-	 */
-	load(option) {
-		var msg = null;
-		// 此处通常用于require加载其他相关模块（不在脚本文件中直接require模块,可提高启动速度，可根据插件优先级优先加载模块）
-		return msg;
-	},
-	/**
-	 * 初始化插件，设置全局变量、路由规则和定时任务等
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null, 否则返回错误提示。常见错误：配置格式错误、路由冲突等
-	 */
-	init(option) {
-		var msg = null;
-		// 此处主要用于重置全局变量和配置，更新路由和更新定时任务等操作
-		return msg;
-	},
-
-	/**
-	 * 启动插件，开启路由监听和定时任务
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：端口被占用、服务启动超时等
-	 */
-	start(option) {
-		var msg = null;
-		// 此处主要用于开启路由和定时任务
-		return msg;
-	},
-	/**
-	 * 重启插件，在配置更改或插件更新时执行
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：重启超时、服务未完全停止等
-	 */
-	restart(option) {
-		var msg = null;
-		this.stop();
-		this.start();
-		return msg;
-	},
-	/**
-	 * 暂停插件，临时停止路由和定时任务的执行
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：有未完成的任务、停止超时等
-	 */
-	stop(option) {
-		var msg = null;
-		// 此处主要用于关闭路由和定时任务
-		return msg;
-	},
-	/**
-	 * 结束插件，清理路由、定时任务和连接
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：资源释放失败、清理超时等
-	 */
-	end(option) {
-		var msg = null;
-		// 主要用于移除注册的路由、 定时任务连接
-		return msg;
-	},
-	/**
-	 * 卸载已加载的模块，释放内存资源
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：模块正在使用、依赖关系阻止卸载等
-	 */
-	unload(option) {
-		var msg = null;
-		// 主要用于移除加载的模块，释放内存（卸载require的模块,降低系统运行内存）
-		return msg;
-	},
-	/**
-	 * 插件版本更新，包括下载、安装和重启
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null, 否则返回错误提示。常见错误：网络问题、版本冲突、空间不足等
-	 */
-	update(option) {
-		var msg = null;
-		// 下载最新版本，重新安装、重新加载并初始化，如果本身程序属于启动状态，将重新启动
-		this.install(option);
-		if (this.config.state == 1) {
-			this.load(option);
-			this.init(option);
-			this.start(option);
-		}
-		return msg;
-	},
-	/**
-	 * 卸载插件，完全移除插件及其相关资源
-	 * @param {Object} option 配置参数
-	 * @return {String} 成功返回null,否则返回错误提示。常见错误：文件删除失败、数据库清理失败等
-	 */
-	uninstall(option) {
-		var msg = null;
-		// 此处从系统中完全删除程序及其所有相关文件和配置。卸载后，该插件不会在系统中留下任何痕迹‌
-		return msg;
-	},
-	/**
-	 * 配置更新后的处理函数
-	 * @param {Object} options 更新后的配置对象
-	 */
-	update_options_after(options) {
-		if (this.config.state) {
-			this.restart();
-		}
-	},
-	/**
-	 * 获取插件使用帮助信息
-	 * @param {String} item 查询的功能项，如"install"、"api"等
-	 * @return {Object} 返回帮助信息对象
-	 * @example
-	 * // 获取安装相关帮助
-	 * help("install") 
-	 * // 返回: {title: "安装说明", steps: ["步骤1...", "步骤2..."], examples: [...]}
-	 */
-	help(item) {
-		var tip = "";
-		switch (item) {
-			case "run":
-				break;
-			default:
-				break;
-		}
-		return tip;
-	},
-
-	/**
-	 * 插件主程序，处理核心业务逻辑
-	 * @param {Object} param1 业务参数对象
-	 * @param {Object} param2 配置参数对象
-	 * @return {Object} 返回执行结果对象 {code: 0, msg: "success", data: {}}
-	 * @example
-	 * main({action: "process", data: {id: 1}}, {options: {async: true}})
-	 * // 返回: {code: 0, msg: "处理成功", data: {result: "..."}} 
-	 */
-	main(param1, param2) {
-		var ret = null;
-		return ret;
-	},
-
-	/**
-	 * 执行命令行指令
-	 * @param {String} content 指令内容，格式为"命令 参数1 参数2..."
-	 * @return {String} 执行结果文本
-	 * @example
-	 * cmd("status --detail") 
-	 * // 返回: "运行状态: 正常\n内存使用: 80MB\n已运行时间: 2h"
-	 */
-	cmd(content) {
-		var ret = "";
-		return ret;
-	},
-
-	/**
-	 * 插件API接口，供其他插件调用
-	 * @param {Object} ctx HTTP上下文对象
-	 * @param {String} ctx.method 请求方法
-	 * @param {Object} ctx.query 查询参数
-	 * @param {Object} ctx.body 请求体数据
-	 * @param {Object} db 数据库管理器实例
-	 * @return {Object} 返回API执行结果 {code: 200, data: {}, msg: ""}
-	 * @example
-	 * api({method: "GET", query: {id: 1}}, db)
-	 * // 返回: {code: 200, data: {name: "test"}, msg: "success"}
-	 */
-	api(ctx, db) {
-		var ret = "";
-		return ret;
-	},
-
-	/**
-	 * 聊天消息处理函数，用于机器人开发
-	 * @param {String} from_user 发送消息用户的唯一标识
-	 * @param {String} to_user 接收消息用户的唯一标识
-	 * @param {String} content 消息内容
-	 * @param {String} group 群组ID，个人聊天时为空
-	 * @param {Number} type 会话类型: 1-永久会话/群、2-临时会话/群
-	 * @param {String} msg_type 消息类型: event-事件消息、message-普通消息(默认)
-	 * @param {Object} db 数据管理器实例
-	 * @return {String} 回复消息内容
-	 * @example
-	 * chat("user1", "user2", "你好", "", 1, "message", db)
-	 * // 返回: "你好，我是智能助手，有什么可以帮你的吗？"
-	 */
-	async chat(from_user, to_user, group, content, type, msg_type, db) {
-		var ret = "";
-		return ret;
-	}
-};

package/core/com/rpc/com.json

@@ -1,4 +0,0 @@
-{
-	"name": "rpc通讯管理器",
-	"script": "./index.js"
-}

package/core/com/rpc/drive.js

@@ -1,160 +0,0 @@
-const Item = require('mm_machine').Item;
-
-/**
- * Api接口驱动类
- * @extends {Item}
- * @class
- */
-class Drive extends Item {
-	/**
-	 * 构造函数
-	 * @param {String} dir 当前目录
-	 * @constructor
-	 */
-	constructor(dir) {
-		/**
-		 * 定义当前RPC文件路径
-		 */
-		this.rpc_file_now = "";
-		
-		/**
-		 * 定义rpc 方法
-		 */
-		this.methods = {};
-	}
-}
-
-/**
- * 获取现有参数
- * @param {String} file 文件名
- * @return {Object} 获取的对象
- */
-Drive.prototype.getParam = function(file) {
-	if ($.param) {
-		var obj = $.param.list.getObj({
-			filename: file
-		});
-		if (obj) {
-			return obj;
-		}
-	}
-	return null;
-};
-
-/**
- * 设置参数对象
- * @param {Object} param 参数对象
- */
-Drive.prototype.setParam = function(param) {
-	if ($.param) {
-		var lt = $.param.list;
-		if (lt) {
-			var has = false;
-			var len = lt.length;
-			for (var i = 0; i < len; i++) {
-				var o = lt[i];
-				if (param.filename === o.filename) {
-					$.param.list[i] = param;
-					has = true;
-					break;
-				}
-			}
-			if (!has) {
-				$.param.list.push(param);
-			}
-		}
-	}
-};
-
-/**
- * 加载参数
- * @param {String} file_path 文件路径
- */
-Drive.prototype.loadParam = async function(file_path) {
-	if (file_path) {
-		var p = file_path.fullname(this.dir);
-		var param = this.getParam(p);
-		if (param) {
-			this.param = param;
-		} else {
-			this.param = new Param(this.dir);
-			await this.param.exec('load_config', p);
-			this.setParam(this.param);
-			this.param.load('load');
-		}
-	}
-};
-
-/**
- * 加载完成后执行
- */
-Drive.prototype.load_after = function() {
-	var cg = this.config;
-	this.loadParam(cg.param_path);
-};
-
-
-/**
- * 验证参数
- * @param {Object} query url参数
- * @param {Object} body 内容参数
- * @param {String} method 方法
- * @return {Object} 验证结果
- */
-Drive.prototype.checkParam = function(query, body, method) {
-	if (this.param) {
-		var msg = this.param.check(query, body, method);
-		if (msg) {
-			var code;
-			if (msg.indexOf("必须") !== -1 || msg.indexOf("为空") !== -1) {
-				code = 30001;
-			} else {
-				code = 30002;
-			}
-			return $.ret.error(code, msg);
-		}
-	}
-	return null;
-};
-
-
-/**
- * 运行GRPC方法
- * @param {Object} db 数据库管理器
- * @param {String} method 方法名称
- * @param {Object} query 查询条件
- * @param {Object} body 增改项
- * @return {Object} 返回执行结果
- */
-Drive.prototype.run = async function(db, method, query, body) {
-	var func = this.methods[method];
-	var ret = {};
-	try {
-		if (func) {
-			ret = this.checkParam(query, body, method);
-			if (!ret) {
-				ret = await func(db, query, body);
-			}
-		} else {
-			ret = {
-				error: {
-					code: 60000,
-					message: "方法名称不存在",
-					data: Object.keys(this.methods)
-				}
-			}
-		}
-	} catch (err) {
-		$.log.error("运行RPC方法错误！", method, err);
-		ret = {
-			error: {
-				code: 500,
-				message: "服务端业务逻辑错误"
-			}
-		}
-	}
-	return ret;
-};
-
-/* 导出驱动 */
-module.exports = Drive;

package/core/com/rpc/index.js

@@ -1,87 +0,0 @@
-const Index = require('mm_machine').Index;
-const Drive = require('./drive');
-
-/**
- * RPC导航类
- * @extends {Index}
- * @class
- */
-class RPC extends Index {
-	/**
-	 * 构造函数
-	 * @param {Object} scope 作用域
-	 * @param {String} title 标题
-	 * @constructor
-	 */
-	constructor(scope, title) {
-		super(scope, __dirname);
-		this.Drive = Drive;
-		this.type = "rpc";
-		this.title = title;
-		this.list = [];
-		// 默认启用热更新
-		this.mode = 3;
-	}
-}
-
-/**
- * 运行GRPC方法
- * @param {Object} db 数据库管理器
- * @param {String} class_name 类名
- * @param {String} method 方法名称
- * @param {Object} query 查询条件
- * @param {Object} body 增改项
- * @return {Object} 返回执行结果
- */
-RPC.prototype.run = async function(db, class_name, method, query, body) {
-	if (!db) {
-		db = {
-			ret: null
-		};
-	}
-
-	var lt = this.list;
-	for (var i = 0, o; o = lt[i++];) {
-		if (o.config.state === 1 && class_name == o.config.name) {
-			var ret = await o.run(db, method, query, body);
-			if (ret) {
-				db.ret = ret;
-				break;
-			}
-		}
-	}
-	return db.ret;
-};
-
-/* 导出指令 */
-exports.RPC = RPC;
-
-/**
- * RPC事件池
- */
-if (!$.pool.rpc) {
-	$.pool.rpc = {};
-}
-
-/**
- * RPC管理器，用于创建缓存
- * @param {String} scope 作用域
- * @param {string} title 标题
- * @return {Object} 返回一个缓存类
- */
-function rpc_admin(scope, title) {
-	if (!scope) {
-		scope = $.val.scope + '';
-	}
-	var obj = $.pool.rpc[scope];
-	if (!obj) {
-		$.pool.rpc[scope] = new RPC(scope, title);
-		obj = $.pool.rpc[scope];
-	}
-	return obj;
-}
-
-/**
- * @module 导出RPC管理器
- */
-$.rpc_admin = rpc_admin;