本文档由 g2rain-appkit 的
# G2rain Appkit 文档
docs/index.md 自动同步生成。本目录记录 g2rain-appkit 作为 G2rain Supporting Library 的公共 API、架构边界、开发和发布规则。它不采用业务 App Profile；组织级角色和跨仓库契约以中央 平台共享库登记 (opens new window) 为准，本仓库维护实现、验证和接入细节。
# 当前状态
Theme/UI、HTTP 与 Platform Sub 已在 g2rain-member-app 完成真实 App 接入。2026-09-20 用户确认该试点已基本验证成功；Main Shell /main 接线、主子联合验收、Registry 发布及模板/CLI 推广仍未完成。权威状态见 project.yaml 与接入就绪清单。
# 阅读路径
- 项目事实：仓库身份、公共包、中央登记和验证状态。
- 总体架构、依赖关系与架构偏差。
- 公开契约与包设计。
- 本仓开发规范、完成定义；消费方见接入就绪清单。
- 运维与发布、故障排查及安全边界。
- 架构决策、需求状态和应用迁移。
# 专题入口
- Platform Main/Sub 方案
- 主题与微应用协作
- 接入手册：Main Shell、业务 App、就绪清单
- 中央 Main Shell 契约 (opens new window)：AI / 生成器实现主应用时的不变式与完成检查（与本仓接入手册分工）
- Main Shell AI Coding 提示词：可复制给助手的生成/改造提示词（派生自生成契约）
- 构建、制品与测试契约
- HTTP 与 Runtime 契约
- 平台数据组件与 Provider