xinyouhe/ai-kefu-admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
62 Commits 2 Branches 0 Tags
6f22e519081590a045710a1407601a7426c64b5a
Commit Graph

62 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
浅念 6f22e51908 feat: 租户管理与站点管理（创建向导/停用/域名/门面覆盖） 
- API 层实装（api/tenants.ts）：创建/详情/PATCH 租户、建站/改站、
  域名绑定解绑——400 撞车 detail（slug/域名归属/prefix 引导）经
  showErrorMessage:false 关全局 toast、由向导与绑域名弹窗内联常驻展示
- 租户列表：slug/名称/状态/域名数/版本/管理员概要 + 状态筛选 +
  行操作（详情/停用复启用/改名）；停用确认框写明 503 服务暂停语义
- 创建向导（ElSteps 四步）：名称+slug（^[a-z0-9-]+$ 与撞车内联拦截）
  → 域名多填 → 出厂档案（auto/jiancai 提示 prefix 全局唯一撞车引导
  改 blank；blank 提示墙与提示词取建材出厂档案）→ 管理员账号；
  201 后列表刷新并提示首登需改密
- 站点管理（详情抽屉）：站点表/新建站（门面覆盖层表单——brand 组
  子集字段留空=继承租户默认）/停用复启用（404 语义提示）/域名绑定
  （撞车归属内联）与解绑（标签 × 确认）
- vitest +9（API 层 URL/方法/请求体契约）；页面仅超管（菜单 roles 已挡）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 18:27:56 +08:00
浅念 ce668eaf2f feat: 会话与线索（列表/筛选/租户切换/详情消息流/推送日志/删除） 
- 会话列表页签：分页表格 + 筛选（意向三值/站点精确/日期区间 daterange，
  筛选变化重置第一页）+ 行操作（详情抽屉/删除确认框，级联消息画像评估
  推送日志，末页删空自动回退一页）
- 租户切换器：超管专用（fetchTenantList 下拉，默认第一个，切换联动双页签
  并关抽屉）；租户管理员固定登录态 tenant_slug，无切换器只有标签
- 详情抽屉：元数据（状态/来源/站点/IP 归国/session/设备）+ 画像 chips
  （ElTag 键值）+ 评估块（意向/理由/联系方式/更正次数）+ 消息流气泡
  （user 右 assistant 左，时间直显库内 naive UTC 不换算，与筛选同口径）
- 推送日志页签（列表平行）：状态筛选（pending/success/failed/skipped）
  + 分页表格（类型/状态/尝试/outcome/HTTP/payload 大小/会话/错误）——
  列表接口不回大 payload，仅服务端 payload_size
- api/conversations.ts 实装调用函数并按 data_routes.py 实际响应修正类型
  （IntentLevel 三值/messages.time/详情扁平 evaluation+profile 块/
  PushLogItem 全字段），新增枚举中文映射（intentLabel 等，未知值回退原样）
- vitest +9（conversations API 契约：URL/参数/白名单/映射），总 45；
  后端不动（pytest 577 基线复核）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:31:12 +08:00
浅念 f640889f22 feat: 仪表盘（租户卡片墙/平台总览/时间切换）+ 顺手：409契约锁与死代码 
- 仪表盘视图：超管=平台总览四指标卡（/api/platform/stats 合并视图）+
  租户卡片墙（逐租户 ?tenant= 下钻，含停用租户）；租户管理员=自己
  指标卡（/tenants/{slug}/stats，slug 取登录态）；口径文案照
  stats.py docstring（线索=留资三选一/成功率分母0显—等）
- 时间范围快捷切换（今天/近7天/近30天）→ from/to 本地日期串；
  utils/statsRange.ts 纯函数 + epoch 防快速切换过期响应竞写
- 空数据态：无租户 ElEmpty / 单租户零数据自然显 0 与 —
- api/stats.ts 补 fetchPlatformStats/fetchTenantStats；tenants.ts 补
  fetchTenantList（卡片墙枚举，其余仍留 Task 6）
- vitest +11（statsRange 6 + stats API 5，总 36）
- 顺手1：test_auth must_change 409 测试补 detail 断言，锁死前后端
  契约文案（client.ts MUST_CHANGE_DETAIL）
- 顺手2：删除 beforeEach.ts 的 isUnauthorizedError 死分支与 ApiStatus
  import（模板 isHttpError 判自建 ApiError 恒 false，分支不可达）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 16:59:12 +08:00
浅念 3973abea8b feat: API层与认证流（client拦截/守卫/登录改密实装/域API骨架/vitest） 
- 自建轻量 axios client(src/api/client.ts)：Bearer 注入、401 清会话跳登录
  (login 请求除外)、409 精确匹配"必须先修改初始密码"跳强制改密(区别于并发
  冲突 409)、429/网络错误统一 ElMessage、ApiError 标准化、showErrorMessage
  可opt-out——模板 utils/http 的 {code,msg,data} 信封与后端裸 HTTP 语义不符故弃用
- Pinia auth store(src/store/modules/auth.ts)：token/role/tenant_slug/
  must_change 落地并持久化(all-kefu-auth key)，login/logout/changePassword/
  会话过期/强制改密跳转(动态 import 断循环)
- 路由守卫：token 事实源判定、must_change 全站门(除改密页)、UserInfo 由登录
  快照派生(后端无用户信息端点)；user store 残留自愈
- 登录页实装(去除角色调试开关)、强制改密页实装；用户菜单/锁屏对接真实 logout
- 域 API 骨架：tenants/config/conversations/stats/settings(类型+端点常量)
- mask 哨兵助手：__SET__ ↔ 已设置 表单语义
- vitest 25 例(client 11/store 8/mask 6)；登录页拖拽验证 reset 空引用修复

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 16:28:11 +08:00
浅念 6afa31ec85 fix: 脚手架审查修复（dts入库保首跑/esnext注释/模板changelog清理） 
- auto-imports.d.ts / components.d.ts 出 .gitignore 并入库（已重新生成）：新克隆/CI 首跑 pnpm build 直接可用，Phase 4 部署依赖
- vite.config.ts build.target=esnext 补注释：Windows 本机 es2015 曾触发 esbuild 0xC0000409 原生崩溃，改后稳定；管理后台仅面向现代浏览器
- 删除模板自带 CHANGELOG.md / CHANGELOG.zh-CN.md（约 650 行 x2，与本项目无关）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 15:03:30 +08:00
浅念 78ff060420 feat: art-design-pro 脚手架落地与品牌化（八页骨架/代理配置/权限菜单） 
- 模板 art-design-pro（MIT）GitHub 直连克隆后裁剪落地 admin/：删除演示页面/示例数据/mock/未用组件，保留构建与依赖清单
- 品牌化：应用名/标题/侧栏与登录页 logo/浏览器 favicon 全部替换为 all-kefu 自有资源（static/kefu-small.png），中文界面
- 八页骨架：login / force-change-password / dashboard / tenants / conversations / config / stats / settings 占位页 + 6 组路由模块
- 权限菜单：meta.roles 前端过滤，super 全量，tenant 隐藏 租户管理/平台设置（角色值与后端一致）
- 开发代理：/api 直转 + /api/public 与 /static 携带租户 Host 改写（VITE_TENANT_PREVIEW_HOST），适配后端 TenantHostMiddleware
- 认证 API 为开发桩（角色调试开关），Task 3 对接真实登录

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 14:51:24 +08:00
浅念 0c25287c19 feat: 密钥掩码哨兵(__SET__)四处响应 + 站点管理权限放开租户管理员 
- config_routes: push.api_key/ai.api_key/email.smtp.password 掩码助手
  (MASKED="__SET__";非空才掩,空串/None 原样)。作用于 GET config、
  GET versions/{n}、POST rollback 响应、GET settings(计划四处),并盖
  PUT/reset/PUT settings 的写回显——哨兵还原后的库值不经任何响应外泄。
- PUT 哨兵还原: 密钥字段收到 __SET__ → 当前快照原值替换后再写版本
  (前端"不改就原样传回");传新值照常覆盖;空串传回仍=清空(既有语义
  不变)。settings 同款(密钥名含 key/password/secret,递归嵌套 dict;
  设置 key 本身命中也算)。库行/版本历史永远存原值。
- tenant_routes: 站点/域名四端点(POST sites/PATCH sites/POST domains/
  DELETE domains)require_super → _tenant_guard;租户生命周期三端点
  (POST /tenants/GET 列表/PATCH /tenants/{slug})保持超管专属。
- 测试: 掩码四处响应+落库分离断言(_current_snapshot 直查库)、哨兵
  往返/新值/清空/嵌套路径/未设还原 None、settings 标量+嵌套+非密钥
  字面量;租户管理员四端点自助(201/200)+他租户 403+生命周期仍 403。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:39:23 +08:00
浅念 0741069f49 docs: Phase 3 计划评审修复（掩码盖四处响应/权限端点计数与不动清单/推送探测端点/Task7拆四/增量瘦身/嵌入代码data-site/两版对比） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:26:38 +08:00
浅念 584bb24091 docs: Phase 3 实施计划（admin SPA 九任务，含掩码哨兵与站点权限两项前置决策） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:23:06 +08:00
浅念 6839cb94d2 fix: 终审修复——站点停用接线/prefix查重补创建reset/默认凭据警示+取舍补录 
- I-1 站点停用全链接线: Site 数据类加 status 字段; DB 源 _load_one 与
  文件源 read_tenant 均只输出 active 站点(停用站点域名不进 registry
  索引 → 该域名 404;全停用=合法运营状态输出空 sites;文件源无 status
  键默认 active 兼容)。E2E: PATCH 站点 disabled → 其域名 404、复启用
  恢复;源级直测两源过滤。
- I-3 prefix 跨租户查重补两口: db.other_push_prefixes 共用助手
  (MAX(version) 逐租户当前前缀,排除自身);创建向导(出厂档案前缀被占
  → 400 提示改 blank/改占用方)与 reset push(重置回出厂撞车 → 400 提示
  走 PUT)接入;PUT 原有查重改用同一助手。rollback 维持豁免(历史不可变
  语义优先,取舍清单记档)。既有测试第二租户改 blank profile 避撞。
- I-4 默认凭据警示: lifespan 启动检测 ADMIN_PASSWORD 仍为 Settings 字段
  默认值(非硬编码第二份,防双源漂移)→ logger.warning 醒目提示;
  CLAUDE.md Phase 4 部署记档补 ADMIN_PASSWORD 生产要求。
- I-2/M-2 取舍补录: 密钥掩码未实现(GET config/settings 明文返回
  api_key/smtp 密码,Phase 3 前须定 __SET__ 哨兵方案);站点管理权限现为
  仅超管(Phase 3 对接时决策放开或改 spec);取舍清单第 2 条同步刷新
  (rollback 现为唯一豁免口)。

全量回归: 571 passed(基线 566 + 新增 5)。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:40:21 +08:00
浅念 6cd343e24a chore: Phase 2 收尾——平台层完成（审计+安全自查+文档+清理单） 
- 全量回归 566 passed（根目录与 tests/ 双跑一致），基线数字刷新（459→566）
- 零同步 IO 审计复查：app/ 无 requests/urllib/time.sleep/open，scrypt CPU 注记在案
- 安全自查全过：platform 层零 logger（凭据不进日志）、gitignore 覆盖实证
  （tenants/*.db* / platform.db* / data/）、登录限流在 /api/platform 豁免
  路径仍生效（豁免只跳过租户解析，测试钉位在）、上传目录不可执行
  （魔数+uuid 重命名，avatar 下发防路径穿透，content-type 按扩展名映射）
- CLAUDE.md：新增 Phase 2 完成状态（基线/审计/安全/平台层能力一览/
  admin API 速览）、Phase 2 沉淀取舍 10 项 + Phase 3 清理单（旧 12 项中
  #1#2#3 Task 10、#10 Task 7 已完成划除）、Phase 4 部署记档、
  Phase 3 计划编写注意（conftest 三坑 + db_source_app/super_client 夹具 +
  config_views 单入口 + stats 口径表）
- README：现状刷新至 Phase 2 收尾时点

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:21:10 +08:00
浅念 7d16ae6318 feat: 生产装配切换DbTenantSource + bootstrap脚本（超管/两租户幂等导入） 
- app/main.py: lifespan registry 装配按 env TENANT_SOURCE 切换（db|file，
  默认 db）——db 走 TenantRegistry(DbTenantSource(platform_engine)) +
  schema 就绪后 async load_all；file 回退旧 load_from_dir。空 platform.db
  冷启动不炸：显式预检 tenants 表（非捕 ValueError——坏数据同样抛
  ValueError，一揽子吞会把数据损坏静默成空平台），空表保持空注册表
  （域名全 404 直到 bootstrap 导入），清扫循环对空 runtimes() 安全。
  非法值在创建任何 engine 前显性炸。conftest 预置缝优先于 env 装配，
  既有 558 测试零改动全绿。
- scripts/bootstrap_platform.py: init（schema+超管，env/.env 凭据，空表
  才建）+ 出厂档案幂等导入（已存在 slug 跳过；FileTenantSource.read_tenant
  同构快照 → Tenant+sites+domains+版本1，版本走 write_config_version 单一
  路径；域名 _normalize_host 归一）。不建租户管理员——导入是存量迁移
  形态，租户管理员按需走后台创建向导补。CLI 照 extract_config.py 的
  argparse 风格（--db/--profiles/--seed）。
- tests/test_bootstrap_script.py: 幂等两遍零变化（行数/版本数逐项断言）、
  超管 env 凭据、未知档案显性炸、bootstrap→DbTenantSource→registry 两租户
  resolve 冒烟（jc 蓝/17 条/ai-kefu-jc，auto 橙/13 条/ai-kefu，es 覆盖层）、
  TENANT_SOURCE 三态装配（db 空/库冷启动、file 回退、非法值炸）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:05:42 +08:00
浅念 71e11c317f refactor: config_views 单入口 + 0语义统一 + FakeAI 收敛（清理单#1#2#3） 
- #3 六个消费视图 resolver 收拢 app/platform/config_views(单一定义点):
  resolve_email/push/ai_settings ← 各服务文件, resolve_contact_flags/
  context_seed_map ← conversation, name_to_region_extras ← manager
  __init__ 内联取值(or None 语义原样)——函数体逐字搬入,服务层 import 之,
  旧定义删;Phase 3 编辑器/试金石与该模块对接
- #2 限流 0 语义统一: conn_limiter.try_acquire 的 limit 与 chat_rest 的
  rate_limit_per_hour 取值同款——0 或负 = 回退出厂默认(与姊妹键一致),
  原 conn_limiter 0=全拒改为回退;chat_rest 取值抽 _resolve_rate_limit
  纯函数供锚定
- #1 FakeAI 收敛进 conftest(超集: extract/evaluate/eval_calls),四份拷贝
  删(test_lead_email_trigger/test_cc_integration/test_channel_hygiene/
  test_lead_push_wiring——计划记三份,grep 实有四份;push_wiring 经
  evaluate 参数注入原本地固定返回值,断言零改动)

全量 558 passed(554 + 新增 4: 单入口/内联等价/两处 0 语义)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:45:42 +08:00
浅念 acf5777ff2 feat: 统计API（卡片/漏斗/趋势/分布/推送健康，逐库聚合禁ATTACH） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:24:30 +08:00
浅念 ec55bc38ab feat: 数据视图API（会话/详情/推送日志/删除，租户scope强制） 
查询语义自 jc admin.py 移植,路由多租户化(/api/platform/tenants/{slug}/...):
- runtime 按 slug 取: registry.runtimes() 匹配 + ensure_ready(resolve 需域名,
  平台后台只有 slug);未懒建租户首次查询触发建库不炸
- 会话列表: ≥1 消息的会话、created_at 倒序、intent/site(client_info.site)/
  日期区间 from-to(边界含,to 日期-only 含全天)筛选,分页 page/page_size≤100,
  每行含意向/联系方式/email_sent/IP 归国(ip_service 复用);total 对筛选后
  集合计数(修 jc 旧缺陷: 其会话列表 total 不随 intent 变)
- 详情: 元数据+client_info+画像 chips(raw_info 去 _ 前缀键)+消息全量+意向块
- 删除: jc 原序逐表显式删,补齐 lead_push_logs(兑现 FK 声明的 CASCADE,
  免孤儿行);不存在 404
- push-logs: load_only 排除 request_payload 大列,payload_size(func.length
  服务端算)作省略标记;status/conversation_id 筛选
- 鉴权 _tenant_guard(slug): 他租户 403/未认证 401 有测试钉住;非法筛选值
  显性 400(jc 静默忽略)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:00:39 +08:00
浅念 a43c654337 feat: 头像上传（uuid重命名/魔数校验/2MB/配置版本管线）与三级解析链 
- POST /api/platform/tenants/{slug}/brand/avatar（require_tenant）：
  multipart 收文件，魔数判定类型（\x89PNG/\xff\xd8\xff/RIFF....WEBP，
  优先于扩展名——改后缀骗不过，存盘扩展名取自内容）、≤2MB（413，
  upload.size 预检免拷贝）、服务端 uuid4 重命名（原始文件名不参与
  路径），落 data/uploads/<slug>/（目录懒建，gitignore 已忽略）
- 走 Task 6 配置版本管线（复用 config_routes 内部 helper）：读当前
  快照 → brand 组只替换 avatar 字段 → validate_group →
  write_config_version(comment=头像上传) → registry_reload 热生效
- /api/public/avatar 三级解析链：uploads → seed 资产 → 静态兜底；
  Phase 1 文件名穿越防线（拒 / \ . ..）扩到 uploads 段
- registry.uploads_root：自 data_dir.parent 派生（生产=<repo>/data/
  uploads；测试注入 tmp data_dir 时自动落 tmp 内，隔离免污染）
- 新依赖 python-multipart（multipart 表单解析）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:35:41 +08:00
浅念 7502176190 feat: 配置API（分组校验管线/整份版本/回滚/重置出厂/试金石/平台设置） 
- config_validation.validate_group: 九组校验管线(类型/键 allowlist/数值
  范围/prompts 大小上限 50KB·100KB/wall 全量交 compile_wall/push.prefix
  跨租户查重 spec E1),错误清单中文带字段路径
- config_routes: GET/PUT config(整组替换原样入版本,MAX+1,热 reload)/
  reset(按 Tenant.profile 取出厂档案组)/versions 列表·详情/rollback
  (旧版复制为新版本,历史不可变)/wall/test 试金石(逐句判定,不落库
  不 bump)/settings 平台设置 CRUD(仅超管,resolver 接线归 Phase 3)
- db.write_config_version: 版本写入公共路径(创建向导与配置 API 单一
  事实源);Tenant 落 profile 列(重置出厂按它取对应档案)
- _profile_snapshot/_blankify 迁 tenant_source(两路由模块共用);
  db_source_app/super_client 夹具收拢 conftest(两测试文件共用)
- 测试: 519 → 537 全绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:07:40 +08:00
浅念 ec2e17d5e3 feat: 租户管理API（创建向导消费出厂档案/blank保留jc墙/域名/停用/slug不可变） 
POST /api/platform/tenants: profile ∈ {auto,jiancai,blank}——首版快照复用
FileTenantSource(seed).read_tenant(profile).snapshot(Task 4 审查指定);
blank=jiancai 档案 _blankify 去身份组但保留 wall/prompts(compile_wall/
PromptProvider 的硬要求)。建 Tenant+main 站点+版本1+租户管理员
(must_change_password=True),创建后 registry_reload(upsert)立即可用。

站点 CRUD(brand_overlay 整字典赋值,M-2a)/域名绑定解绑(全局唯一,
撞车 400 带现有归属)/PATCH 租户(name/status;slug 不可变 400;停用走
reload 路径 dispose 引擎)。列表/详情管理员概要显式挑字段,凭据永不外泄。
鉴权: 写操作+列表 require_super;GET 详情放宽 require_tenant(slug)。

测试: db_source_app 夹具(registry 用 DbTenantSource 生产形态指向临时
platform.db,跨循环纪律: 直查走独立 NullPool 连接),16 项全绿,全量 519。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:20:28 +08:00
浅念 1bd341c21a fix: 数据源审查小修（from_config 类型守卫/PROMPTS_KEYS 消重/契约措辞） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:05:09 +08:00
浅念 c7fd533320 feat: TenantSource 抽象——File源(测试/档案)与DB源(生产)，registry 数据源可切换+reload upsert 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 08:50:16 +08:00
浅念 386b5eb90a feat: /api/platform 豁免租户解析（认证守护） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 08:32:55 +08:00
浅念 c5e8dd6ded fix: 认证审查修复（角色依赖连锁409门/停用租户token取舍注记/公共面整理） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 08:29:01 +08:00
浅念 f49e8e92b1 feat: 平台认证（scrypt上移/内存token 8h/登录限流/改密/角色依赖/409语义） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 08:18:15 +08:00
浅念 bfcaba5c87 fix: platform.db 前瞻加固（bootstrap竞态/哈希版本化/json_valid CHECK/测试补空/凭据列警示） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 08:08:22 +08:00
浅念 2d62108c73 feat: platform.db 模型与超管引导（WAL/scrypt/幂等bootstrap） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 07:57:15 +08:00
浅念 d088264ca0 docs: Phase 2 计划复审修复（blank 出厂源=jiancai墙提示词/新租户管理员must_change/两处测试时点锚修正） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 07:44:35 +08:00
浅念 f5d4c74f53 docs: Phase 2 计划评审修复（挂载挪Task2/Site补brand_overlay列/reload upsert语义/重置出厂+平台设置CRUD归位） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 07:41:53 +08:00
浅念 fe9e767689 docs: Phase 2 实施计划（platform.db/认证/配置版本试金石/数据视图统计，12 任务） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 07:35:22 +08:00
浅念 9ad02a778f fix: 终审修复——墙执行侧接租户管道(端到端回归锁)+seed补email组+措辞与死依赖清理 
C-1(必须修): 墙的执行侧没接租户管道——runtime.compiled_wall 全库只有
AIService 的 $DEFLECTION_POOL 一处消费,conversation.py 执行侧全走模块级
DEFAULT_WALL(jiancai 出厂),auto 租户会话实际跑的是 jc 墙。修复:
- manager 构造时 self._wall = runtime.compiled_wall(与 AIService 同源);
- 6 处过滤调用(violates_boundary/no_contact_value/asks_contact 的句内
  与 pending 尾巴两路)、CC 墙模板/替换句、no_contact 收尾选择、
  pivot/deflection、兜底句、contact_ask 触发日志判定全部传 wall=self._wall;
- _build_context_reminder/_contact_completion_note/_cc_confirm_note/
  _cc_script/_cc_wall_template/_lang_note_for 加 wall=None 尾参
  (None = 模块级默认墙,旧测试直调语义不变;流式侧 _contact_completion_note
  双胞调用同传 wall,写回与注入不漂移);
- 模块级 DEFAULT_WALL 视图常量(BOUNDARY_TRIGGER_RE/_CC_*/_EMAIL_NOTE_* 等)
  保留——boundary_filter 出厂默认与旧测试锚定,boundary_filter 模块级
  DEFAULT_WALL 照旧,conversation 会话流内一律租户墙;
- 端到端回归锁 tests/test_wall_execution_tenant.py(两租户真 runtime +
  脚本化假 AI): jc 独有 [€£] pattern 句在 jiancai 拦截替换(收尾=jc
  pivots 池)/auto 放行逐字流出;同一邮箱违规句两租户各自精确收到自己
  no_contact["web"](12 hours vs replies fast!);contact_ask 提醒注入
  各自墙文案互不渗漏。已验证模拟旧 DEFAULT_WALL 行为时三测全败。

I-1: 两租户 seed 补 email 组(以 brand_values.json 实际值为准:
auto=notify_email 环境值,jiancai=品牌邮箱——其 notify_email 记录是
notify@example.com 占位): auto {sender_name: XYH, notify_emails:
[18339827479@163.com]}, jiancai {sender_name: HESUPIPE, notify_emails:
[hesu@hesuu.com]};seed 存裸名,From 头渲染时外层再包【】。补测
test_seed_tenants_ship_email_group: env NOTIFY_EMAIL patch 成异值证明
seed 槽胜出。

M-1/M-2: README/CLAUDE.md "platform.db 热加载"改为"文件级 registry_reload
热加载(Phase 2 升级为 platform.db)";requirements.txt 删 alembic
(全库零引用,grep 实证唯一命中即该行)。

M-3/M-4(挂账): CLAUDE.md Phase 2 清理单补两项——/health 分级健康
(Phase 4 部署批次)、PromptProvider.from_dir FileNotFoundError 带路径上下文。

全量回归: 463 passed(459 基线 + 4 新增),根目录与 tests/ 子目录同数。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 00:18:54 +08:00
浅念 0bf492c1e4 chore: Phase 1 收尾——引擎合并租户化完成（审计+清单核对+CLAUDE.md/清理单） 
- 全量回归 459 passed（根目录与 tests/ 子目录双跑一致）
- 零同步 IO 审计: requests/urllib/time.sleep 在 app/ 零命中; 唯一 HTTP
  出站点 lead_push _do_post 为 httpx.AsyncClient; glm 同步路径经
  executor/to_thread 下卸; 结论写入 CLAUDE.md
- spec §6.2 合并清单逐项核对全部在位（jc 六项/上游吸收/三不带），
  核对明细写入 CLAUDE.md Phase 1 完成状态段
- CLAUDE.md 新增 Phase 2 清理单（10 项挂账含出处）与 Phase 2 计划
  编写注意（conftest 跨循环纪律/夹具复用）；修正过时的 tests 目录描述
- README.md 扩为现状能力一览 + 本地跑法指向 CLAUDE.md

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 23:51:26 +08:00
浅念 3d6064dc14 docs: 上游吸收审查修补（注释纠偏/上游标点恢复/交叉引用闭合） 
- test_lead_push_cc: 两处"双钉"注释与模块头改为如实的跨文件互补分工
  (常量同源钉本文件,字节级措辞钉 test_lead_push_service.py /
  test_email_rendering.py)
- chat_rest: _server_ip/_merge_client_info docstring 与调用点注释恢复
  上游半角标点原文(逐字同步,便于将来 diff 式跟上游)
- chat.py WS 自报注释补 REST 侧交叉引用,闭合悬空不对称说明

全量回归 459 passed(不变)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 23:44:02 +08:00
浅念 d1aed8e722 feat: 吸收上游 7 个测试文件断言与 placeholder 配置化对齐 
上游 ai-kefu → phase1 吸收(Task 11 unit 12):
- 拷入 7 个测试文件,import/夹具按目标库重锚(app.engine.* / conftest
  async_db+build_jiancai_runtime / seed_profiles 提示词锚点)
- 补实现(同步自上游): chat_rest 服务端可信 IP(_server_ip/
  _merge_client_info,直连场景自报假 IP 不再原样落库);widget.js 与
  chat.js 的 data-placeholder 读取(叠加 Task 10 管道:data-* > brand >
  中性兜底,tests/test_placeholder_static.py 守卫)
- 断言重锚以 jc 主线为准: ev.contact_info 存裸号+等待尾注(e164 走
  _cc 派生)、source 值 fallback/customer_stated 口径、推送标注键
  号码补全说明、prompt 静态锚按租户(seed_profiles)双测
- 全量回归 459 passed(基线 421 + 吸收 38)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 23:19:02 +08:00
浅念 7697673a3b fix: 品牌下发审查修复（esc统一/语料中性化/穿越加固/反向断言动态化） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 22:52:08 +08:00
浅念 bbc7bc520e feat: brand 白名单下发(站点覆盖/租户头像/CORS) + widget/chat 客户端 key 租户化 + 会话站点标 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 22:26:15 +08:00
浅念 49e2b476f5 fix: 配置接线审查修复（push数值哨兵化/恒真测试修正/哨兵防漂移/种子映射消双路径） 
Important-1: push 数值字段(timeout/max_attempts/retry_backoff_base)
出厂默认改 None 哨兵(与 ai.model 同款),resolve_push_settings 对 None
回退 env——根治 truthy 出厂默认永久遮住 env 覆盖;恒真测试修正(env 数值
patch 成 7.5/5/2.0 与出厂区分)+租户显式数值优先断言;ai.provider 遮
env 的边界记入 docstring。Minor-2: 出厂 model 哨兵与 DEFAULT_CONFIG
一致性测试 + defaults.py 双源注释(model/rate_limit_per_hour)。
Minor-4: allowed_seed_keys → context_seed_map(返回映射,单一取值路径)。
Minor-6/7/3/8: WS 配置冻结时机注释/name_to_region 查表序注释改准确/
chat_rest limit 0 语义注释/resolver None 路径仅供测试注释。404 全绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 21:57:57 +08:00
浅念 32b582aac8 feat: 服务层配置接线——email/push/rate_limit/AI凭据/行为开关/映射表/种子键 
Task 9: 服务层对全局 settings 的业务引用清零,每个 DEFAULT_CONFIG 组
都有真实消费方。resolve_*_settings(email/push/ai)以空槽回退 env
(平台默认层);contact 行为开关/种子白名单/国名扩表/限流上限经
manager 的 runtime.config 接线。收口: lead_push session_factory 必填、
config.py 死代码清理、PromptProvider frozen、no_contact 视图直取、
AIService wall 参数定型 CompiledWall。403 测试全绿(389+14)。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 21:37:48 +08:00
浅念 8453d3cc56 test: conn_limiter 差异覆盖与导入清理 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 21:05:54 +08:00
浅念 54a65ed7da feat: WS 每 IP 并发连接上限（默认10，(租户,IP) 键，finally 释放） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 20:54:28 +08:00
浅念 fd0f49870c fix: Host中间件审查修复（本地开发文档/顺序守护测试/ws断连分支/夹具清理） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 20:47:01 +08:00
浅念 eaa5bf7e51 feat: Host 中间件租户路由（纯ASGI覆盖WS/未知404/停用503暂停页/health豁免） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 20:30:30 +08:00
浅念 1824bb1590 test: PromptProvider 审查修复（组装缝断言/占位符约定文档与glob守护/边界注记） 
- I-1: test_company_facts 捕获完整 prompt 的用例补话术池注入断言
  ("- EN:"/"- ZH:" 分组行在场)——守 AIService 组装缝,防 Task 9
  重接提示词线时静默丢池
- I-2: seed_profiles/README.md 落档 $DEFLECTION_POOL 占位符约定
  (缺失 = 话术池静默不注入);test_prompt_provider 占位符防漂移改
  glob 遍历 seed_profiles/*/prompts/system.md,第三租户自动纳管
  (空 glob 显性兜底,防假守护)
- Minor-1 注记: _format_deflection_pool docstring 记已知边界——条目
  含引号/换行暂不转义,Phase 2 编辑器批次处理
- Minor-5: test_provider_loads_from_tenant_dir 删恒真 or 侧,改单一
  明确断言;registry 加载期显性失败清单补 prompts 读取失败
  (FileNotFoundError 说明);conftest build_jiancai_runtime 注明
  data_dir 仅占位、从不 ensure_ready

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 20:16:40 +08:00
浅念 e34378257f feat: PromptProvider 化 + $DEFLECTION_POOL 单一事实源注入 + runtime 必填化 
- PromptProvider(app/engine/services/ai_service.py): 租户提示词四件套
  from_dir 加载;build_system 把 system.md 的 $DEFLECTION_POOL 占位符替换为
  wall.json deflections 话术池(按语言分组一行,EN/ZH/ES)再拼事实卡;
  extractor/evaluator 的 $existing_info/$messages/$profile/$recent_messages
  替换逻辑自 AIService 原样搬入(行为等价);删模块级 import 时读文件的
  PROMPTS_DIR 与四个常量,保留 DEFAULT_PROVIDER(jiancai 出厂,__file__ 锚定)
- 两租户 system.md「三类请求的处理」第2条的迂回话术枚举 → $DEFLECTION_POOL
  占位符(保留段落说明文字),话术只存 wall.json 一份,改一处两边同步变
- TenantRuntime 加 prompts 字段(加载期 from_dir(seed_dir/prompts));
  ConversationManager 的 runtime 转必填(keyword-only),默认 AIService 用
  runtime.prompts + compiled_wall.deflections 组装
- app/engine/prompts/ 删除(grep 无代码消费方,jiancai 出厂由
  seed_profiles/jiancai/prompts 承接);test_company_facts/
  test_system_prompt_dual_contact 的 cwd 相对路径改 Path(__file__) 锚定,
  test_extractor_evaluator_prompts 断言对象改 DEFAULT_PROVIDER(语义等价)
- 新增 tests/test_prompt_provider.py(14 用例): 加载/注入/格式/占位符防漂移/
  extractor-evaluator 组装/registry 接线/runtime 必填/池线过两墙

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 19:54:47 +08:00
浅念 20dddc151e fix: 装配切换审查修复（启动异常路径韧性/清扫隔离/文案与夹具卫生） 
- main.lifespan: 预热+清扫挪进 try,finally dispose_all 覆盖启动半途
  失败(幂等于更少引擎,堵 engine 泄漏);清扫循环体 per-tenant
  try/except + logger.exception 后继续——一个租户坏库不炸平台启动,
  resolve/load_from_dir 保持 fail-fast
- routes/runtime.py: RuntimeError 文案补 registry_reload dispose 旧
  runtime 成因;TenantRuntime 注解挪 TYPE_CHECKING(engine 包运行期
  零 import platform)
- conftest client: teardown 置空 app.state.registry(关残留窗);
  rmtree 先正常删,失败 warnings.warn 留痕后再 ignore_errors 兜底

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 19:37:51 +08:00
浅念 d041077bb6 feat: 装配切换——main/服务构造线/conftest 迁至 Registry（含默认租户过渡兜底） 
- main.py: 删全局 engine/async_session;lifespan 装配 TenantRegistry
  (seed_profiles → 仓库根 tenants/,路径锚定),预热默认租户 jiancai 挂
  app.state.default_runtime,逐 active 租户(库文件已存在)跑
  sweep_stale_pending,退出 dispose_all。app.state.registry 预置即沿用
  (测试注入缝)
- routes/runtime.py(过渡,Task 7 删): get_runtime——state.tenant 优先,
  缺省落 default_runtime;chat.py/chat_rest.py 全部改走它,消除
  main↔routes 循环依赖
- ConversationManager 构造线: 新增 runtime 可选参(持 session_factory/
  compiled_wall/config 引用;prompts 仍模块级,Task 6;业务接线 Task 9),
  fire_pending_pushes 随任务传 session_factory(后台写回派发租户的库)
- lead_push_service: 去 app.main import;写库入口显式收 session_factory,
  模块级 async_session=None 仅作测试注入兜底
- conftest: client 夹具 = 每测试独立 Registry(tmp data_dir)+ 真实
  lifespan 在 TestClient 循环内预热;删 _dispose_main_engine;
  async_db 保持 NullPool(跨 asyncio.run 循环安全,刻意不换 Registry 引擎)
- 测试仅动夹具/桩签名(断言零改动): wiring 桩补 session_factory 形参;
  history-404 用例改经真实 WS 路由造 widget 会话(引擎常驻连接绑定
  TestClient 循环,测试线程不得直开 session_factory)

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 19:15:46 +08:00
浅念 0c296ca1ba fix: Registry 审查修复（JSON定位/校验测试/竞态窗口/TenantDisabledError/路径锚定/seed_dir） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 18:54:30 +08:00
浅念 607baff83c feat: TenantRuntime/Registry——每租户懒建 engine(WAL/pool2)+文件加载器+站点解析 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 18:24:47 +08:00
浅念 f5f54383fc fix: 词表墙的四项审查修复（es 池降级/占位符白名单校验/键 allowlist/提取自检+防呆测试） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 18:05:55 +08:00
浅念 bc903a273e feat: 词表数据化——AST 提取脚本 + wall.json + 编译器 + boundary/conversation 数据源切换（等价回归全绿） 
- scripts/extract_config.py: AST 解析两老项目源码取常量(不 import 源模块),
  生成 seed_profiles/<slug>/{wall.json, brand_values.json, prompts/};幂等可重跑
- app/engine/wall_schema.py: compile_wall(json)→CompiledWall,坏结构/坏 regex
  编译期显性失败(WallConfigError 含字段路径)
- boundary_filter/conversation: 墙词表/话术数据源切换为 DEFAULT_WALL
  (jiancai 出厂 seed),函数逻辑不动、常量名保留为 wall 视图(既有测试零修改);
  wall 数据化新增 pivots/pivots_contact/zero_number/reask_patterns 字段
- 脆锚点迁移: test_inline_prohibitions 断言对象从 conversation.py 源码改为
  wall.json 数据文件,语义等价(唯一允许的测试修改)
- 回归: 322 既有全绿 + 10 新增 wall_schema 测试 = 332;提取脚本两遍无 diff

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 17:31:57 +08:00
浅念 8a16a2959b test: 钉住 deep_merge 的 None 替换与列表替换语义 + 只读约定注释 
- characterization：显式 None 整体替换且兄弟键保留默认（Task 9 回退契约依赖）；列表整体替换不与默认拼接
- DEFAULT_CONFIG 与 TenantConfig.data/Site.brand 补只读约定注释
- platform 包依赖章程改明确：defaults/tenant_config 为叶子模块供 engine 反向消费，registry 组装层可 import app/engine

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:59:31 +08:00
浅念 89339868db feat: 出厂默认与快照深合并（E4 配置演进） 
- app/platform/defaults.py：DEFAULT_CONFIG（spec §5.1 九组，brand/wall 待 Task 4 填充）+ deep_merge（补缺/不动入参/兄弟保留）
- app/platform/tenant_config.py：TenantConfig/Site frozen dataclass；site.brand 以租户级 data["brand"] 为合并基线，租户自定义可被站点继承
- tests/test_config_merge.py：merge 三性质 + 站点覆盖/继承/无 sites 共 5 用例

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:44:49 +08:00