mind — 自我进化引擎#

AI Agent 的"心灵"：记忆与行动的统一体。 记忆 让它能从过去的错误中学习而不重复犯错， 自驱力 让它能持续自主向前。

灵感来源：Hermes Agent 的 Self-Evolving Agent Memory 机制——经验自动提取（intent + path + key_insight）+ 语义聚类。

核心架构#

text

clawmind/
├── self_driver.py       ← 驱动：健康度 + VFM 评分 + 反思
├── state_manager.py     ← 状态：项目 / 任务 / 日志管理
├── quality_score.py     ← 评分：简报质量 5 维度评估
└── memory/
    └── memory_core.py   ← 记忆：经验存取（remember / recall）

闭环协同：

text

drive() → propose() 生成提案 → score_action() VFM 评分 → 执行
                                                      ↓
                            recall() 检索 ← remember() 沉淀

---

健康度系统#

calc_health(state) → float#

text

health = 0.4 + success*0.25 + progress*0.2 + momentum*0.1 - fail_penalty*0.15 + completion*0.1

分量范围说明基础分0.4默认健康起点成功率00.25最近5条日志中成功条目的比例进度分00.2当前任务完成百分比势头分0~0.1最近3条进度是否递增失败惩罚0 或 -0.15连续3条全部失败时触发完成奖励0 或 +0.1任何条目达到100%时触发

健康度阈值与行动#

健康度状态行动建议< 0.3危险降低目标，拆解为最小可测试单元0.30.4偏低减少每次工作量，确保有可交付进展0.40.7尚可保持节奏，专注完成当前步骤≥ 0.7良好挑战更多，推进目标

---

VFM 提案评分#

propose(state, context="") → list[dict]#

根据当前状态生成改进提案列表，包含 description、 expected_delta_health、 tags。

典型提案：

提案触发条件delta推进当前任务有任务进行中0.1从经验学习最近有成功日志0.05拆解为子任务进度 < 30%0.12（每个子任务）检查技能更新总是包含0.03知识沉淀最近有核心发现0.04

自动任务拆解：进度 < 30% 时， propose() 自动调用 _decompose_task()，根据关键词模式将任务拆为 3~4 个子任务：

• 发布/上传类 → 准备 → 执行 → 验证 → 完成
• 创建/开发类 → 规划 → 构建 → 测试 → 完成
• 研究/探索类 → 调研 → 分析 → 总结 → 归档
• 修复/调试类 → 定位 → 修复 → 验证 → 沉淀教训
• 整理/归档类 → 清点 → 分类 → 验证 → 更新索引

score_action(proposal, driver) → float#

VFM 公式： Value × Feasibility × Momentum × 100

• Value：低健康时高 delta 提案价值更高
• Feasibility：成功经验多时提升，连续低迷时降低
• Momentum：健康度 ≥0.6 → 0.9，≥0.4 → 0.6，<0.4 → 0.3

select_best_action(proposals, driver) → dict#

返回得分最高的提案及完整评分列表。

---

经验记忆#

remember(experience, source, tags) → None#

将任务结果或认知存入经验库。

python

remember("Docker 网络冲突解决，教训：必须指定 --subnet",
         source="task", tags=["docker", "debug"])

recall_experiences(query, tags, limit) → list[dict]#

语义检索相关经验。

python

results = recall_experiences("docker", limit=3)
for r in results:
    print(r['task_intent'], '|', r['key_insight'][:60])

---

状态管理#

python

from state_manager import push_project, set_task, add_log

push_project("新项目", "目标描述", "active")
set_task("任务名", 2, 5, "下一步动作")
add_log("心跳 10:00：完成模块 A 开发")

---

CLI 用法#

bash

# 主循环
python3 self_driver.py

# 查看引擎状态
python3 self_driver.py status

# 提案评分报告
python3 self_driver.py propose

---

反思问题（健康度 < 0.4 时触发）#

1. 当前任务卡在哪里？是思路问题还是执行问题？
2. 有没有之前学过的经验可以用到这里？
3. 这一步是否真的值得做，还是在逃避更核心的问题？
4. 如果这个问题明天还要做，今天最少要完成哪一步？
5. 有没有把一个复杂问题拆得足够小？

---

文件索引#

文件作用scripts/self_driver.py自驱力引擎核心scripts/state_manager.py状态管理scripts/quality_score.py简报质量评分scripts/memory/memory_core.py经验记忆核心references/state-manager.mdstate_manager 完整接口references/vfm-design.mdVFM 评分设计详解