agent-aide/CHANGELOG.md

CHANGELOG

本文件记录 Aide 项目对使用者可见的重要变更。

2025-12-17

修复

aide flow 分支切换问题修复

• 修复 finish 阶段分支切换时 lock 文件冲突的问题
• 修复 finish 阶段状态文件未提交导致切换失败的问题
• 在 BranchManager 添加 _cleanup_lock_file 方法
• 调整 FlowTracker 中分支合并的执行顺序（先提交再合并）
• 修复 _merge_normal 方法使用错误的 reset_soft 逻辑，改用 merge_squash
• 在分支合并前额外提交状态文件（解决 git_commit hash 更新后未提交的问题）
• 修复 finish 后工作目录不干净的问题：在 record_branch_finish 后添加收尾提交
• 修复 git add_all 改用 -A 参数，确保删除的文件也被正确暂存

新增功能

环境安装 Commands

• 新增 /aide:install-win - Windows 环境安装命令
• 新增 /aide:install-linux - Linux 环境安装命令
• 支持两种安装模式：自动安装（报告→确认→执行）和手动指南（markdown + 脚本）
• 自动检测并安装 uv、Python（via uv）、Java JRE
• 包含 aide PATH 配置指导

离线安装程序

• 新增 aide-program/offline-installer/windows/ - Windows 离线安装程序
• 新增 aide-program/offline-installer/linux/ - Linux 离线安装程序
• 提供资源清单（resources.json）、安装脚本和使用说明
• 支持在无网络环境下安装 aide 所需的环境依赖

aide flow 自动 Git 分支管理

• 任务开始时自动创建 aide/NNN 分支（三位递增编号）
• 任务结束时自动合并并压缩提交
• 分支概况文档（JSON + MD 双格式）
• 安全合并策略（检测源分支变更，必要时创建临时分支）
• 新增 BranchManager 类管理分支编号和概况
• 扩展 GitIntegration 类支持分支操作

变更

command/run 流程更新

• 智能续接判断逻辑：检查任务细则文档，判断是否符合当前任务
• 待定项处理强制执行
• 任务细则生成后强制确认（使用 AskUserQuestion）

优化

/aide:docs 命令强化完整性覆盖

• 新增"完整覆盖"规则：根目录下每个非忽略的子目录都必须归入某个区块
• 新增强制完整性检查步骤：区块划分后必须验证所有顶层目录都已覆盖
• 新增非代码区块示例：展示如何处理 docs/、discuss/、assets/ 等目录
• 更新目录树生成规则：明确要求包含所有顶层目录（包括非代码目录）
• 更新完成检查清单：新增目录完整性最终检查项
• 修复了之前执行 /aide:docs 时遗漏 docs/、discuss/ 等非代码目录的问题

/aide:docs 命令增强（早期更新）

• 新增"完全深度探索"核心原则：不考虑效率，对每个文件/目录完全覆盖
• 新增完整目录树结构展示（类似 tree 命令输出）
• 支持混合模式：总导览使用简化版（前两层），区块文档使用完整 tree
• 新增空目录处理：记录并标注 [空目录]
• 新增被忽略文件处理：标注 [ignored]
• 新增二进制文件处理：根据上下文推断概括
• 新增文件类型列和统计信息
• 移除"单个区块不超过 5000 行代码"的限制

文档更新 (docs 阶段)

• 更新 commands/docs.md 命令定义
• 更新 aide-plugin-commands.md 区块文档
• 更新 CHANGELOG.md 记录变更详情

---

2025-12-16

新增功能

新增 task-parser skill

• 口语化任务内容解析器
• 支持语义解析、批判性分析、建设性建议
• 自动识别口语化特征并进行规范化转换

流程图规范强化

• 明确区分两种流程图类型：
  • 任务执行流程图（所有任务必需）
  • 程序逻辑流图（程序类任务必需）
• 程序逻辑流图规范：从入口函数开始，支持模块化和层次化表示

优化

aide flow git 提交顺序调整

• 状态文件先保存再执行 git 操作
• 确保 flow-status.json 的更新包含在 commit 中

文档

• 更新项目导览和区块文档
• 新增 task-parser skill 说明

---

2025-12-15 (v2.0.3)

文档

• 重写 README.md，提供面向用户的快速上手指南
• 原 README.md 移至 docs/project-details.md 作为项目详细说明

2025-12-15 (v2.0.0)

新增功能

Commands 重组

• 新增 /aide:setup - 独立的环境配置命令
• 新增 /aide:load - 项目文档按需载入命令
• 新增 /aide:docs - 项目文档创建和维护命令
• 新增 /aide:run - 整合任务准备和执行的核心命令（替代原 prep + exec）

aide flow 增强

• 新增 aide flow status - 查看当前任务状态
• 新增 aide flow list - 列出所有任务（当前 + 归档）
• 新增 aide flow show <task_id> - 查看指定任务的详细状态历史

配置系统增强

• 配置文件完全自文档化（所有配置项含详细注释说明）
• 新增 [general] 节：gitignore_aide 配置是否忽略 .aide 目录
• 新增 [docs] 节：项目文档路径配置
• 新增 [flow] 节：diagram_path 流程图目录配置
• 新增 [plantuml] 节：PlantUML jar 路径配置

PlantUML 集成

• 内置 plantuml.jar，支持本地流程图校验和构建
• flow-design 阶段自动校验 PlantUML 语法
• 进入 impl 阶段时自动生成 PNG 图片

项目文档体系

• 设计面向 LLM 的区块化文档结构
• 支持总导览 + 多子区块的文档组织
• 支持增量更新和多对话续接

任务分析增强

• 制定任务复杂度评估指导原则
• 支持复杂任务拆分为多个子计划
• 子计划循环执行机制

变更

• 原 /aide:init 重命名为 /aide:setup
• 原 /aide:prep 和 /aide:exec 合并为 /aide:run
• 旧命令文件保留为 _deprecated_*.md 供参考

2025-12-14

• 实现 aide flow（进度追踪 + Git 自动提交 + 流程校验 + Hooks）
• 补充 aide flow 详细设计文档与导航链路