SSparkWorkgithub operations
operations / contribution loop

让 Issue 有去处,让发布有边界。

事实源:docs/operations/github-governance.md · 最后核对 2026-09-22

从问题到交付

Issue可复现缺陷
功能建议
维护任务
Inboxtriage
补齐上下文
确认安全边界
PlannedPriority
Area
验收条件
PR分支
验证
审查
Done合并
发布
文档核对

Project 设计

资源 约定
Status Inbox → Planned → In Progress → In Review → Blocked → Done
Priority P0 紧急、P1 近期、P2 常规、P3 以后
Area Runtime、Desktop、Website、Docs、Operations、Release
Views Delivery Board、Roadmap Table、Needs Triage

打开 SparkWork · Open Source Roadmap →。项目板只追踪可交付的 Issue/PR,不预先堆积无法验证的愿望清单;设计事实回到仓库 docs,讨论性内容放 Discussions。

五条发布链

CI

类型、lint、文件大小、Spark engine 和包级验证。

打开 CI →

桌面 / CLI

桌面安装包走 GitHub Release;CLI 制品走 spark-cli-releases 分支。

查看 Releases →

官网 / Pages

官网走 Docker 与自有服务器;Pages 只部署 docs-site 工程手册。

查看 Actions →

GitHub Pages 合同

源文件在主仓库,artifact 只来自 docs-site。

Pages 使用相对链接,适配项目页的 /spark-agent/ 路径;不读取发布 secrets,不参与桌面/CLI/官网部署。若内容错误,回滚文档提交并重跑部署即可。

维护节奏

每次 PR

  • 补齐验证命令和风险
  • 架构/计划文档更新状态行
  • Pages 入口文件仍可构建
  • 不公开凭据和私有数据

每季度

  • 核对 docs 与代码
  • 检查 Wiki、Pages、README 链接
  • 复核 Project 字段和视图
  • 检查 workflow action 版本

阅读完整发布与 Pages 运维文档 →