# AI 代理功能开发 · 校园 AI 代理层

> **定位标注**：本目录开发「端 ↔ 云之间的 **AI 代理层**」——面向校园场景的 LLM API 代理网关
> （如代理 DeepSeek key：学生持代理 key，代理持有上游主 key）。
> **商业模式 = API 差价 + 缓存收益**：校园问题高重复 → 高缓存命中 → 高毛利；
> 校园网提供网络基础设施（托管/带宽/内网可达）。
> **方案全文见 [`方案_校园AI代理层.md`](方案_校园AI代理层.md)**（架构 / 缓存经济学 / 复用映射 / MVP 任务 / 合规红线）。

## 当前状态

- [x] 立项草案（2026-09-04）：方案文档就绪
- [ ] P1 透传网关 → P2 计量计费 → P3 缓存栈 → P4 账号配额 → P5 看板（见方案第 4 节）

## 工作区约定（智能体工具调用）

本目录同时是智能体的工作区之一：

1. **接入**：设置页 → 工作区选择本目录；或 `POST /agent/workspaces`，
   `{"path": "AI代理功能开发"}`。网关默认工作区仍为 `agent_workspace/`，互不影响。
2. **安全边界**（对齐 实现方案_v4 / D12）：工具调用关押在本目录内，路径越界拒绝；
   `run_command` 默认关闭（allow_shell 开关）。

## Git 与安全约定

- 本目录**仅 README 与方案文档入库**；开发/实验产物由 `.gitignore` 忽略。
- **上游主 key 只存 env / `config/settings.json`（已 gitignore）**；
  任何代码、示例、测试不得出现真实凭据字面量。

## 相关文档与代码

- 复用资产：`gateway/model_pool.py`（多价位池）、`router_system/cache.py`（语义缓存）、
  `gateway/api.py`（SSE 基建）、`review.py`（sqlite 模式 → billing 参照）
- 设计：`实现方案_v4_模型池与工具智能体.md`；进展：`毕业设计_进度记录.md`