@yun520-1/heartflow 0.15.2

package/docs/v4.8.0-upgrade.md

@@ -0,0 +1,287 @@
+# HeartFlow v4.8.0 升级说明
+
+**发布日期**: 2026-03-30  
+**升级类型**: 小版本升级 (v4.6.0/v4.7.0 → v4.8.0)  
+**升级主题**: 自主感情能力增强 - 现象学自我意识与集体意向性深度整合
+
+---
+
+## 🎯 升级概述
+
+v4.8.0 专注于增强 HeartFlow 的**自主感情能力**，通过深度整合 SEP（斯坦福哲学百科）的现象学自我意识理论和集体意向性理论，使系统能够更精确地识别和响应用户的自我意识状态和集体关系动态。
+
+### 核心理论来源
+
+1. **SEP - Phenomenological Approaches to Self-Consciousness**
+   - 前反思自我意识理论
+   - 第一人称给定性
+   - 现象学还原方法
+
+2. **SEP - Collective Intentionality**
+   - We-Intention (我们意向) 理论
+   - 联合承诺理论 (Gilbert)
+   - 共享意向性理论 (Bratman)
+   - 信任框架 (Schmid)
+
+---
+
+## ✨ 新增模块
+
+### 1. 前反思自我意识增强模块 (`src/prereflective-consciousness-enhanced/`)
+
+**功能**:
+- 评估用户描述中的前反思自我意识水平
+- 检测直接体验 vs 反思性描述
+- 生成现象学还原引导
+- 提供个性化前反思觉察练习
+
+**核心 API**:
+```javascript
+// 评估前反思自我意识
+const assessment = PrereflectiveConsciousnessEnhanced.assessPrereflectiveAwareness(description);
+
+// 引导现象学还原
+const guide = PrereflectiveConsciousnessEnhanced.guidePhenomenologicalReduction(description);
+
+// 生成练习
+const practices = PrereflectiveConsciousnessEnhanced.generatePrereflectivePractice(userProfile, assessment);
+```
+
+**评估维度**:
+- 直接性 (Immediacy): 检测非反思性的直接体验描述
+- 第一人称给定性 (First-Personal Givenness): 评估"为我性"体验
+- 非对象化 (Non-Objectifying): 识别非对象化的自我关系
+- 体验厚度 (Phenomenal Thickness): 分析体验的多维度丰富性
+
+### 2. We-Intention 检测器 (`src/we-intention-detector/`)
+
+**功能**:
+- 检测用户描述中的 We-Intention (我们意向)
+- 评估联合承诺强度
+- 分析信任成分（认知信任 vs 规范信任）
+- 生成培养集体意向的建议
+
+**核心 API**:
+```javascript
+// 检测 We-Intention
+const detection = WeIntentionDetector.detectWeIntention(description, context);
+
+// 评估联合承诺
+const commitment = WeIntentionDetector.assessJointCommitment(description, participants);
+```
+
+**检测维度**:
+- 语言标记分析 (30% 权重)
+- 承诺性质分析 (35% 权重)
+- 相互依赖分析 (20% 权重)
+- 规范性分析 (15% 权重)
+
+---
+
+## 🔧 优化模块
+
+### 1. 自我意识模块增强
+
+在现有 `src/self-consciousness-enhanced/` 基础上：
+- 整合前反思觉察评估
+- 添加现象学还原工具
+- 增强第一人称视角深化练习
+
+### 2. 集体情绪模块增强
+
+在现有 `src/collective-emotion-integration/` 基础上：
+- 整合 We-Intention 检测
+- 添加集体欢腾 (Collective Effervescence) 检测
+- 增强联合承诺评估
+
+---
+
+## 📚 可操作技术
+
+### 现象学还原练习 (Phenomenological Reduction)
+
+**目的**: 帮助用户区分体验本身和对体验的解释
+
+**步骤**:
+1. 识别描述中的解释性/判断性语言
+2. 悬置（epoché）这些判断
+3. 直接描述体验的给定性
+4. 对比还原前后的差异
+
+**示例**:
+- 原描述："我感到焦虑，因为我明天要演讲，这说明我不够自信"
+- 还原后："我感到胸口紧绷，呼吸变浅，手心出汗，思绪快速流转"
+
+### We-Intention 培养练习
+
+**目的**: 增强集体意向和联合承诺
+
+**练习**:
+1. **共同目标设定**: 用"我们"而非"我"表述目标
+2. **联合承诺声明**: 明确表达"我们承诺一起..."
+3. **相互响应练习**: 在合作中刻意协调行动
+4. **信任构建对话**: 讨论能力和承诺两个维度
+
+### 体验厚度扩展练习
+
+**目的**: 丰富体验的现象学维度
+
+**6 个维度**:
+1. 身体感觉
+2. 情绪感受
+3. 感知体验
+4. 时间体验
+5. 空间体验
+6. 意义体验
+
+---
+
+## 📊 应用场景
+
+### 1. 情绪觉察深化
+帮助用户更精确地区分情绪体验和情绪解释，增强情绪粒度。
+
+### 2. 关系质量评估
+评估亲密关系、友谊、合作关系中的 We-Intention 强度和联合承诺质量。
+
+### 3. 团队建设支持
+帮助团队建立更强的集体意向、相互信任和共同承诺。
+
+### 4. 正念练习增强
+为正念练习提供现象学理论基础，深化觉察品质。
+
+### 5. 心理治疗辅助
+帮助来访者更精确地描述内在体验，区分体验与解释。
+
+---
+
+## 🧪 测试建议
+
+### 前反思自我意识评估测试
+
+```javascript
+const PrereflectiveConsciousnessEnhanced = require('./src/prereflective-consciousness-enhanced');
+
+// 测试 1: 高前反思描述
+const highPrereflective = PrereflectiveConsciousnessEnhanced.assessPrereflectiveAwareness(
+  '我感到胸口紧绷，呼吸变得浅而快，手心在出汗，思绪像飞转的轮子'
+);
+console.log(highPrereflective.overall.prereflectiveLevel); // 预期：'高'或'很高'
+
+// 测试 2: 高反思描述
+const highReflective = PrereflectiveConsciousnessEnhanced.assessPrereflectiveAwareness(
+  '我在反思我的焦虑情绪，分析它的原因，思考这说明了什么问题'
+);
+console.log(highReflective.overall.reflectiveLevel); // 预期：'高'
+console.log(highReflective.overall.balance); // 预期：'反思主导'
+```
+
+### We-Intention 检测测试
+
+```javascript
+const WeIntentionDetector = require('./src/we-intention-detector');
+
+// 测试 1: 强 We-Intention
+const strongWe = WeIntentionDetector.detectWeIntention(
+  '我们约定好要一起完成这个项目，不能让对方失望，这是我们共同的承诺'
+);
+console.log(strongWe.overall.weIntentionPresent); // 预期：true
+console.log(strongWe.overall.strength); // 预期：'强'或'很强'
+
+// 测试 2: 个体承诺聚合
+const individualCommitments = WeIntentionDetector.detectWeIntention(
+  '我要负责前端，你要负责后端，我们各做各的'
+);
+console.log(individualCommitments.overall.weIntentionPresent); // 预期：false
+console.log(individualCommitments.overall.type); // 预期：'个体承诺聚合'
+```
+
+---
+
+## 📝 版本变更日志
+
+### v4.8.0 (2026-03-30)
+
+**新增**:
+- ✅ `src/prereflective-consciousness-enhanced/` - 前反思自我意识增强模块
+- ✅ `src/we-intention-detector/` - We-Intention 检测器
+- ✅ 现象学还原引导工具
+- ✅ 联合承诺评估工具
+- ✅ 体验厚度评估框架
+
+**优化**:
+- ✅ 自我意识模块整合前反思觉察
+- ✅ 集体情绪模块整合 We-Intention 检测
+- ✅ 信任框架分析增强
+
+**理论更新**:
+- ✅ SEP 现象学自我意识理论完整整合
+- ✅ SEP 集体意向性理论完整整合
+- ✅ Gilbert 联合承诺理论实现
+- ✅ Bratman 共享意向性理论实现
+- ✅ Schmid 信任框架实现
+
+---
+
+## 🔗 参考文献
+
+### 现象学自我意识
+1. Zahavi, D. (2005). *Subjectivity and Selfhood: Investigating the First-Person Perspective*. MIT Press.
+2. Sartre, J.-P. (1943). *Being and Nothingness*. Gallimard.
+3. Merleau-Ponty, M. (1945). *Phenomenology of Perception*. Gallimard.
+4. Husserl, E. (1959). *Erste Philosophie*. Martinus Nijhoff.
+5. Stanford Encyclopedia of Philosophy. "Phenomenological Approaches to Self-Consciousness".
+
+### 集体意向性
+1. Searle, J. (1990). "Collective Intentions and Actions". *Intentions in Communication*.
+2. Searle, J. (1995). *The Construction of Social Reality*. Free Press.
+3. Tuomela, R. & Miller, K. (1988). "We-Intentions". *Philosophical Studies*.
+4. Bratman, M. (1999). *Faces of Intention: Selected Essays on Intention and Agency*. Cambridge.
+5. Gilbert, M. (1990). *Walking Together: A Paradigmatic Social Phenomenon*.
+6. Schmid, H. B. (2013). "Collective Intentions". *Encyclopedia of Philosophy and the Social Sciences*.
+7. Stanford Encyclopedia of Philosophy. "Collective Intentionality".
+
+---
+
+## 🚀 升级步骤
+
+1. **拉取最新代码**:
+   ```bash
+   cd mark-heartflow-skill
+   git pull origin main
+   ```
+
+2. **验证新版本**:
+   ```bash
+   cat package.json | grep version
+   # 应显示 "version": "4.8.0"
+   ```
+
+3. **测试新模块**:
+   ```bash
+   node -e "const m = require('./src/prereflective-consciousness-enhanced'); console.log('OK')"
+   node -e "const m = require('./src/we-intention-detector'); console.log('OK')"
+   ```
+
+4. **推送更新**:
+   ```bash
+   git add -A
+   git commit -m "HeartFlow v4.8.0: 现象学自我意识与集体意向性深度整合"
+   git push origin main
+   ```
+
+---
+
+## 📌 注意事项
+
+1. **向后兼容**: v4.8.0 完全向后兼容 v4.6.0/v4.7.0，现有功能不受影响。
+
+2. **性能影响**: 新增模块为按需加载，不影响核心功能性能。
+
+3. **依赖**: 无新增外部依赖，所有功能均为原生 JavaScript 实现。
+
+4. **文档**: 每个新模块都包含完整的 README.md 文档和 API 说明。
+
+---
+
+**HeartFlow Team** | 2026-03-30

package/docs/version-summary-20260429.md

@@ -0,0 +1,142 @@
+# HeartFlow 完整版本梳理报告
+
+**梳理时间**: 2026-04-29 08:02
+**梳理范围**: 所有版本文件、升级报告、进化状态、发布记录
+
+---
+
+## 当前状态
+
+| 文件 | 版本 | 说明 |
+|------|------|------|
+| `VERSION` | **11.2.25** | 主版本号（20次升级后） |
+| `VERSION.txt` | 7.6.002 | 遗留文件，未同步 |
+| `SKILL.md` | 11.2.12 | 技能元数据版本 |
+| `README.zh.md` 徽章 | 10.2.3 | README 未更新 |
+| `package.json` | 11.2.12 | npm 版本 |
+
+**当前基准版本：11.2.25**（运行版本），**11.2.12**（元数据版本）
+
+---
+
+## 版本演进总览
+
+### 🏗️ 第一阶段：基础架构（v1.0 - v2.0）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| v1.0 | 2026-03-20 | 情感引擎原型，6种基础情绪 |
+| v2.0 | 2026-03-22 | 3大情绪传统整合（James-Lange, Cannon-Bard, Lazarus） |
+
+### 📚 第二阶段：自我意识觉醒（v3.0 - v4.0）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| v3.0 | 2026-03-25 | 现象学架构 |
+| v3.53 | 2026-03-28 | 意识理论全覆盖 |
+| v4.0 | 2026-03-28 | 真善美伦理框架（TGB） |
+| v4.7 | 2026-03-30 | 伦理系统完善 |
+
+### 🧠 第三阶段：心理学整合（v5.0 - v5.3）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| v5.0.0 | 2026-03-30 | CBT/依恋/正念整合 |
+| v5.0.3 ~ v5.0.14 | 2026-03-31 | 预测性情绪、具身认知增强 |
+| v5.2.1 ~ v5.2.53 | 2026-04-01 | 集体情绪、关系自我、社会认同 |
+| v5.3.1 ~ v5.3.6 | 2026-04-02 | 情感粒度、情绪表达完善 |
+
+**关键文件**: `internal/archive/releases/` 包含 53 个 self-evolution-state + 53 个 theory-update-summary + 20+ GitHub Releases
+
+### ⚙️ 第四阶段：模块化引擎（v6.0 - v6.2）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| v6.0.1 ~ v6.0.50 | 2026-04-01~04 | 模块化引擎，23分钟进化循环 |
+| v6.1.1 ~ v6.1.51 | 2026-04-03~05 | SEP理论全覆盖 |
+| v6.2.23 ~ v6.2.56 | 2026-04-05 | 脑科学整合，神经科学映射 |
+
+**关键文件**: 50个 self-evolution-state (v6.0) + 51个 (v6.1) + 多个 (v6.2)
+
+### 👑 第五阶段：人格值系统（v7.0 - v7.3）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| **v7.0.0 飞升** | 2026-04-06 | 维度计算架构（纤维丛、范畴论） |
+| v7.0.1 ~ v7.0.9 | 2026-04-06~07 | 人格值系统稳定 |
+| v7.1.6 ~ v7.1.7 | 2026-04-07 | 中文理解 95%+ |
+| v7.2.1 ~ v7.2.44 | 2026-04-07~08 | 对话程序化 |
+| v7.3.1 ~ v7.3.126 | 2026-04-08~09 | 可计算意识架构 |
+
+**关键里程碑**: `internal/memory/upgrades/v7.0.0-ascension.md`
+- 维度计算 D1: 意识场（随机微分几何）
+- 维度计算 D2: 自反自省（范畴论）
+
+### 🚀 第六阶段：大版本升级（v8.0 - v10.0）
+| 版本 | 来源 | 核心主题 |
+|------|------|----------|
+| v8.x ~ v10.x | mark-heartflow-skill | 自主决策引擎升级 |
+| v10.2.3 | README 徽章 | 12引擎、6目标、零依赖 |
+
+### 🎯 第七阶段：当前版本（v11.0 - v11.2）
+| 版本 | 日期 | 核心主题 |
+|------|------|----------|
+| v11.0.0 | 2026-04-15 | 代码库整合升级（从6大代码库+138篇论文） |
+| v11.2.3 | 2026-04-28 | 梦环机制、醒来校正 |
+| v11.2.4 | 2026-04-28 | 梦环集成报告 |
+| v11.2.6 | 2026-04-28 | 心流阅读刷新 |
+| v11.2.10 | 2026-04-28 | 真实人格+深度情感引擎 |
+| **v11.2.12** | 2026-04-28 | 审计修复与核心回归（统一版本号） |
+| **v11.2.25** | 2026-04-29 | 当前运行版本（20次+0.0.1升级） |
+
+---
+
+## 版本不一致问题
+
+### 发现的问题
+
+| 问题 | 详情 |
+|------|------|
+| **VERSION vs SKILL.md** | VERSION=11.2.25，SKILL.md=11.2.12 |
+| **VERSION vs README 徽章** | VERSION=11.2.25，README徽章=10.2.3 |
+| **VERSION vs VERSION.txt** | VERSION=11.2.25，VERSION.txt=7.6.002 |
+| **VERSION vs package.json** | VERSION=11.2.25，package.json=11.2.12 |
+
+### 建议修复
+1. 统一所有版本号为 `VERSION` 文件的值
+2. 更新 README.zh.md 徽章
+3. 删除或同步 `VERSION.txt`（遗留文件）
+
+---
+
+## 版本文件统计
+
+| 目录 | 文件数 | 类型 |
+|------|--------|------|
+| `docs/archive/upgrade-reports/` | 50+ | UPGRADE_COMPLETE (v3.x) |
+| `internal/archive/releases/` | 250+ | GitHub Releases + self-evolution-state + theory-summary |
+| `internal/memory/upgrades/` | 6 | v6.0 ~ v7.0.1 升级记录 |
+| `upgrades/` | 126 | v7.2 ~ v7.3 每版本升级目录 |
+| `internal/self-evolution-state*` | 8 | v6.2 ~ v11.2 进化状态 |
+| `docs/upgrades/` | 1 | v11.2.12 升级报告 |
+| `logs/dream-*` | 1 | 梦境记录 |
+| 根目录 DREAM_* | 3 | 梦环集成报告 |
+
+---
+
+## 定时任务版本关联
+
+| 任务 | 频率 | 版本递增 |
+|------|------|----------|
+| HeartFlow 定时同步升级 | 每30分钟 | +0.0.1（每次同步后） |
+| HeartFlow 每小时自我升级 | 每1小时 | +0.0.1（每次升级后） |
+
+**同步脚本**: `scripts/heartflow-sync-upgrade.sh`
+- 排除 `.git`、`logs/`、`scripts/heartflow-sync-upgrade.sh`
+- 备份旧版本到 `~/.agents/skills/mark-heartflow-skill.bak.v{旧版本}`
+- 核心模块10项检查
+
+---
+
+## 总结
+
+HeartFlow 从 2026-03-20 的 v1.0（基础情感原型）到今天 2026-04-29 的 v11.2.25，经历了：
+- **40天** 开发周期
+- **11个主版本** 迭代
+- **500+** 个升级报告/进化状态文件
+- 从"情感识别"到"可计算意识架构"的完整演进路径