Metadata-Version: 2.4
Name: yaping-aether
Version: 0.9.0
Summary: 1+N 多模态 Agent 框架 — 面向国产大模型的开源 AI 助手
Project-URL: Homepage, https://github.com/AQ-july/aether
Project-URL: Repository, https://github.com/AQ-july/aether.git
Project-URL: Issues, https://github.com/AQ-july/aether/issues
Author: Aether Contributors
License: Apache-2.0
License-File: LICENSE
Keywords: agent,ai-assistant,chinese-llm,cli,llm,multi-agent,smolagents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: litellm>=1.60.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: smolagents>=1.20.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🌌 Aether v0.9.0

**1+N 多模态 Agent 框架** — 面向国产大模型的开源 AI 助手。

> 一个主管调度多个专家，自动拆解和执行复杂任务。终端里跑，VS Code 里用，支持 100+ 模型。

## 🚀 安装

```bash
pip install aether
aether                          # 首次运行自动配置
```

## ✨ 特性

- 🧠 **1+3 主管-专家架构** — 主管拆解任务，File/Search/Create 三个专家各司其职
- 🇨🇳 **国产模型全覆盖** — DeepSeek V4 / 通义千问 / 智谱 GLM / 豆包 / Moonshot / Ollama
- 🔧 **实时切换模型** — `/model deepseek` 三秒切，支持任意 LiteLLM 兼容的 model_id
- 📋 **三种执行模式** — Auto（直接执行）/ Plan（先出计划）/ Step（逐步确认）
- 💾 **语义缓存 + 上下文压缩** — 相似任务命中缓存，长对话自动压缩，省 Token
- 🎯 **人格学习** — 自动学习你的交互风格，越聊越像你
- 🔒 **Docker 沙箱** — `/sandbox on` 容器隔离，代码碰不到真实文件
- ⏪ **Checkpoint 快照** — 写文件自动备份，`/rewind` 秒级回滚
- 🔌 **MCP 插件** — 接入社区工具，`.env` 里配 `MCP_SERVERS`
- 📦 **Skills 能力包** — `.aether/skills/*.md` 即插即用
- 🧠 **跨会话记忆** — 自动记住偏好和项目信息

## ⚡ 快速开始

```bash
pip install aether
aether
```

首次运行自动弹出终端配置向导 → 选模型 → 输 Key → 开始对话。

## 💻 VS Code 中使用

打开 VS Code 终端（Ctrl+`），输入：

```bash
aether
```

或添加任务（`.vscode/tasks.json`）：

```json
{
  "version": "2.0.0",
  "tasks": [{
    "label": "Aether",
    "type": "shell",
    "command": "aether",
    "presentation": {"reveal": "always", "panel": "new"}
  }]
}
```

然后 `Ctrl+Shift+P` → `Tasks: Run Task` → `Aether`。

## ⌨️ 常用命令

| 命令 | 别名 | 作用 |
|------|------|------|
| `/mode plan` | `/m p` | 先出计划再执行 |
| `/model qwen` | `/md` | 实时切换模型 |
| `/usage` | `/u` | 查看 Token 消耗 |
| `/status` | `/s` | 会话状态 |
| `/memory` | — | 查看记忆 |
| `/git` | — | Git 状态 |
| `/checkpoint` | `/cp` | 快照列表 |
| `/rewind` | `/w` | 回滚到快照 |
| `/export` | `/ex` | 导出对话 |
| `/sandbox on` | `/sb on` | 开启 Docker 沙箱 |
| `/skill` | `/sk` | Skills 管理 |
| `/model` | `/md` | 切换模型 |
| `/quit` | `/q` | 退出 |

## 🏗️ 架构

```
用户输入 → Supervisor（任务拆解+调度）
                │
      ┌─────────┼─────────┐
      ▼         ▼         ▼
  FileAgent  SearchAgent  CreateAgent
   (文件)     (搜索)       (创作)
```

## 📄 许可

Apache 2.0
