AI260626/group_fqcd_jr
13
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
5b97475950225e67a6dc0a6a488f4e8e61a0c4cb
group_fqcd_jr/.env.example
T
lzf_0626 0c642133d4 修复长期记忆向量链路：投影入队 + 集合名三侧同源 + 召回按客户过滤 
语义召回"恒空"的根因分四层，本提交修掉投递层与读取层（另两层——重试计数
门禁、episode 不投 rebuild 事件——已在前两个提交修复）。

R2 投递层：dispatch_profile_rebuild 只做图投影，没有任何 Milvus 投递，
  长期记忆的向量从未被写入过（实测客户 9001 在 memory_sync_outbox 里 0 行）。
  新增 _enqueue_memory_vector_projection()，在画像重建后投
  MemorySyncOutbox(target_store="milvus")。走事件而不是同步写，是为了拿
  Outbox 的重试/退避/死信，且不把 embedding 的网络等待拖进事务。
  ⚠️ payload 必须带 version（正整数）：适配器 _coerce_profile_version 缺它
  直接抛 ValueError（实测踩到，事件立刻 failed）。

R4 读取层：写的集合与读的集合不是同一个 ——
  写（MilvusProfileProjection）用 "user_long_term_memory_v1"，
  读（bootstrap.get_vector_memory_adapter）与删（projection_cleanup_service）
  却用 settings.milvus_collection = "jr_memory"，而该集合从未被创建。
  ⇒ 召回：MilvusClient 构造不校验集合存在，适配器"构造成功"但每次 search
     抛异常被 VectorMemoryAdapter 吞成 degraded → 召回恒
     degraded_reasons=('milvus_unavailable',)、向量命中恒 0 条；
  ⇒ 清理：jr_memory 不在集合列表 → 走 vector_collection_absent 分支 →
     报清理成功但一个向量都没删，陈旧向量永久留存。
  修法：PROFILE_COLLECTION 成为唯一常量，读/删两侧直接引用它；
  并删除 Settings.milvus_collection 配置项、清掉 .env.example 的
  MILVUS_COLLECTION —— 写侧从来没读过它，一个只在契约一侧生效的配置项
  比没有配置项更危险（Settings 的 extra="ignore" 会让其他环境残留的该
  变量被安全忽略）。

顺带：
- 语义检索把客户过滤下推到 Milvus（filter="customer_id == N"）。此前不带
  过滤，别家客户的命中会白占 limit 名额，稀释本客户的召回条数。
- upsert 在 sources 为空时先返回，不再无条件 load_collection ——
  "本来就没有可写内容"不该被记成投递失败（10001/10002 那两条事件即如此
  重试 5 次进死信）。

回归守卫：tests/unit/infrastructure/test_memory_vector_collection_consistency.py
  断言读侧与删侧用的都是 PROFILE_COLLECTION，且被删掉的配置项不得回归。
  这个缺陷能活下来，正是因为两侧单测全绿而接缝无人守。

验证（走生产装配、进程内调用，未重启你正在跑的 API 窗口）：
  读侧集合打印 user_long_term_memory_v1（修前为 jr_memory）；
  召回 degraded=False / reasons=() / sources 含 milvus，且排序随 query 语义
  变化（投资期限→horizon 0.288 > risk_level 0.201；风险偏好→risk_level 0.287）；
  query="进取型" 双通道合并且 vector_score=0.9987；query=None 走 mysql 全量。
  pytest tests/unit tests/contract → 1432 passed, 2 skipped, 1 failed
  （唯一失败是同事正在改的投顾页面，与记忆链路无关）。

文档：docs/演示用/记忆召回恒空-根因与修复-2026-09-14.md（新增，四层根因+证据）、
  docs/37-记忆投影链路实现说明.md（补集合名三侧契约）。
2026-09-14 21:26:03 +08:00

134 lines
4.2 KiB
Bash
Raw Blame History

APP_ENV=local
APP_NAME=jr-agent-platform
LOG_LEVEL=INFO
TIMEZONE=Asia/Shanghai
JWT_ISSUER=jr-local
JWT_AUDIENCE=jr-agent-platform
JWT_ALGORITHM=RS256
# 开发专用密钥，由 tools/generate_jwt_keys.py 生成。config/jwt/ 已被 .gitignore 忽略，
# 所以克隆仓库后**必须自己生成一次**，否则服务会因为读不到公钥而启动失败。
# 生产环境：在生产机上单独生成一套，用环境变量覆盖这两行，不要复用开发密钥。
JWT_PRIVATE_KEY_PATH=config/jwt/dev/jwt-private.pem
JWT_PUBLIC_KEY_PATH=config/jwt/dev/jwt-public.pem
JWT_CLOCK_SKEW_SECONDS=30
MYSQL_DSN=mysql+asyncmy://jr_app:change-me@127.0.0.1:3306/jr_agent
MYSQL_POOL_SIZE=5
MYSQL_MAX_OVERFLOW=10
MYSQL_POOL_PRE_PING=false
MYSQL_TX_ISOLATION=READ COMMITTED
REDIS_URL=redis://127.0.0.1:6379/0
REDIS_CONNECT_TIMEOUT_SECONDS=2
MESSAGE_BROKER_URL=
MESSAGE_BROKER_RUN_TOPIC=agent.run
MESSAGE_BROKER_OUTBOX_TOPIC=agent.outbox
MESSAGE_BROKER_DLQ_TOPIC=agent.dlq
MILVUS_URI=http://127.0.0.1:19530
MILVUS_TOKEN=
NEO4J_URI=bolt://127.0.0.1:7687
NEO4J_DATABASE=neo4j
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=
MODEL_ROUTER_CONFIG_REF=local
MODEL_DEFAULT_ENDPOINT=
MODEL_FALLBACK_ENDPOINT=
DEEPSEEK_API_KEY=
SSE_HEARTBEAT_SECONDS=15
SSE_MAX_CONNECTION_SECONDS=300
WORKER_LEASE_SECONDS=60
WORKER_RETRY_LIMIT=3
WORKER_POLL_SECONDS=1
SSE_CHUNK_CHARACTERS=256
RISK_SCAN_SCHEDULE_ENABLED=false
RISK_SCAN_INTERVAL_MINUTES=5
RISK_SCAN_RUN_IMMEDIATELY=false
RISK_SCAN_RETRY_LIMIT=2
RISK_SCAN_POLL_SECONDS=30
RISK_EVIDENCE_DIR=storage/risk_evidence
RISK_EVIDENCE_MAX_FILE_SIZE_MB=10
RISK_ALERT_MAIL_ENABLED=true
RISK_ALERT_MAIL_DRY_RUN=false
RISK_ALERT_MAIL_RECIPIENTS=你的邮箱账号
RISK_DAILY_REPORT_MAIL_ENABLED=true
RISK_DAILY_REPORT_MAIL_DRY_RUN=true
RISK_SMTP_HOST=smtp.163.com
RISK_SMTP_PORT=465
RISK_SMTP_USERNAME=你的邮箱账号
RISK_SMTP_PASSWORD=你的SMTP授权码
RISK_SMTP_SENDER=你的邮箱账号
RISK_SMTP_USE_SSL=true
RISK_SMTP_TIMEOUT_SECONDS=30
# 投顾灰度：开启后仅白名单客户和管理员可访问投顾业务；多个客户 ID 用逗号分隔。
ADVISOR_ROLLOUT_ENABLED=false
ADVISOR_ROLLOUT_CUSTOMER_IDS=
# 限流：按“用户 + 方法 + 路由”在窗口内计数，超限返回 429 RATE_LIMITED + Retry-After。
# 默认 600/60s（10 QPS）是为本机验收与集成测试留足余量的宽松值；生产按真实容量收紧。
# Redis 不可用时自动降级为放行（限流是保护措施，不能因后端故障拒绝正常请求）。
RATE_LIMIT_ENABLED=true
RATE_LIMIT_WINDOW_SECONDS=60
RATE_LIMIT_MAX_REQUESTS=600
RATE_LIMIT_KEY_PREFIX=jr:rate_limit
OFFSITE_MAILBOX=yuan80818843@163.com
OFFSITE_ALLOWED_SENDERS=["15273589815@163.com"]
OFFSITE_RISK_RECEIVER_ID=
OFFSITE_SETTLEMENT_RECEIVER_ID=
OFFSITE_MAIL_RETURN_RECEIVER=yuan80818843@163.com
OFFSITE_MAX_RETRY_COUNT=3
OFFSITE_IMAP_ENABLED=false
OFFSITE_IMAP_HOST=
OFFSITE_IMAP_PORT=993
OFFSITE_IMAP_USERNAME=
OFFSITE_IMAP_PASSWORD=
OFFSITE_IMAP_USE_SSL=true
OFFSITE_IMAP_IDLE_ENABLED=false
OFFSITE_IMAP_IDLE_TIMEOUT_SECONDS=120
OFFSITE_MAIL_WORKER_ENABLED=false
OFFSITE_MAIL_WORKER_BATCH_SIZE=20
OFFSITE_WORKER_USER_ID=
OFFSITE_NOTIFICATION_SENDING_TIMEOUT_SECONDS=900
OFFSITE_MAIL_STORAGE_DIR=data/offsite_mail
OFFSITE_OCR_ENABLED=false
OFFSITE_OCR_TIMEOUT_SECONDS=30
OFFSITE_ALIYUN_OCR_ENDPOINT=https://docmind-api.cn-hangzhou.aliyuncs.com
OFFSITE_ALIYUN_REGION_ID=cn-hangzhou
OFFSITE_ALIYUN_POLL_INTERVAL_SECONDS=1
OFFSITE_ALIYUN_ACCESS_KEY_ID=
OFFSITE_ALIYUN_ACCESS_KEY_SECRET=
OFFSITE_DEEPSEEK_ENABLED=false
OFFSITE_DEEPSEEK_BASE_URL=https://api.deepseek.com
OFFSITE_DEEPSEEK_API_KEY=
OFFSITE_DEEPSEEK_MODEL=deepseek-v4-flash
OFFSITE_DEEPSEEK_TIMEOUT_SECONDS=30
OFFSITE_SMTP_ENABLED=false
OFFSITE_SMTP_DRY_RUN=true
OFFSITE_SMTP_HOST=
OFFSITE_SMTP_PORT=465
OFFSITE_SMTP_USERNAME=
OFFSITE_SMTP_PASSWORD=
OFFSITE_SMTP_SENDER=
OFFSITE_SMTP_USE_SSL=true
OFFSITE_SMTP_TIMEOUT_SECONDS=30
PROMOTION_MATERIAL_STORAGE_DIR=data/promotion_materials
PROMOTION_PDF_ENABLED=false
PROMOTION_PDF_CONVERTER_PATH=
PROMOTION_MAX_PHOTO_SIZE_BYTES=10485760
PROMOTION_MAX_PERFORMANCE_FILE_SIZE_BYTES=20971520
PROMOTION_IMAGE_ENABLED=false
PROMOTION_IMAGE_BASE_URL=https://dashscope.aliyuncs.com
PROMOTION_IMAGE_MODEL=wan2.2-t2i-flash
PROMOTION_IMAGE_TIMEOUT_SECONDS=90
PROMOTION_IMAGE_POLL_INTERVAL_SECONDS=2
Reference in New Issue View Git Blame Copy Permalink