feat(mcp): 增加 mode=skill,把 MCP 工具以技能形式暴露
mode 三态改为 advertise / skill / disable: - skill 不下发到 tools 数组,由 skill 工具的 list/get/run 暴露 - get 返回 MCP 原始的 description + input_schema;run 直接转发,不做路径改写与 required 预检 - 移除 mode: silent(不设专门迁移文案)与 front matter mcp_tool 包装 - 删除 skills/image、skills/video,改由 image_task / video_task 的 mode: skill 提供 - 技能清单改用 listCallableSkills(目录 + MCP,同名时目录胜出);设置页仍只列目录 - init.sh 配了 BIGMODEL_KEY 时给 image_task / video_task 写 mode: skill - image_task / video_task 的 tool description 首行改为自解释的一句话(技能清单取首行)
This commit is contained in:
@@ -122,7 +122,8 @@ const DEFAULTS = {
|
||||
// 登录认证:{users:[{user,password}], secret?, ttl_ms?};null / users 空 = 不启用。
|
||||
auth: null,
|
||||
// 外部 MCP 服务列表(无默认值):{name?, url, headers?, mode?(默认 advertise), timeout_ms?(默认 60s)}。
|
||||
// mode 三态:advertise=工具下发给模型;silent=只注册可调用(技能/lab)不下发;disable=不加载。
|
||||
// mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始
|
||||
// input_schema,run 直接转发);disable=不加载。
|
||||
mcp_servers: [],
|
||||
// 公网临时链接:base_url 非空才启用 mint_public_link;容器配 VIRTUAL_HOST 时以它为准。
|
||||
public_link: { base_url: '', ttl_ms: 1800000 },
|
||||
@@ -352,14 +353,14 @@ function parseAndValidate(rawText, configPath) {
|
||||
// 旧字段 enable 已废弃且不静默忽略:未知键会被无声丢弃,那样「以为关了」的服务会照常连上、
|
||||
// 照常烧额度。宁可启动即报错,把迁移动作逼到明面上。
|
||||
if (s.enable !== undefined) {
|
||||
throw new Error('mcp_servers 的 enable 已废弃,请改用 mode: advertise | silent | disable');
|
||||
throw new Error('mcp_servers 的 enable 已废弃,请改用 mode: advertise | skill | disable');
|
||||
}
|
||||
// 三态:advertise(默认,工具下发给模型)/ silent(注册但不下发,配合技能 mcp_tool 使用)/
|
||||
// 三态:advertise(默认,工具下发给模型)/ skill(不下发,改为以技能形式暴露)/
|
||||
// disable(不连接、不发现)。拼错要报错而不是回落默认,否则又是一次静默降级。
|
||||
const mode = String(s.mode == null ? '' : s.mode).trim().toLowerCase();
|
||||
if (!mode) s.mode = 'advertise';
|
||||
else if (mode === 'advertise' || mode === 'silent' || mode === 'disable') s.mode = mode;
|
||||
else throw new Error('mcp_servers 的 mode 只能是 advertise / silent / disable,收到:' + mode);
|
||||
else if (mode === 'advertise' || mode === 'skill' || mode === 'disable') s.mode = mode;
|
||||
else throw new Error('mcp_servers 的 mode 只能是 advertise / skill / disable,收到:' + mode);
|
||||
const headers = {};
|
||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = String(v);
|
||||
s.headers = headers;
|
||||
|
||||
+34
-15
@@ -3,7 +3,8 @@
|
||||
// 启动时 init() 对每个服务调 tools/list 发现工具(mode: disable 的服务跳过加载;配了 tools_allow/tools_deny
|
||||
// 时按名单过滤),发现失败的服务按 2s / 20s / 1min 再试 3 次(容器并行启动/重启后的乱序兜底),转成 OpenAI function 格式,
|
||||
// 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型;
|
||||
// mode: silent 的服务工具照常注册进 toolIndex(技能 mcp_tool / lab 可调),只是不追加进 toolDefs(模型看不到)。
|
||||
// mode: skill 的服务工具照常注册进 toolIndex(lab 可调),不追加进
|
||||
// toolDefs,而是由 tools/skills.js 自动包装成技能(get 返回注册表里的原始 input_schema)。
|
||||
// 工具调用经 tools/call 转发给对应服务。
|
||||
// 与内置工具严格分离:本模块不碰内置定义;MCP 工具默认沿用原始名,
|
||||
// 仅当与内置工具或其他 MCP 工具重名时加「服务名__」前缀。
|
||||
@@ -15,7 +16,7 @@ const log = require('./log');
|
||||
const CALL_TIMEOUT_MS = 60000;
|
||||
|
||||
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
||||
const toolIndex = new Map(); // 发送名 -> { server, tool }(服务配置 + 原始工具名)
|
||||
const toolIndex = new Map(); // 发送名 -> { server, tool, def }(服务配置 + 原始工具名 + 原始契约)
|
||||
let builtinNames = new Set();
|
||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
|
||||
|
||||
@@ -147,21 +148,20 @@ async function loadServer(s) {
|
||||
if (!t || !t.name) continue;
|
||||
let name = t.name;
|
||||
if (builtinNames.has(name) || toolIndex.has(name)) name = s.name + '__' + name;
|
||||
// 先进索引:silent 的工具要能被技能(mcp_tool)与 lab 调到,只是不下发。
|
||||
toolIndex.set(name, { server: s, tool: t.name });
|
||||
if (s.mode === 'silent') { hidden++; continue; }
|
||||
toolDefs.push({
|
||||
type: 'function',
|
||||
function: {
|
||||
name,
|
||||
description: t.description || t.title || '',
|
||||
parameters: t.inputSchema || t.input_schema || { type: 'object', properties: {} },
|
||||
},
|
||||
});
|
||||
// 先进索引:mode=skill 的工具同样要能被 lab 调到,只是不下发。
|
||||
// 索引里连规范化后的契约一起留住,技能 get 时原样返回(单一份真相,不会跟 MCP 实现漂移)。
|
||||
const def = {
|
||||
name,
|
||||
description: t.description || t.title || '',
|
||||
parameters: t.inputSchema || t.input_schema || { type: 'object', properties: {} },
|
||||
};
|
||||
toolIndex.set(name, { server: s, tool: t.name, def });
|
||||
if (s.mode === 'skill') { hidden++; continue; }
|
||||
toolDefs.push({ type: 'function', function: def });
|
||||
}
|
||||
let msg = s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : '');
|
||||
if (tools.length !== all.length) msg += '(服务端共 ' + all.length + ' 个,已按 tools_allow/tools_deny 过滤)';
|
||||
if (hidden) msg += '(mode=silent:' + hidden + ' 个不下发给模型,仅供技能调用)';
|
||||
if (hidden) msg += '(mode=skill:' + hidden + ' 个以技能形式暴露,不下发给模型)';
|
||||
log.info('mcp', msg);
|
||||
// 配了名单却一个都没过滤中,十有八九是名单里的名字跟 tools/list 返回不一致;
|
||||
// 不 warn 的话排查时只能对着「发现 0 个工具」干瞪眼。
|
||||
@@ -233,6 +233,25 @@ function toolDefinitions() { return toolDefs; }
|
||||
|
||||
function hasTool(name) { return toolIndex.has(name); }
|
||||
|
||||
// mode=skill 的工具:不进 tools 数组,由 skills.js 包装成技能(list/get/run)。
|
||||
// 名字一律用最终可调用名(含重名时的 server__ 前缀),否则模型拿到的是调不通的名字。
|
||||
function skillTools() {
|
||||
const out = [];
|
||||
for (const [name, e] of toolIndex) {
|
||||
if (!e || !e.server || e.server.mode !== 'skill' || !e.def) continue;
|
||||
out.push({ name, description: e.def.description, parameters: e.def.parameters, server: e.server.name, tool: e.tool });
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
// 只认 mode=skill:advertise 的工具已经直接下发给模型,不必再绕技能这一层。
|
||||
function getSkillTool(name) {
|
||||
const key = String(name == null ? '' : name).trim();
|
||||
const e = toolIndex.get(key);
|
||||
if (!e || !e.server || e.server.mode !== 'skill' || !e.def) return null;
|
||||
return { name: key, description: e.def.description, parameters: e.def.parameters, server: e.server.name, tool: e.tool };
|
||||
}
|
||||
|
||||
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
|
||||
// 超时取该服务的 timeout_ms(config.js 里归一化 + 夹过区间);这里再兜一次底,
|
||||
// 兼容没走配置加载的调用方(如测试里手搓的 cfg)。
|
||||
@@ -276,4 +295,4 @@ async function notifyTool(name, args, timeoutMs, extraHeaders) {
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { init, toolDefinitions, hasTool, callTool, notifyTool };
|
||||
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool };
|
||||
|
||||
@@ -339,7 +339,7 @@
|
||||
<label class="mpe-field">工具暴露
|
||||
<select id="mce-mode">
|
||||
<option value="advertise">advertise(下发给模型)</option>
|
||||
<option value="silent">silent(仅技能可调用)</option>
|
||||
<option value="skill">skill(以技能形式暴露)</option>
|
||||
<option value="disable">disable(不加载)</option>
|
||||
</select>
|
||||
</label>
|
||||
|
||||
@@ -1421,7 +1421,7 @@
|
||||
// · 新增 = append 到 mcp_servers;
|
||||
// · 删 = delete mcp_servers[pi];
|
||||
// · 改 = setIn mcp_servers[pi].(name|url|timeout_ms|mode);headers 是普通键值对象,整体 setIn 一次到位。
|
||||
// mode 三态:advertise(默认,工具下发给模型) / silent(只注册可调用,不下发) / disable(不加载):
|
||||
// mode 三态:advertise(默认,工具下发给模型) / skill(不下发,以技能形式暴露) / disable(不加载):
|
||||
// 默认值不写进文件——选 advertise 时删键,回落到 config.js 的缺省。
|
||||
// 运行配置(cg.effective.mcp_servers)即文件刚解析后的视图,按 pi 直接定位;重启后才会重新发现工具。
|
||||
let mcpEdit = null; // 工作态:{ idx, headers:[{key, value, masked}] };idx=-1 为新增
|
||||
@@ -1451,7 +1451,7 @@
|
||||
? '<div class="restart-bar"><span>配置已写入,重启后生效</span><button class="primary-btn" onclick="sUI.restartNow()">重启服务</button></div>'
|
||||
: '';
|
||||
box.innerHTML = banner + SET.cfgMcp.map(mcpCardHtml).join('') +
|
||||
'<div class="empty-tip">点卡片编辑 MCP 服务。advertise 的工具启动时发现并追加到内置工具之后;silent 只注册可调用(供技能 mcp_tool),不下发给模型。</div>';
|
||||
'<div class="empty-tip">点卡片编辑 MCP 服务。advertise 的工具启动时发现并追加到内置工具之后;skill 不下发,改为以技能形式暴露(skill 工具里 get 拿到原始 input_schema)。</div>';
|
||||
} catch (e) {
|
||||
const b = $('mcp-list');
|
||||
if (b && (!ctx || ctx())) b.innerHTML = '<div class="empty-tip">加载失败:' + esc(e.message) + '</div>';
|
||||
@@ -1462,8 +1462,8 @@
|
||||
const mode = s.mode || 'advertise';
|
||||
const stateHtml = mode === 'disable'
|
||||
? '<span class="model-card-state off">已禁用</span>'
|
||||
: mode === 'silent'
|
||||
? '<span class="model-card-state idle">仅技能可见</span>'
|
||||
: mode === 'skill'
|
||||
? '<span class="model-card-state idle">以技能暴露</span>'
|
||||
: '<span class="model-card-state idle">启用</span>';
|
||||
const entries = Object.entries(s.headers || {});
|
||||
// header 值等同密码对待:后端 effective 已脱敏为固定短掩码,这里透传展示;若收到未脱敏原文也一律替换,不外显
|
||||
|
||||
@@ -10,7 +10,7 @@ const multer = require('multer');
|
||||
const YAML = require('yaml');
|
||||
const engine = require('../engine');
|
||||
const llm = require('../llm');
|
||||
const { extractDescription, parseFrontMatter, listSkills, formatSkillListForPrompt } = require('../tools/skills');
|
||||
const { extractDescription, listCallableSkills, formatSkillListForPrompt } = require('../tools/skills');
|
||||
const { sanitizeName } = require('./files');
|
||||
|
||||
const router = express.Router();
|
||||
@@ -79,7 +79,7 @@ function absInSkill(dir, rel) {
|
||||
// 模型立即感知新技能或改名,无需重启。fire-and-forget:扫描失败不影响 API 响应,
|
||||
// skill {"list":"all"} 仍是实时兜底。
|
||||
function refreshSkillPrompt() {
|
||||
listSkills({ cfg: engine.getConfig() })
|
||||
listCallableSkills({ cfg: engine.getConfig() })
|
||||
.then(list => llm.setSkillListText(formatSkillListForPrompt(list)))
|
||||
.catch(() => {});
|
||||
}
|
||||
@@ -118,12 +118,9 @@ router.get('/', wrap(async (req, res) => {
|
||||
const dir = path.join(root, e.name);
|
||||
let description = '(缺 SKILL.md)';
|
||||
let hasMd = false;
|
||||
let mcpTool = '';
|
||||
try {
|
||||
const content = await fsp.readFile(path.join(dir, 'SKILL.md'), 'utf8');
|
||||
description = extractDescription(content);
|
||||
// mcp_tool 后端没有入口脚本,徽章靠它区分(前端显示「mcp 后端」)
|
||||
mcpTool = String(parseFrontMatter(content).mcp_tool || '').trim();
|
||||
hasMd = true;
|
||||
} catch (_) {}
|
||||
const files = listSkillFiles(dir);
|
||||
@@ -132,7 +129,7 @@ router.get('/', wrap(async (req, res) => {
|
||||
description,
|
||||
has_md: hasMd,
|
||||
entry: fs.existsSync(path.join(dir, 'run.py')) ? 'py'
|
||||
: fs.existsSync(path.join(dir, 'run.sh')) ? 'sh' : (mcpTool ? 'mcp' : null),
|
||||
: fs.existsSync(path.join(dir, 'run.sh')) ? 'sh' : null,
|
||||
file_count: files.length,
|
||||
size: files.reduce((s, f) => s + (f.size || 0), 0),
|
||||
mtime: files.length ? Math.max.apply(null, files.map(f => f.mtime || 0)) : null,
|
||||
@@ -160,7 +157,6 @@ router.post('/', wrap(async (req, res) => {
|
||||
'## 用法',
|
||||
'',
|
||||
'- 入口脚本 `run.py` 或 `run.sh`,接收一个 JSON 字符串作为唯一命令行参数(含全部入参)。',
|
||||
'- 后端是 MCP 工具时改在 front matter 写 `mcp_tool: <工具名>`,不需要入口脚本。',
|
||||
'- 可选:`requirements.txt`(Python 依赖)、`install.sh`(系统依赖),首次执行前自动安装。',
|
||||
'',
|
||||
].join('\n');
|
||||
|
||||
+2
-13
@@ -181,20 +181,9 @@ mcp.init(cfg).then(async () => {
|
||||
// 技能列表快照:模型直接感知已有技能,免先 {"list":"all"} 探索;
|
||||
// 此处失败不阻塞启动,{"list":"all"} 仍可做实时兜底。
|
||||
try {
|
||||
const list = await skills.listSkills({ cfg });
|
||||
const list = await skills.listCallableSkills({ cfg });
|
||||
llm.setSkillListText(skills.formatSkillListForPrompt(list));
|
||||
log.info('startup', ' skills=' + (list.length ? list.map(s => s.name).join(', ') : '(none)'));
|
||||
// mcp_tool 后端自检(mcp.init 已完成,注册表是本轮发现的最终状态):
|
||||
// 启动期点名,避免模型第一次调用才撞墙;两条路并存时也告一声,方便渐进迁移。
|
||||
const advertised = new Set(mcp.toolDefinitions().map(t => t && t.function && t.function.name));
|
||||
for (const s of list) {
|
||||
if (!s.mcp_tool) continue;
|
||||
if (!mcp.hasTool(s.mcp_tool)) {
|
||||
log.warn('startup', '技能 ' + s.name + ' 的 MCP 后端不可用:' + s.mcp_tool + '(检查 mcp_servers 与 mode)');
|
||||
} else if (advertised.has(s.mcp_tool)) {
|
||||
log.info('startup', '技能 ' + s.name + ' 的 MCP 后端 ' + s.mcp_tool + ' 同时下发给模型(两条路并存)');
|
||||
}
|
||||
}
|
||||
} catch (e) {
|
||||
log.warn('startup', '技能列表生成失败:' + e.message);
|
||||
}
|
||||
@@ -205,7 +194,7 @@ mcp.init(cfg).then(async () => {
|
||||
log.info('startup', ' data_root=' + cfg.data_root);
|
||||
log.info('startup', ' models=' + cfg.models.map(m => m.id + '@' + m.url).join(', '));
|
||||
const mcpList = (cfg.mcp_servers || []).map(s => s.name + '@' + s.url +
|
||||
(s.mode === 'disable' ? '(禁用)' : s.mode === 'silent' ? '(仅技能)' : '')).join(', ');
|
||||
(s.mode === 'disable' ? '(禁用)' : s.mode === 'skill' ? '(技能)' : '')).join(', ');
|
||||
log.info('startup', ' mcp_servers=' + (mcpList || '(none)'));
|
||||
log.info('startup', ' auth=' + (auth.enabled ? 'login: ' + cfg.auth.users.map(u => u.user).join(', ') : '(disabled)'));
|
||||
log.info('startup', ' wxbot=' + (cfg.wxbot.url && cfg.wxbot.token ? cfg.wxbot.url : '(未启用)'));
|
||||
|
||||
@@ -1504,6 +1504,8 @@ function toolDb(ctx, args) {
|
||||
// list 的值是范围而非布尔:将来技能分类落地时直接扩成 {list:"<分类>"},调用形状不变,
|
||||
// 模型不用学第二套写法。今天只认 "all" 且报错点名——静默返回全部会让错拼的分类名
|
||||
// 看起来「能用」,将来接分类时更难排查。
|
||||
// {list:"all"} 的清单 = 目录技能 + mode=skill 的 MCP 工具;get/run 对两者一视同仁:
|
||||
// 目录技能读 SKILL.md,MCP 技能直接回注册表里的原始 input_schema。
|
||||
// args 仅 run 用且可缺省:runSkill 把 null 视作 {},真正缺哪些字段由各技能 input_schema
|
||||
// 校验点名报错(工具层再 gate 一层是双重门槛,无益)。
|
||||
// 旧形状 {op, name, input_args} 仍接受:存量技能文档的调用示例里写的是它,模型 get 到
|
||||
@@ -1554,7 +1556,7 @@ async function legacyToolSkill(ctx, a) {
|
||||
const name = String(a.name == null ? '' : a.name).trim();
|
||||
switch (op) {
|
||||
case 'list':
|
||||
return JSON.stringify(await skills.listSkills(ctx), null, 2);
|
||||
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||
case 'get':
|
||||
if (!name) throw new Error('op=get 缺少技能名。' + SKILL_USAGE);
|
||||
return skills.getSkillInfo(ctx, name);
|
||||
@@ -1582,7 +1584,7 @@ async function toolSkill(ctx, args) {
|
||||
const scope = String(a.list).trim().toLowerCase();
|
||||
if (scope !== 'all') throw new Error('list 目前只支持 "all"(技能分类尚未提供),收到:"' + scope + '"');
|
||||
rejectSkillArgs(a, 'list');
|
||||
return JSON.stringify(await skills.listSkills(ctx), null, 2);
|
||||
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||
}
|
||||
const name = skillNameArg(a[verb], verb);
|
||||
if (verb === 'get') {
|
||||
|
||||
+53
-37
@@ -4,8 +4,9 @@
|
||||
// 技能统一存放于技能根目录(cfg.skills_root,所有任务/会话共享;容器内挂 ./skills → /workspace/skills),每个技能一个子目录:
|
||||
// <skill>/SKILL.md(必须)、run.py | run.sh(入口)、requirements.txt、install.sh(可选)。
|
||||
// 入口脚本约定接收一个 JSON 字符串作为唯一命令行参数(含全部 args)。
|
||||
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(front matter 声明 mcp_tool,
|
||||
// run 由 core 直接调 mcp.callTool,不经沙箱——凭证留在 core,模型只看到一行技能描述)。
|
||||
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(core 直接 mcp.callTool 转发,
|
||||
// 不经沙箱——凭证留在 core)。MCP 技能不落目录:服务配成 mode=skill 时由平台自动暴露,
|
||||
// 参数契约直接取注册表里的原始 input_schema。
|
||||
const fs = require('fs');
|
||||
const fsp = require('fs').promises;
|
||||
const path = require('path');
|
||||
@@ -13,7 +14,7 @@ const { spawn } = require('child_process');
|
||||
const YAML = require('yaml');
|
||||
const log = require('../log');
|
||||
const rexec = require('../remote-exec');
|
||||
// 技能可声明 mcp_tool(front matter),run 时由 core 直接转发给 MCP;mcp.js 只依赖 ./log,不成环。
|
||||
// mode=skill 的 MCP 工具在 get/run 时由 core 直接转发;mcp.js 只依赖 ./log,不成环。
|
||||
const mcp = require('../mcp');
|
||||
|
||||
class SkillNotFoundError extends Error {
|
||||
@@ -68,22 +69,44 @@ async function listSkills(ctx) {
|
||||
let content;
|
||||
try { content = await fsp.readFile(mdPath, 'utf8'); } catch (_) { continue; }
|
||||
// frontmatter 可选 required: true —— 进 system prompt 时行首标 **required**(配合模板里的强制条款)
|
||||
// 可选 mcp_tool: <MCP 工具名> —— 声明后端为 MCP 服务(run 不落沙箱),仅在声明时带该键
|
||||
let required = false, mcpTool = '';
|
||||
let required = false;
|
||||
try {
|
||||
const fm = parseFrontMatter(content);
|
||||
required = fm.required === true;
|
||||
mcpTool = String(fm.mcp_tool || '').trim();
|
||||
required = parseFrontMatter(content).required === true;
|
||||
} catch (_) {}
|
||||
const item = { name: e.name, description: extractDescription(content), required: required };
|
||||
if (mcpTool) item.mcp_tool = mcpTool;
|
||||
out.push(item);
|
||||
out.push({ name: e.name, description: extractDescription(content), required: required });
|
||||
}
|
||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||
return out;
|
||||
}
|
||||
|
||||
// ---------- MCP 技能(mode=skill)----------
|
||||
// mode=skill 的服务:工具不进 tools 数组,而是自动成为技能。既省掉每轮的 schema 开销,
|
||||
// 又不用在 skills_root 里建目录、手抄一份参数说明——get 直接返回注册表里的原始 input_schema。
|
||||
// 目录技能优先:同名时目录技能胜出并打 warn。手写包装可以遮住自动版,迁移期也不会撞车。
|
||||
|
||||
// MCP 的 description 常是多段文本;清单里只取第一行,完整内容留给 get。
|
||||
function firstLine(s) {
|
||||
const line = String(s == null ? '' : s).split(/\r?\n/).map(l => l.trim()).find(Boolean);
|
||||
return line || '(无描述)';
|
||||
}
|
||||
|
||||
// 模型可见的技能全集 = 目录技能 + mode=skill 的 MCP 工具。
|
||||
// 设置页的技能 API 只用 listSkills(它按目录增删改),不要混用这个函数。
|
||||
async function listCallableSkills(ctx) {
|
||||
const dir = await listSkills(ctx);
|
||||
const taken = new Set(dir.map(s => s.name));
|
||||
const out = dir.slice();
|
||||
for (const t of mcp.skillTools()) {
|
||||
if (taken.has(t.name)) {
|
||||
log.warn('skills', 'MCP 工具 ' + t.name + ' 与目录技能同名,按目录技能处理(mode=skill 的这份被遮蔽)');
|
||||
continue;
|
||||
}
|
||||
out.push({ name: t.name, description: firstLine(t.description), required: false });
|
||||
}
|
||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||
return out;
|
||||
}
|
||||
|
||||
// ---------- system prompt 注入:可用技能列表 ----------
|
||||
// 把技能列表格式化成 “## Available Skills” 段落(每行 `- [**required** ]名字: 描述`;
|
||||
// listSkills 已按名字 localeCompare 排序,行序恒定,不破坏前缀缓存;
|
||||
// 参数查 get,执行 run;描述如需实时复核仍可查 list)。
|
||||
@@ -104,10 +127,12 @@ function formatSkillListForPrompt(list) {
|
||||
async function getSkillInfo(ctx, skillName) {
|
||||
const dir = skillDir(ctx, skillName);
|
||||
const mdPath = path.join(dir, 'SKILL.md');
|
||||
if (!fs.existsSync(mdPath)) {
|
||||
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
||||
}
|
||||
return fsp.readFile(mdPath, 'utf8');
|
||||
if (fs.existsSync(mdPath)) return fsp.readFile(mdPath, 'utf8');
|
||||
// mode=skill 的 MCP 技能没有目录:直接返回注册表里的原始契约(description + input_schema),
|
||||
// 模型看到的就是服务端实际声明的参数,不存在手抄副本漂移的问题。
|
||||
const t = mcp.getSkillTool(skillName);
|
||||
if (t) return JSON.stringify({ name: t.name, description: t.description, input_schema: t.parameters }, null, 2);
|
||||
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
||||
}
|
||||
|
||||
// ---------- 参数路径预处理 ----------
|
||||
@@ -217,7 +242,16 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
throw new SkillExecutionError('技能参数必须是对象(键值参数),收到:' + JSON.stringify(inputArgs).slice(0, 80), 1);
|
||||
}
|
||||
const dir = skillDir(ctx, skillName);
|
||||
if (!fs.existsSync(dir)) throw new SkillNotFoundError('技能不存在:' + skillName);
|
||||
if (!fs.existsSync(dir)) {
|
||||
// mode=skill 的 MCP 技能:直接转发。同样不做 absolutizeArgs——URL 与含 '/' 的 prompt
|
||||
// 会被当成路径改写坏;也不做 validateArgs,参数与 MCP 工具自己的 op 相关。
|
||||
const t = mcp.getSkillTool(skillName);
|
||||
if (t) {
|
||||
log.info('skills', '执行 MCP 技能 ' + t.name + ' → ' + t.server + '/' + t.tool);
|
||||
return mcp.callTool(t.name, inputArgs || {}, ctx);
|
||||
}
|
||||
throw new SkillNotFoundError('技能不存在:' + skillName);
|
||||
}
|
||||
|
||||
const mdPath = path.join(dir, 'SKILL.md');
|
||||
if (!fs.existsSync(mdPath)) throw new SkillNotFoundError('技能缺少 SKILL.md:' + skillName);
|
||||
@@ -225,24 +259,6 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
let fm = {};
|
||||
try { fm = parseFrontMatter(await fsp.readFile(mdPath, 'utf8')); } catch (_) {}
|
||||
|
||||
// MCP 后端技能(front matter 声明 mcp_tool):run 不落沙箱,由 core 直接转发给 MCP 服务。
|
||||
// core 用 cfg.mcp_servers[].headers 里的凭证调服务,技能进程根本不参与——这是唯一
|
||||
// 既能让模型只看到一行技能描述、又能让 key 不出 core 的路径(executor 的 env 白名单
|
||||
// 会按名字丢掉 *KEY/*TOKEN,沙箱里既拿不到也不该拿到)。
|
||||
// 必须在 absolutizeArgs 之前分流:它把「像路径」的参数改写成会话目录下的绝对路径,
|
||||
// 而 URL(含 '/')与含斜杠的 prompt 都会中招。
|
||||
// 不跑 validateArgs:MCP 工具的参数是 op 相关的(如 op=create 才要 prompt),
|
||||
// 静态 required 列表会误伤 op=get。
|
||||
if (fm.mcp_tool) {
|
||||
const tool = String(fm.mcp_tool).trim();
|
||||
if (!mcp.hasTool(tool)) {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 的 MCP 后端不可用:' + tool +
|
||||
'(检查 mcp_servers 是否含该服务,且 mode 不为 disable)', 1);
|
||||
}
|
||||
log.info('skills', '执行 ' + skillName + ':mcp_tool=' + tool);
|
||||
return mcp.callTool(tool, inputArgs || {}, ctx);
|
||||
}
|
||||
|
||||
// 以下是脚本后端(run.py / run.sh):先把相对路径参数按会话任务目录转成绝对路径(缺任务目录时退回进程当前目录)。
|
||||
const args = absolutizeArgs(inputArgs || {}, ctx.taskDir || process.cwd());
|
||||
const payload = JSON.stringify(args);
|
||||
@@ -261,7 +277,7 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
entry = 'bash';
|
||||
cmdArgs = [runSh, payload];
|
||||
} else {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh(也未声明 mcp_tool)', 1);
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh', 1);
|
||||
}
|
||||
|
||||
// cwd:远端取会话目录(executor 侧命中 session 隔离,技能看到的 /workspace/tasks/<sid>
|
||||
@@ -273,4 +289,4 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
return runEntry(ctx, entry, cmdArgs, execCwd, timeoutMs);
|
||||
}
|
||||
|
||||
module.exports = { listSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
||||
module.exports = { listSkills, listCallableSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
||||
|
||||
Reference in New Issue
Block a user