|
|
# 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)*
|
|
|
|
