diff --git a/mcp/officecli/README.md b/mcp/officecli/README.md index fad43e8..231362e 100644 --- a/mcp/officecli/README.md +++ b/mcp/officecli/README.md @@ -53,6 +53,7 @@ mcp_officecli:3100 gateway.js ——按路径找槽位、改写 Host/Origin 回 - url 按任务组织:文档必须在会话目录下(`/<会话id>/…`,任务根下不可预览);重启换槽不影响链接含义。 - 预览 url 不由本服务下发:链接按固定格式 `<公网前缀>/preview/<会话id>/<文档相对路径>/` 由前端自拼;`X-Public-Base` 仅供桥内 watch 状态/日志用,对 AI 的回包里 `url`/`path` 字段已被剥掉。 +- 回包可附通用 UI 卡片块 `{type:'ui_card', action, arg, title?, note?}`(非 text:core 的 MCP 层剥离后不进模型面,整块经 SSE `ui_card` 转前端,动作注册表驱动渲染)。当前动作 `open_preview`:arg=相对会话目录的文件路径,聊天流出可点卡片直接开预览窗(无需等文件回任务盘);create/open/push 成功自动附带(文案由产生方给)。卡片为实时事件不落库,刷新后从任务文件列表进入。 - 槽位数 `OFFICE_SLOTS`(默认 4);满了优先踢「无活动连接且最久未用」;闲置超 `OFFICE_IDLE_MS`(默认 6h)回收,挂着活动连接的槽不回收;预览每一帧回传与 AI 命令都会续命。 - 槽位是缓存不是承诺:预览链接按任务路径寻址,被回收/挤占后页面再访问由网关就地复活(一次冷启动)。 - AI 面不公示 watch/unwatch(也没有 watch ls / --all 这类跨会话动作):预览完全由前端拼链接、网关按需复活槽位 + LRU 管理;core 删会话时经校验的 `unwatch --session --purge` 清槽并删工作区目录副本(不等 scratch TTL)。 diff --git a/mcp/officecli/server.js b/mcp/officecli/server.js index 63e3f80..9788ed7 100644 --- a/mcp/officecli/server.js +++ b/mcp/officecli/server.js @@ -161,7 +161,9 @@ function ackNote(cmd, reply, sessDir) { const t = (tokenizeCmd(cmd) || []).find((x) => x.startsWith(watch.WORKSPACE + '/') && OFFICE_EXT_RE.test(x)); if (!t) return; const jail = sessDir && sessDir.startsWith('/') ? path.resolve(sessDir) : ''; - first.text = verb + ': ' + (jail && t.startsWith(jail + '/') ? path.relative(jail, t) : path.basename(t)); + const jailRel = jail && t.startsWith(jail + '/') ? path.relative(jail, t) : ''; + first.text = verb + ': ' + (jailRel || path.basename(t)); + if (jailRel) attachPreviewCard(res, verb === 'Created' ? 'created' : 'opened', jailRel); } // 失败文案整形:剥掉工作区路径前缀只留文件名(与任务目录同名不同盘,全路径只会诱发误判); @@ -348,6 +350,18 @@ function toolErr(msg) { return { content: [{ type: 'text', text: 'Error: ' + (msg && msg.message || String(msg)) }], isError: true }; } + +// create/open/push 成功附带一个通用 ui_card 块(action=open_preview):core 的 MCP 层剥离后不进模型面, +// 经 SSE ui_card 转聊天流可点卡片。后续其它命令/其它服务出卡片走同一协议: +// {type:'ui_card', action, arg, title?, note?}。arg 相对会话目录(前端 openFilePreview 拼预览链接 +// 正好用);组不出会话目录则不附。卡片的展示文案由产生方负责(前端只做动作分发)。 +const CARD_NOTE = { created: '已创建', opened: '已打开', imported: '已导入' }; +function attachPreviewCard(res, op, rel) { + if (!res || !Array.isArray(res.content)) return; + if (!rel || rel === '.' || rel.startsWith('..')) return; + res.content.push({ type: 'ui_card', action: 'open_preview', arg: rel, title: rel, note: CARD_NOTE[op] || '' }); +} + async function handle(msg, pubBase, sessDir) { // pubBase/sessDir:调用方每请求注入(X-Public-Base / X-Session-Dir) const isReq = msg.id !== undefined && msg.id !== null; let helpCmd = false; // 本次调用是否为 help 族:透传后要把文本对齐可调用面 @@ -434,7 +448,9 @@ async function handle(msg, pubBase, sessDir) { // pubBase/sessDir:调用方每 if (data.length > PUSH_MAX_BYTES) throw new Error('File too large: limit is ' + Math.floor(PUSH_MAX_BYTES / 1048576) + ' MB'); fs.mkdirSync(path.dirname(abs), { recursive: true }); fs.writeFileSync(abs, data); - return { jsonrpc: '2.0', id: msg.id, result: toolText('Imported: ' + name) }; + const pushRes = { jsonrpc: '2.0', id: msg.id, result: toolText('Imported: ' + name) }; + if (sessDir) attachPreviewCard(pushRes.result, 'imported', path.relative(path.resolve(sessDir), abs)); + return pushRes; } if (mr[1] === 'watch') { if (!file) throw new Error('Usage: watch ');