chore: T-P-1 工作区收敛——并行会话成果与历史未入库文件整理入库

- 入库历史遗漏源码/测试: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
This commit is contained in:
tzt
2026-09-05 08:28:25 +08:00
parent 747d85c3ba
commit ce0f6170d3
82 changed files with 74132 additions and 36 deletions
+33
View File
@@ -0,0 +1,33 @@
# 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`