本文件记录 ConvergeLoop 的版本演进。遵循 Keep a Changelog 规范，版本号遵循 语义化版本。
- 人工介入管理器（
human_intervention.py）：三类介入点——检查点介入（第 5/10/15 轮）、风险确认介入（L-Hint 级修复）、异常介入（顽固问题/成熟度下降） - 会话持久化与断点续传（
session_store.py）：检查点持久化 + 会话恢复，支持中途断电/断网后从检查点继续 - MCP Tool
convergeloop_resume：从断点恢复修复会话 - MCP Tool
convergeloop_human_decision：对人工介入请求做出决策（approve/reject/modify/skip/continue/pause/adjust/terminate/retry/manual） - CLI
session list/show/delete：会话管理命令集 - CLI
resume：从断点恢复修复会话
config_consistency.py：修复后自动检测环境变量一致性、依赖一致性、配置文件引用、Docker 环境一致性、API 端点一致性- 自动补充缺失的
.env.example变量和缺失依赖
file_lock.py：文件哈希 + 写入锁 + 冲突检测，用户修改优先于 ConvergeLoop 自动修复- 协作模式下通过 MCP 预告即将修改的文件
business_intent.md模板：产品经理角色基于业务意图做功能完整性审计project_sense.py业务意图探测：通过 README、路由定义、数据库模型等信号推断项目业务意图- 支持
.convergeloop/intent.md用户自定义业务意图 - MCP Tool
convergeloop_generate_prompt支持prompt_type=business_intent
config/engines.json：AI 引擎配置文件（DeepSeek/GLM/OpenAI/Claude/Ollama），供参考和手动配置- 环境变量驱动的引擎发现（无需配置文件即可运行）
.env.example：环境变量配置模板，包含所有 AI 引擎 API Key、本地模型、CI/CD 集成配置
- 版本号统一：pyproject.toml（1.0.0→1.2.0）、
__init__.py（1.1.0→1.2.0）、convergeloop.json（1.1.0→1.2.0）、config/__init__.py（1.1.0→1.2.0）、server.py（1.1.0/1.0.0→1.2.0）全部统一到 1.2.0 - pyproject.toml 依赖补齐：
docker>=7.0.0、tree-sitter系列、sentence-transformers从可选依赖提升为主依赖（对齐规划文档 5.2 节） - README.md 数量修正：提示语模板 7→8（含业务意图问）、MCP tools 7→9（含 resume 和 human_decision）
- README.md 新增人工介入、会话持久化、配置一致性验证、并发编辑保护等特性描述
- MCP_SETUP.md 新增
convergeloop_resume和convergeloop_human_decision工具文档 - pyproject.toml 精简可选依赖（ast/embedding 可选项已提升为主依赖）
- 执行引擎层：Docker 安全沙箱（
sandbox_manager.py）+ 9 种语言/框架构建适配器（build_adapter.py） - 项目感知层：零配置识别项目类型、框架、架构、构建系统、技术栈、风险域（
project_sense.py） - 提示语引擎层：7 种对抗性提示语模板（正问/负问/交叉问/红队问/裁判问/测试问/文档问）+ 自适应学习（
prompt_forge.py） - 角色矩阵层：17 个红队角色 + 8 类蓝队工程师路由（
role_matrix.py+roles.json） - 红蓝对抗层：多角色并行审计 + 突袭验证 + 魔鬼代言人机制
- 收敛裁决层：6 硬性指标 + 7 条防欺骗铁律 + 止损机制（
convergence_judge.py） - 商业就绪裁决层：8 维度成熟度评分（
maturity_scorer.py+maturity_dimensions.json）
- L1-L8 分层分析对应 G1-G6 质量门控
- G3 安全检查覆盖 SQL 注入、命令注入、路径穿越等 10+ 漏洞模式
- G5 性能检查覆盖 N+1 查询、内存泄漏、死锁检测
- 全部基于真实编译/测试执行结果，不信任 AI 自报结果
- 5 种修复类型（精确替换 / 函数重写 / 插入代码 / 文件级 / 新建文件）
- AST 语义定位 + 模糊匹配 + 原子写入（不依赖行号）
- 修复冲突管理：文件级锁 + 优先级排序 + 原子批处理（
fix_scheduler.py）
- 5 级升级策略：重试 → 注入上下文 → 升级模型 → 提示修复 → 顽固问题
- 失败知识库持久化（
error_learner.py）
- 5 个 AI 引擎适配器：OpenAI / Claude / DeepSeek / GLM / Ollama
- 模型分级（简单/复杂/验证任务路由不同模型）+ 熔断机制（
budget_controller.py）
- 新增：
SessionStore模块，会话状态每轮自动持久化到~/.convergeloop/sessions/ - 新增：CLI
resume命令，恢复已保存的会话继续修复 - 新增：CLI
report命令，查看会话报告（支持内存/磁盘加载） - 新增：CLI
export命令，导出报告为 Markdown / HTML / JSON 格式
- 大型项目分片-聚合-迭代处理（
chunk_engine.py，<8000 tokens/片） - Git diff 增量分析（
incremental_analyzer.py） - 依赖图构建（
dependency_graph.py）
- 基于 FastMCP 实现 7 个 MCP tools
- IDE 自动检测与安装（Trae/Cursor/CatPawAI/VSCode/Claude/Windsurf 等 8 个 IDE）
- FastAPI + slowapi 限流的 7 个 API 端点
- 新增：Web Dashboard 挂载到
/和/dashboard路由（无需单独启动） - 7 端点：analyze / sessions / report / pause / resume / rollback / delete
- 基础：
fix/analyze/generate-prompts/test/score - 会话：
sessions/resume/report/export - 配置：
config show/set/reset（reset 支持备份恢复 + 智能类型转换） - IDE：
install/uninstall - 服务：
server（含 Dashboard 提示）
- server.py：移除
from __future__ import annotations，修复 FastAPI 无法解析函数内定义的AnalyzeRequest注解的前向引用问题 - server.py：为 slowapi 限流端点（
start_analysis/get_session_status/get_session_report）添加request: Request参数，修复No "request" argument错误 - config reset：从"待实现"补齐为完整实现，支持备份当前配置 + 从默认配置/备份恢复
ProjectProfile新增build_system字段，ProjectSense._detect_build_system()自动检测 9 种构建系统AdversarialLoop._round_1_sense()感知后将build_system应用到BuildAdapter（实现规划 14.1 节"项目感知引擎自动检测构建系统，适配器统一封装执行接口"）- 版本号从
1.0.0统一升级到1.1.0（__init__.py/convergeloop.json/ server.py）
- 七层对抗性架构骨架
- 核心 CLI 命令（fix / analyze / score / test）
- 5 个 AI 引擎适配器
- 17 红队 + 8 蓝队角色矩阵
- 7 种对抗性提示语模板
- 8 维度成熟度评分
- MCP Server + REST API 基础
- IDE 检测与安装
- MIT License
- 主版本号（X.0.0）：不兼容的 API 修改
- 次版本号（1.X.0）：向下兼容的功能新增
- 修订号（1.1.X）：向下兼容的问题修复