glad-web 1.0.44 → 1.0.46

package/README.md

@@ -34,6 +34,8 @@ Glad was created to enable **vibe coding** on mobile devices. By bringing variou
 
 Our design philosophy is **Easy to use, Stable, and Restrained**. Glad focuses strictly on the essentials:
 - **Session management:** Run multiple sessions from a single dashboard with per-session working directories.
+- **Responsive workspace:** Use a resizable session sidebar on wide screens and focused lobby/chat pages on mobile, with light and dark themes.
+- **File attachments:** Upload images or arbitrary local files from the composer; Glad stores them privately for the active session and cleans them up automatically.
 - **Local usage dashboard:** Select a week or month, compare per-model and daily token totals, and inspect model-stacked token and cost charts through the bundled read-only `ccusage` engine. Costs use `ccusage` estimates and are shown only for GPT models used by Codex.
 - **High-fidelity terminal interaction:** A mobile-friendly terminal experience with touch shortcuts.
 - **Extreme performance history viewing:** Fast and responsive text history.

package/README.zh-CN.md

@@ -34,6 +34,8 @@ Glad 的初衷是开发一款完全运行在本地的、足够简单的，且登
 
 我们的设计哲学是：**易用、稳定、克制**。只提供最核心且体验优秀的功能：
 - **Session 管理**：在一个面板中管理多个会话，每个会话可单独指定工作目录。
+- **响应式工作区**：宽屏提供可调宽度的会话侧边栏，手机使用大厅与对话双页面，并支持亮色、暗色主题。
+- **文件附件**：可从输入区上传图片或普通文件；附件仅保存于当前会话的私有临时目录，并会自动清理。
 - **本地用量看板**：通过内置的只读 `ccusage` 引擎选择某周或某月，查看按模型汇总及每日 token，并用按模型堆叠的柱状图比较 token 和费用；费用完全采用 `ccusage` 估算，且只对 Codex 使用的 GPT 模型显示。
 - **高还原度的 terminal 交互**：专为手机优化的终端体验与快捷按键。
 - **极致性能的历史查看**：快速流畅的终端历史记录浏览。

package/lib/claude/structured-session.js

@@ -211,22 +211,27 @@ class ClaudeStructuredSession extends EventEmitter {
     return true;
   }
 
-  sendUserMessage(text, attachments = []) {
+  sendUserMessage(text, attachments = [], options = {}) {
     if (!this.running) return false;
     const prompt = String(text || '').trim();
+    const agentPrompt = String(options.agentText ?? prompt).trim();
     const images = Array.isArray(attachments) ? attachments.filter(item => item?.data && item?.mediaType) : [];
-    if (!prompt && images.length === 0) return false;
+    const displayAttachments = Array.isArray(options.displayAttachments) ? options.displayAttachments : [];
+    if (!agentPrompt && images.length === 0) return false;
     this.hasUnreadCompletion = false;
-    const turn = this.beginTurn(prompt, images.map(item => ({ name: item.name, size: item.size })));
+    const turn = this.beginTurn(prompt, [
+      ...images.map(item => ({ name: item.name, size: item.size })),
+      ...displayAttachments
+    ]);
     this.setStatus('thinking');
 
     const content = images.length > 0 ? [
-      ...(prompt ? [{ type: 'text', text: prompt }] : []),
+      ...(agentPrompt ? [{ type: 'text', text: agentPrompt }] : []),
       ...images.map(item => ({
         type: 'image',
         source: { type: 'base64', media_type: item.mediaType, data: item.data }
       }))
-    ] : prompt;
+    ] : agentPrompt;
 
     const sdkMessage = {
       type: 'user',

package/lib/codex/image-store.js

@@ -35,8 +35,7 @@ class CodexImageStore {
 
   assertSession(session) {
     if (!session) throw inputError('Session not found', 404);
-    const structured = session.kind === 'claude-structured'
-      || (session.kind === 'codex-structured' && session.presentation === 'structured');
+    const structured = ['claude-structured', 'codex-structured'].includes(session.kind);
     if (!structured) {
       throw inputError('Image attachments are available only in structured chat mode');
     }

package/lib/codex/structured-session.js

@@ -3,7 +3,6 @@ const { spawn } = require('child_process');
 const net = require('net');
 const crypto = require('crypto');
 const WebSocket = require('ws');
-const PTYManager = require('../session/pty-manager');
 
 const PERMISSION_MODES = new Set(['untrusted', 'on-request', 'never']);
 const SANDBOX_MODES = new Set(['read-only', 'workspace-write', 'danger-full-access']);
@@ -282,7 +281,6 @@ class CodexStructuredSession extends EventEmitter {
     this.startTime = Date.now();
     this.running = true;
     this.status = 'idle';
-    this.presentation = 'structured';
     this.messages = [];
     this.replayingHistory = false;
     this.pendingPermissions = new Map();
@@ -326,27 +324,22 @@ class CodexStructuredSession extends EventEmitter {
     this.abortGraceMs = Number(options.abortGraceMs) > 0
       ? Number(options.abortGraceMs) : DEFAULT_ABORT_GRACE_MS;
     this.forceKillProcessTree = options.forceKillProcessTree || forceKillProcessTree;
-    this.terminalSession = null;
-    this.terminalOutput = '';
     this.hasUnreadCompletion = false;
     this.inputSeq = 0;
     this.completionReadInputSeq = 0;
     this.timedInputs = new Map();
     this.promptHistoryCache = null;
     this.deferredWarnings = null;
-    this.ptyManager = {
-      workingDir,
-      isRunning: () => this.isRunning(),
-      write: data => this.write(data),
-      kill: () => this.kill(),
-      resize: (cols, rows) => this.terminalSession?.resize(cols, rows),
-      redraw: () => false
-    };
+    this.activeSkill = options.activeSkill && options.activeSkill.name && options.activeSkill.path
+      ? { name: String(options.activeSkill.name), path: String(options.activeSkill.path) }
+      : null;
+    this.extraSkillRoots = (Array.isArray(options.extraSkillRoots) ? options.extraSkillRoots : [])
+      .map(value => String(value || '').trim()).filter(Boolean);
   }
 
   toListItem() {
     return { id: this.id, name: this.name, tool: this.tool.displayName, startTime: this.startTime,
-      toolKey: this.tool.key, workingDirectory: this.workingDir, mode: this.presentation === 'terminal' ? 'terminal' : 'structured',
+      toolKey: this.tool.key, workingDirectory: this.workingDir, mode: 'structured',
       hasUnreadCompletion: Boolean(this.hasUnreadCompletion), timedInputCount: this.timedInputs.size };
   }
 
@@ -404,15 +397,12 @@ class CodexStructuredSession extends EventEmitter {
     return { permissionMode: this.permissionMode || 'default', sandboxMode: this.sandboxMode || 'default',
       effectivePermissionMode: this.effectivePermissionMode, effectiveSandboxMode: this.effectiveSandboxMode,
       model: this.model, effort: this.effort,
-      status: this.status, threadId: this.threadId, presentation: this.presentation,
+      status: this.status, threadId: this.threadId,
       aborting: this.aborting, resuming: this.resuming,
-      canAbort: this.presentation === 'structured' && (this.status !== 'idle' || this.resuming) && !this.aborting,
-      canCompact: this.presentation === 'structured' && this.status === 'idle' && !this.compacting
+      canAbort: (this.status !== 'idle' || this.resuming) && !this.aborting,
+      canCompact: this.status === 'idle' && !this.compacting
         && !this.aborting && !this.resuming && Boolean(this.threadId),
       compacting: this.compacting,
-      canSwitchToTerminal: this.presentation === 'structured' && this.status === 'idle'
-        && !this.aborting && !this.resuming && Boolean(this.threadId),
-      canSwitchToStructured: this.presentation === 'terminal',
       pendingPermissionCount: this.pendingPermissions.size, activeSubagentCount, models: this.models };
   }
 
@@ -424,15 +414,14 @@ class CodexStructuredSession extends EventEmitter {
       return item.text || '';
     }).filter(Boolean).join('\n\n');
     return { success: true, sessionId: this.id, sessionName: this.name, tool: this.tool.displayName,
-      historyMode: this.presentation === 'terminal' ? 'terminal' : 'structured', text, updatedAt: Date.now(),
+      historyMode: 'structured', text, updatedAt: Date.now(),
       truncated: false, bytes: Buffer.byteLength(text, 'utf8'), lines: text ? text.split('\n').length : 0 };
   }
 
   getCatchupOutput() {
-    if (this.presentation === 'terminal') return { source: 'codex-terminal', items: 1, data: this.terminalOutput };
     return { source: 'codex-structured', items: this.messages.length, data: '' };
   }
-  isRunning() { return this.running && (this.presentation !== 'terminal' || Boolean(this.terminalSession)); }
+  isRunning() { return this.running; }
 
   createItem(item) { return { id: crypto.randomUUID(), createdAt: Date.now(), ...item }; }
   append(item) {
@@ -502,7 +491,7 @@ class CodexStructuredSession extends EventEmitter {
           const failure = error instanceof Error ? error : new Error(String(error || 'Codex app-server transport closed'));
           this.logger.debugInfo?.(`[codex-app-server] transport failed: ${failure.message}`);
           this.needsThreadResume = Boolean(this.threadId || this.resumeTarget);
-          if (this.running && this.presentation === 'structured') {
+          if (this.running) {
             const activeTurn = Boolean(this.currentTurnId || this.status === 'running' || this.status === 'waiting_approval');
             this.clearAbortState(false);
             this.compacting = false;
@@ -526,7 +515,7 @@ class CodexStructuredSession extends EventEmitter {
             request.reject(new Error(`Codex app-server exited (${code})`));
           }
           this.pendingRequests.clear();
-          if (this.running && this.presentation === 'structured') {
+          if (this.running) {
             const activeTurn = Boolean(this.currentTurnId || this.status === 'running' || this.status === 'waiting_approval');
             this.needsThreadResume = Boolean(this.threadId);
             this.clearAbortState(false);
@@ -556,6 +545,9 @@ class CodexStructuredSession extends EventEmitter {
           }, { fatalOnTimeout: true });
         }).then(async () => {
           this.notify('initialized', {});
+          if (this.extraSkillRoots.length) {
+            await this.request('skills/extraRoots/set', { extraRoots: this.extraSkillRoots }, { fatalOnTimeout: true });
+          }
           try { await this.refreshConfigDefaults(); } catch (error) { this.logger.debugInfo?.(`[codex-app-server] config/read failed: ${error.message}`); }
           try { await this.refreshModels(); } catch (error) { this.logger.debugInfo?.(`[codex-app-server] model/list failed: ${error.message}`); }
           resolve();
@@ -924,10 +916,11 @@ class CodexStructuredSession extends EventEmitter {
 
   async listSkills(forceReload = false) {
     await this.ensureProcess();
-    const result = await this.request('skills/list', {
+    const params = {
       cwds: [this.workingDir],
       forceReload: Boolean(forceReload)
-    });
+    };
+    const result = await this.request('skills/list', params);
     const entries = Array.isArray(result?.data) ? result.data : [];
     const entry = entries.find(item => item?.cwd === this.workingDir) || entries[0] || {};
     return {
@@ -937,7 +930,10 @@ class CodexStructuredSession extends EventEmitter {
   }
 
   async resolveSkillInputs(skills) {
-    const requested = (Array.isArray(skills) ? skills : []).slice(0, 8);
+    const requested = [
+      ...(this.activeSkill ? [this.activeSkill] : []),
+      ...(Array.isArray(skills) ? skills : [])
+    ].slice(0, 8);
     if (!requested.length) return [];
     const available = await this.listSkills(false);
     const allowed = new Map(available.skills.map(item => [`${item.name}\n${item.path}`, item]));
@@ -1132,7 +1128,6 @@ class CodexStructuredSession extends EventEmitter {
   }
 
   async showStatus() {
-    if (this.presentation !== 'structured') return false;
     await this.ensureProcess();
     const accountResult = await this.request('account/read', { refreshToken: false });
     const account = accountResult?.account || null;
@@ -1172,11 +1167,11 @@ class CodexStructuredSession extends EventEmitter {
     }
     const needsConfigDefaults = (settings.permissionMode !== undefined && !this.permissionMode)
       || (settings.sandboxMode !== undefined && !this.sandboxMode);
-    if (needsConfigDefaults && this.presentation === 'structured') {
+    if (needsConfigDefaults) {
       await this.ensureProcess();
       await this.refreshConfigDefaults();
     }
-    if (this.threadId && this.presentation === 'structured') {
+    if (this.threadId) {
       await this.ensureProcess();
       const params = { threadId: this.threadId };
       if (settings.permissionMode !== undefined) {
@@ -1219,18 +1214,22 @@ class CodexStructuredSession extends EventEmitter {
     return params;
   }
 
-  async sendUserMessage(text, attachments = [], skills = []) {
+  async sendUserMessage(text, attachments = [], skills = [], options = {}) {
     const prompt = String(text || '').trim();
+    const agentPrompt = String(options.agentText ?? prompt).trim();
     const images = (Array.isArray(attachments) ? attachments : [])
       .filter(item => item && typeof item.path === 'string' && item.path);
-    if ((!prompt && images.length === 0) || this.presentation !== 'structured'
-      || this.status !== 'idle' || this.aborting || this.resuming) return false;
+    const displayAttachments = Array.isArray(options.displayAttachments) ? options.displayAttachments : [];
+    if ((!agentPrompt && images.length === 0) || this.status !== 'idle' || this.aborting || this.resuming) return false;
     this.hasUnreadCompletion = false;
     this.promptHistoryCache = null;
     this.append({
       kind: 'user',
-      text: prompt || '📷 Image attachment',
-      attachments: images.map(item => ({ id: item.id, name: item.name || 'image' })),
+      text: prompt || (displayAttachments.length ? '📎 File attachment' : '📷 Image attachment'),
+      attachments: [
+        ...images.map(item => ({ id: item.id, name: item.name || 'image' })),
+        ...displayAttachments
+      ],
       skills: (Array.isArray(skills) ? skills : []).map(item => ({
         name: String(item?.name || ''), path: String(item?.path || '')
       })).filter(item => item.name && item.path)
@@ -1255,7 +1254,7 @@ class CodexStructuredSession extends EventEmitter {
       }
       const input = [];
       input.push(...await this.resolveSkillInputs(skills));
-      if (prompt) input.push({ type: 'text', text: prompt });
+      if (agentPrompt) input.push({ type: 'text', text: agentPrompt });
       for (const image of images) input.push({ type: 'localImage', path: image.path });
       const params = { threadId: this.threadId, input, cwd: this.workingDir, summary: 'auto' };
       if (this.hasModelOverride) params.model = this.model;
@@ -1278,7 +1277,7 @@ class CodexStructuredSession extends EventEmitter {
   }
 
   async compactContext() {
-    if (!this.threadId || this.presentation !== 'structured' || this.status !== 'idle'
+    if (!this.threadId || this.status !== 'idle'
       || this.aborting || this.resuming) return false;
     await this.ensureProcess();
     this.compacting = true;
@@ -1295,7 +1294,6 @@ class CodexStructuredSession extends EventEmitter {
   }
 
   write(data) {
-    if (this.presentation === 'terminal') return this.terminalSession?.write(data) || false;
     const text = String(data || '').replace(/\r/g, '\n');
     const prompt = text.trim();
     if (prompt) void this.sendUserMessage(prompt).catch(error => {
@@ -1330,7 +1328,7 @@ class CodexStructuredSession extends EventEmitter {
   }
 
   abort(reason = 'Aborted by user') {
-    if (this.presentation !== 'structured' || (this.status === 'idle' && !this.resuming)) return false;
+    if (this.status === 'idle' && !this.resuming) return false;
     if (this.aborting) return true;
     if (this.resuming) {
       this.aborting = true;
@@ -1417,7 +1415,7 @@ class CodexStructuredSession extends EventEmitter {
 
   resume(threadId = null) {
     const target = String(threadId || this.threadId || '').trim();
-    if (!target || this.presentation !== 'structured' || this.status !== 'idle' || this.aborting) return false;
+    if (!target || this.status !== 'idle' || this.aborting) return false;
     if (this.resumePromise) return target === this.resumeTarget ? this.resumePromise : false;
     this.resuming = true;
     this.resumeTarget = target;
@@ -1521,7 +1519,7 @@ class CodexStructuredSession extends EventEmitter {
 
   async forkFrom(threadId) {
     const sourceThreadId = String(threadId || '').trim();
-    if (!sourceThreadId || this.presentation !== 'structured' || this.status !== 'idle'
+    if (!sourceThreadId || this.status !== 'idle'
       || this.aborting || this.resuming) return false;
     await this.ensureProcess();
     const params = { threadId: sourceThreadId, cwd: this.workingDir, ephemeral: false, threadSource: null };
@@ -1542,39 +1540,6 @@ class CodexStructuredSession extends EventEmitter {
     return { threadId: this.threadId };
   }
 
-  async switchToTerminal() {
-    if (this.presentation !== 'structured' || this.status !== 'idle' || this.aborting
-      || this.resuming || !this.threadId) throw new Error('Codex must be idle before switching to Terminal.');
-    await this.disconnectProcess();
-    this.terminalOutput = '';
-    const terminal = new PTYManager(this.tool, this.workingDir, { append() {} }, { silent: true });
-    terminal.onData(data => {
-      this.terminalOutput = (this.terminalOutput + data).slice(-1024 * 1024);
-      this.emit('output', data);
-    });
-    terminal.onExit(() => { this.terminalSession = null; this.emitEvent({ type: 'state', state: this.getControlState() }); });
-    if (!terminal.start(['resume', this.threadId])) throw new Error('Failed to start Codex terminal.');
-    this.terminalSession = terminal;
-    this.presentation = 'terminal';
-    this.emitEvent({ type: 'presentation', presentation: 'terminal', state: this.getControlState() });
-    return true;
-  }
-
-  async switchToStructured() {
-    if (this.presentation !== 'terminal') throw new Error('Codex is already in chat mode.');
-    await this.ensureProcess();
-    const listed = await this.request('thread/list', { limit: 100, archived: false, cwd: this.workingDir, useStateDbOnly: true });
-    const current = (listed?.data || []).find(item => item.id === this.threadId);
-    if (current?.status?.type === 'active') throw new Error('Codex is still running in Terminal. Wait for it to finish before switching.');
-    if (this.terminalSession) {
-      this.terminalSession.kill();
-      this.terminalSession = null;
-    }
-    this.presentation = 'structured';
-    this.emitEvent({ type: 'presentation', presentation: 'structured', state: this.getControlState() });
-    return this.resume();
-  }
-
   async disconnectProcess(force = false, reason = null) {
     if (!this.process) return this.processShutdown || undefined;
     const child = this.process;
@@ -1613,8 +1578,6 @@ class CodexStructuredSession extends EventEmitter {
     this.clearAbortState(false);
     this.resuming = false;
     this.resumeTarget = null;
-    this.terminalSession?.kill();
-    this.terminalSession = null;
     await this.disconnectProcess(true);
     this.emit('exit');
   }

package/lib/commands/web.js

@@ -48,10 +48,14 @@ const registerWorkspaceRoutes = require('../server/routes/workspace');
 const registerProviderRoutes = require('../server/routes/providers');
 const registerNotificationRoutes = require('../server/routes/notifications');
 const registerUsageRoutes = require('../server/routes/usage');
+const registerSkillHubRoutes = require('../server/routes/skillhub');
 const { UsageService } = require('../usage/usage-service');
 const { ServerChanSettingsStore } = require('../notifications/serverchan-settings-store');
 const ServerChanClient = require('../notifications/serverchan-client');
 const NotificationService = require('../notifications/notification-service');
+const { SkillHubSettingsStore } = require('../skillhub/settings-store');
+const { SkillHubClient } = require('../skillhub/client');
+const { SkillInstaller } = require('../skillhub/skill-installer');
 
 async function webCommand(options) {
   const port = parseInt(options.port) || 3000;
@@ -104,6 +108,10 @@ async function webCommand(options) {
     logger
   });
   const usageService = new UsageService({ logger });
+  const skillHubSettings = new SkillHubSettingsStore();
+  const skillHubClient = new SkillHubClient({ settingsStore: skillHubSettings });
+  const skillInstaller = new SkillInstaller({ client: skillHubClient });
+  await skillInstaller.initialize();
   sessionManager.on('output', ({ sessionId, data }) => {
     broadcastToSession(sessionId, { type: 'output', data });
   });
@@ -147,6 +155,12 @@ async function webCommand(options) {
     notificationService
   });
   registerUsageRoutes(app, { usageService, sendJson: sendCompressedJson });
+  registerSkillHubRoutes(app, {
+    settingsStore: skillHubSettings,
+    client: skillHubClient,
+    installer: skillInstaller,
+    sessionManager
+  });
 
   // API: List all active sessions
   app.get('/api/sessions', (req, res) => {
@@ -275,9 +289,43 @@ async function webCommand(options) {
     }
   });
 
+  app.post('/api/sessions/:id/attachments/files/chunks', express.raw({ type: () => true, limit: '1mb' }), async (req, res) => {
+    try {
+      const result = await sessionManager.appendFileChunk(req.params.id, {
+        uploadId: req.get('X-Glad-Upload-Id'),
+        chunkIndex: req.get('X-Glad-Chunk-Index'),
+        chunkTotal: req.get('X-Glad-Chunk-Total'),
+        name: req.get('X-Glad-File-Name')
+      }, req.body);
+      res.json({ success: true, ...result });
+    } catch (e) {
+      res.status(e.statusCode || 500).json({ error: e.message });
+    }
+  });
+
+  app.delete('/api/sessions/:id/attachments/files/uploads/:uploadId', async (req, res) => {
+    try {
+      const removed = await sessionManager.discardFileUpload(req.params.id, req.params.uploadId);
+      res.json({ success: true, removed });
+    } catch (e) {
+      res.status(e.statusCode || 500).json({ error: e.message });
+    }
+  });
+
+  app.delete('/api/sessions/:id/attachments/files/:attachmentId', async (req, res) => {
+    try {
+      const removed = await sessionManager.discardFileAttachment(req.params.id, req.params.attachmentId);
+      if (!removed) return res.status(404).json({ error: 'File attachment not found' });
+      res.json({ success: true });
+    } catch (e) {
+      res.status(e.statusCode || 500).json({ error: e.message });
+    }
+  });
+
   // API: Delete/Kill session
   app.delete('/api/sessions/:id', async (req, res) => {
-    await sessionManager.kill(req.params.id);
+    const deleted = await sessionManager.kill(req.params.id);
+    if (!deleted) return res.status(404).json({ error: 'Session not found' });
     res.json({ success: true });
   });
 
@@ -335,7 +383,7 @@ async function webCommand(options) {
     if (session.kind === 'claude-structured') {
       ws.send(JSON.stringify({ type: 'claude-snapshot', snapshot: sessionManager.getClaudeSnapshot(sessionId) }));
     }
-    if (session.kind === 'codex-structured' && session.presentation === 'structured') {
+    if (session.kind === 'codex-structured') {
       ws.send(JSON.stringify({ type: 'codex-snapshot', snapshot: sessionManager.getCodexSnapshot(sessionId) }));
     }
     
@@ -347,7 +395,7 @@ async function webCommand(options) {
       && (isReconnect || (catchup && catchup.source === 'rendered-history'));
     if (ws.needsTuiRedraw) {
       ws.send(JSON.stringify({ type: 'reset' }));
-    } else if (!(session.kind === 'claude-structured' || (session.kind === 'codex-structured' && session.presentation === 'structured')) && catchup && catchup.data) {
+    } else if (!['claude-structured', 'codex-structured'].includes(session.kind) && catchup && catchup.data) {
       sessionManager.logWsCatchupOutput(sessionId, catchup);
       ws.send(JSON.stringify({ type: 'output', data: catchup.data }));
     }
@@ -358,8 +406,11 @@ async function webCommand(options) {
         if (payload.type === 'input') {
           session.write(payload.data);
         }
+        if (payload.type === 'file-input') {
+          sessionManager.sendTerminalFileInput(sessionId, payload.text || '', payload.fileAttachmentIds || []);
+        }
         if (payload.type === 'claude-input') {
-          sessionManager.sendClaudeInput(sessionId, payload.text || '', payload.attachmentIds || [])
+          sessionManager.sendClaudeInput(sessionId, payload.text || '', payload.attachmentIds || [], payload.fileAttachmentIds || [])
             .catch(error => logger.error(`Claude input error: ${error.message}`));
         }
         if (payload.type === 'claude-permission') {
@@ -378,7 +429,7 @@ async function webCommand(options) {
           sessionManager.abortClaude(sessionId);
         }
         if (payload.type === 'codex-input') {
-          sessionManager.sendCodexInput(sessionId, payload.text || '', payload.attachmentIds || [], payload.skills || [])
+          sessionManager.sendCodexInput(sessionId, payload.text || '', payload.attachmentIds || [], payload.skills || [], payload.fileAttachmentIds || [])
             .catch(error => logger.error(`Codex input error: ${error.message}`));
         }
         if (payload.type === 'codex-permission') {
@@ -398,7 +449,7 @@ async function webCommand(options) {
         }
         if (payload.type === 'codex-detail-request') {
           const codex = sessionManager.get(sessionId);
-          if (codex && codex.kind === 'codex-structured' && codex.presentation === 'structured') {
+          if (codex && codex.kind === 'codex-structured') {
             ws.send(JSON.stringify({
               type: 'codex-detail-response',
               requestId: payload.requestId || null,
@@ -473,12 +524,14 @@ async function webCommand(options) {
   };
 
   const webAssets = [
+    'bootstrap.js',
     'gitgraph.js',
     'styles.css',
     'theme.js',
     'core.js',
     'layout.js',
     'notifications.js',
+    'skillhub.js',
     'claude.js',
     'schedules.js',
     'shell.js',
@@ -539,12 +592,14 @@ async function webCommand(options) {
     console.log(chalk.gray(`Tips: Access from your phone via the Network URL above.\n`));
   });
 
-  process.on('SIGINT', () => { 
+  const shutdown = () => {
     schedulerService.stop();
     notificationService.stop();
     sessionManager.killAll();
-    process.exit(0); 
-  });
+    process.exit(0);
+  };
+  process.once('SIGINT', shutdown);
+  process.once('SIGTERM', shutdown);
 }
 
 module.exports = webCommand;

package/lib/config/manager.js

@@ -26,6 +26,25 @@ const schema = {
       clientType: 'wechat'
     }
   },
+  skillHub: {
+    type: 'object',
+    properties: {
+      baseUrl: { type: 'string', default: '' },
+      token: {
+        type: 'object',
+        properties: {
+          ciphertext: { type: 'string', default: '' },
+          iv: { type: 'string', default: '' },
+          authTag: { type: 'string', default: '' }
+        },
+        default: { ciphertext: '', iv: '', authTag: '' }
+      }
+    },
+    default: {
+      baseUrl: '',
+      token: { ciphertext: '', iv: '', authTag: '' }
+    }
+  },
   version: {
     type: 'string',
     default: '1.0.0'

package/lib/server/routes/providers.js

@@ -104,18 +104,6 @@ function registerProviderRoutes(app, { sessionManager }) {
     }
   });
 
-  app.post('/api/sessions/:id/codex-presentation', async (req, res) => {
-    const presentation = req.body?.presentation;
-    if (!['terminal', 'structured'].includes(presentation)) return res.status(400).json({ error: 'Invalid presentation' });
-    try {
-      const success = await sessionManager.switchCodexPresentation(req.params.id, presentation);
-      if (!success) return res.status(409).json({ error: 'Codex session cannot switch presentation now' });
-      res.json({ success: true });
-    } catch (error) {
-      res.status(409).json({ error: error.message });
-    }
-  });
-
   app.post('/api/debug/client-log', (req, res) => {
     const { sessionId, event, payload } = req.body || {};
     sessionManager.logClientDebug(sessionId, event, payload);

package/lib/server/routes/skillhub.js

@@ -0,0 +1,104 @@
+const { v4: uuidv4 } = require('uuid');
+
+function statusCode(error) {
+  return Number(error?.statusCode) || 500;
+}
+
+function errorBody(error) {
+  return {
+    error: error?.message || 'SkillHub 操作失败',
+    ...(error?.code ? { code: error.code } : {})
+  };
+}
+
+function registerSkillHubRoutes(app, {
+  settingsStore,
+  client,
+  installer,
+  sessionManager
+}) {
+  app.get('/api/skillhub/status', (_req, res) => {
+    res.json({ available: installer.available === true });
+  });
+
+  app.get('/api/skillhub/settings', (_req, res) => {
+    try { res.json(settingsStore.getPublic()); }
+    catch (error) { res.status(statusCode(error)).json(errorBody(error)); }
+  });
+
+  app.put('/api/skillhub/settings', async (req, res) => {
+    try {
+      const resolved = settingsStore.resolve(req.body || {});
+      const user = await client.test(resolved);
+      const settings = settingsStore.save(resolved);
+      res.json({ success: true, settings, user });
+    } catch (error) {
+      res.status(statusCode(error)).json(errorBody(error));
+    }
+  });
+
+  app.delete('/api/skillhub/settings', (_req, res) => {
+    try { res.json({ success: true, settings: settingsStore.clear() }); }
+    catch (error) { res.status(statusCode(error)).json(errorBody(error)); }
+  });
+
+  app.post('/api/skillhub/settings/test', async (req, res) => {
+    try {
+      const settings = settingsStore.resolve(req.body || {});
+      const user = await client.test(settings);
+      res.json({ success: true, user });
+    } catch (error) {
+      res.status(statusCode(error)).json(errorBody(error));
+    }
+  });
+
+  app.get('/api/skillhub/skills', async (_req, res) => {
+    try {
+      installer.assertAvailable();
+      const skills = await client.listSkills();
+      res.json({ success: true, skills });
+    } catch (error) {
+      res.status(statusCode(error)).json(errorBody(error));
+    }
+  });
+
+  app.post('/api/skillhub/sessions', async (req, res) => {
+    const sessionId = uuidv4();
+    let created = false;
+    try {
+      if (req.body?.toolKey !== 'codex') {
+        const error = new Error('SkillHub Session 当前只支持 Codex');
+        error.statusCode = 400;
+        error.code = 'SKILLHUB_CODEX_ONLY';
+        throw error;
+      }
+      const activeSkill = await installer.prepare(sessionId, req.body?.skill || {});
+      const session = sessionManager.create({
+        id: sessionId,
+        toolKey: 'codex',
+        workingDirectory: req.body?.workingDirectory,
+        name: activeSkill.name,
+        codexOptions: {
+          activeSkill,
+          extraSkillRoots: [activeSkill.skillsRoot]
+        },
+        disposeResources: () => installer.cleanupSync(sessionId)
+      });
+      created = true;
+      const defaultPrompt = activeSkill.defaultPrompt
+        || '请先用中文介绍这个 Skill 能完成什么、适合哪些任务，以及用户接下来应该如何使用。这一轮只做使用引导。';
+      const intro = `$${activeSkill.name}\n\n${defaultPrompt}`;
+      const started = await sessionManager.sendCodexInput(session.id, intro, [], [activeSkill], []);
+      if (!started) throw new Error('Codex Skill 引导会话启动失败');
+      res.status(201).json({ id: session.id, name: session.name });
+    } catch (error) {
+      if (created) await sessionManager.kill(sessionId).catch(() => {});
+      else {
+        try { installer.cleanupSync(sessionId); } catch (_) { /* 目录可能尚未创建 */ }
+      }
+      res.status(statusCode(error)).json(errorBody(error));
+    }
+  });
+}
+
+module.exports = registerSkillHubRoutes;