mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 21:40:50 +00:00
3b5bd37bfb
为所有 MCP 内置工具实现 category() 分类方法，支持管理后台按业务分组展示；优化订单列表关键词搜索逻辑，使用闭包显式 OR 条件匹配订单号和商品标题，避免管道字段静默丢弃问题；新增优惠券库存调整原子方法，提升并发安全性；同步更新相关文档和注释，完善分类展示规则说明。
111 lines
3.7 KiB
PHP
111 lines
3.7 KiB
PHP
<?php
|
||
// +----------------------------------------------------------------------
|
||
// | CRMEB [ CRMEB赋能开发者，助力企业发展 ]
|
||
// +----------------------------------------------------------------------
|
||
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
|
||
// +----------------------------------------------------------------------
|
||
// | Licensed CRMEB并不是自由软件，未经许可不能去掉CRMEB相关版权
|
||
// +----------------------------------------------------------------------
|
||
// | Author: CRMEB Team <admin@crmeb.com>
|
||
// +----------------------------------------------------------------------
|
||
declare(strict_types=1);
|
||
|
||
namespace modules\service\mcp\tools;
|
||
|
||
use crmeb\interfaces\McpToolInterface;
|
||
use think\facade\Db;
|
||
|
||
/**
|
||
* MCP 工具：已安装模块清单
|
||
*
|
||
* 查询系统模块安装日志（模块框架基础数据），返回已安装模块及启用状态。
|
||
* 供 AI 判断「功能所属模块是否已安装」：未安装的模块在后台不存在对应
|
||
* 菜单与配置项，禁止直接给出其操作路径。
|
||
*/
|
||
class ModuleListTool implements McpToolInterface
|
||
{
|
||
/**
|
||
* 工具名称
|
||
* @return string
|
||
*/
|
||
public function name(): string
|
||
{
|
||
return 'crmeb_module_list';
|
||
}
|
||
|
||
/**
|
||
* 工具描述
|
||
* @return string
|
||
*/
|
||
public function description(): string
|
||
{
|
||
return '查询当前系统已安装的模块（插件）清单及启用状态。回答「XX 功能怎么配置」「XX 功能的菜单在哪」等问题前必须先调用本工具：功能所属模块未安装时，后台不存在对应菜单与配置项，禁止给出该模块的操作路径，应告知用户先到插件管理安装。';
|
||
}
|
||
|
||
/**
|
||
* 工具中文名（管理后台展示）
|
||
* @return string
|
||
*/
|
||
public function label(): string
|
||
{
|
||
return '模块清单查询';
|
||
}
|
||
|
||
/**
|
||
* 工具分类（管理后台分组展示）
|
||
* @return string
|
||
*/
|
||
public function category(): string
|
||
{
|
||
return '系统设置';
|
||
}
|
||
|
||
/**
|
||
* 入参 Schema
|
||
* @return array
|
||
*/
|
||
public function inputSchema(): array
|
||
{
|
||
return [
|
||
'type' => 'object',
|
||
'properties' => [
|
||
'keyword' => [
|
||
'type' => 'string',
|
||
'description' => '按模块名称或标识筛选（可选），如：分销、agent、优惠券',
|
||
],
|
||
],
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 执行工具
|
||
*
|
||
* @param array $args 参数（keyword 可选）
|
||
* @return array 已安装模块清单
|
||
*/
|
||
public function execute(array $args): array
|
||
{
|
||
$keyword = trim((string)($args['keyword'] ?? ''));
|
||
$query = Db::name('module_install_log')
|
||
->field('module_key,module_name,module_type,version,status,enabled');
|
||
if ($keyword !== '') {
|
||
$query->where(function ($query) use ($keyword) {
|
||
$query->whereLike('module_name', "%{$keyword}%")
|
||
->whereOr('module_key', 'like', "%{$keyword}%");
|
||
});
|
||
}
|
||
$list = $query->order('id', 'asc')->select()->toArray();
|
||
foreach ($list as &$module) {
|
||
$module['status_text'] = (int)$module['status'] === 1 ? '已安装' : '已卸载';
|
||
$module['enabled_text'] = (int)$module['enabled'] === 1 ? '启用中' : '已停用';
|
||
}
|
||
unset($module);
|
||
|
||
return [
|
||
'count' => count($list),
|
||
'list' => $list,
|
||
'notice' => '清单未列出的模块 = 当前未安装：其功能在后台不存在菜单与配置，回答时应告知用户先到「插件管理」安装，禁止编造该模块的操作路径',
|
||
];
|
||
}
|
||
}
|