张胜宇
e239eb778b
1) 客服 Agent 四份交付文档 + 构建脚手架：品牌由包装占位 XX科技 / 旧名 南方财富 统一为南方基金（热线 400-889-8899 / 官网 nffund.com），系统名改为「智能服务系统」； 同步追加 §0.4 修订记录行，工程记录行保留原占位字面以支撑硬编码扫描验收。 2) 开发文档：清理 28 份已作废/残留文档（14 份移出归档 + 14 份仓库副本）， 新增《文档规整方案与开发前待决事项-2026-09-17》。 3) 客服agent 四份交付文档首次纳入本分支。
75 lines
2.6 KiB
Python
75 lines
2.6 KiB
Python
"""手工重建客户画像：中期记忆 → 长期事实 → 画像 + 版本快照。
|
||
|
||
用法：
|
||
|
||
```powershell
|
||
# 重建一个客户
|
||
python tools/rebuild_profile.py 9001
|
||
|
||
# 重建全部有记忆的客户
|
||
python tools/rebuild_profile.py --all
|
||
```
|
||
|
||
为什么需要这个入口：画像组装目前没有自动触发（记忆写入后不会立刻重建画像），
|
||
在把它接上 Worker 事件之前，这是唯一的触发方式，也便于运维排查"画像为什么没更新"。
|
||
|
||
关于输出里的 `reason=profile_row_not_opened`：客户尚未开户时不会创建画像行
|
||
（`trade_account` 等身份字段是 NOT NULL，属注册／开户流程所有），这是**正确行为**而非失败。
|
||
"""
|
||
|
||
import argparse
|
||
import asyncio
|
||
import sys
|
||
|
||
from sqlalchemy import select
|
||
|
||
from app.infrastructure.db import SessionFactory
|
||
from app.model.memory import MemoryUnit
|
||
from app.service.profile_assembly_service import ProfileAssemblyService
|
||
|
||
sys.stdout.reconfigure(errors="replace")
|
||
|
||
|
||
async def rebuild_one(customer_id: int) -> None:
|
||
async with SessionFactory() as session:
|
||
async with session.begin():
|
||
outcome = await ProfileAssemblyService(session).rebuild(customer_id)
|
||
print(f"\n== 客户 {customer_id} ==")
|
||
if outcome.get("profile") is None:
|
||
print(f" 未重建画像：{outcome.get('reason')}"
|
||
f"（尚未开户；已提升事实 {len(outcome.get('promoted_keys') or [])} 条）")
|
||
else:
|
||
print(f" 提升事实：{outcome.get('promoted_keys')}")
|
||
print(f" 画像内容：{outcome.get('profile')}")
|
||
print(f" 生成依据：{outcome.get('generation_basis')}")
|
||
|
||
|
||
async def main() -> int:
|
||
parser = argparse.ArgumentParser(description="重建客户画像")
|
||
parser.add_argument("customer_id", nargs="?", type=int, help="客户 id")
|
||
parser.add_argument("--all", action="store_true", help="重建全部有记忆的客户")
|
||
args = parser.parse_args()
|
||
|
||
if args.all:
|
||
async with SessionFactory() as session:
|
||
rows = list(await session.scalars(
|
||
select(MemoryUnit.customer_id).distinct()
|
||
))
|
||
targets = [int(row) for row in rows]
|
||
if not targets:
|
||
print("没有任何客户有记忆数据，无需重建")
|
||
return 0
|
||
print(f"将重建 {len(targets)} 个客户：{targets}")
|
||
for customer_id in targets:
|
||
await rebuild_one(customer_id)
|
||
return 0
|
||
|
||
if args.customer_id is None:
|
||
parser.print_help()
|
||
return 2
|
||
await rebuild_one(args.customer_id)
|
||
return 0
|
||
|
||
|
||
sys.exit(asyncio.run(main()))
|