G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/development/git-workflow.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# Git 工作流
- 每个提交聚焦一个部署行为或一个清晰的配置治理事项。
- 修改前检查工作区,保留用户已有配置与变更。
- 不提交
.env、运行日志、数据卷内容、ssl/或新生成的私钥。 - Compose 服务变化应同时评审主文件、业务片段、Nginx 配置与文档导航。
- 合并前执行静态验证;涉及真实部署时先在隔离环境演练。
- 版本升级记录镜像 digest 与迁移/回滚要求,避免只使用不可追溯的
latest。