Files
metona-ollama-desktop/src/renderer/services/sub-agent.ts
T
thzxx 374d86086e feat: v4.3 生态扩展 — 诊断系统 + Heartbeat + 子代理 + MCP
新增功能:

1. 🩺 一键诊断系统
   - 设置面板添加「一键诊断」按钮
   - 检查项:Ollama 连接、模型可用性、模型能力(Tools/Vision/Think)、
     SQLite 数据库、技能系统、应用版本信息
   - 实时渲染诊断结果,/⚠️/ 状态标识

2. 💓 Heartbeat 后台检查
   - 设置面板添加开关 + 间隔选择(10分/30分/1小时/2小时)
   - 定时检查 Ollama 连接,异常时系统通知
   - 配置持久化到 settings,启动时自动恢复
   - startHeartbeat/stopHeartbeat/restoreHeartbeat 三件套

3. 🤖 子代理委派(spawn_task)
   - 新增 spawn_task 工具(26 个工具)
   - 子 Agent 独立运行(独立消息上下文,5 轮上限,2 分钟超时)
   - 不支持工具调用,专注于文本推理任务
   - 主 Agent 可传入附加上下文
   - 结果返回主 Agent Loop

4. 🔌 MCP Client 框架
   - mcp-client.ts: MCP 服务器配置管理(增删改查、启用禁用)
   - 配置存储在 settings.mcp_servers
   - 工具注册框架就绪,待主进程 MCP bridge 实现协议通信

新增文件:mcp-client.ts, sub-agent.ts
修改文件:settings-modal.ts, index.html, main.ts, tool-registry.ts
2026-04-18 09:25:40 +08:00

113 lines
3.6 KiB
TypeScript

/**
* SubAgent - 子代理委派系统 (v4.3)
* 允许主 Agent 将独立任务委派给子 Agent 执行
* 子 Agent 独立运行,完成后将结果返回给主 Agent
*/
import { state, KEYS } from '../state/state.js';
import { OllamaAPI } from '../api/ollama.js';
import { logInfo, logWarn, logError, logAgentLoop } from './log-service.js';
import type { ToolResult } from '../types.js';
const SUB_AGENT_TIMEOUT = 120000; // 2 分钟超时
const SUB_AGENT_MAX_LOOPS = 5; // 子 Agent 最多 5 轮
/**
* 执行子 Agent 任务
* @param task 子任务描述
* @param context 附加上下文(主 Agent 提供的参考信息)
* @returns 子 Agent 的执行结果
*/
export async function executeSubAgent(task: string, context?: string): Promise<ToolResult> {
const api = state.get<OllamaAPI>(KEYS.API);
const model = state.get<string>('_defaultModel', '');
if (!api || !model) {
return { success: false, error: '未选择模型,无法执行子任务' };
}
logInfo(`子 Agent 启动`, `任务: ${task.slice(0, 80)}`);
const systemPrompt = `你是一个子任务执行 Agent。你的任务是高效完成指定的单一任务,然后给出简洁的结果报告。
不要闲聊,不要说废话。直接执行任务,完成后给出结果。
${context ? `\n附加上下文:\n${context}` : ''}`;
const messages: Array<{ role: string; content: string }> = [
{ role: 'system', content: systemPrompt },
{ role: 'user', content: task }
];
let resultContent = '';
let loopCount = 0;
const startTime = Date.now();
try {
while (loopCount < SUB_AGENT_MAX_LOOPS) {
loopCount++;
if (Date.now() - startTime > SUB_AGENT_TIMEOUT) {
logWarn('子 Agent 超时', `${loopCount} 轮`);
break;
}
let content = '';
let toolCalls: Array<{ name: string; arguments: Record<string, unknown> }> = [];
await api.chatStream({
model,
messages,
stream: true,
think: false,
options: { num_ctx: 8192, temperature: 0.3 }
} as any, (chunk: any) => {
if (chunk.message?.content) content += chunk.message.content;
if (chunk.message?.tool_calls?.length) {
for (const tc of chunk.message.tool_calls) {
if (tc.function?.name) {
toolCalls.push({ name: tc.function.name, arguments: tc.function.arguments || {} });
}
}
}
});
resultContent = content;
if (toolCalls.length === 0) {
// 子 Agent 完成
logInfo(`子 Agent 完成`, `${loopCount} 轮, ${resultContent.length} 字`);
return {
success: true,
content: resultContent,
loops: loopCount,
duration: Date.now() - startTime
};
}
// 子 Agent 调用了工具(不支持,提示直接回答)
messages.push({ role: 'assistant', content });
messages.push({
role: 'user',
content: '你无法调用工具。请基于已有信息直接给出回答。如果需要工具才能完成,请说明你无法完成此任务及原因。'
});
}
// 达到最大轮次
logWarn('子 Agent 达到最大轮次', `${loopCount} 轮`);
return {
success: true,
content: resultContent || '(子任务执行超时)',
loops: loopCount,
duration: Date.now() - startTime,
partial: true
};
} catch (err) {
logError('子 Agent 错误', (err as Error).message);
return {
success: false,
error: (err as Error).message,
loops: loopCount,
duration: Date.now() - startTime
};
}
}