feat: v0.4.0 四阶段迭代 — 安全加固 + 工程基线 + 架构重构 + 双 Provider 扩展
P0 安全修复: - API Key 加密存储（safeStorage 密钥链，版本化前缀，历史明文平滑兼容） - 间接提示注入防护（SecurityScanHook 工具结果深扫描，网络工具脱敏/本地工具警示分级） - error:report IPC 断链修复（渲染进程错误上报落 electron-log + 审计） - abort 信号贯通工具层（run_command/dev-tools 子进程随会话中断终止） - run_command 沙箱加固（cd 系统目录/敏感文件读取拦截 + chcp 前缀剥离防解析退化） - .env 真实生效（dotenv 回退加载，应用内配置优先） P1 工程基础: - ESLint 9 flat config + 全部 34 条存量 warnings 清零（零容忍基线） - 测试基线 118 用例 11 文件（token/文件防护/权限/沙箱/注入/命令/引擎/注册表/审计链/摘要分层） - test:electron 双模式（ELECTRON_RUN_AS_NODE 跑 Electron ABI，SQLite 套件全执行） - SessionRecorder 多会话隔离 + 9 种 TRACE 事件补全（含最终轮 iteration_end） - Provider 故障转移（重试耗尽/不可重试一次性切换 fallback + 前端通知） - MCP 真就绪（等待全部连接完成再广播 tools:ready） - SLO/HealthChecker 真实接入（60s 巡检 + 托盘状态） - CONFIG_DEFAULTS 单一来源（消除 SEED 双源漂移） P2 架构升级: - handlers.ts 1940 行拆分为 13 个 IPC 域模块（防重入注册 + 多窗口广播） - AgentEngineManager 每会话独立引擎（LRU 30 + adapter 工厂隔离 abort 信号） - TaskOrchestrator EngineProvider 改造 + abortByParent 联动中断 SubAgent - 会话摘要分层上下文（session_summaries 滚动摘要 + 截断游标清理防因果污染） - 消息编辑重发/重新生成（truncateAfter IPC + store 动作 + UI） - Markdown 导出 / WebSearch 并行抓取（并发 3）/ 记忆 TF 缓存 / 版本构建期注入 P3 能力扩展: - OpenAI Adapter（o 系列推理模型 reasoning_effort/max_completion_tokens） - Anthropic Adapter（原生 Messages API：tool_use 块/角色合并/thinking budget/图片 base64/SSE 事件机） - 设置页/Onboarding 六 Provider 全链路接入
This commit is contained in:
@@ -11,6 +11,12 @@
|
||||
* 4. 真正的 abort — 通过引擎引用调用 engine.abort()
|
||||
* 5. 事件隔离 — SubAgent 的流式事件不直接转发到前端，仅通过 orchestrator 事件通知
|
||||
*
|
||||
* P2-10 改造：
|
||||
* - 依赖 EngineProvider（AgentEngineManager）而非单个 mainEngine：
|
||||
* SubAgent 通过工厂获取独立 adapter 实例，彻底消除 abort 信号互踩问题
|
||||
* （原实现 SubEngine 共享主引擎 adapter，setAbortSignal 单槽位会互相覆盖）
|
||||
* - 新增 abortByParent(parentSessionId)：用户中断会话时联动中断其派生的 SubAgent
|
||||
*
|
||||
* @see docs/生产级通用 AI Agent 智能体桌面应用：完整设计与构建指南.html — 第五章
|
||||
*/
|
||||
|
||||
@@ -18,7 +24,7 @@ import { EventEmitter } from 'events';
|
||||
import { nanoid } from 'nanoid';
|
||||
import { AgentLoopEngine } from '../agent-loop/engine';
|
||||
import type { AgentLoopConfig } from '../agent-loop/types';
|
||||
import type { MetonaMessage, MetonaSystemPrompt, MetonaToolDef } from '../types';
|
||||
import type { MetonaMessage, MetonaSystemPrompt, MetonaToolDef, IMetonaProviderAdapter } from '../types';
|
||||
import type { ToolRegistry } from '../tools/registry';
|
||||
import type { PreToolHook } from '../hooks/pre-tool';
|
||||
import type { PostToolHook } from '../hooks/post-tool';
|
||||
@@ -32,8 +38,24 @@ export interface SubAgentResult {
|
||||
iterations: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* P2-10: 引擎供给接口（由 AgentEngineManager 实现）
|
||||
* orchestrator 不再持有单个引擎引用，而是按需创建独立实例。
|
||||
*/
|
||||
export interface EngineProvider {
|
||||
/** 主 adapter（读取 contextWindow 等元信息） */
|
||||
getAdapter(): IMetonaProviderAdapter;
|
||||
/** 创建独立 adapter 实例（SubAgent 专用，隔离 abort 信号） */
|
||||
createAdapter(): IMetonaProviderAdapter;
|
||||
/** 故障转移 Provider（可为 null） */
|
||||
getFallbackAdapter(): IMetonaProviderAdapter | null;
|
||||
/** 工作空间路径 */
|
||||
getWorkspacePath(): string;
|
||||
}
|
||||
|
||||
interface SubAgentHandle {
|
||||
taskId: string;
|
||||
parentSessionId: string;
|
||||
description: string;
|
||||
status: 'pending' | 'running' | 'completed' | 'error';
|
||||
depth: number;
|
||||
@@ -52,7 +74,7 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
private sessionDepth = new Map<string, number>();
|
||||
|
||||
constructor(
|
||||
private mainEngine: AgentLoopEngine,
|
||||
private engines: EngineProvider,
|
||||
private toolRegistry?: ToolRegistry,
|
||||
private preToolHooks: PreToolHook[] = [],
|
||||
private postToolHooks: PostToolHook[] = [],
|
||||
@@ -68,7 +90,7 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
* engine.updateConfig() 即时生效；但 SubAgent 在 delegate() 时从 defaultConfig
|
||||
* 复制配置，若 defaultConfig 不同步，新创建的 SubAgent 仍使用旧配置。
|
||||
*
|
||||
* 此方法供 handlers.ts 在 config:set 时同步调用，确保后续 SubAgent 使用最新配置。
|
||||
* 此方法供 IPC 层在 config:set 时同步调用，确保后续 SubAgent 使用最新配置。
|
||||
*/
|
||||
updateDefaultConfig(partial: Partial<AgentLoopConfig>): void {
|
||||
this.defaultConfig = { ...this.defaultConfig, ...partial };
|
||||
@@ -107,7 +129,7 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
|
||||
this.emit('taskDelegated', { taskId, description: params.description, parentSessionId: params.parentSessionId, depth });
|
||||
|
||||
// ===== 创建独立的引擎实例 =====
|
||||
// ===== 创建独立的引擎实例（P2-10: 独立 adapter，隔离 abort 信号） =====
|
||||
const subEngine = new AgentLoopEngine(
|
||||
{
|
||||
maxIterations: params.maxIterations ?? 10,
|
||||
@@ -117,12 +139,13 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
contextLength: this.defaultConfig?.contextLength,
|
||||
contextWindow: this.defaultConfig?.contextWindow ?? 128_000,
|
||||
},
|
||||
this.mainEngine.getAdapter(),
|
||||
this.engines.createAdapter(),
|
||||
this.toolRegistry,
|
||||
this.preToolHooks,
|
||||
this.postToolHooks,
|
||||
);
|
||||
subEngine.setWorkspacePath(this.mainEngine.getWorkspacePath());
|
||||
subEngine.setFallbackAdapter(this.engines.getFallbackAdapter());
|
||||
subEngine.setWorkspacePath(this.engines.getWorkspacePath());
|
||||
|
||||
// ===== 工具白名单设置 =====
|
||||
const allowedTools = this.resolveTools(params.tools);
|
||||
@@ -130,6 +153,7 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
|
||||
const handle: SubAgentHandle = {
|
||||
taskId,
|
||||
parentSessionId: params.parentSessionId,
|
||||
description: params.description,
|
||||
status: 'running',
|
||||
depth,
|
||||
@@ -201,7 +225,6 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
return result;
|
||||
} finally {
|
||||
// #5 修复: 统一在 finally 块恢复 sessionDepth，覆盖正常完成/异常/abort 所有路径
|
||||
// 之前 try 和 catch 中各有一份重复的恢复逻辑，且 abort 路径（handle.abort）跳过了恢复
|
||||
// 审查修复: 如果 abortAll 已 clear sessionDepth，不再恢复（避免覆盖紧急清理）。
|
||||
// 场景：用户紧急中断时 abortAll 先 clear，若 SubEngine 随后才返回执行 finally，
|
||||
// 不应把已清空的 sessionDepth 又 set 回 currentDepth。
|
||||
@@ -213,9 +236,7 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
}
|
||||
}
|
||||
this.activeSubAgents.delete(taskId);
|
||||
// #4 修复: SubEngine 共享主 Engine 的 adapter，完成后必须恢复主 Engine 的 abort signal，
|
||||
// 否则主 Engine 后续 fetch 无法被用户中断（SubEngine 覆盖并清除了 adapter 的 signal）
|
||||
this.mainEngine.restoreAbortSignal();
|
||||
// P2-10: SubEngine 使用独立 adapter 实例，无需恢复主引擎的 abort signal
|
||||
}
|
||||
}
|
||||
|
||||
@@ -280,6 +301,24 @@ export class TaskOrchestrator extends EventEmitter {
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* P2-10: 中断指定父会话派生的所有 SubAgent
|
||||
* （用户中断会话时由 IPC abort handler 联动调用，消除"会话停了子任务还在跑"）
|
||||
*/
|
||||
abortByParent(parentSessionId: string): number {
|
||||
let aborted = 0;
|
||||
for (const handle of this.activeSubAgents.values()) {
|
||||
if (handle.parentSessionId === parentSessionId && handle.status === 'running') {
|
||||
handle.abort();
|
||||
aborted++;
|
||||
}
|
||||
}
|
||||
if (aborted > 0) {
|
||||
log.info(`[Orchestrator] Aborted ${aborted} SubAgent(s) of session ${parentSessionId}`);
|
||||
}
|
||||
return aborted;
|
||||
}
|
||||
|
||||
/**
|
||||
* 完成子任务（外部触发，保留接口兼容）
|
||||
*/
|
||||
|
||||
Reference in New Issue
Block a user