group_xinghuo_jinrong/AGENTS.md

Agent

⚡ 需要接手/开工，先读项目根「交接文档.md」 —— 三线合并版唯一交接入口： §0 公共层（铁律 / 环境 / 已知坑 / 禁止事项）· §A 风控模块主线 · §B 基金转换（convert）线 · §C 架构改进线。 （该文件在 .gitignore 内、不入库，是给 AI 接手用的本地文件；docs/交接文档-*.md 两份为历史留档，内容已过期，勿读。）

无上下文时先读 docs/memory/MEMORY.md §0 交接清单（5 分钟了解仓库地图、bootstrap、禁止项、下一步）。

阅读顺序

顺序	文件	何时
1	docs/memory/MEMORY.md	每次任务
2	docs/memory/TODO.md	取当前待办
3	docs/memory/REQUIREMENTS.md	对照场景 ID（F/C/A/D/R）
4	docs/memory/FRAMEWORK.md	分层、选型、实现状态表
5	docs/memory/FLOW.md	端到端链路 + §0 bootstrap
6	docs/memory/ENVIRONMENT.md	As-Is；Core 为模拟库

原文与深度文档

• 业务需求：docs/需求拆解/
• 表结构 SQL：docs/项目框架设计/表设计/
• 技术选型 / JWT：docs/项目框架设计/技术选型和版本/
• Core 模拟底座：docs/项目框架设计/Core模拟底座/
• 业务记忆分层：docs/业务记忆管理/业务记忆管理手册.md
• 基金转换线（第 5 步 todo 开发进行中 · T+1 受理/确认分离模型）：T-1 ~ T-11 ✅ / T-12 ~ T-17 ⬜（当前基线 846 passed / 10 skipped 实测；真库 T-6 verify_convert_accept.py 37/37、T-7 verify_convert_confirm.py 83/83、T-8 verify_convert_engine.py 39/39、T-9/T-10 verify_convert_api.py 89/89、T-11 复跑 verify_convert_tools.py 14/14，退出码均 0；下一步 T-12 = 补偿脚本改写）；开工入口 交接文档.md §B（§B.11 下一条立项指引 = 最新状态）· docs/PRD/PRD-基金转换交易.md（v1.1）· docs/项目框架设计/架构设计-基金转换交易.md（v2.1）· docs/项目框架设计/开发计划-基金转换交易.md（v2.0 · T-1~T-17 逐任务改法 + DoD）
• 架构改进线（✅ 2026-09-10 已结项，无待办）：开工入口 交接文档.md §C
• 风控模块主线：交接文档.md §A

代码入口

app/main.py               # FastAPI：路由挂载 + trace/audit 中间件 + lifespan（风控 4 API + /api/simulate + /api/chat 四端点已挂载）
app/api/chat.py           # 对话：POST ""（同步）+ GET /sessions + GET /sessions/{id}/messages + POST /sessions/{id}/close（方案 B）+ POST /stream（SSE 流式，方案 C）
app/api/deps.py           # 鉴权工厂（T-01 JWT：Bearer 优先，dev debug 头兜底）+ 归属断言
app/service/auth_service.py     # Auth SDK：JWT 验签/吊销（T-01）；签发 CLI scripts/dev/issue_dev_token.py
app/service/agent_service.py    # LangGraph StateGraph 骨架 + DeepSeek（T-07）
app/config/settings.py    # 双库 jinrong_agent + jinrong_core + risk_* 阈值 + JWT 配置
app/repository/core_ro.py # Core 只读（已实现）
scripts/core/reset.ps1    # 本地灌 Core 模拟库

技术选型硬阀门见 MEMORY 第 3、7 节。Cursor 以 .cursor/rules/project-memory.mdc 为准。