Files

T

zhanghongyu_0626 af9fb719e5 refactor(analyst): Update authentication context and add smoke test script

- Replaced `get_auth_context` with `get_platform_auth_context` in `analyst.py` to enhance authentication handling.
- Added a new smoke test script `smoke_analyst.py` for testing the data analysis agent with both fake and live LLM configurations.
- Updated TODO documentation to reflect the completion of Scope B smoke tests, ensuring clarity on testing status.

This update improves the authentication mechanism and introduces a comprehensive testing approach for the data analysis agent.

2026-09-09 21:09:03 +08:00

20 KiB

Raw Blame History

TODO

大任务开始时更新；完成一步打钩并验证后再往下。
新 Agent： 先看 MEMORY.md §0 交接清单，再从此处取下一项。

进行中

前端 P0 主链路真接（2026-09-09）：ChatPanel · 游客/客户/风控/顾问/分析 Chat · 平台只读页 · 行情 · 风控台账处置 · 773 passed · 19 Vitest · analytics 问数页已接

Redis Docker（2026-09-09）：jinrong-redis @ 6380 · .env REDIS_URL 已对齐 · scripts/dev/start-redis.ps1 ✓

待办（统筹 · P1 推荐顺序）

代销平台 API v0.1 实现（2026-09-08）：customers/products/advisors/staff/compliance + service/platform/ + PLATFORM_RESPONSE_DESENSITIZE · 530 passed 0 skipped
web/ P0 脚手架 init（2026-09-09）：Vite+AntD+HashRouter · 登录真接 · AppLayout · 四角色路由 · 占位页 · 见 web/README.md · 设计 docs/superpowers/specs/2026-09-09-frontend-p0-design.md
接口契约发群（login + 平台读 API + simulate/trade；强调重复功能以平台路径为准）
前端 P0 真接（analytics 问数已接 · 契约发群 · simulate 说明）
同步 MEMORY/REQUIREMENTS/FRAMEWORK 与各 Agent 负责人联调节奏

前端 `web/` · P0 待接（后端已就绪）

现状（2026-09-09）：ChatPanel / 四 Agent 对话 / 平台只读页 / 行情 / 风控台账已真接；待接：analytics 问数页 · PermissionGate · simulate 交易 UI。

四角色「收益/洞察」登录首页（2026-09-09 · web/src/pages/dashboard/*）：静奢 UI（Tailwind v4 + tokens.css）· Hero+图表+明细 · 真接平台 API · 交接见 docs/frontend/FRONTEND-HANDOFF.md
平台 API client（Dashboard 子集）（2026-09-09）：customers / products / risk（listPendingAlerts）/ advisors + ApiErrorResult · 完整 CRUD/处置等见下方未接项
customer 只读页（一条链路跑通）：档案 / 持仓 / 流水 · 真调 v0.1（2026-09-09）
共享 /app/market：GET /api/products + 逐产品 GET .../nav · 静态净值 Alert
ChatPanel + SSE 解析：sessions 列表 / messages / close · 首帧 meta/disclaimer · [DONE] 收尾
customer Chat：POST /api/chat 同步 · X-Agent-Type: customer（客服 LangGraph 专用线）
登录页游客试聊：POST /api/chat/visitor · VisitorChatWidget
risk Chat：POST /api/chat/stream · X-Agent-Type: risk
risk 预警台账全页：GET /api/risk/alerts 筛选/分页表格 + POST .../handle 处置 UI
advisor Chat：SSE + AgentBanner · 名下客户列表页
/app/analytics/chat：SSE · X-Agent-Type: analyst
/app/analytics/query：AnalystQueryPanel · POST /api/analyst/chat · 四角色权限内问数
Vitest：authStore · SSE 解析已绿（19 例）· 可补 ChatPanel hook 测试
前端 P0 收尾：接口契约发群 · simulate 交易 Disabled 菜单说明

待办（模块侧开放项）

客服 Agent · S2 接缝（2026-09-09 已接线 · 并行分流）

清单：docs/项目框架设计/客服Agent-合并说明.md §3–§4 · 原则只增不盖、不覆盖 main.py/chat.py/agent_service.py 整体。

跑迁移 SQL：scripts/agent/migrate-customer-agent-cs-c11.sql（conversation_archive · customer_notes）（2026-09-09 本机已执行）
挂游客路由：POST /api/chat/visitor → main.py
编排接缝（并行）：X-Agent-Type: customer → customer_service.run_customer_chat；其余 Agent 仍 agent_service.chat
Wave 3 测试解禁：test_wave3_customer_service.py 19 例绿 · 基线 554 passed
Wave 1/2 解禁：test_wave1_* · test_wave2_* 已移出 collect_ignore 并绿（132+ 例）
Wave 3 profile / 4 / 5 解禁：test_wave3_profile_service · test_wave4_e2e · test_wave5_notes · 基线 730 passed
客服 KB 第二套（fin_*）· Ollama 灌库（2026-09-09 本机）：
1. ollama pull bge-m3 ✓
2. Ollama 服务 http://127.0.0.1:11434 ✓
3. Windows：MILVUS_URI 须英文绝对路径（如 C:/Users/Windows/.jinrong/milvus/milvus.db），中文项目路径 faiss 会炸
4. python scripts/kb/build_collections.py --rebuild（原料 data/kb_collections/）✓ 9 块
5. python scripts/kb/test_search.py ✓
客服 RAG 接 fin_ 三库*：VisitorRagService → search_cs_knowledge（fin_product / fin_policy / fin_faq）；宿主 Tool 仍走 kb_product_rules（T-21）
tool 层实现 + 种子文档：document_parser / embedding_tool / milvus_tool + data/kb_collections/*（2026-09-09）

数据分析 Agent · S3 接缝（2026-09-09 已接线）

清单：docs/项目框架设计/数据分析Agent-合并说明.md · merge data-analysis-agent-work · 773 passed

merge + 接缝：analyst_router · analyst_auth_adapter · analyst_schemas · 废弃 utils/auth.py
鉴权 G1–G4 + G8：assert_analyst_query_access · customer self 域 · 尾注「AI 分析有风险」
Wave6 测试：test_wave6_* · +43 例
前端问数页：web/src/pages/analytics/AnalystQueryPage.tsx · api/analyst.ts
迁移 SQL（本机）：scripts/agent/migrate-analyst-d07-d11.sql（三资产表 · 2026-09-09 已执行 · 无种子数据）
Scope B 冒烟：python scripts/dev/smoke_analyst.py → 19/19（FakeLLM + --live-llm 真 MySQL/LLM 亦绿）

风控 Agent · 后端已就绪 · 前端/运维未接（盘点 2026-09-09）

HTTP 接口（后端已实现 · 前端/演示未接）

POST /api/risk/alerts/{alert_id}/handle：人工处置（confirmed_normal / confirmed_suspicious / reported）· 前端台账页 + api/risk.ts 封装
GET /api/risk/alerts（完整能力）：alert_type / customer_id / 日期窗 / 分页 · Dashboard 仅用 status=pending_review 子集
POST /api/risk/suitability/check：风控线适当性直调（过渡路径 · 带 audit）· 前端未接
POST /api/compliance/suitability-check：平台 canonical 适当性 · 前端未接（发群口径以此为准）
POST /api/risk/aml/scan：全量 AML 手动扫描 · 仅 risk_officer · 无 UI
POST /api/simulate/trade：模拟交易 → 规则引擎动态出预警 · 无 UI（演示走 Swagger / curl）

对话 Tool（需 risk Chat SSE 才触达）

risk Chat SSE：POST /api/chat/stream · X-Agent-Type: risk
alert_query / customer_context / suitability_check / aml_lookup / query_overdue_alerts
query_agent_behavior：函数+意图已有 · 未写入 RISK_TOOL_REGISTRY → 会 TOOL_UNKNOWN（接线前必修）

运维 / 动态演示（无 UI · 见 演示SOP-风控模块.md）

scripts/demo/subscribe_alerts.py：订阅 Redis risk:pub:alert 实时推送（Pub/Sub 无持久化，须先开订阅再发交易）
scripts/cron/escalation_scan.py：超期未处置升级（FR-9 · 需库内已有 pending_review 且 created_at 超阈值）
scripts/cron/agent_behavior_scan.py：代理人行为链扫描（FR-10 · 需 audit_log 先积累越权/诱导交易痕迹）
scripts/demo/rebuild_alerts.py：按 trade_id 幂等重放引擎（engine_error 补偿）

演示种子 / 测试数据补充（测未接接口 · 非 everyday reset.ps1）

Core reset 后 risk_alert 为空、AML/测评可能未就位；测预警/处置/推送/FR-9/FR-10 须先补数据。

scripts/agent/seed-aml-list.sql：8 条 AML 名单（A-5：CUST-1002 展示名故意命中）
scripts/demo/prepare_risk_demo.sql：6 客户测评刷新（可交易）；CUST-1004 保持过期（FM-03 阻断演示）
风控走查重灌（SOP §2）：双库 DROP + agent 表 + 上两项 + sync_advisor_rel（reset.ps1 只重建 core）
动态造预警 · A-1~A-5：POST /api/simulate/trade（Swagger/curl）— A-3 CUST-3001/PROD-510300/50 万 · A-4 CUST-9527 连发 4 笔 · A-5 CUST-1002/PROD-005828/100
Redis 实时推送演示：终端 1 subscribe_alerts.py → 终端 2 发 simulate/trade（Pub/Sub 无持久化）
FR-9 超期升级：库内 pending_review 且 created_at 超 RISK_ESCALATION_L1_HOURS（默认 4h）→ escalation_scan.py
FR-10 代理人行为链：A-12 ① 同一 X-Debug-Actor=STAFF-10087 发 3 组赎回+申购 + 越权 audit → agent_behavior_scan.py
L3 监测档数据：A-5 AML 命中后 customer_profile_l3.monitor_tier=high（测 customer_context Tool / Dashboard 高风险客户数）
适当性阻断样例：A-1 CUST-1001/PROD-161725/1 万 · A-2 CUST-4001/2 万（测 handle/台账 suitability 单）
引擎补偿：rebuild_alerts.py <trade_id>（engine_error 场景）
可选 dev 静态预警 seed：2~3 条 pending_review 样例（免每次 simulate；与集成测试当日窗冲突须文档说明）
链式 reset 脚本：AML + prepare 并入 reset.ps1 或新增 scripts/demo/prepare_all.ps1

画像 Redis · cache-aside（2026-09-09）

L3 热读：get_profile_l3 cache-aside（读 Redis miss → MySQL → SET EX 5m；写 upsert DEL）· customer_context Tool 已走此路径
L1 热读/写：ProfileHotCache 仅在客服线 customer_service.py · 宿主 POST /api/chat 未接
L2 热读/写：表与 JWT scope 已有 · Repository/Redis 未实现
chat 链路 risk_suitability_log.actor_id 暂落 SYSTEM（run_tool 统一透传需动 core_tools/kb_tools 冻结 func 契约，发起者留痕已由 agent_tool_call 覆盖）——AL-06 遗留，动 Tool 契约前先出方案
【前端接入·方案 B】chat 拉侧三端点（commit 8328c24，2026-09-08）：GET /api/chat/sessions（本人+本 Agent 线分页列表）、GET /api/chat/sessions/{id}/messages（历史消息升序分页，closed 仍可读）、POST /api/chat/sessions/{id}/close（active→closed，重复/非 active 409）；chat.py 抽 _resolve_agent_type/_assert_chat_entry/_guard_session 三守卫供四端点共用，POST "" 行为零回归；risk_manager 在对话线数据面保持 403（PRD 4A.1）。测试 482→494 绿；独立评审 P0=0，P1（close 并发 rowcount 静默 200）已修复
【前端接入·方案 C】SSE 流式对话（commit 01ec5fc，2026-09-08）：新增 POST /api/chat/stream（OpenAI 兼容 chunk：首帧 meta → delta → finish_reason=stop → [DONE]）；agent_service.stream_chat 生成器 + needs_disclaimer；_guard_request/_prepare_turn 与同步端点共用守卫；session_repository.insert_turn user+assistant 同事务落库（修评审 P0/P1）。测试 494→503 绿。遗留：无心跳帧、断连留空会话待清理
chat 同步/流式落库免责声明口径统一（2026-09-09）：chat.py _assistant_content_for_persist · sync/stream 共用 · test_chat 回归
2026-09-05 memory 文件夹更新（新 Agent 交接清单）

AL-09 已完成（2026-09-08）——见 docs/项目框架设计/合并注意事项-风控模块并入main.md 执行记录。

【AL-09】合并接线（2026-09-08）：JWT 统一 · 模块 chat 恢复 · auth_adapter · test_module_boundary 绿 · 502 pytest 绿
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 首批入库 —— 完成（2026-09-07，commits e34973f~535c8a0 共 6 个 + 评审闭环 9cc2e59）：app/service/embedding.py（Ollama bge-m3 批量 /api/embed 1024 维，四类失败一律 EmbeddingError 不静默降级）+ app/service/milvus_service.py（kb_product_rules 幂等建集合+upsert+search_kb 溯源/effective_date 合规过滤）+ data/kb/ 6 只种子产品手册（prospectus/fee/rule/risk 四节 24 块）+ scripts/kb/build_kb.py（--dry-run/--kb-dir）+ app/service/rag_service.py 落地（search_knowledge→chunks+source_refs，异常上抛防 LLM 编造）+ app/tool/kb_tools.py 挂注册表第三层（ToolSpec 新增 skip_access_check：公开知识无归属语义，advisor 无绑定客户可查；意图层限定 customer/advisor，risk 不开放——用户拍板）+ tool_node 按 spec 白名单注入 query + summarize 溯源口径。真库验收：24 块入库，search_knowledge("基金申购") Top3 命中申赎规则（score 0.73+），溯源完整。三坑收口：Milvus Lite 跨进程重开须显式 load / faiss 不支持中文路径（本机 .env 改 C:/Users/YUAN/.jinrong/milvus/）/ build_kb sys.path 引导。知识库 API（上传/重建端点）一期不做（knowledge.py 仍空壳，用户拍板），425 绿
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 绿
风控阶段 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

风控模块（PRD v1.0 已冻结 · `docs/PRD/PRD-风控监测Agent.md`，事件驱动线不依赖 T-07 可先行）

T-30 风控事件线 —— 全部完成（B1~B9b，M2 tag risk-m2）：规则引擎/预警聚合/L3/AML/交易网关/4 API/演示走查 11/11 PASS + 核查单①~⑥收口，均经独立 AI 评审闭环；scan_all 幂等读后写无锁留痕（接批量时 run_locked）
T-31 service/suitability.py 公共校验（SUIT-001008）+ POST /api/risk/suitability/check —— **交付=suitability 服务函数+单测（77 例；check API 随 B6 带鉴权+直调审计）；MySQL 手工 SQL 对照（阶段 A 评审 P2-8）2026-09-07 收口：4 组演示组合真库 SQL 推导与函数判定逐项一致（演示 SOP 核查单附行）。【2026-09-07 阶段一退役】SUIT-001008 编号体系已随 AL-05 换核退役，判定内核改为 main 的 core_ro.check_suitability（C×R 矩阵 + JR-AST/FM 契约），测试按 main 契约重写（原 77 例作废，全量基线 425→406）**
T-32 预警台账与人工处置 API + 对话线 —— 台账/处置 API 已由 B6 覆盖并复审通过（A-7/A-9 用例绿）；交付=对话线，归阶段 C（C1~C3，T-07 已就绪）

已完成

2026-09-07 风控 M2 收尾（M4 复核）：MEMORY/TODO 状态与边界文字对齐（任务映射 T-30/T-31/T-32 口径确认；B7 复审留痕「成功响应不包裹外壳」演进口径维持并登记开发计划 M4 节）——风控阶段 B 正式完结
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
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）
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 不依赖外网
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 挂载
2026-09-07 Wave 0 独立 AI 评审有条件通过→闭环（commit 61711cb）：P2×5（python-jose>=3.5.0 防 CVE / audit 降级测试 / JWT 通道 chat 用例 / debug 兜底纵深防御 / 留痕失败降级显式化）+ P3×11 顺手，273 测试绿
2026-09-05 init 项目记忆目录 + app/ 脚手架（api/service/tool/model/config/utils）
2026-09-05 需求拆解文档（业务场景/矩阵/合规）
2026-09-05 表设计 + 技术选型 + JWT 手册
2026-09-05 Core 模拟库 scripts/core/* + reset.ps1 + 文档
2026-09-05 core_ro.py + settings.mysql_core_database + sync 脚本
2026-09-05 Agent 编排依赖改为 LangGraph（requirements.txt）
2026-09-05 memory 文件夹更新（新 Agent 交接清单）
2026-09-09 数据分析 Agent 需求规格定稿 v1.1（docs/需求拆解/01-数据分析Agent需求规格.md，含 D-01~D-12 + 缓存/三层记忆方案）

20 KiB Raw Blame History Unescape Escape