> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

YEARNING V4 · AI AGENTIC SQL 审核平台

公测版本 · PUBLIC BETA

# AI Agentic 驱动的
新一代 SQL 审核平台

以自主探测表结构与执行计划的 AI Agentic 审核引擎为核心，集成数据库 AI 助手、多阶段冻结审批、进程内 gh-ost 与跨引擎自动回滚，让 SQL 从编写、审核到上线一气呵成。

[3 分钟体验公测版](/guide/quick-start)[AI Agentic 预审](/features/ai-precheck)[数据库 AI 助手](/features/ai-assistant)

`git clone --single-branch --branch v4 https://github.com/cookieY/Yearning.git && cd Yearning && docker compose up -d`复制

公测提示

Yearning v4.0 当前处于 **公测阶段（Public Beta）**，功能与细节仍在持续迭代打磨中。建议优先在测试或预发环境试用验证，正式接入生产前务必做好数据备份。 [前往 GitHub Issues 反馈建议 →](https://github.com/cookieY/Yearning/issues)

AI 探测与内置规则5 项工具 · 48 条规则单工单批量上限100,000 条 · 32 MiB冻结审批链路1..N 阶段 · 1..10 级无 Binlog 回滚上限100,000 行事务前像

## Yearning 4.0 六大核心能力

基于 Go 模块化单体、React 19 与 PostgreSQL 彻底重构，围绕「AI Agentic 自主审核 + 数据库 AI 助手 + 冻结审批执行 + 跨引擎回滚与诊断」打造完整 SQL 变更闭环。

4.0 CORE · AGENTIC REVIEW5 probes · 48 rules

### AI Agentic 自主探测 SQL 审核引擎

告别静态正则死规则：AI 在审核回路中自主调用 5 项只读元数据工具（查表/列/索引/统计信息/安全 EXPLAIN），结合 48 条内置规则、自定义技能与团队经验库完成最高 100,000 条批量预审，支持云端脱敏与内网本地模型双轨接入。

[查看 AI 预审与 48 条规则实战 →](/features/ai-precheck)

4.0 CORE · AI ASSISTANTNL-to-SQL · AST Verified

### 受控数据库 AI 助手（咨询 · 写 SQL · 优化）

常驻工作台右下角，基于真实授权元数据提供平台使用咨询、自然语言生成 SELECT/DML/DDL 与慢 SQL 改写优化；方言 AST 校验把关、缺必填列主动追问，两阶段直连正式预审提单，绝不越权执行。

[阅读数据库 AI 助手实战指南 →](/features/ai-assistant)

GOVERNANCE1..N stages · 18 gh-ost params

### 冻结式多阶段审批与进程内 gh-ost

提交瞬间冻结规则、阶段、审批人与执行人（含 admin 均不可越权）；内嵌 Go 进程内 gh-ost 在线改表（18 项参数可覆写，退役 pt-osc），带水印 SQL Reveal 与断网 result_unknown 人工核验。

[查看审批与 gh-ost 调优手册 →](/features/change-orders)

RECOVERY0 Binlog/WAL · 100k rows

### 跨引擎无 Binlog/WAL 自动 SQL 回滚

无需开启 Binlog 或 WAL 逻辑复制，MySQL 与 PostgreSQL 同事务采集最多 100,000 行前像（超限自动回滚正向事务）及 DDL/gh-ost 逆向快照，AES-256-GCM 加密并一键派生受治理回滚工单。

[查看自动回滚与派生工单实战 →](/features/sql-rollback)

DATA ACCESSServer Masking · SSE Lock

### 受控只读查询与服务端敏感列脱敏

限时 Query Grant 审批、方言只读 AST 拦截写与加锁读、敏感列在离开服务端前即完成脱敏、6 小时 HMAC 游标分页与受控导出，撤销授权经 SSE 毫秒级锁定前端查询台。

[查看只读查询与脱敏指南 →](/features/query-workspace)

OBSERVABILITY & AGENT6 Charts · SKILL.md

### 6 图 Top SQL 性能诊断与 Agent Skill

复用只读连接池采集 performance_schema / pg_stat_statements，6 图联动 + Brush 框选毛刺 + 四段式 AI 根因报告一键建索引工单；内置零依赖 skills/yearning 直连 /api/v4/*。

[查看性能诊断与 Agent 集成 →](/features/sql-diagnostics)

## 实景体验 AI Agentic 审核与治理流水线

AI Agent 自主探测元数据并综合风险证据，结构化契约掌控每一次门禁、审批、执行租约与回滚闭环。点选下方五个典型场景查看真实处理轨迹。

01AI Agentic 预审02数据库 AI 助手03内网 SAN 原生轨道04进程内 gh-ost 改表05无 Binlog 自动回滚

自主元数据探测 · 48 条规则5 项只读工具 · PlanHash 已绑定 · 云端 default / 内网 san 双轨隐私

提交前，AI Agent 自主调用 5 项只读元数据工具探测真实表结构、索引与执行计划，结合 48 条内置规则与团队经验输出结构化阻断结论；调用公有云模型时在内存中自动完成脱敏与零泄漏断言。

1. 1词法解析与双指纹折叠

Canonical + Dialect 双指纹将同构语句合并为 1 组（单单上限 100,000 语句 / 1,000 组）
1. 25 项只读元数据工具自主探测

AI Agent 自动调用 list_indexes + safe_explain 实证 WHERE 列缺失索引、触发 482 万行全表扫描
1. 3内置规则 + 自定义技能联合裁决

结合 48 条内置规则、自定义技能与团队经验库评估风险；公有云轨道自动完成内存脱敏与零泄漏断言
1. 4确定性门禁阻断与授权还原

规则命中自动归为 Critical 阻断提交（大模型自由建议封顶 Medium 防误杀），为授权人还原真实表列名

提交的原始 SQLSQL

````
UPDATE billing.orders
SET amount_cents = 99900, remark = 'vip-promo-q4'
WHERE customer_phone = '13800138000'
  AND status = 'pending';
````

Yearning v4 治理流水线处理

双指纹折叠 + 只读探测证据（云端自动内存脱敏）VERIFIED

````
-- Step 1: Dual fingerprint collapses 1,240 homologous stmts -> 1 review group
-- Step 2: AI Agent autonomous read-only metadata tool calls:
-> get_table_schema(table_1)     => 14 cols, PK(id), est_rows = 4,820,000
-> list_indexes(table_1)         => idx_status_created(status, created_at)
-> safe_explain(UPDATE table_1)  => type=ALL, key=NULL, rows=4,820,000
-- Step 3: Cloud default track strips literals/identifiers (AssertZeroLeak=PASS)
````

2008 REVIEW_BLOCKED_BY_RISK

门禁阻断：billing.orders.customer_phone 无索引且影响行数超过 max_affect_rows 阈值，必须修正后重跑预审。

## 面向 DBA 与研发团队的真实工作台

全面告别旧版 Vue 与 RPC 依赖，基于 React 19 与 shadcn/ui 重构，内置实时 SSE 状态推送、水印 SQL Reveal 与 6 图联动性能诊断。

个人工作台与系统健康/workspace聚合待审批、待执行、30 日执行成功率与 6 组件实时健康灯，并内置右下角受控数据库 AI 助手。

AI Agentic SQL 预审门禁/changes/new最高 100,000 语句 / 32 MiB 批量导入，AI 自主探测真实元数据并结合 48 条内置规则输出风险发现与建议。

冻结工单详情与执行控制台/changes/orders/:id展示提交时冻结的多阶段审批快照、带水印 SQL Reveal 开关、进程内 gh-ost 进度与一键派生回滚工单。

受控只读查询与敏感脱敏/query基于限时 Query Grant 与只读 AST 校验，服务端自动脱敏敏感列，支持流式游标分页与 CSV/JSONL 导出。

多引擎治理与管理后台/admin/datasources统一配置 MySQL / PG / TiDB / OceanBase / PolarDB 数据源、审批流、审核技能、AI 预算、OIDC/LDAPS 与通知规则。

![个人工作台与系统健康](/screenshots/dashboard-zh-CN-dark.png)

/workspaceYearning v4 1440p 真实界面实拍（自动跟随当前站点明暗主题与语言切换）

## 按角色快速直达：从部署落地到日常使用

直接拿走可复制的部署编排、Nginx SSE 反代配置、目标库最小权限建权 SQL 与研发/DBA 实操步骤。

01

### 安装部署与升级

- [Docker Compose 一键部署 + Nginx SSE 反代配置](/guide/quick-start)
- [单二进制 + 独立 PG 三角色授权 + systemd 托管](/operations/binary-deploy)
- [Kubernetes 5 份 Secret 准备与多副本滚动发布](/operations/kubernetes)
- [Yearning v3 → v4 停机迁移与 SecretKey 重加密](/operations/migration-v3-to-v4)

02

### 管理员 15 分钟初始化

- [首次登录 6 步初始化清单（避坑 1001 报错）](/admin/first-time-setup)
- [MySQL / PostgreSQL 最小权限账号建权 SQL](/admin/datasources-and-grants)
- [公有云/内网 vLLM 接入与 48 条内置审核规则](/admin/review-engine)
- [AD/OpenLDAP、OIDC 回调与钉钉/飞书自定义模板](/admin/governance)

03

### 研发与 DBA 日常使用

- [提单、大批量 .sql 导入与处理 2008 阻断](/features/ai-precheck)
- [数据库 AI 助手：自然语言写 SQL 与两阶段提单](/features/ai-assistant)
- [审批、18 项 gh-ost 调优与断网人工核验 SOP](/features/change-orders)
- [开启回滚保护与一键派生回滚工单实操](/features/sql-rollback)
- [开启慢 SQL 诊断、6 图下钻与 AI 根因报告](/features/sql-diagnostics)

04

### 安全合规、排障与集成

- [企业级安全架构：防泄露 · 零侵入 · 抗幻觉](/guide/security-and-ai-trust)
- [admin 锁死重置密码命令与全量环境变量表](/operations/cli-and-config)
- [启动报错速查与 10xx–70xx 业务错误码表](/reference/error-codes)
- [接入 Claude/Codex Skill 与 curl 调 API 示例](/integration/agent-skill-openapi)

## 五大数据库引擎矩阵，一套治理基线

统一分离只读（预审/查询）与读写（执行）凭据，全量经 AES-256-GCM AEAD 加密存储并强制校验 TLS 证书。

| 数据库引擎 | 兼容模式 | AI 预审 | 安全执行 | 进程内 gh-ost | 自动回滚 | 受控查询 | 性能诊断数据源 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| MySQL 5.7 / 8.0 | 原生 MySQL | 支持 | 支持 | 原生内嵌 | 支持 | 支持 | performance_schema |
| PostgreSQL 14 – 18 | 原生 PostgreSQL | 支持 | 支持 | N/A | 支持 | 支持 | pg_stat_statements |
| TiDB | MySQL 兼容模式 | 支持 | 支持 | N/A | 支持 | 支持 | performance_schema |
| OceanBase | MySQL 兼容模式 | 支持 | 支持 | N/A | 支持 | 支持 | MySQL Digest |
| PolarDB | MySQL & PG 模式 | 支持 | 支持 | N/A | 支持 | 支持 | Native Digest |

## 无状态 Go 单体，原生拥抱外部 AI Agent

彻底移除 RPC 与本地 Pod 状态，依托 PostgreSQL 实现 Kubernetes 多副本水平扩展。内置 OpenAPI v4、实时 SSE 事件总线与零依赖 yearning Agent Skill，让 Claude Code、Codex、Antigravity 等助手在严格门禁下直接协作。

Web UI / AgentReact 19 · SKILL.mdGo Control PlaneAST · Agentic AITarget ClustersMySQL · PG · TiDBPostgreSQL Meta3 Roles · AEAD KeyringAI Providersdefault vs san LANOutbox & SSEAudit · IM · Events

[阅读 AI Agent Skill 与 OpenAPI 集成指南 →](/integration/agent-skill-openapi)[查看 6 图联动 SQL 性能诊断与根因报告 →](/features/sql-diagnostics)

skills/yearning/scripts/yearning_api.py复制

````
export YEARNING_BASE_URL="http://localhost:8080"
export YEARNING_USERNAME="admin"
export YEARNING_PASSWORD_FILE="/path/to/password"

# Discover granted change flows & run AI Agentic precheck
python3 skills/yearning/scripts/yearning_api.py flows
python3 skills/yearning/scripts/yearning_api.py precheck \
  --flow-id <flow_id> \
  --sql "ALTER TABLE demo.users ADD COLUMN status VARCHAR(32) NOT NULL DEFAULT 'active';"
````

零外部依赖（Python 3 标准库）CSRF · Idempotency-Key · If-Match

## 面向生产落地的企业级安全与 AI 可信保障

让企业放心将 AI Agentic 引入核心数据库流程：防泄露、零侵入、抗幻觉与平台加密全部通过 Go 运行时硬契约强制落地。

[阅读完整安全与 AI 防护白皮书 →](/guide/security-and-ai-trust)

防数据泄露

### 字面值剥离 · 单轮内存脱敏 · 本地模型零出网

公有云 default 轨剥离字面值并在单次请求内存完成表列名匿名化，经 AssertZeroLeak 失败关闭（2005/6003）；内网 vLLM/Ollama 独立走 san 轨零字节出网且严禁明文回退。

AI 零侵入

### 只读元数据 · 不查业务行 · 无审批执行权

AI 预审仅限 5 项只读元数据探测；AI 助手连 SELECT/EXPLAIN 都不执行；诊断绝不改参数或动用执行凭据。所有 AI 建议均须经过正式预审与冻结审批，AI 绝不越权执行。

抗 AI 幻觉

### 确定性规则兜底 · 自由建议封顶 · AST 二次验真

48 条规则与运行时无效 SQL 确定性 Critical 阻断，模型自由观察封顶 Medium 防止幻觉误杀；元数据缺失强制 partial 阻断，AI 助手 SQL 须经方言 AST 验真（6004）且缺必填列只追问不捏造。

平台纵深加固

### 六用途 AEAD · 三角色隔离 · 水印审计

6 用途 AES-256-GCM 密钥环绑定 AAD 防密文替换、元库三角色与目标库读写分离、Argon2id 与仅本机 TTY 重置 admin、LDAPS/OIDC PKCE、水印 SQL Reveal 与 90 天不可篡改审计日志。

## 三分钟部署体验 v4 公测版

公测版本

支持 Docker Compose、Linux 单二进制与 Kubernetes 多副本部署；当前为公测版本，建议先在测试 / 预发环境验证。

Docker ComposeKubernetesv3 升级迁移

````
git clone --single-branch --branch v4 https://github.com/cookieY/Yearning.git
cd Yearning
docker compose up -d
# Open http://<host-ip>:8080  (admin / Yearning@2026!)
````

复制

[查看部署手册](/guide/quick-start)[从 v3 升级迁移](/operations/migration-v3-to-v4)[提交公测反馈](https://github.com/cookieY/Yearning/issues)

v4.0 Public Beta · AGPL-3.0-or-later · Go 1.25 · React 19 · PostgreSQL 14–18

