- ① 后端删除 app/ai_provider/(38 文件,含 anthropic/openai 格式、billing、audio、embedding)、services/ai_provider_admin.py、core/config/model_config.py、tests/ai_provider/(21 文件) - ② 连带退役 application/agent/(旧 Agent 循环/steer/follow-up/确认注册表)、application/skill_executor.py、app/skills/(python skills 孤儿)、endpoints/audio.py、application/imports.py(ProviderManager 消费方);settings 端点收敛为生成偏好 - ③ runs.py 修剪:AgentRunRegistry/steer/follow-up/confirmations 端点退役,保留 list/get/events/cancel/stream;safety 确认改为直接落库裁决(pending→approved/denied) - ④ 前端删除:models 页、ModelGatewayView、gateway.ts、GatewayPanel(玄关)、ModelGatewayPanel/ModelStrategyForm、audio.ts/useVoiceInput、网关类型与 mock;设置页收敛为外观/语言/通知 - ⑤ 配置收敛:config/models|providers|pricing.example.yaml 归档 shenshi/config/;.env.example 删 provider keys/MODEL_ENDPOINT_POOL/MODEL_CONFIG_PATH,收敛 SHENSHI_* - ⑥ 验收:rg 审计灵台 Provider SDK import 与 ai_provider 引用归零;后端 528 passed(2 个预存失败经 HEAD 复跑验证与本手术无关)、前端 type-check+201 passed、神识 go vet+test、BFF 4 passed
神识 · 魂镜模型网关(hunjing-shenshi / Shenshi)
文化命名「神识」(契约词典 §2.1):统一模型能力——Provider/Endpoint 接入、能力槽位、协议转换、路由、流式、BYOK、配额与成本。神识不拥有人物状态。
当前状态(rewrite/1.0 M4a)
- 数据面
POST /v1/chat/completions:IR 入站 → 候选路由 → SSE 出站;首帧到达前不提交响应,失败可整体切道并返回 JSON 错误(HJ-2001),已写出字节后不换道、如实 error 终帧; - 适配器:
openai_compatible(云厂商兼容面与元炁本地端点共用此协议)与stub回声桩(未配置端点时兜底); - 端点配置:环境
SHENSHI_ENDPOINTS(JSON 数组,字段 type/name/base_url/api_key/model/priority),示例见.env.example; - 故障策略(shenshi-gateway.md §4):候选按 Priority 升序 + 粘性会话置首 + 冷却端点排尾兜底;首字超时(默认 10s)切道;401/403 凭证级冷却 10 分钟,429/5xx/超时仅冷却该端点绑定 30 秒;
- 计量(M4a):每次尝试一条 stdout JSON 日志(
kind=shenshi_usage)+ 进程内聚合,GET /me/usage返回按 模型×端点 的请求数/成功数/token;生产 PG 落库与 BYOK 归属随 M4b; - 健康面
GET /healthzGET /readyz;服务令牌SHENSHI_SERVICE_TOKEN(开发档可空)。
目录结构
shenshi/
main.go # 入口:配置与路由装配
internal/ir/types.go # IR 请求/增量(与灵台 app/shenshi_client/types.py 对齐)
internal/transform/ # 出站适配器(Adaptor 接口 + stub)
internal/route/registry.go # 槽位 → 端点候选注册表
internal/relay/sse.go # SSE 帧写出(X-Accel-Buffering: no)
internal/server/ # HTTP 服务与测试
本地运行
统一经根目录 Makefile:
make dev-shenshi # SHENSHI_PORT=8080
make vet-shenshi # go vet
make test-shenshi # go test ./...
# 灵台侧联调配置(根目录 .env):SHENSHI_BASE_URL=http://127.0.0.1:8080
测试
go vet ./... && go test ./...