G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/development/local-development.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# 本地开发
文档和脚本开发可在不连接 Docker Engine 的情况下完成大部分静态检查。推荐在 Linux 或兼容 Bash 环境验证脚本行为,并解析合并后的 Compose 配置。
bash -n pull.sh init-once.sh start.sh stop.sh update.sh compose-business.inc
bash -n config/generate-ssl.sh
docker compose --env-file .env.example -f docker-compose.yml config
docker compose --env-file .env.example \
-f docker-compose.yml \
-f business.d/g2rain-agent.yml \
-f business.d/g2rain-knowledge.yml \
config
docker compose --env-file .env.example \
-f docker-compose.yml \
-f business.d/g2rain-agent.yml \
-f business.d/g2rain-knowledge.yml \
-f business.d/g2rain-department.yml \
-f business.d/g2rain-member.yml \
-f business.d/g2rain-cms.yml \
config
不要为了测试脚本而在开发者的默认 Docker Context 中执行真实 up、down、prune 或破坏性 down -v。源码联调与本地镜像构建请使用 g2rain-deploy (opens new window)。