AI 代理功能开发 · 校园 AI 代理层
定位标注：本目录开发「端 ↔ 云之间的 AI 代理层」——面向校园场景的 LLM API 代理网关 （如代理 DeepSeek key：学生持代理 key，代理持有上游主 key）。 商业模式 = API 差价 + 缓存收益：校园问题高重复 → 高缓存命中 → 高毛利； 校园网提供网络基础设施（托管/带宽/内网可达）。 方案全文见
方案_校园AI代理层.md（架构 / 缓存经济学 / 复用映射 / MVP 任务 / 合规红线）。
当前状态
- 立项草案（2026-09-04）：方案文档就绪
- P1 透传网关 → P2 计量计费 → P3 缓存栈 → P4 账号配额 → P5 看板（见方案第 4 节）
工作区约定（智能体工具调用）
本目录同时是智能体的工作区之一：
- 接入：设置页 → 工作区选择本目录；或
POST /agent/workspaces，{"path": "AI代理功能开发"}。网关默认工作区仍为agent_workspace/，互不影响。 - 安全边界（对齐 实现方案_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