| 
|
截图使用演示数据，拍摄于旧版，仅供界面参考。
+## 相对上版本的改动
+
+- 你现在可以随意编辑它在额度耗尽后的发送内容
+- 解决了即使当前任务已经结束，仍然会对被设置监测的对话发送约定消息的问题
+- 拆分了事件处理器的职责，减轻了核心管理器manager.js的负担
+- 明确了不同工作的边界，加入了跨模式校验
+- 减轻了重复逻辑的使用，稍微优化了石山
+- 给依赖文字和源码形状的实现添加了新的协议
+- 给英文版装了新的依赖
+
## 安装
运行需要 Windows x64、Node.js 22.12+（推荐 24），以及已安装、登录并支持插件的 Codex CLI。原聊天接续还需要支持 `queue --thread --message` 的桌面 CLI。源码编译额外需要 Visual Studio Build Tools 的 MSBuild/Roslyn；便携包不需要编译工具。
@@ -54,7 +64,7 @@ cd codex-continuer
| 模式 | 接续行为 | 停止条件 |
| --- | --- | --- |
-| 导入原聊天 | 一次确认的耗尽恢复周期，向原聊天发送一次“继续”；备注仅本地保存 | 暂停、发送次数到限或发送结果不确定；不自动识别原聊天目标完成 |
+| 导入原聊天 | 一次确认的耗尽恢复周期，向原聊天发送一次自定义续作消息，留空发送“继续”；备注保存在本地并展示在首页卡片 | 暂停、发送次数到限或发送结果不确定；不自动识别原聊天目标完成 |
| 新建工作 | 按原始目标启动执行轮次，要求结构化完成结果 | 完成、阻塞、无工具活动或轮次到限；模型报告完成仍需核对验收 |
`Start-Continuer.ps1` 打开原生挂件；浏览器凭据链接已停用。本地客户端通过固定证书校验服务身份后才发送凭据。隐藏到托盘仍保留运行；点击关闭按钮或选择“退出 Continuer”会保存状态、停止后台服务和监听器，并结束进程。停止超时后仅清理经安装路径核验的所属服务进程树。退出后，普通状态查询和自动启动不会重新拉起；手动打开挂件可恢复。
@@ -87,7 +97,7 @@ npm run build:release
## 范围与隐私
- 当前主要验证 Windows x64、Node.js 24、Codex CLI 协议基线 0.153.2；外部接口升级可能需要适配。
-- 目前仅支持中文，在工作恢复时也发送且只发送“继续”，对于需求新阶段新引导词的对话可能不适配。
+- 界面支持中文和英文；续作消息可在加入工作时自定义，每次额度恢复使用同一条消息，仍需在原聊天中确认工作进展和结果。
- 电脑、服务和原聊天执行端必须可用。排队成功不等于任务完成；已进入 Codex 队列的消息不能由本工具撤回。
- 跨机器、完整真实额度耗尽恢复和长期无人值守仍然需要验收；原生监听器尚未代码签名。
- 凭据由 Codex 管理；本工具的任务、输出、路径、备注和日志仍可能包含私人信息。不要上传 `data/`、`.cache/`、`runtime.json`、令牌或未脱敏诊断以及一切可能涉及安全问题的信息。
diff --git a/desktop/geometry.cjs b/desktop/geometry.cjs
index 272f274..d308d62 100644
--- a/desktop/geometry.cjs
+++ b/desktop/geometry.cjs
@@ -17,6 +17,18 @@ function placeIndependent(saved, current, workArea, size) {
const y = saved?.y ?? (Math.abs(current.height-size.height)<=1 ? current.y : current.y+current.height-size.height);
return place({ x, y, ...size },workArea,size,{ right: 0, bottom: 0 });
}
+function expandFromCard(card, workArea, size) {
+ const width = Math.min(size.width, workArea.width), height = Math.min(size.height, workArea.height);
+ const align = (start, length, minimum, available, expanded) => {
+ const endAligned = start + length - expanded, maximum = minimum + available - expanded;
+ // Prefer the shared bottom/right edge; near the top/left edge, grow in
+ // the other direction instead of sliding the card's corner to the edge.
+ if (endAligned >= minimum && endAligned <= maximum) return Math.round(endAligned);
+ if (start >= minimum && start <= maximum) return Math.round(start);
+ return Math.round(Math.max(minimum, Math.min(endAligned, maximum)));
+ };
+ return { x: align(card.x, card.width, workArea.x, workArea.width, width), y: align(card.y, card.height, workArea.y, workArea.height, height), width, height };
+}
function compactSize(value) { return Number.isFinite(value) ? Math.min(420,Math.max(160,Math.round(value))) : 256; }
function samePlacementContext(a,b) {
return !!a && a.mode===b.mode && a.follow===b.follow && a.compactSize===b.compactSize &&
@@ -31,4 +43,4 @@ function restoreModePosition(fallback,saved,workArea) {
? {...fallback,x,y} : fallback;
}
const sizes = { compact: { width: 256, height: 256 }, expanded: { width: 432, height: 720 } };
-module.exports = { place, placeIndependent, offsetFrom, sizes, compactSize, samePlacementContext, restoreModePosition };
+module.exports = { place, placeIndependent, expandFromCard, offsetFrom, sizes, compactSize, samePlacementContext, restoreModePosition };
diff --git a/desktop/main.cjs b/desktop/main.cjs
index f70b526..3a97a12 100644
--- a/desktop/main.cjs
+++ b/desktop/main.cjs
@@ -1,297 +1 @@
-const { app, BrowserWindow, ipcMain, screen, Tray, Menu, nativeImage, globalShortcut, dialog } = require('electron');
-const { spawn } = require('node:child_process');
-const { createInterface } = require('node:readline');
-const { join } = require('node:path');
-const { readFileSync, writeFileSync, mkdirSync, existsSync } = require('node:fs');
-const { place, placeIndependent, offsetFrom, sizes, compactSize, samePlacementContext, restoreModePosition } = require('./geometry.cjs');
-const { createPointerDrag } = require('./pointer-drag.cjs');
-const runtimeConfig = require('../server/config.cjs');
-const logging = require('../server/logging.cjs');
-const localTls = require('../server/local-tls.cjs');
-
-app.setName('Codex Continuer');
-const dataDir = runtimeConfig.dataDir;
-mkdirSync(dataDir, { recursive: true });
-logging.installLogs(dataDir, 'widget');
-app.setPath('userData', join(dataDir, 'desktop-profile'));
-const preferenceFile = join(dataDir, 'widget-preferences.json');
-let prefs = { follow: true, expanded: false, hidden: false, compactSize: 256, offsets: {}, positions: {} };
-try { prefs = { ...prefs, ...JSON.parse(readFileSync(preferenceFile, 'utf8')) }; } catch {}
-let preferenceError = null;
-const save = () => { try { writeFileSync(preferenceFile, JSON.stringify(prefs)); preferenceError = null; } catch (error) { preferenceError = error.message; console.error(`挂件设置未保存：${error.message}`); } };
-const port = runtimeConfig.port;
-const origin = `https://127.0.0.1:${port}`;
-let win, tray, widgetMenu, tracker, anchor, pointerDrag, isReady = false, targetVisible = false, closing = false, lastDiagnostic, lastSentState, menuOpen = false, dragging = false, boundsTimer;
-let panelSize = { width: sizes.expanded.width - 18, height: sizes.expanded.height - 18 };
-let settledPlacement, restoringMode=false;
-let pendingTransition, transitionSequence=0, renderedExpanded=prefs.expanded;
-const mode = () => prefs.expanded ? 'expanded' : 'compact';
-const placementContext = () => ({ mode:mode(),follow:prefs.follow,compactSize:compactSize(prefs.compactSize),anchor:anchor ? {...anchor} : null });
-if (process.argv.includes('--auto')) prefs.hidden = false;
-function diagnostics() {
- if (!win || win.isDestroyed() || dragging || pointerDrag?.active) return;
- const next = JSON.stringify({ ...runtimeConfig.appInfo(), pid: process.pid, ready: isReady, visible: win.isVisible(), ...state(), bounds: win.getBounds() });
- if (next !== lastDiagnostic) { lastDiagnostic = next; try { writeFileSync(join(dataDir, 'widget-status.json'), next); } catch (error) { console.error(`挂件诊断未保存：${error.message}`); } }
-}
-const ownsInstance = app.requestSingleInstanceLock();
-let quitting, shutdownComplete = false;
-if (!ownsInstance) { app.quit(); }
-else if (process.argv.includes('--quit')) { app.whenReady().then(quitAll); }
-else {
- app.on('second-instance', (_event, argv) => { if (argv.includes('--quit')) { void quitAll(); return; } if (closing) return; prefs.hidden = false; if (!argv.includes('--auto')) changeExpanded(true); save(); show(!argv.includes('--auto')); });
- app.whenReady().then(start).catch(error => { dialog.showErrorBox('Continuer 启动失败', error.message); app.quit(); });
-}
-function quitAll() {
- if (quitting) return quitting;
- closing = true; isReady = false;
- pointerDrag?.finish(); cancelTransition(); tracker?.kill(); win?.hide();
- try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: process.pid, ready: false, exitReason: 'quitting', updatedAt: Date.now() })); } catch {}
- quitting = (async () => {
- try {
- const runtime = await import('../plugin/runtime.js');
- const { stopBackground } = await import('../plugin/shutdown.js');
- await stopBackground({ root: runtime.root, dataDir, request: runtime.request, demo: process.env.CONTINUER_DEMO === '1' });
- } catch (error) { console.error('退出后台进程失败：' + error.message); }
- finally { shutdownComplete = true; app.quit(); }
- })();
- return quitting;
-}
-function state() { return { follow: prefs.follow, expanded: prefs.expanded, hidden: prefs.hidden, preferenceError, tracking: !!anchor, visible: !!win?.isVisible(), compactSize: compactSize(prefs.compactSize), transitioning: !!boundsTimer, transition: pendingTransition ? {id:pendingTransition.id,fromExpanded:pendingTransition.fromExpanded} : null, panelSize, platform: process.platform }; }
-function cancelTransition() {
- clearTimeout(boundsTimer); boundsTimer=null; pendingTransition=null;
-}
-function finishTransition(id=pendingTransition?.id) {
- if (!pendingTransition || pendingTransition.id!==id || !win || win.isDestroyed()) return;
- const transition=pendingTransition;
- cancelTransition();
- // Change native geometry only after the outgoing view has faded away.
- win.setBounds(transition.next,false);
- renderedExpanded=prefs.expanded;
- transition.settle(); sendState(); diagnostics();
-}
-function sendState() {
- if (!isReady || win.isDestroyed()) return;
- const next = state(), serialized = JSON.stringify(next);
- if (serialized !== lastSentState) { lastSentState = serialized; win.webContents.send('continuer:state', next); }
-}
-function position(animate = false) {
- if (!win || win.isDestroyed() || dragging || pointerDrag?.active || (boundsTimer && !animate)) return;
- // A user drop is authoritative. Do not snap it back to the work area, resize
- // it, or reinterpret it on an unchanged tracker tick.
- if (samePlacementContext(settledPlacement,placementContext())) return;
- const positionedContext=placementContext();
- const settle = () => { restoringMode=false; settledPlacement=positionedContext; };
- const current = win.getBounds();
- const saved = prefs.positions[mode()];
- const following = prefs.follow && anchor;
- const target = following ? anchor : { ...(saved || current), width: (saved || current).width + 16, height: (saved || current).height + 16 };
- const size = prefs.expanded ? sizes.expanded : { width: compactSize(prefs.compactSize), height: compactSize(prefs.compactSize) };
- const offset = prefs.follow && anchor ? (prefs.offsets[mode()] || prefs.offsets[prefs.expanded ? 'compact' : 'expanded']) : undefined;
- const desired = { x: target.x + target.width - size.width - (offset?.right ?? 16), y: target.y + target.height - size.height - (offset?.bottom ?? 16), ...size };
- const display = screen.getDisplayMatching(desired);
- panelSize = { width: Math.min(sizes.expanded.width,display.workArea.width)-18, height: Math.min(sizes.expanded.height,display.workArea.height)-18 };
- if (!prefs.expanded) size.width=size.height=Math.min(size.width,display.workArea.width,display.workArea.height);
- let next = following ? place(target, display.workArea, size, offset) : placeIndependent(saved,current,display.workArea,size);
- if (restoringMode) {
- const remembered=following ? (prefs.offsets[mode()] ? {x:target.x+target.width-next.width-offset.right,y:target.y+target.height-next.height-offset.bottom} : null) : saved;
- next=restoreModePosition(next,remembered,display.workArea);
- }
- // Windows fractional DPI can round a 432 DIP window to 433 on readback.
- if (Object.keys(next).some(key => Math.abs(current[key] - next[key]) > 1)) {
- cancelTransition();
- if (!animate || !win.isVisible()) { win.setBounds(next,false); renderedExpanded=prefs.expanded; settle(); }
- else {
- const id=++transitionSequence;
- pendingTransition={id,next,settle,fromExpanded:renderedExpanded};
- // Renderer acknowledges opacity=0; the timeout also handles hidden,
- // reloading, or reduced-motion renderers without leaving a stuck view.
- boundsTimer=setTimeout(()=>finishTransition(id),240);
- }
- } else { cancelTransition(); renderedExpanded=prefs.expanded; settle(); }
-}
-function show(force = false, animate = false) {
- if (!win || !isReady) return;
- // Tracking still records the latest anchor, but must not query/mutate the
- // window, send renderer state, or write diagnostics during a user drag.
- if (!force && !prefs.hidden && (dragging || pointerDrag?.active)) return;
- position(animate);
- if (!prefs.hidden && (force || menuOpen || !prefs.follow || targetVisible || win.isFocused())) {
- if (!win.isVisible()) win.showInactive();
- if (force) win.focus();
- } else win.hide();
- sendState(); diagnostics();
-}
-function beginDrag() {
- cancelTransition();
- dragging = true;
-}
-function savePosition() {
- const bounds = win.getBounds();
- prefs.positions[mode()] = bounds;
- if (prefs.follow && anchor) prefs.offsets[mode()] = offsetFrom(anchor,bounds);
- settledPlacement=placementContext();
- save(); diagnostics();
-}
-function finishDrag() {
- if (!dragging) return;
- dragging = false; savePosition();
-}
-function changeExpanded(expanded) {
- if (prefs.expanded === expanded) return;
- pointerDrag?.finish();
- // Record the departing mode only after its layout has settled. Never save
- // an intermediate animation rectangle as a compact or expanded position.
- if (isReady && win && !win.isDestroyed() && !boundsTimer && !dragging) {
- const bounds=win.getBounds();
- const size=prefs.expanded ? sizes.expanded : {width:compactSize(prefs.compactSize),height:compactSize(prefs.compactSize)};
- if (bounds.width<=size.width+2 && bounds.height<=size.height+2) {
- prefs.positions[mode()]=bounds;
- if (prefs.follow && anchor) prefs.offsets[mode()]=offsetFrom(anchor,bounds);
- }
- }
- // A remembered compact drop must not suppress a later expanded -> compact
- // layout, nor may a cancelled animation resume after a rapid reverse toggle.
- cancelTransition();
- settledPlacement=null;
- restoringMode=true;
- dragging=false;
- prefs.expanded=expanded;
-}
-function syncTracker() {
- if (process.platform !== 'win32') { prefs.follow = false; return; }
- if (!prefs.follow) {
- const previous = tracker; tracker = null;
- previous?.kill();
- anchor = null; targetVisible = false;
- return;
- }
- if (tracker) return;
- const native = join(__dirname, 'continuer-monitor.exe');
- const command = existsSync(native) ? native : 'powershell.exe';
- const args = command === native ? ['--track', String(process.pid)] : ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', join(__dirname, 'follow-window.ps1'), '-WidgetPid', String(process.pid)];
- const child = tracker = spawn(command, args, { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
- child.stderr.resume();
- const lines = createInterface({ input: child.stdout });
- lines.on('line', line => {
- if (tracker !== child || closing) return;
- try {
- const result = JSON.parse(line);
- targetVisible = !!result.visible;
- anchor = result.found ? screen.screenToDipRect(null, { x: result.x, y: result.y, width: result.width, height: result.height }) : null;
- show();
- } catch {}
- });
- const ended = () => {
- lines.close();
- if (tracker !== child) return;
- tracker = null;
- if (!closing) { prefs.follow = false; anchor = null; targetVisible = false; show(true); }
- };
- child.on('error', ended);
- child.on('exit', ended);
-}
-async function start() {
- const runtime = await import('../plugin/runtime.js');
- await runtime.ensureService();
- const display = screen.getPrimaryDisplay().workArea;
- win = new BrowserWindow({ x: display.x + display.width - sizes.compact.width - 16, y: display.y + display.height - sizes.compact.height - 16, ...sizes.compact, show: false, alwaysOnTop: false, frame: false, thickFrame: false, roundedCorners: false, transparent: true, backgroundColor: '#00000000', resizable: false, skipTaskbar: true, hasShadow: false, autoHideMenuBar: true, title: 'Codex Continuer Widget', webPreferences: { preload: join(__dirname, 'preload.cjs'), contextIsolation: true, nodeIntegration: false, sandbox: true, devTools: false } });
- win.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
- win.webContents.on('console-message', details => { if (details.level === 'error') console.error('挂件页面错误：' + details.message.slice(0, 2000)); });
- for (const name of ['will-navigate', 'will-redirect']) win.webContents.on(name, (event, url) => { if (url !== origin + '/widget') event.preventDefault(); });
- win.webContents.session.setPermissionRequestHandler((_contents, _permission, callback) => callback(false));
- const pinned = localTls.readIdentity(dataDir, process.env.CONTINUER_DEMO === '1').certificate;
- win.webContents.session.setCertificateVerifyProc((request, callback) => {
- callback(request.hostname === '127.0.0.1' && localTls.matchesCertificate(request.certificate.data, pinned) ? 0 : -2);
- });
- // Keep the native credential in the main process and never attach it to
- // another window, origin, static asset or redirected request.
- win.webContents.session.webRequest.onBeforeSendHeaders({ urls: [origin + '/api/*'] }, (details, callback) => {
- try {
- const token = runtime.readAccessToken();
- if (details.webContentsId === win.webContents.id && new URL(details.url).origin === origin && token) details.requestHeaders.Authorization = 'Bearer ' + token;
- callback({ requestHeaders: details.requestHeaders });
- } catch { callback({ cancel: true }); }
- });
- win.on('close', event => { if (!shutdownComplete) { event.preventDefault(); void quitAll(); } });
- // will-move is emitted for native user dragging, not our setBounds calls.
- win.on('will-move', () => { if (!dragging && !pointerDrag.active) beginDrag(); });
- win.on('moved', () => { if (dragging && !pointerDrag.active) finishDrag(); });
- pointerDrag = createPointerDrag({
- getCursor: () => screen.getCursorScreenPoint(),
- getBounds: () => win.getBounds(),
- // setPosition can accumulate fractional-DPI size rounding on every move.
- setPosition: (x,y,bounds) => win.setBounds({ x,y,width:bounds.width,height:bounds.height },false),
- onMove: cancelTransition,
- onFinish: moved => { if (moved) savePosition(); },
- });
- win.on('blur', () => pointerDrag.finish());
- win.on('hide', () => { pointerDrag.finish(); finishTransition(); });
- let rendererRestarts = 0;
- win.webContents.on('render-process-gone', (_event, detail) => {
- pointerDrag.finish(); isReady = false; lastDiagnostic = null; lastSentState = null;
- try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: process.pid, ready: false, exitReason: `renderer-${detail.reason}` })); } catch {}
- if (!closing && rendererRestarts++ < 3) setTimeout(() => { if (!closing && !win.isDestroyed()) win.reload(); }, 1000 * rendererRestarts);
- });
- win.webContents.on('did-finish-load', () => { if (isReady) show(); });
- const allowed = event => event.sender === win.webContents && event.senderFrame.url === origin + '/widget';
- ipcMain.handle('continuer:control', (event, action, value) => {
- if (!allowed(event)) throw new Error('Untrusted widget request');
- if (action === 'renderer-ready') { isReady = true; show(); return state(); }
- if (action === 'quit') { setImmediate(() => { void quitAll(); }); return { quitting: true }; }
- if (action === 'transition-ready') { finishTransition(value); return state(); }
- if (action === 'drag-start') {
- if (!Number.isInteger(value) || prefs.expanded || boundsTimer || dragging) return { ok:false };
- return pointerDrag.start(value);
- }
- if (action === 'drag-end') return pointerDrag.finish(value?.id);
- if (action !== 'state') pointerDrag.finish();
- if (action === 'expand' && typeof value === 'boolean') changeExpanded(value);
- else if (action === 'follow' && typeof value === 'boolean') { prefs.follow = value; syncTracker(); }
- else if (action === 'hide') prefs.hidden = true;
- else if (action === 'reset-position') { settledPlacement=null; prefs.offsets = {}; prefs.positions = {}; }
- else if (action === 'compact-size' && Number.isFinite(value) && value >= 160 && value <= 420) prefs.compactSize=compactSize(value);
- else if (action === 'state') return state();
- else throw new Error('Unsupported action');
- save(); show(action === 'expand',action === 'expand' || action === 'compact-size'); return state();
- });
- ipcMain.handle('continuer:pick-directory', async event => {
- if (!allowed(event)) throw new Error('Untrusted widget request');
- const result = await dialog.showOpenDialog(win, { properties: ['openDirectory'], title: '选择工作项目目录' });
- return result.canceled ? null : result.filePaths[0];
- });
- tray = new Tray(nativeImage.createFromPath(join(__dirname, 'icon.png')));
- tray.setToolTip('Codex Continuer · 额度与持续工作');
- const reveal = () => { prefs.hidden = false; changeExpanded(true); save(); show(true,true); };
- widgetMenu = Menu.buildFromTemplate([
- { label: '打开额度与工作面板', click: reveal },
- { label: '跟随 Codex 窗口', click: () => { prefs.follow = true; prefs.hidden = false; syncTracker(); save(); show(); } },
- { label: '独立显示面板', click: () => { prefs.follow = false; syncTracker(); reveal(); } },
- { label: '重置挂件位置', click: () => { settledPlacement=null; prefs.offsets = {}; prefs.positions = {}; save(); show(true); } },
- { type: 'separator' },
- { label: '隐藏到托盘', click: () => { prefs.hidden = true; save(); show(); } },
- { label: '退出 Continuer', click: () => { void quitAll(); } },
- ]);
- const popupMenu = () => {
- if (menuOpen) return;
- pointerDrag.finish();
- menuOpen = true;
- widgetMenu.popup({ window: win, callback: () => { menuOpen = false; } });
- };
- tray.setContextMenu(widgetMenu);
- win.webContents.on('context-menu', (_event,params) => { if (!params.isEditable) popupMenu(); });
- win.on('system-context-menu', event => { event.preventDefault(); popupMenu(); });
- tray.on('click', reveal);
- globalShortcut.register('CommandOrControl+Alt+C', reveal);
- const displayChanged = () => { settledPlacement=null; show(); };
- screen.on('display-removed',displayChanged);
- screen.on('display-metrics-changed',displayChanged);
- syncTracker();
- await win.loadURL(origin + '/widget');
-}
-app.on('before-quit', event => {
- if (!ownsInstance) return;
- if (!shutdownComplete) { event.preventDefault(); void quitAll(); return; }
- closing = true; pointerDrag?.finish(); cancelTransition(); tracker?.kill(); globalShortcut.unregisterAll(); tray?.destroy();
- try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: process.pid, ready: false, exitReason: 'user-quit', updatedAt: Date.now() })); } catch {}
-});
-app.on('window-all-closed', () => app.quit());
+require('./runtime.cjs').createDesktopRuntime();
diff --git a/desktop/runtime.cjs b/desktop/runtime.cjs
new file mode 100644
index 0000000..c1139be
--- /dev/null
+++ b/desktop/runtime.cjs
@@ -0,0 +1,326 @@
+// Constructing a runtime makes its native dependencies and lifecycle explicit.
+function createDesktopRuntime({ load = require, processInfo = process, timing = globalThis, window } = {}) {
+ const { setTimeout, clearTimeout } = timing;
+ const { app, BrowserWindow, ipcMain, screen, Tray, Menu, nativeImage, globalShortcut, dialog } = load('electron');
+ const { spawn } = load('node:child_process');
+ const { createInterface } = load('node:readline');
+ const { join } = load('node:path');
+ const { readFileSync, writeFileSync, mkdirSync, existsSync } = load('node:fs');
+ const { place, placeIndependent, expandFromCard, offsetFrom, sizes, compactSize, samePlacementContext, restoreModePosition } = load('./geometry.cjs');
+ const { createPointerDrag } = load('./pointer-drag.cjs');
+ const runtimeConfig = load('../server/config.cjs');
+ const logging = load('../server/logging.cjs');
+ const localTls = load('../server/local-tls.cjs');
+
+ app.setName('Codex Continuer');
+ const dataDir = runtimeConfig.dataDir;
+ mkdirSync(dataDir, { recursive: true });
+ logging.installLogs(dataDir, 'widget');
+ app.setPath('userData', join(dataDir, 'desktop-profile'));
+ const preferenceFile = join(dataDir, 'widget-preferences.json');
+ let prefs = { follow: true, expanded: false, hidden: false, compactSize: 256, offsets: {}, positions: {} };
+ try { prefs = { ...prefs, ...JSON.parse(readFileSync(preferenceFile, 'utf8')) }; } catch {}
+ let preferenceError = null;
+ let nativeText = () => 'Codex Continuer', refreshMenu = () => {};
+ const save = () => { try { writeFileSync(preferenceFile, JSON.stringify(prefs)); preferenceError = null; } catch (error) { preferenceError = error.message; console.error(`挂件设置未保存：${error.message}`); } };
+ const port = runtimeConfig.port;
+ const origin = `https://127.0.0.1:${port}`;
+ let win = window, tray, widgetMenu, tracker, anchor, pointerDrag, isReady = !!window, targetVisible = false, closing = false, lastDiagnostic, lastSentState, menuOpen = false, dragging = false, boundsTimer;
+ let panelSize = { width: sizes.expanded.width - 18, height: sizes.expanded.height - 18 };
+ let settledPlacement, restoringMode=false, expansionOrigin=null;
+ let pendingTransition, transitionSequence=0, renderedExpanded=prefs.expanded;
+ const mode = () => prefs.expanded ? 'expanded' : 'compact';
+ const placementContext = () => ({ mode:mode(),follow:prefs.follow,compactSize:compactSize(prefs.compactSize),anchor:anchor ? {...anchor} : null });
+ if (processInfo.argv.includes('--auto')) prefs.hidden = false;
+ function diagnostics() {
+ if (!win || win.isDestroyed() || dragging || pointerDrag?.active) return;
+ const next = JSON.stringify({ ...runtimeConfig.appInfo(), pid: processInfo.pid, ready: isReady, visible: win.isVisible(), ...state(), bounds: win.getBounds() });
+ if (next !== lastDiagnostic) { lastDiagnostic = next; try { writeFileSync(join(dataDir, 'widget-status.json'), next); } catch (error) { console.error(`挂件诊断未保存：${error.message}`); } }
+ }
+ const ownsInstance = app.requestSingleInstanceLock();
+ let quitting, shutdownComplete = false;
+ if (!ownsInstance) { app.quit(); }
+ else if (processInfo.argv.includes('--quit')) { app.whenReady().then(quitAll); }
+ else {
+ app.on('second-instance', (_event, argv) => { if (argv.includes('--quit')) { void quitAll(); return; } if (closing) return; prefs.hidden = false; if (!argv.includes('--auto')) changeExpanded(true); save(); show(!argv.includes('--auto')); });
+ app.whenReady().then(start).catch(error => { dialog.showErrorBox(nativeText("native.continuer_could_not_start"), error.message); app.quit(); });
+ }
+ function quitAll() {
+ if (quitting) return quitting;
+ closing = true; isReady = false;
+ pointerDrag?.finish(); cancelTransition(); tracker?.kill(); win?.hide();
+ try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: processInfo.pid, ready: false, exitReason: 'quitting', updatedAt: Date.now() })); } catch {}
+ quitting = (async () => {
+ try {
+ const runtime = await import('../plugin/runtime.js');
+ await runtime.stopBackground();
+ } catch (error) { console.error('退出后台进程失败：' + error.message); }
+ finally { shutdownComplete = true; app.quit(); }
+ })();
+ return quitting;
+ }
+ function state() { return { follow: prefs.follow, expanded: prefs.expanded, hidden: prefs.hidden, preferenceError, tracking: !!anchor, visible: !!win?.isVisible(), compactSize: compactSize(prefs.compactSize), transitioning: !!boundsTimer, transition: pendingTransition ? {id:pendingTransition.id,fromExpanded:pendingTransition.fromExpanded} : null, panelSize, platform: processInfo.platform }; }
+ function cancelTransition() {
+ clearTimeout(boundsTimer); boundsTimer=null; pendingTransition=null;
+ }
+ function finishTransition(id=pendingTransition?.id) {
+ if (!pendingTransition || pendingTransition.id!==id || !win || win.isDestroyed()) return;
+ const transition=pendingTransition;
+ cancelTransition();
+ // Change native geometry only after the outgoing view has faded away.
+ win.setBounds(transition.next,false);
+ renderedExpanded=prefs.expanded;
+ transition.settle(); sendState(); diagnostics();
+ }
+ function sendState() {
+ if (!isReady || win.isDestroyed()) return;
+ const next = state(), serialized = JSON.stringify(next);
+ if (serialized !== lastSentState) { lastSentState = serialized; win.webContents.send('continuer:state', next); }
+ }
+ function position(animate = false) {
+ if (!win || win.isDestroyed() || dragging || pointerDrag?.active || (boundsTimer && !animate)) return;
+ // A user drop is authoritative. Do not snap it back to the work area, resize
+ // it, or reinterpret it on an unchanged tracker tick.
+ if (samePlacementContext(settledPlacement,placementContext())) return;
+ const positionedContext=placementContext();
+ const fromCard = restoringMode && prefs.expanded && expansionOrigin;
+ const settle = () => {
+ if (fromCard) {
+ const bounds = win.getBounds();
+ prefs.positions.expanded = bounds;
+ if (prefs.follow && anchor) prefs.offsets.expanded = offsetFrom(anchor,bounds);
+ expansionOrigin = null;
+ save();
+ }
+ restoringMode=false; settledPlacement=fromCard ? placementContext() : positionedContext;
+ };
+ const current = win.getBounds();
+ const saved = prefs.positions[mode()];
+ const following = prefs.follow && anchor;
+ const target = following ? anchor : { ...(saved || current), width: (saved || current).width + 16, height: (saved || current).height + 16 };
+ const size = prefs.expanded ? sizes.expanded : { width: compactSize(prefs.compactSize), height: compactSize(prefs.compactSize) };
+ const offset = prefs.follow && anchor ? (prefs.offsets[mode()] || prefs.offsets[prefs.expanded ? 'compact' : 'expanded']) : undefined;
+ const desired = { x: target.x + target.width - size.width - (offset?.right ?? 16), y: target.y + target.height - size.height - (offset?.bottom ?? 16), ...size };
+ const display = screen.getDisplayMatching(fromCard || desired);
+ panelSize = { width: Math.min(sizes.expanded.width,display.workArea.width)-18, height: Math.min(sizes.expanded.height,display.workArea.height)-18 };
+ if (!prefs.expanded) size.width=size.height=Math.min(size.width,display.workArea.width,display.workArea.height);
+ let next = fromCard ? expandFromCard(fromCard,display.workArea,size) : following ? place(target, display.workArea, size, offset) : placeIndependent(saved,current,display.workArea,size);
+ if (restoringMode && !fromCard) {
+ const remembered=following ? (prefs.offsets[mode()] ? {x:target.x+target.width-next.width-offset.right,y:target.y+target.height-next.height-offset.bottom} : null) : saved;
+ next=restoreModePosition(next,remembered,display.workArea);
+ }
+ // Windows fractional DPI can round a 432 DIP window to 433 on readback.
+ if (Object.keys(next).some(key => Math.abs(current[key] - next[key]) > 1)) {
+ cancelTransition();
+ if (!animate || !win.isVisible()) { win.setBounds(next,false); renderedExpanded=prefs.expanded; settle(); }
+ else {
+ const id=++transitionSequence;
+ pendingTransition={id,next,settle,fromExpanded:renderedExpanded};
+ // Renderer acknowledges opacity=0; the timeout also handles hidden,
+ // reloading, or reduced-motion renderers without leaving a stuck view.
+ boundsTimer=setTimeout(()=>finishTransition(id),240);
+ }
+ } else { cancelTransition(); renderedExpanded=prefs.expanded; settle(); }
+ }
+ function show(force = false, animate = false) {
+ if (!win || !isReady) return;
+ // Tracking still records the latest anchor, but must not query/mutate the
+ // window, send renderer state, or write diagnostics during a user drag.
+ if (!force && !prefs.hidden && (dragging || pointerDrag?.active)) return;
+ position(animate);
+ if (!prefs.hidden && (force || menuOpen || !prefs.follow || targetVisible || win.isFocused())) {
+ if (!win.isVisible()) win.showInactive();
+ if (force) win.focus();
+ } else win.hide();
+ sendState(); diagnostics();
+ }
+ function beginDrag() {
+ cancelTransition();
+ dragging = true;
+ }
+ function savePosition() {
+ const bounds = win.getBounds();
+ prefs.positions[mode()] = bounds;
+ if (prefs.follow && anchor) prefs.offsets[mode()] = offsetFrom(anchor,bounds);
+ settledPlacement=placementContext();
+ save(); diagnostics();
+ }
+ function finishDrag() {
+ if (!dragging) return;
+ dragging = false; savePosition();
+ }
+ function changeExpanded(expanded) {
+ if (prefs.expanded === expanded) return;
+ pointerDrag?.finish();
+ let origin = null;
+ // Record the departing mode only after its layout has settled. Never save
+ // an intermediate animation rectangle as a compact or expanded position.
+ if (isReady && win && !win.isDestroyed() && !boundsTimer && !dragging) {
+ const bounds=win.getBounds();
+ // Native dimensions can differ by several DIP during a display/DPI change.
+ // The committed view mode, rather than a size tolerance, tells us whether
+ // these are the departing mode's settled bounds.
+ if (renderedExpanded === prefs.expanded) {
+ prefs.positions[mode()]=bounds;
+ if (prefs.follow && anchor) prefs.offsets[mode()]=offsetFrom(anchor,bounds);
+ if (!prefs.expanded && !renderedExpanded) origin = bounds;
+ }
+ }
+ // A remembered compact drop must not suppress a later expanded -> compact
+ // layout, nor may a cancelled animation resume after a rapid reverse toggle.
+ cancelTransition();
+ settledPlacement=null;
+ restoringMode=true;
+ expansionOrigin=expanded ? origin : null;
+ dragging=false;
+ prefs.expanded=expanded;
+ }
+ function setFollow(value) { prefs.follow = value; syncTracker(); }
+ function syncTracker() {
+ if (processInfo.platform !== 'win32') { prefs.follow = false; return; }
+ if (!prefs.follow) {
+ const previous = tracker; tracker = null;
+ previous?.kill();
+ anchor = null; targetVisible = false;
+ return;
+ }
+ if (tracker) return;
+ const native = join(__dirname, 'continuer-monitor.exe');
+ const command = existsSync(native) ? native : 'powershell.exe';
+ const args = command === native ? ['--track', String(processInfo.pid)] : ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', join(__dirname, 'follow-window.ps1'), '-WidgetPid', String(processInfo.pid)];
+ const child = tracker = spawn(command, args, { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+ child.stderr.resume();
+ const lines = createInterface({ input: child.stdout });
+ lines.on('line', line => {
+ if (tracker !== child || closing) return;
+ try {
+ const result = JSON.parse(line);
+ targetVisible = !!result.visible;
+ anchor = result.found ? screen.screenToDipRect(null, { x: result.x, y: result.y, width: result.width, height: result.height }) : null;
+ show();
+ } catch {}
+ });
+ const ended = () => {
+ lines.close();
+ if (tracker !== child) return;
+ tracker = null;
+ if (!closing) { prefs.follow = false; anchor = null; targetVisible = false; show(true); }
+ };
+ child.on('error', ended);
+ child.on('exit', ended);
+ }
+ async function start() {
+ const { interfaceText } = await import('../public/i18n.js');
+ nativeText = text => interfaceText(text, prefs.language || 'zh');
+ const runtime = await import('../plugin/runtime.js');
+ await runtime.ensureService();
+ const display = screen.getPrimaryDisplay().workArea;
+ win = new BrowserWindow({ x: display.x + display.width - sizes.compact.width - 16, y: display.y + display.height - sizes.compact.height - 16, ...sizes.compact, show: false, alwaysOnTop: false, frame: false, thickFrame: false, roundedCorners: false, transparent: true, backgroundColor: '#00000000', resizable: false, skipTaskbar: true, hasShadow: false, autoHideMenuBar: true, title: 'Codex Continuer Widget', webPreferences: { preload: join(__dirname, 'preload.cjs'), contextIsolation: true, nodeIntegration: false, sandbox: true, devTools: false } });
+ win.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+ win.webContents.on('console-message', details => { if (details.level === 'error') console.error('挂件页面错误：' + details.message.slice(0, 2000)); });
+ for (const name of ['will-navigate', 'will-redirect']) win.webContents.on(name, (event, url) => { if (url !== origin + '/widget') event.preventDefault(); });
+ win.webContents.session.setPermissionRequestHandler((_contents, _permission, callback) => callback(false));
+ const pinned = localTls.readIdentity(dataDir, processInfo.env.CONTINUER_DEMO === '1').certificate;
+ win.webContents.session.setCertificateVerifyProc((request, callback) => {
+ callback(request.hostname === '127.0.0.1' && localTls.matchesCertificate(request.certificate.data, pinned) ? 0 : -2);
+ });
+ // Keep the native credential in the main process and never attach it to
+ // another window, origin, static asset or redirected request.
+ win.webContents.session.webRequest.onBeforeSendHeaders({ urls: [origin + '/api/*'] }, (details, callback) => {
+ try {
+ const token = runtime.readAccessToken();
+ if (details.webContentsId === win.webContents.id && new URL(details.url).origin === origin && token) details.requestHeaders.Authorization = 'Bearer ' + token;
+ callback({ requestHeaders: details.requestHeaders });
+ } catch { callback({ cancel: true }); }
+ });
+ win.on('close', event => { if (!shutdownComplete) { event.preventDefault(); void quitAll(); } });
+ // will-move is emitted for native user dragging, not our setBounds calls.
+ win.on('will-move', () => { if (!dragging && !pointerDrag.active) beginDrag(); });
+ win.on('moved', () => { if (dragging && !pointerDrag.active) finishDrag(); });
+ pointerDrag = createPointerDrag({
+ getCursor: () => screen.getCursorScreenPoint(),
+ getBounds: () => win.getBounds(),
+ // setPosition can accumulate fractional-DPI size rounding on every move.
+ setPosition: (x,y,bounds) => win.setBounds({ x,y,width:bounds.width,height:bounds.height },false),
+ onMove: cancelTransition,
+ onFinish: moved => { if (moved) savePosition(); },
+ });
+ win.on('blur', () => pointerDrag.finish());
+ win.on('hide', () => { pointerDrag.finish(); finishTransition(); });
+ let rendererRestarts = 0;
+ win.webContents.on('render-process-gone', (_event, detail) => {
+ pointerDrag.finish(); isReady = false; lastDiagnostic = null; lastSentState = null;
+ try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: processInfo.pid, ready: false, exitReason: `renderer-${detail.reason}` })); } catch {}
+ if (!closing && rendererRestarts++ < 3) setTimeout(() => { if (!closing && !win.isDestroyed()) win.reload(); }, 1000 * rendererRestarts);
+ });
+ win.webContents.on('did-finish-load', () => { if (isReady) show(); });
+ const allowed = event => event.sender === win.webContents && event.senderFrame.url === origin + '/widget';
+ ipcMain.handle('continuer:control', (event, action, value) => {
+ if (!allowed(event)) throw new Error('Untrusted widget request');
+ if (action === 'language' && ['zh', 'en'].includes(value)) { if (prefs.language !== value) { prefs.language = value; save(); refreshMenu(); } return state(); }
+ if (action === 'renderer-ready') { isReady = true; show(); return state(); }
+ if (action === 'quit') { setImmediate(() => { void quitAll(); }); return { quitting: true }; }
+ if (action === 'transition-ready') { finishTransition(value); return state(); }
+ if (action === 'drag-start') {
+ if (!Number.isInteger(value) || prefs.expanded || boundsTimer || dragging) return { ok:false };
+ return pointerDrag.start(value);
+ }
+ if (action === 'drag-end') return pointerDrag.finish(value?.id);
+ if (action !== 'state') pointerDrag.finish();
+ if (action === 'expand' && typeof value === 'boolean') changeExpanded(value);
+ else if (action === 'follow' && typeof value === 'boolean') setFollow(value)
+ else if (action === 'hide') prefs.hidden = true;
+ else if (action === 'reset-position') { settledPlacement=null; prefs.offsets = {}; prefs.positions = {}; }
+ else if (action === 'compact-size' && Number.isFinite(value) && value >= 160 && value <= 420) prefs.compactSize=compactSize(value);
+ else if (action === 'state') return state();
+ else throw new Error('Unsupported action');
+ save(); show(action === 'expand',action === 'expand' || action === 'compact-size'); return state();
+ });
+ ipcMain.handle('continuer:pick-directory', async event => {
+ if (!allowed(event)) throw new Error('Untrusted widget request');
+ const result = await dialog.showOpenDialog(win, { properties: ['openDirectory'], title: nativeText("native.select_project_directory") });
+ return result.canceled ? null : result.filePaths[0];
+ });
+ tray = new Tray(nativeImage.createFromPath(join(__dirname, 'icon.png')));
+ const reveal = () => { prefs.hidden = false; changeExpanded(true); save(); show(true,true); };
+ refreshMenu = () => {
+ tray.setToolTip(nativeText("native.codex_continuer_quota_and_continuous_work"));
+ widgetMenu = Menu.buildFromTemplate([
+ { label: nativeText("native.open_quota_and_work_panel"), click: reveal },
+ { label: nativeText("native.follow_codex_window"), click: () => { prefs.hidden = false; setFollow(true); save(); show(); } },
+ { label: nativeText("native.show_independently"), click: () => { setFollow(false); reveal(); } },
+ { label: nativeText("ui.reset_widget_position"), click: () => { settledPlacement=null; prefs.offsets = {}; prefs.positions = {}; save(); show(true); } },
+ { type: 'separator' },
+ { label: nativeText("native.hide_to_tray"), click: () => { prefs.hidden = true; save(); show(); } },
+ { label: nativeText("ui.quit_continuer"), click: () => { void quitAll(); } },
+ ]);
+ tray.setContextMenu(widgetMenu);
+ };
+ refreshMenu();
+ const popupMenu = () => {
+ if (menuOpen) return;
+ pointerDrag.finish();
+ menuOpen = true;
+ widgetMenu.popup({ window: win, callback: () => { menuOpen = false; } });
+ };
+ win.webContents.on('context-menu', (_event,params) => { if (!params.isEditable) popupMenu(); });
+ win.on('system-context-menu', event => { event.preventDefault(); popupMenu(); });
+ tray.on('click', reveal);
+ globalShortcut.register('CommandOrControl+Alt+C', reveal);
+ const displayChanged = () => { settledPlacement=null; show(); };
+ screen.on('display-removed',displayChanged);
+ screen.on('display-metrics-changed',displayChanged);
+ syncTracker();
+ await win.loadURL(origin + '/widget');
+ }
+ app.on('before-quit', event => {
+ if (!ownsInstance) return;
+ if (!shutdownComplete) { event.preventDefault(); void quitAll(); return; }
+ closing = true; pointerDrag?.finish(); cancelTransition(); tracker?.kill(); globalShortcut.unregisterAll(); tray?.destroy();
+ try { writeFileSync(join(dataDir, 'widget-status.json'), JSON.stringify({ ...runtimeConfig.appInfo(), pid: processInfo.pid, ready: false, exitReason: 'user-quit', updatedAt: Date.now() })); } catch {}
+ });
+ app.on('window-all-closed', () => app.quit());
+ return { changeExpanded, finishTransition, show, savePosition, state, setFollow, get preferences() { return prefs; } };
+}
+
+module.exports = { createDesktopRuntime };
diff --git a/docs/README.md b/docs/README.md
index 07b0bf2..39f48de 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -9,6 +9,11 @@
| [支持范围](compatibility.md) | Windows x64 预览版、只读诊断、外部版本与尚未完成的验收 |
| [便携包安装](portable.md) | 二进制包安装、卸载及源码配套要求 |
| [按需加载与代码结构](loading-and-structure.md) | 隐藏视图停订阅、HTTP 模块拆分、冗余代码与一次性脚本清理；226 项回归 |
+| [Manager 职责拆分](manager-responsibilities.md) | 调度协调、状态保存及 Codex 轮次协议的组件边界 |
+| [两种任务的状态模型](task-models.md) | 多轮工作与额度监测的独立状态、计数、操作和旧数据迁移 |
+| [完整页面与挂件的共享界面](shared-interface.md) | 共用请求、任务状态、卡片、详情和表单，以及界面行为回归 |
+| [消息标识与模块测试入口](message-contracts.md) | 固定消息标识、兼容字段、旧文本处理和正式模块入口测试 |
+| [启动与退出的运行边界](runtime-lifecycle.md) | 共享身份核验、并发启动、就绪等待、退出与手动重开 |
| [第三轮审查与修复](project-evaluation-round3.md) | 7 类问题已修复，213 项回归通过；授权、在途发送、异步轮次及中文输入 |
| [第二轮评估](project-evaluation-round2.md) | 6 项缺陷及详情缓存优化已修复，195 项回归通过；保留修复前证据 |
| [项目评估](project-evaluation.md) | 功能、架构、12 项评估与修复进展、测试及优化路线 |
diff --git a/docs/manager-responsibilities.md b/docs/manager-responsibilities.md
new file mode 100644
index 0000000..7f7f84c
--- /dev/null
+++ b/docs/manager-responsibilities.md
@@ -0,0 +1,32 @@
+# Manager 职责拆分
+
+版本：0.5.1。日期：2026-10-29。
+
+`server/manager.js` 保留服务对外入口，负责额度采样、调度准入、任务操作和组件协调。原先集中在 Manager 中的数据迁移、保存与 Codex 轮次协议分别交给以下模块。
+
+| 模块 | 负责内容 | 协作边界 |
+| --- | --- | --- |
+| `server/state-lifecycle.js` | 默认状态、完成记录清理，以及按模式分发迁移和恢复转换 | 只转换传入的数据，不调用 RPC、保存文件或开启调度 |
+| `server/direct-task.js`、`server/monitor-task.js` | 各模式的创建、状态、计数、操作、校验和恢复规则 | 通过 `server/task-model.js` 选择规则；模式说明见 [两种任务的状态模型](task-models.md) |
+| `server/state-persistence.js` | 当前状态、保存健康信息、250 毫秒输出合并、立即提交、保存重试与备份替换 | 通过 Store 完成文件操作；保存失败先关闭调度，再通知协调层使旧调度失效 |
+| `server/turn-controller.js` | 轮次启动、启动前事件缓存、轮次 ID 校验、输出与完成事件、授权和中断 | 自行管理执行与授权映射；使用明确注入的调度、额度、保存和通知接口，不接收 Manager 对象 |
+| `server/manager.js` | 用户操作、额度采样、调度周期和恢复前的运行检查 | 组装组件，保持 HTTP、MCP、健康检查及状态快照使用的现有接口 |
+
+状态由 StatePersistence 持有。恢复备份会替换状态对象，轮次处理每次读取当前对象，避免继续修改已替换的旧任务。恢复时同时取消旧的延迟保存定时器。
+
+保存失败后，未保存标记仍然保留。授权操作先立即提交，再发送决定；额度恢复消息仍由原有发送路径在发送前保存记录。重启后正在执行的工作等待人工确认，发送结果不确定的记录继续阻止自动重复发送。两种任务模式、额度阈值及发送策略沿用原有规则。
+
+## 验证
+
+在独立的 0.5.1 源码目录中，以本次改动前的提交加上职责拆分源码运行完整回归，避免工作区同时进行的其他功能改动影响基线：**292 项通过，0 失败、0 跳过**。语法检查和公开源码检查通过。
+
+新增 `tests/manager-components.test.js`，在不实例化 Manager 的情况下验证：
+
+- 旧 writer 冲突记录的迁移、计数保留与重复迁移稳定性。
+- 启动迁移保存失败时，错误可见且调度被关闭。
+- 备份替换取消待执行保存，轮次事件只更新恢复后的当前状态。
+- 独立轮次组件的授权隔离、保存失败时保留请求，以及先保存后发送决定的顺序。
+
+既有回归继续覆盖暂停期间的并发事件、过期轮次、启动事件溢出、断线重连、授权范围、发送防重、输出合并、HTTP 集成及真实隐藏 Electron 窗口。测试使用独立数据和模拟 RPC／消息通道。
+
+验证源码保存在本地 `.cache/manager-refactor-0.5.1/`；不构建或安装新版本。
diff --git a/docs/message-contracts.md b/docs/message-contracts.md
new file mode 100644
index 0000000..16c60f8
--- /dev/null
+++ b/docs/message-contracts.md
@@ -0,0 +1,48 @@
+# 消息标识与模块测试入口
+
+版本：0.5.1。日期：2026-10-29。
+
+界面和服务提示通过固定消息标识取译文，不再根据中文字符串、前后缀或正则猜测含义。修改中文文案只需修改词条内容；调用处的标识和英文译文不受影响。
+
+| 模块 | 职责 |
+| --- | --- |
+| `public/messages.js` | 界面文案的中英文词条 |
+| `public/system-messages.js` | 服务状态、日志和错误的中英文词条 |
+| `public/message.js` | 构造、校验、格式化及限制消息参数；生成兼容的活动、日志和错误字段 |
+| `public/i18n.js` | 当前语言、显式静态标记、表单错误与语言切换 |
+| `public/api-client.js` | 将 HTTP 错误的消息标识保留到界面错误对象 |
+
+## 字段与兼容
+
+消息采用 `{ id, params }`。例如 `message('error.setting_range', { name: 'maxWakeSends', min: 1, max: 100 })`。参数只能包含声明的名称，值可以是文本、有限数字、布尔值、null 或有深度限制的嵌套消息。用户提供的名称、备注、输出和错误详情作为参数时保持原文。
+
+现有文本字段继续保留中文文本，供旧调用方和直接检查数据使用；新增可选字段负责翻译：
+
+| 数据 | 文本字段 | 消息字段 |
+| --- | --- | --- |
+| 任务活动 | `activity` | `activityMessage` |
+| 日志、连接、存储状态 | `message` | `messageInfo` |
+| HTTP 错误 | `error` | `errorInfo` |
+| 精简列表提示 | `summaryNotice` | `summaryNoticeInfo` |
+
+标识和参数随任务和日志一起保存。列表摘要限制消息参数长度，完整详情仍走原有接口；消息字段变化会更新详情修订号。内部错误继续通过 HTTP 错误策略隐藏，只有允许的提示和参数能够返回客户端。
+
+旧数据、未知标识及外部诊断没有有效消息标识时显示原文，不根据中文反推类别。新模型输出替换系统活动时会清除旧消息字段，避免套用上一次活动的译文。语言切换不会改写任务名称、备注、自定义续作消息或模型输出，也不会重新发送消息。
+
+静态 HTML 使用 `data-i18n` 和 `data-i18n-title`、`data-i18n-aria-label`、`data-i18n-placeholder` 标记。动态组件直接调用 `t(id, params)`；组件中的 HTML 结构不进入翻译词条。
+
+## 测试入口
+
+`mountPage(environment)`、`mountWidget(environment)` 接收 DOM、时间、请求和消息源，浏览器加载时仍自动挂载。测试直接导入并调用相同入口。`discardLegacyAccess()` 独立处理旧凭据清理；`desktop/runtime.cjs` 的 `createDesktopRuntime()` 明确接收原生依赖、运行环境、计时器和已有窗口，由 `desktop/main.cjs` 负责启动。
+
+页面、访问清理、桌面布局以及真实窗口展开测试均不再读取、改写或拼接生产 JavaScript 来暴露私有函数。原生窗口验收继续使用真实 Electron 几何计算；测试窗口和数据独立，沙箱保持开启。
+
+`tests/message-contracts.test.js` 覆盖词条参数一致性、中文文案变化、用户文本保留、无效消息、嵌套参数限制、HTTP 错误往返、显式静态标记、真实存储重启、摘要限制和详情修订。现有语言测试和回复检查测试改为检查消息契约及实际运行结果。
+
+固定源码验证目录：`.cache/message-contract-refactor-0.5.1/`。双语界面验收报告与截图：`.cache/message-contract-ui-qa-0.5.1/`。本轮只保存源码和本地提交。
+
+## 验证结果
+
+新增 10 项消息契约回归。最终固定源码以两个测试文件并发运行，**331 项通过，0 失败、0 跳过**；语法、公开源码和差异空白检查通过。工作区与验证副本的修改文件已逐项比对哈希。
+
+完整页面、挂件各自的中文和英文共 4 组真实隐藏 Electron 窗口验收通过，检查系统活动按标识翻译、卡片与表单布局、详情编辑，以及语言往返切换时草稿、焦点和光标保留。截图已核对；桌面启动、退出和原生窗口反复展开也通过隔离回归。未安装新版本，未启动真实任务或发送聊天消息。
diff --git a/docs/project-evaluation.md b/docs/project-evaluation.md
index 9e64f44..e674859 100644
--- a/docs/project-evaluation.md
+++ b/docs/project-evaluation.md
@@ -46,7 +46,7 @@ Continuer 已经具备个人日常使用的完整功能闭环：查看额度、
| --- | --- | --- |
| 创建方式 | 新建工作 | 导入已有聊天 |
| 执行端 | Continuer 自己的 `codex app-server` | 原聊天的桌面执行端 |
-| 接续方式 | `thread/start/resume`、`turn/start` | CLI 队列发送固定消息“继续” |
+| 接续方式 | `thread/start/resume`、`turn/start` | CLI 队列发送自定义续作消息，留空发送“继续”（0.5.0-preview） |
| 启动条件 | 开启调度、任务排队、真实额度达标 | 先观察到额度耗尽，再观察到恢复且达标 |
| 用户输入 | 目标进入实际执行提示词 | 可选本地监测备注，不发送 |
| 上限 | maxRounds，直接执行轮次 | maxWakeSends，每条记录累计确认排队次数 |
diff --git a/docs/runtime-lifecycle.md b/docs/runtime-lifecycle.md
new file mode 100644
index 0000000..52e3a38
--- /dev/null
+++ b/docs/runtime-lifecycle.md
@@ -0,0 +1,55 @@
+# 启动与退出的运行边界
+
+版本：0.5.1。日期：2026-10-29。
+
+插件命令、MCP 与 Electron 通过同一个运行时接口启动和停止。入口不再各自解释端口身份、构建、目录与就绪状态；生命周期流程集中管理，主机依赖由适配器提供。
+
+| 模块 | 职责 |
+| --- | --- |
+| `plugin/runtime.js` | 绑定本机配置、凭据、证书、日志文件、进程创建与退出标记；对外保留原有接口并提供明确启动和停止方法 |
+| `plugin/lifecycle.js` | 组织服务启动、挂件就绪、监听器恢复、显式重开和完整退出；合并同一进程中的并发操作 |
+| `plugin/local-client.js` | 固定本地 TLS 请求、消息错误、目录规范化及服务身份校验 |
+| `plugin/shutdown.js` | 写入退出标记，停止监听器，请求正常关闭，最后按所属路径核验后清理进程 |
+
+```mermaid
+flowchart LR
+ MCP[MCP 查询] --> Runtime[运行时接口]
+ CLI[命令行入口] --> Runtime
+ Desktop[Electron 入口] --> Runtime
+ Runtime --> Lifecycle[生命周期协调]
+ Lifecycle --> Client[本地请求与身份校验]
+ Client --> Service[后台 HTTPS 服务]
+ Lifecycle --> Host[主机进程适配]
+ Host --> Widget[Electron 挂件]
+ Host --> Watcher[原生监听器]
+```
+
+后台服务负责无窗口时的额度与任务处理；Electron 负责挂件；原生监听器负责桌面跟随和自动打开。RPC 与队列仍属于任务执行层，不参与挂件就绪判定。本次收敛入口和生命周期契约，不改变任务调度与发送路径。
+
+## 入口契约
+
+- `ensureService()` 是被动查询：检查退出标记，复用当前服务，必要时以 `--observe-only` 冷启动。不会清除退出标记或开启保存的调度。
+- `startService()` 是明确启动：等待正在进行的完整退出，清除当前模式的退出标记，再进入查询模式。
+- `openWidget({ automatic })` 自动打开时遵守退出标记；手动打开时等待退出完成并清除标记。先确认服务，再启动挂件并等待真实就绪状态；手动打开按既有偏好恢复监听器。
+- `stopService()` 只请求当前数据目录的服务关闭，保留命令行停止入口既有含义；服务不在时不启动它。
+- `stopBackground()` 是挂件完整退出：沿用退出标记、监听器清理、正常关闭和所属进程核验流程。同一运行时中的并发退出共用一次流程。
+
+并发服务查询共用一次启动。并发打开共用一个挂件启动与就绪等待；手动打开加入自动打开时只恢复一次监听器。完整退出会使旧启动代次失效，重开创建新的启动代次；旧服务响应和挂件等待不能被新请求复用，也不能清除新一轮的等待状态。
+
+## 身份、时间与故障
+
+服务查询和冷启动就绪检查均核验应用标识、协议、构建和规范化数据目录。命令行停止允许关闭同数据目录的旧构建，便于升级；挂件完整退出额外要求源码或安装根目录一致。进程强制清理继续使用既有 PowerShell 路径核验，不依赖单个端口或 PID。
+
+只有未创建本地 TLS 身份或明确连接拒绝才触发启动；身份不匹配、TLS 错误、访问拒绝和其他网络错误直接返回。请求继续使用固定证书，每次请求重新读取当前凭据及 TLS 身份，不将凭据发送到其他来源。
+
+常规 API 请求保留 35 秒超时。启动探测单次最多 2 秒；冷启动后的就绪等待使用 18 秒总预算，每次探测受剩余预算约束。挂件保留原来的 60 次、间隔 150 ms 检查，需满足当前构建、真实存活进程和首屏就绪条件。创建进程失败直接返回错误，失败后后续明确请求可重试。
+
+构造生命周期不读写文件、不启动进程；执行时所有主机操作由注入的适配器完成。测试通过正式构造函数注入请求、启动器、诊断、时钟和退出标记。运行时错误提供稳定错误代码及消息标识，调用方不依靠中文文本分类。
+
+## 验证
+
+新增 `tests/runtime-lifecycle.test.js` 与 `tests/local-client.test.js` 共 23 项检查，覆盖并发启动与打开、启动与退出交叉、重新打开、旧代次响应和等待隔离、主机同步停机通知、身份及构建不符、就绪超时、进程创建失败、监听器归属与回退、旧构建停止、凭据更新和消息参数传递。
+
+完整回归使用固定源码目录 `.cache/runtime-lifecycle-refactor-0.5.1/`。真实服务冷启动继续采用独立数据与模拟 RPC/消息通道，桌面验收使用隐藏 Electron 窗口。未运行安装器或更换用户正在使用的插件。
+
+最终固定源码以两个测试文件并发运行：**354 项通过，0 失败、0 跳过**。语法检查、公开源码检查及差异空白检查通过，工作区与验证副本的 13 个修改文件已逐项核对哈希。完整回归包含真实 MCP 冷启动、跨数据目录拒绝、退出标记、所属进程清理、隐藏窗口就绪与退出，以及原生窗口反复展开；测试未启动真实任务或发送聊天消息。
diff --git a/docs/shared-interface.md b/docs/shared-interface.md
new file mode 100644
index 0000000..899a978
--- /dev/null
+++ b/docs/shared-interface.md
@@ -0,0 +1,37 @@
+# 完整页面与挂件的共享界面
+
+版本：0.5.1。日期：2026-10-29。
+
+完整页面和挂件继续使用各自的布局、导航和窗口交互。请求策略、任务状态与操作判断、任务内容和工作表单集中在共享模块中维护。
+
+| 模块 | 职责 |
+| --- | --- |
+| `public/api-client.js` | 创建 JSON 请求客户端；统一凭据策略、重定向限制、写请求标记、服务错误和 35 秒超时 |
+| `public/task-view.js` | 任务状态文字、暂停或继续按钮、结束操作条件、进度值；两种布局的卡片和详情，以及共用的备注、续作消息和输出内容 |
+| `public/task-forms.js` | 新建工作与导入监测表单；共用字段、限制和提示，保留布局、目录选择和按钮样式的差异 |
+| `public/html.js` | 统一转义用户文本与属性值 |
+| `public/icons.js` | 现有 SVG 图标集合 |
+| `public/app.js`、`public/widget.js` | 页面和窗口生命周期、局部布局、事件处理，以及调用共享组件 |
+
+任务卡片和详情通过 `taskPresentation()` 取得当前语言的状态、操作和进度信息。共用的业务内容只定义一次，布局差异由独立的小模板表达。模板按内容段落展开，页面事件处理不再嵌入完整的新建或导入表单。
+
+两种界面都在完整详情加载后才允许编辑续作消息；运行、启动、授权和暂停中的工作隐藏结束按钮，继续通过暂停流程停止。监测详情展示备注和消息，工作详情展示计划和输出。用户标题、备注、消息、计划和输出始终按原文转义后显示。
+
+请求客户端由各界面创建，详情缓存和窗口状态仍分别持有。两处都使用既有的 `credentials: omit`、`redirect: error` 和写请求标记；完整页面补齐挂件已有的 35 秒超时。实时流仍由 `VisibleFeed` 管理，隐藏视图订阅和动画的生命周期继续独立维护。
+
+## 验证方式
+
+- `tests/shared-ui.test.js` 检查请求与错误处理、超时、两种布局的状态和操作一致性、转义、表单字段，以及实际页面脚本中的创建、导入和消息编辑提交。
+- `tests/mode-views.test.js` 通过页面和挂件入口检查卡片、详情及设置，移除对生产函数源码形状的截取。
+- `tests/fixtures/widget-view.js` 使用同一套模拟 DOM、请求与事件环境加载两种页面脚本；测试不启动真实任务或发送聊天消息。
+- HTTP 集成检查遍历页面模块的实际导入，确认所有共享模块均包含在静态资源白名单中。
+
+固定源码回归目录为 `.cache/shared-ui-refactor-0.5.1/`。运行数据和界面验收数据使用独立目录；本轮未构建或安装新版本。
+
+## 验证结果
+
+新增 10 项共享界面回归，相关界面、语言、加载与 HTTP 集成共 44 项通过。固定源码的完整回归以两个测试文件并发执行，**321 项通过，0 失败、0 跳过**；语法和公开源码检查通过。
+
+首轮默认并发中出现服务初始化读取、进程与窗口等待及目录清理失败；随后保持同一源码和原有超时设置，以两个测试文件并发复跑，全量通过。未为通过检查修改 Electron 沙箱或系统 ACL。
+
+另以模拟桌面桥接和模拟 HTTP 数据，在真实隐藏 Electron 窗口中验收完整页面、挂件各自的中文和英文，共 4 组。检查卡片、新建表单和监测详情；语言切换时输入、焦点与光标保留，完整详情加载后开放消息编辑。截图已核对，报告与截图保存在 `.cache/shared-ui-qa-0.5.1/`。
diff --git a/docs/task-models.md b/docs/task-models.md
new file mode 100644
index 0000000..7353620
--- /dev/null
+++ b/docs/task-models.md
@@ -0,0 +1,35 @@
+# 两种任务的状态模型
+
+版本：0.5.1。日期：2026-10-29。
+
+任务列表继续通过原有 HTTP、MCP 和快照接口读取。后台以 `mode` 区分两种记录，各自定义创建、状态、操作、校验和恢复规则；Manager 只分发操作并协调保存、授权取消及中断。
+
+| 约定 | 多轮工作 | 原聊天额度监测 |
+| --- | --- | --- |
+| 模块 | `server/direct-task.js` | `server/monitor-task.js` |
+| `mode` | `direct`，新建时明确记录 | `quota-wake` |
+| 主要数据 | 原始目标 `prompt`、计划、输出和当前轮次 | 本地备注 `note`、续作消息和额度恢复发送记录 `wake` |
+| 计数 | `rounds`，按 `maxRounds` 限制 | `sentCount`，按 `maxWakeSends` 限制 |
+| 手动继续 | 重置执行轮次并等待调度 | 保留累计发送次数，重新开启监测 |
+| 允许状态 | 排队、等待、启动、执行、授权、暂停中、暂停、阻塞、失败、完成 | 监测、等待、暂停、阻塞、结束并移除 |
+| 执行通道 | Codex 轮次与授权协议 | 额度恢复后的消息队列；发送前检查原聊天回复 |
+
+`server/task-model.js` 按模式选择规则，并保留共用字段的基本结构检查。Store 使用各模式的状态和计数校验；工作记录不能保存监测发送字段，监测记录不能使用执行、授权或启动等工作状态。轮次启动入口也会拒绝监测记录，其外部轮次通知不会写入计划、输出或授权映射。
+
+两种模式仍使用现有的 `continuous` 字段以兼容界面和持久化格式，含义分别是“允许继续下一轮”和“开启额度监测”。状态及计数的规则由各自模块维护，调用方不再通过同一段分支处理两类任务的暂停、继续和完成。
+
+## 旧数据与恢复
+
+- 读取没有 `mode` 的旧工作记录时补为 `direct`，保留目标和执行次数。明确标为 `direct` 的 writer 等待继续按工作模式重试。
+- 只有没有模式、满足历史 writer 冲突条件的旧记录才迁为监测；旧直接执行轮次不能当作已排队消息，其发送次数从 0 开始。
+- 旧监测记录的 `prompt` 转为备注，缺少 `sentCount` 时按原有兼容规则读取旧计数；已有发送次数、备注和自定义消息继续保留。之后移除监测记录中的旧目标、轮次、计划、输出及执行轮次 ID。
+- 缺少耗尽证据的待发送记录继续阻塞；重启时正在发送的记录转为结果不确定并保存，不自动重发。
+- 恢复备份也先执行模式迁移，再关闭两种任务的自动推进。监测恢复不会新增工作执行字段。
+
+数据 schema 继续为 1，使用现有字段与模式标记。迁移只在新源码运行时作用于其指定的数据目录；本轮测试使用独立数据，未安装或切换正在使用的版本。
+
+## 验证
+
+固定源码副本 `.cache/task-model-refactor-0.5.1/` 的完整回归：**311 项通过，0 失败、0 跳过**，包括真实隐藏 Electron 检查。语法检查与公开源码检查通过。
+
+新增 `tests/task-models.test.js` 的 7 项回归覆盖模式字段、跨模式非法状态、计数与执行隔离、外部通知和授权隔离、混合旧数据的一次性迁移、在途发送重启，以及备份恢复。既有暂停竞态、发送上限、回复检查、保存失败、HTTP/MCP 和界面回归继续通过。
diff --git a/docs/usage.md b/docs/usage.md
index 889e09e..afc6a82 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -1,6 +1,6 @@
# 功能与使用细节
-**0.4.1-preview · Windows x64 预览版。** 开源准备、验证证据与剩余验收见 [开源准备记录](open-source-readiness.md)。使用范围见 [兼容性说明](compatibility.md)，参与开发和反馈见 [CONTRIBUTING.md](../CONTRIBUTING.md)、[SECURITY.md](../SECURITY.md)。本工具独立于 OpenAI、Rhine 和 Clash Verge，不代表这些项目官方产品。
+**0.5.1 · Windows x64 预览版。** 开源准备、验证证据与剩余验收见 [开源准备记录](open-source-readiness.md)。使用范围见 [兼容性说明](compatibility.md)，参与开发和反馈见 [CONTRIBUTING.md](../CONTRIBUTING.md)、[SECURITY.md](../SECURITY.md)。本工具独立于 OpenAI、Rhine 和 Clash Verge，不代表这些项目官方产品。
一个可运行的本地 Codex 插件：监测账户额度、查看任务计划，并在额度恢复后继续指定工作。v0.3.3 基于 [Rhine 仓库的动画 SVG](https://github.com/empty610/rhine_ui_clash-verge/blob/a298150dbbd13a217bf48fe574f8fd27bfec2b80/src/assets/image/rhine-signal-loop.svg)，保留 60 秒的轮廓、飞行、行星、轨道形变动画。本地版本精简重复关键帧与叠加滤镜，将 48 个粒子动画合并为 3 组，并移除方形外框；不使用图片序列缓存或额外合成层。界面使用仓库中的暖灰、琥珀配色，支持明暗主题。
@@ -8,7 +8,7 @@
收起后显示动态仪表：默认先显示**五小时额度及其重置倒计时**，每 12 秒切换一次，使用 1 秒的淡出、换值、淡入过渡；额度文字不再随装饰动画长时间隐藏，原版 SVG 的 60 秒动画时间线保持连续。倒计时每秒更新，数据未知或过期时显示「待同步」，重置时间已到则显示「待刷新」。这仅切换显示，续作调度仍需所有窗口的真实新额度样本达标。系统开启「减少动态效果」时关闭装饰动画与转场，但保留额度轮播。
-桌面卡片默认 256 px，可在「工作策略与显示」中用滑块调为 160–420 px，也可按住 Ctrl 在卡片上滚动鼠标滚轮调整；大小会保存。**点击整张卡片展开，拖动任意位置移动**；桌面光标移动超过 6 个逻辑像素视为拖动，不触发展开。静止按住或轻微抖动不会移动卡片或保存新位置；失焦、取消或丢失指针捕获时结束拖动。展开/收起先淡出，在不可见时一次切换窗口尺寸和位置，再淡入；两种模式分别记住位置。
+桌面卡片默认 256 px，可在「工作策略与显示」中用滑块调为 160–420 px，也可按住 Ctrl 在卡片上滚动鼠标滚轮调整；大小会保存。**点击整张卡片展开，拖动任意位置移动**；桌面光标移动超过 6 个逻辑像素视为拖动，不触发展开。静止按住或轻微抖动不会移动卡片或保存新位置；失焦、取消或丢失指针捕获时结束拖动。展开/收起先淡出，在不可见时一次切换窗口尺寸和位置，再淡入；收起会恢复卡片原位，从卡片展开时以当前卡片为锚，屏幕边缘空间不足时换向展开，不跳回旧面板位置。
**右键卡片**可打开与系统托盘相同的菜单：打开面板、跟随 Codex、独立显示、重置位置、隐藏挂件或退出挂件。隐藏到托盘只隐藏界面；关闭按钮和“退出 Continuer”会保存状态、停止本工具的执行轮次与服务、结束跟随和自启动监听进程。已进入原聊天队列的消息仍不能撤回。
@@ -16,9 +16,9 @@
源码构建使用 Visual Studio Build Tools 的 Roslyn 编译器确定性生成 `desktop/continuer-monitor.exe`，可通过 `CONTINUER_CSC` 指定编译器。自启动与跟随监测优先使用此隐藏程序，PowerShell 启动入口在交接后退出。便携包已经包含监听器，无需安装编译工具。源码环境仍保留 PowerShell 监测回退。
-导入原聊天后，开启「额度监测」即开始等待耗尽与恢复。只有后台确认额度耗尽（某窗口已用 ≥100% 或服务端返回限制标记），随后获取所有窗口达标的新样本，才通过官方 `codex queue` 向原聊天排队发送一次「继续」。开启时额度正常、仅低于阈值、倒计时到零、额度未知或部分更新事件都不会直接触发。每次耗尽恢复周期只发送一次；暂停监测可取消尚未发送的消息。已进入 Codex 队列的消息不能由本工具撤回。
+导入原聊天后，开启「额度监测」即开始等待耗尽与恢复。只有后台确认额度耗尽（某窗口已用 ≥100% 或服务端返回限制标记），随后获取所有窗口达标的新样本，才准备通过官方 `codex queue` 向原聊天排队发送一次续作消息。发送前逐条检查原聊天：最新指令对应的轮次已正常结束且已有最终回复，则跳过本次发送，不增加发送次数；仍在回复或无法确认状态时保留待发送记录，稍后重试。只检查最新轮次，较早的完整回复不会阻止新指令在额度中断后续作。开启时额度正常、仅低于阈值、倒计时到零、额度未知或部分更新事件都不会直接触发。每次耗尽恢复周期最多发送一次；暂停监测可取消尚未发送的消息。已进入 Codex 队列的消息不能由本工具撤回。
-原聊天的「监测备注」仅本地保存，可留空，不作为新目标发送。每条记录受独立的「原聊天发送次数上限」约束（1–100 次，默认 20 次），累计次数在暂停、重新开启和重启后保留；到限自动停止，提高上限后需手动开启。原聊天进度和完成状态由原聊天负责，本工具不自动识别目标完成；「结束监测并移除」只移除监测记录。新建工作仍使用自己的执行目标、轮次上限和结构化完成结果。
+原聊天的「监测备注」仅本地保存，可留空，不作为新目标发送。每条记录受独立的「原聊天发送次数上限」约束（1–100 次，默认 20 次），累计次数在暂停、重新开启和重启后保留；到限自动停止，提高上限后需手动开启。完整回复检查使用轮次结束状态、最终消息及消息与最新指令的顺序；中途说明、失败或中断的轮次不算完整回复。兼容未提供消息 phase 的旧模型，在轮次正常结束且有非空回复时视为完整回复。此检查不验证项目验收结果，也不保存读取到的聊天正文。跳过后继续监测并保留备注和自定义消息，以便新指令遇到额度中断时再次接续；「结束监测并移除」只移除监测记录。新建工作仍使用自己的执行目标、轮次上限和结构化完成结果。
此模式使用新版桌面端附带的 CLI 队列，不通过 `thread/resume` 接管原聊天，不需要模型定时检查额度，也不依赖活跃助手调用上下文。可用 `CODEX_QUEUE_BINARY` 指定支持 `queue` 的 CLI。原聊天及其执行端必须可用；队列接收成功不等于项目已完成。发送超时或重启时结果不明将停止自动重发，请检查原聊天后重新开启监测。当前旧版「等待会话占用」任务会迁移到监测模式，迁移不会把历史占用错误当作新额度耗尽。
@@ -37,7 +37,7 @@ cd .\codex-continuer
安装器下载锁定版本的 Electron 运行时，构建本地插件包，注册 `continuer-local` 市场并安装 `codex-continuer`，随后打开挂件。使用官方本地插件机制，不修改 Codex 安装文件。首次安装后，在 Codex 中重新加载插件或打开新聊天，再让 Codex「打开 Continuer 挂件」或「查看额度和任务进度」。
-也可以双击 `Open-Widget.cmd` 直接打开，或运行 `npm run widget`。**Ctrl+Alt+C** 展开面板，点击减号收起成圆形仪表。收起后点击任意位置展开、拖动移动；展开后拖动顶部标题栏移动。两种状态分别记住位置，跟随模式保存相对 Codex 的偏移。系统托盘和工作策略中提供「重置挂件位置」。跟随模式在 Codex 位于前台时显示，挂件获得焦点时保持显示；其他应用在前台或 Codex 最小化时隐藏。
+也可以双击 `Open-Widget.cmd` 直接打开，或运行 `npm run widget`。**Ctrl+Alt+C** 展开面板，点击减号收起成圆形仪表。收起后点击任意位置展开、拖动移动；展开后拖动顶部标题栏移动。卡片位置独立保留，点击展开时优先贴着当前卡片；跟随模式同步保存相对 Codex 的新偏移。系统托盘和工作策略中提供「重置挂件位置」。跟随模式在 Codex 位于前台时显示，挂件获得焦点时保持显示；其他应用在前台或 Codex 最小化时隐藏。
这是与 Codex 窗口联动的独立原生挂件，不是向 Codex 内部侧栏注入 UI。插件工具与挂件共用本地服务。隐藏到托盘仍保持运行；退出会停止后台调度和服务。退出标记会阻止普通 MCP 查询或自动启动重新拉起，需手动打开挂件恢复。Codex 托管的 MCP 工具连接可保持空闲，不执行后台调度。
@@ -108,12 +108,16 @@ CLI 已登录时不必重复登录。普通 Windows 用户环境即可运行，
## 使用
1. 新建工作：填写名称、现有项目的绝对目录、目标和验收标准。创建后即排队执行。
-2. 或导入已有本地 Codex 会话：填写可选备注，导入后保持暂停；开启额度监测，确认耗尽并恢复后向原聊天发送固定「继续」。备注不发送，原聊天中的最新要求继续有效。
+2. 或导入已有本地 Codex 会话：点击「加入我的工作」后，可填写续作消息和监测备注。续作消息留空（含仅空白）时，根据发送时的界面语言发送中文「继续」或英文「Continue」；填写时每次恢复都发送原文。备注保存到首页工作卡片，仅本地展示，不发送。导入后保持暂停；开启额度监测并确认耗尽、恢复后才发送。详情可查看完整备注和实际续作消息。
+
+挂件与完整页面顶部的语言选择器可切换「中文 / English」。设置保存到本地，重新打开后保留，并同步到其他窗口；旧数据默认中文。语言切换不会开启自动调度、清空输入或翻译工作名称、备注和自定义续作消息。
+
+已加入的原聊天可以在「详情 → 编辑续作消息」中修改消息，点击「保存消息」后本地持久保存。清空后恢复当前语言的默认消息，取消编辑不保存。修改不重置发送次数或监测状态；新内容用于后续发送，正在发送或已排队的消息保持原内容。
3. 为需要长期推进的任务开启「持续工作」。等待额度的任务在所有返回窗口恢复到阈值后自动继续。
4. 新建工作的进度来自 Codex 步骤计划；没有计划显示「无计划」。原聊天显示「进度请在原聊天查看」，不推断完成度。
5. 新建工作详情显示目标、计划、输出和执行轮次；原聊天详情显示备注、已排队发送次数和监测状态。
6. 设置中调整轮询周期（10–90 秒）、恢复阈值（1–99%）、直接执行上限（1–100 轮）和原聊天发送上限（每条记录累计 1–100 次）。
-7. 新建工作完成后清除记录；原聊天需选择「结束监测并移除」，该操作不确认原聊天工作已完成。原始 Codex 对话和项目文件保留。
+7. 新建工作完成后清除记录；原聊天需选择「结束监测并移除」，该操作不确认原聊天工作已完成，并同步清理当前状态、自动备份及可解析恢复副本中的对应记录、备注和自定义消息。原始 Codex 对话和项目文件保留。
全局调度开关控制新轮次和新的续作消息。新建工作的「暂停」请求中断本工具当前轮次；原聊天的「暂停监测」不打断原聊天执行，也不能撤回已排队的消息。修改上限时，已经开始排队的消息可能完成；已确认排队次数仍会计入累计。
@@ -137,7 +141,7 @@ CLI 已登录时不必重复登录。普通 Windows 用户环境即可运行，
- 额度样本超过 90 秒、未知或连接失败时不运行。重置时间已到仍需新样本确认，不能推断额度恢复。
- 轮询周期最多 90 秒；旧版本超过上限的配置会在加载时收紧至 90 秒。旧监测目标转存为本地备注，旧发送计数迁移为 sentCount；新增发送上限首次沿用原配置 maxRounds，之后两个上限独立。读取或迁移不会开启监测。
- 额度类失败按协议错误码判断，至少退避 60 秒；其他失败需人工处理。
-- 新建工作每轮要求结构化 `done / continue / blocked` 结果；`continue` 且存在工具活动才可自动开始下一轮。结果不明确、需要输入、没有工具活动或达到轮次上限均停止。原聊天只监测额度并发送消息，不读取这类完成结果。
+- 新建工作每轮要求结构化 `done / continue / blocked` 结果；`continue` 且存在工具活动才可自动开始下一轮。结果不明确、需要输入、没有工具活动或达到轮次上限均停止。原聊天在额度恢复后读取最新轮次以检查完整回复，不解析这类结构化项目结果；支持分页历史的服务只读取最新一轮，旧服务通过 `thread/read` 兼容读取。
- `done` 由模型报告，不是独立验证器。验收要求应写入目标，用户可检查输出后手动标记完成。
- 使用 `workspace-write` 沙箱和 `on-request` 审批策略。支持可完整审阅的命令审批；文件变更、空命令、未展示的权限字段及其他交互会拒绝并暂停，需用户到原 Codex 手工处理。
- 只主动管理本工具创建或导入的任务；不会接管未导入的聊天。其他 Codex 客户端的实时进度不保证跨进程同步；不应在两个客户端同时执行同一会话。
diff --git a/package-lock.json b/package-lock.json
index 1572a9f..84ec807 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "codex-continuer",
- "version": "0.4.1-preview",
+ "version": "0.5.1",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "codex-continuer",
- "version": "0.4.1-preview",
+ "version": "0.5.1",
"devDependencies": {
"electron": "45.0.0"
},
diff --git a/package.json b/package.json
index 3cfde7a..ecfe77c 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "codex-continuer",
- "version": "0.4.1-preview",
+ "version": "0.5.1",
"private": true,
"type": "module",
"description": "Local Codex quota monitor and resumable task manager",
diff --git a/plugin.json b/plugin.json
index 387635f..b35a6bb 100644
--- a/plugin.json
+++ b/plugin.json
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "codex-continuer",
- "version": "0.4.1-preview",
+ "version": "0.5.1",
"description": "Windows 预览版：Codex 额度监测、原聊天接续与任务管理",
"extensions": {
"com.openai": {
diff --git a/plugin/control.js b/plugin/control.js
index 058ad58..e444d82 100644
--- a/plugin/control.js
+++ b/plugin/control.js
@@ -3,20 +3,13 @@ const demo = process.argv.includes('--demo');
process.env.CONTINUER_PORT = process.env.PORT || (demo ? '4318' : process.env.CONTINUER_PORT || '4317');
process.env.CONTINUER_DEMO = demo ? '1' : '';
const runtime = await import('./runtime.js');
-const { default: exitState } = await import('../server/exit-state.cjs');
try {
if (process.argv[2] === 'stop') {
- let state;
- try { state = await runtime.request('/api/state'); }
- catch (error) { if (error.code === 'TLS_IDENTITY_MISSING' || error.cause?.code === 'ECONNREFUSED') { console.log('Continuer is not running.'); process.exit(0); } throw error; }
- const { resolve } = await import('node:path');
- const normalize = value => process.platform === 'win32' ? resolve(value).toLowerCase() : resolve(value);
- if (state.app !== 'codex-continuer' || typeof state.diagnostics?.dataDir !== 'string' || normalize(state.diagnostics.dataDir) !== normalize(runtime.dataDir)) throw Error('端口服务不属于当前 Continuer 数据目录');
- await runtime.request('/api/shutdown', {}); console.log('Continuer stopped.');
+ const result = await runtime.stopService();
+ console.log(result.stopped ? 'Continuer stopped.' : 'Continuer is not running.');
} else if (process.argv[2] === 'open' || process.argv[2] === 'start') {
- exitState.clear(runtime.dataDir, demo);
if (process.argv[2] === 'open') console.log(JSON.stringify(await runtime.openWidget()));
- else { await runtime.ensureService(); console.log('Continuer started in observation mode.'); }
+ else { await runtime.startService(); console.log('Continuer started in observation mode.'); }
} else if (process.argv[2] === 'url') throw Error('浏览器凭据链接已停用，请运行 node plugin/open.js 打开原生挂件。');
else throw Error('Usage: node plugin/control.js open|start|stop [--demo]');
} catch (error) { console.error(error.message); process.exitCode = 1; }
diff --git a/plugin/lifecycle.js b/plugin/lifecycle.js
new file mode 100644
index 0000000..439511f
--- /dev/null
+++ b/plugin/lifecycle.js
@@ -0,0 +1,139 @@
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { assertServiceIdentity, runtimeError, samePath, serviceUnavailable } from './local-client.js';
+import { message, messageFields } from '../public/message.js';
+
+// The lifecycle knows process roles and readiness. Host I/O is supplied by the
+// runtime adapter; constructing it never reads state or starts a process.
+export function createLifecycle({ root, dataDir, port, demo = false, platform = process.platform, serviceNode, widgetNode,
+ appInfo, request, launch, exists, diagnostic, alive, quit, shutdown,
+ wait = delay, now = () => performance.now(), serviceTimeoutMs = 18000, widgetAttempts = 60 }) {
+ let starting, opening, stopping, generation = 0;
+ const assertOpen = (expected = generation) => {
+ if (expected !== generation || stopping || quit.requested()) throw runtimeError('EXIT_REQUESTED', 'runtime.exited');
+ };
+ const verify = state => assertServiceIdentity(state, { dataDir, appInfo: appInfo(), platform });
+
+ async function start(expected) {
+ assertOpen(expected);
+ try {
+ const state = await request('/api/state', undefined, { timeoutMs: 2000 });
+ assertOpen(expected); return verify(state);
+ } catch (error) { if (!serviceUnavailable(error)) throw error; }
+ assertOpen(expected);
+ if (!serviceNode) throw runtimeError('NODE_MISSING', 'runtime.node_missing');
+ // A passive query/open must not restore the saved scheduler automatically.
+ const child = launch(serviceNode, [join(root, 'server/index.js'), '--observe-only', ...(demo ? ['--demo'] : [])], 'service', { PORT: String(port) });
+ let spawnError;
+ const failed = error => { spawnError = error; };
+ child.once('error', failed);
+ const deadline = now() + serviceTimeoutMs;
+ try {
+ while (now() < deadline) {
+ assertOpen(expected); if (spawnError) throw spawnError;
+ await wait(Math.min(150, Math.max(0, deadline - now())));
+ assertOpen(expected); if (spawnError) throw spawnError;
+ const remaining = Math.ceil(deadline - now());
+ if (remaining <= 0) break;
+ try {
+ const state = await request('/api/state', undefined, { timeoutMs: Math.min(2000, remaining) });
+ assertOpen(expected); if (spawnError) throw spawnError;
+ return verify(state);
+ } catch (error) { if (!serviceUnavailable(error)) throw error; }
+ }
+ throw runtimeError('SERVICE_START_TIMEOUT', 'runtime.service_timeout');
+ } finally { child.removeListener('error', failed); }
+ }
+
+ function ensureService() {
+ try { assertOpen(); } catch (error) { return Promise.reject(error); }
+ const job = starting || { generation };
+ if (!starting) {
+ starting = job;
+ job.promise = start(job.generation).finally(() => { if (starting === job) starting = null; });
+ }
+ return job.promise;
+ }
+
+ async function startService() {
+ const expected = generation;
+ if (stopping) await stopping;
+ assertOpenGeneration(expected);
+ quit.clear(); return ensureService();
+ }
+
+ function assertOpenGeneration(expected) {
+ if (expected !== generation) throw runtimeError('EXIT_REQUESTED', 'runtime.exited');
+ }
+
+ function ensureWatcher() {
+ if (demo || !diagnostic(join(dataDir, 'autostart-preferences.json'))?.enabled) return;
+ const watcher = diagnostic(join(dataDir, 'autostart-status.json'));
+ if (samePath(watcher?.pluginRoot, root, platform) && alive(watcher?.pid)) return;
+ const native = join(root, 'desktop/continuer-monitor.exe');
+ if (exists(native)) launch(native, ['--watch', widgetNode, root, dataDir], 'watcher');
+ else launch('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', join(root, 'desktop/watch-codex.ps1'), '-NodePath', widgetNode, '-PluginRoot', root, '-DataDir', dataDir], 'watcher');
+ }
+
+ async function open(automatic, expected) {
+ assertOpen(expected); await ensureService(); assertOpen(expected);
+ const executable = join(root, 'node_modules/electron/dist', platform === 'win32' ? 'electron.exe' : 'electron');
+ if (!exists(executable)) throw runtimeError('DESKTOP_MISSING', 'runtime.desktop_missing');
+ const child = launch(executable, [join(root, 'desktop/main.cjs'), ...(automatic ? ['--auto'] : [])], 'widget', { ELECTRON_RUN_AS_NODE: undefined, CONTINUER_NODE: widgetNode, CONTINUER_PORT: String(port) });
+ let spawnError;
+ const failed = error => { spawnError = error; };
+ child.once('error', failed);
+ try {
+ for (let attempt = 0; attempt < widgetAttempts; attempt++) {
+ assertOpen(expected); if (spawnError) throw spawnError;
+ const widget = diagnostic(join(dataDir, 'widget-status.json'));
+ if (widget?.ready && widget.buildId === appInfo().buildId && alive(widget.pid)) {
+ return { launched: true, ready: true, mode: widget.follow ? 'follow-codex' : 'independent', ...messageFields(message('runtime.widget_ready')) };
+ }
+ await wait(150);
+ }
+ assertOpen(expected); if (spawnError) throw spawnError;
+ throw runtimeError('WIDGET_START_TIMEOUT', 'runtime.widget_timeout');
+ } finally { child.removeListener('error', failed); }
+ }
+
+ async function openWidget({ automatic = false } = {}) {
+ if (automatic) assertOpen();
+ else {
+ const expected = generation;
+ if (stopping) await stopping;
+ assertOpenGeneration(expected); quit.clear();
+ }
+ const job = opening || { manual: !automatic, generation };
+ if (!opening) {
+ opening = job;
+ job.promise = open(automatic, job.generation).then(result => {
+ assertOpen(job.generation);
+ // Manual callers joining automatic startup restore one watcher.
+ if (job.manual) ensureWatcher();
+ return result;
+ }).finally(() => { if (opening === job) opening = null; });
+ } else if (!automatic) job.manual = true;
+ return job.promise;
+ }
+
+ async function stopService() {
+ let state;
+ try { state = await request('/api/state', undefined, { timeoutMs: 2000 }); }
+ catch (error) { if (serviceUnavailable(error)) return { running: false }; throw error; }
+ assertServiceIdentity(state, { dataDir, platform });
+ await request('/api/shutdown', {}, { timeoutMs: 5000 });
+ return { running: false, stopped: true };
+ }
+
+ function stopBackground() {
+ if (!stopping) {
+ generation++; starting = null; opening = null;
+ // Publish the stopping state before calling host I/O, which may emit events.
+ stopping = Promise.resolve().then(shutdown).finally(() => { stopping = null; });
+ }
+ return stopping;
+ }
+
+ return { ensureService, startService, openWidget, stopService, stopBackground };
+}
diff --git a/plugin/local-client.js b/plugin/local-client.js
new file mode 100644
index 0000000..d531f2f
--- /dev/null
+++ b/plugin/local-client.js
@@ -0,0 +1,39 @@
+import { resolve } from 'node:path';
+import { isMessage, message, MessageError } from '../public/message.js';
+
+export function runtimeError(code, id) { return Object.assign(new MessageError(message(id)), { code }); }
+export const serviceUnavailable = error => error?.code === 'TLS_IDENTITY_MISSING' || error?.cause?.code === 'ECONNREFUSED';
+export function samePath(left, right, platform = process.platform) {
+ if (typeof left !== 'string' || typeof right !== 'string') return false;
+ const normalize = value => platform === 'win32' ? resolve(value).toLowerCase() : resolve(value);
+ return normalize(left) === normalize(right);
+}
+
+// Reads require the current build; shutdown may deliberately address an older
+// build. Both require the expected data directory, and full exit also its root.
+export function assertServiceIdentity(state, { dataDir, root, appInfo, platform = process.platform }) {
+ if (state?.app !== 'codex-continuer') throw runtimeError('SERVICE_OWNER_MISMATCH', 'runtime.port_in_use');
+ if (appInfo && (state.protocolVersion !== appInfo.protocolVersion || state.buildId !== appInfo.buildId)) {
+ throw runtimeError('SERVICE_BUILD_MISMATCH', 'runtime.build_mismatch');
+ }
+ if (!samePath(state.diagnostics?.dataDir, dataDir, platform)) {
+ throw runtimeError('SERVICE_OWNER_MISMATCH', 'runtime.directory_mismatch');
+ }
+ if (root !== undefined && !samePath(state.diagnostics?.projectRoot, root, platform)) throw runtimeError('SERVICE_OWNER_MISMATCH', 'runtime.root_mismatch');
+ return state;
+}
+
+export function createLocalClient({ origin, readAccessToken, identityOptions, fetchLocal }) {
+ return async function request(path, payload, { timeoutMs = 35000 } = {}) {
+ if (typeof path !== 'string' || !path.startsWith('/api/') || path.includes('\\') || new URL(origin + path).origin !== origin) throw Error('Invalid API path');
+ const token = readAccessToken();
+ const response = await fetchLocal(origin + path, {
+ signal: AbortSignal.timeout(timeoutMs),
+ headers: { ...(token ? { Authorization: 'Bearer ' + token } : {}), ...(payload === undefined ? {} : { 'Content-Type': 'application/json', 'X-Continuer-Client': '1' }) },
+ ...(payload === undefined ? {} : { method: 'POST', body: JSON.stringify(payload) }),
+ }, identityOptions());
+ const result = await response.json();
+ if (!response.ok) throw new MessageError(isMessage(result.errorInfo) ? result.errorInfo : null, result.error || `HTTP ${response.status}`);
+ return result;
+ };
+}
diff --git a/plugin/runtime.js b/plugin/runtime.js
index ef5ad51..f06cbb6 100644
--- a/plugin/runtime.js
+++ b/plugin/runtime.js
@@ -1,92 +1,45 @@
import { spawn } from 'node:child_process';
import { existsSync, mkdirSync, openSync, closeSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { join } from 'node:path';
import settings from '../server/config.cjs';
import logging from '../server/logging.cjs';
import { diagnostic, alive } from '../server/health.js';
import access from '../server/access.cjs';
import exitState from '../server/exit-state.cjs';
import localTls from '../server/local-tls.cjs';
+import { createLocalClient } from './local-client.js';
+import { createLifecycle } from './lifecycle.js';
+import { stopBackground as stopOwnedBackground } from './shutdown.js';
-export const root = settings.root;
-const config = settings.config;
-export const dataDir = settings.dataDir;
-export const port = settings.port;
+// This adapter is the only place where the lifecycle binds to this host.
+export const { root, dataDir, port } = settings;
export const origin = `https://127.0.0.1:${port}`;
-export const readAccessToken = () => access.readToken(dataDir, process.env.CONTINUER_DEMO === '1');
-export async function request(path, payload, { timeoutMs = 35000 } = {}) {
- const token = readAccessToken();
- if (typeof path !== 'string' || !path.startsWith('/api/') || path.includes('\\') || new URL(origin + path).origin !== origin) throw Error('Invalid API path');
- const response = await localTls.fetchLocal(origin + path, { signal: AbortSignal.timeout(timeoutMs), headers: { ...(token ? { Authorization: 'Bearer ' + token } : {}), ...(payload === undefined ? {} : { 'Content-Type': 'application/json', 'X-Continuer-Client': '1' }) }, ...(payload === undefined ? {} : { method: 'POST', body: JSON.stringify(payload) }) }, localTls.requestOptions(dataDir, process.env.CONTINUER_DEMO === '1'));
- const result = await response.json();
- if (!response.ok) throw new Error(result.error || `HTTP ${response.status}`);
- return result;
-}
+const demo = process.env.CONTINUER_DEMO === '1';
+export const readAccessToken = () => access.readToken(dataDir, demo);
+export const request = createLocalClient({
+ origin, readAccessToken,
+ identityOptions: () => localTls.requestOptions(dataDir, demo),
+ fetchLocal: (...args) => localTls.fetchLocal(...args),
+});
+
export function launch(command, args, name, extraEnv = {}) {
mkdirSync(dataDir, { recursive: true });
logging.rotateLogs(dataDir);
const out = openSync(join(dataDir, `${name}-stdout.log`), 'a');
- const err = openSync(join(dataDir, `${name}-stderr.log`), 'a');
+ let err;
try {
+ err = openSync(join(dataDir, `${name}-stderr.log`), 'a');
const child = spawn(command, args, { cwd: root, detached: true, windowsHide: true, stdio: ['ignore', out, err], env: { ...process.env, ...extraEnv, CONTINUER_DATA_DIR: dataDir } });
child.on('error', () => {}); child.unref(); return child;
- } finally { closeSync(out); closeSync(err); }
-}
-let starting;
-function verifiedService(state) {
- if (state.app !== 'codex-continuer') throw new Error('Port belongs to another application');
- if (state.protocolVersion !== settings.appInfo().protocolVersion || state.buildId !== settings.appInfo().buildId) throw new Error('运行服务与当前插件构建不一致，请先停止并重新启动 Continuer');
- const directory = path => process.platform === 'win32' ? resolve(path).toLowerCase() : resolve(path);
- if (typeof state.diagnostics?.dataDir !== 'string' || directory(state.diagnostics.dataDir) !== directory(dataDir)) throw new Error('该端口服务使用不同的数据目录，请检查路径后重新启动 Continuer');
- return state;
-}
-export async function ensureService() {
- if (exitState.requested(dataDir, process.env.CONTINUER_DEMO === '1')) throw Error('Continuer 已退出，请先手动打开挂件。');
- if (starting) return starting;
- starting = (async () => {
- try {
- const state = await request('/api/state');
- return verifiedService(state);
- } catch (error) {
- if (error.code !== 'TLS_IDENTITY_MISSING' && error.cause?.code !== 'ECONNREFUSED') throw error;
- }
- const node = config.nodePath || (process.versions.electron ? process.env.CONTINUER_NODE || 'node' : process.execPath);
- if (!node) throw new Error('缺少 Node.js 路径，请重新运行插件安装器');
- if (exitState.requested(dataDir, process.env.CONTINUER_DEMO === '1')) throw Error('Continuer 已退出，请先手动打开挂件。');
- // Opening a widget or reading MCP state never restores saved scheduling by itself.
- const child = launch(node, [join(root, 'server/index.js'), '--observe-only', ...(process.env.CONTINUER_DEMO === '1' ? ['--demo'] : [])], 'service', { PORT: String(port) });
- let spawnError; child.once('error', e => { spawnError = e; });
- for (let i = 0; i < 120; i++) {
- if (spawnError) throw spawnError;
- await new Promise(resolve => setTimeout(resolve, 150));
- let state;
- try { state = await request('/api/state'); } catch (error) { if (error.code === 'TLS_IDENTITY_MISSING' || error.cause?.code === 'ECONNREFUSED') continue; throw error; }
- return verifiedService(state);
- }
- throw new Error('本地服务启动失败，请查看 data/service-stderr.log');
- })().finally(() => { starting = null; });
- return starting;
-}
-export async function openWidget({ automatic = false } = {}) {
- if (automatic && exitState.requested(dataDir, process.env.CONTINUER_DEMO === '1')) throw Error('Continuer 已退出，自动启动已暂停。');
- if (!automatic) exitState.clear(dataDir, process.env.CONTINUER_DEMO === '1');
- await ensureService();
- const executable = join(root, 'node_modules/electron/dist', process.platform === 'win32' ? 'electron.exe' : 'electron');
- if (!existsSync(executable)) throw new Error('缺少桌面运行时，请在项目目录运行 npm install 后重新构建插件');
- launch(executable, [join(root, 'desktop/main.cjs'), ...(automatic ? ['--auto'] : [])], 'widget', { ELECTRON_RUN_AS_NODE: undefined, CONTINUER_NODE: config.nodePath || process.execPath, CONTINUER_PORT: String(port) });
- for (let attempt = 0; attempt < 60; attempt++) {
- const widget = diagnostic(join(dataDir, 'widget-status.json'));
- if (widget?.ready && widget.buildId === settings.appInfo().buildId && alive(widget.pid)) {
- const watcher = diagnostic(join(dataDir, 'autostart-status.json'));
- const currentWatcher = typeof watcher?.pluginRoot === 'string' && resolve(watcher.pluginRoot).toLowerCase() === resolve(root).toLowerCase() && alive(watcher.pid);
- if (!automatic && process.env.CONTINUER_DEMO !== '1' && diagnostic(join(dataDir, 'autostart-preferences.json'))?.enabled && !currentWatcher) {
- const node = config.nodePath || process.env.CONTINUER_NODE || process.execPath, native = join(root, 'desktop/continuer-monitor.exe');
- if (existsSync(native)) launch(native, ['--watch', node, root, dataDir], 'watcher');
- else launch('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', join(root, 'desktop/watch-codex.ps1'), '-NodePath', node, '-PluginRoot', root, '-DataDir', dataDir], 'watcher');
- }
- return { launched: true, ready: true, mode: widget.follow ? 'follow-codex' : 'independent', message: '挂件已就绪。可使用 Ctrl+Alt+C 展开。' };
- }
- await new Promise(resolve => setTimeout(resolve, 150));
- }
- throw new Error('挂件未在时限内就绪，请查看 /api/health 和 widget-stderr.log');
+ } finally { closeSync(out); if (err !== undefined) closeSync(err); }
}
+
+const lifecycle = createLifecycle({
+ root, dataDir, port, demo,
+ serviceNode: settings.config.nodePath || (process.versions.electron ? process.env.CONTINUER_NODE || 'node' : process.execPath),
+ widgetNode: settings.config.nodePath || process.env.CONTINUER_NODE || process.execPath,
+ appInfo: settings.appInfo, request, launch, exists: existsSync, diagnostic, alive,
+ quit: { requested: () => exitState.requested(dataDir, demo), clear: () => exitState.clear(dataDir, demo) },
+ shutdown: () => stopOwnedBackground({ root, dataDir, request, demo }),
+});
+export const { ensureService, startService, openWidget, stopService, stopBackground } = lifecycle;
diff --git a/plugin/shutdown.js b/plugin/shutdown.js
index 2c7bc41..1d41010 100644
--- a/plugin/shutdown.js
+++ b/plugin/shutdown.js
@@ -1,12 +1,12 @@
import { execFile } from 'node:child_process';
import { promisify } from 'node:util';
-import { join, resolve } from 'node:path';
+import { join } from 'node:path';
import { setTimeout as delay } from 'node:timers/promises';
import exitState from '../server/exit-state.cjs';
import { alive, diagnostic } from '../server/health.js';
+import { assertServiceIdentity } from './local-client.js';
const execute = promisify(execFile);
-const canonical = value => process.platform === 'win32' ? resolve(value).toLowerCase() : resolve(value);
export async function stopBackground({ root, dataDir, request, demo = false, cleanup = async (phase, pid = 0) => {
await execute('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', join(root, 'plugin/stop-owned.ps1'), '-PluginRoot', root, '-DataDir', dataDir, '-Phase', phase, '-ServicePid', String(pid)], { windowsHide: true, timeout: 10000 });
}, isAlive = alive, wait = delay, graceMs = 2500 }) {
@@ -17,8 +17,7 @@ export async function stopBackground({ root, dataDir, request, demo = false, cle
let pid = diagnostic(join(dataDir, demo ? 'demo-service.lock' : 'service.lock'))?.pid;
try {
const state = await request('/api/state', undefined, { timeoutMs: 2000 });
- if (state.app !== 'codex-continuer' || typeof state.diagnostics?.projectRoot !== 'string' || typeof state.diagnostics?.dataDir !== 'string'
- || canonical(state.diagnostics.projectRoot) !== canonical(root) || canonical(state.diagnostics.dataDir) !== canonical(dataDir)) throw Error('Refusing to shut down another application or data directory.');
+ assertServiceIdentity(state, { root, dataDir });
pid = state.diagnostics.pid;
await request('/api/shutdown', {}, { timeoutMs: 5000 });
} catch (error) {
diff --git a/plugin/tools.js b/plugin/tools.js
index bd59b5f..cd4bcb0 100644
--- a/plugin/tools.js
+++ b/plugin/tools.js
@@ -4,7 +4,7 @@ export const tools = [
{ name: 'continuer_open_widget', description: '打开跟随 Codex 窗口的 Continuer 额度和任务挂件。只显示界面，不新建或继续任务。', inputSchema: object({}), annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false } },
{ name: 'continuer_status', description: '读取 Codex 额度、已管理任务进度、持续工作开关及连接状态。未知额度不是零。', inputSchema: object({}), annotations: { readOnlyHint: true, openWorldHint: false } },
{ name: 'continuer_list_sessions', description: '分页读取可导入的 Codex 本机会话；读取不会自动接管会话。', inputSchema: object({ cursor: { type: 'string' } }), annotations: { readOnlyHint: true, openWorldHint: false } },
- { name: 'continuer_import_session', description: '将原聊天加入额度恢复监测，导入后暂停。note 为可选本地备注，不发送给聊天；旧 prompt 字段仅作为备注兼容。每次确认耗尽并恢复后只发送固定“继续”，累计受 maxWakeSends 限制。不读取原聊天完成状态，不承诺完成目标。', inputSchema: { ...object({ threadId: text, note: { type: 'string', minLength: 0 }, prompt: { ...text, description: '旧版兼容备注；不发送给聊天，不可与 note 同时提供' } }), required: ['threadId'] }, annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false } },
+ { name: 'continuer_import_session', description: '将原聊天加入额度恢复监测，导入后暂停。note 为可选本地备注，不发送给聊天；旧 prompt 字段仅作为备注兼容。continuationMessage 为可选续作消息，留空发送“继续”。每次确认耗尽并恢复后先检查最新回复，上次指令已有完整回复则跳过；仍在回复或状态未知时等待重试。实际发送累计受 maxWakeSends 限制，不承诺完成项目目标。', inputSchema: { ...object({ threadId: text, note: { type: 'string', minLength: 0 }, continuationMessage: { type: 'string', minLength: 0, description: '额度恢复时发送给原聊天的消息；留空发送继续' }, prompt: { ...text, description: '旧版兼容备注；不发送给聊天，不可与 note 同时提供' } }), required: ['threadId'] }, annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false } },
{ name: 'continuer_task_action', description: '暂停任务、关闭持续工作或结束并移除记录。原聊天 complete 仅结束监测，不确认工作完成。恢复执行、开启监测和持续工作必须由用户在挂件中操作。', inputSchema: { ...object({ id: text, action: { enum: ['pause', 'complete', 'continuous'], type: 'string' }, value: { type: 'boolean', enum: [false] } }), required: ['id', 'action'] }, annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false } },
{ name: 'continuer_update_settings', description: '仅允许关闭后台调度。开启调度、调整额度阈值及执行上限必须由用户在挂件中操作。', inputSchema: { ...object({ enabled: { type: 'boolean', enum: [false] } }), required: ['enabled'] }, annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false } },
];
diff --git a/public/access.js b/public/access.js
index 863f876..4053fb0 100644
--- a/public/access.js
+++ b/public/access.js
@@ -1,9 +1,10 @@
// Browser credential links are retired. Only the pinned native window receives
// API authorization from its main process; discard legacy browser credentials.
-if (typeof window !== 'undefined' && typeof location !== 'undefined') {
+export function discardLegacyAccess({ location, history, sessionStorage }) {
if (new URLSearchParams(location.hash.slice(1)).has('access')) history.replaceState(null, '', location.pathname + location.search);
sessionStorage.removeItem('continuer-access');
}
+if (typeof window !== 'undefined' && typeof location !== 'undefined') discardLegacyAccess(globalThis);
export function accessHeaders() { return {}; }
// Native EventSource cannot send authorization headers. Preserve its small
diff --git a/public/api-client.js b/public/api-client.js
new file mode 100644
index 0000000..1d213d5
--- /dev/null
+++ b/public/api-client.js
@@ -0,0 +1,23 @@
+import { accessHeaders } from './access.js';
+import { t as tr } from './i18n.js';
+import { isMessage, message, MessageError } from './message.js';
+
+// Both interfaces use the same transport policy and bounded request lifetime.
+export function createApiClient({ request = (...args) => fetch(...args), timeoutMs = 35000 } = {}) {
+ return async function api(path, body) {
+ const write = body !== undefined;
+ const response = await request(path, {
+ signal: AbortSignal.timeout(timeoutMs),
+ credentials: 'omit',
+ redirect: 'error',
+ headers: {
+ ...accessHeaders(),
+ ...(write ? { 'Content-Type': 'application/json', 'X-Continuer-Client': '1' } : {}),
+ },
+ ...(write ? { method: 'POST', body: JSON.stringify(body) } : {}),
+ });
+ const data = await response.json();
+ if (!response.ok) throw new MessageError(isMessage(data.errorInfo) ? data.errorInfo : data.error ? null : message('ui.request_failed'), data.error || tr("ui.request_failed"));
+ return data;
+ };
+}
diff --git a/public/app.js b/public/app.js
index cf1ec8c..b16d749 100644
--- a/public/app.js
+++ b/public/app.js
@@ -1,184 +1,236 @@
+import { newTaskForm, monitorImportForm } from './task-forms.js';
+import { t as tr, systemText, setFormError, locale, setLanguage, staticInterface, refreshLocalizedContent } from './i18n.js';
import { TaskDetails } from './task-details.js';
-import { accessHeaders } from './access.js';
+import { createApiClient } from './api-client.js';
+import { escapeHtml as esc } from './html.js';
+import { icon } from './icons.js';
+import { taskCardHtml, taskDetailHtml, isTaskActive, toggle } from './task-view.js';
import { VisibleFeed, setHtml } from './view-lifecycle.js';
import { ApprovalDetails } from './approval-details.js';
import { storageNotice } from './storage-status.js';
-import { taskMode, wakeExplanation } from './task-mode.js';
-const paths = {
- overview: '${description}
每 ${state.settings.pollSeconds} 秒同步，实时接收更新
保存会话，等待所有额度窗口恢复
剩余额度 ≥ ${state.settings.minimumRemaining}% 时自动续作
直接执行：完成、阻塞或达到 ${state.settings.maxRounds} 轮时停止。原聊天：${esc(wakeExplanation)}每条记录累计最多发送 ${state.settings.maxWakeSends} 次。
${esc(log.message)}
开始第一项工作后，活动会记录在这里。
'}${esc(a.reason)}
${esc(a.command || a.method)}\n${esc(a.cwd)}${a.requiresDetails ? '完整授权内容尚未加载，请刷新重试；加载完成后可允许操作。
' : ''}本地服务需持续运行，关机或休眠期间不执行。关闭页面不影响后台服务；原生挂件提供系统托盘；随 Codex 启动：${state.diagnostics?.autostart.watcherRunning ? '监听器运行中' : state.diagnostics?.autostart.enabled === false ? '已关闭' : '监听器未运行或状态未知'}。
构建 ${esc(state.buildId || '')} · 协议 ${state.protocolVersion} ·
${description}
重置时间来自服务端，仅作参考。系统会读取恢复后的新样本，再决定是否继续工作。
`; - else if (page === 'logs') html = `${heading('活动日志', '显示最近 50 条活动；导出可获取最多 300 条。', '')}| 时间 | 类型 | 活动 |
|---|---|---|
| ${new Date(l.time).toLocaleDateString('zh-CN')} ${time(l.time)} | ${({ success: '成功', warning: '关注', info: '信息' })[l.type]} | ${esc(l.message)} |
给项目一个明确目标，Continuer 帮你接续进展。
`); } -function renderDetail(id) { - const summary = state.tasks.find(t => t.id === id); if (!summary) { modal.close(); selectedTask = null; return; } - const t = taskDetails.read(summary); - const mode = taskMode(t, state.settings); - $('#modal-body').innerHTML = `${modalHead(esc(t.name))}${badge(t)}${esc(t.cwd)}
${esc(mode.description)}
${mode.wake ? `${esc(wakeExplanation)}
` : `计划百分比仅表示已完成步骤比例。
`}当前状态：${esc(t.activity)} · ${esc(mode.counter)}
${t.threadId ? `会话：${esc(t.threadId)}
` : ''}${!mode.wake ? `输出较长，仅保留末尾预览；完整内容请在原 Codex 会话查看。
' : ''}${esc(t.output || '尚无输出')}` : ''}选择需要管理的本机会话。导入后先保持暂停。
没有可导入的会话
'; - if (append) $('#thread-list').insertAdjacentHTML('beforeend', list); else $('#thread-list').innerHTML = list; - $('#thread-more').innerHTML = result.nextCursor && remaining > result.data.length ? `` : ''; - } catch (e) { if ($('#modal-error')) $('#modal-error').textContent = e.message; } + function stats() { + const bucket = allBuckets().find(b => b.limitId === 'codex') || allBuckets()[0]; + const running = state.tasks.filter(isTaskActive).length; + const continuous = state.tasks.filter(t => t.continuous && t.status !== 'completed').length; + const windowName = (w, fallback) => w?.windowDurationMins ? (w.windowDurationMins >= 1440 ? tr("ui.day_quota", { p0: w.windowDurationMins / 1440 }) : tr("ui.hour_quota", { p0: w.windowDurationMins / 60 })) : fallback; + return `${tr("ui.every")}${state.settings.pollSeconds}${tr("ui.sec_with_live_updates")}
${tr("ui.save_the_chat_and_wait_for_all")}
${tr("ui.resume_at")}${state.settings.minimumRemaining}${tr("ui.resume_percent_suffix")}
${tr("ui.direct_work_stops_when_completed_blocked_or")}${state.settings.maxRounds}${tr("ui.rounds_original_chats")}${esc(wakeExplanation)}${tr("ui.each_record_can_send_up_to")}${state.settings.maxWakeSends}${tr("ui.messages")}
${esc(systemText(log))}
${tr("ui.activity_will_appear_here_after_your_first")}
`}${esc(a.reason)}
${esc(a.command || a.method)}
+${esc(a.cwd)}${a.requiresDetails ? `${tr("ui.full_approval_details_are_not_loaded_refresh")}
` : ''}${tr("ui.the_local_service_must_stay_running_work")}${watcher}。
${tr("ui.build")}${esc(state.buildId || '')}${tr("ui.protocol")}${state.protocolVersion} ·
${tr("ui.reset_times_come_from_the_server_and")}
`; + else if (page === 'logs') html = `${heading(tr("ui.activity_log"), tr("ui.shows_the_latest_events_export_up_to"), ``)}| ${tr("ui.time")} | ${tr("ui.type")} | ${tr("ui.activity")} |
|---|---|---|
| ${new Date(l.time).toLocaleDateString(locale())} ${time(l.time)} | ${({ success: tr("ui.success"), warning: tr("ui.attention"), info: tr("ui.info") })[l.type]} | ${esc(systemText(l))} |
${tr("ui.choose_a_local_chat_to_manage_monitoring")}
${tr("ui.no_chats_available_to_import")}
`}${esc(JSON.stringify(health, null, 2))}`); return; }
+ if (action === 'detail') { openModal(''); selectedTask = id; renderDetail(id); return; }
+ if (action === 'edit-message') {
+ const summary = state.tasks.find(task => task.id === id), task = summary && taskDetails.read(summary);
+ if (!task || task.mode !== 'quota-wake') throw Error(tr("ui.only_monitored_chats_support_editing_continuation_messages"));
+ if (!taskDetails.ready(summary)) throw Error(tr("ui.wait_for_the_full_work_details_to"));
+ openLocalized(() => `${modalHead(tr("ui.edit_continuation_message"))}${continuationEditor(task, esc)}`); return;
+ }
+ if (action === 'import') { await importModal(); return; }
+ if (action === 'more-threads') { await importModal(button.dataset.cursor, true); return; }
+ if (action === 'choose-thread') {
+ openLocalized(() => modalHead(tr("ui.monitor_original_chat_quota")) + monitorImportForm(id));
+ return;
+ }
+ if (action === 'export') { const logs = await api('/api/logs'); const blob = new Blob([JSON.stringify(logs.logs, null, 2)], { type: 'application/json' }); const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'continuer-logs.json'; a.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); return; }
+ button.disabled = true;
+ if (action === 'storage-retry' || action === 'storage-backup') { state = await api('/api/storage/recover', { source: action === 'storage-backup' ? 'backup' : 'retry' }); toast(tr("ui.storage_recovered_scheduling_remains_off")); }
+ else if (action === 'refresh') { state = await api('/api/refresh', {}); toast(state.connection.status === 'connected' ? tr("ui.quota_synced") : tr("ui.connection_failed_check_the_notice")); }
+ else if (action === 'scheduler') { state = await api('/api/settings', { enabled: !state.settings.enabled }); toast(state.settings.enabled ? tr("ui.scheduling_enabled") : tr("ui.scheduling_paused")); }
+ else if (action === 'continuous') { state = await api(`/api/tasks/${id}`, { action, value: !state.tasks.find(t => t.id === id).continuous }); }
+ else if (['pause', 'resume', 'complete'].includes(action)) { const wake = state.tasks.find(t => t.id === id)?.mode === 'quota-wake'; state = await api(`/api/tasks/${id}`, { action }); toast(wake ? (action === 'resume' ? tr("ui.monitoring_enabled") : action === 'complete' ? tr("ui.monitoring_ended_and_removed") : tr("ui.monitoring_paused")) : (action === 'resume' ? tr("ui.work_queued") : action === 'complete' ? tr("ui.marked_complete") : tr("ui.pause_requested"))); }
+ else if (action === 'approve' || action === 'decline') { if (action === 'approve' && !approvalDetails.ready(state.approvals.find(item => String(item.id) === id && item.detailToken === token))) throw Error(tr("ui.wait_for_the_full_approval_details_to")); state = await api('/api/approval', { id, token, decision: action === 'approve' ? 'accept' : 'decline' }); }
+ else if (action === 'exhaust' || action === 'recover') { state = await api('/api/demo/quota', { exhausted: action === 'exhaust' }); toast(action === 'exhaust' ? tr("ui.simulated_quota_exhausted") : tr("ui.simulated_quota_recovered")); }
+ render();
+ } catch (error) { toast(systemText(error)); } finally { button.disabled = false; }
+ });
+ document.addEventListener('submit', async event => {
+ const form = event.target; event.preventDefault();
+ const values = Object.fromEntries(new FormData(form));
+ const submit = form.querySelector('[type="submit"],button.primary'); submit.disabled = true;
+ try {
+ if (form.id === 'task-form') { state = await api('/api/tasks', { ...values, continuous: values.continuous === 'on' }); modal.close(); toast(tr("ui.work_created")); }
+ else if (form.id === 'import-form') { state = await api('/api/import', { ...values, threadId: form.dataset.id }); modal.close(); toast(tr("ui.chat_imported_monitoring_stays_paused")); }
+ else if (form.id === 'message-form') { state = await api(`/api/tasks/${encodeURIComponent(form.dataset.id)}`, { action: 'message', value: values.continuationMessage }); taskDetails.clear(); modal.close(); toast(tr("ui.continuation_message_saved")); }
+ else if (form.id === 'settings-form') { state = await api('/api/settings', Object.fromEntries(Object.entries(values).map(([k, v]) => [k, Number(v)]))); document.activeElement?.blur(); toast(tr("ui.settings_saved")); }
+ render();
+ } catch (error) { const errorEl = form.querySelector('.form-error'); if (errorEl) setFormError(errorEl, error); else toast(systemText(error)); }
+ finally { submit.disabled = false; }
+ });
+ $('#language').addEventListener('change', async event => { const input = event.target; input.disabled = true; try { state = await api('/api/settings', { language: input.value }); render(); } catch (error) { toast(systemText(error)); applyStaticLanguage(); } finally { input.disabled = false; } });
+ $('#theme').addEventListener('click', () => { document.body.classList.toggle('dark'); localStorage.setItem('continuer-theme', document.body.classList.contains('dark') ? 'dark' : 'light'); });
+ if (localStorage.getItem('continuer-theme') === 'dark') document.body.classList.add('dark');
+ modal.addEventListener('close', () => { if (modal.open) return; modalRenderer = null; importList = null; selectedTask = null; taskDetails.clear(); });
+ const stream = new VisibleFeed({ ...(environment.createSource ? { create: environment.createSource } : {}), visible: () => !document.hidden, receive: data => { streamAlive = true; state = data; render(); }, error: () => { streamAlive = false; if (state) render(); else setHtml(main, `${esc(JSON.stringify(health, null, 2))}`); return; }
- if (action === 'detail') { openModal(''); selectedTask = id; renderDetail(id); return; }
- if (action === 'import') { await importModal(); return; }
- if (action === 'more-threads') { await importModal(button.dataset.cursor, true); return; }
- if (action === 'choose-thread') { openModal(`${modalHead('监测原聊天额度')}`); return; }
- if (action === 'export') { const logs = await api('/api/logs'); const blob = new Blob([JSON.stringify(logs.logs, null, 2)], { type: 'application/json' }); const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'continuer-logs.json'; a.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); return; }
- button.disabled = true;
- if (action === 'storage-retry' || action === 'storage-backup') { state = await api('/api/storage/recover', { source: action === 'storage-backup' ? 'backup' : 'retry' }); toast('恢复完成，调度保持关闭'); }
- else if (action === 'refresh') { state = await api('/api/refresh', {}); toast(state.connection.status === 'connected' ? '额度已同步' : '连接未成功，请查看提示'); }
- else if (action === 'scheduler') { state = await api('/api/settings', { enabled: !state.settings.enabled }); toast(state.settings.enabled ? '自动调度已开启' : '自动调度已暂停'); }
- else if (action === 'continuous') { state = await api(`/api/tasks/${id}`, { action, value: !state.tasks.find(t => t.id === id).continuous }); }
- else if (['pause', 'resume', 'complete'].includes(action)) { const wake = state.tasks.find(t => t.id === id)?.mode === 'quota-wake'; state = await api(`/api/tasks/${id}`, { action }); toast(wake ? (action === 'resume' ? '额度监测已开启' : action === 'complete' ? '监测已结束并移除' : '额度监测已暂停') : (action === 'resume' ? '工作已加入队列' : action === 'complete' ? '已标记完成' : '已请求暂停')); }
- else if (action === 'approve' || action === 'decline') { if (action === 'approve' && !approvalDetails.ready(state.approvals.find(item => String(item.id) === id && item.detailToken === token))) throw Error('请先等待完整授权内容加载'); state = await api('/api/approval', { id, token, decision: action === 'approve' ? 'accept' : 'decline' }); }
- else if (action === 'exhaust' || action === 'recover') { state = await api('/api/demo/quota', { exhausted: action === 'exhaust' }); toast(action === 'exhaust' ? '模拟额度已耗尽' : '模拟额度已恢复'); }
- render();
- } catch (error) { toast(error.message); } finally { button.disabled = false; }
-});
-document.addEventListener('submit', async event => {
- const form = event.target; event.preventDefault();
- const values = Object.fromEntries(new FormData(form));
- const submit = form.querySelector('[type="submit"],button.primary'); submit.disabled = true;
- try {
- if (form.id === 'task-form') { state = await api('/api/tasks', { ...values, continuous: values.continuous === 'on' }); modal.close(); toast('工作已创建'); }
- else if (form.id === 'import-form') { state = await api('/api/import', { ...values, threadId: form.dataset.id }); modal.close(); toast('会话已导入，监测保持暂停'); }
- else if (form.id === 'settings-form') { state = await api('/api/settings', Object.fromEntries(Object.entries(values).map(([k, v]) => [k, Number(v)]))); document.activeElement?.blur(); toast('设置已保存'); }
- render();
- } catch (error) { const errorEl = form.querySelector('.form-error'); if (errorEl) errorEl.textContent = error.message; else toast(error.message); }
- finally { submit.disabled = false; }
-});
-$('#theme').addEventListener('click', () => { document.body.classList.toggle('dark'); localStorage.setItem('continuer-theme', document.body.classList.contains('dark') ? 'dark' : 'light'); });
-if (localStorage.getItem('continuer-theme') === 'dark') document.body.classList.add('dark');
-modal.addEventListener('close', () => { selectedTask = null; taskDetails.clear(); });
-const stream = new VisibleFeed({ visible: () => !document.hidden, receive: data => { streamAlive = true; state = data; render(); }, error: () => { streamAlive = false; if (state) render(); else setHtml(main, '${esc(state.summaryNotice)}
` : ''; - if (state.persistence?.status === 'error') return summary + `数据保存或读取失败，自动调度已停止：${esc(state.persistence.message)}
${!state.persistence.needsRestore ? '' : ''}${state.persistence.backupAvailable ? '恢复会保留当前主文件副本；恢复后请先核对原聊天与项目状态。
' : ''}当前为查询模式，尚未恢复自动调度。开启调度或明确继续工作后才会执行。
' : ''); + const summary = state.summaryNotice ? `${esc(systemText(state.summaryNotice, state.summaryNoticeInfo))}
` : ''; + if (state.persistence?.status === 'error') return summary + `${tr("ui.data_could_not_be_saved_or_loaded")}${esc(systemText(state.persistence))}
${!state.persistence.needsRestore ? `` : ''}${state.persistence.backupAvailable ? `${tr("ui.a_copy_of_the_current_file_is")}
` : ''}${tr("ui.read_only_mode_work_starts_only_after")}
` : ''); } diff --git a/public/style.css b/public/style.css index 407324b..f306c36 100644 --- a/public/style.css +++ b/public/style.css @@ -16,3 +16,9 @@ body.dark{--bg:#20251f;--surface:#293027;--side:#242a21;--line:#3b4435;--muted:# .banner,body.dark .banner{background:var(--tint);border-color:var(--line)}.banner h3,body.dark .banner h3{color:var(--purple)}.banner p,body.dark .banner p{color:var(--muted)} nav>button.active,body.dark nav>button.active{background:var(--tint);color:var(--purple)}.banner-icon,body.dark .banner-icon{background:var(--surface);border-color:var(--line);color:var(--purple)}.card-bottom,body.dark .card-bottom{background:var(--side)}.count{background:var(--tint);color:var(--purple)} + +.monitor-note{margin:12px 0;padding:10px 12px;border:1px solid var(--line);border-radius:8px;font-size:11px;line-height:1.7;overflow-wrap:anywhere}.monitor-note strong{display:block;font-size:10px;opacity:.7;margin-bottom:4px}.monitor-note span{display:block;white-space:pre-wrap;max-height:10em;overflow:auto}.monitor-note small{display:block;margin-top:4px;opacity:.7} + +.detail-summary{white-space:pre-wrap} +#language{padding:6px 8px;font-size:12px} +.setting-row>div:last-child{flex-shrink:0;white-space:nowrap} diff --git a/public/system-messages.js b/public/system-messages.js new file mode 100644 index 0000000..3d196c7 --- /dev/null +++ b/public/system-messages.js @@ -0,0 +1,587 @@ +// Service-owned messages use stable IDs and explicit parameters. +export const systemMessages = Object.freeze({ + "runtime.widget_ready": { "zh": "挂件已就绪。可使用 Ctrl+Alt+C 展开。", "en": "The widget is ready. Press Ctrl+Alt+C to expand it." }, + "runtime.port_in_use": { "zh": "端口属于其他应用", "en": "Port belongs to another application" }, + "runtime.build_mismatch": { "zh": "运行服务与当前插件构建不一致，请先停止并重新启动 Continuer", "en": "The service and plugin builds differ. Stop and restart Continuer." }, + "runtime.directory_mismatch": { "zh": "该端口服务使用不同的数据目录，请检查路径后重新启动 Continuer", "en": "The service uses a different data directory. Check the paths before restarting Continuer." }, + "runtime.root_mismatch": { "zh": "端口服务使用不同的安装目录，请检查路径后重新启动 Continuer", "en": "The service uses a different installation directory. Check the paths before restarting Continuer." }, + "runtime.exited": { "zh": "Continuer 已退出，请先手动打开挂件。", "en": "Continuer has exited. Open the widget manually first." }, + "runtime.node_missing": { "zh": "缺少 Node.js 路径，请重新运行插件安装器", "en": "Node.js path is missing. Run the plugin installer again." }, + "runtime.service_timeout": { "zh": "本地服务启动失败，请查看数据目录中的 service-stderr.log", "en": "The local service did not become ready. Check service-stderr.log in the data directory." }, + "runtime.desktop_missing": { "zh": "缺少桌面运行时，请在项目目录运行 npm install 后重新构建插件", "en": "Desktop runtime is missing. Run npm install in the project directory and rebuild the plugin." }, + "runtime.widget_timeout": { "zh": "挂件未在时限内就绪，请查看 /api/health 和 widget-stderr.log", "en": "The widget did not become ready in time. Check /api/health and widget-stderr.log." }, + "connection.demo": { "zh": "演示数据 · 不执行真实任务", "en": "Demo data · No real tasks are run" }, + "connection.codex_connected": { "zh": "Codex App Server 已连接", "en": "Codex App Server connected" }, + "task.outcome_missing": { "zh": "本轮已结束，未收到明确的完成状态，请检查输出后继续。", "en": "This turn ended without a clear completion status. Check the output before continuing." }, + "error.project_missing": { "zh": "项目目录不存在", "en": "Project directory does not exist" }, + "error.operation_failed": { "zh": "操作失败，请检查本地服务状态后重试", "en": "Operation failed. Check the local service and retry." }, + "system.summary_truncated": { "zh": "列表内容较多，已精简历史和授权预览；完整内容请打开详情。", "en": "History and approval previews were shortened. Open details for the full content." }, + "log.task_activity": { + "zh": "{name}：{activity}", + "en": "{name}: {activity}" + }, + "task.no_tool_activity": { + "zh": "{summary}（本轮无工具活动，已停止自动续作）", + "en": "{summary} (No tool activity this turn; automatic continuation stopped)" + }, + "error.setting_range": { + "zh": "{name} 必须为 {min}–{max} 的整数", + "en": "{name} must be an integer between {min} and {max}" + }, + "monitor.send_limit": { + "zh": "已达到原聊天发送上限（{sent}/{limit} 次），监测已停止；请查看原聊天确认工作结果", + "en": "Message limit reached ({sent}/{limit}). Monitoring stopped; check results in the original chat." + }, + "task.wait_writer_retry": { + "zh": "原会话被其他 Codex 客户端占用，30 秒后自动重试", + "en": "The original chat is in use by another Codex client. Retrying in 30 seconds." + }, + "task.wait_writer_manual": { + "zh": "原会话被其他 Codex 客户端占用，请等待原会话结束后再继续", + "en": "The original chat is in use by another Codex client. Wait for it to finish before continuing." + }, + "task.wait_thread_retry": { + "zh": "原会话仍在运行，30 秒后自动重试", + "en": "The original chat is still running. Retrying in 30 seconds." + }, + "task.wait_thread_manual": { + "zh": "原会话仍在运行，请等待原会话结束后再继续", + "en": "The original chat is still running. Wait for it to finish before continuing." + }, + "demo.search_ready": { + "zh": "全文索引已建立，等待继续验证搜索结果", + "en": "Full-text index built; continue to verify search results" + }, + "demo.components_ready": { + "zh": "已完成 Button 和 Input，等待继续", + "en": "Button and Input completed; waiting to continue" + }, + "demo.tests_ready": { + "zh": "演示记录：测试用例已补齐", + "en": "Demo record: test cases added" + }, + "demo.started": { + "zh": "演示模式已启动，所有额度与工作记录均为模拟数据", + "en": "Demo mode started. All quota and work records are simulated." + }, + "demo.work_complete": { + "zh": "API 服务 · 单元测试：模拟工作已完成", + "en": "API service · Unit tests: simulated work completed" + }, + "error.enter_a_name_project_directory_and_work_goal": { + "zh": "请填写名称、项目目录和工作目标", + "en": "Enter a name, project directory, and work goal." + }, + "error.name_or_goal_is_too_long": { + "zh": "名称或目标过长", + "en": "Name or goal is too long" + }, + "task.waiting_for_scheduling": { + "zh": "等待调度", + "en": "Waiting for scheduling" + }, + "task.service_restarted_confirm_the_original_chat_has_stopped": { + "zh": "服务重启，请确认原会话已停止后手动继续", + "en": "Service restarted. Confirm the original chat has stopped before resuming manually." + }, + "error.direct_state": { + "zh": "工作任务状态无效", + "en": "Invalid direct work state" + }, + "error.direct_rounds": { + "zh": "工作执行轮次无效", + "en": "Invalid execution round count" + }, + "error.direct_monitor_fields": { + "zh": "工作任务不能包含监测发送状态", + "en": "Direct work cannot contain monitoring delivery fields" + }, + "error.invalid_switch_value": { + "zh": "开关值无效", + "en": "Invalid switch value" + }, + "task.continuous_work_disabled": { + "zh": "持续工作已关闭", + "en": "Continuous work disabled" + }, + "task.pausing": { + "zh": "正在暂停", + "en": "Pausing" + }, + "task.work_paused": { + "zh": "工作已暂停", + "en": "Work paused" + }, + "error.work_is_still_running_or_stopping": { + "zh": "任务尚在运行或停止中", + "en": "Work is still running or stopping" + }, + "task.waiting_for_available_quota": { + "zh": "等待可用额度", + "en": "Waiting for available quota" + }, + "error.pause_the_work_first": { + "zh": "请先暂停任务", + "en": "Pause the work first" + }, + "task.user_marked_complete": { + "zh": "用户确认完成", + "en": "User marked complete" + }, + "error.unsupported_action": { + "zh": "不支持的操作", + "en": "Unsupported action" + }, + "task.backup_restored_check_the_original_chats_and_projects": { + "zh": "已恢复备份，请检查原聊天和项目状态后手动继续", + "en": "Backup restored. Check the original chats and projects before resuming manually." + }, + "error.invalid_utf8": { + "zh": "请求正文不是有效 UTF-8", + "en": "Request body is not valid UTF-8" + }, + "error.request_too_large": { + "zh": "请求过大", + "en": "Request is too large" + }, + "error.invalid_json": { + "zh": "请求正文不是有效 JSON", + "en": "Request body is not valid JSON" + }, + "error.json_object_required": { + "zh": "请求正文必须为 JSON 对象", + "en": "Request body must be a JSON object" + }, + "error.note_alias_conflict": { + "zh": "请仅提供监测备注 note；prompt 为旧版兼容字段", + "en": "Provide only note; prompt is a legacy compatibility field" + }, + "error.work_item_not_found": { + "zh": "任务不存在", + "en": "Work item not found" + }, + "error.stream_limit": { + "zh": "实时连接已达上限，请关闭多余页面", + "en": "Live connection limit reached. Close extra pages." + }, + "error.approval_expired": { + "zh": "授权请求已失效", + "en": "Approval request has expired" + }, + "error.loopback_required": { + "zh": "请使用 127.0.0.1 访问", + "en": "Use 127.0.0.1 to access this service" + }, + "error.cross_origin": { + "zh": "跨站请求被拒绝", + "en": "Cross-origin request rejected" + }, + "error.invalid_origin": { + "zh": "请求来源无效", + "en": "Invalid request origin" + }, + "error.request_rate": { + "zh": "请求过于频繁，请稍后重试", + "en": "Too many requests. Retry later." + }, + "error.api_credentials": { + "zh": "请用启动脚本重新打开 Continuer；本地 API 需要访问凭据", + "en": "Reopen Continuer with the launcher. Local API access requires credentials." + }, + "error.not_found": { + "zh": "接口或页面不存在", + "en": "API route or page not found" + }, + "error.lease_platform": { + "zh": "此平台不支持 Continuer 数据目录互斥锁", + "en": "Continuer data directory locking is unavailable on this platform" + }, + "error.lease_conflict": { + "zh": "同一数据目录已有服务运行，请勿重复启动", + "en": "A service is already running for this data directory" + }, + "error.lease_corrupt": { + "zh": "服务锁损坏，请检查进程后处理 service.lock", + "en": "Service lock is damaged. Check running processes before handling service.lock." + }, + "connection.connecting_to_local_codex": { + "zh": "正在连接本机 Codex…", + "en": "Connecting to local Codex…" + }, + "task.connection_interrupted_check_the_original_work_before_resuming": { + "zh": "连接中断，请检查原任务后手动继续", + "en": "Connection interrupted. Check the original work before resuming manually." + }, + "error.data_could_not_be_saved_recover_storage_before": { + "zh": "数据保存失败，恢复存储后再开启调度", + "en": "Data could not be saved. Recover storage before enabling scheduling." + }, + "error.a_continuation_message_is_still_being_sent_wait": { + "zh": "续作消息仍在发送，请等待发送结果确认后再恢复存储", + "en": "A continuation message is still being sent. Wait for confirmation before recovering storage." + }, + "error.confirm_current_work_has_stopped_before_restoring_a": { + "zh": "请先确认当前工作已停止，再恢复备份", + "en": "Confirm current work has stopped before restoring a backup." + }, + "error.the_main_state_file_is_corrupt_choose_restore": { + "zh": "主状态文件损坏，请明确选择恢复备份", + "en": "The main state file is corrupt. Choose Restore backup to proceed." + }, + "error.invalid_recovery_method": { + "zh": "恢复方式无效", + "en": "Invalid recovery method" + }, + "task.quota_is_low_or_unknown_waiting_for_fresh": { + "zh": "可用额度不足或未知，等待新额度样本", + "en": "Quota is low or unknown. Waiting for fresh data." + }, + "error.up_to_records_are_supported_end_unused_work": { + "zh": "最多管理 100 条记录，请先结束不再需要的工作", + "en": "Up to 100 records are supported. End unused work first." + }, + "log.work_added": { + "zh": "添加工作：{name}", + "en": "Work added: {name}" + }, + "log.scheduling_settings_updated": { + "zh": "调度设置已更新", + "en": "Scheduling settings updated" + }, + "error.this_chat_has_already_been_added": { + "zh": "该会话已添加", + "en": "This chat has already been added" + }, + "error.this_chat_is_being_added_do_not_import": { + "zh": "该会话正在添加，请勿重复导入", + "en": "This chat is being added. Do not import it again." + }, + "log.chat_added": { + "zh": "已添加会话：{name}", + "en": "Chat added: {name}" + }, + "task.monitoring_quota_a_continuation_message_will_be_sent": { + "zh": "正在监测额度；确认耗尽后，恢复时向原聊天发送续作消息", + "en": "Monitoring quota. A continuation message will be sent after confirmed exhaustion and recovery." + }, + "task.quota_recovery_monitoring_paused": { + "zh": "额度恢复续作已暂停", + "en": "Quota recovery monitoring paused" + }, + "error.monitoring_notes_must_be_text_of_up_to": { + "zh": "监测备注必须为不超过 12000 字符的文本", + "en": "Monitoring notes must be text of up to 12,000 characters." + }, + "error.continuation_messages_must_be_text_of_up_to": { + "zh": "续作消息必须为不超过 12000 字符的文本", + "en": "Continuation messages must be text of up to 12,000 characters." + }, + "task.chat_added_enable_monitoring_to_send_a_message": { + "zh": "会话已添加，开启额度监测后在恢复时发送续作消息；工作结果请在原聊天确认", + "en": "Chat added. Enable monitoring to send a message after quota recovery. Check results in the original chat." + }, + "task.this_legacy_record_lacks_proof_of_quota_exhaustion": { + "zh": "旧监测记录缺少额度耗尽依据，请检查原聊天后重新开启监测", + "en": "This legacy record lacks proof of quota exhaustion. Check the original chat before enabling monitoring again." + }, + "task.the_previous_delivery_is_unconfirmed_check_the_original": { + "zh": "上次发送结果未确认，请检查原聊天后重新开启监测", + "en": "The previous delivery is unconfirmed. Check the original chat before enabling monitoring again." + }, + "error.monitor_state": { + "zh": "额度监测状态无效", + "en": "Invalid monitoring state" + }, + "error.monitor_count": { + "zh": "额度监测发送次数或旧计数无效", + "en": "Invalid monitoring delivery count or legacy counter" + }, + "error.monitor_delivery": { + "zh": "额度监测发送状态无效", + "en": "Invalid monitoring delivery state" + }, + "log.continuation_message_updated": { + "zh": "续作消息已更新", + "en": "Continuation message updated" + }, + "task.monitoring_paused_delivery_is_still_unconfirmed_check_the": { + "zh": "监测已暂停，发送结果仍需确认；请核对原聊天，已发出的消息无法撤回", + "en": "Monitoring paused. Delivery is still unconfirmed; check the original chat. Sent messages cannot be recalled." + }, + "error.delivery_is_still_being_confirmed_wait_before_enabling": { + "zh": "续作消息发送结果仍在确认，请等待后再开启或结束监测", + "en": "Delivery is still being confirmed. Wait before enabling or ending monitoring." + }, + "error.message_limit_reached_raise_the_limit_then_enable": { + "zh": "已达到原聊天发送次数上限，请提高发送上限后再开启监测；累计次数不会重置", + "en": "Message limit reached. Raise the limit, then enable monitoring. Counts do not reset." + }, + "log.monitoring_ended_check_results_in_the_original_chat": { + "zh": "已结束监测：{name}；工作结果请在原聊天确认", + "en": "Monitoring ended: {name}; check results in the original chat" + }, + "task.the_delivery_record_could_not_be_saved_check": { + "zh": "发送记录保存失败，请检查原聊天后手动继续", + "en": "The delivery record could not be saved. Check the original chat before resuming manually." + }, + "error.project_path": { + "zh": "项目目录必须是本地盘符绝对路径", + "en": "Project directory must be an absolute local drive path" + }, + "error.project_path_kind": { + "zh": "项目目录必须是本地盘符绝对路径，不支持网络或设备路径", + "en": "Project directory must be an absolute local drive path; network and device paths are unsupported" + }, + "error.project_directory": { + "zh": "项目目录必须是存在的本地目录", + "en": "Project directory must be an existing local directory" + }, + "error.queue_timeout": { + "zh": "Codex 队列请求超时", + "en": "Codex queue request timed out" + }, + "error.queue_failed": { + "zh": "Codex 队列请求失败 ({code})", + "en": "Codex queue request failed ({code})" + }, + "error.invalid_original_chat_id": { + "zh": "原聊天 ID 无效", + "en": "Invalid original chat ID" + }, + "error.codex_message_queue_unavailable_update_the_desktop_app": { + "zh": "Codex 消息队列不可用，请更新桌面端或设置 CODEX_QUEUE_BINARY", + "en": "Codex message queue unavailable. Update the desktop app or set CODEX_QUEUE_BINARY." + }, + "error.paused_no_continuation_message_sent": { + "zh": "已暂停，未发送续作消息", + "en": "Paused; no continuation message sent" + }, + "error.delivery_unconfirmed_check_the_original_chat": { + "zh": "发送结果未确认，请检查原聊天：{reason}", + "en": "Delivery unconfirmed. Check the original chat: {reason}" + }, + "task.quota_exhaustion_confirmed_one_continuation_message_will_be": { + "zh": "已确认额度耗尽，恢复后向原聊天发送一次续作消息", + "en": "Quota exhaustion confirmed. One continuation message will be sent after recovery." + }, + "task.quota_recovered_waiting_for_message_delivery_to_become": { + "zh": "额度已恢复，等待消息发送通道", + "en": "Quota recovered. Waiting for message delivery to become available." + }, + "error.the_last_instruction_already_received_a_complete_reply": { + "zh": "原聊天自上次指令后已形成完整回复，已跳过本次续作消息", + "en": "The last instruction already received a complete reply. This continuation message was skipped." + }, + "error.the_original_chat_is_still_replying_no_continuation": { + "zh": "原聊天仍在回复，暂不发送续作消息", + "en": "The original chat is still replying. No continuation message sent yet." + }, + "error.reply_status_could_not_be_confirmed_no_continuation": { + "zh": "无法确认原聊天回复状态，暂不发送续作消息，稍后重试", + "en": "Reply status could not be confirmed. No continuation message sent; retrying later." + }, + "task.quota_recovered_sending_a_continuation_message_to_the": { + "zh": "额度已恢复，正在向原聊天发送续作消息", + "en": "Quota recovered. Sending a continuation message to the original chat." + }, + "task.continuation_message_queued_monitoring_continues_check_results_in": { + "zh": "已向原聊天排队发送续作消息，继续监测；工作结果请在原聊天确认", + "en": "Continuation message queued. Monitoring continues; check results in the original chat." + }, + "task.continuation_message_queued_monitoring_paused_queued_messages_can": { + "zh": "已向原聊天排队发送续作消息，监测已暂停；已排队消息无法撤回", + "en": "Continuation message queued. Monitoring paused; queued messages cannot be recalled." + }, + "error.codex_exit": { + "zh": "Codex 进程已退出 ({code})", + "en": "Codex process exited ({code})" + }, + "error.codex_connection": { + "zh": "Codex 连接已失效", + "en": "Codex connection is no longer valid" + }, + "error.codex_disconnected": { + "zh": "Codex 未连接", + "en": "Codex is not connected" + }, + "error.rpc_timeout": { + "zh": "{method} 请求超时，请检查连接", + "en": "{method} request timed out. Check the connection." + }, + "error.codex_connection_closed": { + "zh": "Codex 连接已关闭", + "en": "Codex connectionOff" + }, + "error.storage_shape": { + "zh": "状态文件结构无效", + "en": "Invalid state file structure" + }, + "error.storage_version": { + "zh": "状态文件版本不兼容", + "en": "Incompatible state file version" + }, + "error.storage_history": { + "zh": "活动或额度历史格式无效", + "en": "Invalid activity or quota history" + }, + "error.storage_settings": { + "zh": "状态文件设置无效", + "en": "Invalid state file settings" + }, + "error.storage_send_limit": { + "zh": "状态文件发送上限无效", + "en": "Invalid state file delivery limit" + }, + "error.task_duplicate": { + "zh": "任务记录无效或 ID 重复", + "en": "Invalid task record or duplicate ID" + }, + "error.thread_duplicate": { + "zh": "状态中存在重复会话，请检查备份后恢复", + "en": "Duplicate chats in state. Check the backup before restoring." + }, + "error.storage_size": { + "zh": "状态文件超过 64 MiB，请检查后恢复备份", + "en": "State file exceeds 64 MiB. Inspect it before restoring a backup." + }, + "error.storage_missing": { + "zh": "主状态文件缺失，但存在备份，请明确恢复", + "en": "Primary state file is missing but a backup exists. Restore it explicitly." + }, + "error.storage_unrecovered": { + "zh": "状态未恢复，禁止覆盖原文件：{reason}", + "en": "State has not been restored; the original file cannot be overwritten: {reason}" + }, + "error.task_mode": { + "zh": "任务模式无效", + "en": "Invalid task mode" + }, + "error.task_record": { + "zh": "任务记录无效", + "en": "Invalid task record" + }, + "error.task_switch": { + "zh": "任务开关无效", + "en": "Invalid task switch" + }, + "error.task_fields": { + "zh": "任务目标、备注、续作消息或输出字段无效", + "en": "Invalid task goal, note, continuation message, or output fields" + }, + "error.monitor_execution": { + "zh": "额度监测记录不能启动执行轮次", + "en": "A monitoring record cannot start an execution turn" + }, + "task.start_cancelled_waiting_for_active_scheduling_and_fresh": { + "zh": "启动已取消，等待有效调度和新鲜额度", + "en": "Start cancelled. Waiting for active scheduling and fresh quota." + }, + "task.resuming_chat": { + "zh": "正在恢复会话…", + "en": "Resuming chat…" + }, + "task.automatic_turn_limit_reached_resume_manually_to_continue": { + "zh": "已达到自动执行轮次上限，请手动继续", + "en": "Automatic turn limit reached. Resume manually to continue." + }, + "error.no_valid_turn_id_received_check_the_original": { + "zh": "未收到有效的轮次 ID，请检查原会话后手动继续", + "en": "No valid turn ID received. Check the original chat before resuming manually." + }, + "log.work_started": { + "zh": "开始工作：{name}", + "en": "Work started: {name}" + }, + "task.startup_events_exceeded_the_buffer_limit_interrupting_check": { + "zh": "启动期间通知超过缓存上限，正在中断，请检查原会话后手动继续", + "en": "Startup events exceeded the buffer limit. Interrupting; check the original chat before resuming." + }, + "task.interruption_unconfirmed": { + "zh": "未确认中断：{reason}", + "en": "Interruption unconfirmed: {reason}" + }, + "task.codex_is_working_on_the_goal": { + "zh": "Codex 正在处理目标", + "en": "Codex is working on the goal" + }, + "task.plan_updated": { + "zh": "计划已更新", + "en": "Plan updated" + }, + "task.running_a_command": { + "zh": "正在执行命令", + "en": "Running a command" + }, + "task.editing_files": { + "zh": "正在修改文件", + "en": "Editing files" + }, + "task.analyzing": { + "zh": "正在分析", + "en": "Analyzing" + }, + "task.generating_a_response": { + "zh": "正在生成回复", + "en": "Generating a response" + }, + "task.calling_a_tool": { + "zh": "正在调用工具", + "en": "Calling a tool" + }, + "task.working": { + "zh": "正在工作", + "en": "Working" + }, + "task.this_turn_failed": { + "zh": "本轮执行失败", + "en": "This turn failed" + }, + "task.waiting_for_your_approval": { + "zh": "等待你批准操作", + "en": "Waiting for your approval" + }, + "log.is_awaiting_approval": { + "zh": "{name} 等待操作授权", + "en": "{name} is awaiting approval" + }, + "task.file_changes_cannot_be_fully_reviewed_and_were": { + "zh": "文件修改范围无法完整审阅，已拒绝；请在原 Codex 中核对后手动继续", + "en": "File changes cannot be fully reviewed and were declined. Review them in the original Codex chat before resuming." + }, + "task.user_input_is_required_respond_in_codex_before": { + "zh": "需要用户输入，请在 Codex 中处理后继续", + "en": "User input is required. Respond in Codex before resuming." + }, + "task.approval_details_cannot_be_fully_reviewed_and_were": { + "zh": "授权内容超出可审阅范围，已拒绝，请在原 Codex 会话核对后继续", + "en": "Approval details cannot be fully reviewed and were declined. Review them in the original Codex chat before resuming." + }, + "error.recover_data_storage_before_handling_approvals": { + "zh": "请先恢复数据保存，再处理授权", + "en": "Recover data storage before handling approvals." + }, + "error.approval_expired_or_decision_invalid": { + "zh": "授权请求已过期或决定无效", + "en": "Approval expired or decision invalid" + }, + "error.approval_details_cannot_be_fully_reviewed_handle_this": { + "zh": "授权内容无法完整审阅，请在原 Codex 中处理", + "en": "Approval details cannot be fully reviewed. Handle this in the original Codex chat." + }, + "error.the_approval_turn_is_no_longer_active_or": { + "zh": "授权所属轮次已失效或正在暂停", + "en": "The approval turn is no longer active or is pausing" + }, + "task.more_operations_await_approval": { + "zh": "仍有操作等待授权", + "en": "More operations await approval" + }, + "task.approved_continuing": { + "zh": "已批准，继续执行", + "en": "Approved; continuing" + }, + "task.operation_declined": { + "zh": "已拒绝操作", + "en": "Operation declined" + } +}); diff --git a/public/task-details.js b/public/task-details.js index b55b5d9..1d9b40a 100644 --- a/public/task-details.js +++ b/public/task-details.js @@ -8,12 +8,13 @@ export class TaskDetails { slot.pending = true; slot.revision = revision; this.request(`/api/tasks/${encodeURIComponent(summary.id)}`).then(result => { if (this.slot !== slot) return; - slot.task = result.task; slot.pending = false; this.changed(); + slot.task = result.task; slot.taskRevision = revision; slot.pending = false; this.changed(); }).catch(error => { if (this.slot === slot) { slot.pending = false; slot.revision = undefined; slot.retryAt = Date.now() + 2000; this.error(error); } }); } const result = { ...slot.task, ...summary }; - if (slot.task && slot.revision === revision) for (const key of ['cwd', 'activity', 'name']) if (key in slot.task) result[key] = slot.task[key]; + if (slot.task && slot.taskRevision === revision) for (const key of ['cwd', 'activity', 'activityMessage', 'name']) if (key in slot.task) result[key] = slot.task[key]; return result; } + ready(summary) { return !!this.slot?.task && this.slot.id === summary.id && !this.slot.pending && this.slot.taskRevision === (summary.detailRevision ?? 0); } clear() { this.slot = null; } } diff --git a/public/task-forms.js b/public/task-forms.js new file mode 100644 index 0000000..ef15c6b --- /dev/null +++ b/public/task-forms.js @@ -0,0 +1,55 @@ +import { t as tr } from './i18n.js'; +import { wakeExplanation } from './task-mode.js'; +import { escapeHtml as esc } from './html.js'; +import { icon } from './icons.js'; + +export function newTaskForm({ layout = 'page', pickDirectory = false } = {}) { + const page = layout === 'page', fieldClass = page ? 'form-field' : ''; + const directory = ``; + const directoryControl = page + ? `${directory}${tr("ui.enter_an_absolute_path_to_an_existing")}` + : `${directory}${pickDirectory ? `` : ''}`; + const submit = page ? tr("ui.create_work", { p0: icon('arrow') }) : tr("ui.create_and_queue"); + const actions = page + ? `` + : ``; + return `${page ? `${tr("ui.give_your_project_a_clear_goal_continuer")}
` : ''} + `; +} + +export function monitorImportForm(threadId, { layout = 'page', thread = null } = {}) { + const page = layout === 'page', fieldClass = page ? 'form-field' : '', hint = page ? 'subtitle' : 'hint'; + const preview = thread ? `${esc(thread.name || thread.preview || tr("ui.codex_chat"))}${esc(thread.cwd)}
` : ''; + const label = thread ? tr("ui.add_to_my_work") : tr("ui.import_chat"); + const button = ``; + const actions = page + ? `+ ${tr("ui.monitoring_note")}${esc(note) || tr("ui.not_provided")} + ${task.noteTruncated ? `${tr("ui.see_details_for_the_full_note")}` : ''} +
`; +} + +function controlButton(view, layout) { + if (!view.control) return ''; + const { action, label } = view.control; + const buttonIcon = layout === 'page' ? icon(isTaskActive(view.task) ? 'pause' : 'play') : ''; + return ``; +} + +function pageTaskCard(view) { + const { task, mode, progress } = view; + return `${esc(view.activity)}
+${esc(mode.counter)}
+${tr("ui.continuation_message")}
${esc(task.continuationMessage?.trim() || defaultContinuation(settings.language))}
${esc(wakeExplanation)}
`; +} + +function planDetails(view, layout) { + const steps = view.task.plan || []; + if (layout === 'widget') { + return `${tr("ui.the_percentage_shows_completed_plan_steps_only")}
`; +} + +function outputDetails(view, layout, hint) { + if (view.mode.wake) return ''; + const task = view.task; + const notice = task.outputTruncated + ? `${tr("ui.only_the_end_of_long_output_is")}
` : ''; + if (layout === 'widget') return notice + (task.output ? `${esc(task.output)}` : '');
+ return `${esc(task.output || tr("ui.no_output_yet"))}`;
+}
+
+export function taskDetailHtml(task, settings, { layout = 'page', canEdit = false } = {}) {
+ const view = taskPresentation(task, settings), page = layout === 'page';
+ const hint = page ? 'subtitle' : 'hint';
+ const complete = view.canComplete ? `` : '';
+ const context = page
+ ? `${badge(view)}${esc(task.cwd)}
` + : `${esc(task.cwd)}
${esc(view.label)} · ${esc(view.mode.counter)}
${tr("ui.current_status")}${esc(view.activity)} · ${esc(view.mode.counter)}
` + : `${esc(view.activity)}
`; + const thread = page && task.threadId ? `${tr("ui.chat")}${esc(task.threadId)}
` : ''; + const actions = page + ? `${esc(view.mode.description)}
`; + const details = view.mode.wake ? monitorDetails(view, settings, canEdit, hint) : planDetails(view, layout); + return `${page ? context + description : description + context}${details}${activity}${thread}${outputDetails(view, layout, hint)}${actions}`; +} diff --git a/public/widget.css b/public/widget.css index adad780..b3f923a 100644 --- a/public/widget.css +++ b/public/widget.css @@ -4,8 +4,11 @@ #mini.has-art #mini-open{animation:readout-art-cycle 60s ease-in-out infinite;animation-play-state:paused} #mini.has-art[data-motion=running] #mini-open{animation-play-state:running} @keyframes readout-art-cycle{0%,20%{opacity:1}21.1667%,64.1667%{opacity:0}65.5%,100%{opacity:1}} -/* Keep quota information visible throughout the decorative artwork cycle. */ +/* Hide quota text during the spacecraft flight, then restore it above the lower signal. */ #gauge-readout{opacity:1} +#mini.has-art #gauge-readout{animation:readout-flight 60s linear infinite;animation-play-state:paused} +#mini.has-art[data-motion=running] #gauge-readout{animation-play-state:running} +@keyframes readout-flight{0%,20%{opacity:1}21%,30.5%{opacity:0}31.5%,100%{opacity:1}} #mini.is-refreshing #quota-readout{animation:quota-reload 1s cubic-bezier(.37,0,.63,1) both} @keyframes quota-reload{0%,100%{opacity:1}45%,55%{opacity:0}} @keyframes beacon{0%,100%{opacity:.5}50%{opacity:1}}.size-setting>span{display:flex;flex-direction:column;align-items:flex-end;gap:5px}.size-setting output{font:10px var(--mono);color:var(--accent)}#compact-size{width:130px;padding:0;accent-color:var(--accent);border:0;background:transparent}.browser{min-height:100dvh;background:var(--bg)}.browser .shell{width:min(416px,100%);height:min(704px,calc(100dvh - 16px));margin:auto;transition:width .28s ease,height .28s ease,border-radius .28s ease,background-color .28s ease}.browser.collapsed .shell{width:var(--disc-size);height:var(--disc-size)}.browser #quit,.browser #follow-label,.browser #reset-position{display:none}@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation:none!important;transition:none!important}}@media(max-width:340px){.scroll{padding:4px 11px 10px}header{padding:13px 10px;gap:3px}.brand strong{font-size:13px;letter-spacing:.7px}.brand small{letter-spacing:1px}.quota{padding:11px}.quota strong{font-size:32px}.scheduler strong span{display:none}.section-label em{padding-right:5px;margin-right:3px}} @@ -39,3 +42,11 @@ body:not(.browser).is-switching:not(.collapsed) #panel{opacity:1;visibility:visi body:not(.browser).is-switching header{-webkit-app-region:no-drag} /* Storage diagnostics share the existing compact panel palette. */ .storage-warning{margin:10px 0;padding:10px;border:1px solid var(--line);border-radius:8px;font-size:11px;line-height:1.6}.storage-warning p{margin:4px 0}.storage-warning button{margin:4px 4px 4px 0} + +.monitor-note{margin:12px 0;padding:10px 12px;border:1px solid var(--line);border-radius:8px;font-size:11px;line-height:1.7;overflow-wrap:anywhere}.monitor-note strong{display:block;font-size:10px;opacity:.7;margin-bottom:4px}.monitor-note span{display:block;white-space:pre-wrap;max-height:10em;overflow:auto}.monitor-note small{display:block;margin-top:4px;opacity:.7} + +.detail-summary{white-space:pre-wrap} +.modal-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:14px}.form-error{color:var(--orange);font-size:11px;line-height:1.5} +#language{background:var(--card);color:var(--text);border:1px solid var(--line);border-radius:4px;padding:3px 1px;font-size:10px;max-width:69px;-webkit-app-region:no-drag} +html[lang=en-US] .brand small{font-size:8px;letter-spacing:0}html[lang=en-US] .brand strong{font-size:12px}html[lang=en-US] .scheduler strong>span{display:none} +html[lang=en-US] #mini-window{font-size:7px;letter-spacing:0}html[lang=en-US] .task-bottom{gap:6px;flex-wrap:wrap}html[lang=en-US] .task-bottom>div{margin-left:auto} diff --git a/public/widget.html b/public/widget.html index 751dbc5..3726e57 100644 --- a/public/widget.html +++ b/public/widget.html @@ -1,48 +1,48 @@ -正在连接本地服务…
+正在连接本地服务…
-正在读取工作记录…
${esc(t.activity)}
${esc(taskMode(t, state.settings).counter)}
还没有工作
选择上方对话加入管理，或新建工作。
${esc(a.reason)}
${esc(a.command || a.method)}\n${esc(a.cwd)}${a.requiresDetails ? '完整授权内容尚未加载，请刷新重试。
' : ''}暂无活动
'); - if (!settingsInitialized) { for (const key of ['minimumRemaining', 'pollSeconds', 'maxRounds', 'maxWakeSends']) $(`#settings-form [name=${key}]`).value = state.settings[key]; settingsInitialized = true; } - refreshSessionsIfNeeded(); - updateSessionSelection(); - syncActivity(); - if ($('#modal').open && detailId) { - if (state.tasks.some(t => t.id === detailId)) detail(detailId); - else { $('#modal').close(); detailId = null; } + function updateSessionSelection() { + const t = selectedSession(); + const managed = t && state?.tasks.find(task => task.threadId === t.id); + $('#add-session').disabled = !t; + $('#add-session').textContent = managed ? tr("ui.view_added_work") : tr("ui.add_to_my_work"); + $('#session-preview').textContent = sessionError ? tr("ui.could_not_load_click_chats_to_retry", { p0: systemText(sessionError) }) : t ? `${t.cwd || tr("ui.no_project_directory")}${t.updatedAt ? tr("ui.updated", { p0: new Date(t.updatedAt * 1000).toLocaleString(locale(), { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' }) }) : ''}` : tr("ui.choose_a_chat_sorted_by_most_recently"); } -} -function open(title, html) { detailId = null; $('#modal-title').textContent = title; $('#modal-body').innerHTML = html; $('#error').textContent = ''; if (!$('#modal').open) $('#modal').showModal(); } -function detail(id) { - const summary = state.tasks.find(t => t.id === id); if (!summary) return; - const t = taskDetails.read(summary); - const mode = taskMode(t, state.settings); - $('#modal-title').textContent = t.name; - $('#modal-body').innerHTML = `${esc(mode.description)}
${esc(t.cwd)}
${esc(taskLabel(t))} · ${esc(mode.counter)}
${esc(wakeExplanation)}
` : `${esc(t.activity)}
${!mode.wake && t.outputTruncated ? '输出较长，仅保留末尾预览；完整内容请在原 Codex 会话查看。
' : ''}${!mode.wake && t.output ? `${esc(t.output)}` : ''}${t.status !== 'completed' ? `` : ''}`;
-}
-async function sessions(cursor, append = false) { if (!append) open('导入已有会话', '正在读取本机会话…
'); const data = await api('/api/threads' + (cursor ? `?cursor=${encodeURIComponent(cursor)}` : '')); const remaining = 300 - (append ? $('#modal-body').querySelectorAll('.session').length : 0); const html = (data.data || []).slice(0, remaining).map(t => ``).join(''); if (append) { $('#more')?.remove(); $('#modal-body').insertAdjacentHTML('beforeend', html); } else $('#modal-body').innerHTML = html || '没有可导入的会话
'; if (data.nextCursor && remaining > (data.data || []).length) $('#modal-body').insertAdjacentHTML('beforeend', ``); } -document.addEventListener('click', async e => { const b = e.target.closest('[data-action]'); if (!b) return; const { action, id, token } = b.dataset; try { - if (action === 'sessions-refresh' || action === 'sessions-more') { await readSessions(action === 'sessions-more'); return; } - if (action === 'add-session') { - const t = selectedSession(); if (!t) return; - const managed = state.tasks.find(task => task.threadId === t.id); - if (managed) { open('工作详情', ''); detailId = managed.id; detail(managed.id); return; } - open('监测原聊天额度', ``); return; + async function readSessions(more = false) { + if (sessionLoading) return; + sessionLoading = true; + sessionError = null; + lastSessionAttempt = Date.now(); + const chosen = $('#session-select').value || localStorage.getItem('continuer-selected-session') || ''; + renderSessionOptions(); + try { + const result = await api('/api/threads' + (more && sessionCursor ? `?cursor=${encodeURIComponent(sessionCursor)}` : '')); + const retained = sessionItems.find(t => t.id === ($('#session-select').value || chosen)); + sessionItems = [...new Map([...(more ? sessionItems : []), ...(result.data || []), ...(!more && retained && !(result.data || []).some(t => t.id === retained.id) ? [retained] : [])].map(t => [t.id, t])).values()].slice(0, 300); + sessionCursor = sessionItems.length < 300 ? result.nextCursor : null; + lastSessionRead = Date.now(); + } catch (error) { sessionError = error; } + finally { sessionLoading = false; renderSessionOptions(); } } - if (action === 'new') { open('新建工作', ``); return; } - if (action === 'detail') { open('工作详情', ''); detailId = id; detail(id); return; } - if (action === 'pick') { const path = await bridge.pickDirectory(); if (path) $('#new-form [name=cwd]').value = path; return; } - if (action === 'import' || action === 'more') { await sessions(b.dataset.cursor, action === 'more'); return; } - if (action === 'select-session') { open('监测原聊天额度', ``); return; } - b.disabled = true; - if (action === 'storage-retry' || action === 'storage-backup') { state = await api('/api/storage/recover', { source: action === 'storage-backup' ? 'backup' : 'retry' }); toast('恢复完成，调度保持关闭'); } - else if (action === 'refresh') { state = await api('/api/refresh', {}); toast('额度同步请求已完成'); } - else if (['pause', 'resume', 'complete'].includes(action)) state = await api(`/api/tasks/${encodeURIComponent(id)}`, { action }); - else if (action === 'approve' || action === 'decline') { if (action === 'approve' && !approvalDetails.ready(state.approvals.find(item => String(item.id) === id && item.detailToken === token))) throw Error('请先等待完整授权内容加载'); state = await api('/api/approval', { id, token, decision: action === 'approve' ? 'accept' : 'decline' }); } - render(); -} catch (error) { if ($('#modal').open) $('#error').textContent = error.message; else toast(error.message); } finally { b.disabled = false; } }); -document.addEventListener('change', async e => { const input = e.target; try { if (input.id === 'scheduler') state = await api('/api/settings', { enabled: input.checked }); else if (input.dataset.continuous) state = await api(`/api/tasks/${encodeURIComponent(input.dataset.continuous)}`, { action: 'continuous', value: input.checked }); else if (input.id === 'follow') { applyDesktop(await bridge.control('follow', input.checked)); return; } else return; render(); } catch (error) { toast(error.message); render(); } }); -document.addEventListener('submit', async e => { e.preventDefault(); const form = e.target, values = Object.fromEntries(new FormData(form)), button = form.querySelector('[type=submit]'); button.disabled = true; $('#error').textContent = ''; try { if (form.id === 'new-form') state = await api('/api/tasks', { ...values, continuous: values.continuous === 'on' }); else if (form.id === 'import-form') state = await api('/api/import', { threadId: form.dataset.id, note: values.note }); else if (form.id === 'settings-form') state = await api('/api/settings', Object.fromEntries(Object.entries(values).map(([k, v]) => [k, Number(v)]))); if (form.id !== 'settings-form') $('#modal').close(); render(); toast('已保存'); } catch (error) { if ($('#modal').open) $('#error').textContent = error.message; else toast(error.message); } finally { button.disabled = false; } }); -function setSize(value) { - compactPixels=Math.max(160,Math.min(420,Math.round(Number(value)||256))); - document.documentElement.style.setProperty('--compact-size',`${compactPixels}px`); - $('#compact-size').value=compactPixels; $('#compact-size-value').textContent=`${compactPixels} px`; -} -let nativeTransition,transitionAcknowledged; -function acknowledgeTransition() { - if(!bridge || !nativeTransition || transitionAcknowledged===nativeTransition.id) return; - const id=nativeTransition.id; - transitionAcknowledged=id; - void bridge.control('transition-ready',id).then(result=>{if(nativeTransition?.id===id) applyDesktop(result);}).catch(error=>toast(error.message)); -} -function applyDesktop(s) { - desktopPreferenceError = s.preferenceError || null; - if (desktopPreferenceError) toast(`挂件设置未保存：${desktopPreferenceError}`); - nativeTransition=s.transition; - const expanded=nativeTransition ? nativeTransition.fromExpanded : s.expanded; - if(s.panelSize) { - document.documentElement.style.setProperty('--panel-width',`${s.panelSize.width}px`); - document.documentElement.style.setProperty('--panel-height',`${s.panelSize.height}px`); + const clock = t => t ? new Date(t).toLocaleTimeString(locale(), { hour: '2-digit', minute: '2-digit', hour12: false }) : '—'; + const percent = w => Number.isFinite(w?.usedPercent) ? Math.max(0, Math.min(100, 100 - w.usedPercent)) : null; + function reset(t) { if (!t) return tr("ui.reset_time_unknown"); const m = Math.ceil((t * 1000 - Date.now()) / 60000); return m <= 0 ? tr("ui.waiting_for_recovery_confirmation") : m >= 1440 ? tr("ui.d_h_until_reset", { p0: Math.floor(m / 1440), p1: Math.floor(m % 1440 / 60) }) : m >= 60 ? tr("ui.h_min_until_reset", { p0: Math.floor(m / 60), p1: m % 60 }) : tr("ui.min_until_reset", { p0: m }); } + function windowName(w, fallback) { const m = w?.windowDurationMins; return m ? m >= 1440 ? tr("ui.day_quota", { p0: m / 1440 }) : tr("ui.hour_quota", { p0: m / 60 }) : fallback; } + function toast(text) { $('#toast').textContent = text; $('#toast').classList.add('show'); clearTimeout(timer); timer = setTimeout(() => $('#toast').classList.remove('show'), 3500); } + function card(w, title) { const p = percent(w); return `${tr("ui.no_work_yet")}
${tr("ui.add_a_chat_above_or_create_new")}
${esc(a.reason)}
${esc(a.command || a.method)}
+${esc(a.cwd)}${a.requiresDetails ? `${tr("ui.full_approval_details_are_not_loaded_refresh_2")}
` : ''}${tr("ui.no_activity_yet_2")}
`); + if (!settingsInitialized) { for (const key of ['minimumRemaining', 'pollSeconds', 'maxRounds', 'maxWakeSends']) $(`#settings-form [name=${key}]`).value = state.settings[key]; settingsInitialized = true; } + refreshSessionsIfNeeded(); + renderSessionOptions(); + syncActivity(); + if ($('#modal').open && detailId) { + if (state.tasks.some(t => t.id === detailId)) detail(detailId); + else { $('#modal').close(); detailId = null; } + } + } + function open(title, html) { modalRenderer = null; sessionModal = null; detailId = null; $('#modal-title').textContent = title; $('#modal-body').innerHTML = html; setFormError($('#error'), ''); if (!$('#modal').open) $('#modal').showModal(); } + function openLocalized(render) { + open('', ''); + modalRenderer = () => { const view = render(); $('#modal-title').textContent = view.title; return view.html; }; + refreshLocalizedContent($('#modal-body'), modalRenderer); + } + + function detail(id) { + const summary = state.tasks.find(task => task.id === id); + if (!summary) return; + const task = taskDetails.read(summary); + $('#modal-title').textContent = task.name; + $('#modal-body').innerHTML = taskDetailHtml(task, state.settings, { + layout: 'widget', canEdit: taskDetails.ready(summary), + }); + } + async function sessions(cursor, append = false) { + if (!append) { + const list = { data: [], nextCursor: null, loading: true, error: null }; + openLocalized(() => { + const options = list.data.map(t => ``).join(''); + const empty = list.loading ? `${tr("ui.loading_local_chats")}
` : list.error ? `${tr("ui.chats_unavailable")}
` : `${tr("ui.no_chats_available_to_import")}
`; + const more = list.nextCursor ? `` : ''; + const retry = list.error ? `` : ''; + return { title: tr("ui.import_an_existing_chat"), html: (options || empty) + more + retry }; + }); + sessionModal = { list, render: modalRenderer }; + } + const current = sessionModal; + if (!current) return; + current.list.loading = true; current.list.error = null; setFormError($('#error'), ''); + refreshLocalizedContent($('#modal-body'), current.render); + try { + const result = await api('/api/threads' + (cursor ? `?cursor=${encodeURIComponent(cursor)}` : '')); + if (modalRenderer !== current.render || !$('#modal').open) return; + const remaining = 300 - (append ? current.list.data.length : 0); + current.list.data = [...(append ? current.list.data : []), ...(result.data || []).slice(0, remaining)]; + current.list.nextCursor = remaining > (result.data || []).length ? result.nextCursor : null; + } catch (error) { + current.list.error = error; + if (modalRenderer === current.render && $('#modal').open) setFormError($('#error'), error); + } finally { + current.list.loading = false; + if (modalRenderer === current.render && $('#modal').open) refreshLocalizedContent($('#modal-body'), current.render); + } + } + + + document.addEventListener('click', async e => { const b = e.target.closest('[data-action]'); if (!b) return; const { action, id, token } = b.dataset; try { + if (action === 'sessions-refresh' || action === 'sessions-more') { await readSessions(action === 'sessions-more'); return; } + if (action === 'add-session') { + const t = selectedSession(); if (!t) return; + const managed = state.tasks.find(task => task.threadId === t.id); + if (managed) { open(tr("ui.work_details"), ''); detailId = managed.id; detail(managed.id); return; } + openLocalized(() => ({ + title: tr("ui.monitor_original_chat_quota"), html: monitorImportForm(t.id, { layout: 'widget', thread: t }), + })); + return; + } + if (action === 'new') { + openLocalized(() => ({ title: tr("ui.new_work"), html: newTaskForm({ layout: 'widget', pickDirectory: !!bridge }) })); + return; + } + if (action === 'detail') { open(tr("ui.work_details"), ''); detailId = id; detail(id); return; } + if (action === 'edit-message') { + const summary = state.tasks.find(task => task.id === id), task = summary && taskDetails.read(summary); + if (!task || task.mode !== 'quota-wake') throw Error(tr("ui.only_monitored_chats_support_editing_continuation_messages")); + if (!taskDetails.ready(summary)) throw Error(tr("ui.wait_for_the_full_work_details_to")); + openLocalized(() => ({ title: tr("ui.edit_continuation_message"), html: continuationEditor(task, esc) })); return; + } + if (action === 'pick') { const path = await bridge.pickDirectory(); if (path) $('#new-form [name=cwd]').value = path; return; } + if (action === 'import' || action === 'more') { await sessions(b.dataset.cursor, action === 'more'); return; } + if (action === 'select-session') { + openLocalized(() => ({ title: tr("ui.monitor_original_chat_quota"), html: monitorImportForm(id, { layout: 'widget' }) })); + return; + } + b.disabled = true; + if (action === 'storage-retry' || action === 'storage-backup') { state = await api('/api/storage/recover', { source: action === 'storage-backup' ? 'backup' : 'retry' }); toast(tr("ui.storage_recovered_scheduling_remains_off")); } + else if (action === 'refresh') { state = await api('/api/refresh', {}); toast(tr("ui.quota_sync_requested")); } + else if (['pause', 'resume', 'complete'].includes(action)) state = await api(`/api/tasks/${encodeURIComponent(id)}`, { action }); + else if (action === 'approve' || action === 'decline') { if (action === 'approve' && !approvalDetails.ready(state.approvals.find(item => String(item.id) === id && item.detailToken === token))) throw Error(tr("ui.wait_for_the_full_approval_details_to")); state = await api('/api/approval', { id, token, decision: action === 'approve' ? 'accept' : 'decline' }); } + render(); + } catch (error) { if ($('#modal').open) setFormError($('#error'), error); else toast(systemText(error)); } finally { b.disabled = false; } }); + document.addEventListener('change', async e => { const input = e.target; try { if (input.id === 'language') { input.disabled = true; try { state = await api('/api/settings', { language: input.value }); } finally { input.disabled = false; } } else if (input.id === 'scheduler') state = await api('/api/settings', { enabled: input.checked }); else if (input.dataset.continuous) state = await api(`/api/tasks/${encodeURIComponent(input.dataset.continuous)}`, { action: 'continuous', value: input.checked }); else if (input.id === 'follow') { applyDesktop(await bridge.control('follow', input.checked)); return; } else return; render(); } catch (error) { toast(systemText(error)); render(); } }); + document.addEventListener('submit', async e => { e.preventDefault(); const form = e.target, values = Object.fromEntries(new FormData(form)), button = form.querySelector('[type=submit]'); button.disabled = true; setFormError($('#error'), ''); try { if (form.id === 'new-form') state = await api('/api/tasks', { ...values, continuous: values.continuous === 'on' }); else if (form.id === 'import-form') state = await api('/api/import', { threadId: form.dataset.id, note: values.note, continuationMessage: values.continuationMessage }); else if (form.id === 'message-form') { state = await api(`/api/tasks/${encodeURIComponent(form.dataset.id)}`, { action: 'message', value: values.continuationMessage }); taskDetails.clear(); } else if (form.id === 'settings-form') state = await api('/api/settings', Object.fromEntries(Object.entries(values).map(([k, v]) => [k, Number(v)]))); if (form.id !== 'settings-form') $('#modal').close(); render(); toast(form.id === 'message-form' ? tr("ui.continuation_message_saved") : tr("ui.saved")); } catch (error) { if ($('#modal').open) setFormError($('#error'), error); else toast(systemText(error)); } finally { button.disabled = false; } }); + function setSize(value) { + compactPixels=Math.max(160,Math.min(420,Math.round(Number(value)||256))); + document.documentElement.style.setProperty('--compact-size',`${compactPixels}px`); + $('#compact-size').value=compactPixels; $('#compact-size-value').textContent=`${compactPixels} px`; + } + let nativeTransition,transitionAcknowledged; + function acknowledgeTransition() { + if(!bridge || !nativeTransition || transitionAcknowledged===nativeTransition.id) return; + const id=nativeTransition.id; + transitionAcknowledged=id; + void bridge.control('transition-ready',id).then(result=>{if(nativeTransition?.id===id) applyDesktop(result);}).catch(error=>toast(systemText(error))); + } + function applyDesktop(s) { + desktopPreferenceError = s.preferenceError || null; + if (desktopPreferenceError) toast(tr("ui.widget_settings_were_not_saved", { p0: desktopPreferenceError })); + nativeTransition=s.transition; + const expanded=nativeTransition ? nativeTransition.fromExpanded : s.expanded; + if(s.panelSize) { + document.documentElement.style.setProperty('--panel-width',`${s.panelSize.width}px`); + document.documentElement.style.setProperty('--panel-height',`${s.panelSize.height}px`); + } + document.body.classList.toggle('collapsed',!expanded); + $('#mini').setAttribute('aria-expanded',String(expanded)); + document.body.classList.toggle('is-switching',!!s.transitioning); + $('#follow').checked=s.follow; nativeVisible=!!s.visible; setSize(s.compactSize); + syncView(); + if(nativeTransition && (reducedMotion.matches || Number(getComputedStyle($('.shell')).opacity)<=.001)) acknowledgeTransition(); + } + $('.shell').addEventListener('transitionend',event=>{ + if(event.target===$('.shell') && event.propertyName==='opacity' && Number(getComputedStyle($('.shell')).opacity)<=.001) acknowledgeTransition(); + }); + async function setExpanded(expanded) { + $('#modal').close(); + if(bridge) { try { applyDesktop(await bridge.control('expand',expanded)); } catch(error) { toast(systemText(error)); } } + else { document.body.classList.toggle('collapsed',!expanded); $('#mini').setAttribute('aria-expanded',String(expanded)); syncView(); } + } + let pointerDrag=null,dragSequence=0; + let pointerResult=Promise.resolve({ moved:false }); + $('#mini').addEventListener('pointerdown',e => { + if(e.button!==0 || !e.isPrimary || pointerDrag) return; + const drag={id:e.pointerId,session:++dragSequence,x:e.screenX,y:e.screenY,moved:false}; + pointerDrag=drag; + $('#mini').setPointerCapture(e.pointerId); + drag.started=bridge ? bridge.control('drag-start',drag.session).catch(error => { toast(systemText(error)); return {ok:false}; }) : Promise.resolve({ok:true}); + }); + $('#mini').addEventListener('pointermove',e => { + if(bridge || !pointerDrag || pointerDrag.id!==e.pointerId) return; + if(Math.hypot(e.screenX-pointerDrag.x,e.screenY-pointerDrag.y)>6) pointerDrag.moved=true; + }); + function endPointer(e,cancelled=false) { + if(!pointerDrag || (e && pointerDrag.id!==e.pointerId)) return; + const drag=pointerDrag; pointerDrag=null; + if($('#mini').hasPointerCapture(drag.id)) $('#mini').releasePointerCapture(drag.id); + pointerResult=drag.started.then(async started => { + const result=bridge && started.ok ? await bridge.control('drag-end',{id:drag.session,cancelled}) : {moved:drag.moved}; + return {moved:result.moved || cancelled}; + }).catch(error => { toast(systemText(error)); return {moved:true}; }); + } + $('#mini').addEventListener('pointerup',e => endPointer(e)); + $('#mini').addEventListener('pointercancel',e => endPointer(e,true)); + $('#mini').addEventListener('lostpointercapture',e => endPointer(e,true)); + window.addEventListener('blur',() => endPointer(null,true)); + $('#mini').onclick=async e => { e.preventDefault(); const result=await pointerResult; pointerResult=Promise.resolve({moved:false}); if(!result.moved) void setExpanded(true); }; + $('#mini').addEventListener('keydown',e => { if(e.key==='Enter'||e.key===' ') { e.preventDefault(); void setExpanded(true); } }); + $('#mini').addEventListener('wheel',e => { if(!e.ctrlKey) return; e.preventDefault(); if(!pointerDrag) void changeSize(compactPixels+(e.deltaY<0?16:-16)); },{passive:false}); + async function changeSize(value) { + setSize(value); + if(bridge) { try { applyDesktop(await bridge.control('compact-size',compactPixels)); } catch(error) { toast(systemText(error)); } } + else localStorage.setItem('continuer-compact-size',String(compactPixels)); + } + $('#compact-size').addEventListener('input',e => { void changeSize(e.target.value); }); + $('#collapse').onclick=() => { void setExpanded(false); }; + if(bridge) { + bridge.onState(applyDesktop); bridge.control('state').then(applyDesktop).catch(e=>toast(e.message)); + $('#quit').onclick=()=>bridge.control('quit'); + $('#reset-position').onclick=()=>bridge.control('reset-position').then(()=>toast(tr("ui.widget_position_reset"))); + } else { document.body.classList.add('browser'); setSize(Number(localStorage.getItem('continuer-compact-size'))||256); } + document.addEventListener('visibilitychange',syncView); + $('#session-select').onchange = () => { localStorage.setItem('continuer-selected-session', $('#session-select').value); updateSessionSelection(); }; + $('#close').onclick = () => $('#modal').close(); $('#modal').addEventListener('close', () => { if ($('#modal').open) return; modalRenderer = null; sessionModal = null; detailId = null; taskDetails.clear(); }); + if (localStorage.getItem('continuer-rhine-theme') === 'light') document.body.classList.add('light'); + $('#theme').onclick = () => { document.body.classList.toggle('light'); localStorage.setItem('continuer-rhine-theme', document.body.classList.contains('light') ? 'light' : 'dark'); }; + const stream = new VisibleFeed({ ...(environment.createSource ? { create: environment.createSource } : {}), visible: viewVisible, bootstrap: () => !!bridge && !rendererReady, receive: data => { connected = true; state = data; render(); }, error: () => { connected = false; if (state) render(); else $('#health').textContent = tr("ui.could_not_connect_to_the_local_service_2"); } }); + window.addEventListener('pagehide', () => { stream.close(); nativeVisible = false; syncActivity(); }); + window.addEventListener('pageshow', () => { if (!bridge) nativeVisible = true; syncView(); }); + stream.sync(); } -$('#compact-size').addEventListener('input',e => { void changeSize(e.target.value); }); -$('#collapse').onclick=() => { void setExpanded(false); }; -if(bridge) { - bridge.onState(applyDesktop); bridge.control('state').then(applyDesktop).catch(e=>toast(e.message)); - $('#quit').onclick=()=>bridge.control('quit'); - $('#reset-position').onclick=()=>bridge.control('reset-position').then(()=>toast('挂件位置已重置')); -} else { document.body.classList.add('browser'); setSize(Number(localStorage.getItem('continuer-compact-size'))||256); } -document.addEventListener('visibilitychange',syncView); -$('#session-select').onchange = () => { localStorage.setItem('continuer-selected-session', $('#session-select').value); updateSessionSelection(); }; -$('#close').onclick = () => $('#modal').close(); $('#modal').addEventListener('close', () => { detailId = null; taskDetails.clear(); }); -if (localStorage.getItem('continuer-rhine-theme') === 'light') document.body.classList.add('light'); -$('#theme').onclick = () => { document.body.classList.toggle('light'); localStorage.setItem('continuer-rhine-theme', document.body.classList.contains('light') ? 'light' : 'dark'); }; -const stream = new VisibleFeed({ visible: viewVisible, bootstrap: () => !!bridge && !rendererReady, receive: data => { connected = true; state = data; render(); }, error: () => { connected = false; if (state) render(); else $('#health').textContent = '本地服务连接失败，正在重连…'; } }); -window.addEventListener('pagehide', () => { stream.close(); nativeVisible = false; syncActivity(); }); -window.addEventListener('pageshow', () => { if (!bridge) nativeVisible = true; syncView(); }); -stream.sync(); + +if (typeof document !== 'undefined' && typeof window !== 'undefined') mountWidget(); diff --git a/server/demo.js b/server/demo.js index 32e7a50..766f7ea 100644 --- a/server/demo.js +++ b/server/demo.js @@ -1,3 +1,4 @@ +import { activityFields, messageFields, message as textMessage } from '../public/message.js'; import { EventEmitter } from 'node:events'; import { randomUUID } from 'node:crypto'; @@ -9,7 +10,7 @@ export class DemoRpc extends EventEmitter { async call(method, p = {}) { if (method === 'account/rateLimits/read') return { rateLimitsByLimitId: { codex: { limitId: 'codex', planType: 'plus', primary: { usedPercent: this.used, windowDurationMins: 300, resetsAt: Math.floor(Date.now() / 1000) + 7380 }, secondary: { usedPercent: 42, windowDurationMins: 10080, resetsAt: Math.floor(Date.now() / 1000) + 192600 } } } }; if (method === 'thread/start') return { thread: { id: randomUUID() } }; - if (method === 'thread/read' || method === 'thread/resume') return { thread: { id: p.threadId, name: '示例会话', cwd: 'E:\\projects\\demo', status: { type: 'idle' } } }; + if (method === 'thread/read' || method === 'thread/resume') return { thread: { id: p.threadId, name: '示例会话', cwd: 'E:\\projects\\demo', status: { type: 'idle' }, turns: p.includeTurns ? [{ id: 'demo-quota-turn', status: 'failed', items: [{ type: 'userMessage', id: 'demo-instruction', content: [{ type: 'text', text: '演示续作' }] }], error: { codexErrorInfo: 'usageLimitExceeded' } }] : [] } }; if (method === 'thread/list') return { data: [{ id: 'demo-existing-thread', name: '个人知识库', cwd: 'E:\\projects\\knowledge', preview: '为个人知识库添加全文搜索' }], nextCursor: null }; if (method === 'turn/interrupt') { for (const timer of this.timers.get(p.threadId) || []) clearTimeout(timer); @@ -44,11 +45,11 @@ export function demoState() { return { settings: { enabled: true, pollSeconds: 30, minimumRemaining: 5, maxRounds: 20, maxWakeSends: 20 }, tasks: [ - { id: 'demo-1', name: '个人知识库', cwd: 'E:\\Projects\\knowledge-hub', prompt: '完成个人知识库的全文搜索，并验证搜索结果。', continuous: true, status: 'paused', activity: '全文索引已建立，等待继续验证搜索结果', rounds: 2, plan: [{ step: '建立全文索引', status: 'completed' }, { step: '接入搜索界面', status: 'completed' }, { step: '验证搜索结果', status: 'pending' }], output: '', createdAt: now, updatedAt: now }, - { id: 'demo-2', name: '设计系统 · 组件文档', cwd: 'E:\\Projects\\design-system', prompt: '为组件库补充使用文档与示例。', continuous: false, status: 'paused', activity: '已完成 Button 和 Input，等待继续', rounds: 1, plan: [{ step: '基础组件文档', status: 'completed' }, { step: '布局组件文档', status: 'pending' }, { step: '交互示例', status: 'pending' }, { step: '校验文档', status: 'pending' }], output: '', createdAt: now, updatedAt: now }, - { id: 'demo-3', name: 'API 服务 · 单元测试', cwd: 'E:\\Projects\\api-service', prompt: '完善 API 服务的单元测试。', continuous: false, status: 'completed', activity: '演示记录：测试用例已补齐', rounds: 3, plan: [{ step: '编写用例', status: 'completed' }, { step: '运行验证', status: 'completed' }], output: '', createdAt: now, updatedAt: now }, + { id: 'demo-1', name: '个人知识库', cwd: 'E:\\Projects\\knowledge-hub', prompt: '完成个人知识库的全文搜索，并验证搜索结果。', continuous: true, status: 'paused', ...activityFields(textMessage("demo.search_ready")), rounds: 2, plan: [{ step: '建立全文索引', status: 'completed' }, { step: '接入搜索界面', status: 'completed' }, { step: '验证搜索结果', status: 'pending' }], output: '', createdAt: now, updatedAt: now }, + { id: 'demo-2', name: '设计系统 · 组件文档', cwd: 'E:\\Projects\\design-system', prompt: '为组件库补充使用文档与示例。', continuous: false, status: 'paused', ...activityFields(textMessage("demo.components_ready")), rounds: 1, plan: [{ step: '基础组件文档', status: 'completed' }, { step: '布局组件文档', status: 'pending' }, { step: '交互示例', status: 'pending' }, { step: '校验文档', status: 'pending' }], output: '', createdAt: now, updatedAt: now }, + { id: 'demo-3', name: 'API 服务 · 单元测试', cwd: 'E:\\Projects\\api-service', prompt: '完善 API 服务的单元测试。', continuous: false, status: 'completed', ...activityFields(textMessage("demo.tests_ready")), rounds: 3, plan: [{ step: '编写用例', status: 'completed' }, { step: '运行验证', status: 'completed' }], output: '', createdAt: now, updatedAt: now }, ], - logs: [{ id: 'l1', time: now, type: 'info', message: '演示模式已启动，所有额度与工作记录均为模拟数据' }, { id: 'l2', time: now - 180000, type: 'success', message: 'API 服务 · 单元测试：模拟工作已完成' }], + logs: [{ id: 'l1', time: now, type: 'info', ...messageFields(textMessage("demo.started")) }, { id: 'l2', time: now - 180000, type: 'success', ...messageFields(textMessage("demo.work_complete")) }], history: Array.from({ length: 24 }, (_, i) => ({ time: now - (23 - i) * 300000, values: [{ id: 'codex', used: 18 + Math.floor(i * 2.17) }] })), }; } diff --git a/server/direct-task.js b/server/direct-task.js new file mode 100644 index 0000000..74734f0 --- /dev/null +++ b/server/direct-task.js @@ -0,0 +1,91 @@ +import { MessageError, activityFields, setActivity, message as textMessage } from '../public/message.js'; +import { randomUUID } from 'node:crypto'; +import { ClientError } from './http-policy.js'; +import { checkedProjectPath } from './project-path.js'; +import { isWriterConflict, parseOutcome } from './policy.js'; +import { OUTPUT_LIMIT, retainOutput, outcomeSummary } from './output.js'; + +/** + * @typedef {object} DirectTask + * @property {'direct'} mode + * @property {string} prompt Original goal; never a monitoring note. + * @property {number} rounds Execution rounds; manual resume resets this counter. + * @property {boolean} continuous Whether another round may be scheduled. + * @property {string} status A member of DIRECT_TASK_STATUSES. + */ +export const DIRECT_TASK_STATUSES = Object.freeze(['queued', 'waiting', 'starting', 'running', 'approval', 'pausing', 'paused', 'blocked', 'failed', 'completed']); +export const ACTIVE_TURN_STATUSES = Object.freeze(['running', 'approval', 'pausing']); +const inFlight = ['starting', ...ACTIVE_TURN_STATUSES]; +export const isDirectTask = task => task?.mode === 'direct' || (task != null && task.mode === undefined); +export const isActiveDirectTask = task => isDirectTask(task) && inFlight.includes(task.status); +export const isRunnableDirectTask = (task, now = Date.now()) => isDirectTask(task) + && (task.status === 'queued' || (task.status === 'waiting' && task.continuous)) && (!task.retryAt || now >= task.retryAt); + +export function createDirectTask(input, { demo = false } = {}) { + for (const key of ['name', 'cwd', 'prompt']) if (typeof input[key] !== 'string' || !input[key].trim()) throw new ClientError(textMessage("error.enter_a_name_project_directory_and_work_goal")); + if (input.name.length > 120 || input.prompt.length > 12000) throw new ClientError(textMessage("error.name_or_goal_is_too_long")); + const cwd = checkedProjectPath(input.cwd, { demo }), now = Date.now(); + return { id: randomUUID(), mode: 'direct', name: input.name.trim(), cwd, prompt: input.prompt.trim(), threadId: null, continuous: input.continuous === true, status: 'queued', ...activityFields(textMessage("task.waiting_for_scheduling")), rounds: 0, plan: [], output: '', createdAt: now, updatedAt: now }; +} + +export function waitForThread(task, reason) { + task.status = task.continuous ? 'waiting' : 'blocked'; + task.waitReason = task.continuous ? reason : null; + task.retryAt = task.continuous ? Date.now() + 30000 : 0; + const id = reason === 'writer' ? (task.continuous ? 'task.wait_writer_retry' : 'task.wait_writer_manual') + : (task.continuous ? 'task.wait_thread_retry' : 'task.wait_thread_manual'); + setActivity(task, textMessage(id)); +} + +function prepare(task) { + let changed = false; + if (task.mode === undefined) { task.mode = 'direct'; changed = true; } + if (task.rounds === undefined) { task.rounds = 0; changed = true; } + if (task.plan?.length > 100) { task.plan = task.plan.slice(0, 100); changed = true; } + for (const step of task.plan || []) if (typeof step.step === 'string' && step.step.length > 2000) { step.step = outcomeSummary(step.step); changed = true; } + if (typeof task.output === 'string' && task.output.length > OUTPUT_LIMIT) { + task.outcome = parseOutcome(task.output); retainOutput(task, task.output); changed = true; + } + if (task.status === 'blocked' && task.continuous && isWriterConflict({ message: task.activity })) { + task.lastError = task.activity; waitForThread(task, 'writer'); changed = true; + } + if (isActiveDirectTask(task)) { + task.status = 'blocked'; setActivity(task, textMessage("task.service_restarted_confirm_the_original_chat_has_stopped")); changed = true; + } + return changed; +} + +function validate(task) { + if (!DIRECT_TASK_STATUSES.includes(task.status)) throw new MessageError(textMessage("error.direct_state")); + if (task.rounds !== undefined && (!Number.isSafeInteger(task.rounds) || task.rounds < 0)) throw new MessageError(textMessage("error.direct_rounds")); + if (task.wake !== undefined || task.sentCount !== undefined || task.continuationMessage !== undefined) throw new MessageError(textMessage("error.direct_monitor_fields")); +} + +function action(task, action, value) { + if (action === 'continuous') { + if (typeof value !== 'boolean') throw new ClientError(textMessage("error.invalid_switch_value")); + task.continuous = value; + if (!value && ['waiting', 'queued'].includes(task.status)) { task.status = 'paused'; setActivity(task, textMessage("task.continuous_work_disabled")); } + if (value && task.status === 'blocked' && isWriterConflict({ message: task.activity })) waitForThread(task, 'writer'); + } else if (action === 'pause') { + const active = ACTIVE_TURN_STATUSES.includes(task.status); + task.status = active ? 'pausing' : 'paused'; setActivity(task, active ? textMessage("task.pausing") : textMessage("task.work_paused")); + task.waitReason = null; task.retryAt = 0; + return { kind: 'pause-turn', interrupt: active && !!task.turnId }; + } else if (action === 'resume') { + if (isActiveDirectTask(task)) throw new ClientError(textMessage("error.work_is_still_running_or_stopping")); + task.status = 'queued'; task.rounds = 0; task.retryAt = 0; setActivity(task, textMessage("task.waiting_for_available_quota")); + } else if (action === 'complete') { + if (isActiveDirectTask(task)) throw new ClientError(textMessage("error.pause_the_work_first")); + task.status = 'completed'; setActivity(task, textMessage("task.user_marked_complete")); + } else throw new ClientError(textMessage("error.unsupported_action")); + if (task.status !== 'waiting') { task.waitReason = null; if (task.status === 'paused') task.retryAt = 0; } + return { kind: 'changed', activate: action === 'resume' || (action === 'continuous' && value === true) }; +} + +function restoreBackup(task) { + task.continuous = false; task.status = 'blocked'; task.turnId = null; + setActivity(task, textMessage("task.backup_restored_check_the_original_chats_and_projects")); +} + +export const directTaskModel = Object.freeze({ prepare, validate, action, restoreBackup, retryStorage() {} }); diff --git a/server/http-body.js b/server/http-body.js index 036924e..d755c22 100644 --- a/server/http-body.js +++ b/server/http-body.js @@ -1,19 +1,20 @@ +import { message as textMessage } from '../public/message.js'; // Decode across network chunk boundaries; never replace a split UTF-8 codepoint. import { ClientError } from './http-policy.js'; export async function readJsonBody(req) { const decoder = new TextDecoder('utf-8', { fatal: true }); - const decode = (chunk, options) => { try { return decoder.decode(chunk, options); } catch { throw new ClientError('请求正文不是有效 UTF-8'); } }; + const decode = (chunk, options) => { try { return decoder.decode(chunk, options); } catch { throw new ClientError(textMessage("error.invalid_utf8")); } }; let content = '', bytes = 0; for await (const chunk of req) { bytes += chunk.length; - if (bytes > 160000) throw new ClientError('请求过大'); + if (bytes > 160000) throw new ClientError(textMessage("error.request_too_large")); content += decode(chunk, { stream: true }); - if (content.length > 40000) throw new ClientError('请求过大'); + if (content.length > 40000) throw new ClientError(textMessage("error.request_too_large")); } content += decode(); - if (content.length > 40000) throw new ClientError('请求过大'); + if (content.length > 40000) throw new ClientError(textMessage("error.request_too_large")); let result; - try { result = content ? JSON.parse(content) : {}; } catch { throw new ClientError('请求正文不是有效 JSON'); } - if (!result || typeof result !== 'object' || Array.isArray(result)) throw new ClientError('请求正文必须为 JSON 对象'); + try { result = content ? JSON.parse(content) : {}; } catch { throw new ClientError(textMessage("error.invalid_json")); } + if (!result || typeof result !== 'object' || Array.isArray(result)) throw new ClientError(textMessage("error.json_object_required")); return result; } diff --git a/server/http-policy.js b/server/http-policy.js index f69456c..b47cc5e 100644 --- a/server/http-policy.js +++ b/server/http-policy.js @@ -1,9 +1,13 @@ // Only deliberate local validation messages may cross the HTTP boundary. -export class ClientError extends Error {} +import { MessageError, message, errorResponse } from '../public/message.js'; + +export class ClientError extends MessageError {} export function clientErrorMessage(error) { - if (error instanceof ClientError) return error.message; - if (error?.code === 'ENOENT') return '项目目录不存在'; - return '操作失败，请检查本地服务状态后重试'; + return clientErrorResponse(error).error; +} +export function clientErrorResponse(error) { + if (error instanceof ClientError) return errorResponse(error); + return errorResponse(message(error?.code === 'ENOENT' ? 'error.project_missing' : 'error.operation_failed')); } // Fixed-size buckets: unauthenticated traffic cannot spend a client's budget. diff --git a/server/http-routes.js b/server/http-routes.js index 68dda05..99f07a6 100644 --- a/server/http-routes.js +++ b/server/http-routes.js @@ -1,3 +1,4 @@ +import { errorResponse, message as textMessage } from '../public/message.js'; import { readJsonBody } from './http-body.js'; import { ClientError } from './http-policy.js'; @@ -14,8 +15,8 @@ export function createApiRouter({ manager, health, stream, rpc, demo, summary, s ['/api/storage/recover', input => manager.recoverStorage(input.source)], ['/api/tasks', input => manager.create(input)], ['/api/import', input => { - if (input.note !== undefined && input.prompt !== undefined) throw new ClientError('请仅提供监测备注 note；prompt 为旧版兼容字段'); - return manager.importThread(input.threadId, input.note ?? input.prompt); + if (input.note !== undefined && input.prompt !== undefined) throw new ClientError(textMessage("error.note_alias_conflict")); + return manager.importThread(input.threadId, input.note ?? input.prompt, input.continuationMessage); }], ['/api/approval', input => manager.approve(input.id, input.decision, input.token)], ]); @@ -29,9 +30,9 @@ export function createApiRouter({ manager, health, stream, rpc, demo, summary, s else if (path === '/api/logs') json(res, 200, { logs: manager.state.logs }); else if (/^\/api\/tasks\/[^/]+$/.test(path)) { const task = manager.taskSnapshot(decodeURIComponent(path.split('/').pop())); - json(res, task ? 200 : 404, task ? { task } : { error: '任务不存在' }); + json(res, task ? 200 : 404, task ? { task } : errorResponse(textMessage("error.work_item_not_found"))); } else if (path === '/api/events') { - if (!stream.add(req, res, summary())) json(res, 429, { error: '实时连接已达上限，请关闭多余页面' }); + if (!stream.add(req, res, summary())) json(res, 429, errorResponse(textMessage("error.stream_limit"))); } else if (path === '/api/threads') json(res, 200, await manager.listThreads(url.searchParams.get('cursor'))); else return false; return true; @@ -40,7 +41,7 @@ export function createApiRouter({ manager, health, stream, rpc, demo, summary, s if (/^\/api\/approvals\/[^/]+$/.test(path)) { const input = await readJsonBody(req), approval = manager.approvals.get(decodeURIComponent(path.split('/').pop())); if (typeof input.token === 'string' && approval && approval.detailToken === input.token) json(res, 200, { approval }); - else json(res, 404, { error: '授权请求已失效' }); + else json(res, 404, errorResponse(textMessage("error.approval_expired"))); return true; } const taskId = /^\/api\/tasks\/[^/]+$/.test(path) ? decodeURIComponent(path.split('/').pop()) : null; diff --git a/server/index.js b/server/index.js index fe2d3a2..b94055a 100644 --- a/server/index.js +++ b/server/index.js @@ -1,3 +1,4 @@ +import { errorResponse, message as textMessage } from '../public/message.js'; import { createServer } from 'node:https'; import { resolve, dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; @@ -16,7 +17,7 @@ import { createStaticAssets } from './static-assets.js'; import access from './access.cjs'; import exitState from './exit-state.cjs'; import localTls from './local-tls.cjs'; -import { clientErrorMessage, createRequestLimiter } from './http-policy.js'; +import { clientErrorResponse, createRequestLimiter } from './http-policy.js'; const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); const demo = process.argv.includes('--demo'); @@ -58,21 +59,21 @@ const server = createServer(secureOptions, async (req, res) => { res.setHeader('Referrer-Policy', 'no-referrer'); res.setHeader('Content-Security-Policy', "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'; object-src 'none'"); // Loopback binding + exact Host + same-origin mutations prevent DNS rebinding/CSRF. - if (req.headers.host !== `127.0.0.1:${port}`) return json(res, 403, { error: '请使用 127.0.0.1 访问' }); - if (req.headers.origin && req.headers.origin !== origin) return json(res, 403, { error: '跨站请求被拒绝' }); - if (req.method !== 'GET' && (req.headers['x-continuer-client'] !== '1' || !req.headers['content-type']?.startsWith('application/json'))) return json(res, 403, { error: '请求来源无效' }); + if (req.headers.host !== `127.0.0.1:${port}`) return json(res, 403, errorResponse(textMessage("error.loopback_required"))); + if (req.headers.origin && req.headers.origin !== origin) return json(res, 403, errorResponse(textMessage("error.cross_origin"))); + if (req.method !== 'GET' && (req.headers['x-continuer-client'] !== '1' || !req.headers['content-type']?.startsWith('application/json'))) return json(res, 403, errorResponse(textMessage("error.invalid_origin"))); try { const url = new URL(req.url, origin); - if (url.origin !== origin) return json(res, 403, { error: '请求来源无效' }); + if (url.origin !== origin) return json(res, 403, errorResponse(textMessage("error.invalid_origin"))); if (url.pathname.startsWith('/api/')) { const authorized = access.authorized(req, accessToken); - if (!allowRequest(authorized, req.method)) { res.setHeader('Retry-After', '1'); return json(res, 429, { error: '请求过于频繁，请稍后重试' }); } - if (!authorized) return json(res, 401, { error: '请用启动脚本重新打开 Continuer；本地 API 需要访问凭据' }); + if (!allowRequest(authorized, req.method)) { res.setHeader('Retry-After', '1'); return json(res, 429, errorResponse(textMessage("error.request_rate"))); } + if (!authorized) return json(res, 401, errorResponse(textMessage("error.api_credentials"))); } if (await routeApi(req, res, url)) return; if (await serveStatic(req, res, url)) return; - json(res, 404, { error: '接口或页面不存在' }); - } catch (error) { json(res, 400, { error: clientErrorMessage(error) }); } + json(res, 404, errorResponse(textMessage("error.not_found"))); + } catch (error) { json(res, 400, clientErrorResponse(error)); } }); server.listen(port, '127.0.0.1', () => { health.record('running'); console.log(`Codex Continuer ${demo ? '(DEMO)' : ''}: ${origin}`); manager.start(); }); server.on('error', error => { console.error(error.message); process.exitCode = 1; health.record('failed', 'listen-error'); manager.safely(() => manager.stop()); }); diff --git a/server/lease.js b/server/lease.js index 4bb41e1..12e594d 100644 --- a/server/lease.js +++ b/server/lease.js @@ -1,3 +1,4 @@ +import { MessageError, message as textMessage } from '../public/message.js'; import { writeFileSync, readFileSync, unlinkSync, mkdirSync, realpathSync, existsSync } from 'node:fs'; import { join } from 'node:path'; import { createHash, randomUUID } from 'node:crypto'; @@ -12,10 +13,10 @@ export async function acquireLease(directory, name) { // libuv uses FILE_FLAG_FIRST_PIPE_INSTANCE on Windows. The OS closes the // exclusive handle after a crash; no stale-path deletion owns exclusion. const address = process.platform === 'win32' ? `\\\\.\\pipe\\continuer-${key}` : process.platform === 'linux' ? `\0continuer-${key}` : null; - if (!address) throw new Error('此平台不支持 Continuer 数据目录互斥锁'); + if (!address) throw new MessageError(textMessage("error.lease_platform")); const guard = createServer(socket => socket.destroy()); await new Promise((resolve, reject) => { - const failed = error => reject(error.code === 'EADDRINUSE' ? new Error('同一数据目录已有服务运行，请勿重复启动') : error); + const failed = error => reject(error.code === 'EADDRINUSE' ? new MessageError(textMessage("error.lease_conflict")) : error); guard.once('error', failed); guard.listen(address, () => { guard.off('error', failed); resolve(); }); }); @@ -24,8 +25,8 @@ export async function acquireLease(directory, name) { // Respect a running pre-upgrade service that does not own the pipe yet. if (existsSync(file)) { let previous; - try { previous = JSON.parse(readFileSync(file, 'utf8')); } catch { throw new Error('服务锁损坏，请检查进程后处理 service.lock'); } - if (!Number.isInteger(previous.pid) || alive(previous.pid)) throw new Error('同一数据目录已有服务运行，请勿重复启动'); + try { previous = JSON.parse(readFileSync(file, 'utf8')); } catch { throw new MessageError(textMessage("error.lease_corrupt")); } + if (!Number.isInteger(previous.pid) || alive(previous.pid)) throw new MessageError(textMessage("error.lease_conflict")); } writeFileSync(file, JSON.stringify({ pid: process.pid, leaseId, startedAt: Date.now() }), { mode: 0o600 }); } catch (error) { await new Promise(resolve => guard.close(resolve)); throw error; } diff --git a/server/manager.js b/server/manager.js index 00a34c3..e8542b5 100644 --- a/server/manager.js +++ b/server/manager.js @@ -1,21 +1,18 @@ +import { boundedMessage, isMessage, messageText, messageFields, setActivity, message as textMessage } from '../public/message.js'; import { EventEmitter } from 'node:events'; import { randomUUID } from 'node:crypto'; import { ClientError } from './http-policy.js'; -import { checkedProjectPath, localProjectPath } from './project-path.js'; -import { quotaAvailable, isQuotaError, isWriterConflict, parseOutcome, progress, buckets, MAX_POLL_SECONDS } from './policy.js'; -import { resetWake, tickQuotaWake, enforceWakeLimit } from './quota-wake.js'; -import { OUTPUT_LIMIT, retainOutput, outcomeSummary } from './output.js'; +import { quotaAvailable, progress, buckets, MAX_POLL_SECONDS } from './policy.js'; +import { tickQuotaWake } from './quota-wake.js'; +import { removeCompletedTasks } from './state-lifecycle.js'; +import { createDirectTask, isActiveDirectTask, isRunnableDirectTask } from './direct-task.js'; +import { createMonitorTask, validateMonitorInput, isMonitorTask, enforceWakeLimit } from './monitor-task.js'; +import { taskModel } from './task-model.js'; +import { StatePersistence } from './state-persistence.js'; +import { TurnController } from './turn-controller.js'; import config from './config.cjs'; import { compactSummary } from './summary.js'; -const outcomeSchema = { type: 'object', properties: { status: { type: 'string', enum: ['done', 'continue', 'blocked'] }, summary: { type: 'string' } }, required: ['status', 'summary'], additionalProperties: false }; -const instructions = '\n请维护可验证的步骤计划。仅在原始目标全部完成并验证后返回 status=done；还有可独立推进的工作则返回 continue；需要用户输入或权限则返回 blocked。summary 简述证据或阻塞原因。不要因为额度不足声称完成。'; -const OUTPUT_SAVE_INTERVAL_MS = 250; -const TURN_EVENTS = new Set(['turn/started', 'turn/completed', 'turn/plan/updated', 'item/agentMessage/delta', 'item/started', 'item/completed']); -const ACTIVE_TURN_STATUSES = ['running', 'approval', 'pausing']; -const START_EVENT_LIMIT = 256; -const START_EVENT_BYTES = 4 * 1024 * 1024; - export class Manager extends EventEmitter { constructor(rpc, store, { demo = false, wakeSender = null, observeOnly = false } = {}) { super(); @@ -24,92 +21,48 @@ export class Manager extends EventEmitter { this.demo = demo; this.wakeSender = wakeSender; this.wakeQuota = null; this.wakeSampledAt = null; - this.persistence = { status: 'ok', message: null }; this.observationOnly = observeOnly; this.scheduleEpoch = 0; this.stopped = false; this.wakeExecutions = new Map(); this.detailVersions = new WeakMap(); - try { this.state = store.load(); } - catch (error) { this.persistence = { status: 'error', message: error.message, needsRestore: true }; } - this.state ||= { settings: { enabled: !this.persistence.needsRestore, pollSeconds: 30, minimumRemaining: 5, maxRounds: 20, maxWakeSends: 20 }, tasks: [], logs: [], history: [] }; - this.connection = { status: 'disconnected', message: '正在连接本机 Codex…' }; + this.connection = { status: 'disconnected', ...messageFields(textMessage("connection.connecting_to_local_codex")) }; this.quota = null; this.sampledAt = null; - this.approvals = new Map(); this.importingThreads = new Set(); - this.executions = new Map(); - this.pendingSave = false; - this.saveTimer = null; - let migrated = this.clearCompletedTasks(); - if (this.state.logs.length > 300) { this.state.logs = this.state.logs.slice(0, 300); migrated = true; } - if (this.state.history.length > 240) { this.state.history = this.state.history.slice(-240); migrated = true; } - for (const entry of this.state.logs) if (typeof entry.message === 'string' && entry.message.length > 2600) { entry.message = entry.message.slice(0, 2600); migrated = true; } - const settings = this.state.settings; - const pollSeconds = Number.isInteger(settings.pollSeconds) ? Math.max(10, Math.min(MAX_POLL_SECONDS, settings.pollSeconds)) : 30; - if (settings.pollSeconds !== pollSeconds) { settings.pollSeconds = pollSeconds; migrated = true; } - if (!Number.isInteger(settings.maxWakeSends) || settings.maxWakeSends < 1 || settings.maxWakeSends > 100) { - settings.maxWakeSends = Number.isInteger(settings.maxRounds) ? Math.max(1, Math.min(100, settings.maxRounds)) : 20; - migrated = true; - } - for (const task of this.state.tasks) { - if (task.continuous === undefined) { task.continuous = false; migrated = true; } - if (task.mode !== 'quota-wake' && task.rounds === undefined) { task.rounds = 0; migrated = true; } - if (typeof task.activity === 'string' && task.activity.length > 2400) { task.activity = task.activity.slice(0, 2400); migrated = true; } - if (task.plan?.length > 100) { task.plan = task.plan.slice(0, 100); migrated = true; } - for (const step of task.plan || []) if (typeof step.step === 'string' && step.step.length > 2000) { step.step = outcomeSummary(step.step); migrated = true; } - if (typeof task.output === 'string' && task.output.length > OUTPUT_LIMIT) { - task.outcome = parseOutcome(task.output); - retainOutput(task, task.output); - migrated = true; - } - } - for (const task of this.state.tasks) { - if (!task.mode && ['waiting', 'blocked'].includes(task.status) && task.threadId && task.continuous && (task.waitReason === 'writer' || isWriterConflict({ message: task.activity }))) { - task.mode = 'quota-wake'; resetWake(task); - // Legacy writer waits counted direct turns, never queued messages. - task.sentCount = 0; migrated = true; - } - if (task.mode === 'quota-wake') { - if (!task.wake) { task.wake = { armed: false, delivery: 'idle' }; migrated = true; } - if (task.wake.delivery === 'pending' && (!task.wake.episodeId || !Number.isFinite(task.wake.exhaustedAt))) { - task.wake.delivery = 'uncertain'; task.continuous = false; task.status = 'blocked'; - task.activity = '旧监测记录缺少额度耗尽依据，请检查原聊天后重新开启监测'; migrated = true; - } - if (typeof task.note !== 'string') { task.note = task.prompt || ''; migrated = true; } - if (!Number.isInteger(task.sentCount) || task.sentCount < 0) { task.sentCount = Math.max(0, Number.isInteger(task.rounds) ? task.rounds : 0); migrated = true; } - if ('prompt' in task || 'rounds' in task) { delete task.prompt; delete task.rounds; migrated = true; } - if (task.wake?.delivery === 'sending') { - task.wake.delivery = 'uncertain'; task.status = 'blocked'; task.activity = '上次发送结果未确认，请检查原聊天后重新开启监测'; - } - if (enforceWakeLimit(task, settings.maxWakeSends)) migrated = true; - continue; - } - if (task.status === 'blocked' && task.continuous && isWriterConflict({message:task.activity})) { - task.lastError=task.activity; - this.waitForThread(task,'writer'); - } - if (['running', 'starting', 'approval', 'pausing'].includes(task.status)) { - task.status = 'blocked'; - task.activity = '服务重启，请确认原会话已停止后手动继续'; - } - } - if (migrated) { - try { this.store.save(this.state); } catch (error) { this.storageFailure(error); } - } + this.storage = new StatePersistence(store, error => { + this.scheduleEpoch++; + this.emit('change'); this.emit('persistence-error', error); + }); + this.turns = new TurnController(rpc, { + persistence: this.storage, + canSchedule: epoch => this.canSchedule(epoch), + hasExecutionQuota: () => this.hasExecutionQuota(), + isStopped: () => this.stopped, + changed: options => this.changed(options), + log: (...args) => this.log(...args), + invalidateQuota: () => { this.sampledAt = null; }, + onError: error => this.emit('operation-error', error), + }); + this.storage.load(); rpc.on('notification', msg => this.safely(() => this.event(msg))); rpc.on('request', msg => this.safely(() => this.request(msg))); - rpc.on('disconnect', message => { + rpc.on('disconnect', (message, messageInfo) => { this.scheduleEpoch++; - this.connection = { status: 'disconnected', message }; + this.connection = { status: 'disconnected', ...messageFields({ message, messageInfo }) }; this.sampledAt = null; this.wakeSampledAt = null; this.approvals.clear(); this.executions.clear(); - for (const t of this.state.tasks) if (['running', 'starting', 'approval', 'pausing'].includes(t.status)) { - t.status = 'blocked'; t.activity = '连接中断，请检查原任务后手动继续'; + for (const t of this.state.tasks) if (isActiveDirectTask(t)) { + t.status = 'blocked'; setActivity(t, textMessage("task.connection_interrupted_check_the_original_work_before_resuming")); } this.safely(() => this.changed()); }); } + get state() { return this.storage.state; } + get persistence() { return this.storage.status; } + get pendingSave() { return this.storage.pending; } + get approvals() { return this.turns.approvals; } + get executions() { return this.turns.executions; } snapshot({ details = true } = {}) { const snapshot = { ...this.state, ...config.appInfo(), settings: { ...this.state.settings, enabled: this.state.settings.enabled && !this.observationOnly }, observationOnly: this.observationOnly, persistence: { ...this.persistence, ...this.store.status?.(), pending: this.pendingSave }, @@ -119,11 +72,11 @@ export class Manager extends EventEmitter { taskSnapshot(id) { const task = typeof id === 'object' ? id : this.state.tasks.find(t => t.id === id); if (!task) return null; - const fields = ['name', 'prompt', 'note', 'output', 'outputTruncated', 'plan', 'outcome', 'cwd', 'activity', 'toolCount', 'lastError', 'turnId']; + const fields = ['name', 'prompt', 'note', 'continuationMessage', 'output', 'outputTruncated', 'plan', 'outcome', 'cwd', 'activity', 'activityMessage', 'toolCount', 'lastError', 'turnId']; const values = fields.map(key => task[key]); const previous = this.detailVersions.get(task); if (!previous || values.some((value, index) => value !== previous.values[index])) this.detailVersions.set(task, { values, revision: (previous?.revision || 0) + 1 }); - return { ...task, progress: task.mode === 'quota-wake' ? null : progress(task.plan), detailRevision: this.detailVersions.get(task).revision }; + return { ...task, progress: isMonitorTask(task) ? null : progress(task.plan), detailRevision: this.detailVersions.get(task).revision }; } canSchedule(epoch = this.scheduleEpoch) { return epoch === this.scheduleEpoch && !this.stopped && !this.observationOnly && this.persistence.status === 'ok' && this.state.settings.enabled && this.rpc.ready && this.connection.status === 'connected'; @@ -138,70 +91,40 @@ export class Manager extends EventEmitter { async safelyAsync(action) { try { return await action(); } catch (error) { this.emit('operation-error', error); } } - storageFailure(error) { - this.scheduleEpoch++; - this.persistence = { ...this.persistence, status: 'error', message: error.message, failedAt: Date.now() }; - this.state.settings.enabled = false; - this.emit('change'); this.emit('persistence-error', error); - } + storageFailure(error) { this.storage.fail(error); } activate() { - if (this.persistence.status !== 'ok') throw new ClientError('数据保存失败，恢复存储后再开启调度'); + if (this.persistence.status !== 'ok') throw new ClientError(textMessage("error.data_could_not_be_saved_recover_storage_before")); this.observationOnly = false; } recoverStorage(source = 'retry') { - if (this.wakeExecutions.size) throw new ClientError('续作消息仍在发送，请等待发送结果确认后再恢复存储'); + if (this.wakeExecutions.size) throw new ClientError(textMessage("error.a_continuation_message_is_still_being_sent_wait")); if (source === 'backup') { - if (this.scheduling || this.executions.size || this.state.tasks.some(t => ['starting', ...ACTIVE_TURN_STATUSES].includes(t.status))) throw new ClientError('请先确认当前工作已停止，再恢复备份'); + if (this.scheduling || this.executions.size || this.state.tasks.some(isActiveDirectTask)) throw new ClientError(textMessage("error.confirm_current_work_has_stopped_before_restoring_a")); this.scheduleEpoch++; - this.state = this.store.restoreBackup(state => { - state.settings.enabled = false; - for (const task of state.tasks) { - task.continuous = false; task.status = 'blocked'; task.turnId = null; - task.activity = '已恢复备份，请检查原聊天和项目状态后手动继续'; - if (task.wake?.armed || task.wake?.delivery === 'sending') task.wake.delivery = 'uncertain'; - } - }); - this.approvals.clear(); this.persistence = { status: 'ok', message: null }; this.pendingSave = false; - this.emit('change'); + this.storage.restoreBackup(); + this.approvals.clear(); } else if (source === 'retry') { - if (this.persistence.needsRestore) throw new ClientError('主状态文件损坏，请明确选择恢复备份'); + if (this.persistence.needsRestore) throw new ClientError(textMessage("error.the_main_state_file_is_corrupt_choose_restore")); this.scheduleEpoch++; - for (const task of this.state.tasks) if (task.wake?.delivery === 'sending') { task.wake.delivery = 'uncertain'; task.status = 'blocked'; task.activity = '发送记录保存失败，请检查原聊天后手动继续'; } - this.state.settings.enabled = false; this.pendingSave = true; this.flush(); this.emit('change'); - } else throw new ClientError('恢复方式无效'); + this.storage.retry(); + } else throw new ClientError(textMessage("error.invalid_recovery_method")); + this.emit('change'); } clearCompletedTasks() { - const completedIds = new Set(this.state.tasks.filter(t => t.status === 'completed').map(t => t.id)); - if (!completedIds.size) return false; - this.state.tasks = this.state.tasks.filter(t => !completedIds.has(t.id)); + const completedIds = removeCompletedTasks(this.state); for (const [id, request] of this.approvals) if (completedIds.has(request.taskId)) this.approvals.delete(id); - return true; + return completedIds.size > 0; } - changed({ deferSave = false } = {}) { - if (!deferSave) this.clearCompletedTasks(); - this.pendingSave = true; - if (deferSave) { - // One deadline from the first fragment; continuous output cannot postpone it. - if (!this.saveTimer) this.saveTimer = setTimeout(() => { - this.saveTimer = null; - try { this.flush(); } - catch { /* flush recorded the failure; keep the service available. */ } - }, OUTPUT_SAVE_INTERVAL_MS); - } else this.flush(); + changed(options = {}) { + if (!options.deferSave) this.clearCompletedTasks(); + this.storage.changed(options); // Consumers coalesce this invalidation signal and request the latest snapshot. this.emit('change'); } - flush() { - clearTimeout(this.saveTimer); this.saveTimer = null; - if (!this.pendingSave) return; - try { this.store.save(this.state); } - catch (error) { this.storageFailure(error); throw error; } - // Keep the pending flag on failure so a later change/flush can retry. - this.pendingSave = false; - this.persistence = { status: 'ok', message: null }; - } - log(message, type = 'info', taskId = null) { - this.state.logs.unshift({ id: randomUUID(), time: Date.now(), message: String(message).slice(0, 2600), type, taskId }); + flush() { this.storage.flush(); } + log(value, type = 'info', taskId = null) { + const info = boundedMessage(isMessage(value) ? value : value?.messageInfo); + this.state.logs.unshift({ id: randomUUID(), time: Date.now(), message: messageText(value).slice(0, 2600), ...(info ? { messageInfo: info } : {}), type, taskId }); this.state.logs = this.state.logs.slice(0, 300); } async refresh() { @@ -211,12 +134,12 @@ export class Manager extends EventEmitter { await this.rpc.connect(); const result = await this.rpc.call('account/rateLimits/read'); this.setQuota(result); - this.connection = { status: 'connected', message: this.demo ? '演示数据 · 不执行真实任务' : 'Codex App Server 已连接' }; + this.connection = { status: 'connected', ...messageFields(textMessage(this.demo ? 'connection.demo' : 'connection.codex_connected')) }; this.changed(); } catch (error) { this.sampledAt = null; this.wakeSampledAt = null; - this.connection = { status: 'disconnected', message: String(error.message).slice(0, 2400) }; + this.connection = { status: 'disconnected', ...messageFields(error), message: String(error.message).slice(0, 2400) }; this.changed(); } finally { this.refreshing = false; } await this.tick(); @@ -247,7 +170,7 @@ export class Manager extends EventEmitter { clearInterval(this.timer); this.state.settings.enabled = false; this.safely(() => this.changed()); - await Promise.all(this.state.tasks.filter(t => ['running', 'starting', 'approval', 'pausing'].includes(t.status)).map(t => this.action(t.id, 'pause').catch(() => {}))); + await Promise.all(this.state.tasks.filter(isActiveDirectTask).map(t => this.action(t.id, 'pause').catch(() => {}))); this.executions.clear(); try { this.flush(); } finally { this.rpc.close(); } } @@ -258,122 +181,17 @@ export class Manager extends EventEmitter { try { await tickQuotaWake(this, epoch); if (!this.canSchedule(epoch)) return; - if (this.state.tasks.some(t => ['starting', 'running', 'approval', 'pausing'].includes(t.status))) return; - const task = this.state.tasks.find(t => t.mode !== 'quota-wake' && (t.status === 'queued' || (t.status === 'waiting' && t.continuous)) && (!t.retryAt || Date.now() >= t.retryAt)); + if (this.state.tasks.some(isActiveDirectTask)) return; + const task = this.state.tasks.find(task => isRunnableDirectTask(task)); if (!task) return; if (!this.hasExecutionQuota()) { - if (task.status !== 'waiting' || task.waitReason !== 'quota') { task.status = 'waiting'; task.waitReason='quota'; task.activity = '可用额度不足或未知，等待新额度样本'; this.changed(); } + if (task.status !== 'waiting' || task.waitReason !== 'quota') { task.status = 'waiting'; task.waitReason='quota'; setActivity(task, textMessage("task.quota_is_low_or_unknown_waiting_for_fresh")); this.changed(); } return; } await this.run(task, epoch); } finally { this.scheduling = false; } } - waitForThread(task,reason) { - task.status=task.continuous ? 'waiting' : 'blocked'; - task.waitReason=task.continuous ? reason : null; - task.retryAt=task.continuous ? Date.now()+30000 : 0; - const message=reason==='writer' ? '原会话被其他 Codex 客户端占用' : '原会话仍在运行'; - task.activity=message+(task.continuous ? '，30 秒后自动重试' : '，请等待原会话结束后再继续'); - } - async run(task, epoch = this.scheduleEpoch) { - if (!this.canSchedule(epoch)) return; - const execution = { pending: false, events: [], bytes: 0, overflow: false }; - this.executions.set(task.id, execution); - const current = () => this.executions.get(task.id) === execution; - const previousRounds=task.rounds; - const permitted = () => { - if (!current() || task.status !== 'starting') return false; - if (this.canSchedule(epoch) && this.hasExecutionQuota()) return true; - task.status = 'queued'; task.activity = '启动已取消，等待有效调度和新鲜额度'; this.changed(); return false; - }; - try { - task.cwd = localProjectPath(task.cwd); - task.turnId = null; - task.status = 'starting'; task.waitReason=null; task.activity = '正在恢复会话…'; this.changed(); - if (task.rounds >= this.state.settings.maxRounds) { - task.status = 'blocked'; task.activity = '已达到自动执行轮次上限，请手动继续'; this.changed(); return; - } - if (task.threadId) { - const read = await this.rpc.call('thread/read', { threadId: task.threadId, includeTurns: false }); - if (!permitted()) return; - if (read.thread.status?.type === 'active') { this.waitForThread(task,'thread'); this.changed(); return; } - await this.rpc.call('thread/resume', { threadId: task.threadId, cwd: task.cwd, excludeTurns: true, approvalPolicy: 'on-request', sandbox: 'workspace-write' }); - } else { - const result = await this.rpc.call('thread/start', { cwd: task.cwd, approvalPolicy: 'on-request', sandbox: 'workspace-write' }); - if (!current()) return; - task.threadId = result.thread.id; - } - if (!current()) return; - if (task.status !== 'starting') { this.changed(); return; } - if (!permitted()) return; - task.output = ''; task.outputTruncated = false; task.outcome = null; - task.toolCount = 0; task.rounds++; task.status = 'running'; task.updatedAt = Date.now(); - this.changed(); - execution.pending = true; - const result = await this.rpc.call('turn/start', { - threadId: task.threadId, - input: [{ type: 'text', text: `${task.rounds > 1 ? '继续原目标，先检查已有成果，避免重复操作。\n' : ''}${task.prompt}${instructions}`, text_elements: [] }], - outputSchema: outcomeSchema, - }); - if (!current()) return; - if (typeof result.turn?.id !== 'string' || !result.turn.id) throw new ClientError('未收到有效的轮次 ID，请检查原会话后手动继续'); - execution.pending = false; - if (ACTIVE_TURN_STATUSES.includes(task.status)) task.turnId = result.turn.id; - this.log(`开始工作：${task.name}`, 'success', task.id); - if (execution.overflow) { - task.status = 'pausing'; task.activity = '启动期间通知超过缓存上限，正在中断，请检查原会话后手动继续'; - this.log(`${task.name}：${task.activity}`, 'warning', task.id); - } - const events = execution.events; execution.events = []; execution.bytes = 0; - for (const event of events) event.request ? this.request(event.message) : this.event(event.message); - this.changed(); - if (task.status === 'pausing' && task.turnId === result.turn.id) { - try { await this.rpc.call('turn/interrupt', { threadId: task.threadId, turnId: task.turnId }); } - catch (error) { - if (!current() || task.status !== 'pausing' || task.turnId !== result.turn.id) return; - task.status = 'blocked'; task.activity = `未确认中断：${error.message}`; - this.log(`${task.name}：${task.activity}`, 'warning', task.id); this.changed(); - } - } - } catch (error) { - if (!current()) return; - if (['paused', 'pausing'].includes(task.status)) task.status = 'paused'; - else if (isWriterConflict(error)) { - task.rounds=previousRounds; task.turnId=null; task.lastError=error.message; - this.waitForThread(task,'writer'); - } - else { task.status = 'blocked'; task.activity = String(error.message).slice(0, 2400); } - this.log(`${task.name}：${task.activity}`, 'warning', task.id); this.changed(); - } finally { - if (current()) { - this.executions.delete(task.id); - for (const event of execution.events) if (event.request) this.rejectRequest(event.message); - } - } - } - matchesTurn(task, params) { - const turnId = params.turnId ?? params.turn?.id; - return task.mode !== 'quota-wake' && ACTIVE_TURN_STATUSES.includes(task.status) - && task.threadId === params.threadId && typeof task.turnId === 'string' && !!task.turnId - && turnId === task.turnId && (params.turnId == null || params.turn?.id == null || params.turnId === params.turn.id); - } - rejectRequest(msg) { - this.rpc.send({ id: msg.id, error: { code: -32601, message: 'This client requires manual handling for this request.' } }); - } - deferTurnEvent(task, message, request = false) { - const execution = this.executions.get(task.id); - if (!execution?.pending) return false; - // Notifications may precede the turn/start response. Its ID is authoritative. - const bytes = execution.overflow ? 0 : Buffer.byteLength(JSON.stringify(message)); - if (execution.overflow || execution.events.length >= START_EVENT_LIMIT || execution.bytes + bytes > START_EVENT_BYTES) { - for (const event of execution.events) if (event.request) this.rejectRequest(event.message); - execution.events = []; execution.bytes = 0; execution.overflow = true; - if (request) this.rejectRequest(message); - } else { - execution.events.push({ message, request }); execution.bytes += bytes; - } - return true; - } + run(task, epoch = this.scheduleEpoch) { return this.turns.run(task, epoch); } event({ method, params: p = {} }) { if (method === 'account/rateLimits/updated') { const merged = p.rateLimitsByLimitId ? p : p.rateLimits?.limitId && this.quota?.rateLimitsByLimitId @@ -385,196 +203,61 @@ export class Manager extends EventEmitter { if (merged !== p && Object.keys(merged.rateLimitsByLimitId).length > 1) this.sampledAt = previousSample; this.changed(); return; } - if (!TURN_EVENTS.has(method)) return; - const task = this.state.tasks.find(t => t.threadId === p.threadId); - if (!task) return; - if (task.mode === 'quota-wake') return; - if (this.deferTurnEvent(task, { method, params: p })) return; - if (!this.matchesTurn(task, p)) return; - if (method === 'turn/completed' && !['completed', 'failed', 'interrupted'].includes(p.turn?.status)) return; - task.updatedAt = Date.now(); - if (method === 'turn/started') { task.activity = 'Codex 正在处理目标'; } - else if (method === 'turn/plan/updated') { task.plan = p.plan.slice(0, 100).map(step => ({ ...step, step: outcomeSummary(step.step) })); task.activity = outcomeSummary(p.explanation || task.plan.find(s => s.status === 'inProgress')?.step || '计划已更新'); } - else if (method === 'item/agentMessage/delta') { - retainOutput(task, p.delta, true); - task.outcome = null; - } - else if (method === 'item/started') { - const item = p.item; - if (['commandExecution', 'fileChange', 'mcpToolCall', 'dynamicToolCall', 'webSearch'].includes(item.type)) task.toolCount++; - task.activity = ({ commandExecution: '正在执行命令', fileChange: '正在修改文件', reasoning: '正在分析', agentMessage: '正在生成回复', mcpToolCall: '正在调用工具' })[item.type] || '正在工作'; - } else if (method === 'item/completed' && p.item.type === 'agentMessage') { - const text = p.item.text ?? task.output; - // Parse the complete JSON before retaining only its display tail. - task.outcome = parseOutcome(text); - if (p.item.text != null) retainOutput(task, text); - } - else if (method === 'turn/completed') { - for (const [id, request] of this.approvals) if (request.taskId === task.id) this.approvals.delete(id); - task.turnId = null; - if (p.turn.status === 'interrupted' || task.status === 'pausing') { - task.status = 'paused'; task.activity = '工作已暂停'; - } else if (p.turn.status === 'failed') { - const limited = isQuotaError(p.turn.error); - task.status = limited && task.continuous ? 'waiting' : 'failed'; - task.waitReason=task.status==='waiting' ? 'quota' : null; - task.activity = String(p.turn.error?.message || '本轮执行失败').slice(0, 2400); - task.retryAt = Date.now() + 60000; - if (limited) this.sampledAt = null; - } else { - const outcome = task.outcome || parseOutcome(task.output); - task.activity = outcome.summary; - task.status = outcome.status === 'done' ? 'completed' : outcome.status === 'continue' && task.continuous && task.toolCount > 0 ? 'queued' : 'blocked'; - if (outcome.status === 'continue' && task.toolCount === 0) task.activity += '（本轮无工具活动，已停止自动续作）'; - task.retryAt = Date.now() + 5000; - } - this.log(`${task.name}：${task.activity}`, task.status === 'completed' ? 'success' : 'info', task.id); - } else return; - this.changed({ deferSave: method === 'item/agentMessage/delta' }); - } - request(msg) { - const task = this.state.tasks.find(t => t.threadId === msg.params?.threadId); - if (task && task.mode !== 'quota-wake' && this.deferTurnEvent(task, msg, true)) return; - if (!task || !this.matchesTurn(task, msg.params || {})) { this.rejectRequest(msg); return; } - if (task.status === 'pausing') { this.rejectRequest(msg); return; } - // File changes need a complete patch/scope view. Until that exists, leave - // these requests to the original Codex client instead of approving blindly. - const supported = msg.method === 'item/commandExecution/requestApproval'; - const commandFields = ['threadId', 'turnId', 'itemId', 'approvalId', 'command', 'reason', 'cwd', 'commandActions', 'kind', 'startedAtMs']; - // CLI 0.153.2 permits null optional scope fields. A non-null scope needs - // its own review UI; unknown fields still fail closed, even when null. - const absentScopeFields = ['additionalPermissions', 'availableDecisions', 'environmentId', 'networkApprovalContext', 'proposedExecpolicyAmendment', 'proposedNetworkPolicyAmendments']; - const reviewable = typeof msg.params.command === 'string' && !!msg.params.command.trim() && msg.params.command.length <= 12000 - && Object.keys(msg.params).every(key => commandFields.includes(key) || (absentScopeFields.includes(key) && msg.params[key] === null)) - && (msg.params.kind === undefined || msg.params.kind === 'command') - && (msg.params.startedAtMs === undefined || Number.isSafeInteger(msg.params.startedAtMs)) - && (msg.params.reason == null || (typeof msg.params.reason === 'string' && msg.params.reason.length <= 2000)) - && (msg.params.cwd == null || typeof msg.params.cwd === 'string'); - if (supported && reviewable) { - if (this.approvals.size >= 50) { this.rejectRequest(msg); return; } - this.approvals.set(String(msg.id), { id: msg.id, detailToken: randomUUID(), taskId: task.id, threadId: task.threadId, turnId: task.turnId, method: msg.method, reason: msg.params.reason || '操作需要授权', command: msg.params.command || '', cwd: msg.params.cwd || task.cwd }); - task.status = 'approval'; task.activity = '等待你批准操作'; - this.log(`${task.name} 等待操作授权`, 'warning', task.id); - } else { - this.rejectRequest(msg); - this.cancelApprovals(task); - task.status = 'pausing'; task.activity = msg.method === 'item/fileChange/requestApproval' ? '文件修改范围无法完整审阅，已拒绝；请在原 Codex 中核对后手动继续' : reviewable ? '需要用户输入，请在 Codex 中处理后继续' : '授权内容超出可审阅范围，已拒绝，请在原 Codex 会话核对后继续'; - if (task.turnId) void this.safelyAsync(() => this.interruptTask(task)); - } - this.changed(); - } - cancelApprovals(task) { - for (const [id, request] of this.approvals) if (request.taskId === task.id) { - this.approvals.delete(id); - this.safely(() => this.rpc.send({ id: request.id, result: { decision: 'decline' } })); - } - } - async interruptTask(task) { - const threadId = task.threadId, turnId = task.turnId; - try { await this.rpc.call('turn/interrupt', { threadId, turnId }); } - catch (error) { - if (!this.state.tasks.includes(task) || task.status !== 'pausing' || task.threadId !== threadId || task.turnId !== turnId) return; - task.status = 'blocked'; task.activity = `未确认中断：${error.message}`; this.changed(); throw error; - } - } - approve(id, decision, token) { - if (this.persistence.status !== 'ok') throw new ClientError('请先恢复数据保存，再处理授权'); - const request = this.approvals.get(String(id)); - if (!request || typeof token !== 'string' || token !== request.detailToken || !['accept', 'decline'].includes(decision)) throw new ClientError('授权请求已过期或决定无效'); - if (request.method !== 'item/commandExecution/requestApproval' || typeof request.command !== 'string' || !request.command.trim()) throw new ClientError('授权内容无法完整审阅，请在原 Codex 中处理'); - const task = this.state.tasks.find(t => t.id === request.taskId); - if (this.stopped || !this.rpc.ready || !task || task.status !== 'approval' || !this.matchesTurn(task, request)) throw new ClientError('授权所属轮次已失效或正在暂停'); - // Confirm storage before granting an operation permission. - this.pendingSave = true; this.flush(); - this.rpc.send({ id: request.id, result: { decision } }); - this.approvals.delete(String(id)); - const remaining = [...this.approvals.values()].some(other => other.taskId === task.id); - task.status = remaining ? 'approval' : 'running'; task.activity = remaining ? '仍有操作等待授权' : decision === 'accept' ? '已批准，继续执行' : '已拒绝操作'; - this.changed(); + this.turns.event({ method, params: p }); } + request(message) { return this.turns.request(message); } + approve(id, decision, token) { return this.turns.approve(id, decision, token); } create(input) { - if (this.state.tasks.length >= 100) throw new ClientError('最多管理 100 条记录，请先结束不再需要的工作'); - for (const key of ['name', 'cwd', 'prompt']) if (typeof input[key] !== 'string' || !input[key].trim()) throw new ClientError('请填写名称、项目目录和工作目标'); - if (input.name.length > 120 || input.prompt.length > 12000) throw new ClientError('名称或目标过长'); - const cwd = checkedProjectPath(input.cwd, { demo: this.demo }); - const task = { id: randomUUID(), name: input.name.trim(), cwd, prompt: input.prompt.trim(), threadId: null, continuous: input.continuous === true, status: 'queued', activity: '等待调度', rounds: 0, plan: [], output: '', createdAt: Date.now(), updatedAt: Date.now() }; - this.state.tasks.unshift(task); this.log(`添加工作：${task.name}`); this.changed(); this.activate(); return task; + if (this.state.tasks.length >= 100) throw new ClientError(textMessage("error.up_to_records_are_supported_end_unused_work")); + const task = createDirectTask(input, { demo: this.demo }); + this.state.tasks.unshift(task); this.log(textMessage("log.work_added", { name: task.name })); this.changed(); this.activate(); return task; } async action(id, action, value) { const task = this.state.tasks.find(t => t.id === id); - if (!task) throw new ClientError('任务不存在'); - if (task.mode === 'quota-wake') { - if ((this.wakeExecutions.has(task.id) || task.wake?.delivery === 'uncertain') && (action === 'pause' || (action === 'continuous' && value === false))) { - task.continuous = false; task.status = 'paused'; task.waitReason = null; task.retryAt = 0; - task.activity = '监测已暂停，发送结果仍需确认；请核对原聊天，已发出的消息无法撤回'; this.changed(); return; - } - if (this.wakeExecutions.has(task.id)) { - throw new ClientError('续作消息发送结果仍在确认，请等待后再开启或结束监测'); - } - if ((action === 'resume' || (action === 'continuous' && value === true)) && (task.sentCount || 0) >= this.state.settings.maxWakeSends) throw new ClientError('已达到原聊天发送次数上限，请提高发送上限后再开启监测；累计次数不会重置'); - if (action === 'continuous') { - if (typeof value !== 'boolean') throw new ClientError('开关值无效'); - if (task.continuous !== value) { task.continuous = value; resetWake(task); } - } else if (action === 'pause') { task.continuous = false; resetWake(task); } - else if (action === 'resume') { task.continuous = true; resetWake(task); } - else if (action === 'complete') { task.continuous = false; task.status = 'completed'; this.log(`已结束监测：${task.name}；工作结果请在原聊天确认`, 'info', task.id); } - else throw new ClientError('不支持的操作'); - this.changed(); if (action === 'resume' || (action === 'continuous' && value === true)) this.activate(); return; - } - if (action === 'continuous') { - if (typeof value !== 'boolean') throw new ClientError('开关值无效'); - task.continuous = value; - if (!value && ['waiting', 'queued'].includes(task.status)) { task.status = 'paused'; task.activity = '持续工作已关闭'; } - if (value && task.status==='blocked' && isWriterConflict({message:task.activity})) this.waitForThread(task,'writer'); - } else if (action === 'pause') { - const active = ['running', 'approval', 'pausing'].includes(task.status); - task.status = active ? 'pausing' : 'paused'; task.activity = active ? '正在暂停' : '工作已暂停'; - task.waitReason = null; task.retryAt = 0; - this.cancelApprovals(task); + if (!task) throw new ClientError(textMessage("error.work_item_not_found")); + const transition = taskModel(task).action(task, action, value, { + sending: this.wakeExecutions.has(task.id), maxWakeSends: this.state.settings.maxWakeSends, + }); + if (transition.logMessage) this.log(transition.logMessage, 'info', task.id); + if (transition.kind === 'pause-turn') { + this.turns.cancelApprovals(task); this.safely(() => this.changed()); - if (task.turnId && active) { - await this.interruptTask(task); - } + if (transition.interrupt) await this.turns.interruptTask(task); return; - } else if (action === 'resume') { - if (['starting', 'running', 'approval', 'pausing'].includes(task.status)) throw new ClientError('任务尚在运行或停止中'); - task.status = 'queued'; task.rounds = 0; task.retryAt = 0; task.activity = '等待可用额度'; - } else if (action === 'complete') { - if (['starting', 'running', 'approval', 'pausing'].includes(task.status)) throw new ClientError('请先暂停任务'); - task.status = 'completed'; task.activity = '用户确认完成'; - } else throw new ClientError('不支持的操作'); - if (task.status!=='waiting') { task.waitReason=null; if (task.status==='paused') task.retryAt=0; } + } this.changed(); - if (action === 'resume' || (action === 'continuous' && value === true)) this.activate(); + if (transition.activate) this.activate(); } updateSettings(input) { const s = this.state.settings; - if (input.enabled !== undefined && typeof input.enabled !== 'boolean') throw new ClientError('开关值无效'); + if (input.language !== undefined && !['zh', 'en'].includes(input.language)) throw new ClientError('Invalid language: use zh or en'); + if (input.enabled !== undefined && typeof input.enabled !== 'boolean') throw new ClientError(textMessage("error.invalid_switch_value")); for (const [key, min, max] of [['pollSeconds', 10, MAX_POLL_SECONDS], ['minimumRemaining', 1, 99], ['maxRounds', 1, 100], ['maxWakeSends', 1, 100]]) { - if (input[key] !== undefined) { if (!Number.isInteger(input[key]) || input[key] < min || input[key] > max) throw new ClientError(`${key} 必须为 ${min}–${max} 的整数`); } + if (input[key] !== undefined) { if (!Number.isInteger(input[key]) || input[key] < min || input[key] > max) throw new ClientError(textMessage("error.setting_range", { name: key, min: min, max: max })); } } for (const key of ['pollSeconds', 'minimumRemaining', 'maxRounds', 'maxWakeSends']) if (input[key] !== undefined) s[key] = input[key]; if (input.enabled !== undefined) s.enabled = input.enabled; + if (input.language !== undefined) s.language = input.language; if (input.enabled === false) this.scheduleEpoch++; - for (const task of this.state.tasks) if (task.mode === 'quota-wake') enforceWakeLimit(task, s.maxWakeSends); - this.log('调度设置已更新'); this.changed(); + for (const task of this.state.tasks) if (isMonitorTask(task)) enforceWakeLimit(task, s.maxWakeSends); + this.log(textMessage("log.scheduling_settings_updated")); this.changed(); if (input.enabled === true) this.activate(); } async listThreads(cursor = null) { await this.rpc.connect?.(); return this.rpc.call('thread/list', { limit: 30, sortKey: 'updated_at', cursor }); } - async importThread(id, note = '') { - if (this.state.tasks.some(t => t.threadId === id)) throw new ClientError('该会话已添加'); - if (this.importingThreads.has(id)) throw new ClientError('该会话正在添加，请勿重复导入'); - if (this.state.tasks.length >= 100) throw new ClientError('最多管理 100 条记录，请先结束不再需要的工作'); - if (typeof note !== 'string' || note.length > 12000) throw new ClientError('监测备注必须为不超过 12000 字符的文本'); + async importThread(id, note = '', continuationMessage = '') { + if (this.state.tasks.some(t => t.threadId === id)) throw new ClientError(textMessage("error.this_chat_has_already_been_added")); + if (this.importingThreads.has(id)) throw new ClientError(textMessage("error.this_chat_is_being_added_do_not_import")); + if (this.state.tasks.length >= 100) throw new ClientError(textMessage("error.up_to_records_are_supported_end_unused_work")); + validateMonitorInput(note, continuationMessage); // Reserve before yielding: HTTP and MCP imports share this manager. this.importingThreads.add(id); try { const { thread } = await this.rpc.call('thread/read', { threadId: id, includeTurns: false }); // Another task path may have claimed the thread while the read was pending. - if (this.state.tasks.some(t => t.threadId === id)) throw new ClientError('该会话已添加'); - if (this.state.tasks.length >= 100) throw new ClientError('最多管理 100 条记录，请先结束不再需要的工作'); - const task = { id: randomUUID(), mode: 'quota-wake', threadId: id, name: (thread.name || thread.preview || 'Codex 会话').slice(0, 80), cwd: thread.cwd, note: note.trim(), continuous: false, status: 'paused', activity: '会话已添加，开启额度监测后在恢复时发送“继续”；工作结果请在原聊天确认', sentCount: 0, wake: { armed: false, delivery: 'idle' }, plan: [], output: '', createdAt: Date.now(), updatedAt: Date.now() }; - this.state.tasks.unshift(task); this.log(`已添加会话：${task.name}`); this.changed(); return task; + if (this.state.tasks.some(t => t.threadId === id)) throw new ClientError(textMessage("error.this_chat_has_already_been_added")); + if (this.state.tasks.length >= 100) throw new ClientError(textMessage("error.up_to_records_are_supported_end_unused_work")); + const task = createMonitorTask(id, thread, note, continuationMessage); + this.state.tasks.unshift(task); this.log(textMessage("log.chat_added", { name: task.name })); this.changed(); return task; } finally { this.importingThreads.delete(id); } } } diff --git a/server/monitor-task.js b/server/monitor-task.js new file mode 100644 index 0000000..5fd64e0 --- /dev/null +++ b/server/monitor-task.js @@ -0,0 +1,131 @@ +import { MessageError, activityFields, setActivity, message as textMessage } from '../public/message.js'; +import { randomUUID } from 'node:crypto'; +import { ClientError } from './http-policy.js'; +import { isWriterConflict } from './policy.js'; + +/** + * @typedef {object} MonitorTask + * @property {'quota-wake'} mode + * @property {string} note Local note; never an execution goal. + * @property {string} continuationMessage Message for future recovery deliveries. + * @property {number} sentCount Confirmed queue deliveries; resume never resets it. + * @property {boolean} continuous Whether quota monitoring is enabled. + * @property {object} wake The recovery episode and delivery claim. + * @property {string} status A member of MONITOR_TASK_STATUSES. + */ +export const MONITOR_TASK_STATUSES = Object.freeze(['monitoring', 'waiting', 'paused', 'blocked', 'completed']); +export const isMonitorTask = task => task?.mode === 'quota-wake'; +export const isEnabledMonitorTask = task => isMonitorTask(task) && task.continuous === true && ['monitoring', 'waiting'].includes(task.status); +const executionFields = ['prompt', 'rounds', 'plan', 'output', 'outputTruncated', 'outcome', 'toolCount', 'turnId', 'lastError']; + +export function resetWake(task) { + task.wake = { armed: false, delivery: 'idle' }; + task.status = task.continuous ? 'monitoring' : 'paused'; + task.waitReason = null; task.retryAt = 0; + setActivity(task, task.continuous ? textMessage("task.monitoring_quota_a_continuation_message_will_be_sent") : textMessage("task.quota_recovery_monitoring_paused")); +} + +export function enforceWakeLimit(task, limit) { + if ((task.sentCount || 0) < limit) return false; + task.continuous = false; + if (task.wake?.delivery !== 'uncertain') { + task.status = 'paused'; task.waitReason = 'send-limit'; task.retryAt = 0; + if (task.wake && task.wake.delivery !== 'sending') { + task.wake.armed = false; + if (task.wake.delivery === 'pending') task.wake.delivery = 'idle'; + } + setActivity(task, textMessage("monitor.send_limit", { sent: task.sentCount, limit: limit })); + } + return true; +} + +export function validateMonitorInput(note, continuationMessage) { + if (typeof note !== 'string' || note.length > 12000) throw new ClientError(textMessage("error.monitoring_notes_must_be_text_of_up_to")); + if (typeof continuationMessage !== 'string' || continuationMessage.length > 12000) throw new ClientError(textMessage("error.continuation_messages_must_be_text_of_up_to")); +} + +export function createMonitorTask(threadId, thread, note = '', continuationMessage = '') { + validateMonitorInput(note, continuationMessage); + const now = Date.now(); + return { id: randomUUID(), mode: 'quota-wake', threadId, name: (thread.name || thread.preview || 'Codex 会话').slice(0, 80), cwd: thread.cwd, note: note.trim(), continuationMessage: continuationMessage.trim(), continuous: false, status: 'paused', ...activityFields(textMessage("task.chat_added_enable_monitoring_to_send_a_message")), sentCount: 0, wake: { armed: false, delivery: 'idle' }, createdAt: now, updatedAt: now }; +} + +export function migrateLegacyWriter(task) { + if (task.mode !== undefined || !['waiting', 'blocked'].includes(task.status) || !task.threadId || !task.continuous + || !(task.waitReason === 'writer' || isWriterConflict({ message: task.activity }))) return false; + task.mode = 'quota-wake'; resetWake(task); + // Direct rounds were never confirmed queued messages. + task.sentCount = 0; + return true; +} + +function prepare(task, settings) { + let changed = false; + if (!task.wake) { task.wake = { armed: false, delivery: 'idle' }; changed = true; } + if (task.wake.delivery === 'pending' && (!task.wake.episodeId || !Number.isFinite(task.wake.exhaustedAt))) { + task.wake.delivery = 'uncertain'; task.continuous = false; task.status = 'blocked'; + setActivity(task, textMessage("task.this_legacy_record_lacks_proof_of_quota_exhaustion")); changed = true; + } + if (typeof task.note !== 'string') { task.note = task.prompt || ''; changed = true; } + if (!Number.isInteger(task.sentCount) || task.sentCount < 0) { task.sentCount = Math.max(0, Number.isInteger(task.rounds) ? task.rounds : 0); changed = true; } + for (const key of executionFields) if (key in task) { delete task[key]; changed = true; } + if (task.wake.delivery === 'sending') { + task.wake.delivery = 'uncertain'; task.status = 'blocked'; setActivity(task, textMessage("task.the_previous_delivery_is_unconfirmed_check_the_original")); changed = true; + } + if (enforceWakeLimit(task, settings.maxWakeSends)) changed = true; + return changed; +} + +function validate(task) { + if (!MONITOR_TASK_STATUSES.includes(task.status)) throw new MessageError(textMessage("error.monitor_state")); + if ((task.sentCount !== undefined && (!Number.isSafeInteger(task.sentCount) || task.sentCount < 0)) + || (task.rounds !== undefined && (!Number.isSafeInteger(task.rounds) || task.rounds < 0))) throw new MessageError(textMessage("error.monitor_count")); + // Old records may contain direct fields; prepare migrates their note/count + // before removing them. Delivery evidence is checked without inventing it. + if (task.wake === undefined) return; + const wake = task.wake; + if (!wake || typeof wake !== 'object' || Array.isArray(wake) || typeof wake.armed !== 'boolean' + || !['idle', 'pending', 'sending', 'sent', 'uncertain'].includes(wake.delivery) + || (['pending', 'sending'].includes(wake.delivery) && wake.armed !== true) + || (['idle', 'sent'].includes(wake.delivery) && wake.armed !== false) + || (wake.episodeId !== undefined && (typeof wake.episodeId !== 'string' || !wake.episodeId)) + || (wake.exhaustedAt !== undefined && (!Number.isFinite(wake.exhaustedAt) || wake.exhaustedAt <= 0))) throw new MessageError(textMessage("error.monitor_delivery")); +} + +function action(task, action, value, { sending, maxWakeSends }) { + if (action === 'message') { + if (typeof value !== 'string' || value.length > 12000) throw new ClientError(textMessage("error.continuation_messages_must_be_text_of_up_to")); + task.continuationMessage = value.trim(); task.updatedAt = Date.now(); + return { kind: 'changed', logMessage: textMessage("log.continuation_message_updated") }; + } + if ((sending || task.wake?.delivery === 'uncertain') && (action === 'pause' || (action === 'continuous' && value === false))) { + task.continuous = false; task.status = 'paused'; task.waitReason = null; task.retryAt = 0; + setActivity(task, textMessage("task.monitoring_paused_delivery_is_still_unconfirmed_check_the")); + return { kind: 'changed' }; + } + if (sending) throw new ClientError(textMessage("error.delivery_is_still_being_confirmed_wait_before_enabling")); + if ((action === 'resume' || (action === 'continuous' && value === true)) && (task.sentCount || 0) >= maxWakeSends) throw new ClientError(textMessage("error.message_limit_reached_raise_the_limit_then_enable")); + if (action === 'continuous') { + if (typeof value !== 'boolean') throw new ClientError(textMessage("error.invalid_switch_value")); + if (task.continuous !== value) { task.continuous = value; resetWake(task); } + } else if (action === 'pause') { task.continuous = false; resetWake(task); } + else if (action === 'resume') { task.continuous = true; resetWake(task); } + else if (action === 'complete') { + task.continuous = false; task.status = 'completed'; + return { kind: 'changed', logMessage: textMessage("log.monitoring_ended_check_results_in_the_original_chat", { name: task.name }) }; + } else throw new ClientError(textMessage("error.unsupported_action")); + return { kind: 'changed', activate: action === 'resume' || (action === 'continuous' && value === true) }; +} + +function restoreBackup(task) { + task.continuous = false; task.status = 'blocked'; + setActivity(task, textMessage("task.backup_restored_check_the_original_chats_and_projects")); + if (task.wake?.armed || task.wake?.delivery === 'sending') task.wake.delivery = 'uncertain'; +} + +function retryStorage(task) { + if (task.wake?.delivery !== 'sending') return; + task.wake.delivery = 'uncertain'; task.status = 'blocked'; setActivity(task, textMessage("task.the_delivery_record_could_not_be_saved_check")); +} + +export const monitorTaskModel = Object.freeze({ prepare, validate, action, restoreBackup, retryStorage }); diff --git a/server/policy.js b/server/policy.js index 7554d3d..823eaff 100644 --- a/server/policy.js +++ b/server/policy.js @@ -1,4 +1,5 @@ import { outcomeSummary } from './output.js'; +import { message, formatMessage } from '../public/message.js'; export const QUOTA_TTL_MS = 90000; export const MAX_POLL_SECONDS = QUOTA_TTL_MS / 1000; @@ -37,5 +38,6 @@ export function parseOutcome(text) { const value = JSON.parse(text); if (['done', 'continue', 'blocked'].includes(value?.status) && typeof value.summary === 'string') return { status: value.status, summary: outcomeSummary(value.summary) }; } catch { /* Missing structured outcome must not trigger an endless loop. */ } - return { status: 'blocked', summary: '本轮已结束，未收到明确的完成状态，请检查输出后继续。' }; + const summaryMessage = message('task.outcome_missing'); + return { status: 'blocked', summary: formatMessage(summaryMessage), summaryMessage }; } diff --git a/server/project-path.js b/server/project-path.js index dc2ba69..87cf82a 100644 --- a/server/project-path.js +++ b/server/project-path.js @@ -1,3 +1,4 @@ +import { message as textMessage } from '../public/message.js'; import { win32 } from 'node:path'; import { statSync } from 'node:fs'; import { ClientError } from './http-policy.js'; @@ -5,13 +6,13 @@ import { ClientError } from './http-policy.js'; // Check the string before touching the filesystem: UNC/device stat can send SMB // authentication. Accept drive-qualified Windows paths only, including in demo. export function localProjectPath(value) { - if (typeof value !== 'string') throw new ClientError('项目目录必须是本地盘符绝对路径'); + if (typeof value !== 'string') throw new ClientError(textMessage("error.project_path")); const path = value.trim().replaceAll('/', '\\'); - if (!/^[a-z]:\\(?!\\)/i.test(path) || /[\x00-\x1f]/.test(path) || path.slice(2).includes(':')) throw new ClientError('项目目录必须是本地盘符绝对路径，不支持网络或设备路径'); + if (!/^[a-z]:\\(?!\\)/i.test(path) || /[\x00-\x1f]/.test(path) || path.slice(2).includes(':')) throw new ClientError(textMessage("error.project_path_kind")); return win32.normalize(path); } export function checkedProjectPath(value, { demo = false, stat = statSync } = {}) { const path = localProjectPath(value); - if (!demo && !stat(path).isDirectory()) throw new ClientError('项目目录必须是存在的本地目录'); + if (!demo && !stat(path).isDirectory()) throw new ClientError(textMessage("error.project_directory")); return path; } diff --git a/server/queue-sender.js b/server/queue-sender.js index 409995c..8674574 100644 --- a/server/queue-sender.js +++ b/server/queue-sender.js @@ -1,6 +1,8 @@ +import { MessageError, message as textMessage } from '../public/message.js'; import { execFile } from 'node:child_process'; import { existsSync, readdirSync, statSync } from 'node:fs'; import { join } from 'node:path'; +import { defaultContinuation } from '../public/i18n.js'; export function queueBinary(env = process.env) { if (env.CODEX_QUEUE_BINARY) return env.CODEX_QUEUE_BINARY; @@ -19,7 +21,7 @@ function execute(binary, args) { const env = { ...process.env }; for (const key of ['CODEX_THREAD_ID', 'CODEX_SESSION_ID', 'CODEX_TOOL_CALL_ID', 'CODEX_APP_TOOLS_PIPE_PATH', 'CODEX_APP_TOOLS_CALLER_HOST_ID']) delete env[key]; execFile(binary, args, { env, windowsHide: true, timeout: 20000, maxBuffer: 65536, shell: false }, (error, stdout) => { - if (error) reject(new Error(error.killed ? 'Codex 队列请求超时' : `Codex 队列请求失败 (${error.code || 'unknown'})`)); + if (error) reject(new MessageError(error.killed ? textMessage("error.queue_timeout") : textMessage("error.queue_failed", { code: error.code || 'unknown' }))); else resolve(String(stdout)); }); }); @@ -28,20 +30,28 @@ function execute(binary, args) { // Official queue command: no thread/resume, model override or approval override. export class QueueSender { constructor({ binary, run = execute } = {}) { this.binary = binary || queueBinary(); this.run = run; } - async send(threadId, { shouldSend = () => true } = {}) { + async send(threadId, { shouldSend = () => true, beforeSend, message = '', language = 'zh' } = {}) { + if (typeof message !== 'string' || message.length > 12000) { + throw Object.assign(new MessageError(textMessage("error.continuation_messages_must_be_text_of_up_to")), { safeToRetry: false }); + } + message = message.trim() || defaultContinuation(language); if (!/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(threadId)) { - throw Object.assign(new Error('原聊天 ID 无效'), { safeToRetry: false }); + throw Object.assign(new MessageError(textMessage("error.invalid_original_chat_id")), { safeToRetry: false }); } try { await this.run(this.binary, ['queue', '--help']); } - catch { throw Object.assign(new Error('Codex 消息队列不可用，请更新桌面端或设置 CODEX_QUEUE_BINARY'), { safeToRetry: true }); } - if (!shouldSend()) throw Object.assign(new Error('已暂停，未发送续作消息'), { cancelled: true, safeToRetry: true }); + catch { throw Object.assign(new MessageError(textMessage("error.codex_message_queue_unavailable_update_the_desktop_app")), { safeToRetry: true }); } + if (!shouldSend()) throw Object.assign(new MessageError(textMessage("error.paused_no_continuation_message_sent")), { cancelled: true, safeToRetry: true }); + // Re-read after the capability probe, immediately before enqueueing. This + // hook has no message side effect, so its errors must not become uncertain. + await beforeSend?.(); + if (!shouldSend()) throw Object.assign(new MessageError(textMessage("error.paused_no_continuation_message_sent")), { cancelled: true, safeToRetry: true }); try { - const output = await this.run(this.binary, ['queue', '--thread', threadId, '--message', '继续']); + const output = await this.run(this.binary, ['queue', '--thread', threadId, '--message', message]); const queueId = /Queued message ([0-9a-f-]{36})/i.exec(String(output))?.[1]; return { queueId: queueId || null }; } catch (error) { // A timeout/exit can occur after enqueueing. Never silently send twice. - throw Object.assign(new Error(`发送结果未确认，请检查原聊天：${error.message}`), { safeToRetry: false }); + throw Object.assign(new MessageError(textMessage("error.delivery_unconfirmed_check_the_original_chat", { reason: error.messageInfo || error.message })), { safeToRetry: false }); } } } diff --git a/server/quota-wake.js b/server/quota-wake.js index 3281239..966c41b 100644 --- a/server/quota-wake.js +++ b/server/quota-wake.js @@ -1,73 +1,77 @@ +import { MessageError, setActivity, taskActivityMessage, message as textMessage } from '../public/message.js'; import { randomUUID } from 'node:crypto'; import { buckets, quotaAvailable, QUOTA_TTL_MS } from './policy.js'; +import { defaultContinuation } from '../public/i18n.js'; +import { readThreadReply } from './thread-reply.js'; +import { enforceWakeLimit, isEnabledMonitorTask } from './monitor-task.js'; -export function enforceWakeLimit(task, limit) { - if ((task.sentCount || 0) < limit) return false; - task.continuous = false; - if (task.wake?.delivery !== 'uncertain') { - task.status = 'paused'; task.waitReason = 'send-limit'; task.retryAt = 0; - if (task.wake && task.wake.delivery !== 'sending') { - task.wake.armed = false; - if (task.wake.delivery === 'pending') task.wake.delivery = 'idle'; - } - task.activity = `已达到原聊天发送上限（${task.sentCount}/${limit} 次），监测已停止；请查看原聊天确认工作结果`; - } - return true; -} +export { resetWake, enforceWakeLimit } from './monitor-task.js'; export function quotaExhausted(payload) { return buckets(payload).some(b => Boolean(b.rateLimitReachedType) || [b.primary, b.secondary].some(w => Number.isFinite(w?.usedPercent) && w.usedPercent >= 100)); } -export function resetWake(task) { - task.wake = { armed: false, delivery: 'idle' }; - task.status = task.continuous ? 'monitoring' : 'paused'; - task.waitReason = null; task.retryAt = 0; - task.activity = task.continuous ? '正在监测额度；确认耗尽后，恢复时向原聊天发送“继续”' : '额度恢复续作已暂停'; -} - export async function tickQuotaWake(manager, epoch = manager.scheduleEpoch) { const now = Date.now(); if (!manager.wakeSampledAt || now - manager.wakeSampledAt > QUOTA_TTL_MS) return; for (const task of manager.state.tasks) { if (!manager.canSchedule(epoch)) break; - if (task.mode !== 'quota-wake' || task.continuous !== true || !['monitoring', 'waiting'].includes(task.status)) continue; + if (!isEnabledMonitorTask(task)) continue; if (enforceWakeLimit(task, manager.state.settings.maxWakeSends)) { manager.changed(); continue; } const wake = task.wake ||= { armed: false, delivery: 'idle' }; if (quotaExhausted(manager.wakeQuota)) { if (!wake.armed) { Object.assign(wake, { armed: true, episodeId: randomUUID(), exhaustedAt: now, delivery: 'pending' }); task.status = 'waiting'; task.waitReason = 'quota'; task.retryAt = 0; - task.activity = '已确认额度耗尽，恢复后向原聊天发送一次“继续”'; - manager.log(`${task.name}：${task.activity}`, 'info', task.id); manager.changed(); + setActivity(task, textMessage("task.quota_exhaustion_confirmed_one_continuation_message_will_be")); + manager.log(taskActivityMessage(task), 'info', task.id); manager.changed(); } continue; } if (wake.armed !== true || wake.delivery !== 'pending' || (task.retryAt || 0) > now || !quotaAvailable(manager.wakeQuota, manager.wakeSampledAt, manager.state.settings.minimumRemaining)) continue; if (!manager.wakeSender) { - if (task.waitReason !== 'desktop') { task.waitReason = 'desktop'; task.activity = '额度已恢复，等待消息发送通道'; manager.changed(); } + if (task.waitReason !== 'desktop') { task.waitReason = 'desktop'; setActivity(task, textMessage("task.quota_recovered_waiting_for_message_delivery_to_become")); manager.changed(); } continue; } manager.wakeExecutions.set(task.id, wake); try { - // Durable outbox claim before the side effect. A restart leaves this uncertain. - wake.delivery = 'sending'; task.activity = '额度已恢复，正在向原聊天发送“继续”'; manager.changed(); + const permitted = () => manager.canSchedule(epoch) && isEnabledMonitorTask(task) + && task.wake === wake && manager.state.tasks.includes(task) && (task.sentCount || 0) < manager.state.settings.maxWakeSends + && quotaAvailable(manager.wakeQuota, manager.wakeSampledAt, manager.state.settings.minimumRemaining); + const inspectReply = async () => { + if (!permitted()) throw Object.assign(new MessageError(textMessage("error.paused_no_continuation_message_sent")), { cancelled: true }); + let reply; + try { reply = await readThreadReply(manager.rpc, task.threadId); } + catch { reply = 'unknown'; } + if (!permitted()) throw Object.assign(new MessageError(textMessage("error.paused_no_continuation_message_sent")), { cancelled: true }); + if (reply === 'complete') throw Object.assign(new MessageError(textMessage("error.the_last_instruction_already_received_a_complete_reply")), { replyComplete: true }); + if (reply !== 'incomplete') throw Object.assign(new MessageError(reply === 'active' ? textMessage("error.the_original_chat_is_still_replying_no_continuation") : textMessage("error.reply_status_could_not_be_confirmed_no_continuation")), { waitForReply: true }); + }; try { - const result = await manager.wakeSender.send(task.threadId, { shouldSend: () => manager.canSchedule(epoch) && task.continuous === true && task.status !== 'paused' && task.wake === wake && manager.state.tasks.includes(task) && (task.sentCount || 0) < manager.state.settings.maxWakeSends && quotaAvailable(manager.wakeQuota, manager.wakeSampledAt, manager.state.settings.minimumRemaining) }); + await inspectReply(); + // Durable outbox claim before the side effect. A restart leaves this uncertain. + wake.delivery = 'sending'; setActivity(task, textMessage("task.quota_recovered_sending_a_continuation_message_to_the")); manager.changed(); + const result = await manager.wakeSender.send(task.threadId, { message: task.continuationMessage?.trim() || defaultContinuation(manager.state.settings.language), shouldSend: permitted, beforeSend: inspectReply }); Object.assign(wake, { armed: false, delivery: 'sent', sentAt: Date.now(), queueId: result?.queueId || null }); task.sentCount = (task.sentCount || 0) + 1; // A user may pause while the queue command is in flight; don't undo it. if (task.continuous && task.status !== 'paused') { task.status = 'monitoring'; task.waitReason = null; } - task.activity = task.continuous ? '已向原聊天排队发送“继续”，继续监测；工作结果请在原聊天确认' : '已向原聊天排队发送“继续”，监测已暂停；已排队消息无法撤回'; + setActivity(task, task.continuous ? textMessage("task.continuation_message_queued_monitoring_continues_check_results_in") : textMessage("task.continuation_message_queued_monitoring_paused_queued_messages_can")); enforceWakeLimit(task, manager.state.settings.maxWakeSends); - manager.log(`${task.name}：${task.activity}`, 'success', task.id); + manager.log(taskActivityMessage(task), 'success', task.id); } catch (error) { - if (error.cancelled) { wake.delivery = 'pending'; } + if (manager.persistence.status !== 'ok') throw error; + if (error.replyComplete) { + wake.armed = false; wake.delivery = 'idle'; task.retryAt = 0; task.waitReason = null; + task.status = task.continuous ? 'monitoring' : 'paused'; + } else if (error.waitForReply) { + wake.delivery = 'pending'; task.waitReason = 'thread'; task.retryAt = Date.now() + manager.state.settings.pollSeconds * 1000; + } else if (error.cancelled) { if (wake.delivery === 'sending') wake.delivery = 'pending'; } else if (error.safeToRetry && task.continuous && task.status !== 'paused') { wake.delivery = 'pending'; task.waitReason = 'desktop'; task.retryAt = Date.now() + 60000; } else { wake.delivery = 'uncertain'; if (task.status !== 'paused') task.status = 'blocked'; } - task.activity = error.message; - manager.log(`${task.name}：${error.message}`, 'warning', task.id); + setActivity(task, error); + manager.log(taskActivityMessage(task), error.replyComplete ? 'info' : 'warning', task.id); } manager.changed(); } finally { manager.wakeExecutions.delete(task.id); } diff --git a/server/rpc.js b/server/rpc.js index 5962de5..36bb772 100644 --- a/server/rpc.js +++ b/server/rpc.js @@ -1,3 +1,4 @@ +import { MessageError, message as textMessage } from '../public/message.js'; import { spawn } from 'node:child_process'; import { EventEmitter } from 'node:events'; import { createInterface } from 'node:readline'; @@ -27,10 +28,10 @@ export class CodexRpc extends EventEmitter { this.child = null; for (const p of this.pending.values()) { clearTimeout(p.timer); p.reject(error); } this.pending.clear(); - this.emit('disconnect', error.message); + this.emit('disconnect', error.message, error.messageInfo); }; child.on('error', fail); - child.on('exit', (code) => fail(new Error(`Codex 进程已退出 (${code})`))); + child.on('exit', (code) => fail(new MessageError(textMessage("error.codex_exit", { code: code })))); child.stdin.on('error', fail); // Do not expose stderr: extensions can log credential-bearing diagnostics. child.stderr.resume(); @@ -50,19 +51,19 @@ export class CodexRpc extends EventEmitter { }); try { await this.call('initialize', { clientInfo: { name: 'codex_continuer', title: 'Codex Continuer', version: config.version }, capabilities: { experimentalApi: false } }); - if (this.child !== child) throw new Error('Codex 连接已失效'); + if (this.child !== child) throw new MessageError(textMessage("error.codex_connection")); this.send({ method: 'initialized' }); this.ready = true; } catch (error) { child.kill(); throw error; } } send(message) { - if (!this.child?.stdin.writable) throw new Error('Codex 未连接'); + if (!this.child?.stdin.writable) throw new MessageError(textMessage("error.codex_disconnected")); this.child.stdin.write(JSON.stringify(message) + '\n'); } call(method, params = {}) { const id = ++this.sequence; return new Promise((resolve, reject) => { - const timer = setTimeout(() => { this.pending.delete(id); reject(new Error(`${method} 请求超时，请检查连接`)); }, 30000); + const timer = setTimeout(() => { this.pending.delete(id); reject(new MessageError(textMessage("error.rpc_timeout", { method: method }))); }, 30000); this.pending.set(id, { resolve, reject, timer }); try { this.send({ id, method, params }); } catch (error) { clearTimeout(timer); this.pending.delete(id); reject(error); } }); @@ -71,7 +72,7 @@ export class CodexRpc extends EventEmitter { const child = this.child; if (!child) return; this.child = null; this.ready = false; - for (const p of this.pending.values()) { clearTimeout(p.timer); p.reject(new Error('Codex 连接已关闭')); } + for (const p of this.pending.values()) { clearTimeout(p.timer); p.reject(new MessageError(textMessage("error.codex_connection_closed"))); } this.pending.clear(); // EOF permits app-server to close its sessions before the bounded fallback. child.stdin.end(); diff --git a/server/state-lifecycle.js b/server/state-lifecycle.js new file mode 100644 index 0000000..c6a06fb --- /dev/null +++ b/server/state-lifecycle.js @@ -0,0 +1,49 @@ +import { setActivity } from '../public/message.js'; +import { MAX_POLL_SECONDS } from './policy.js'; +import { taskModel } from './task-model.js'; +import { migrateLegacyWriter } from './monitor-task.js'; + +export { ACTIVE_TURN_STATUSES, waitForThread } from './direct-task.js'; + +export function initialState(enabled = true) { + return { settings: { enabled, language: 'zh', pollSeconds: 30, minimumRemaining: 5, maxRounds: 20, maxWakeSends: 20 }, tasks: [], logs: [], history: [] }; +} + +export function removeCompletedTasks(state) { + const ids = new Set(state.tasks.filter(task => task.status === 'completed').map(task => task.id)); + if (ids.size) state.tasks = state.tasks.filter(task => !ids.has(task.id)); + return ids; +} + +// Startup transformations only touch persisted data; they never contact Codex. +export function prepareState(state) { + let migrated = removeCompletedTasks(state).size > 0; + if (state.logs.length > 300) { state.logs = state.logs.slice(0, 300); migrated = true; } + if (state.history.length > 240) { state.history = state.history.slice(-240); migrated = true; } + for (const entry of state.logs) if (typeof entry.message === 'string' && entry.message.length > 2600) { entry.message = entry.message.slice(0, 2600); migrated = true; } + const settings = state.settings; + const pollSeconds = Number.isInteger(settings.pollSeconds) ? Math.max(10, Math.min(MAX_POLL_SECONDS, settings.pollSeconds)) : 30; + if (settings.pollSeconds !== pollSeconds) { settings.pollSeconds = pollSeconds; migrated = true; } + if (!Number.isInteger(settings.maxWakeSends) || settings.maxWakeSends < 1 || settings.maxWakeSends > 100) { + settings.maxWakeSends = Number.isInteger(settings.maxRounds) ? Math.max(1, Math.min(100, settings.maxRounds)) : 20; + migrated = true; + } + for (const task of state.tasks) { + if (task.continuous === undefined) { task.continuous = false; migrated = true; } + if (typeof task.activity === 'string' && task.activity.length > 2400) { setActivity(task, task.activity.slice(0, 2400)); migrated = true; } + if (migrateLegacyWriter(task)) migrated = true; + if (taskModel(task).prepare(task, settings)) migrated = true; + } + return migrated; +} + +export function prepareBackup(state) { + prepareState(state); + state.settings.enabled = false; + for (const task of state.tasks) taskModel(task).restoreBackup(task); +} + +export function prepareStorageRetry(state) { + for (const task of state.tasks) taskModel(task).retryStorage(task); + state.settings.enabled = false; +} diff --git a/server/state-persistence.js b/server/state-persistence.js new file mode 100644 index 0000000..3050ae5 --- /dev/null +++ b/server/state-persistence.js @@ -0,0 +1,64 @@ +import { messageFields, message as textMessage } from '../public/message.js'; +import { ClientError } from './http-policy.js'; +import { initialState, prepareState, prepareBackup, prepareStorageRetry } from './state-lifecycle.js'; + +const OUTPUT_SAVE_INTERVAL_MS = 250; + +// Owns the in-memory state and its durable-save lifecycle. Store owns file I/O. +export class StatePersistence { + constructor(store, onFailure) { + this.store = store; + this.onFailure = onFailure; + this.status = { status: 'ok', message: null }; + this.pending = false; + this.timer = null; + } + get healthy() { return this.status.status === 'ok'; } + load() { + try { this.state = this.store.load(); } + catch (error) { this.status = { status: 'error', ...messageFields(error), needsRestore: true }; } + this.state ||= initialState(!this.status.needsRestore); + if (prepareState(this.state)) { + try { this.store.save(this.state); } + catch (error) { this.fail(error); } + } + } + fail(error) { + this.status = { ...this.status, status: 'error', messageInfo: undefined, ...messageFields(error), failedAt: Date.now() }; + this.state.settings.enabled = false; + this.onFailure(error); + } + changed({ deferSave = false } = {}) { + this.pending = true; + if (!deferSave) return this.flush(); + // One deadline from the first fragment; continuous output cannot postpone it. + if (!this.timer) this.timer = setTimeout(() => { + this.timer = null; + try { this.flush(); } + catch { /* fail recorded the error; retain pending output for retry. */ } + }, OUTPUT_SAVE_INTERVAL_MS); + } + flush() { + clearTimeout(this.timer); this.timer = null; + if (!this.pending) return; + try { this.store.save(this.state); } + catch (error) { this.fail(error); throw error; } + this.pending = false; + this.status = { status: 'ok', message: null }; + } + commit() { + this.pending = true; + this.flush(); + } + restoreBackup() { + this.state = this.store.restoreBackup(prepareBackup); + clearTimeout(this.timer); this.timer = null; + this.status = { status: 'ok', message: null }; + this.pending = false; + } + retry() { + if (this.status.needsRestore) throw new ClientError(textMessage("error.the_main_state_file_is_corrupt_choose_restore")); + prepareStorageRetry(this.state); + this.commit(); + } +} diff --git a/server/static-assets.js b/server/static-assets.js index 4ecc117..4a461c2 100644 --- a/server/static-assets.js +++ b/server/static-assets.js @@ -4,7 +4,13 @@ import { createHash } from 'node:crypto'; const files = new Map([ ['/', 'index.html'], ['/widget', 'widget.html'], - ...['app.js', 'widget.js', 'access.js', 'view-lifecycle.js', 'task-mode.js', 'task-details.js', 'approval-details.js', 'storage-status.js', 'quota-display.js', 'rhine-readout.js', 'style.css', 'widget.css', 'favicon.svg', 'rhine-signal-loop.svg'].map(file => ['/' + file, file]), + ...[ + 'app.js', 'widget.js', 'i18n.js', 'messages.js', 'message.js', 'system-messages.js', 'access.js', 'api-client.js', + 'html.js', 'icons.js', 'task-view.js', 'task-forms.js', 'view-lifecycle.js', + 'task-mode.js', 'task-details.js', 'approval-details.js', 'storage-status.js', + 'quota-display.js', 'rhine-readout.js', 'style.css', 'widget.css', + 'favicon.svg', 'rhine-signal-loop.svg', + ].map(file => ['/' + file, file]), ]); const types = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.svg': 'image/svg+xml' }; diff --git a/server/store.js b/server/store.js index cbfd8bb..5c2deb0 100644 --- a/server/store.js +++ b/server/store.js @@ -1,45 +1,51 @@ -import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, copyFileSync, statSync } from 'node:fs'; +import { MessageError, message as textMessage } from '../public/message.js'; +import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, copyFileSync, openSync, closeSync, fstatSync } from 'node:fs'; import { dirname } from 'node:path'; import config from './config.cjs'; +import { validateTask } from './task-model.js'; export function validateState(state) { if (!state || typeof state !== 'object' || Array.isArray(state) || !state.settings || typeof state.settings.enabled !== 'boolean' - || !['tasks', 'logs', 'history'].every(key => Array.isArray(state[key]))) throw new Error('状态文件结构无效'); - if (state.schemaVersion != null && state.schemaVersion !== config.schemaVersion) throw new Error('状态文件版本不兼容'); - if (!state.logs.every(entry => entry && typeof entry.message === 'string') || !state.history.every(entry => entry && Array.isArray(entry.values))) throw new Error('活动或额度历史格式无效'); + || !['tasks', 'logs', 'history'].every(key => Array.isArray(state[key]))) throw new MessageError(textMessage("error.storage_shape")); + if (state.schemaVersion != null && state.schemaVersion !== config.schemaVersion) throw new MessageError(textMessage("error.storage_version")); + if (!state.logs.every(entry => entry && typeof entry.message === 'string') || !state.history.every(entry => entry && Array.isArray(entry.values))) throw new MessageError(textMessage("error.storage_history")); if (!Number.isInteger(state.settings.pollSeconds) || !Number.isInteger(state.settings.maxRounds) || state.settings.maxRounds < 1 || state.settings.maxRounds > 100 - || !Number.isInteger(state.settings.minimumRemaining) || state.settings.minimumRemaining < 1 || state.settings.minimumRemaining > 99) throw new Error('状态文件设置无效'); - if (state.settings.maxWakeSends !== undefined && (!Number.isInteger(state.settings.maxWakeSends) || state.settings.maxWakeSends < 1 || state.settings.maxWakeSends > 100)) throw new Error('状态文件发送上限无效'); + || !Number.isInteger(state.settings.minimumRemaining) || state.settings.minimumRemaining < 1 || state.settings.minimumRemaining > 99) throw new MessageError(textMessage("error.storage_settings")); + if (state.settings.maxWakeSends !== undefined && (!Number.isInteger(state.settings.maxWakeSends) || state.settings.maxWakeSends < 1 || state.settings.maxWakeSends > 100)) throw new MessageError(textMessage("error.storage_send_limit")); + if (state.settings.language !== undefined && !['zh', 'en'].includes(state.settings.language)) throw new Error('Invalid saved language'); const ids = new Set(), threads = new Set(); - const statuses = ['queued', 'waiting', 'starting', 'running', 'approval', 'pausing', 'paused', 'blocked', 'failed', 'completed', 'monitoring']; for (const task of state.tasks) { - if (!task || typeof task.id !== 'string' || !statuses.includes(task.status) || ids.has(task.id)) throw new Error('任务记录无效或 ID 重复'); + validateTask(task); + if (ids.has(task.id)) throw new MessageError(textMessage("error.task_duplicate")); ids.add(task.id); - if ((task.continuous !== undefined && typeof task.continuous !== 'boolean') - || (task.rounds !== undefined && (!Number.isSafeInteger(task.rounds) || task.rounds < 0)) - || (task.sentCount !== undefined && (!Number.isSafeInteger(task.sentCount) || task.sentCount < 0)) - || (task.mode !== undefined && !['direct', 'quota-wake'].includes(task.mode))) throw new Error('任务模式、开关或次数无效'); - if (task.wake !== undefined) { - const wake = task.wake; - if (!wake || typeof wake !== 'object' || Array.isArray(wake) || typeof wake.armed !== 'boolean' - || !['idle', 'pending', 'sending', 'sent', 'uncertain'].includes(wake.delivery) - || (['pending', 'sending'].includes(wake.delivery) && wake.armed !== true) - || (['idle', 'sent'].includes(wake.delivery) && wake.armed !== false) - || (wake.episodeId !== undefined && (typeof wake.episodeId !== 'string' || !wake.episodeId)) - || (wake.exhaustedAt !== undefined && (!Number.isFinite(wake.exhaustedAt) || wake.exhaustedAt <= 0))) throw new Error('额度监测发送状态无效'); - } - if ((task.prompt != null && (typeof task.prompt !== 'string' || task.prompt.length > 12000)) || (task.note != null && (typeof task.note !== 'string' || task.note.length > 12000)) - || (task.output != null && typeof task.output !== 'string') || (task.plan != null && (!Array.isArray(task.plan) || !task.plan.every(step => step && typeof step.step === 'string')))) throw new Error('任务目标、备注或输出字段无效'); if (task.threadId && task.status !== 'completed') { - if (typeof task.threadId !== 'string' || threads.has(task.threadId)) throw new Error('状态中存在重复会话，请检查备份后恢复'); + if (typeof task.threadId !== 'string' || threads.has(task.threadId)) throw new MessageError(textMessage("error.thread_duplicate")); threads.add(task.threadId); } } return state; } function readState(file) { - if (statSync(file).size > 64 * 1024 * 1024) throw new Error('状态文件超过 64 MiB，请检查后恢复备份'); - return readFileSync(file, 'utf8').replace(/^\uFEFF/, ''); + const descriptor = openSync(file, 'r'); + try { + if (fstatSync(descriptor).size > 64 * 1024 * 1024) throw new MessageError(textMessage("error.storage_size")); + return readFileSync(descriptor, 'utf8').replace(/^\uFEFF/, ''); + } finally { closeSync(descriptor); } +} +function removeArchivedTasks(file, removedIds) { + if (!existsSync(file)) return; + let archived; + try { archived = validateState(JSON.parse(readState(file))); } + catch (error) { + if (error.code) throw error; + // A damaged recovery snapshot is diagnostic evidence, not a writable state. + return; + } + const tasks = archived.tasks.filter(task => !removedIds.has(task.id)); + if (tasks.length === archived.tasks.length) return; + archived.tasks = tasks; + writeFileSync(file + '.tmp', JSON.stringify(archived, null, 2), { mode: 0o600, flush: true }); + renameSync(file + '.tmp', file); } export class Store { @@ -47,7 +53,7 @@ export class Store { load() { try { if (!existsSync(this.file)) { - if (existsSync(this.file + '.bak')) throw new Error('主状态文件缺失，但存在备份，请明确恢复'); + if (existsSync(this.file + '.bak')) throw new MessageError(textMessage("error.storage_missing")); return null; } const value = validateState(JSON.parse(readState(this.file))); @@ -55,14 +61,20 @@ export class Store { } catch (error) { this.loadError = error; throw error; } } save(state) { - if (this.loadError) throw new Error(`状态未恢复，禁止覆盖原文件：${this.loadError.message}`); + if (this.loadError) throw new MessageError(textMessage("error.storage_unrecovered", { reason: this.loadError.messageInfo || this.loadError.message })); validateState(state); state.schemaVersion = config.schemaVersion; mkdirSync(dirname(this.file), { recursive: true }); writeFileSync(this.file + '.tmp', JSON.stringify(state, null, 2), { mode: 0o600, flush: true }); if (existsSync(this.file)) { - const previous = readState(this.file); - validateState(JSON.parse(previous)); - writeFileSync(this.file + '.bak.tmp', previous, { mode: 0o600, flush: true }); + const previous = validateState(JSON.parse(readState(this.file))); + const remainingIds = new Set(state.tasks.map(task => task.id)); + const removedIds = new Set(previous.tasks.filter(task => !remainingIds.has(task.id)).map(task => task.id)); + if (removedIds.size) { + previous.tasks = previous.tasks.filter(task => !removedIds.has(task.id)); + for (const suffix of ['.before-restore', '.restore.tmp']) removeArchivedTasks(this.file + suffix, removedIds); + } + // Backups retain prior values for surviving records, never deleted tasks. + writeFileSync(this.file + '.bak.tmp', JSON.stringify(previous, null, 2), { mode: 0o600, flush: true }); renameSync(this.file + '.bak.tmp', this.file + '.bak'); } renameSync(this.file + '.tmp', this.file); diff --git a/server/summary.js b/server/summary.js index b65554a..6f1af10 100644 --- a/server/summary.js +++ b/server/summary.js @@ -1,4 +1,5 @@ import { buckets } from './policy.js'; +import { boundedMessage, formatMessage, message } from '../public/message.js'; export const SUMMARY_BUDGET = 768 * 1024; const text = (value, limit) => typeof value === 'string' ? value.length > limit ? value.slice(0, limit - 1) + '…' : value : typeof value === 'object' ? null : value; @@ -10,23 +11,25 @@ const windowSummary = value => value && pick(value, ['usedPercent', 'windowDurat export function compactSummary(snapshot) { const result = { ...pick(snapshot, ['app', 'version', 'buildId', 'protocolVersion', 'schemaVersion', 'sampledAt', 'demo', 'observationOnly']), - settings: pick(snapshot.settings, ['enabled', 'pollSeconds', 'minimumRemaining', 'maxRounds', 'maxWakeSends']), - persistence: { ...pick(snapshot.persistence, ['status', 'needsRestore', 'pending', 'failedAt', 'backupAvailable']), message: text(snapshot.persistence?.message, 2000), loadError: text(snapshot.persistence?.loadError, 2000) }, - connection: { status: snapshot.connection?.status, message: text(snapshot.connection?.message, 2000) }, + settings: pick(snapshot.settings, ['enabled', 'language', 'pollSeconds', 'minimumRemaining', 'maxRounds', 'maxWakeSends']), + persistence: { ...pick(snapshot.persistence, ['status', 'needsRestore', 'pending', 'failedAt', 'backupAvailable']), message: text(snapshot.persistence?.message, 2000), messageInfo: boundedMessage(snapshot.persistence?.messageInfo, 2000), loadError: text(snapshot.persistence?.loadError, 2000) }, + connection: { status: snapshot.connection?.status, message: text(snapshot.connection?.message, 2000), messageInfo: boundedMessage(snapshot.connection?.messageInfo, 2000) }, tasks: snapshot.tasks.map(task => ({ ...pick(task, ['id', 'mode', 'name', 'threadId', 'status', 'continuous', 'rounds', 'sentCount', 'waitReason', 'retryAt', 'createdAt', 'updatedAt', 'progress', 'detailRevision']), - cwd: text(task.cwd, 256), activity: text(task.activity, 240), + cwd: text(task.cwd, 256), activity: text(task.activity, 240), activityMessage: boundedMessage(task.activityMessage, 240), + ...(task.mode === 'quota-wake' ? { notePreview: text(task.note || '', 500), noteTruncated: (task.note?.length || 0) > 500 } : {}), ...(task.wake ? { wake: pick(task.wake, ['armed', 'delivery', 'episodeId', 'exhaustedAt', 'sentAt', 'queueId']) } : {}), })), approvals: snapshot.approvals.map(item => ({ ...pick(item, ['id', 'taskId', 'method', 'detailToken']), requiresDetails: (item.reason?.length || 0) > 240 || (item.command?.length || 0) > 1000 || (item.cwd?.length || 0) > 256, reason: text(item.reason, 240), command: text(item.command, 1000), cwd: text(item.cwd, 256) })), quota: snapshot.quota ? { rateLimitsByLimitId: Object.fromEntries(buckets(snapshot.quota).slice(0, 16).map((bucket, index) => [String(bucket.limitId || index).slice(0, 80), { ...pick(bucket, ['limitId', 'limitName', 'planType', 'rateLimitReachedType'], 80), primary: windowSummary(bucket.primary), secondary: windowSummary(bucket.secondary) }])) } : null, history: snapshot.history.slice(-240).map(entry => ({ time: Number.isFinite(entry.time) ? entry.time : 0, values: entry.values.slice(0, 16).map(value => ({ id: text(value?.id, 40), used: Number.isFinite(value?.used) ? value.used : null })) })), - logs: snapshot.logs.slice(0, 50).map(entry => ({ ...pick(entry, ['id', 'time', 'type', 'taskId']), message: text(entry.message, 180) })), + logs: snapshot.logs.slice(0, 50).map(entry => ({ ...pick(entry, ['id', 'time', 'type', 'taskId']), message: text(entry.message, 180), messageInfo: boundedMessage(entry.messageInfo, 180) })), }; if (Buffer.byteLength(JSON.stringify(result)) > SUMMARY_BUDGET) { result.history = []; result.logs = []; result.approvals = result.approvals.map(item => ({ ...item, requiresDetails: true, command: '', reason: text(item.reason, 80) })); - result.summaryNotice = '列表内容较多，已精简历史和授权预览；完整内容请打开详情。'; + result.summaryNoticeInfo = message('system.summary_truncated'); + result.summaryNotice = formatMessage(result.summaryNoticeInfo); } return result; } diff --git a/server/task-model.js b/server/task-model.js new file mode 100644 index 0000000..cc5ac9d --- /dev/null +++ b/server/task-model.js @@ -0,0 +1,22 @@ +import { MessageError, message as textMessage } from '../public/message.js'; +import { directTaskModel, isDirectTask } from './direct-task.js'; +import { monitorTaskModel, isMonitorTask } from './monitor-task.js'; + +/** @typedef {import('./direct-task.js').DirectTask | import('./monitor-task.js').MonitorTask} Task */ + +// Omitted mode is accepted only for compatibility with persisted direct tasks. +// Startup resolves the legacy writer migration before assigning an explicit mode. +export function taskModel(task) { + if (isMonitorTask(task)) return monitorTaskModel; + if (isDirectTask(task)) return directTaskModel; + throw new MessageError(textMessage("error.task_mode")); +} + +export function validateTask(task) { + if (!task || typeof task.id !== 'string') throw new MessageError(textMessage("error.task_record")); + if (task.continuous !== undefined && typeof task.continuous !== 'boolean') throw new MessageError(textMessage("error.task_switch")); + if ((task.prompt != null && (typeof task.prompt !== 'string' || task.prompt.length > 12000)) || (task.note != null && (typeof task.note !== 'string' || task.note.length > 12000)) + || (task.continuationMessage !== undefined && (typeof task.continuationMessage !== 'string' || task.continuationMessage.length > 12000)) + || (task.output != null && typeof task.output !== 'string') || (task.plan != null && (!Array.isArray(task.plan) || !task.plan.every(step => step && typeof step.step === 'string')))) throw new MessageError(textMessage("error.task_fields")); + taskModel(task).validate(task); +} diff --git a/server/thread-reply.js b/server/thread-reply.js new file mode 100644 index 0000000..8b1af92 --- /dev/null +++ b/server/thread-reply.js @@ -0,0 +1,35 @@ +// Inspect protocol state only: a final reply ends the latest instruction, but +// does not independently prove that the project's acceptance criteria passed. +export function turnReplyState(turn) { + if (!turn || typeof turn.id !== 'string' || !turn.id) return 'unknown'; + if (turn.status === 'inProgress') return 'active'; + if (!['completed', 'failed', 'interrupted'].includes(turn.status) + || !Array.isArray(turn.items) || turn.items.some(item => !item || typeof item.type !== 'string') + || (turn.itemsView != null && turn.itemsView !== 'full')) return 'unknown'; + if (turn.status !== 'completed') return 'incomplete'; + const instruction = turn.items.findLastIndex(item => item.type === 'userMessage'); + const reply = turn.items.slice(instruction + 1).findLast(item => item.type === 'agentMessage'); + if (reply && (typeof reply.text !== 'string' || (reply.phase != null && !['commentary', 'final_answer'].includes(reply.phase)))) return 'unknown'; + // Older providers omit phase. A successfully completed turn and nonempty + // assistant reply retain compatibility; commentary alone is not a final reply. + return typeof reply?.text === 'string' && reply.text.trim() + && (reply.phase == null || reply.phase === 'final_answer') ? 'complete' : 'incomplete'; +} + +const runtimeState = thread => thread?.status?.type === 'active' ? 'active' + : ['idle', 'notLoaded'].includes(thread?.status?.type) ? null : 'unknown'; + +export async function readThreadReply(rpc, threadId) { + const { thread } = await rpc.call('thread/read', { threadId, includeTurns: false }); + if (thread?.id !== threadId) return 'unknown'; + const runtime = runtimeState(thread); + if (runtime) return runtime; + if (thread.historyMode === 'paginated') { + const page = await rpc.call('thread/turns/list', { threadId, limit: 1, sortDirection: 'desc', itemsView: 'full' }); + return Array.isArray(page?.data) && page.data.length === 1 ? turnReplyState(page.data[0]) : 'unknown'; + } + // Legacy app-servers expose full chronological history through thread/read. + const { thread: history } = await rpc.call('thread/read', { threadId, includeTurns: true }); + if (history?.id !== threadId) return 'unknown'; + return runtimeState(history) || (Array.isArray(history.turns) ? turnReplyState(history.turns.at(-1)) : 'unknown'); +} diff --git a/server/turn-controller.js b/server/turn-controller.js new file mode 100644 index 0000000..5c36526 --- /dev/null +++ b/server/turn-controller.js @@ -0,0 +1,246 @@ +import { setActivity, taskActivityMessage, message as textMessage } from '../public/message.js'; +import { randomUUID } from 'node:crypto'; +import { ClientError } from './http-policy.js'; +import { localProjectPath } from './project-path.js'; +import { isQuotaError, isWriterConflict, parseOutcome } from './policy.js'; +import { retainOutput, outcomeSummary } from './output.js'; +import { ACTIVE_TURN_STATUSES, waitForThread, isDirectTask } from './direct-task.js'; + +const outcomeSchema = { type: 'object', properties: { status: { type: 'string', enum: ['done', 'continue', 'blocked'] }, summary: { type: 'string' } }, required: ['status', 'summary'], additionalProperties: false }; +const instructions = '\n请维护可验证的步骤计划。仅在原始目标全部完成并验证后返回 status=done；还有可独立推进的工作则返回 continue；需要用户输入或权限则返回 blocked。summary 简述证据或阻塞原因。不要因为额度不足声称完成。'; +const TURN_EVENTS = new Set(['turn/started', 'turn/completed', 'turn/plan/updated', 'item/agentMessage/delta', 'item/started', 'item/completed']); +const START_EVENT_LIMIT = 256; +const START_EVENT_BYTES = 4 * 1024 * 1024; + +// Owns Codex turn execution, early-event correlation and manual approvals. +// Scheduling and persistence policy are supplied through explicit collaborators. +export class TurnController { + constructor(rpc, { persistence, canSchedule, hasExecutionQuota, isStopped, changed, log, invalidateQuota, onError }) { + this.rpc = rpc; + this.persistence = persistence; + this.canSchedule = canSchedule; + this.hasExecutionQuota = hasExecutionQuota; + this.isStopped = isStopped; + this.changed = changed; + this.log = log; + this.invalidateQuota = invalidateQuota; + this.onError = onError; + this.executions = new Map(); + this.approvals = new Map(); + } + get state() { return this.persistence.state; } + safely(action) { + try { return action(); } catch (error) { this.onError(error); } + } + async safelyAsync(action) { + try { return await action(); } catch (error) { this.onError(error); } + } + async run(task, epoch) { + if (!isDirectTask(task)) throw new ClientError(textMessage("error.monitor_execution")); + if (!this.canSchedule(epoch)) return; + const execution = { pending: false, events: [], bytes: 0, overflow: false }; + this.executions.set(task.id, execution); + const current = () => this.executions.get(task.id) === execution; + const previousRounds=task.rounds; + const permitted = () => { + if (!current() || task.status !== 'starting') return false; + if (this.canSchedule(epoch) && this.hasExecutionQuota()) return true; + task.status = 'queued'; setActivity(task, textMessage("task.start_cancelled_waiting_for_active_scheduling_and_fresh")); this.changed(); return false; + }; + try { + task.cwd = localProjectPath(task.cwd); + task.turnId = null; + task.status = 'starting'; task.waitReason=null; setActivity(task, textMessage("task.resuming_chat")); this.changed(); + if (task.rounds >= this.state.settings.maxRounds) { + task.status = 'blocked'; setActivity(task, textMessage("task.automatic_turn_limit_reached_resume_manually_to_continue")); this.changed(); return; + } + if (task.threadId) { + const read = await this.rpc.call('thread/read', { threadId: task.threadId, includeTurns: false }); + if (!permitted()) return; + if (read.thread.status?.type === 'active') { waitForThread(task,'thread'); this.changed(); return; } + await this.rpc.call('thread/resume', { threadId: task.threadId, cwd: task.cwd, excludeTurns: true, approvalPolicy: 'on-request', sandbox: 'workspace-write' }); + } else { + const result = await this.rpc.call('thread/start', { cwd: task.cwd, approvalPolicy: 'on-request', sandbox: 'workspace-write' }); + if (!current()) return; + task.threadId = result.thread.id; + } + if (!current()) return; + if (task.status !== 'starting') { this.changed(); return; } + if (!permitted()) return; + task.output = ''; task.outputTruncated = false; task.outcome = null; + task.toolCount = 0; task.rounds++; task.status = 'running'; task.updatedAt = Date.now(); + this.changed(); + execution.pending = true; + const result = await this.rpc.call('turn/start', { + threadId: task.threadId, + input: [{ type: 'text', text: `${task.rounds > 1 ? '继续原目标，先检查已有成果，避免重复操作。\n' : ''}${task.prompt}${instructions}`, text_elements: [] }], + outputSchema: outcomeSchema, + }); + if (!current()) return; + if (typeof result.turn?.id !== 'string' || !result.turn.id) throw new ClientError(textMessage("error.no_valid_turn_id_received_check_the_original")); + execution.pending = false; + if (ACTIVE_TURN_STATUSES.includes(task.status)) task.turnId = result.turn.id; + this.log(textMessage("log.work_started", { name: task.name }), 'success', task.id); + if (execution.overflow) { + task.status = 'pausing'; setActivity(task, textMessage("task.startup_events_exceeded_the_buffer_limit_interrupting_check")); + this.log(taskActivityMessage(task), 'warning', task.id); + } + const events = execution.events; execution.events = []; execution.bytes = 0; + for (const event of events) event.request ? this.request(event.message) : this.event(event.message); + this.changed(); + if (task.status === 'pausing' && task.turnId === result.turn.id) { + try { await this.rpc.call('turn/interrupt', { threadId: task.threadId, turnId: task.turnId }); } + catch (error) { + if (!current() || task.status !== 'pausing' || task.turnId !== result.turn.id) return; + task.status = 'blocked'; setActivity(task, textMessage("task.interruption_unconfirmed", { reason: error.messageInfo || error.message })); + this.log(taskActivityMessage(task), 'warning', task.id); this.changed(); + } + } + } catch (error) { + if (!current()) return; + if (['paused', 'pausing'].includes(task.status)) task.status = 'paused'; + else if (isWriterConflict(error)) { + task.rounds=previousRounds; task.turnId=null; task.lastError=error.message; + waitForThread(task,'writer'); + } + else { task.status = 'blocked'; setActivity(task, error); } + this.log(taskActivityMessage(task), 'warning', task.id); this.changed(); + } finally { + if (current()) { + this.executions.delete(task.id); + for (const event of execution.events) if (event.request) this.rejectRequest(event.message); + } + } + } + matchesTurn(task, params) { + const turnId = params.turnId ?? params.turn?.id; + return isDirectTask(task) && ACTIVE_TURN_STATUSES.includes(task.status) + && task.threadId === params.threadId && typeof task.turnId === 'string' && !!task.turnId + && turnId === task.turnId && (params.turnId == null || params.turn?.id == null || params.turnId === params.turn.id); + } + rejectRequest(msg) { + this.rpc.send({ id: msg.id, error: { code: -32601, message: 'This client requires manual handling for this request.' } }); + } + deferTurnEvent(task, message, request = false) { + const execution = this.executions.get(task.id); + if (!execution?.pending) return false; + // Notifications may precede the turn/start response. Its ID is authoritative. + const bytes = execution.overflow ? 0 : Buffer.byteLength(JSON.stringify(message)); + if (execution.overflow || execution.events.length >= START_EVENT_LIMIT || execution.bytes + bytes > START_EVENT_BYTES) { + for (const event of execution.events) if (event.request) this.rejectRequest(event.message); + execution.events = []; execution.bytes = 0; execution.overflow = true; + if (request) this.rejectRequest(message); + } else { + execution.events.push({ message, request }); execution.bytes += bytes; + } + return true; + } + event({ method, params: p = {} }) { + if (!TURN_EVENTS.has(method)) return; + const task = this.state.tasks.find(t => t.threadId === p.threadId); + if (!task) return; + if (!isDirectTask(task)) return; + if (this.deferTurnEvent(task, { method, params: p })) return; + if (!this.matchesTurn(task, p)) return; + if (method === 'turn/completed' && !['completed', 'failed', 'interrupted'].includes(p.turn?.status)) return; + task.updatedAt = Date.now(); + if (method === 'turn/started') { setActivity(task, textMessage("task.codex_is_working_on_the_goal")); } + else if (method === 'turn/plan/updated') { task.plan = p.plan.slice(0, 100).map(step => ({ ...step, step: outcomeSummary(step.step) })); setActivity(task, (p.explanation || task.plan.find(s => s.status === 'inProgress')?.step) ? outcomeSummary(p.explanation || task.plan.find(s => s.status === 'inProgress')?.step) : textMessage("task.plan_updated")); } + else if (method === 'item/agentMessage/delta') { + retainOutput(task, p.delta, true); + task.outcome = null; + } + else if (method === 'item/started') { + const item = p.item; + if (['commandExecution', 'fileChange', 'mcpToolCall', 'dynamicToolCall', 'webSearch'].includes(item.type)) task.toolCount++; + setActivity(task, ({ commandExecution: textMessage("task.running_a_command"), fileChange: textMessage("task.editing_files"), reasoning: textMessage("task.analyzing"), agentMessage: textMessage("task.generating_a_response"), mcpToolCall: textMessage("task.calling_a_tool") })[item.type] || textMessage("task.working")); + } else if (method === 'item/completed' && p.item.type === 'agentMessage') { + const text = p.item.text ?? task.output; + // Parse the complete JSON before retaining only its display tail. + task.outcome = parseOutcome(text); + if (p.item.text != null) retainOutput(task, text); + } + else if (method === 'turn/completed') { + for (const [id, request] of this.approvals) if (request.taskId === task.id) this.approvals.delete(id); + task.turnId = null; + if (p.turn.status === 'interrupted' || task.status === 'pausing') { + task.status = 'paused'; setActivity(task, textMessage("task.work_paused")); + } else if (p.turn.status === 'failed') { + const limited = isQuotaError(p.turn.error); + task.status = limited && task.continuous ? 'waiting' : 'failed'; + task.waitReason=task.status==='waiting' ? 'quota' : null; + setActivity(task, p.turn.error?.message || textMessage("task.this_turn_failed")); + task.retryAt = Date.now() + 60000; + if (limited) this.invalidateQuota(); + } else { + const outcome = task.outcome || parseOutcome(task.output); + setActivity(task, { message: outcome.summary, messageInfo: outcome.summaryMessage }); + task.status = outcome.status === 'done' ? 'completed' : outcome.status === 'continue' && task.continuous && task.toolCount > 0 ? 'queued' : 'blocked'; + if (outcome.status === 'continue' && task.toolCount === 0) setActivity(task, textMessage("task.no_tool_activity", { summary: task.activityMessage || task.activity })); + task.retryAt = Date.now() + 5000; + } + this.log(taskActivityMessage(task), task.status === 'completed' ? 'success' : 'info', task.id); + } else return; + this.changed({ deferSave: method === 'item/agentMessage/delta' }); + } + request(msg) { + const task = this.state.tasks.find(t => t.threadId === msg.params?.threadId); + if (task && isDirectTask(task) && this.deferTurnEvent(task, msg, true)) return; + if (!task || !this.matchesTurn(task, msg.params || {})) { this.rejectRequest(msg); return; } + if (task.status === 'pausing') { this.rejectRequest(msg); return; } + // File changes need a complete patch/scope view. Until that exists, leave + // these requests to the original Codex client instead of approving blindly. + const supported = msg.method === 'item/commandExecution/requestApproval'; + const commandFields = ['threadId', 'turnId', 'itemId', 'approvalId', 'command', 'reason', 'cwd', 'commandActions', 'kind', 'startedAtMs']; + // CLI 0.153.2 permits null optional scope fields. A non-null scope needs + // its own review UI; unknown fields still fail closed, even when null. + const absentScopeFields = ['additionalPermissions', 'availableDecisions', 'environmentId', 'networkApprovalContext', 'proposedExecpolicyAmendment', 'proposedNetworkPolicyAmendments']; + const reviewable = typeof msg.params.command === 'string' && !!msg.params.command.trim() && msg.params.command.length <= 12000 + && Object.keys(msg.params).every(key => commandFields.includes(key) || (absentScopeFields.includes(key) && msg.params[key] === null)) + && (msg.params.kind === undefined || msg.params.kind === 'command') + && (msg.params.startedAtMs === undefined || Number.isSafeInteger(msg.params.startedAtMs)) + && (msg.params.reason == null || (typeof msg.params.reason === 'string' && msg.params.reason.length <= 2000)) + && (msg.params.cwd == null || typeof msg.params.cwd === 'string'); + if (supported && reviewable) { + if (this.approvals.size >= 50) { this.rejectRequest(msg); return; } + this.approvals.set(String(msg.id), { id: msg.id, detailToken: randomUUID(), taskId: task.id, threadId: task.threadId, turnId: task.turnId, method: msg.method, reason: msg.params.reason || '操作需要授权', command: msg.params.command || '', cwd: msg.params.cwd || task.cwd }); + task.status = 'approval'; setActivity(task, textMessage("task.waiting_for_your_approval")); + this.log(textMessage("log.is_awaiting_approval", { name: task.name }), 'warning', task.id); + } else { + this.rejectRequest(msg); + this.cancelApprovals(task); + task.status = 'pausing'; setActivity(task, msg.method === 'item/fileChange/requestApproval' ? textMessage("task.file_changes_cannot_be_fully_reviewed_and_were") : reviewable ? textMessage("task.user_input_is_required_respond_in_codex_before") : textMessage("task.approval_details_cannot_be_fully_reviewed_and_were")); + if (task.turnId) void this.safelyAsync(() => this.interruptTask(task)); + } + this.changed(); + } + cancelApprovals(task) { + for (const [id, request] of this.approvals) if (request.taskId === task.id) { + this.approvals.delete(id); + this.safely(() => this.rpc.send({ id: request.id, result: { decision: 'decline' } })); + } + } + async interruptTask(task) { + const threadId = task.threadId, turnId = task.turnId; + try { await this.rpc.call('turn/interrupt', { threadId, turnId }); } + catch (error) { + if (!this.state.tasks.includes(task) || task.status !== 'pausing' || task.threadId !== threadId || task.turnId !== turnId) return; + task.status = 'blocked'; setActivity(task, textMessage("task.interruption_unconfirmed", { reason: error.messageInfo || error.message })); this.changed(); throw error; + } + } + approve(id, decision, token) { + if (!this.persistence.healthy) throw new ClientError(textMessage("error.recover_data_storage_before_handling_approvals")); + const request = this.approvals.get(String(id)); + if (!request || typeof token !== 'string' || token !== request.detailToken || !['accept', 'decline'].includes(decision)) throw new ClientError(textMessage("error.approval_expired_or_decision_invalid")); + if (request.method !== 'item/commandExecution/requestApproval' || typeof request.command !== 'string' || !request.command.trim()) throw new ClientError(textMessage("error.approval_details_cannot_be_fully_reviewed_handle_this")); + const task = this.state.tasks.find(t => t.id === request.taskId); + if (this.isStopped() || !this.rpc.ready || !task || task.status !== 'approval' || !this.matchesTurn(task, request)) throw new ClientError(textMessage("error.the_approval_turn_is_no_longer_active_or")); + // Confirm storage before granting an operation permission. + this.persistence.commit(); + this.rpc.send({ id: request.id, result: { decision } }); + this.approvals.delete(String(id)); + const remaining = [...this.approvals.values()].some(other => other.taskId === task.id); + task.status = remaining ? 'approval' : 'running'; setActivity(task, remaining ? textMessage("task.more_operations_await_approval") : decision === 'accept' ? textMessage("task.approved_continuing") : textMessage("task.operation_declined")); + this.changed(); + } +} diff --git a/tests/access.test.js b/tests/access.test.js index 212849b..12bab2d 100644 --- a/tests/access.test.js +++ b/tests/access.test.js @@ -3,9 +3,8 @@ import assert from 'node:assert/strict'; import { mkdtempSync, readFileSync, writeFileSync, realpathSync, rmSync } from 'node:fs'; import { join, dirname } from 'node:path'; import { tmpdir } from 'node:os'; -import { runInNewContext } from 'node:vm'; import access from '../server/access.cjs'; -import { AuthenticatedSource } from '../public/access.js'; +import { AuthenticatedSource, discardLegacyAccess, accessHeaders } from '../public/access.js'; import { doctor } from '../scripts/doctor.js'; test('credentials are random, persistent, mode-separated and malformed files fail closed', t => { @@ -23,10 +22,9 @@ test('credentials are random, persistent, mode-separated and malformed files fai test('retired browser bootstrap discards legacy credentials and never authorizes requests', () => { const token = 'a'.repeat(64), saved = new Map(); let replaced; - const source = readFileSync(new URL('../public/access.js', import.meta.url), 'utf8').replace(/^export /gm, '') + '\nthis.headers = accessHeaders();'; saved.set('continuer-access', token); const context = { window: {}, location: { hash: '#access=' + token, pathname: '/', search: '' }, history: { replaceState(_state, _title, url) { replaced = url; } }, sessionStorage: { removeItem: key => saved.delete(key), getItem: key => saved.get(key) }, URLSearchParams }; - runInNewContext(source, context); assert.equal(replaced, '/'); assert.equal(context.headers.Authorization, undefined); + discardLegacyAccess(context); assert.equal(replaced, '/'); assert.equal(accessHeaders().Authorization, undefined); assert.equal(saved.size, 0); }); diff --git a/tests/continuation-message.test.js b/tests/continuation-message.test.js new file mode 100644 index 0000000..66dc9e6 --- /dev/null +++ b/tests/continuation-message.test.js @@ -0,0 +1,201 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { EventEmitter } from 'node:events'; +import { mkdtempSync, realpathSync, rmSync } from 'node:fs'; +import { dirname, join } from 'node:path'; +import { tmpdir } from 'node:os'; +import { Manager } from '../server/manager.js'; +import { QueueSender } from '../server/queue-sender.js'; +import { Store, validateState } from '../server/store.js'; +import { dispatch, validate } from '../plugin/tools.js'; +import { TaskDetails } from '../public/task-details.js'; +import { interruptedThread } from './fixtures/thread-history.js'; + +const threadId = '33333333-3333-4333-8333-333333333333'; +const quota = usedPercent => ({ rateLimits: { primary: { usedPercent } } }); +function manager(store = { load: () => null, save() {} }) { + const rpc = new EventEmitter(), calls = []; + rpc.ready = true; rpc.close = () => {}; + rpc.call = async (_method, params) => ({ thread: interruptedThread(params?.threadId) }); + const sender = new QueueSender({ binary: 'mock-codex', run: async (_binary, args) => { calls.push(args); return `Queued message ${threadId}`; } }); + const m = new Manager(rpc, store, { demo: true, wakeSender: sender }); + m.connection.status = 'connected'; + return { m, calls, async cycle() { m.setQuota(quota(100)); await m.tick(); m.setQuota(quota(0)); await m.tick(); } }; +} + +test('custom multiline message survives a real isolated store restart and reaches only the selected chat once per recovery', async t => { + const parent = realpathSync(tmpdir()), directory = mkdtempSync(join(parent, 'continuer-message-')); + t.after(() => { assert.equal(dirname(realpathSync(directory)), parent); rmSync(directory, { recursive: true, force: true }); }); + const store = new Store(join(directory, 'state.json')); + const custom = '优先完成测试，遇到阻塞时说明原因。\n保留 "引号"、`代码`、$() 和 <标签>。'; + const original = manager(store), task = await original.m.importThread(threadId, '只在首页显示的备注', custom); + await original.cycle(); assert.equal(original.calls.length, 0, 'Import stays paused'); + original.m.stop(); + const restored = manager(store), current = restored.m.state.tasks[0]; + t.after(() => restored.m.stop()); + assert.equal(current.note, task.note); assert.equal(current.continuationMessage, custom); + await restored.m.action(current.id, 'resume'); + restored.m.setQuota(quota(0)); await restored.m.tick(); assert.equal(restored.calls.length, 0); + await restored.cycle(); await restored.m.tick(); + assert.deepEqual(restored.calls, [['queue', '--help'], ['queue', '--thread', threadId, '--message', custom]]); + assert.equal(current.sentCount, 1); + await restored.cycle(); assert.equal(current.sentCount, 2); assert.equal(restored.calls.at(-1).at(-1), custom); + assert.ok(restored.calls.every(args => !args.includes(task.note)), 'Notes never enter the queue'); +}); + +test('empty, whitespace and legacy records all send the default continuation', async () => { + for (const message of ['', ' \r\n\t ', undefined]) { + const f = manager(), task = await f.m.importThread(threadId, 'Local only', message); + if (message === undefined) delete task.continuationMessage; + await f.m.action(task.id, 'resume'); await f.cycle(); + assert.equal(f.calls.at(-1).at(-1), '继续'); assert.equal(task.sentCount, 1); f.m.stop(); + } +}); + +test('malformed or overlong messages are rejected before import or queue effects and cannot load from storage', async () => { + const f = manager(); + for (const message of [null, 1, {}, 'x'.repeat(12001)]) { + await assert.rejects(f.m.importThread(threadId, '', message), /续作消息/); + await assert.rejects(f.m.wakeSender.send(threadId, { message }), /续作消息/); + assert.throws(() => validate('continuer_import_session', { threadId, continuationMessage: message })); + } + assert.equal(f.calls.length, 0); assert.equal(f.m.state.tasks.length, 0); + const task = await f.m.importThread(threadId, '', 'x'.repeat(12000)); + validateState(f.m.state); + task.continuationMessage = null; assert.throws(() => validateState(f.m.state), /续作消息/); + f.m.stop(); +}); + +test('authenticated homepage summaries include bounded notes while full message remains in details', async () => { + const f = manager(), note = '