yaping-aether 0.9.0__tar.gz

yaping_aether-0.9.0/.env.example

@@ -0,0 +1,39 @@
+# Aether 配置
+# 复制此文件为 .env 并填入你的 API Key
+
+# ===== 模型配置 =====
+# 主管模型（用于任务拆解和调度，建议用最强的）
+SUPERVISOR_MODEL=dashscope/qwen-max
+SUPERVISOR_API_KEY=your_qwen_api_key_here
+
+# 专家默认模型（可以每个专家用不同的，这里是默认值）
+WORKER_MODEL=deepseek/deepseek-chat
+WORKER_API_KEY=your_deepseek_api_key_here
+
+# 智能路由：每个专家可配独立模型（读文件用便宜的，写代码用强的）
+# FILE_MODEL=dashscope/qwen-turbo      ← 文件操作走便宜模型
+# SEARCH_MODEL=deepseek/deepseek-chat
+# CREATE_MODEL=dashscope/qwen-max      ← 创作走强模型
+
+# 如果所有模型共用同一个 API 提供商，可以用这个简化配置
+# DEFAULT_MODEL=dashscope/qwen-max
+# DEFAULT_API_KEY=your_api_key_here
+
+# ===== 可选配置 =====
+# 计划模型（可选，不设则共用主管模型。可设为更便宜的模型做计划，省 Token）
+# PLAN_MODEL=dashscope/qwen-turbo
+
+# 默认执行模式: auto（直接执行）, plan（先出计划）, step（逐步确认）
+DEFAULT_MODE=auto
+
+# 最大步数（主管 Agent 最多执行多少步）
+MAX_STEPS=20
+
+# 日志级别: DEBUG, INFO, WARNING, ERROR
+LOG_LEVEL=INFO
+
+# 缓存开关（MVP 阶段默认关闭）
+CACHE_ENABLED=false
+
+# 记忆系统（默认开启）
+MEMORY_ENABLED=true

yaping_aether-0.9.0/.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: Test
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e .
+          pip install pytest
+
+      - name: Run tests
+        run: python -m pytest tests/ -v --tb=short

yaping_aether-0.9.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtualenv
+.venv/
+venv/
+
+# Environment
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Cache
+*.cache/
+.cache/
+
+# Test
+.pytest_cache/
+htmlcov/
+.coverage

yaping_aether-0.9.0/LICENSE

@@ -0,0 +1,59 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work.
+
+   See the full license at: http://www.apache.org/licenses/LICENSE-2.0

yaping_aether-0.9.0/PKG-INFO

@@ -0,0 +1,120 @@
+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

yaping_aether-0.9.0/README.md

@@ -0,0 +1,92 @@
+# 🌌 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

yaping_aether-0.9.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "yaping-aether"
+version = "0.9.0"
+description = "1+N 多模态 Agent 框架 — 面向国产大模型的开源 AI 助手"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Aether Contributors" }]
+keywords = ["agent", "llm", "chinese-llm", "multi-agent", "smolagents", "cli", "ai-assistant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "smolagents>=1.20.0",
+    "litellm>=1.60.0",
+    "rich>=13.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/AQ-july/aether"
+Repository = "https://github.com/AQ-july/aether.git"
+Issues = "https://github.com/AQ-july/aether/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+]
+
+[project.scripts]
+aether = "aether.main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aether"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

yaping_aether-0.9.0/run.py

@@ -0,0 +1,14 @@
+"""Aether 启动脚本
+用法：双击或在终端运行 python run.py
+"""
+import sys
+from pathlib import Path
+
+# 确保 src 目录在 Python 路径中
+src_path = Path(__file__).parent / "src"
+sys.path.insert(0, str(src_path))
+
+from aether.main import main
+
+if __name__ == "__main__":
+    main()

yaping_aether-0.9.0/src/aether/__init__.py

@@ -0,0 +1,3 @@
+"""Aether — 1+N 多模态 Agent 框架"""
+
+__version__ = "0.9.0"

yaping_aether-0.9.0/src/aether/agents/create_agent.py

@@ -0,0 +1,28 @@
+"""内容创作专家 Agent"""
+
+from smolagents import CodeAgent, LiteLLMModel
+
+from ..config import WorkerConfig
+from ..tools.create_tools import write_article, generate_code, summarize_text
+from ..tools.file_tools import write_file
+from ..tools.project_tools import edit_file
+
+
+def create_create_agent(config: WorkerConfig) -> CodeAgent:
+    """创建内容创作专家 Agent。支持独立模型（CREATE_MODEL），否则用默认。"""
+    mc = config.create_model or config.model
+    model = LiteLLMModel(model_id=mc.model_id, api_key=mc.api_key, temperature=mc.temperature)
+
+    agent = CodeAgent(
+        name="create_agent",
+        description=(
+            "内容创作专家。能写文章、生成代码、摘要文本。"
+            "当任务涉及创作内容（写文章、写代码、做摘要、生成文档）时调用我。"
+        ),
+        tools=[write_article, generate_code, summarize_text, write_file, edit_file],
+        model=model,
+        provide_run_summary=True,
+        max_steps=12,
+    )
+
+    return agent

yaping_aether-0.9.0/src/aether/agents/file_agent.py

@@ -0,0 +1,27 @@
+"""文件管理专家 Agent"""
+
+from smolagents import CodeAgent, LiteLLMModel
+
+from ..config import WorkerConfig
+from ..tools.file_tools import read_file, write_file, list_directory, search_files
+from ..tools.project_tools import project_map
+
+
+def create_file_agent(config: WorkerConfig) -> CodeAgent:
+    """创建文件管理专家 Agent。支持独立模型（FILE_MODEL），否则用默认。"""
+    mc = config.file_model or config.model
+    model = LiteLLMModel(model_id=mc.model_id, api_key=mc.api_key, temperature=mc.temperature)
+
+    agent = CodeAgent(
+        name="file_agent",
+        description=(
+            "文件管理专家。能搜索、读取、写入、整理本地文件和目录，扫描项目结构。"
+            "当任务涉及文件操作（读文件、写文件、整理文件夹、搜索文件、了解项目结构）时调用我。"
+        ),
+        tools=[read_file, write_file, list_directory, search_files, project_map],
+        model=model,
+        provide_run_summary=True,
+        max_steps=10,
+    )
+
+    return agent

yaping_aether-0.9.0/src/aether/agents/search_agent.py

@@ -0,0 +1,26 @@
+"""搜索专家 Agent"""
+
+from smolagents import CodeAgent, LiteLLMModel
+
+from ..config import WorkerConfig
+from ..tools.search_tools import web_search, fetch_url
+
+
+def create_search_agent(config: WorkerConfig) -> CodeAgent:
+    """创建搜索专家 Agent。支持独立模型（SEARCH_MODEL），否则用默认。"""
+    mc = config.search_model or config.model
+    model = LiteLLMModel(model_id=mc.model_id, api_key=mc.api_key, temperature=mc.temperature)
+
+    agent = CodeAgent(
+        name="search_agent",
+        description=(
+            "搜索专家。能搜索网页、抓取 URL 内容、聚合资讯。"
+            "当任务涉及在网上查找信息、搜索资料、获取最新资讯时调用我。"
+        ),
+        tools=[web_search, fetch_url],
+        model=model,
+        provide_run_summary=True,
+        max_steps=8,
+    )
+
+    return agent

yaping_aether-0.9.0/src/aether/cache/semantic_cache.py

@@ -0,0 +1,140 @@
+"""语义缓存层
+
+对相似的任务/查询进行缓存，避免重复调用 LLM。
+
+核心思路：
+1. 将用户任务文本做 embedding
+2. 与缓存中的历史任务做余弦相似度匹配
+3. 相似度超过阈值 → 直接返回缓存结果
+4. 否则执行任务 → 结果存入缓存
+
+MVP 阶段使用简单的文本 hash + 模糊匹配，
+后续可升级为向量数据库方案。
+"""
+
+import hashlib
+import time
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass
+class CacheEntry:
+    """单条缓存记录"""
+    task_hash: str
+    task: str
+    result: Any
+    timestamp: float = field(default_factory=time.time)
+    hit_count: int = 0
+
+
+class SemanticCache:
+    """语义缓存管理器。
+
+    MVP 版本使用以下策略：
+    - 精确匹配：相同任务文本 → 直接命中
+    - 规范化匹配：去空白、小写后相同 → 命中
+    - 前缀匹配：新任务是缓存任务的子串 → 命中
+
+    未来可升级为 embedding + 向量相似度匹配。
+    """
+
+    def __init__(
+        self,
+        max_entries: int = 100,
+        ttl_seconds: int = 3600,
+        similarity_threshold: float = 0.92,
+    ):
+        self._cache: dict[str, CacheEntry] = {}
+        self._max_entries = max_entries
+        self._ttl_seconds = ttl_seconds
+        self._similarity_threshold = similarity_threshold
+
+    def _normalize(self, text: str) -> str:
+        """规范化文本：去除所有空白、转小写。
+        
+        中英文混排场景下，空格不是可靠的词边界（"Python协程" vs "Python 协程"），
+        因此直接去掉所有空白后做哈希，确保语义等价文本命中同一缓存。
+        """
+        # 去掉所有空白字符（空格、换行、制表等）
+        import re
+        return re.sub(r"\s+", "", text.lower())
+
+    def _hash(self, task: str) -> str:
+        """计算任务的哈希"""
+        return hashlib.md5(self._normalize(task).encode()).hexdigest()
+
+    def get(self, task: str) -> Any | None:
+        """查找缓存。返回结果或 None。"""
+        # 1. 精确匹配
+        task_hash = self._hash(task)
+        entry = self._cache.get(task_hash)
+        if entry:
+            # 检查是否过期
+            if time.time() - entry.timestamp > self._ttl_seconds:
+                del self._cache[task_hash]
+                return None
+            entry.hit_count += 1
+            return entry.result
+
+        # 2. 规范化匹配（遍历缓存查找）
+        normalized = self._normalize(task)
+        for cached_hash, cached_entry in self._cache.items():
+            cached_normalized = self._normalize(cached_entry.task)
+            # 完全相同
+            if normalized == cached_normalized:
+                if time.time() - cached_entry.timestamp < self._ttl_seconds:
+                    cached_entry.hit_count += 1
+                    # 将新 hash 也指向同一结果
+                    self._cache[task_hash] = cached_entry
+                    return cached_entry.result
+            # 新任务是缓存任务的子串（更具体的追问可能命中之前的大任务）
+            if normalized in cached_normalized and len(normalized) > 20:
+                if time.time() - cached_entry.timestamp < self._ttl_seconds:
+                    cached_entry.hit_count += 1
+                    return cached_entry.result
+
+        return None
+
+    def set(self, task: str, result: Any) -> None:
+        """存入缓存"""
+        # 清理过期条目
+        self._evict_expired()
+
+        # 超出容量时淘汰命中次数最少的
+        if len(self._cache) >= self._max_entries:
+            min_entry = min(self._cache.values(), key=lambda e: e.hit_count)
+            del self._cache[min_entry.task_hash]
+
+        task_hash = self._hash(task)
+        self._cache[task_hash] = CacheEntry(
+            task_hash=task_hash,
+            task=task,
+            result=result,
+        )
+
+    def _evict_expired(self) -> None:
+        """清理过期缓存"""
+        now = time.time()
+        expired = [
+            h for h, e in self._cache.items()
+            if now - e.timestamp > self._ttl_seconds
+        ]
+        for h in expired:
+            del self._cache[h]
+
+    def clear(self) -> None:
+        """清空所有缓存"""
+        self._cache.clear()
+
+    @property
+    def stats(self) -> dict:
+        """缓存统计信息"""
+        total = len(self._cache)
+        hits = sum(e.hit_count for e in self._cache.values())
+        return {
+            "entries": total,
+            "total_hits": hits,
+            "max_entries": self._max_entries,
+            "ttl_seconds": self._ttl_seconds,
+        }