docs: 交接文档增量同步——演示库状态更新(已按 SOP 重灌+冒烟清理, pytest 可直接跑, 走查后需再重灌) + FLOW 尾注补 python-jose 漏装坑(与 redis 包同类, 附 import 自检命令) + JWT 默认密钥 warning 属预期/DEEPSEEK 空 chat 降级入本机状态 + AGENTS.md 代码入口刷新(main 全路由/鉴权工厂/Auth SDK/StateGraph)

2026-09-07 08:15:50 +08:00
parent b97e77747a
commit 3c3ce4e5d6
3 changed files with 10 additions and 7 deletions
@@ -50,9 +50,9 @@ Client → Gateway(JWT/RBAC) → api/chat → agent_service(LangGraph) → Tools

 当前：**风控事件线 + Wave 0 共用底座完成**（交易网关 → 规则引擎 → 预警/AML/L3 → 4 API，`main.py` 路由挂载 + trace 中间件（X-Trace-Id/X-Request-Id + 500 兜底）+ audit 中间件（http_access）+ lifespan 完成，B1~B8；T-01 JWT 鉴权（Bearer 全环境 + dev debug 头兜底 + X-Agent-Type 准入矩阵）/ T-02 审计与 input_guard_log 双写 / T-06 chat 最小闭环（`POST /api/chat` 会话+窗口+落盘）/ T-07 LangGraph 骨架+DeepSeek（无 key 降级）均于 2026-09-07 完成并经独立 AI 评审闭环；M2 tag risk-m2 + M4 复核闭环；273 测试绿）；阶段 B 完结；**对话链路骨架已通**（chat → LangGraph → 免责声明 → 落库），Tool 节点与 RAG 待 T-04/T-21、输入防护待 T-03。

-**本机已就位状态（2026-09-07 更新 · 已完成上述 ①~⑤，无需重做）：** `.env` 已配置（学习项目，`MYSQL_PASSWORD=123456`；NEO4J/DEEPSEEK 留空——DEEPSEEK_API_KEY 空时 chat 走降级回复，不阻塞演示；JWT 配置走默认 dev secret，启动有 warning 属预期）；`jinrong_core` + `jinrong_agent` 已灌库（28 客户 / AML 名单 8 条 / 演示测评已刷新 / 归属同步 28 行）；`python -m pytest` 273 用例（重灌后全绿；集成测试真连本机 MySQL，未灌库的机器自动 skip 集成模块。**演示库当前含 B9b 走查残留，跑集成前先按演示 SOP §2 重灌**——核查单⑥前置断言会对残留数据显式 fail）；本机 Redis 服务在跑（`redis://127.0.0.1:6379/0`，B9a 订阅脚本已验证）。
+**本机已就位状态（2026-09-07 更新 · 已完成上述 ①~⑤，无需重做）：** `.env` 已配置（学习项目，`MYSQL_PASSWORD=123456`；NEO4J/DEEPSEEK 留空——DEEPSEEK_API_KEY 空时 chat 走降级回复，不阻塞演示；`.env` 无 JWT 项，签发走默认 `JWT_DEV_SECRET`，**启动时出现默认密钥 warning 属预期**，生产形态须配 `JWT_PUBLIC_KEY_PATH`）；`jinrong_core` + `jinrong_agent` 已灌库（28 客户 / AML 名单 8 条 / 演示测评已刷新 / 归属同步 28 行）；`python -m pytest` 273 用例全绿（集成测试真连本机 MySQL，未灌库的机器自动 skip 集成模块）；**演示库已重灌并清理冒烟数据（2026-09-07），全量测试可直接跑，下次演示/走查后再按 SOP §2 重灌**；本机 Redis 服务在跑（`redis://127.0.0.1:6379/0`，B9a 订阅脚本已验证）。

-**本机已知坑：** `mysql.exe` 不在 PATH（位于 `C:\Program Files\MySQL\MySQL Server 8.0\bin`）；`reset.ps1` 的交互式 `-p` 在自动化执行时会卡死——脚本化重灌用 `MYSQL_PWD` 环境变量传密码（交互执行不受影响，不把密码写进仓库脚本）；`redis` 包 requirements 有但初始 `pip install -r` 漏装（B9a 于 2026-09-07 补装，重装环境时留意）。
+**本机已知坑：** `mysql.exe` 不在 PATH（位于 `C:\Program Files\MySQL\MySQL Server 8.0\bin`）；`reset.ps1` 的交互式 `-p` 在自动化执行时会卡死——脚本化重灌用 `MYSQL_PWD` 环境变量传密码（交互执行不受影响，不把密码写进仓库脚本）；**`redis` 与 `python-jose[cryptography]` 包均出现过 requirements 有而环境漏装（B9a 补装 redis、Wave 0 补装 jose，2026-09-07），重装环境后先 `python -c "import jose, redis"` 自检**。

 ------