docs: add project README, env guide and assignment baseline notes

This commit is contained in:
Eric Wang
2026-10-19 13:32:31 +08:00
parent 81b2335d9e
commit a6ce570499
4 changed files with 173 additions and 1 deletions
+1 -1
View File
@@ -126,7 +126,7 @@ python -m pytest test/agent/test_scaffold.py -q
3. 提供 `AGENT_BACKEND=fastgpt|langgraph` 类型化配置和依赖工厂。LangGraph fake 模式启动不得要求 FastGPT 密钥;仍启用语音 FastGPT 路径时单独校验所需配置。
4. 将资源初始化和关闭纳入 lifespan。两种后端分别执行启动冒烟验证,不仅在测试中覆盖依赖。
5. 在现有 `test/api/` 补充 HTTP 级契约测试;检查 OpenAPI schema、JSON 响应和 SSE 事件。
6. 先运行已有测试并记录基线。已知需检查的过期预期包括:默认请求缺少 `clientMode`、`ChatInput.client_mode` 仍期望空串、`nextStageCode` 把五字符视为超长。按当前实际契约修正预期,不能为消除红灯收窄合法协议。
6. 在 Conda 的 `py3.11` 环境先运行已有测试并记录基线。当前测试已覆盖默认 `clientMode=direct`、API 向 `ChatInput` 传递该模式,以及 `nextStageCode` 的 32 字符上限。后续按当前实际契约维护预期,不能为消除红灯收窄合法协议。
7. 保存请求与响应夹具,覆盖两种 clientMode、分句开关、表单开关、state 标签跨 chunk 和错误响应。
**交付物:** 可切换的图后端、HTTP 契约夹具、修正说明、两种后端的启动方法。