# Aether

**Repository Path**: zhou-yang12138/aether

## Basic Information

- **Project Name**: Aether
- **Description**: Aether 是一个用于学习和练习的手搓 Java Agent Framework，兼容 OpenAI API 格式。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: 2026-06-03-prototype
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: ai

**Tags**: None

## README

# Aether

Aether 是一个用于学习和练习的手搓 Java Agent Framework，兼容 OpenAI API 格式。

本工程重点是理解 Agent、LLM Client、Tool、Harness、事件流和运行时治理等机制，而不是追求最快生成代码。

## 技术栈

- Java 17
- Jackson (JSON)
- SLF4J + Logback
- JUnit 5

## 构建

```bash
mvn compile
```

## 项目结构

```text
com.aether/
├── core/      # 核心模型，如 Message、Tool 定义等
├── client/    # LLM Client / OpenAI-compatible API 适配
├── agent/     # Agent Loop
├── tools/     # 工具系统
└── harness/   # Harness 编排层
```

## 设计原则

- Java 17，轻依赖。
- 不优先引入 Spring、LangChain、OpenAI SDK 等大型框架。
- 优先手写端口、适配器、状态机、工具治理和 Harness Runtime。
- `core` 只放稳定领域模型，不放具体执行逻辑。
- `agent` 负责 LLM 与 Tool 的闭环，不直接执行工具或管理运行时治理。
- `tools` 负责工具注册、校验和执行。
- `harness` 后续负责 trace、审批、回放、取消、限额等运行时能力。

## 协作约定

本工程以学习为主，开发者本人负责亲手实现代码。

AI / Agent 默认只提供：

- 方案和建议
- 设计评审
- 边界分析
- 实现顺序
- 风险提示
- 代码审阅

除非开发者明确要求“直接修改代码 / 帮我实现 / 写文件”，否则不要直接编写、修改或生成 Java 业务代码。

当开发者询问“怎么写 / 从哪里开始 / 这个模块怎么设计 / 下一步做什么”时，优先输出：

1. 推荐实现顺序
2. 模块职责边界
3. 关键接口草图或伪代码
4. 容易踩坑的点
5. 自查清单

## 修改约束

需要明确确认后才能修改：

- `src/main/java/**`
- `src/test/java/**`
- `pom.xml`
- 会影响工程行为的配置文件

可以直接修改：

- 设计文档
- 架构图 / PlantUML 图
- README 等说明性文档

## 验证约定

不要自动运行测试、编译、集成验证或外部调用。

如果需要验证，先说明建议运行的命令和验证目的，等待开发者确认。