10｜部署、适配与可运维性

本页保留早期架构、实验成绩与原文；正文中的“当前”“已解决”“生产就绪”仅指当时判断，不代表现行版本或安全认证。旧共享 API Key、pending/approve、v1 执行及原始 SQL 执行方式不得用作生产接入指南，也不要照此连接真实客户数据或公开服务。

当前产品是 Evaluate → Enforce → Explain Trust Runtime；公开源码的普通 Quickstart 使用 v1 合成演示。本地未提交 v2 候选才引入独立主体与有界授权、退休旧执行入口；不能将这些变更当成公开版本已发布能力。最新公开测试摘要仍记录 Direct SQL 授权检查与 Pi 跨主体事件去重隔离两项 P0 发布阻断，不提供后续修复认证。请以当前介绍、Quickstart和验证边界为准；旧实验仅在隔离合成环境中作为历史学习材料阅读。

部署、适配与可运维性

dev、PoC、prod 部署剖面

文字替代说明：开发环境可使用 Demo SQLite 和宽松设置；PoC 连接客户只读数据库并建立专属 Registry/测试集；生产增加 HTTPS、认证、持久化、只读副本、备份、监控、回滚和严格 readiness 门禁。

1. 三种剖面

剖面	目的	最低要求
dev	本地开发、教材实验	Demo 数据、测试 Provider 可选、`doctor dev` 可有 warn
PoC	客户域验证	客户只读库、客户 Registry、golden questions、审计、超时
prod	受控生产	认证/HTTPS、只读账号、持久化、备份、监控、回滚、prod doctor 无 fail

2. 部署组件

Reverse Proxy / HTTPS
  → FastAPI (Web Chat + Admin + API + Feishu webhook)
  → LLM/Embedding Provider
  → Registry files (read-only mount recommended)
  → Memory/Audit DB (persistent volume)
  → Customer DB read-only replica/account

仓库提供 Dockerfile、开发 docker-compose.yml、docker-compose.prod.yml 和 .env.production.example。生产 compose 是起点，不是客户网络、证书和灾备方案的全部。

3. 兼容性必须分层说

层级	问题
compile	Compiler 能否生成目标方言？
sync	能否 introspect schema 和枚举？
execute	Executor 能否连接、超时、限制并只读执行？
smoke_verified	是否在真实/CI 数据库跑过共同测试？
production_verified	是否有客户/生产交付证据？

当前建议：SQLite 适合 Demo/测试；PostgreSQL 是生产首选；MySQL/MariaDB 可用于 PoC并保留真实回归；BigQuery/Snowflake 主要有方言编译路径，sync/execute/dry-run/资源治理不能据此视为完整支持。

4. Provider 适配

Anthropic 和 OpenAI-compatible 接口在工具格式、named tool choice、strict JSON、timeout、错误体和 token 上限上可能不同。接入新 Provider 至少验证：

tool call 是否真的返回结构化参数；
动态 Schema 是否被执行而非忽略；
编译失败能否正常重试；
最大输出和超时是否足够；
API Key/套餐当前是否可用；
smoke 结果是否保存且不包含 secret。

python scripts/provider_smoke.py --json --out .forge/provider-smoke.json

5. Readiness 与 smoke

forge doctor --profile dev
forge doctor --profile poc --json
forge doctor --profile prod
FORGE_PROFILE=poc bash scripts/production-smoke.sh

doctor 检查配置；production smoke 串联 Provider、数据库、Registry 与服务路径。真实 Provider/数据库步骤受凭证和网络影响，文档不得把未运行写成通过。

6. 持久化与备份

至少保护：

Registry 与变更历史；
Memory/tenant 数据库；
Audit/Feedback；
客户 accuracy cases 与结果；
生产配置模板（不含 secret）。

目标 runbook 应定义：RPO/RTO、备份频率、恢复演练、schema migration、版本升级、回滚触发条件和审计保留期。

7. 监控建议

API/LLM/DB 延迟和错误率；
编译失败、lint retry、取消和 feedback 比例；
每租户 token 与数据库执行量；
timeout、row cap 命中和空结果；
Registry 变更与 accuracy 回归；
Provider 配额、限流和兼容漂移。

这些运维能力目前并未全部产品化，应作为正式标准化交付前的目标架构，而不是现状宣称。