老板要求「在 ai 网关里做智能体 agent,新的一个菜单」,一期仅管理员、成熟后下发。 完整设计(27 条决策,4 轮评审)见 docs/agents-dev-plan.md。 架构(路线 A):界面与权限在网关,执行在 QwenPaw(独立 profile ai-gateway)。 网关当门面(鉴权/计量/灰度/审计),引擎提供工具能力(文件/命令/浏览器)。 Step -1 技术验证(实测,全部改变或确认了设计): - 请求级指定模型【无效】:传 model 被忽略,turn_usage 回 provider_id=opencode、 model_name=deepseek-v4.1-flash;AgentRequest 无 model 字段。模型是 profile 级。 → 甲案:所有智能体共用 ai-gateway 一个 profile ⇒ 共用同一模型,配置页模型栏只读。 - role:"system"【被接受且生效】:塞入「只用英文回答」后模型真的用英文 → params.system_suffix 走注入 system 消息。 - SSE 事件谱已录制 → tests/fixtures/sse-tool-flow.sse + docs/qwenpaw-agent-api-sse.md 后端: - app/agents.py:AgentStore(data/agents.yaml,600/原子写/mtime 热载)+ 严格校验 (slug 三重查重:模型 id/别名/QwenPaw profile;params 4 键白名单;suffix 限长 2000; max_agents=5 软上限,归档不计入;restore 可恢复) - app/adapters/qwenpaw_engine.py:OpenAI 形状 ↔ AgentScope Agent API + SSE 翻译器 (text 累积、delta:false 快照忽略、plugin_call→轨迹、call_id 配对 output、turn_usage→计量) - app/agents_routes.py:GET/POST/PUT/DELETE /agents、/restore、/chat(SSE)、/stop、 /runs、/sessions、/test + 新增 GET /auth/me(灰度通道,features.agents 后端权威); 权限唯一入口 can_use_agent();防自指(引擎模型不得指向 agent/*) - app/history.py:会话类别扩展支持 agent_<slug>(复用现有存储) - data/agents.yaml(配置,入库);data/agent_runs.json(运行时,gitignore) 前端: - views/Agents.vue(列表 + 对话/配置/运行记录)+ lib/agents.ts(SSE 解析) - 菜单核心组第 5 位 + 图标 bot;router meta.admin 双层守卫;i18n 中英对称 871/871 上线实测:真实对话跑通 —— 让智能体 read_file 读 /etc/hostname,前端正确显示 「执行了 1 步」+ 工具参数、正文、计量(wjd · 47196 tokens · 缓存 13696)、终态; 引擎调用经 wangjinding 过网关(计量闭环)。 测试 209 → 217 全过(新增 8 条,含用真实夹具验证 SSE 翻译器);ci_check 全绿。
61 lines
2.2 KiB
Plaintext
61 lines
2.2 KiB
Plaintext
# ── 缓存 / 构建产物 ──
|
||
__pycache__/
|
||
*.pyc
|
||
*.pyo
|
||
.pytest_cache/
|
||
.venv/
|
||
venv/
|
||
*.log
|
||
|
||
# ── 本地敏感文件 ──
|
||
.env
|
||
.env.*
|
||
!.env.example
|
||
# 账号体系数据:密码哈希 + API Key 哈希,属凭证材料,不入库
|
||
data/users.json
|
||
# 前端历史(提示词/回答正文属隐私)
|
||
data/history.json
|
||
# 意见反馈(正文 + 图片,属隐私)
|
||
data/feedback.json
|
||
data/feedback_media/
|
||
# 单测运行时会往项目根写这几个临时数据文件(test_gateway.py 用),别入库
|
||
.test_users.json
|
||
.test_history.json
|
||
.test_feedback.json
|
||
.test_feedback_media/
|
||
.test_sessions.json
|
||
.test_video_owners.json
|
||
.test_env
|
||
|
||
# 运行期状态(第三十轮):会话落盘 / 视频归属落盘 —— 都是运行数据,且含账号名与凭证哈希,
|
||
# 属"可重新生成、不该进版本库"的一类(重启后从空开始,语义上无害)
|
||
data/sessions.json
|
||
data/video_owners.json
|
||
|
||
# 智能体运行记录(第三十八轮):运行时数据(谁在什么时候用了哪个智能体),
|
||
# 与 sessions.json 同理 —— 可重新生成、不该进版本库。
|
||
# 注意 data/agents.yaml 是**配置**(不含秘密),按计划 ⑯ **要入库**。
|
||
data/agent_runs.json
|
||
data/agents.yaml.bak
|
||
|
||
# 配置自动备份(每存一次网关配置就多一对):不该跟着源码走,也不该在仓库里堆历史版本
|
||
data/*.bak
|
||
|
||
# 说明:data/gateway.yaml 不含明文 Key —— 三家供应商密钥统一在 .env(已被上面忽略),
|
||
# 由 yaml 各供应商的 token_env 引用。只要 .env 不提交,密钥就不会进版本库。
|
||
|
||
# ── 设计稿(不入库,历史上从未入库)──────────────────────────────────
|
||
# design/v1、v2、v3 是"出设计图"用的脚本 + 渲染出的 PNG(约 11MB)。
|
||
# 它们与产品构建、网关运行完全无关,且 2026-09-13 曾被清理归档到
|
||
# /root/.trash/<归档>/design/(cp -a 可恢复)。
|
||
# 需要时本地恢复即可,不进版本库。
|
||
design/
|
||
|
||
# ── 依赖与构建产物(不入库,均可重新生成:npm ci && npm run build)──
|
||
node_modules/
|
||
frontend/node_modules/
|
||
frontend/dist/
|
||
dist/
|
||
*.egg-info/
|
||
.DS_Store
|