lzf_0626
36c7a9d8d2
## 新入库（`docs/演示用/`）
- `代码库全面审查报告-2026-09-14.md`
- `代码修改方案-2026-09-14.md`
- `记忆系统排查报告-2026-09-14.md`
- `记忆系统修复文档-2026-09-14.md`
- `文档一致性审计报告-2026-09-14.md`
- `多Worker接入方案-2026-09-14.md`
## 全量校对（32 个既有文档 + `AGENTS.md`）
跨 39 个文件、**1125 insertions / 148 deletions**。
⚠️ **这批改动同样不是本次会话写的**。我抽样核对过性质：是**实质内容补充**而不是
格式/换行转换。例如 `docs/44-演示流程.md` 新增两条"2026-09-14 补注"：
- `启动金融Agent平台.bat` 只在**桌面**上，仓库里只有 `启动平台.bat` 这一份
（两份由同一个 `tools/make_launcher_bat.py` 产出，改完 `start.ps1` 重跑它一起更新）；
- `advisor_t`(9020) 与 `offsite_t`(9006) **不在 `tools/seed_test_rbac.py` 的演示用户里**
（那里只有 `cust_t`/`risk_t`/`admin_t`/`review_t` 四个），由 `grant_*.py` 系列创建，
**重跑种子不会重建它们** —— 换机器时这两个账号登录失败，要先查 `sys_user` 有没有这两行，
而不是查密码。
这两条都是对的地方，与我这一路踩到的现象一致（我确实用到了 `advisor_t`/`offsite_t`）。
**我没有逐字审阅全部 39 个文件**，只抽样确认了改动性质与规模。若其中有需要复核的段落，
请指明文件，我逐处核对。
风控业务模块演示文档
文档功能
本文档是风控业务模块演示文档包的索引，用于说明文档范围、阅读顺序和模块与主项目的职责边界。
模块定位
本模块是主项目中的风控业务模块，负责风险预警、规则扫描、人工处置、证据查询、日报、通知和奶龙风控智能助手等业务能力。
以下内容由主项目统一负责，不在本模块文档范围内：
- 启动顺序和进程编排。
- 访问地址和反向代理。
- 登录页面和统一登录流程。
- 基础设施安装、部署和环境变量管理。
- 数据库初始化和演示数据导入。
- 主项目公共接口规范、JWT、Worker 和审计底座。
文档清单
| 编号 | 文档 | 主要用途 |
|---|---|---|
| 01 | 风控模块总览与边界 | 说明模块目标、范围和职责 |
| 02 | 主项目接入清单 | 说明主项目需要提供的接入点和本模块注册内容 |
| 03 | 风控业务规则与研判手册 | 说明五条规则和证据依据 |
| 04 | 预警状态机与处置规则 | 说明确认、调查、误报、结案和升级 |
| 05 | 误报可放行与疑似误判标准 | 说明只读研判草案的判断边界 |
| 06 | 模块接口与字段映射 | 说明本模块接口、参数和响应字段 |
| 07 | 权限与数据范围说明 | 说明角色、权限码和客户归属 |
| 08 | 数据库依赖与读写边界 | 说明读取表、写入表和字段边界 |
| 09 | 奶龙风控智能助手说明 | 说明助手能力、限制和免责声明 |
| 10 | Agent 工具与调用流程 | 说明工具、参数、调用轮次和降级 |
| 11 | 证据来源与脱敏说明 | 说明证据来源、聚合和脱敏 |
| 12 | 日报通知与邮件规则 | 说明日报、通知、邮件和开关 |
| 13 | 行为分与关注等级 | 说明行为分计算和筛选区间 |
| 14 | 审计与追溯映射 | 说明业务动作、工具调用和运行审计 |
| 15 | 模块验收与演示清单 | 说明演示前置条件和验收步骤 |
| 16 | 已知限制与待办 | 说明当前限制、暂缓项和外部依赖 |
| 17 | 风控模块-前端合并提示词与验收约束 | 指导后续模型识别风控功能并合并前端 |
| 18 | 当前项目完成进度 | 汇总当前完成度、验证结果和剩余任务 |
| 19 | 风控模块配置项清单 | 单独说明风控专用和公共依赖配置 |
| 20 | Agent工具白名单与意图配置 | 交付主项目方的工具和意图配置 |
| 21 | 主项目合并后后端必改清单 | 列出合并后必须处理的后端事项 |
| 22 | 风控模块需求说明书 | 统一业务需求、规则、边界和验收口径 |
| 23 | 风控模块接口文档 | 提供 REST、SSE、字段和联调约定 |
| 24 | 主项目风控前端改造TODO | 记录前端保留项、修改项和待讨论方案 |
| 26 | 演示机数据插入规则 | 说明演示机准备上游数据的表、字段、场景和检查规则 |
推荐阅读顺序
- 01、02：先理解模块定位和主项目接入方式。
- 03、04、05：理解业务规则和处置逻辑。
- 06、07、08：理解接口、权限和数据库边界。
- 09、10：理解奶龙风控智能助手和工具调用。
- 11 至 16：理解证据、日报、审计、验收和限制。
- 17：主项目前端合并时直接提供给模型。
- 18：项目汇报、进度同步和下一阶段安排。
- 19：合并部署和联调时核对环境变量。
- 20：主项目方导入 Agent 工具白名单和意图配置。
- 21：主项目代码合并后的后端整改与验收。
- 22、23：分别作为需求交付和接口联调的统一入口。
- 24：主项目风控前端改造的事项、决策项和实施顺序。
- 26：演示机准备上游数据时按表、字段、场景和检查规则执行。