tzt
ce0f6170d3
- 入库历史遗漏源码/测试：router_system 9 模块（agent/executors/inference/knowledge/ memory/planner/skills/trace）、tests 11 个测试文件、config/knowledge 领域知识 - 入库根目录方案文档（v2/v3/可行性×2）、references 文献（arxiv 14-18/cnki_open/ 参考文献清单）、research 论文素材（routerarena/paper/中文文献 PDF） - 前端构建产物刷新（新 hash）；webapp 误写文档删除 - gitignore 增补：deepseek-harness、research/_refs、.mimosa/.zcode、网关日志/pid、 临时调试脚本、tests/e2e/node_modules、AI代理功能开发/prefix - 基线确认：318 passed
34 lines
1.8 KiB
Markdown
34 lines
1.8 KiB
Markdown
# 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`
|