@yun520-1/heartflow 0.15.2

package/src/core/agents/AgentManager.js

@@ -0,0 +1,161 @@
+/**
+ * AgentManager - 多智能体管理器
+ * 负责协调 FocusAgent, MoodAgent, ReflectionAgent
+ */
+
+const FocusAgent = require('./FocusAgent.js');
+const MoodAgent = require('./MoodAgent.js');
+const ReflectionAgent = require('./ReflectionAgent.js');
+
+class AgentManager {
+  constructor() {
+    this.agents = {
+      focus: new FocusAgent(),
+      mood: new MoodAgent(),
+      reflection: new ReflectionAgent()
+    };
+    this.activeAgent = null;
+  }
+
+  /**
+   * 获取代理
+   * @param {string} agentName - 代理名称 (focus/mood/reflection)
+   * @returns {object} 代理实例
+   */
+  getAgent(agentName) {
+    return this.agents[agentName] || null;
+  }
+
+  /**
+   * 根据上下文自动选择代理
+   * @param {string} userInput - 用户输入
+   * @returns {string} 代理名称
+   */
+  selectAgent(userInput) {
+    const text = userInput.toLowerCase();
+    
+    // 检测用户明确指定代理
+    if (text.includes('专注') || text.includes('分心') || text.includes('注意力')) {
+      return 'focus';
+    }
+    
+    if (text.includes('情绪') || text.includes('心情') || text.includes('鼓励') || text.includes('沮丧') || text.includes('累')) {
+      return 'mood';
+    }
+    
+    if (text.includes('总结') || text.includes('反思') || text.includes('结束') || text.includes('报告')) {
+      return 'reflection';
+    }
+    
+    // 默认返回 null (由主引擎处理)
+    return null;
+  }
+
+  /**
+   * 处理用户输入
+   * @param {string} userInput - 用户输入
+   * @param {string} agentName - 指定代理 (可选)
+   * @returns {object} 代理响应
+   */
+  processInput(userInput, agentName = null) {
+    // 如果指定了代理
+    if (agentName && this.agents[agentName]) {
+      return this.invokeAgent(agentName, userInput);
+    }
+    
+    // 自动选择代理
+    const selected = this.selectAgent(userInput);
+    if (selected) {
+      return this.invokeAgent(selected, userInput);
+    }
+    
+    // 没有匹配的代理
+    return {
+      agent: null,
+      message: '没有检测到需要代理介入的信号'
+    };
+  }
+
+  /**
+   * 调用代理
+   * @param {string} agentName - 代理名称
+   * @param {string} userInput - 用户输入
+   * @returns {object} 代理响应
+   */
+  invokeAgent(agentName, userInput) {
+    const agent = this.agents[agentName];
+    this.activeAgent = agentName;
+    
+    switch (agentName) {
+      case 'focus':
+        const focusAnalysis = agent.analyzeFocus(userInput);
+        return {
+          agent: agent.name,
+          icon: agent.icon,
+          content: agent.generatePrompt(focusAnalysis),
+          data: focusAnalysis
+        };
+      
+      case 'mood':
+        const moodAnalysis = agent.analyzeMood(userInput);
+        return {
+          agent: agent.name,
+          icon: agent.icon,
+          content: agent.encourage(moodAnalysis),
+          data: moodAnalysis
+        };
+      
+      case 'reflection':
+        const summary = agent.endSession();
+        return {
+          agent: agent.name,
+          icon: agent.icon,
+          content: agent.generateReport(summary),
+          data: summary
+        };
+      
+      default:
+        return {
+          agent: null,
+          message: '未知代理'
+        };
+    }
+  }
+
+  /**
+   * 开始新会话
+   */
+  startSession() {
+    this.agents.reflection.startSession();
+    return { success: true, message: '多智能体会话开始' };
+  }
+
+  /**
+   * 结束会话
+   */
+  endSession() {
+    return this.agents.reflection.endSession();
+  }
+
+  /**
+   * 获取所有代理状态
+   */
+  getStatus() {
+    return {
+      activeAgent: this.activeAgent,
+      availableAgents: Object.keys(this.agents),
+      sessionDuration: this.agents.reflection.getSessionDuration()
+    };
+  }
+
+  /**
+   * 重置所有代理
+   */
+  reset() {
+    this.activeAgent = null;
+    this.agents.reflection.reset();
+    return { success: true, message: '所有代理已重置' };
+  }
+}
+
+module.exports = AgentManager;

package/src/core/agents/FocusAgent.js

@@ -0,0 +1,120 @@
+/**
+ * FocusAgent - 专注度监测代理
+ * 负责监测用户专注度，并在分心时给出提示
+ */
+
+// 注意：不在顶层 destructures — 等所有模块加载完再访问
+const heartflowEngine = require('../heartflow-engine.js');
+
+class FocusAgent {
+  constructor() {
+    this.name = '专注助手';
+    this.icon = '🎯';
+    this.focusThreshold = 6; // 专注度阈值 (1-10)
+    this.distractionKeywords = [
+      '分心', '走神', '无聊', '玩手机', '刷网页', '看手机',
+      '注意力', '集中', '专注', '干扰', '打扰'
+    ];
+  }
+
+  /**
+   * 分析用户输入的专注度
+   * @param {string} userInput - 用户输入
+   * @returns {object} 专注度分析结果
+   */
+  analyzeFocus(userInput) {
+    const text = userInput.toLowerCase();
+    let focusScore = 7; // 基础专注度
+    let distractions = [];
+    let suggestions = [];
+
+    // 检测分心关键词
+    this.distractionKeywords.forEach(keyword => {
+      if (text.includes(keyword)) {
+        focusScore -= 2;
+        distractions.push(`检测到分心信号："${keyword}"`);
+      }
+    });
+
+    // 检测任务相关词汇 (正面信号)
+    const taskKeywords = ['任务', '目标', '完成', '继续', '开始', '工作', '代码', '写'];
+    taskKeywords.forEach(keyword => {
+      if (text.includes(keyword)) {
+        focusScore += 1;
+      }
+    });
+
+    // 归一化专注度 (1-10)
+    focusScore = Math.max(1, Math.min(10, focusScore));
+
+    // 生成建议
+    if (focusScore < this.focusThreshold) {
+      suggestions = [
+        '📵 将手机放到视线之外',
+        '🚫 关闭不必要的浏览器标签',
+        '⏱️ 使用番茄工作法 (25 分钟专注)',
+        '🎧 播放专注音乐或白噪音',
+        '📝 写下分散注意力的想法，稍后处理'
+      ];
+    }
+
+    return {
+      agent: this.name,
+      focusScore,
+      isFocused: focusScore >= this.focusThreshold,
+      distractions,
+      suggestions,
+      timestamp: new Date().toISOString()
+    };
+  }
+
+  /**
+   * 生成分心提示
+   * @param {object} analysis - 专注度分析结果
+   * @returns {string} 提示文本
+   */
+  generatePrompt(analysis) {
+    if (analysis.isFocused) {
+      return `${this.icon} ${analysis.focusScore}/10 - 专注度良好，继续保持！`;
+    }
+
+    let prompt = `${this.icon} ${analysis.focusScore}/10 - 感觉有些分心\n\n`;
+    
+    if (analysis.distractions.length > 0) {
+      prompt += '检测到的干扰:\n';
+      analysis.distractions.forEach(d => {
+        prompt += `  - ${d}\n`;
+      });
+      prompt += '\n';
+    }
+
+    prompt += '建议尝试:\n';
+    analysis.suggestions.slice(0, 3).forEach(s => {
+      prompt += `${s}\n`;
+    });
+
+    return prompt;
+  }
+
+  /**
+   * 主动干预 (当检测到持续分心时)
+   * @param {object} state - 当前心流状态
+   * @returns {string} 干预文本
+   */
+  intervene(state) {
+    const FLOW_STATE = heartflowEngine.FLOW_STATE;
+    const getCurrentState = heartflowEngine.getCurrentState;
+    const duration = state?.duration || 0;
+    
+    if (duration > 10) {
+      return `${this.icon} 已经分心 ${duration} 分钟了，要试试 4-7-8 呼吸法吗？
+      
+吸气 4 秒 → 屏息 7 秒 → 呼气 8 秒
+重复 3-4 次，帮助重新集中注意力`;
+    }
+
+    return `${this.icon} 注意到你有些分心，需要帮助吗？`;
+  }
+}
+
+module.exports = FocusAgent;

package/src/core/agents/MoodAgent.js

@@ -0,0 +1,141 @@
+/**
+ * MoodAgent - 情绪分析代理
+ * 负责分析用户情绪，并给予情感支持
+ */
+
+// 延迟加载 — 避免循环 require 警告
+const heartflowEngine = require('../heartflow-engine.js');
+
+class MoodAgent {
+  constructor() {
+    this.name = '情绪助手';
+    this.icon = '💙';
+    this.emotionStates = {
+      positive: ['开心', '高兴', '满意', '顺利', '完成', '成功', '棒', '好'],
+      negative: ['烦', '累', '难', '挫败', '无聊', '讨厌', '糟糕', '失败', '困惑', '焦虑'],
+      neutral: ['嗯', '哦', '好的', '行', '可以']
+    };
+  }
+
+  /**
+   * 分析用户情绪
+   * @param {string} userInput - 用户输入
+   * @returns {object} 情绪分析结果
+   */
+  analyzeMood(userInput) {
+    const detectEmotionFromText = heartflowEngine.detectEmotionFromText;
+    const calculatePADState = heartflowEngine.calculatePADState;
+    const emotion = detectEmotionFromText(userInput);
+    const pad = calculatePADState(emotion.pleasure, emotion.arousal, emotion.dominance);
+    
+    // 情绪分类
+    let moodCategory = 'neutral';
+    if (emotion.pleasure > 2) moodCategory = 'positive';
+    else if (emotion.pleasure < -2) moodCategory = 'negative';
+    
+    // 情绪标签
+    let moodLabel = '平静';
+    if (emotion.pleasure > 5 && emotion.arousal > 3) moodLabel = '兴奋';
+    else if (emotion.pleasure > 3) moodLabel = '愉悦';
+    else if (emotion.pleasure < -5 && emotion.arousal > 3) moodLabel = '焦虑';
+    else if (emotion.pleasure < -3) moodLabel = '挫败';
+    else if (emotion.arousal < -3) moodLabel = '疲惫';
+    
+    // 生成支持建议
+    const support = this.generateSupport(moodCategory, moodLabel, pad);
+
+    return {
+      agent: this.name,
+      moodCategory,
+      moodLabel,
+      pad,
+      support,
+      timestamp: new Date().toISOString()
+    };
+  }
+
+  /**
+   * 生成情感支持
+   * @param {string} category - 情绪类别
+   * @param {string} label - 情绪标签
+   * @param {object} pad - PAD 状态
+   * @returns {string[]} 支持建议
+   */
+  generateSupport(category, label, pad) {
+    const supports = {
+      positive: [
+        '🌟 太棒了！保持这个状态！',
+        '💪 你的努力正在得到回报',
+        '🎉 为自己今天的进步感到骄傲'
+      ],
+      negative: [
+        '💙 我理解你的感受，这很正常',
+        '🌱 每一次挑战都是成长的机会',
+        '🤗 你已经做得很好了，休息一下没关系',
+        '🌈 困难是暂时的，你比想象中更强大',
+        '💪 让我们一起分解这个任务，一步一步来'
+      ],
+      neutral: [
+        '😊 平稳的状态很好',
+        '🎯 准备好继续前进吗？',
+        '💫 今天有什么想完成的吗？'
+      ]
+    };
+
+    // 根据 PAD 调整支持
+    if (pad.dominance < 0) {
+      supports.negative.unshift('🔑 你掌控着自己的节奏，按自己的方式来');
+    }
+    
+    if (pad.arousal < -5) {
+      supports.negative.unshift('☕ 先休息一下吧，喝杯水，活动一下');
+    }
+
+    return supports[category] || supports.neutral;
+  }
+
+  /**
+   * 生成鼓励语
+   * @param {object} analysis - 情绪分析结果
+   * @returns {string} 鼓励文本
+   */
+  encourage(analysis) {
+    const supports = this.generateSupport(analysis.moodCategory, analysis.moodLabel, analysis.pad);
+    
+    let prompt = `${this.icon} ${analysis.moodLabel} (P:${analysis.pad.pleasure} A:${analysis.pad.arousal} D:${analysis.pad.dominance})\n\n`;
+    
+    prompt += supports.slice(0, 2).join('\n') + '\n\n';
+    
+    if (analysis.moodCategory === 'negative') {
+      prompt += '需要我帮你做什么吗？\n';
+      prompt += '  • 分解任务\n';
+      prompt += '  • 调整难度\n';
+      prompt += '  • 或者只是倾听';
+    }
+
+    return prompt;
+  }
+
+  /**
+   * 主动关怀 (检测到低落情绪时)
+   * @param {object} analysis - 情绪分析结果
+   * @returns {string} 关怀文本
+   */
+  checkIn(analysis) {
+    if (analysis.moodCategory === 'negative' && analysis.pad.pleasure < -5) {
+      return `${this.icon} 注意到你情绪有些低落，想聊聊吗？
+
+记住：
+- 你的感受是有效的
+- 寻求帮助是勇敢的表现
+- 你并不孤单
+
+如果需要专业支持：
+📞 心理援助热线：400-161-9995`;
+    }
+
+    return `${this.icon} 今天感觉怎么样？`;
+  }
+}
+
+module.exports = MoodAgent;

package/src/core/agents/ReflectionAgent.js

@@ -0,0 +1,241 @@
+/**
+ * ReflectionAgent - 反思总结代理
+ * 负责在会话结束时，总结本次心流体验并提出改进建议
+ */
+
+// 动态加载 report-generator，如果不存在则使用默认实现
+let generateReport;
+try {
+  generateReport = require('../../../.opencode/memory/report-generator.js').generateReport;
+} catch (e) {
+  // 默认实现
+  generateReport = (sessionData) => ({
+    timestamp: new Date().toISOString(),
+    duration: sessionData.endTime - sessionData.startTime,
+    flowStates: sessionData.flowStates || [],
+    distractions: sessionData.distractions || [],
+    achievements: sessionData.achievements || [],
+    moodChanges: sessionData.moodChanges || [],
+    summary: `本次会话共进入心流状态 ${(sessionData.flowStates || []).length} 次`,
+    suggestions: []
+  });
+}
+
+class ReflectionAgent {
+  constructor() {
+    this.name = '反思助手';
+    this.icon = '🪞';
+    this.sessionData = {
+      startTime: null,
+      endTime: null,
+      flowStates: [],
+      distractions: [],
+      achievements: [],
+      moodChanges: []
+    };
+  }
+
+  /**
+   * 记录心流状态
+   * @param {string} state - 心流状态
+   * @param {number} duration - 持续时间 (分钟)
+   */
+  recordFlowState(state, duration) {
+    this.sessionData.flowStates.push({
+      state,
+      duration,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  /**
+   * 记录分心事件
+   * @param {string} reason - 分心原因
+   * @param {number} duration - 分心时长 (分钟)
+   */
+  recordDistraction(reason, duration) {
+    this.sessionData.distractions.push({
+      reason,
+      duration,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  /**
+   * 记录成就
+   * @param {string} achievement - 成就描述
+   */
+  recordAchievement(achievement) {
+    this.sessionData.achievements.push({
+      achievement,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  /**
+   * 记录情绪变化
+   * @param {string} mood - 情绪标签
+   * @param {number} intensity - 强度 (1-10)
+   */
+  recordMoodChange(mood, intensity) {
+    this.sessionData.moodChanges.push({
+      mood,
+      intensity,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  /**
+   * 生成会话总结
+   * @returns {object} 总结报告
+   */
+  generateSessionSummary() {
+    const { flowStates, distractions, achievements, moodChanges } = this.sessionData;
+    
+    // 计算总心流时间
+    const totalFlowTime = flowStates
+      .filter(s => s.state === 'IN_FLOW')
+      .reduce((sum, s) => sum + s.duration, 0);
+    
+    // 计算分心次数
+    const distractionCount = distractions.length;
+    
+    // 计算成就数
+    const achievementCount = achievements.length;
+    
+    // 计算平均情绪
+    const avgMood = moodChanges.length > 0
+      ? moodChanges.reduce((sum, m) => sum + m.intensity, 0) / moodChanges.length
+      : 5;
+
+    // 生成改进建议
+    const improvements = this.generateImprovements(flowStates, distractions, moodChanges);
+
+    return {
+      agent: this.name,
+      duration: this.getSessionDuration(),
+      totalFlowTime,
+      distractionCount,
+      achievementCount,
+      avgMood: avgMood.toFixed(1),
+      improvements,
+      highlights: achievements.map(a => a.achievement),
+      timestamp: new Date().toISOString()
+    };
+  }
+
+  /**
+   * 生成改进建议
+   */
+  generateImprovements(flowStates, distractions, moodChanges) {
+    const improvements = [];
+
+    // 基于心流时间
+    const totalFlow = flowStates.filter(s => s.state === 'IN_FLOW').reduce((sum, s) => sum + s.duration, 0);
+    if (totalFlow < 25) {
+      improvements.push('⏱️ 心流时间较短，建议尝试番茄工作法 (25 分钟专注)');
+    } else if (totalFlow > 90) {
+      improvements.push('💪 心流时间很长，记得适当休息，避免疲劳');
+    }
+
+    // 基于分心次数
+    if (distractions.length > 3) {
+      improvements.push('📵 分心次数较多，建议：\n  - 关闭通知\n  - 使用专注模式\n  - 告知他人勿扰');
+    }
+
+    // 基于情绪变化
+    const negativeMoods = moodChanges.filter(m => m.intensity < 4);
+    if (negativeMoods.length > 2) {
+      improvements.push('💙 情绪波动较大，建议：\n  - 记录情绪触发点\n  - 练习正念呼吸\n  - 适当调整任务难度');
+    }
+
+    if (improvements.length === 0) {
+      improvements.push('🌟 表现很好！继续保持当前的节奏和方法');
+    }
+
+    return improvements;
+  }
+
+  /**
+   * 计算会话时长
+   */
+  getSessionDuration() {
+    if (!this.sessionData.startTime) return 0;
+    const end = this.sessionData.endTime || new Date();
+    return Math.round((end - this.sessionData.startTime) / 60000);
+  }
+
+  /**
+   * 生成反思报告
+   * @param {object} summary - 会话总结
+   * @returns {string} 报告文本
+   */
+  generateReport(summary) {
+    let report = `${this.icon} 本次心流会话总结\n\n`;
+    report += '═'.repeat(40) + '\n\n';
+    
+    report += `⏱️ 会话时长：${summary.duration} 分钟\n`;
+    report += `🌊 心流时间：${summary.totalFlowTime} 分钟\n`;
+    report += `⚠️ 分心次数：${summary.distractionCount} 次\n`;
+    report += `🏆 完成成就：${summary.achievementCount} 个\n`;
+    report += `💙 平均情绪：${summary.avgMood}/10\n\n`;
+    
+    if (summary.highlights.length > 0) {
+      report += '✨ 高光时刻:\n';
+      summary.highlights.forEach(h => {
+        report += `  • ${h}\n`;
+      });
+      report += '\n';
+    }
+    
+    report += '💡 改进建议:\n';
+    summary.improvements.forEach(i => {
+      report += `${i}\n\n`;
+    });
+    
+    report += '═'.repeat(40) + '\n';
+    report += `生成时间：${summary.timestamp}\n`;
+
+    return report;
+  }
+
+  /**
+   * 开始新会话
+   */
+  startSession() {
+    this.sessionData = {
+      startTime: new Date(),
+      endTime: null,
+      flowStates: [],
+      distractions: [],
+      achievements: [],
+      moodChanges: []
+    };
+    return { success: true, message: '新会话开始' };
+  }
+
+  /**
+   * 结束会话
+   */
+  endSession() {
+    this.sessionData.endTime = new Date();
+    return this.generateSessionSummary();
+  }
+
+  /**
+   * 重置代理
+   */
+  reset() {
+    this.sessionData = {
+      startTime: null,
+      endTime: null,
+      flowStates: [],
+      distractions: [],
+      achievements: [],
+      moodChanges: []
+    };
+    return { success: true, message: '反思助手已重置' };
+  }
+}
+
+module.exports = ReflectionAgent;