Files

T

GaoYiYuan_0626 fffb78a11c docs: 记忆文件同步架构改进交付态（纯文档，零代码）

- 架构设计说明书.md：同步桌面终版——§2.1 补 trace 顺序测试守卫、§4.2.1 无 key 告警闭环、
  §4.3.4 重写为 Redis 双层锁（TTL 30s/Lua 释放/进程内备）、§5.3/§6.10/§7.1/§7.2/§7.3/§7.4/§9.4
  锁与告警状态更新、基线 510
- FRAMEWORK/FLOW/REQUIREMENTS：风控 Tool 四→五（补 query_overdue_alerts）、词表 42→45 口径
- README：risk-m3 tag 注记 + API 契约表改五只读 Tool
- 注：交接文档.md v2.2 同步更新（该文件被 .gitignore 忽略，仅本地）

2026-09-09 20:06:53 +08:00

5.2 KiB

Raw Blame History

需求拆解（对照开发）

来源：docs/需求拆解/业务场景优先级清单.md（P0）
合规：docs/需求拆解/Agent风险与合规约束汇总.md
数据：docs/需求拆解/数据交互矩阵.md

本轮范围

目的： 四 Agent 服务四类人群，统一数据层 + 合规底座，可对话闭环。
明确不做： 自动交易、营销推荐、Agent 互调 LLM、自动冻户、Streamlit、P3 平台能力。

Wave 0 · 共用底座

ID	需求	验收对照	状态	TODO
F-01	JWT + RBAC + 数据归属	越权 403 + audit；JWT 手册 §13	已完成（T-01，2026-09-07）：auth_service 验签/吊销 + deps 工厂（Bearer 全环境 + dev debug 头兜底）+ X-Agent-Type 准入矩阵 + 归属断言（B6 已有）；越权 403 + audit + input_guard_log 双写	~~T-01~~
F-02	全量审计留痕	trace_id 可还原	已完成（T-02，2026-09-07）：http_access 审计中间件 + X-Trace-Id/X-Request-Id 双贯通 + 4xx/500 统一错误体；业务判定审计 B6 已接	~~T-02~~
F-03	输入防护	input_guard_log	完成（2026-09-07，T-03）：prompt_injection（词表纯函数检测，T-03 初版 42 条、2026-09-09 实测扩至 45 条 = 18+11+9+7，命中即拒）/ oversize（4000，Pydantic 硬顶 20000）/ rate_limit（Redis 固定窗口 actor 级 30 次/分 fail-open）；chat 链路 blocked 全留痕，fail-fast 不建会话	—
F-04	Core 只读层	不改 Core 账；Repository 只 SELECT	已完成（T-04，2026-09-07）：core_ro（含风控扩展）经 app/tool/core_tools.py 三只读 Tool 接入 chat（L0/持仓/流水）；Tool 层归属校验（A-01 语义：customer 本人/advisor assigned/risk_officer 全量）+ agent_tool_call 全留痕；Core 侧仍仅 SELECT	~~T-04~~
R0-DB	MySQL 共用 11 表 + Redis	01-mysql-共用底座.sql	SQL 已定；本机已灌库（B9b 走查验证）	T-05（本机已完成）
R0-CORE	Core 模拟 + 同步	reset.ps1 + sync 脚本	脚本已落地	T-05

F-01 部分完成说明： B6 已落地 app/api/deps.py（AuthContext Pydantic + get_auth_context() 工厂，dev 从 X-Debug-Role/X-Debug-Actor 头构造；T-01 就绪后仅替换工厂内部为 JWT 解析）。

F-04 完成说明（T-04，2026-09-07）： app/repository/core_ro.py（含风控扩展）仅 SELECT 不变；对话接入经 app/tool/core_tools.py（query_customer_profile / query_holdings / query_recent_trades，TOOL_REGISTRY 白名单）+ app/service/tool_service.py（run_tool：归属校验→执行→agent_tool_call 落库）；agent_service 图为 START→tool→llm→guard，customer_id 由会话注入不接受 LLM 生成。风控五 Tool（C1 四只 + C5 追加 query_overdue_alerts，RISK_TOOL_REGISTRY 实 5 个）复用同一 runner。

Wave 1 · 内部 Agent P0

ID	需求	验收对照	状态	TODO
D-01~D-04	分析：客户/产品/预警查数 + SQL 留痕	analytics_query_log	未做	T-10
A-01~A-05	代理人：画像/规则/草稿/流程/合规巡检	非归属 403；草稿不外发	未做	T-20

Wave 2 · 风控 P0

详细需求见 docs/PRD/PRD-风控监测Agent.md（v1.0 冻结 + v1.1 追加 FR-8/9/10）；范围含 R-04（P1 顺手做）、R-05 仅预留 L3 接口。

ID	需求	验收对照	状态	TODO
R-01	大额预警	risk_alert pending_review	已实现（B1~B6，A-1/A-2 用例绿）	~~T-30~~
R-02	适当性阻断请求	唯一阻断场景	已实现（~~SUIT-001~008~~ 阶段一换核：main 的 core_ro.check_suitability C×R 矩阵 + match_result 五值/JR-AST-012/FM-01/FM-03/JR-AST-PRO 契约 + check API 带鉴权 + 网关阻断；risk_suitability_log 21 列落库；MySQL 手工 SQL 对照挂账 B9b）	~~T-31~~
R-03	AML 命中通知	不自动冻户	已实现（aml_service + scan API + L3 联动；对话线随 C1~C3 完成，A-6 验收通过）	~~T-32~~
R-04	频繁/试探模式预警	聚合出单 + 去重	已实现（B1 规则 + B2 聚合去重）	~~T-30~~
R-05	L3 画像写入	最小写入（最高档合并）	已实现（profile_l3 防降级；`risk_score` 一期保持 NULL 归评分模型首写）	~~T-30~~
FR-8	客户资产配置集中度预警（RISK-006）	A-10：R4+R5 占比 ≥ 阈值出单（并入事件类聚合）；对话线只读展示	待编码（实现方案已定稿，任务 C4）	C4
FR-9	预警单处置时效监控与自动升级（RISK-007）	A-11：超时分级升级（payload 承载不改 status）+ 幂等 + 降噪	待编码（P0 红线；任务 C5，前置 = risk_manager 角色联动）	C5
FR-10	代理人异常行为链识别（RISK-008）	A-12：条件 A/B/C 触发 + 代理人维度出单（payload.actor_id）+ 明细仅 officer/manager 可见	待编码（任务 C6，前置 = trade_gateway actor 透传）	C6

Wave 3 · 客户 P0

ID	需求	验收对照	状态	TODO
C-01~C-05	持仓/产品/规则/阈值/净值	无买卖指导	未做	T-40

P1+ 见 docs/需求拆解/业务场景优先级清单.md §3。

5.2 KiB Raw Blame History Unescape Escape