G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/index.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# g2rain-bootstrap 工程文档
本仓库是 谷雨G2rain智能体平台的快速启动入口:用 Shell 与 Docker Compose 拉取已发布镜像,组装基础设施、平台服务与 Admin Shell;Agent、Knowledge、部门、会员、CMS 等业务片段按 BUSINESS_EXTENSIONS / --business 选择加载。
与 g2rain-deploy (opens new window) 的分工:本仓库承接已发布镜像的快速启动与生产部署,默认配置用于最低资源验证,生产前需调整资源、安全与数据保障;源码联调、镜像构建与更灵活的业务片段选择在 deploy。
# 导航
- 项目元数据
- 本地工程基线
- 架构与职责
- 部署拓扑
- 配置与合并模型
- 运行流程
- 差异与风险
- 命令参考
- 镜像拉取与后台准备
- 首次安装
- 启动、停止与更新
- 备份与回滚
- 安全、密钥与数据
- 本地开发
- Shell 与 Compose 约定
- 验证策略
- 完成标准
- Git 工作流
- 需求记录
- 架构决策
# 当前验证
2026-11-09 本次静态复核:
init-once.sh、start.sh、stop.sh、update.sh、compose-business.inc、config/generate-ssl.sh的 Bash 语法检查通过。- Docker Compose 成功解析基础编排(13 个服务)、默认 Agent+Knowledge(23 个服务),以及追加 department/member/cms 后的组合。
未启动容器,未验证运行时健康状态,也未执行安装、更新、停止或清理操作。静态检查不等同于部署验收;已知限制见差异与风险。