加入officecli相关支持

This commit is contained in:
2026-10-18 15:40:44 +08:00
parent fd617b0b8d
commit d5e1ff374f
6 changed files with 124 additions and 7 deletions
+2
View File
@@ -1089,6 +1089,8 @@ function deleteSession(sessionId, deleteDir) {
const session = getSession(sessionId);
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
stop(sessionId);
// 尽力清理该会话在 officecli 桥里的预览槽位(没配 officecli 则静默;失败只记日志,不阻断删除)
mcp.notifyTool('officecli', { command: 'unwatch --session ' + String(sessionId).replace(/[^0-9A-Za-z_-]/g, '') }, 5000, { 'X-Session-Dir': taskDirOf(sessionId) });
db.prepare('DELETE FROM messages WHERE session_id = ?').run(sessionId);
db.prepare('DELETE FROM files WHERE session_id = ?').run(sessionId);
db.prepare('DELETE FROM sessions WHERE id = ?').run(sessionId);
+32 -5
View File
@@ -16,12 +16,13 @@ const CALL_TIMEOUT_MS = 60000;
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
const toolIndex = new Map(); // 发送名 -> { server, tool }(服务配置 + 原始工具名)
let builtinNames = new Set();
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
// 之后所有非 initialize 请求都必须带上该 header,否则返回 400。我们把会话 id 缓存在 server.sessionId 里。
// session 过期补偿:非 initialize 请求若 400 且错误信息含 session,清掉旧 id 并重新 initialize 后重试一次。
async function rpc(server, method, params, timeoutMs) {
async function rpc(server, method, params, timeoutMs, extraHeaders) {
const callId = Date.now();
const ms = timeoutMs || 30000;
const ctrl = new AbortController();
@@ -34,6 +35,15 @@ async function rpc(server, method, params, timeoutMs) {
'Content-Type': 'application/json',
'Accept': 'application/json, text/event-stream',
}, server.headers || {});
// 会话上下文随请求下发(如 officecli 预览需要知道会话工作目录拼链接);HTTP 头必须 ASCII,含非标字符则丢弃
if (extraHeaders) {
for (const [k, v] of Object.entries(extraHeaders)) {
if (typeof v === 'string' && /^[\x20-\x7e]+$/.test(v)) headers[k] = v;
}
}
// 公网前缀单一真相随请求下发:给“要返回给人点的链接”的服务拼绝对 url(如 officecli 预览槽位),
// 免得每个 MCP 服务各自配 env 记一遍 core 地址。
if (PUBLIC_BASE) headers['X-Public-Base'] = PUBLIC_BASE;
// initialize 请求自身不需要带 session id;其他请求如果该服务提供了 session id 则必须带
if (method !== 'initialize' && server.sessionId) headers['Mcp-Session-Id'] = server.sessionId;
const res = await fetch(server.url, {
@@ -67,7 +77,7 @@ async function rpc(server, method, params, timeoutMs) {
if (!/Method not found/i.test(String(e && e.message || e))) throw e;
}
// 重试原请求(新一次 fetch + 新 AbortController)
return await rpc(server, method, params, ms);
return await rpc(server, method, params, ms, extraHeaders);
}
throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300));
}
@@ -103,6 +113,7 @@ async function rpc(server, method, params, timeoutMs) {
async function init(cfg) {
toolDefs = [];
toolIndex.clear();
PUBLIC_BASE = (cfg && cfg.public_link && cfg.public_link.base_url) || '';
try {
for (const d of require('./tools/definitions.json')) {
if (d.function && d.function.name) builtinNames.add(d.function.name);
@@ -178,13 +189,15 @@ function hasTool(name) { return toolIndex.has(name); }
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
// 超时取该服务的 timeout_ms(config.js 里归一化 + 夹过区间);这里再兜一次底,
// 兼容没走配置加载的调用方(如测试里手搓的 cfg)。
async function callTool(name, args) {
async function callTool(name, args, ctx) {
const entry = toolIndex.get(name);
if (!entry) return 'Error: 未知 MCP 工具 ' + name;
let result;
try {
result = await rpc(entry.server, 'tools/call', { name: entry.tool, arguments: args || {} },
Number(entry.server.timeout_ms) || CALL_TIMEOUT_MS);
Number(entry.server.timeout_ms) || CALL_TIMEOUT_MS,
// 会话工作目录随请求下发(officecli 预览把裸文件名/相对路径补全会话目录;其它服务忽略此头)
ctx && ctx.taskDir ? { 'X-Session-Dir': String(ctx.taskDir) } : null);
} catch (err) {
return 'MCP ' + entry.server.name + '/' + entry.tool + ' 调用失败: ' + (err && err.message || err);
}
@@ -196,4 +209,18 @@ async function callTool(name, args) {
return JSON.stringify(result).slice(0, 20000);
}
module.exports = { init, toolDefinitions, hasTool, callTool };
// 会话生命周期等后台场景的尽力通知:向声明了该工具的 MCP 服务发一次 tools/call。
// 工具没注册/服务异常都只留日志,绝不把异常或延迟带给调用方。
async function notifyTool(name, args, timeoutMs, extraHeaders) {
const entry = toolIndex.get(name);
if (!entry) return false;
try {
await rpc(entry.server, 'tools/call', { name: entry.tool, arguments: args || {} }, Number(timeoutMs) || 5000, extraHeaders);
return true;
} catch (e) {
log.info('mcp', 'notifyTool ' + name + ' 失败(尽力而为): ' + (e && e.message || e));
return false;
}
}
module.exports = { init, toolDefinitions, hasTool, callTool, notifyTool };
+84
View File
@@ -0,0 +1,84 @@
// 通用任务预览反代(注册表驱动;officecli 只是第一个条目):
// <prefix>/** → 服务的单一预览入口端口。槽位/路径解析托管给服务端自己(路由表在它手里),
// core 只做三件事:鉴权(挂 auth.middleware 之后,信任模型与 data-page 一致 = 登录 ≈ 运维)、
// 头白名单转发(JSON 体因全局 express.json 已消耗,重序列化重放)。
// 另兜一类底:vendor 化预览页会把交互 API 硬编码成根绝对路径(fetch('/api/selection')、
// EventSource('/events')…),这些请求打到 core 根 —— Referer 指向注册预览页时,把【原路径】
// 原样转给对应服务;Referer 不命中的请求,404 行为一切照旧。
// 挂载:server.js 末尾(所有业务路由之后)调 mount(app),兜底路由不吃任何现有路径。
// 注册表:env PREVIEW_PROXIES(JSON 数组)整体覆盖;缺省 = 内置 officecli 一条。
'use strict';
const http = require('http');
const { Router } = require('express');
const log = require('../log');
let services;
try {
services = process.env.PREVIEW_PROXIES ? JSON.parse(process.env.PREVIEW_PROXIES) : [{
name: 'officecli', prefix: '/preview',
host: process.env.OFFICE_MCP_HOST || 'mcp_officecli',
port: Number(process.env.OFFICE_PREVIEW_PORT || 3100),
}];
} catch (e) {
log.error('preview', 'PREVIEW_PROXIES \u89e3\u6790\u5931\u8d25\uff0c\u56de\u9000\u9ed8\u8ba4\u6ce8\u518c\u8868: ' + (e && e.message));
services = [{
name: 'officecli', prefix: '/preview',
host: process.env.OFFICE_MCP_HOST || 'mcp_officecli',
port: Number(process.env.OFFICE_PREVIEW_PORT || 3100),
}];
}
// \u5934\u767d\u540d\u5355\uff1a\u51ed\u636e\u4e0e\u516c\u7f51\u8eab\u4efd\uff08cookie/authorization/sec-fetch-*/connection\uff09\u4e00\u5f8b\u4e0d\u51fa\u5bb9\u5668\uff1b
// referer/origin \u5fc5\u987b\u900f\u4f20\uff1a\u670d\u52a1\u7aef\u7f51\u5173\u9760 Referer \u5b9a\u69fd\u4f4d\uff0c\u4e0a\u6e38\u9632\u62a4\u9760 Origin \u5224\u540c\u6e90\u3002
const PASS_HEADERS = new Set(['accept', 'accept-encoding', 'cache-control', 'pragma', 'content-type', 'content-length', 'last-event-id', 'if-modified-since', 'if-none-match', 'referer', 'origin', 'user-agent']);
function forward(svc, req, res, outPath) {
const fwd = { host: svc.host + ':' + svc.port };
for (const k of Object.keys(req.headers)) if (PASS_HEADERS.has(k)) fwd[k] = req.headers[k];
// \u5168\u5c40 express.json \u5728\u672c\u8def\u7531\u4e4b\u524d\u5df2\u628a JSON \u8bf7\u6c42\u4f53\u8bfb\u5e72\uff08req \u6d41\u4e0d\u53ef\u91cd\u653e\uff09\uff1a\u91cd\u65b0\u5e8f\u5217\u5316\u8f6c\u53d1\u3002
let payload = null;
if ((req.method === 'POST' || req.method === 'PUT' || req.method === 'PATCH') && req.readableEnded && req.body !== undefined) {
payload = Buffer.from(JSON.stringify(req.body));
fwd['content-length'] = String(payload.length);
}
const upstream = http.request({ host: svc.host, port: svc.port, path: outPath, method: req.method, headers: fwd }, (up) => {
const h = Object.assign({}, up.headers);
if (String(h['content-type'] || '').includes('text/event-stream')) { h['cache-control'] = 'no-cache'; h['x-accel-buffering'] = 'no'; }
res.writeHead(up.statusCode, h);
up.pipe(res);
});
upstream.on('error', () => {
if (!res.headersSent) res.status(502).end('\u9884\u89c8\u670d\u52a1\u4e0d\u53ef\u8fbe: ' + svc.name);
else res.destroy();
});
if (payload) upstream.end(payload); else req.pipe(upstream);
}
function serviceByReferer(req) {
const ref = req.headers.referer || req.headers.referrer || '';
if (!ref) return null;
let pathname;
try { pathname = decodeURIComponent(new URL(ref).pathname); } catch (_) { return null; }
for (const svc of services) if (pathname === svc.prefix || pathname.startsWith(svc.prefix + '/')) return svc;
return null;
}
function mount(app) {
for (const svc of services) {
if (svc.ownership) log.warn('preview', svc.name + ': ownership \u5b57\u6bb5\u672a\u63a5\u7ebf\uff08\u5f53\u524d\u4fe1\u4efb\u6a21\u578b = \u767b\u5f55\u2248\u8fd0\u7ef4\uff0c\u4e0e data-page \u4e00\u81f4\uff09');
const r = Router();
r.all('*', (req, res) => forward(svc, req, res, svc.prefix + req.url));
app.use(svc.prefix, r);
log.info('preview', svc.name + ' \u2192 ' + svc.host + ':' + svc.port + ' \u2190 ' + svc.prefix + '/**');
}
// \u6839\u5bf9\u5bf9\u8def\u5f84\u515c\u5e95\uff1a\u53ea\u63a5\u6765\u81ea\u9884\u89c8\u9875\uff08Referer \u547d\u4e2d\u6ce8\u518c\u524d\u7f00\uff09\u7684\u8bf7\u6c42\uff0c\u5176\u4f59\u8d70\u6b63\u5e38 404
const fb = Router();
fb.all('*', (req, res, next) => {
const svc = serviceByReferer(req);
if (!svc) return next();
forward(svc, req, res, req.url);
});
app.use(fb);
}
module.exports = { mount };
+2
View File
@@ -78,6 +78,8 @@ app.use('/api/channel', require('./routes/channel'));
// data-page 技能配套:任务 app/ 子树页面向导 /app/{task_id}/ + 数据 API /api/db/{task_id}/query。
// 随其余业务路由一样挂在 auth.middleware 之后(登录态才能访问)。
app.use(require('./routes/data-page'));
// 通用预览反代(注册表驱动,路由+Referer 兜底一体;挂最末尾,兜底不吃任何现有路径)
require('./routes/preview-proxy').mount(app);
// 模型池状态(前端展示在用会话数/在用会话列表,key 非独占)+ 每模型 token 用量(今日/累计,输入/输出分开)。
// 从生效配置补齐平台维度字段(platform/mid/vision/type + 平台 key 数 key_count):
+1 -1
View File
@@ -1613,7 +1613,7 @@ const HANDLERS = {
async function executeTool(baseCtx, name, args) {
const handler = HANDLERS[name];
if (handler) return handler(baseCtx, args || {});
if (mcp.hasTool(name)) return mcp.callTool(name, args || {});
if (mcp.hasTool(name)) return mcp.callTool(name, args || {}, baseCtx); // baseCtx.taskDir → X-Session-Dir 头下发给 MCP 服务
return 'Error: 未知工具 ' + name;
}
+3 -1
View File
@@ -58,6 +58,7 @@ agent/
│ │ │ ├── platforms.js /api/platforms/balance 余额查询
│ │ │ ├── skills.js /api/skills 技能文件管理
│ │ │ ├── public-files.js GET /p/<id> 公网临时文件取用(匿名)
│ │ │ ├── preview-proxy.js 通用预览反代(注册表驱动:/preview/** → 服务单入口,Referer 兜底;挂 server.js 最末)
│ │ │ └── system.js /api/system/status + /restart 优雅重启
│ │ ├── templates/
│ │ │ ├── profile-default.txt system prompt 静态模板(每次请求复用,利于上游前缀缓存)
@@ -154,7 +155,7 @@ graph LR
5. `engine.setModelPool(cfg, db, bus); engine.init()`:按 cfg.models 重建 `model_pool` 槽位表;会话状态归位(active/遗留 queued → held,绑定不清);指向已删/禁用模型的绑定在下次发言时由 `ensureBinding` 自动改选。
6. `scheduler.start(engine)`:启动定时任务轮询(30s 一次,`unref`)。**必须在 engine.init() 之后**——先让会话状态归位,首轮 tick 才看不到脏状态(见 §5.12)。随后 `wechat.init(cfg, db, bus)` 挂上总线内部订阅(微信接入,§5.13;env WXBOT_URL/WXBOT_TOKEN 未就位时全程静默)。
7. `createAuth(cfg)` 装配登录中间件;未配 `auth.users` 则认证关闭(可交给前置 nginx-proxy basic auth)。
8. `express.static(public)` + 路由挂载(`/api/sessions`、`/api/skills`、`/api/config`、`/api/platforms`、`/api/system`、`/api/channel`、`/api/wechat`);`auth.middleware` 之前另挂两个内网/匿名入口:`/p`(公网临时文件)与 `/wxhook`(wxbot 回调,共享服务 token 把门)。
8. `express.static(public)` + 路由挂载(`/api/sessions`、`/api/skills`、`/api/config`、`/api/platforms`、`/api/system`、`/api/channel`、`/api/wechat`);全部业务路由之后由 `routes/preview-proxy.js` 的 mount(app) 追加通用预览反代(含根绝对路径 Referer 兜底);`auth.middleware` 之前另挂两个内网/匿名入口:`/p`(公网临时文件)与 `/wxhook`(wxbot 回调,共享服务 token 把门)。
9. `mcp.init(cfg).then(...)`:对每个 MCP 服务 initialize → tools/list,发现的工具存在 `mcp` 模块内。
10. `skills.listSkills(...)` → `llm.setSkillListText(...)` 快照注入 system prompt(`llm.js`)。
11. `server.listen(PORT)`,打 startup 行:workspace_root / data_root / models / mcp_servers / auth / log_level。
@@ -484,6 +485,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks`
| `/login` `/logout` | `auth.js` | 登录/登出页 |
| `/files/download[-name/...]?t=` `/files/zip[-name/...]?t=` | `auth.js` 白名单 | 带签名 token 的下载/打包下载(认证中免 cookie) |
| `/p/<id>` | `routes/public-files.js` | 公网临时文件取用(匿名,挂认证中间件之前;随机 ID + 过期) |
| `/preview/**` | `routes/preview-proxy.js` | 通用任务预览反代(挂认证之后、server.js 最末,信任模型同 data-page 登录≈运维):注册表(env PREVIEW_PROXIES,默认 officecli → mcp_officecli:3100)把 `<prefix>/**` 原样转发到服务单一预览入口,槽位/路径解析托管给服务端;另兜 vendor 预览页硬编码的根绝对 API(Referer 指向注册预览页 → 原路径转给对应服务,其余请求 404 照旧);头白名单(凭据/公网身份不出容器),JSON 体因全局 express.json 已消耗需重序列化重放;SSE 响应加 no-cache/no-buffering;watch url 的公网前缀由 `mcp.js` 随请求以 `X-Public-Base` 头注入,会话目录经 `X-Session-Dir` 注入(officecli 桥自动把裸文件名补全会话目录);链路见 mcp 仓库 `officecli/README.md` |
**SSE 事件**(`/api/sessions/:id/stream`,由 `bus.emit` 触发,前端订阅):