# Yearning v4 Beta
> Yearning v4 公测版官方文档 · 基于 AI Agentic 的新一代企业级 SQL 审核平台
## Others
- [开源许可与安全策略](/about/license.md): Yearning 自 2017 年起坚持开源维护至今,致力于为研发与 DBA 团队提供安全可控的 SQL 审核与数据库变更治理能力。
- [数据源接入与目标库建权 SQL](/admin/datasources-and-grants.md): Yearning v4 严格分离 只读凭据(审核/查询/性能诊断) 与 执行凭据(变更落库)。在后台 /admin/datasources 添加数据库前,请先在目标数据库实例上按最小权限原则创建专用账号。
- [首次登录 15 分钟初始化教程](/admin/first-time-setup.md): 服务启动后,访问 http://<你的地址>:8080 并使用内置超级管理员 admin 登录。 很多初次使用 Yearning v4 的管理员容易卡在配置顺序上(例如直接去建变更流程却因为还没有规则集而报错 1001)。请严格按照下面 6 步依赖顺序 操作,15 分钟即可让整个研发团队跑通第一笔工单和第一条只读查询。
- [流程编排、权限组、LDAP/OIDC SSO 与通知中心](/admin/governance.md): 本指南覆盖团队协作上线所需的四大配置:审批与查询流程编排、企业级单点登录(Active Directory / OpenLDAP / OIDC)、执行窗口与系统设置,以及四渠道自定义通知模板。
- [AI Provider、48 条内置审核规则与内部经验库](/admin/review-engine.md): 本手册指导管理员完成 AI 模型接入(公有云与内网私有化双轨)、单日费用预算控制、48 条内置审核技能选配,以及 自定义 Prompt 技能与内部 DBA 经验库 的编写。
- [数据库 AI 助手实战指南(4.0 核心特性)](/features/ai-assistant.md): 数据库 AI 助手(Database AI Assistant) 是 Yearning v4.0 推出的核心增效能力:它以右下角悬浮入口(dots-02 图标,亦支持独立页 /assistant)常驻工作台,严格聚焦在 「平台使用咨询」「基于真实元数据的自然语言生成 SQL」「SQL 分析与优化」 三项数据库任务上。 与通用聊天机器人不同,Yearning AI 助手在架构层面贯彻 零泄漏单轮内存脱敏、方言 AST 结构化还原、零直接执行 SQL、强制衔接正式 AI 预审与审批门禁 四条硬边界,让研发既能用自然语言秒出合规 SQL,又不突破生产数据安全红线。
- [提单、大批量导入与 AI 预审实战](/features/ai-precheck.md): 本手册面向研发工程师,带你一步步完成一次标准的 DDL/DML 变更工单提交、大批量 .sql 文件导入、看懂 AI 预审报告与处理门禁阻断。
- [审批、执行、gh-ost 调优与 result_unknown 核验](/features/change-orders.md): 本手册面向审批人(Team Lead / DBA)与执行人,详细说明工单审批、水印查看 SQL、手动/预约执行、MySQL 进程内 gh-ost 18 项参数调优以及断网异常的人工核验流程。
- [受控只读查询、脱敏与流式导出](/features/query-workspace.md): 本手册面向研发、测试与数据分析人员,介绍如何在不接触数据库明文账号的情况下,通过 /query 安全查询生产只读数据并按权导出。
- [Top SQL 性能诊断实战(管理员 /admin/diagnostics)](/features/sql-diagnostics.md): SQL 性能诊断是 Yearning v4.0 面向 DBA 与管理员打造的无侵入慢 SQL 治理闭环。它严格复用数据源已配置的 只读 query/review 连接池,绝不回退读写执行凭据、绝不自动安装数据库扩展、不修改统计配置、不重置计数器,也不对生产库执行 EXPLAIN ANALYZE。
- [回滚保护与一键派生回滚工单实战](/features/sql-rollback.md): Yearning v4 的自动回滚彻底摆脱了对 MySQL Binlog 抓取与 PostgreSQL WAL 逻辑复制的依赖,支持在 MySQL 族与 PostgreSQL 族 上通过「事务内前像采集 + AST 逆向生成」实现受治理回滚。
- [架构设计与隐私流水线](/guide/architecture.md): Yearning v4 在底层放弃了多进程 RPC 耦合与本地状态假设,采用 无状态 Go 模块化单体 + PostgreSQL 共享协调 架构,保证在高并发审批、批量预审与 Kubernetes 多副本部署下的一致性与零泄漏边界。
- [Docker Compose 部署与 Nginx 反向代理](/guide/quick-start.md): 本指南面向希望在 3 分钟内拉起完整 Yearning v4 公测环境的团队,同时包含健康检查、Nginx HTTPS + SSE 反代配置、数据卷备份与无损升级的完整命令。
- [企业级安全与 AI 可信架构(防泄露 · 零侵入 · 抗幻觉)](/guide/security-and-ai-trust.md): 对企业用户而言,引入 AI 管理生产数据库最核心的三个顾虑是:① 生产数据和表结构会不会泄露给大模型?② AI 会不会越权改库或绕过审批?③ 大模型产生幻觉乱报或胡写 SQL 怎么办? Yearning v4 从底层架构而不是提示词口号上回答了这三个问题,并配套完整的纵深防御体系。
- [Yearning v4 概览与演进](/guide/what-is-yearning.md): Yearning v4 是基于 AI Agentic 架构彻底重构的新一代开源 SQL 审核与数据库变更治理平台。 v4 基于单二进制 Go 模块化单体后端、React 19 + TypeScript + shadcn/ui 前端工作台与 PostgreSQL 元数据库构建,彻底移除旧版 RPC 服务与 MySQL 元库依赖,以自主探测表结构与执行计划的 AI Agentic 审核引擎为核心,为研发、DBA 与 AI Coding Agent 提供从写 SQL、预审到审批执行与回滚的完整闭环。
- [AI Agent Skill 与 OpenAPI v4 实战](/integration/agent-skill-openapi.md): Yearning v4 既可以通过零依赖的 yearning Agent Skill 直接接入 Claude Code、Codex CLI、Cursor、Antigravity 等 AI 编程助手(无需额外搭建 MCP Server),也可以通过标准 HTTP API 集成到企业 CI/CD 发布流水线。
- [二进制与独立 PostgreSQL 手动部署](/operations/binary-deploy.md): 如果你的生产环境已有高可用 PostgreSQL 集群(云 RDS / Patroni / 自建主从),不希望通过 Docker Compose 运行内置数据库,可以采用单二进制 yearning + systemd 方式直接部署。
- [CLI 命令、管理员密码重置与环境变量参考](/operations/cli-and-config.md): Yearning v4 编译为单二进制文件 yearning,配置优先级严格固定为: 内置默认值 < YAML 配置文件 (--config) < YEARNING_* 环境变量
- [Kubernetes 生产多副本部署](/operations/kubernetes.md): Yearning v4 是完全无状态的 Go 控制面,所有会话、单库执行排他租约、定时预约与多副本 SSE 实时广播均通过 PostgreSQL 协调,不依赖本地持久化卷。 仓库在 backend/deploy/k8s/ 提供三份生产清单: control-plane.yaml:至少 2 副本 Deployment(maxUnavailable: 0)、PDB、Service、UID 10001 非 root 只读容器migration-workloads.yaml:一次性 Schema 迁移 Job(yearning-schema-migration)与迁移窗口审查 Deployment(yearning-migration-review)network-policy.yaml:最小权限集群出入站 NetworkPolicy
- [从 Yearning v3 停机迁移实战](/operations/migration-v3-to-v4.md): Yearning v4 将元数据库从旧版 MySQL 迁移为全新 PostgreSQL 领域模型。为彻底杜绝双写漂移与权限误映射,v4 采用 停机迁移 → Dry-Run → 管理员人工确认映射 → Apply → 全量核验 的显式流程。
- [4 位业务错误码与高频排障手册](/reference/error-codes.md): 本页前半部分汇总部署启动期最常见报错,后半部分提供 /api/v4/* 全量 8 个号段(10xx–70xx)业务错误码排障表。