G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的 docs/development/conventions.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。
当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# Shell 与 Compose 约定
  • Shell 使用 Bash,并保持 set -euo pipefail 兼容。
  • 所有路径基于脚本所在仓库根解析,避免依赖调用者当前目录。
  • 仅支持 Docker Compose V2(docker compose)。
  • 业务片段选择集中在 compose-business.inc;新增片段须同步 business.d/README.md、.env.example 与工程文档。
  • --business 为追加语义,并与 BUSINESS_EXTENSIONS 去重合并。
  • G2rain 组件镜像使用固定版本标签;禁止默认引入 latest。
  • 资源、端口、卷、健康检查的变更必须同步 docs/ 与 README.md。
  • 清理、覆盖、生成密钥、删除数据卷均属于显式授权操作,必须有清晰提示。
  • 示例配置只提供占位用途;演示私钥不得被当作生产材料。
Last Updated: 2026-11-15T15:06:20.852Z