Files
XingHuo/docs/memory/MEMORY.md
T

3.1 KiB
Raw Blame History

项目记忆(人 + Agent 共用)

各阶段的简化快照(门闸索引)。只留基础信息,不写源文件正文。 详细需求见 docs/需求拆解/;表设计与技术选型见 docs/项目框架设计/。


1. 项目简介

  • 名称: JinRong 金融四 Agent 智能管家
  • 当前阶段: MVP(需求与底座设计已定,后端脚手架已 init)
  • 当前优先级: 交付速度(先 Wave 0 共用底座 + Wave 1 内部 Agent 闭环)

2. 阶段快照

阶段 当前一句话 源文件
服务对象大环境 公募场景下四类角色各自痛点明确,数据以 Core 为准、Agent 只读事实 ENVIRONMENT.md
需求目的 四个 Agent 服务四类人群,统一数据层交换画像与预警,合规可审计 REQUIREMENTS.md
项目框架 FastAPI 分层 app + MySQL/Redis/Milvus Lite/Neo4j + React;Windows 原生 FRAMEWORK.md
实现流程 Gateway JWT/RBAC → Agent 编排 → Tool/画像库 → 审计落库 FLOW.md

3. 约束

硬阀门:技术选型

docs/项目框架设计/技术选型和版本/01-技术栈与版本.md 中已标「已定」视为用户确认;新增依赖须再确认。

禁止触碰:

Core 正式 C1~C5、持仓/交易真账(Agent 只读)
audit_log 等审计表(只 INSERT)
代理人草稿自动外发客户
风控自动冻户 / 改正式风险等级
各 Agent 自建第二套 JWT/RBAC

高风险(改前需确认): 数据库表结构、JWT/RBAC、部署密钥、删生产数据。

开发开关:

项 YES / NO
允许新增依赖 YES(对齐技术选型文档)
允许重构 YES(最小范围)
允许改表 / schema 需确认
允许改接口协议 需确认

特殊规则:

四 Agent 不互调 LLM;跨 Agent 走 L1/L2/L3 画像与预警表
客户 Agent:无投资建议/收益承诺/自动下单
代理人:不对 C 端直发
数据分析:仅 SELECT,不处置预警
画像不得覆盖 L0 正式测评

4. 入口与运行

关键文件:app/main.py · app/config/settings.py · docs/项目框架设计/表设计/*.sql
如何启动:MySQL/Redis/Neo4j/Ollama 就绪后 → uvicorn app.main:app --reload
配置位置:.env(见 .env.example)

5. 文档资产约定

文件 何时更新
docs/memory/*.md 见 project-memory-kit 约定
docs/需求拆解/ 业务场景与合规(参考)
docs/项目框架设计/ 表结构、鉴权、技术版本

日常改代码只读本文件;验收对照 REQUIREMENTS.md。


6. 协作口令

【大环境】→ ENVIRONMENT · 【需求讨论】→ REQUIREMENTS · 【框架讨论】→ FRAMEWORK · 【实现流程】→ FLOW · 【Plan】→ TODO


7. 阅读完成门闸(Agent)

  1. 四个 Agent 服务谁、禁止什么?
  2. 改动属于 api / service / tool 哪一层?
  3. 是否需 customer_id 归属与 JWT RBAC?
  4. 如何验证?

大任务:FRAMEWORK/FLOW 为空时先补再编码(用户确认跳过除外)。