39 lines
6.8 KiB
Markdown
39 lines
6.8 KiB
Markdown
# TODO
|
||
|
||
> 大任务开始时更新；完成一步打钩并验证后再往下。
|
||
> **新 Agent：** 先看 `MEMORY.md` §0 交接清单，再从此处取下一项。
|
||
|
||
## 进行中
|
||
|
||
（无——风控 M2 收尾已闭环，Wave 0 已完成，均见「已完成」）
|
||
|
||
## 待办（推荐顺序）
|
||
|
||
- [x] T-04 Core RO 封装为 Tool 节点；A-01 归属校验（chat Tool 接入 + agent_tool_call 落库）—— **完成（2026-09-07）**：`app/tool/core_tools.py`（L0/持仓/流水三只读 Tool + TOOL_REGISTRY 白名单）+ `app/service/tool_service.py`（关键词意图仅 customer/advisor；归属校验对齐 deps.assert_customer_access 口径——Tool 层拒绝不抛 403 而 blocked 留痕，纵深防御；run_tool 执行+落库，落库失败降级）+ agent_service 图 tool 节点（START→tool→llm→guard；结果注入 LLM 上下文，降级回复带摘要）+ session_repository.insert_tool_call（message_id 一期 NULL）。**A-01 口径：本任务只做 Tool 层归属校验语义（customer 本人/advisor assigned/risk_officer 全量/其余拒），A-01 完整场景（代理人画像）仍归 T-20**；risk 分支四 Tool 归 C1 复用 run_tool。**评审闭环（2026-09-07）：首评 P1×2+P2×3+P3×2 → 修复 `40a9ee2` → 复审 P2×1+P3×4 → 修复 `1216d26`，pytest 321 绿；入参白名单+days 钳制、公共鉴权双写 `utils/authz.py`、list_holdings LIMIT 均落地**
|
||
- [ ] T-21 Milvus Lite + kb_product_rules 首批入库
|
||
- [x] T-03 输入防护规则（F-03：prompt_injection/oversize/限流）—— **完成（2026-09-07，commits 497554d/65b45aa/cc6f34f/207fc79）**：`app/service/input_guard.py`（注入短语词表 42 条四类纯函数检测 + `inspect_message` oversize 4000 先于 injection + `check_rate_limit` Redis INCR 固定窗口 actor 级 30 次/分 fail-open）+ chat 路由接入（顺序：鉴权→准入→空白→限流 429→注入/超长 400→归属→会话；被拒 fail-fast 不建会话不落消息，blocked 落 input_guard_log，留痕降级不改拒绝语义；Pydantic 硬顶 20000，业务限 4000 移 guard 层换留痕）+ redis_gateway.incr + settings.guard_rate_limit_*；拍板：命中即拒不清洗、仅 blocked 留痕、词表代码常量可审计。**独立 AI 评审 PASS with findings（P0=0；P2×3 已收口：词表断言修正/补 7 条同构变体/窗口 TTL 断言+EXPIRE 失败取舍锁定；P3 已收 session_id 截断，挂账对抗变体扩表）**，378 绿
|
||
- [x] 风控阶段 C（C0 pytest-asyncio / C1 chat_tools / C2 risk 分支 StateGraph / C3 A-6 验收）—— **完成（2026-09-07）**：`app/service/risk/chat_tools.py` 四只读 Tool（alert_query/customer_context/suitability_check/aml_lookup）挂 `RISK_TOOL_REGISTRY`；`tool_service.run_tool` 改查 core+risk 统一注册表 `get_registered_tool` 且恒传 `risk_repo`；`_normalize_params` 读 spec 白名单；`match_intent` 按 agent 分组扩 risk 关键词；`agent_service.tool_node` 守卫放宽（`requires_customer=False` 允许无绑定客户，支撑 A-6 全量待审）；A-6 验收+诱导处置边界（无处置 Tool、系统提示禁自动处置、诱导只触发只读且预警状态不变）；**独立 AI 评审 PASS（P0=0，P2 补 advisor 归属/空 product_id 单测已收口），345 绿，tag `risk-m3`**
|
||
- [ ] 前端 React 多 Agent 入口（HashRouter，`web/` init）
|
||
|
||
### 风控模块（PRD v1.0 已冻结 · `docs/PRD/PRD-风控监测Agent.md`，事件驱动线不依赖 T-07 可先行）
|
||
|
||
- [x] T-30 风控事件线 —— **全部完成（B1~B9b，M2 tag risk-m2）**：规则引擎/预警聚合/L3/AML/交易网关/4 API/演示走查 11/11 PASS + 核查单①~⑥收口，均经独立 AI 评审闭环；scan_all 幂等读后写无锁留痕（接批量时 run_locked）
|
||
- [x] T-31 `service/suitability.py` 公共校验（SUIT-001~008）+ `POST /api/risk/suitability/check` —— **交付=suitability 服务函数+单测（77 例；check API 随 B6 带鉴权+直调审计）；MySQL 手工 SQL 对照（阶段 A 评审 P2-8）2026-09-07 收口：4 组演示组合真库 SQL 推导与函数判定逐项一致（演示 SOP 核查单附行）**
|
||
- [x] T-32 预警台账与人工处置 API + 对话线 —— **台账/处置 API 已由 B6 覆盖并复审通过（A-7/A-9 用例绿）；交付=对话线，归阶段 C（C1~C3，T-07 已就绪）**
|
||
|
||
## 已完成
|
||
|
||
- [x] 2026-09-07 风控 M2 收尾（M4 复核）：MEMORY/TODO 状态与边界文字对齐（任务映射 T-30/T-31/T-32 口径确认；B7 复审留痕「成功响应不包裹外壳」演进口径维持并登记开发计划 M4 节）——风控阶段 B 正式完结
|
||
- [x] 2026-09-07 T-01 JWT 鉴权（commit 36f476f + 评审闭环 61711cb）：`app/service/auth_service.py` Auth SDK（HS256 dev/RS256 生产、必填 claims 显式校验、jti 吊销 fail-open、RS256/HS256 算法白名单互斥）+ `deps.get_auth_context` 工厂替换（Bearer 全环境优先；debug 头降级 dev 兜底，双闸门=APP_ENV+无 RS256 公钥）+ X-Agent-Type 交叉校验（手册 §4.6/§5.4 AGENT_ACCESS_MATRIX）+ `scripts/dev/issue_dev_token.py` 签发 CLI + lifespan 改验 jwt_ready
|
||
- [x] 2026-09-07 T-02 审计中间件（commit 3cec034）：`app/api/audit_middleware.py` http_access 全量访问审计（actor 经 request.state.auth，排障路径/OPTIONS 跳过，写库失败降级）+ 独立 request_id（X-Request-Id 贯通，B7 复审 P3-4）+ 422/404/405/500 统一错误体（500 由 trace 中间件兜底回写 trace 头，B7 复审 P2-2）+ input_guard_log 双写（挂账⑧收口；401 归 platform、四 Agent 入口写 guard）
|
||
- [x] 2026-09-07 T-07 LangGraph 骨架（commit fb18c04）：`agent_service` StateGraph（llm→guard）+ DeepSeek/langchain-openai（无 key 降级明确标注）+ 四 Agent 边界 system prompt + customer/risk 免责声明（has_disclaimer）+ 单测 mock LLM 不依赖外网
|
||
- [x] 2026-09-07 T-06 chat 最小闭环（commit ee5c78a）：`api/chat.py` POST /api/chat（X-Agent-Type 分流+准入+归属校验+SessionGuard AUTH_403_SESSION_AGENT+closed 409）+ `session_repository`（agent_session/agent_message）+ `memory_service`（Redis 窗口 sess:{agent}:{id}:msgs TTL2h N≤20，miss/异常回源 MySQL）+ main 挂载
|
||
- [x] 2026-09-07 Wave 0 独立 AI 评审有条件通过→闭环（commit 61711cb）：P2×5（python-jose>=3.5.0 防 CVE / audit 降级测试 / JWT 通道 chat 用例 / debug 兜底纵深防御 / 留痕失败降级显式化）+ P3×11 顺手，273 测试绿
|
||
- [x] 2026-09-05 init 项目记忆目录 + `app/` 脚手架（api/service/tool/model/config/utils）
|
||
- [x] 2026-09-05 需求拆解文档（业务场景/矩阵/合规）
|
||
- [x] 2026-09-05 表设计 + 技术选型 + JWT 手册
|
||
- [x] 2026-09-05 Core 模拟库 `scripts/core/*` + `reset.ps1` + 文档
|
||
- [x] 2026-09-05 `core_ro.py` + `settings.mysql_core_database` + sync 脚本
|
||
- [x] 2026-09-05 Agent 编排依赖改为 LangGraph（requirements.txt）
|
||
- [x] 2026-09-05 memory 文件夹更新（新 Agent 交接清单）
|