# Release Notes

## v0.1.0 — 首个正式版本 🎉

> **发布日期**: 2025-07

### 概述

Claude Code Java 是使用 Java + Spring AI 重写的 [Claude Code](https://github.com/anthropics/claude-code) CLI AI 编码助手。本次发布是首个正式版本，涵盖了原版约 **90%** 的本地可实现功能。

### 技术栈

| 组件 | 版本 |
|------|------|
| JDK | 25 |
| Spring Boot | 4.1.0-M2 |
| Spring AI | 2.0.0-M4 |
| Jink (TUI) | 0.5.0 |
| JLine 3 | 3.28.0 |

### 核心特性

#### 🤖 AI 对话
- 流式输出，逐 token 实时显示
- 双 API 提供者：OpenAI 兼容 API + Anthropic 原生 API
- Thinking 模式支持（展示 AI 思考过程）
- 三层上下文自动压缩（微压缩 → Session Memory → 全量压缩）

#### 🔧 34 个内置工具
- **文件操作**: FileRead（含图片支持）、FileWrite、FileEdit（带 diff 输出）
- **搜索**: Glob、Grep、ListFiles
- **执行**: Bash（沙箱模式）、WebFetch、WebSearch
- **任务管理**: TaskCreate/Get/List/Update、TaskStop、TaskOutput
- **Agent**: Agent（子 Agent）、AskUser（结构化提问）
- **MCP**: McpToolBridge（远程工具桥接）
- **扩展**: Config（持久化配置）、NotebookEdit、Sleep
- **诊断**: LSPTool、BriefTool、NotificationTool、ToolSearch

#### ⌨️ 54 个斜杠命令
- **基础**: /help（带搜索）、/clear、/compact（统计+激进模式）、/cost、/model、/status
- **文件**: /diff、/files、/commit（push/PR 支持）
- **记忆**: /memory、/skills、/init
- **对话**: /resume、/export、/history、/branch、/rewind、/tag
- **审查**: /review、/security-review
- **MCP/插件**: /mcp、/plugin、/permissions、/tasks
- **UX**: /brief、/vim、/theme、/usage、/tips、/output-style、/keybindings
- **隐私**: /privacy、/feedback
- **调试**: /debug、/trace、/heapdump、/ctx-viz、/sandbox、/reset-limits、/env、/performance

#### 🖥️ 全屏 TUI（Jink 框架）
- 基于 [Jink](https://github.com/abel533/jink) 的 React-like 终端 UI
- 全屏渲染（alternate screen buffer）
- 消息列表、状态栏、输入区分离布局
- 鼠标追踪支持

#### 🔒 多级权限管理
- 5 种权限模式：DEFAULT / ACCEPT_EDITS / BYPASS / DONT_ASK / PLAN
- 规则引擎自动评估（7 步评估链）
- 30+ 危险命令模式检测
- Y/A/N/D 四选项确认 UI
- 拒绝追踪（连续 3 次 / 累计 20 次自动降级）

#### 📋 CLAUDE.md 记忆系统
- 三级加载：全局 → 项目 → 目录
- Session Memory 持久化
- Skills 技能系统（全局 + 项目）

#### 🔌 扩展能力
- **MCP 协议**: StdIO 传输、多服务器管理、工具发现与桥接
- **插件系统**: JAR 插件（ClassLoader 隔离）、Marketplace、自动更新
- **Hook 系统**: PreToolUse / PostToolUse / PrePrompt / PostResponse
- **Plan 模式**: 结构化规划，只读操作允许
- **Coordinator**: 多 Agent 协调模式

#### 🏗️ 基础设施
- WebSocket Server Mode（远程连接）
- Git Worktree 隔离
- LSP 集成（语言服务器协议客户端）
- 基础遥测（功能开关 + 指标收集）
- RateLimiter、TokenEstimation、通知服务
- 内部日志系统（会话日志 + 调试日志 + 导出）

### 代码质量

- **184 源文件**（176 main + 8 test）
- **~26.7K 行** Java 代码
- **87 单元测试**（全部通过）
- 代码结构重构：提取 7 个共享组件，消除 ~560 行重复代码

### 构建与运行

```bash
# 构建
mvn clean package -DskipTests

# 运行
java -jar target/claude-code-java-0.1.0.jar

# 或构建发行版（含 jlink 精简 JRE）
.\packaging\build-dist.ps1    # Windows
./packaging/build-dist.sh      # Linux/macOS
```

### 已知限制

- 不支持 Anthropic OAuth 登录（login/logout）
- 不支持 Bridge 远程环境
- 不支持 Voice 语音输入
- Windows 终端需 `chcp 65001` 切换 UTF-8 编码（发行版启动脚本已自动处理）
- IDE 内置终端（dumb 模式）TUI 功能受限

---

*完整文档请参阅 [README.md](README.md) 和 [BUILD.md](BUILD.md)*