M4 收口：神识用户面与计量闭环——BYOK/配额三段式/usage 落库/Anthropic+Gemini 适配器/神识阁

- 神识 Go：store 双实现（PG 自动建表+60s 就绪重试 / 内存回退）承载 usage_logs·byok_keys·quota_balances；BYOK 密钥库（AES-GCM 加密、API 脱敏、撤回即失效、主密钥未配置 fail-closed）；配额三段式（预扣 max_tokens 钳位 1M→结算实际 token→全败幂等退款，HJ-2004）；计量归属（IR user_id→usage_logs，/me/usage 用户维度聚合+配额总览，/admin/usage/sample 对账抽样）；Anthropic/Gemini 出站适配器（SSE 解析、system 提升、用量映射）；stub 端点补名修复计量空 endpoint
- IR 契约：user_id/byok_key_id 双端同步（Go types.go + Py types.py）
- 灵台：runs.owner_id（迁移 005，server_default 兼容存量）经 kernel 全链透传为 IR user_id；shenshi_client 扩展用户面方法（X-Hunjing-User-Id 代理，Echo 桩带内存实现）；/me/byok-keys 登记·列表·撤回与 /me/usage 端点（4 用例）
- 前端神识阁（/models 重建）：偏好（生成参数表单）/自带密钥（登记加密保存、脱敏列表、撤回二次确认）/用量（聚合表+配额进度条）三区；me API 库+mock+5 用例；侧栏恢复入口
- 配置与部署：.env.example 增 SHENSHI_DATABASE_URL/SHENSHI_BYOK_MASTER_KEY/SHENSHI_USER_BUDGET_TOKENS；compose 神识容器接自有库（init-shenshi.sql 预建 hunjing_shenshi，与灵台不共库共表）
- 证据：Go 34 用例（BYOK 独占/配额拒绝/结算退款/归属聚合）、后端 532、前端 210、BFF 4 全绿；跨进程 E2E 四场景（灵台 HttpShenshiClient→真 Go 神识：登记脱敏/BYOK 独占不可达整体失败/用量归属聚合/撤回即失效）通过；rewrite-plan M4 标记完成、能力矩阵神识行升已验证

docker/README.md

@@ -55,7 +55,7 @@
    cp .env.example .env
    ```
 
-   重点修改：`POSTGRES_PASSWORD`、`SHENSHI_ENDPOINTS`（神识模型端点目录，JSON 数组，示例见 `.env.example`）。若使用 NebulaGraph，确认 `GRAPH_DB_TYPE=nebulagraph`。
+   重点修改：`POSTGRES_PASSWORD`、`SHENSHI_ENDPOINTS`（神识模型端点目录，JSON 数组，示例见 `.env.example`）、`SHENSHI_BYOK_MASTER_KEY`（启用 BYOK，可选）。神识自有库 `hunjing_shenshi` 由 `docker/postgres/init-shenshi.sql` 首次初始化时自动创建。若使用 NebulaGraph，确认 `GRAPH_DB_TYPE=nebulagraph`。
 
 2. 应用层的 `environment` 会自动覆盖容器网络服务发现地址（如 `POSTGRES_HOST=hunjing-postgres`），无需手动改 `.env` 里的 `127.0.0.1`。
 

docker/docker-compose.app.yml

@@ -73,8 +73,10 @@ services:
         limits: { memory: 1G }
         reservations: { memory: 256M }
 
-  # ============================== 神识 · 模型网关（Go，rewrite/1.0 M0） ==============================
-  # 灵台唯一模型出口：IR 入站 → 适配器（当前 stub，云 Provider/元炁按 M4 接入）→ SSE 出站。
+  # ============================== 神识 · 模型网关（Go，rewrite/1.0 M4） ==============================
+  # 灵台唯一模型出口：IR 入站 → 适配器（openai_compatible/anthropic/gemini/local/stub）→ SSE 出站。
+  # 计量/BYOK/配额：SHENSHI_DATABASE_URL 指向独立库（与灵台不共库共表，需在 PG 预建
+  # hunjing_shenshi database；未配置时进程内存储，重启即失）。
   # 鉴权：SHENSHI_SERVICE_TOKEN 经 env_file 注入；未配置时开发档放行。
   hunjing-shenshi:
     build:
@@ -88,6 +90,7 @@ services:
       - ../.env
     environment:
       SHENSHI_PORT: "8080"
+      SHENSHI_DATABASE_URL: postgresql://hunjing:${POSTGRES_PASSWORD:-change-me}@hunjing-postgres:5432/hunjing_shenshi
     deploy:
       resources:
         limits: { memory: 256M }

docker/docker-compose.infra.yml

@@ -51,6 +51,7 @@ services:
       TZ: ${TIMEZONE:-Asia/Shanghai}
     volumes:
       - hunjing-pg-data:/var/lib/postgresql/data
+      - ./postgres/init-shenshi.sql:/docker-entrypoint-initdb.d/10-init-shenshi.sql:ro
     ports:
       - "${POSTGRES_PORT:-5432}:5432"
     healthcheck:

docker/postgres/init-shenshi.sql

@@ -0,0 +1,3 @@
+-- 神识自有库（与灵台主库 hunjing 不共库共表，shenshi-gateway.md §3）
+-- PG 官方镜像首次初始化时执行；已存在的库不受影响。
+CREATE DATABASE hunjing_shenshi;