feat(skills): 技能支持 MCP 后端(front matter mcp_tool)
SKILL.md 声明 mcp_tool 时,op=run 不落 executor 沙箱,由 core 直接 mcp.callTool 转发:凭证留在 core(沙箱的 env 白名单本就会丢掉 *KEY/*TOKEN),模型只看到技能清单 里的一行描述。配合 mcp_servers[].mode: silent,工具不再进每轮请求的 tools 数组。 - skills.js: runSkill 在 absolutizeArgs 之前分流(否则 URL / 含斜杠的 prompt 会被 当路径改写);不做 input_schema.required 预检(参数与 op 相关,交给 MCP 服务) - listSkills 带出 mcp_tool;设置页技能卡显示 mcp 后端徽章 - server.js: 启动期自检,缺失后端 warn、两条路并存 info - 新增 skills/image、skills/video 两个纯文档技能(无 run.py) - skills/README、README、app/AGENTS 同步
This commit is contained in:
@@ -173,6 +173,9 @@ POST /api/sessions/:id/messages
|
||||
- 技能(`tools/skills.js`):`SKILL.md` front matter 提供 `description`/`input_schema`;
|
||||
`input_schema.required` 在 `run` 前校验;相对路径参数按会话目录转绝对路径;入口一律用绝对路径
|
||||
(远端 cwd 是会话目录)。配了 executor 就走 `remote-exec`,否则本地 `spawn`。
|
||||
声明了 `mcp_tool` 的技能走另一条后端:`runSkill` 在 `absolutizeArgs` **之前**分流,由 core
|
||||
直接 `mcp.callTool` 转发(不落沙箱,所以也不需要任何密钥);否则 URL 与含 `/` 的 prompt 会被
|
||||
当路径改写。此时不跑 `input_schema.required` 校验(参数是 op 相关的,交给 MCP 服务管)。
|
||||
- MCP(`mcp.js`):启动时 `initialize` → `notifications/initialized` → `tools/list`;与内置或已有
|
||||
MCP 工具重名时加 `<服务名>__` 前缀;请求随带 `X-Session-Dir`、`X-Public-Base`;
|
||||
`content` 里的 `ui_card` 块不进模型上下文,转成 SSE `ui_card` 事件。
|
||||
|
||||
@@ -840,7 +840,7 @@
|
||||
'<div class="session-main">' +
|
||||
'<div class="session-name">' + esc(s.name) +
|
||||
(s.has_md ? '' : ' <span class="badge cancelled">缺 SKILL.md</span>') +
|
||||
(s.entry ? ' <span class="badge active">' + s.entry + ' 入口</span>' : '') +
|
||||
(s.entry ? ' <span class="badge active">' + (s.entry === 'mcp' ? 'mcp 后端' : s.entry + ' 入口') + '</span>' : '') +
|
||||
'</div>' +
|
||||
'<div class="skill-desc">' + esc(s.description || '') + '</div>' +
|
||||
'<div class="session-meta"><span>' + s.file_count + ' 个文件</span>' +
|
||||
|
||||
@@ -10,7 +10,7 @@ const multer = require('multer');
|
||||
const YAML = require('yaml');
|
||||
const engine = require('../engine');
|
||||
const llm = require('../llm');
|
||||
const { extractDescription, listSkills, formatSkillListForPrompt } = require('../tools/skills');
|
||||
const { extractDescription, parseFrontMatter, listSkills, formatSkillListForPrompt } = require('../tools/skills');
|
||||
const { sanitizeName } = require('./files');
|
||||
|
||||
const router = express.Router();
|
||||
@@ -118,8 +118,12 @@ router.get('/', wrap(async (req, res) => {
|
||||
const dir = path.join(root, e.name);
|
||||
let description = '(缺 SKILL.md)';
|
||||
let hasMd = false;
|
||||
let mcpTool = '';
|
||||
try {
|
||||
description = extractDescription(await fsp.readFile(path.join(dir, 'SKILL.md'), 'utf8'));
|
||||
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);
|
||||
@@ -128,7 +132,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' : null,
|
||||
: fs.existsSync(path.join(dir, 'run.sh')) ? 'sh' : (mcpTool ? 'mcp' : 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,
|
||||
@@ -156,6 +160,7 @@ router.post('/', wrap(async (req, res) => {
|
||||
'## 用法',
|
||||
'',
|
||||
'- 入口脚本 `run.py` 或 `run.sh`,接收一个 JSON 字符串作为唯一命令行参数(含全部入参)。',
|
||||
'- 后端是 MCP 工具时改在 front matter 写 `mcp_tool: <工具名>`,不需要入口脚本。',
|
||||
'- 可选:`requirements.txt`(Python 依赖)、`install.sh`(系统依赖),首次执行前自动安装。',
|
||||
'',
|
||||
].join('\n');
|
||||
|
||||
@@ -184,6 +184,17 @@ mcp.init(cfg).then(async () => {
|
||||
const list = await skills.listSkills({ 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);
|
||||
}
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
// 技能统一存放于技能根目录(cfg.skills_root,所有任务/会话共享;容器内挂 ./skills → /workspace/skills),每个技能一个子目录:
|
||||
// <skill>/SKILL.md(必须)、run.py | run.sh(入口)、requirements.txt、install.sh(可选)。
|
||||
// 入口脚本约定接收一个 JSON 字符串作为唯一命令行参数(含全部 input_args)。
|
||||
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(front matter 声明 mcp_tool,
|
||||
// run 由 core 直接调 mcp.callTool,不经沙箱——凭证留在 core,模型只看到一行技能描述)。
|
||||
const fs = require('fs');
|
||||
const fsp = require('fs').promises;
|
||||
const path = require('path');
|
||||
@@ -11,6 +13,8 @@ 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,不成环。
|
||||
const mcp = require('../mcp');
|
||||
|
||||
class SkillNotFoundError extends Error {
|
||||
constructor(msg) { super(msg); this.name = 'SkillNotFoundError'; }
|
||||
@@ -64,9 +68,16 @@ async function listSkills(ctx) {
|
||||
let content;
|
||||
try { content = await fsp.readFile(mdPath, 'utf8'); } catch (_) { continue; }
|
||||
// frontmatter 可选 required: true —— 进 system prompt 时行首标 **required**(配合模板里的强制条款)
|
||||
let required = false;
|
||||
try { required = parseFrontMatter(content).required === true; } catch (_) {}
|
||||
out.push({ name: e.name, description: extractDescription(content), required: required });
|
||||
// 可选 mcp_tool: <MCP 工具名> —— 声明后端为 MCP 服务(run 不落沙箱),仅在声明时带该键
|
||||
let required = false, mcpTool = '';
|
||||
try {
|
||||
const fm = parseFrontMatter(content);
|
||||
required = fm.required === true;
|
||||
mcpTool = String(fm.mcp_tool || '').trim();
|
||||
} catch (_) {}
|
||||
const item = { name: e.name, description: extractDescription(content), required: required };
|
||||
if (mcpTool) item.mcp_tool = mcpTool;
|
||||
out.push(item);
|
||||
}
|
||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||
return out;
|
||||
@@ -211,12 +222,31 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
const mdPath = path.join(dir, 'SKILL.md');
|
||||
if (!fs.existsSync(mdPath)) throw new SkillNotFoundError('技能缺少 SKILL.md:' + skillName);
|
||||
|
||||
// 先把相对路径参数按会话任务目录转成绝对路径(缺任务目录时退回进程当前目录)。
|
||||
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);
|
||||
|
||||
let fm = {};
|
||||
try { fm = parseFrontMatter(await fsp.readFile(mdPath, 'utf8')); } catch (_) {}
|
||||
validateArgs(fm, args, skillName);
|
||||
|
||||
let entry, cmdArgs;
|
||||
@@ -231,7 +261,7 @@ async function runSkill(ctx, skillName, inputArgs) {
|
||||
entry = 'bash';
|
||||
cmdArgs = [runSh, payload];
|
||||
} else {
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh', 1);
|
||||
throw new SkillExecutionError('技能 ' + skillName + ' 缺少入口 run.py 或 run.sh(也未声明 mcp_tool)', 1);
|
||||
}
|
||||
|
||||
// cwd:远端取会话目录(executor 侧命中 session 隔离,技能看到的 /workspace/tasks/<sid>
|
||||
|
||||
Reference in New Issue
Block a user