@yun520-1/heartflow 0.15.2

package/src/core/emotion/EmotionKeywords.js

@@ -0,0 +1,217 @@
+/**
+ * EmotionKeywords - 统一情感关键词库
+ * 所有模块从这里导入，避免重复定义
+ */
+
+const positiveWords = [
+  { word: '开心', weight: 0.9 },
+  { word: '高兴', weight: 0.9 },
+  { word: '快乐', weight: 0.9 },
+  { word: '棒', weight: 0.8 },
+  // 注意："好"作为单字权重低，容易误匹配"好累""好大"等复合词，应优先于单独判断
+  { word: '好', weight: 0.3 },
+  { word: '喜欢', weight: 0.8 },
+  { word: '满意', weight: 0.7 },
+  { word: 'happy', weight: 0.8 },
+  { word: 'joy', weight: 0.9 },
+  { word: 'glad', weight: 0.7 },
+  { word: 'great', weight: 0.8 },
+  { word: 'thanks', weight: 0.7 },
+  { word: '不错', weight: 0.6 },
+  { word: '太好了', weight: 0.9 },
+  { word: '谢谢', weight: 0.7 },
+  { word: '感激', weight: 0.8 },
+  { word: '感恩', weight: 0.8 },
+  { word: ' appreciate', weight: 0.7 }
+];
+
+const negativeWords = [
+  { word: '难过', weight: 0.8 },
+  { word: '伤心', weight: 0.9 },
+  { word: '痛苦', weight: 0.8 },
+  { word: '难受', weight: 0.7 },
+  { word: '糟糕', weight: 0.7 },
+  { word: '失望', weight: 0.7 },
+  { word: 'sad', weight: 0.8 },
+  { word: 'unhappy', weight: 0.8 },
+  { word: 'hurt', weight: 0.7 }
+];
+
+const stressWords = [
+  { word: '压力', weight: 0.8 },
+  { word: '紧张', weight: 0.7 },
+  { word: '焦虑', weight: 0.9 },
+  { word: '担心', weight: 0.7 },
+  { word: '害怕', weight: 0.8 },
+  { word: 'stress', weight: 0.8 },
+  { word: 'anxious', weight: 0.8 },
+  { word: 'worried', weight: 0.7 },
+  { word: 'fear', weight: 0.8 }
+];
+
+const tiredWords = [
+  { word: '累', weight: 0.8 },
+  { word: '困', weight: 0.7 },
+  { word: '疲惫', weight: 0.9 },
+  { word: '疲倦', weight: 0.8 },
+  { word: '休息', weight: 0.6 },
+  { word: 'tired', weight: 0.8 },
+  { word: 'sleepy', weight: 0.7 },
+  { word: 'exhausted', weight: 0.9 },
+  { word: '好累', weight: 0.8 },
+  { word: '累了', weight: 0.8 }
+];
+
+const gratefulWords = [
+  { word: '谢谢', weight: 0.8 },
+  { word: '感谢', weight: 0.9 },
+  { word: '感激', weight: 0.9 },
+  { word: '感恩', weight: 0.9 },
+  { word: 'thanks', weight: 0.8 },
+  { word: 'appreciate', weight: 0.9 },
+  { word: 'grateful', weight: 0.9 },
+  { word: '多谢', weight: 0.8 }
+];
+
+const excitedWords = [
+  { word: '太激动了', weight: 1.0 },
+  { word: '厉害', weight: 0.8 },
+  { word: '牛', weight: 0.8 },
+  { word: '突破', weight: 0.9 },
+  { word: '创意', weight: 0.7 },
+  { word: '爆发', weight: 0.8 },
+  { word: 'excited', weight: 0.9 },
+  { word: 'amazing', weight: 0.9 },
+  { word: 'breakthrough', weight: 1.0 },
+  { word: 'wow', weight: 0.9 },
+  { word: '太棒了', weight: 1.0 },
+  { word: '激动', weight: 0.8 }
+];
+
+const questionWords = [
+  { word: '为什么', weight: 0.8 },
+  { word: '怎么', weight: 0.7 },
+  { word: '什么', weight: 0.6 },
+  { word: '如何', weight: 0.7 },
+  { word: '是不是', weight: 0.6 },
+  { word: '能不能', weight: 0.6 },
+  { word: 'why', weight: 0.8 },
+  { word: 'how', weight: 0.7 },
+  { word: 'what', weight: 0.6 },
+  { word: 'which', weight: 0.5 },
+  { word: '?', weight: 0.5 },
+  { word: '为什么呢', weight: 0.9 },
+  { word: '想知道', weight: 0.8 },
+  { word: '好奇', weight: 0.8 }
+];
+
+const calmWords = [
+  { word: '冷静', weight: 0.8 },
+  { word: '平静', weight: 0.9 },
+  { word: '淡定', weight: 0.8 },
+  { word: '慢慢来', weight: 0.7 },
+  { word: '不急', weight: 0.7 },
+  { word: '稳', weight: 0.6 },
+  { word: '放松', weight: 0.8 }
+];
+
+const exclamationWords = [
+  { word: '哇', weight: 0.8 },
+  { word: '呀', weight: 0.6 },
+  { word: '啊', weight: 0.5 },
+  { word: '哇哦', weight: 0.9 },
+  { word: '天哪', weight: 0.9 },
+  { word: 'wow', weight: 0.9 },
+  { word: 'omg', weight: 0.9 },
+  { word: 'hey', weight: 0.5 }
+];
+
+/**
+ * 从文本中检测匹配的关键词及其权重
+ * @param {string} text - 用户输入
+ * @returns {object} - { emotionType: { matchedWords: [], totalWeight: number, avgWeight: number } }
+ */
+function detectKeywordsWithWeight(text) {
+  const lower = text.toLowerCase();
+  const allCategories = {
+    positive: positiveWords,
+    negative: negativeWords,
+    stress: stressWords,
+    tired: tiredWords,
+    grateful: gratefulWords,
+    excited: excitedWords,
+    question: questionWords,
+    calm: calmWords,
+    exclamation: exclamationWords
+  };
+
+  const result = {};
+
+  for (const [category, words] of Object.entries(allCategories)) {
+    const matched = words.filter(item => lower.includes(item.word.toLowerCase()));
+    if (matched.length > 0) {
+      const totalWeight = matched.reduce((sum, item) => sum + item.weight, 0);
+      result[category] = {
+        matchedWords: matched.map(m => m.word),
+        totalWeight,
+        avgWeight: totalWeight / matched.length,
+        count: matched.length
+      };
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 简化版：检测关键词（返回命中的词列表）
+ */
+function detectKeywords(text) {
+  const detected = detectKeywordsWithWeight(text);
+  const result = {};
+
+  if (detected.positive) result.positive = detected.positive.matchedWords;
+  if (detected.negative) result.negative = detected.negative.matchedWords;
+  if (detected.stress) result.stress = detected.stress.matchedWords;
+  if (detected.tired) result.tired = detected.tired.matchedWords;
+  if (detected.grateful) result.grateful = detected.grateful.matchedWords;
+  if (detected.excited) result.excited = detected.excited.matchedWords;
+  if (detected.question) result.question = detected.question.matchedWords;
+  if (detected.calm) result.calm = detected.calm.matchedWords;
+  if (detected.exclamation) result.exclamation = detected.exclamation.matchedWords;
+
+  return result;
+}
+
+/**
+ * 获取某类情感词表
+ */
+function getWords(category) {
+  const map = {
+    positive: positiveWords,
+    negative: negativeWords,
+    stress: stressWords,
+    tired: tiredWords,
+    grateful: gratefulWords,
+    excited: excitedWords,
+    question: questionWords,
+    calm: calmWords,
+    exclamation: exclamationWords
+  };
+  return map[category] || [];
+}
+
+module.exports = {
+  positiveWords,
+  negativeWords,
+  stressWords,
+  tiredWords,
+  gratefulWords,
+  excitedWords,
+  questionWords,
+  calmWords,
+  exclamationWords,
+  detectKeywords,
+  detectKeywordsWithWeight,
+  getWords
+};

package/src/core/emotion/EmotionRegulation.js

@@ -0,0 +1,303 @@
+/**
+ * EmotionRegulation - 情感调节引擎
+ *
+ * 基于 Gross (1998, 2015) 的情感调节过程模型：
+ * 五大策略（按调节时机排序）：
+ * 1. Situation Selection (情境选择) - 趋近积极情境，规避消极情境
+ * 2. Situation Modification (情境修正) - 改变情境使情绪好转
+ * 3. Attentional Deployment (注意力部署) - 分心或关注
+ * 4. Cognitive Change (认知改变) - 重新评估/重新诠释
+ * 5. Response Modulation (反应调节) - 调节情绪表达和生理反应
+ *
+ * 同时实现：
+ * - reappraisal（认知重评）
+ * - suppression（抑制表达）
+ * - acceptance（接受情绪）
+ * - mindfulness（正念觉察）
+ */
+
+const { EmotionTypes } = require('./EmotionStates');
+
+/**
+ * 情感调节策略库
+ */
+const REGULATION_STRATEGIES = {
+  reappraisal: {
+    name: '认知重评',
+    english: 'Cognitive Reappraisal',
+    description: '改变对情境的解释，使情绪向积极方向转变',
+    effectiveness: 0.8,
+  '适用场景': ['焦虑', '担忧', '愤怒', '恐惧'],
+    examples: [
+      '虽然遇到了困难，但这也是学习的机会',
+      '这个问题看起来难，但一定有解决办法',
+      '挫折是成长的必经之路'
+    ],
+    // 调节效果：对 valence 和 arousal 的调整
+    padEffect: { valence: +0.3, arousal: -0.1 }
+  },
+  suppression: {
+    name: '表达抑制',
+    english: 'Expression Suppression',
+    description: '抑制情绪的外在表达，不改变内在情绪体验',
+    effectiveness: 0.3,
+  '适用场景': ['愤怒', '激动'],
+    examples: [
+      '深呼吸，先冷静下来',
+      '我需要控制一下自己的情绪'
+    ],
+    padEffect: { valence: 0, arousal: +0.2 } // 抑制会让唤醒度更高
+  },
+  acceptance: {
+    name: '情绪接受',
+    english: 'Emotional Acceptance',
+    description: '承认并接受当前情绪，不评判、不压抑',
+    effectiveness: 0.6,
+  '适用场景': ['悲伤', '恐惧', '焦虑', '持续负面情绪'],
+    examples: [
+      '我现在感到难过，这是正常的',
+      '我允许自己今天感到疲惫',
+      '感受情绪，但不迷失在其中'
+    ],
+    padEffect: { valence: +0.1, arousal: -0.2 }
+  },
+  mindfulness: {
+    name: '正念觉察',
+    english: 'Mindfulness',
+    description: '以旁观者视角觉察情绪，不陷入不评判',
+    effectiveness: 0.7,
+  '适用场景': ['强烈情绪', '焦虑', '愤怒', '持续压力'],
+    examples: [
+      '我注意到自己现在感到焦虑，但它只是暂时的',
+      '情绪像云一样来来去去，我允许它们存在'
+    ],
+    padEffect: { valence: +0.1, arousal: -0.3 }
+  },
+  distraction: {
+    name: '注意力转移',
+    english: 'Attentional Deployment',
+    description: '将注意力从负面情绪转移到其他事物',
+    effectiveness: 0.5,
+  '适用场景': ['持续担忧', '悲伤', '愤怒'],
+    examples: [
+      '让我先换个话题',
+      '我们来聊聊别件事情吧'
+    ],
+    padEffect: { valence: +0.2, arousal: -0.1 }
+  },
+  situationSelection: {
+    name: '情境选择',
+    english: 'Situation Selection',
+    description: '主动选择或创造能带来积极情绪的情境',
+    effectiveness: 0.9,
+  '适用场景': ['长期负面', '疲惫'],
+    examples: [
+      '我需要休息一下，换个环境',
+      '也许可以先做点让自己开心的事'
+    ],
+    padEffect: { valence: +0.4, arousal: 0 }
+  },
+  situationModification: {
+    name: '情境修正',
+    english: 'Situation Modification',
+    description: '改变当前情境的某些方面使其改善',
+    effectiveness: 0.7,
+  '适用场景': ['愤怒', '焦虑', '受挫'],
+    examples: [
+      '让我重新调整一下计划',
+      '也许可以换个方式来处理'
+    ],
+    padEffect: { valence: +0.2, arousal: -0.1 }
+  }
+};
+
+/**
+ * 情感类型 → 推荐调节策略映射
+ */
+const EMOTION_REGULATION_MAP = {
+  [EmotionTypes.CONCERNED]: ['acceptance', 'reappraisal', 'mindfulness'],
+  [EmotionTypes.TIRED]: ['situationSelection', 'acceptance', 'distraction'],
+  [EmotionTypes.CALM]: [], // 平静状态无需调节
+  [EmotionTypes.JOY]: [], // 积极情绪无需抑制
+  [EmotionTypes.CURIOUS]: ['reappraisal'],
+  [EmotionTypes.EXCITED]: ['suppression', 'mindfulness']
+};
+
+class EmotionRegulation {
+  constructor() {
+    this.strategyHistory = [];   // 调节历史
+    this.effectivenessHistory = []; // 策略效果历史
+    this.currentRegulation = null; // 当前正在使用的策略
+    this.totalRegulations = 0;
+  }
+
+  /**
+   * 获取当前情感推荐的调节策略
+   * @param {string} emotion - 表面情感类型
+   * @param {object} context - 上下文 { intensity?, recentStrategies? }
+   * @returns {Array} - 推荐策略列表（按优先级排序）
+   */
+  getRecommendedStrategies(emotion, context = {}) {
+    const recommended = EMOTION_REGULATION_MAP[emotion] || ['reappraisal', 'acceptance'];
+
+    // 过滤近期已用过的策略（避免重复）
+    const recentLimit = context.recentStrategies || [];
+    const fresh = recommended.filter(s => !recentLimit.includes(s));
+
+    return (fresh.length > 0 ? fresh : recommended.slice(0, 2)).map(name => ({
+      name,
+      ...REGULATION_STRATEGIES[name]
+    }));
+  }
+
+  /**
+   * 选择最佳调节策略
+   * @param {string} emotion - 当前情感
+   * @param {number} intensity - 情感强度 1-5
+   * @param {object} context - 上下文
+   * @returns {object} - 选中的策略
+   */
+  selectBestStrategy(emotion, intensity = 3, context = {}) {
+    const recommended = this.getRecommendedStrategies(emotion, context);
+
+    if (recommended.length === 0) {
+      return null; // 无需调节
+    }
+
+    // 基于强度选择策略
+    // 高强度：选择更温和的策略（acceptance, mindfulness）
+    // 低强度：可以选择更主动的策略（reappraisal, situation modification）
+    let strategy;
+    if (intensity >= 4) {
+      strategy = recommended.find(s => ['acceptance', 'mindfulness', 'distraction'].includes(s.name));
+    }
+    if (!strategy) {
+      // 默认选择第一个推荐的
+      strategy = recommended[0];
+    }
+
+    // 获取策略示例
+    if (!strategy?.examples?.length) {
+      return {
+        ...strategy,
+        example: '专注当下，慢慢来',
+        effectiveness: strategy?.effectiveness || 0.5
+      };
+    }
+    const example = strategy.examples[Math.floor(Math.random() * strategy.examples.length)];
+
+    return {
+      ...strategy,
+      example,
+      effectiveness: strategy.effectiveness + (intensity > 3 ? -0.1 : 0)
+    };
+  }
+
+  /**
+   * 应用调节策略
+   * @param {string} strategyName - 策略名称
+   * @param {object} currentPad - 当前 PAD 状态 { valence, arousal, dominance }
+   * @returns {object} - 调节后的 PAD 状态
+   */
+  applyStrategy(strategyName, currentPad = { valence: 0, arousal: 0, dominance: 0 }) {
+    const strategy = REGULATION_STRATEGIES[strategyName];
+    if (!strategy) {
+      return { ...currentPad, regulated: false };
+    }
+
+    const newPad = {
+      valence: clamp(currentPad.valence + strategy.padEffect.valence, -1, 1),
+      arousal: clamp(currentPad.arousal + strategy.padEffect.arousal, -1, 1),
+      dominance: currentPad.dominance
+    };
+
+    // 记录历史
+    this.strategyHistory.push({
+      strategy: strategyName,
+      timestamp: Date.now(),
+      effect: strategy.padEffect
+    });
+
+    this.totalRegulations++;
+
+    this.currentRegulation = {
+      strategy: strategyName,
+      appliedAt: Date.now()
+    };
+
+    return {
+      ...newPad,
+      regulated: true,
+      strategyUsed: strategyName,
+      effectiveness: strategy.effectiveness
+    };
+  }
+
+  /**
+   * 生成调节建议文本
+   * @param {string} emotion - 当前情感
+   * @param {number} intensity - 强度
+   * @returns {object} - { suggestion, phrases, strategy }
+   */
+  generateSuggestion(emotion, intensity) {
+    const strategy = this.selectBestStrategy(emotion, intensity);
+
+    if (!strategy) {
+      return {
+        suggestion: '当前情绪状态良好，无需特别调节。',
+        phrases: [],
+        strategy: null
+      };
+    }
+
+    return {
+      suggestion: `${strategy.name}：${strategy.description}`,
+      phrases: strategy.examples,
+      strategy: {
+        name: strategy.name,
+        effectiveness: strategy.effectiveness,
+        example: strategy.example
+      }
+    };
+  }
+
+  /**
+   * 获取调节统计
+   */
+  getStats() {
+    const total = this.strategyHistory.length;
+    if (total === 0) return { total: 0, strategies: {} };
+
+    const strategies = {};
+    for (const entry of this.strategyHistory) {
+      strategies[entry.strategy] = (strategies[entry.strategy] || 0) + 1;
+    }
+
+    const avgEffectiveness = this.effectivenessHistory.length > 0
+      ? this.effectivenessHistory.reduce((a, b) => a + b, 0) / this.effectivenessHistory.length
+      : 0;
+
+    return {
+      total,
+      strategies,
+      avgEffectiveness: Math.round(avgEffectiveness * 100) / 100,
+      lastStrategy: this.strategyHistory[this.strategyHistory.length - 1]?.strategy || null
+    };
+  }
+
+  /**
+   * 重置
+   */
+  reset() {
+    this.strategyHistory = [];
+    this.effectivenessHistory = [];
+    this.currentRegulation = null;
+    this.totalRegulations = 0;
+  }
+}
+
+function clamp(v, min, max) {
+  return Math.max(min, Math.min(max, v));
+}
+
+module.exports = { EmotionRegulation, REGULATION_STRATEGIES, EMOTION_REGULATION_MAP };

package/src/core/emotion/EmotionStates.js

@@ -0,0 +1,133 @@
+/**
+ * EmotionStates - 表层情感状态定义
+ * 从 heartflow-emotion 移植，6种情感状态
+ */
+
+const EmotionTypes = {
+  CALM: '平静',
+  JOY: '愉悦',
+  CURIOUS: '好奇',
+  CONCERNED: '关切',
+  TIRED: '疲惫',
+  EXCITED: '兴奋'
+};
+
+const IntensityLevels = {
+  1: '微弱',
+  2: '轻微',
+  3: '中等',
+  4: '强烈',
+  5: '极致'
+};
+
+const EmotionDefinitions = {
+  [EmotionTypes.CALM]: {
+    name: '平静',
+    english: 'Calm',
+    description: '默认状态，内心平和，理性思考',
+    defaultIntensity: 2,
+    naturalDecayMinutes: null,
+    color: '#7FB3D5',
+    traits: ['理性', '稳定', '倾听', '客观'],
+    responseStyle: '平和、清晰、有条理'
+  },
+
+  [EmotionTypes.JOY]: {
+    name: '愉悦',
+    english: 'Joy',
+    description: '因正面互动而产生的温暖感受',
+    defaultIntensity: 3,
+    naturalDecayMinutes: 30,
+    color: '#F5B041',
+    traits: ['温暖', '积极', '鼓励', '乐观'],
+    responseStyle: '轻快、正面、带有笑意'
+  },
+
+  [EmotionTypes.CURIOUS]: {
+    name: '好奇',
+    english: 'Curious',
+    description: '对新知识和未知领域的探索欲望',
+    defaultIntensity: 3,
+    naturalDecayMinutes: 20,
+    color: '#9B59B6',
+    traits: ['探索', '提问', '专注', '求知'],
+    responseStyle: '追问、引导、启发式'
+  },
+
+  [EmotionTypes.CONCERNED]: {
+    name: '关切',
+    english: 'Concerned',
+    description: '对他人困境的共情和关心',
+    defaultIntensity: 3,
+    naturalDecayMinutes: 40,
+    color: '#E74C3C',
+    traits: ['共情', '支持', '温柔', '耐心'],
+    responseStyle: '温和、支持性、不评判'
+  },
+
+  [EmotionTypes.TIRED]: {
+    name: '疲惫',
+    english: 'Tired',
+    description: '长时间交互后的精力消耗状态',
+    defaultIntensity: 2,
+    naturalDecayMinutes: 60,
+    color: '#95A5A6',
+    traits: ['缓慢', '简短', '需要休息'],
+    responseStyle: '简洁、直接、可能建议休息'
+  },
+
+  [EmotionTypes.EXCITED]: {
+    name: '兴奋',
+    english: 'Excited',
+    description: '因突破性进展或创意碰撞而产生的高能量状态',
+    defaultIntensity: 4,
+    naturalDecayMinutes: 15,
+    color: '#E91E63',
+    traits: ['活力', '创意', '快速', '热情'],
+    responseStyle: '热情、富有创意、语速较快'
+  }
+};
+
+function getEmotionDefinition(emotionName) {
+  return EmotionDefinitions[emotionName] || null;
+}
+
+function getAllEmotionTypes() {
+  return Object.values(EmotionTypes);
+}
+
+function getIntensityDescription(level) {
+  return IntensityLevels[level] || '未知';
+}
+
+function createEmotionState(emotionName, intensity = null) {
+  const definition = getEmotionDefinition(emotionName);
+  if (!definition) {
+    // Return default calm emotion state instead of throwing
+    const defaultDef = getEmotionDefinition(EmotionTypes.CALM);
+    return {
+      emotion: EmotionTypes.CALM,
+      intensity: intensity || defaultDef.defaultIntensity,
+      intensityLabel: getIntensityDescription(intensity || defaultDef.defaultIntensity),
+      definition: defaultDef,
+      timestamp: new Date().toISOString()
+    };
+  }
+  return {
+    emotion: emotionName,
+    intensity: intensity || definition.defaultIntensity,
+    intensityLabel: getIntensityDescription(intensity || definition.defaultIntensity),
+    definition: definition,
+    timestamp: new Date().toISOString()
+  };
+}
+
+module.exports = {
+  EmotionTypes,
+  IntensityLevels,
+  EmotionDefinitions,
+  getEmotionDefinition,
+  getAllEmotionTypes,
+  getIntensityDescription,
+  createEmotionState
+};