open source field manual / 001

把一个长期运行的仓库，变成一张可读的地图。

SparkWork 是本地优先的桌面 AI Agent 工作台。这份手册说明它如何启动、如何执行一轮 Agent 任务，以及贡献者从哪里开始修改而不踩穿边界。

start here

三条入口，三种阅读任务。

面向第一次看仓库的贡献者、正在排期的维护者，以及需要快速定位发布问题的人。

从 Electron main/preload/renderer 到 Agent runtime、SQLite 和 spark-engine，建立系统边界。

进入架构页 →

Issue、Project、PR、审查、验证和许可证的最短路径，避免把讨论和交付混在一起。

进入治理页 →

CI、桌面端、CLI、自有官网与 GitHub Pages 是五条不同链路，各自有自己的失败边界。

查看发布矩阵 →

runtime at a glance

RendererReact UI
queue · plan · review

MainElectron
IPC · files · Git

Runtimesession · engine
tools · policy

StorageSQLite/WAL
events · repos

Engineturn machine
CLI · serve

工程手册的边界

这里记录当前已经存在的架构和运维约定。产品功能、下载、版本中心和用户操作文档仍由自有官网提供；GitHub Wiki 负责快速导航，不替代代码旁的详细设计。