Files
agent/app/server/routes/preview-proxy.js
kicer 5f4b3ec28b officecli 迁入技能层:skills/office 封装 + executor 预览托管,双盘同步整条退役
- skills/office:SKILL.md + scripts/office 封装层(命令闸门/help 对齐/get-pos 语义糖/create、open 出 ui_card
  marker);install.sh 按技能双跑约定把二进制拉到技能卷 bin/(不进 git/不进镜像,GitHub→gh-proxy 备源)
- executor/preview.js:预览槽位+网关(原 mcp 侧 watch/gateway 移植),工作区=tasks 卷真实文件,
  /__session-kill 供 core 清槽;Dockerfile 零 officecli 痕迹,入口符号链接进 /usr/local/bin/office
- core:preview-proxy 默认上游改 agent-executor:3100;tools/executor.js 通用 drainUiCards(terminal 输出
  ::ui_card 标记行 → 剥离 + ctx.onCard,任意命令可产卡);engine 删会话改走 rexec.killPreviewSession
- compose:agent-executor expose 3100(只走内网);.gitignore 排除技能二进制
2026-10-19 11:30:12 +08:00

95 lines
5.2 KiB
JavaScript

// 通用任务预览反代(注册表驱动;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;
const PREVIEW_DEFAULT = [{
name: 'office', prefix: '/preview',
host: process.env.EXECUTOR_PREVIEW_HOST || 'agent-executor',
port: Number(process.env.EXECUTOR_PREVIEW_PORT || 3100),
}];
try {
services = process.env.PREVIEW_PROXIES ? JSON.parse(process.env.PREVIEW_PROXIES) : PREVIEW_DEFAULT;
} catch (e) {
log.error('preview', 'PREVIEW_PROXIES \u89e3\u6790\u5931\u8d25\uff0c\u56de\u9000\u9ed8\u8ba4\u6ce8\u518c\u8868: ' + (e && e.message));
services = PREVIEW_DEFAULT;
}
// \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;
}
// 前置守卫(server.js 需注册在 express.static 之前):vendor 预览页把「取自身新版 HTML」
// 硬编码成根绝对 '/',打到 core 根上会被 SPA 首页吞掉 → 局部 diff 拿到外来页 → 触发
// location.reload() 兜底(白屏一下)。这里只拦 '/':Referer 命中预览前缀时原样转发回
// 对应服务(与兜底路由同一信任模型),其余路径仍由 mount() 末尾兜底。
function earlyGuard(app) {
app.use((req, res, next) => {
if ((req.method !== 'GET' && req.method !== 'HEAD') || req.path !== '/') return next();
const svc = serviceByReferer(req);
if (!svc) return next();
forward(svc, req, res, '/');
});
}
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, earlyGuard };