@aalis/plugin-webui-server 0.4.2 → 0.5.1

package/dist/gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate.js","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,QAAoB;IAChE,OAAO,CAAC,UAAkB,EAAE,UAAgC,EAAkB,EAAE,CAC9E,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACjB,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAmB,WAAW,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,2CAA2C;YAC3C,wCAAwC;YACxC,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;gBAChC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YACD,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,QAAoB;IAClD,OAAO,GAAmB,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAc,YAAY,EAAE,OAAO,EAAkC,MAAM,aAAa,CAAC;AAsCrG,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,WAAW,6BAAc,CAAC;AACvC,eAAO,MAAM,SAAS,aAAa,CAAC;AACpC,eAAO,MAAM,QAAQ,UAA+B,CAAC;AACrD,eAAO,MAAM,MAAM;;CAMlB,CAAC;AAWF,eAAO,MAAM,YAAY,EAAE,YAkD1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;CASzB,CAAC;AAoBF,OAAO,EAAE,KAAK,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAqIlE,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAo2CxF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAc,YAAY,EAAE,OAAO,EAAkC,MAAM,aAAa,CAAC;AAmDrG,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,WAAW,6BAAc,CAAC;AACvC,eAAO,MAAM,SAAS,aAAa,CAAC;AACpC,eAAO,MAAM,QAAQ,UAA+B,CAAC;AACrD,eAAO,MAAM,MAAM;;CAMlB,CAAC;AAWF,eAAO,MAAM,YAAY,EAAE,YAiD1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;CASzB,CAAC;AAoBF,OAAO,EAAE,KAAK,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA6IlE,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA4yCxF"}

package/dist/index.js

@@ -2,12 +2,12 @@
 // 已在 biome.json noRestrictedImports 中作为基础设施例外列出。
 import { Buffer } from 'node:buffer';
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
 import { createServer } from 'node:http';
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { LogHub, parseLogLine } from '@aalis/core';
+import { listLLMModels } from '@aalis/plugin-llm-api';
 import { aggregatePlatformDetails, getPlatformAdapters, getPlatformNames, } from '@aalis/plugin-platform-api';
 import { createProcessGateway } from '@aalis/plugin-process-api';
 import { createStorageGateway } from '@aalis/plugin-storage-api';
@@ -15,13 +15,24 @@ import { DEFAULT_SUBSYSTEM_METADATA } from '@aalis/plugin-webui-api';
 import express from 'express';
 import { WebSocket, WebSocketServer } from 'ws';
 import { createAuthSystem, openBrowser } from './auth.js';
-import { discoverClients } from './client-discovery.js';
+import { collectLocalPackageDeps, discoverClients } from './client-discovery.js';
+import { renderClientSwitchPage } from './client-switch-page.js';
 import { createRouteGate } from './gate.js';
 import { registerFileRoutes } from './routes/files.js';
 import { registerMarketplaceRoutes } from './routes/marketplace.js';
 import { registerPluginRoutes } from './routes/plugins.js';
 import { registerProxyRoutes } from './routes/proxy.js';
 import { registerUploadedFilesRoutes } from './routes/uploaded-files.js';
+/**
+ * 工具 / 指令 / 工具组 description 约定：首行 = 人类可读摘要，其余 = 给 agent 的长使用指南。
+ * WebUI 管理页只展示首行摘要（避免倾倒整段指南）；完整 description 仍由工具/指令定义抵达 LLM。
+ */
+function descSummary(d) {
+    if (!d)
+        return d;
+    const s = d.split('\n')[0].trim();
+    return s.length > 200 ? `${s.slice(0, 200)}…` : s;
+}
 // ===== 插件元数据 =====
 export const name = '@aalis/plugin-webui-server';
 export const displayName = 'WebUI 服务端';
@@ -65,9 +76,8 @@ export const configSchema = {
             { label: '每次启动随机生成（重启即轮换）', value: 'ephemeral' },
             { label: '首次生成后持久化（重启不掉登录）', value: 'persist' },
             { label: '使用下方固定 token', value: 'fixed' },
-            { label: '禁用 token 登录（仅账户密码；无账户时 token 兜底生效）', value: 'disabled' },
         ],
-        description: 'ephemeral=旧行为；persist=token 写入 data/.webui-token，读取复用；fixed=使用 fixedToken 字段；disabled=多用户部署收口——存在登录账户时 token 全面失效（防 root 后门），无账户时仍以 persist 语义兜底防锁死。所有模式下都会同时写出便利文件 data/webui-access.txt 包含访问 URL。',
+        description: 'ephemeral=每次启动随机；persist=token 写入 data/.webui-token，读取复用；fixed=使用 fixedToken 字段。所有模式都会写出便利文件 data/webui-access.txt 含访问 URL。',
     },
     fixedToken: {
         type: 'string',
@@ -104,14 +114,22 @@ export const defaultConfig = {
 // 入站消息类型 + 校验 schema 见 ./protocol.ts（zod 强校验）
 import { WSIncomingSchema } from './protocol.js';
 export { WSIncomingSchema } from './protocol.js';
-// ===== 日志文件读取（与 src/runtime/file-logger.ts 的格式对偶）=====
+// ===== 日志文件读取（与 @aalis/runtime 的 file-logger 格式对偶）=====
 // 行格式契约（format ↔ parse）由 @aalis/core 的 parseLogLine 唯一持有，此处只负责
-// 读取 data/latest.log（启动覆盖的单一历史源）并按 cursor 尾读分页。
-const LOG_FILE_PATH = resolve(process.cwd(), 'data/latest.log');
-async function readAllLogEntries() {
-    if (!existsSync(LOG_FILE_PATH))
-        return [];
-    const raw = await readFile(LOG_FILE_PATH, 'utf8');
+// 读取「持久化日志单一数据源」并按 cursor 尾读分页。
+//
+// 路径（宿主目录布局）是「环境知识」，归 storage 的 logs 根所有；本插件只用 storage
+// URI 寻址、对 cwd/落盘位置无知。写入方（runtime/file-logger）跑在 storage 起来之前，
+// 是 bootstrap 期的合法 raw-fs 例外，不在此处管辖（默认 logs 根 = data/，与之对偶）。
+const LOG_FILE_URI = 'logs:/latest.log';
+async function readAllLogEntries(storage) {
+    let raw;
+    try {
+        raw = (await storage.readFile(LOG_FILE_URI, 'utf-8'));
+    }
+    catch {
+        return []; // 文件未就绪 / storage 暂不可用 → 无历史
+    }
     const out = [];
     for (const line of raw.split('\n')) {
         if (!line)
@@ -122,12 +140,12 @@ async function readAllLogEntries() {
     }
     return out;
 }
-async function readLogFileTail(limit) {
-    const all = await readAllLogEntries();
+async function readLogFileTail(storage, limit) {
+    const all = await readAllLogEntries(storage);
     return all.slice(-limit);
 }
-async function readLogFileBefore(beforeSeq, limit) {
-    const all = await readAllLogEntries();
+async function readLogFileBefore(storage, beforeSeq, limit) {
+    const all = await readAllLogEntries(storage);
     const filtered = all.filter(e => e.seq < beforeSeq);
     return filtered.slice(-limit);
 }
@@ -138,7 +156,7 @@ export async function apply(ctx, config) {
         host: config.host ?? '127.0.0.1',
         fileRoot: config.fileRoot || 'workspace',
         autoOpen: config.autoOpen ?? true,
-        tokenMode: ['ephemeral', 'fixed', 'disabled'].includes(config.tokenMode)
+        tokenMode: ['ephemeral', 'fixed'].includes(config.tokenMode)
             ? config.tokenMode
             : 'persist',
         fixedToken: config.fixedToken ?? '',
@@ -161,8 +179,7 @@ export async function apply(ctx, config) {
         if (uiConfig.tokenMode === 'fixed' && uiConfig.fixedToken.trim()) {
             return uiConfig.fixedToken.trim();
         }
-        // disabled 模式仍按 persist 语义产出 token：无账户时作为兜底登录方式
-        if (uiConfig.tokenMode === 'persist' || uiConfig.tokenMode === 'fixed' || uiConfig.tokenMode === 'disabled') {
+        if (uiConfig.tokenMode === 'persist' || uiConfig.tokenMode === 'fixed') {
             try {
                 const raw = await storage.readFile(tokenFileUri, 'utf-8');
                 const existing = (typeof raw === 'string' ? raw : raw.toString('utf-8')).trim();
@@ -204,28 +221,13 @@ export async function apply(ctx, config) {
         }
     }
     const authToken = await resolveAuthToken();
-    // 账户校验惰性委托 authority 服务（可能晚于本插件激活/被热替换），账户即
-    // platform='webui' 且带密码凭据的用户记录。
-    const auth = createAuthSystem(authToken, ctx.logger.child('auth'), {
-        verify: (username, password) => ctx.getService('authority')?.verifyPassword('webui', username, password) ?? false,
-        hasAccounts: () => (ctx.getService('authority')?.listUsers() ?? []).some(u => u.platform === 'webui' && u.hasPassword),
-    }, 
-    // disabled：存在账户时 token 全面失效（auth 内部留有"无账户兜底"防锁死）
-    () => uiConfig.tokenMode !== 'disabled');
+    const auth = createAuthSystem(authToken, ctx.logger.child('auth'));
     const expressApp = express();
     expressApp.use(express.json({ limit: '10mb' }));
     expressApp.use(auth.middleware);
-    // REST 路由权限闸（连接级认证之上的身份级裁决，见 gate.ts 分层说明）
-    const gate = createRouteGate(ctx, auth.identify);
-    // 当前调用者信息（middleware 已拦未认证；identity 必存在）
-    expressApp.get('/api/auth/me', (req, res) => {
-        const identity = auth.identify(req) ?? { platform: 'webui', userId: 'console' };
-        const authority = ctx.getService('authority');
-        res.json({
-            identity,
-            isOwner: authority?.isOwner(identity.platform, identity.userId) ?? false,
-        });
-    });
+    // REST 路由 owner 闸（连接级认证之上的显式 owner 复核，见 gate.ts）。
+    // 当前身份 / 登录态查询统一走 auth.ts 的 GET /api/auth/status（含 identity）。
+    const gate = createRouteGate(auth.identify);
     const server = createServer(expressApp);
     const wss = new WebSocketServer({
         server,
@@ -302,11 +304,11 @@ export async function apply(ctx, config) {
     });
     // ---------- REST API ----------
     // 获取系统状态
-    expressApp.get('/api/status', gate('webui:status:read', 'public'), (_req, res) => {
+    expressApp.get('/api/status', gate(), (_req, res) => {
         const persona = ctx.getService('persona');
         // 判断上传能力
         const hasMedia = ctx.hasService('media');
-        const llmHasVision = ctx.getServiceCapabilities('llm').includes('vision');
+        const llmHasVision = listLLMModels(ctx).some(e => e.instance.capabilities.includes('vision'));
         const hasFileReader = ctx.hasService('file-reader');
         res.json({
             name: persona?.getPersonaName() ?? ctx.config.get('name'),
@@ -334,19 +336,47 @@ export async function apply(ctx, config) {
                 ?.getAll()
                 .map(c => ({
                 name: c.name,
-                description: c.description,
+                description: descSummary(c.description),
                 visibility: c.visibility,
             })),
         });
     });
     // ---------- 插件管理 + 全局配置 ----------
+    // fs 扫描 env：discoverClients（ready 时）与市场「已装」兜底共用一份，避免两处重复。
+    const fsScanEnv = {
+        existsSync,
+        readdirSync: (p) => {
+            try {
+                return readdirSync(p);
+            }
+            catch {
+                return [];
+            }
+        },
+        readJson: (p) => {
+            try {
+                return JSON.parse(readFileSync(p, 'utf-8'));
+            }
+            catch {
+                return undefined;
+            }
+        },
+        join: (...parts) => resolve(...parts),
+    };
     registerPluginRoutes(expressApp, ctx, getApp, getPluginMgr, auth.identify, gate);
-    registerMarketplaceRoutes(expressApp, ctx, getPluginMgr, gate, uiConfig.marketplaceRegistry);
+    // 市场「已装」判定 + 依赖图都吃这一份本地扫描（pnpm 工作区下 require.resolve 从仓库根解析不到工作区包）：
+    // 与 discoverClients 同套 scanDirs（monorepo packages/ 同级 + node_modules/@aalis），每请求懒扫（量小）。
+    // 返回 name→依赖名[]：keys=已装包名，values=依赖图边。
+    const localScanDirs = [
+        resolve(dirname(fileURLToPath(import.meta.url)), '../../'),
+        resolve(process.cwd(), 'node_modules/@aalis'),
+    ];
+    registerMarketplaceRoutes(expressApp, ctx, getPluginMgr, gate, uiConfig.marketplaceRegistry, () => collectLocalPackageDeps(localScanDirs, fsScanEnv));
     // 获取历史日志：从 data/latest.log 读尾部 N 条（lazy load）。
     // 单进程内 LogHub 不再缓存 buffer——历史以文件为单一数据源。
-    expressApp.get('/api/logs', gate('webui:logs:read', 'restricted'), async (_req, res) => {
+    expressApp.get('/api/logs', gate(), async (_req, res) => {
         try {
-            const entries = await readLogFileTail(200);
+            const entries = await readLogFileTail(storage, 200);
             res.json(entries);
         }
         catch (err) {
@@ -354,17 +384,17 @@ export async function apply(ctx, config) {
         }
     });
     // 尾部 N 条（首屏 / 显式刷新）
-    expressApp.get('/api/logs/tail', gate('webui:logs:read', 'restricted'), async (req, res) => {
+    expressApp.get('/api/logs/tail', gate(), async (req, res) => {
         const limit = Math.min(Math.max(Number(req.query.limit) || 200, 1), 5000);
         try {
-            res.json(await readLogFileTail(limit));
+            res.json(await readLogFileTail(storage, limit));
         }
         catch (err) {
             res.status(500).json({ error: err.message });
         }
     });
     // 历史分页：返回 seq < before 的最近 limit 条（向上滚动加载更早）
-    expressApp.get('/api/logs/range', gate('webui:logs:read', 'restricted'), async (req, res) => {
+    expressApp.get('/api/logs/range', gate(), async (req, res) => {
         const before = Number(req.query.before);
         const limit = Math.min(Math.max(Number(req.query.limit) || 200, 1), 5000);
         if (!Number.isFinite(before)) {
@@ -372,14 +402,14 @@ export async function apply(ctx, config) {
             return;
         }
         try {
-            res.json(await readLogFileBefore(before, limit));
+            res.json(await readLogFileBefore(storage, before, limit));
         }
         catch (err) {
             res.status(500).json({ error: err.message });
         }
     });
     // 获取服务列表（含提供者信息）
-    expressApp.get('/api/services', gate('webui:services:read', 'public'), async (_req, res) => {
+    expressApp.get('/api/services', gate(), async (_req, res) => {
         const pluginMgr = getPluginMgr();
         const pluginStatus = pluginMgr ? pluginMgr.getStatus() : [];
         const displayNameMap = new Map();
@@ -397,7 +427,6 @@ export async function apply(ctx, config) {
             services[svcName] = {
                 providers: entries.map(e => ({
                     contextId: e.contextId,
-                    capabilities: [...e.capabilities],
                     displayName: displayNameMap.get(e.contextId),
                     label: e.label,
                     priority: e.priority,
@@ -411,7 +440,7 @@ export async function apply(ctx, config) {
      * 设置服务偏好。body: { contextId: string }
      * 偏好语义：`preferred > priority > 注册顺序`。持久化到 aalis.config.yaml 的 servicePreferences。
      */
-    expressApp.post('/api/services/:name/prefer', gate('webui:services:manage', 'restricted'), async (req, res) => {
+    expressApp.post('/api/services/:name/prefer', gate(), async (req, res) => {
         const svcName = String(req.params.name);
         const contextId = String(req.body?.contextId ?? '').trim();
         if (!contextId) {
@@ -433,7 +462,7 @@ export async function apply(ctx, config) {
         res.json({ ok: true });
     });
     /** 清除服务偏好 */
-    expressApp.delete('/api/services/:name/prefer', gate('webui:services:manage', 'restricted'), async (req, res) => {
+    expressApp.delete('/api/services/:name/prefer', gate(), async (req, res) => {
         const svcName = String(req.params.name);
         ctx.unpreferService(svcName);
         ctx.config.removeServicePreference(svcName);
@@ -446,11 +475,11 @@ export async function apply(ctx, config) {
     // POST /api/services/webui-client/prefer（见上），webui-server 在该偏好变更时重挂 + 广播刷新。
     // 故不再有独立的 /api/clients* 路由。
     // 获取所有平台适配器及其连接状态
-    expressApp.get('/api/platforms', gate('webui:status:read', 'public'), (_req, res) => {
+    expressApp.get('/api/platforms', gate(), (_req, res) => {
         res.json({ platforms: aggregatePlatformDetails(ctx) });
     });
     // 获取已注册的工具分组（含元数据 + 各组工具数量 + 贡献插件列表）
-    expressApp.get('/api/tool-groups', gate('webui:status:read', 'public'), (_req, res) => {
+    expressApp.get('/api/tool-groups', gate(), (_req, res) => {
         const groups = ctx.getService('tools')?.getGroups() ?? [];
         const allTools = ctx.getService('tools')?.getAll() ?? [];
         const knownNames = new Set(groups.map(g => g.name));
@@ -459,7 +488,7 @@ export async function apply(ctx, config) {
             // 贡献插件 = 该分组下所有工具的 pluginName 去重（可能跨多个插件，
             // 例如 'session-history' 同时被 plugin-tool-session 与 plugin-memory-history 贡献）
             const contributingPlugins = [...new Set(toolsInGroup.map(t => t.pluginName))].sort();
-            return { ...g, toolCount: toolsInGroup.length, contributingPlugins };
+            return { ...g, description: descSummary(g.description), toolCount: toolsInGroup.length, contributingPlugins };
         });
         // 兜底：未声明任何 group 或 group 不在已注册集合中的工具，聚成 "other" 组
         const orphans = allTools.filter(t => {
@@ -479,7 +508,7 @@ export async function apply(ctx, config) {
         res.json({ groups: result });
     });
     // 获取服务分组（manifest 驱动：每个插件自己声明 subsystem，本路由仅聚合）
-    expressApp.get('/api/service-groups', gate('webui:status:read', 'public'), (_req, res) => {
+    expressApp.get('/api/service-groups', gate(), (_req, res) => {
         const pluginMgr = getPluginMgr();
         const pluginStatus = pluginMgr ? pluginMgr.getStatus() : [];
         // 按插件 subsystem 归组（未声明 → 'external'）。subsystem 是 WebUI 展示概念、
@@ -520,12 +549,12 @@ export async function apply(ctx, config) {
         res.json({ groups });
     });
     // 获取所有 LLM 模型（枚举所有注册的 per-model entry）
-    expressApp.get('/api/llm-models', gate('webui:llm:read', 'restricted'), async (_req, res) => {
+    expressApp.get('/api/llm-models', gate(), async (_req, res) => {
         try {
             const entries = ctx.getAllServices('llm');
             const models = entries.map(e => ({
                 id: e.instance.id,
-                capabilities: e.capabilities,
+                capabilities: [...e.instance.capabilities],
                 provider: e.instance.providerId,
                 contextId: e.contextId,
             }));
@@ -536,7 +565,7 @@ export async function apply(ctx, config) {
         }
     });
     // LLM providers + per-provider models（供 schema type='llm-ref' 联动 select 使用）
-    expressApp.get('/api/llm-providers', gate('webui:llm:read', 'restricted'), async (_req, res) => {
+    expressApp.get('/api/llm-providers', gate(), async (_req, res) => {
         try {
             const entries = ctx.getAllServices('llm');
             const byProvider = new Map();
@@ -560,7 +589,7 @@ export async function apply(ctx, config) {
                 }
                 agg.models.push({
                     id: e.instance.id,
-                    capabilities: e.capabilities,
+                    capabilities: [...e.instance.capabilities],
                     contextLength: e.instance.contextLength,
                 });
             }
@@ -573,7 +602,7 @@ export async function apply(ctx, config) {
     // 触发指定 provider 重新探测远端模型列表（用于 webui 上的"刷新模型"按钮）
     // 仅对在 LLMModel 上实现了 refresh() 的 provider 生效（远端动态发现型，如 Ollama / OpenAI）。
     // 同 provider 下所有 model entries 共享同一份 refresh 闭包，调任一个 entry 即可。
-    expressApp.post('/api/llm-providers/:contextId/refresh', gate('webui:llm:manage', 'restricted'), async (req, res) => {
+    expressApp.post('/api/llm-providers/:contextId/refresh', gate(), async (req, res) => {
         const contextId = req.params.contextId;
         if (!contextId) {
             res.status(400).json({ error: 'contextId is required' });
@@ -596,7 +625,7 @@ export async function apply(ctx, config) {
         }
     });
     // 获取某个服务的可用模型/选项列表
-    expressApp.get('/api/models/:service', gate('webui:models:read', 'public'), async (req, res) => {
+    expressApp.get('/api/models/:service', gate(), async (req, res) => {
         const serviceName = req.params.service;
         // 特殊处理 platform：通过 helper 获取已注册的平台名称
         if (serviceName === 'platform') {
@@ -643,7 +672,7 @@ export async function apply(ctx, config) {
                     details: groups.map(g => ({
                         value: g.name,
                         label: g.label,
-                        description: g.description,
+                        description: descSummary(g.description),
                         pluginName: g.pluginName,
                     })),
                 });
@@ -670,7 +699,7 @@ export async function apply(ctx, config) {
                     model: e.instance.id,
                     provider: e.label ?? e.contextId,
                     contextId: e.contextId,
-                    capabilities: e.capabilities,
+                    capabilities: [...e.instance.capabilities],
                 }));
                 res.json({ models: aggregated.map(a => a.value), providers: aggregated });
             }
@@ -697,9 +726,7 @@ export async function apply(ctx, config) {
                     for (const m of models) {
                         const isModelInfo = typeof m === 'object' && m !== null && 'id' in m;
                         const modelId = isModelInfo ? m.id : String(m);
-                        const modelCaps = isModelInfo
-                            ? m.capabilities
-                            : provider.capabilities;
+                        const modelCaps = isModelInfo ? m.capabilities : [];
                         aggregated.push({
                             value: modelId,
                             model: modelId,
@@ -720,57 +747,22 @@ export async function apply(ctx, config) {
             res.json({ models: [] });
         }
     });
-    // ---------- 受限操作交互式确认（内联对话式；restricted 能力的临时委托） ----------
-    const CONFIRM_TIMEOUT = 60_000; // 60 秒超时
-    const pendingSessionConfirms = new Map();
-    ctx.getService('authority')?.setConfirmHandler('webui', async (request) => {
-        const typeLabel = request.type === 'command' ? '指令' : '工具';
-        const nameStr = request.type === 'command' ? `/${request.name}` : request.name;
-        const prompt = `⚠️ ${typeLabel} ${nameStr} 是受限操作。回复 Y 仅允许本次；回复 YS 允许本会话 10 分钟；其他任意输入取消。`;
-        // 以确认消息形式发送（不影响客户端 loading/streaming 状态）
-        const payload = {
-            type: 'confirm',
-            content: prompt,
-            sessionId: request.sessionId,
-        };
-        const json = JSON.stringify(payload);
-        const sockets = sessions.get(request.sessionId);
-        const targets = sockets && sockets.size > 0 ? sockets : allClients;
-        let sent = false;
-        for (const ws of targets) {
-            if (ws.readyState === WebSocket.OPEN) {
-                ws.send(json);
-                sent = true;
+    // ---------- 受限操作交互式确认（复用 session-confirm 协调器；WebUI 传输=WS type:'confirm'，流式友好） ----------
+    // 协调器逻辑（待确认/超时/解析/文案）由 session-confirm 服务统一实现；WebUI 只注入自己的 WS 投递，
+    // 并保留 type:'confirm'（前端「确认模式」信号，抑制富客户端的「打字即打断」）。回复在 WS-onmessage 调 feed（下方）。
+    let confirmChannel;
+    ctx.whenService('session-confirm', confirmSvc => {
+        confirmChannel = confirmSvc.createChannel((request, text) => {
+            const payload = { type: 'confirm', content: text, sessionId: request.sessionId };
+            const json = JSON.stringify(payload);
+            const sockets = sessions.get(request.sessionId);
+            const targets = sockets && sockets.size > 0 ? sockets : allClients;
+            for (const ws of targets) {
+                if (ws.readyState === WebSocket.OPEN)
+                    ws.send(json);
             }
-        }
-        if (!sent)
-            return false;
-        // 同一 session 已有未决确认时，先取消旧的（清 timer + resolve false），避免新
-        // set 覆盖后旧 Promise 永远 pending 且旧 timer 误删新条目（审计 HIGH #7 竞态）。
-        const stale = pendingSessionConfirms.get(request.sessionId);
-        if (stale) {
-            clearTimeout(stale.timer);
-            pendingSessionConfirms.delete(request.sessionId);
-            stale.resolve(false);
-        }
-        return new Promise(resolve => {
-            const timer = setTimeout(() => {
-                pendingSessionConfirms.delete(request.sessionId);
-                // 超时后向会话发送提示
-                const timeoutPayload = {
-                    type: 'confirm',
-                    content: '⏰ 受限操作确认已超时，已自动取消。',
-                    sessionId: request.sessionId,
-                };
-                const timeoutJson = JSON.stringify(timeoutPayload);
-                for (const ws of targets) {
-                    if (ws.readyState === WebSocket.OPEN)
-                        ws.send(timeoutJson);
-                }
-                resolve(false);
-            }, CONFIRM_TIMEOUT);
-            pendingSessionConfirms.set(request.sessionId, { resolve, timer });
         });
+        ctx.getService('authority')?.setConfirmHandler('webui', confirmChannel.handler);
     });
     // ---------- 文件管理 API ----------
     registerFileRoutes(expressApp, ctx, { storage, fileRoot: uiConfig.fileRoot }, gate);
@@ -869,18 +861,9 @@ export async function apply(ctx, config) {
                     sessions.set(sessionId, new Set());
                 }
                 sessions.get(sessionId).add(ws);
-                // 检查是否有待确认的受限操作（拦截用户输入作为确认/取消）
-                const pending = pendingSessionConfirms.get(sessionId);
-                if (pending) {
-                    clearTimeout(pending.timer);
-                    pendingSessionConfirms.delete(sessionId);
-                    const answer = trimmed.toLowerCase();
-                    if (answer === 'ys' || answer === 'y session') {
-                        pending.resolve({ allowed: true, grant: { scope: 'session', durationSeconds: 600, maxUses: 30 } });
-                    }
-                    else {
-                        pending.resolve(answer === 'y');
-                    }
+                // 检查待确认的受限操作（拦截输入作为确认/取消；协调器逻辑由 session-confirm 服务统一处理）
+                // 传应答者身份：仅确认的触发者本人能应答（防第三方抢答；webui 同账户天然同人）。
+                if (confirmChannel?.feed(sessionId, trimmed, wsIdentity.userId)) {
                     // 不继续处理此消息，交给原始命令/工具执行流返回结果
                     return;
                 }
@@ -1203,6 +1186,13 @@ export async function apply(ctx, config) {
             }
         }
     });
+    // 前端切换「逃生页」：由 webui-server 直出、独立于任何可被切换的前端，故任意前端（哪怕
+    // 极简第三方前端无切换 UI）卡住时都能在此切回。受全局 auth 中间件登录保护；切换走既有 owner
+    // 闸的 POST /api/services/webui-client/prefer，本页零新增后端逻辑（见 client-switch-page.ts）。
+    // 注册在 SPA 兜底之前，故 `/__clients` 被本路由先接走、不落到前端 index.html。
+    expressApp.get('/__clients', (_req, res) => {
+        res.type('html').send(renderClientSwitchPage());
+    });
     // SPA fallback: 所有非 API 路径返回 index.html
     expressApp.get('{*path}', (_req, res) => {
         const indexPath = resolve(clientDist, 'index.html');
@@ -1221,24 +1211,7 @@ export async function apply(ctx, config) {
         const here = dirname(fileURLToPath(import.meta.url));
         const projectRequire = createRequire(pathToFileURL(resolve(process.cwd(), 'package.json')));
         const env = {
-            existsSync,
-            readdirSync: p => {
-                try {
-                    return readdirSync(p);
-                }
-                catch {
-                    return [];
-                }
-            },
-            readJson: p => {
-                try {
-                    return JSON.parse(readFileSync(p, 'utf-8'));
-                }
-                catch {
-                    return undefined;
-                }
-            },
-            join: (...parts) => resolve(...parts),
+            ...fsScanEnv,
             dirname,
             resolvePkgJson: id => {
                 try {
@@ -1281,12 +1254,18 @@ export async function apply(ctx, config) {
             const accessUrl = `${url}?token=${authToken}`;
             void writeAccessFile(url, authToken);
             ctx.logger.info(`WebUI 已启动: ${url}`);
+            // 多前端时提示恢复页 URL：万一切到无切换 UI 的前端被卡住，可在此切回（详见 client-switch-page.ts）。
+            if (clientCandidates.length > 1) {
+                ctx.logger.info(`检测到多个前端；若卡在某前端无切换入口，可访问恢复页切回: ${url}__clients`);
+            }
             const tokenHint = uiConfig.tokenMode === 'ephemeral'
                 ? 'token 仅本次启动有效，重启轮换'
                 : uiConfig.tokenMode === 'fixed'
                     ? 'token 来自配置 fixedToken，固定不变'
                     : 'token 已持久化到 storage data:/webui/token，重启沿用';
-            ctx.logger.info(`首次访问请使用以下 URL（${tokenHint}）: ${accessUrl}`);
+            // 不把 token 打进日志（会落 latest.log / 被 /api/logs 回放 / 贴日志求助时外泄）。
+            // 仅打不带 token 的 URL，完整一键登录链接见 access.txt（该文件应 0o600，见 token 落盘）。
+            ctx.logger.info(`首次访问 URL（${tokenHint}）: ${url} —— 完整一键登录链接见 ${accessFileUri}`);
             void (async () => {
                 let absHint = accessFileUri;
                 try {
@@ -1304,6 +1283,7 @@ export async function apply(ctx, config) {
         });
     });
     ctx.onDispose(() => {
+        confirmChannel?.dispose(); // 清 WebUI 确认通道里挂起的待确认（安全拒），避免 Promise 永挂
         removeLogListener();
         wss.close();
         server.close();
@@ -1344,7 +1324,7 @@ export async function apply(ctx, config) {
             }
         },
     };
-    ctx.provide('platform', adapter, { capabilities: ['webui', 'text', 'image', 'file'] });
+    ctx.provide('platform', adapter);
     // === 注册 WebUI 服务 ===
     const registeredPages = new Map();
     // 内建页面归属为 webui-server 本身
@@ -1386,6 +1366,6 @@ export async function apply(ctx, config) {
             registeredPages.delete(pluginName);
         },
     };
-    ctx.provide('webui-server', webuiService, { capabilities: ['api-v1'] });
+    ctx.provide('webui-server', webuiService);
 }
 //# sourceMappingURL=index.js.map