修改记录

[2026-04-02] - Phase 5: 流式输出与高级功能

修改类型: 功能新增
修改详情:
- 5A 流式输出: AgentLoop 新增 runStreaming() 方法，使用 chatModel.stream() → Flux<ChatResponse> 逐 token 实时输出到终端。流式失败自动降级到阻塞模式。重构核心循环统一阻塞/流式两种模式
- 5B 对话持久化: 新增 ConversationPersistence 类，退出 REPL 时自动保存对话到 ~/.claude-code-java/conversations/ 目录（JSON 格式）。新增 /history 命令查看历史对话
- 5C /compact AI 摘要: 增强 /compact 命令，用 AI 生成对话摘要注入上下文，替代简单清空历史。保留系统提示+AI 摘要+最后一轮对话
- 5D 多行输入: JLine 配置反斜杠续行（\），续行提示符 ...
关联需求: 2.1 核心 REPL 循环, 2.6 流式输出

修改类型: 功能新增
修改详情:
- 支持 OpenAI 和 Anthropic 双 API 提供者，通过 CLAUDE_CODE_PROVIDER 环境变量切换
- 统一环境变量: AI_API_KEY / AI_BASE_URL / AI_MODEL 两种提供者通用
- Banner 启动时显示当前 Provider、Model、API URL
- 修复 ProviderInfo 读取旧环境变量名的 bug
关联需求: 2.1 核心 REPL 循环

修改类型: 功能新增
修改详情:
- 新增 TokenTracker 真实 token 追踪（含模型定价）
- 新增 SkillLoader 技能加载（3 个目录扫描、YAML frontmatter 解析）
- 新增 GitContext Git 上下文收集（分支、状态、最近提交）
- 新增 4 个命令: /init, /status, /context, /config
- 增强 3 个命令: /cost（真实 token）, /model（可切换）, /compact（显示统计）
- SystemPromptBuilder 集成 Skills 和 Git 上下文
- AgentLoop 记录 token 使用量
关联需求: 2.4 命令系统, 2.5 上下文构建

修改类型: 功能新增
修改详情:
- 新增 5 个工具: ListFilesTool, WebFetchTool, TodoWriteTool, AgentTool, NotebookEditTool
- 修复 WebFetchTool 编译错误（replaceAll lambda → Pattern 匹配器）
- AgentTool 子 Agent 工厂通过 ToolContext 注入
关联需求: 2.2 工具系统

修改类型: 功能新增
修改详情:
- 使用 JLine 3 重写 REPL（行编辑、历史、Tab 补全）
- 新增 ClaudeCodeCompleter Tab 补全器
- 新增 /model, /compact, /cost 命令
- JLine FFM 原生终端支持（JDK 22+）
- Windows 终端 UTF-8 编码修复（PrintStream + JVM 参数 + 启动脚本）
- run.ps1 / run.bat 启动脚本
关联需求: 2.3 终端交互

修改类型: 功能新增
修改详情:
- Maven 项目结构: Spring Boot 4.1.0-M2, Spring AI 2.0.0-M4, JDK 25
- 核心 AgentLoop 显式工具调用循环（ChatModel + 手动工具循环）
- 6 个基础工具: BashTool, FileReadTool, FileWriteTool, FileEditTool, GlobTool, GrepTool
- 控制台组件: BannerPrinter, ToolStatusRenderer, ThinkingRenderer, SpinnerAnimation, MarkdownRenderer
- 命令系统: SlashCommand 接口, CommandRegistry, /help, /clear, /exit
- 修复 Spring AI 兼容性: Spring Boot 4.x 升级, ChatModel Bean 冲突, JVM 内存
关联需求: 全部章节

修改类型: 文档更新
修改详情:
- 创建 需求文档.md，完成需求分析和技术设计
- 创建 修改记录.md，记录项目变更历史
- 完成 claude-code TypeScript 源码的主线逻辑分析
- 完成 claude-code-learn Java 参考实现的架构分析
- 确定 Java 重写的技术栈：JDK 25 + Spring Boot 4.1.0-M2 + Spring AI 2.0.0-M4 + JLine 3 + Picocli
- 设计包结构和类映射关系
- 划分 6 个实现阶段
关联需求: 全部章节