01
Evaluate.
先评测，再迭代
比较模型、Prompt 与候选版本。保留失败分类和原始结果，让每次变化都有可复核的基线。
评测不授予执行权 开源 · 开发验证阶段 查看最新验证记录 让 Agent 查询数据，
THE TRUST LAYER FOR DATA AGENTS
让 Agent 查询数据，
不必交出控制权。
模型负责提出候选。Forge 让访问有边界、执行可审核、结果有依据。
接入既有 Agent，而不是再迁移一套聊天工具。
FORGE / QUERY INSPECTOR示意 · 非实时服务
01 / EVALUATE
合成样例从可复核的候选开始。
candidate.sql SQL
1SELECT region,2 SUM(revenue) AS revenue3FROM demo.sales4GROUP BY region;候选、版本与预期结果可比较
Policy / Failure taxonomy可诊断
评测与执行分离。评测通过，不等于获得数据库执行权。
02 / ENFORCE
合成样例允许执行，是另一个决定。
- Principal
- demo-agent
- Resource scope
- demo.sales
- SQL / Policy revisions
- hash-bound
- Review
- 按授权范围决策
范围外拒绝；需要人审时，审批绑定实际查询。本示意不执行授权。
03 / EXPLAIN
合成样例一个结果，一条证据链。
regionrevenue
East128,400
West96,200
实际 SQLRegistry 版本审批链显式限制
合成结果，仅展示结构。完整 Evidence 也不证明业务语义正确。
候选 → 受控执行 → Evidence确定性校验 ≠ 开放世界正确性
WORKS WITH YOUR STACK
Direct SQL+Forge JSONOne governed path.你的 Agent你的数据库
VERIFICATION RECORD本地评估 · 2026.10.04
Python 回归1,011 passed另有 26 项 skipped
Pi Orchestrator212 passedTypeScript 检查通过
公开 Golden Path实际链路跑通 隔离合成数据
以上来自含未提交修改的本地工作树，不是当前公开提交、远端 CI 或部署认证。本轮官网改版未重跑上述测试。
尚未关闭
查看基准、历史结果与可比性边界 两项 P0 安全发布阻断、独立安全审核与外部采用门禁。当前不建议用于真实生产或共享多租户数据访问。
LOCAL FIRST. OPEN SOURCE.
先跑通一次。
再决定是否接入。
不填模型 Key，不连客户数据库。
用隔离的合成数据，亲手走过一次评测、批准与解释。
YOUR TERMINAL
git clone https://github.com/shisuidata/Forge
cd Forge
bash scripts/bootstrap-dev.sh
source .venv/bin/activate
forge quickstartA FEW GOOD QUESTIONS
开始之前，
把边界说清楚。
Forge 是另一个聊天机器人吗？
不是。Forge 位于既有 Agent 与数据库之间，提供生成后的评测、受控执行和证据。Web 工作台与 Pi 是消费者；外部 Agent 也可以独立接入 Forge。
必须让模型生成 Forge JSON 吗？
不必。Direct SQL 和 Forge JSON 是可替换的候选输入，共用 QueryRun 治理链路。Forge JSON 是可选的 Planner Adapter，不是产品边界；不同输入的语义校验强度也不完全相同。
Quickstart 会访问我的数据库或调用模型吗？
不会。公开 Quickstart 使用隔离的合成 SQLite 数据和真实本地 HTTP API，不需要 LLM、API Key、Pi 或已有数据库。默认会展示实际 SQL，等待你明确批准。
现在能直接接入生产吗？
不建议。当前仍是开发验证阶段，最新公开评估记录有两项未关闭的 P0 安全发布阻断；真实企业权限、共享多租户、独立安全审核与外部采用尚未验收。先阅读验证报告，再做隔离评估。