G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的 docs/architecture/deviations.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。
当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:工程设计、实施或验证记录。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# 差异与风险

# 已确认差异

  • 中央 G2rain 目录已登记本项目为生产部署入口,但未发布部署编排类正式 Profile,当前使用本地基线。默认最低资源验证预设不代表生产容量基线。
  • 与 g2rain-deploy (opens new window) 相比:无源码构建映射、无 Compose V1 并行栈;update.sh 可追加 Compose 服务名做局部 up,但不含按 services.conf 拉代码构建;提供轻量 init-once.sh(不含 codes 克隆与业务构建);--business 为追加语义,不是“仅加载列出片段”。
  • g2rain-admin-shell 内置于基础编排,而不是独立业务片段。
  • 业务片段全部由配置选择;脚本不写死默认扩展。CMS 启用前需确认 GHCR 镜像可拉取。
  • .env.example 含固定的数据库、Redis、Nacos、Milvus 示例凭据;生产环境直接沿用会形成安全风险。
  • Git 当前跟踪多个 config/g2rain-*/keys/ 下命名为私钥的 PEM/DER 文件。它们必须视为不可信的演示材料。
  • 默认资源档为单请求 Demo 最低配置,冷启动与文档解析会较慢,不适合并发或生产。
  • 中央目录列有按目标生成部署方案的职责,但当前脚本只提供固定编排生命周期入口,未见独立方案生成命令;该职责的交付范围仍需后续需求明确。
  • 2026-11-08 以 Git for Windows Bash 复核,config/generate_key.sh 语法检查通过,替代 2026-11-07 的历史失败记录;未执行实际密钥生成或验证轮换流程。

# 未验证项

  • 未实际启动容器或验证健康检查、端口、服务发现、登录及前端访问。
  • 未验证真实安装、更新、停止、备份或回滚流程。
  • 未验证 Linux 发行版、文件权限、SELinux、防火墙和生产 Docker/Compose 版本兼容性。
  • 未验证数据卷升级、数据库重复初始化和跨版本迁移。
  • 未验证 Docling HF 模型预置、离线模式与镜像派生构建在目标主机上的端到端结果。
Last Updated: 2026-11-15T15:06:20.846Z