English · 中文
Mega 是第一代 Monorepo 平台；Mega2 是面向 Agent 的第二代引擎，重点提供 Monorepo 引擎与可选的 Agent Session Capture。Agent 场景推荐组合使用 Mega2、ScorpioFS 和 Libra：Mega2 托管 Monorepo 并提供会话捕获接口，ScorpioFS 将仓库挂载为本地文件系统，Libra 为 Agent 提供版本控制工作流和终端浏览入口。
Mega2 开源版不提供 Web UI。运行 libra mega2 browser --server <URL> 可打开 Libra 终端浏览器：它逐层浏览远程目录，支持创建、删除、移动、重命名目录，并可列出、创建和删除根 Tag；创建或删除需要写入凭据。该命令不替代 Git 客户端的 clone、fetch、push。
按你的任务从这里开始。快速开始和使用指南面向使用者；配置、部署和开发文档面向运维人员与贡献者。子系统契约和计划记录保留在各自目录中。
| 能力 | 说明 | 深入阅读 |
|---|---|---|
| Monorepo 引擎 | 托管代码目录与 Git 仓库；Git 客户端负责 clone、fetch、push，Libra browser 提供基础远程目录浏览和 Tag 操作。 | 使用指南 |
| Agent Session Capture | 可选 HTTP 能力，接收并查询 Agent 会话、事件、checkpoint、transcript 和文件操作记录；它与 Git push 是独立接口。需在 storage-only 部署中显式启用并配置 ingest token。 | Agent Capture 配置与接口 · 部署指南 |
LFS、OCI、构建产物、Vault、通知和配置等其他能力见进阶使用场景、使用指南及配置参考。
| 任务 | 文档 |
|---|---|
| 在本机启动 mega2 并完成首次推送 | 快速开始 |
| 查看仓库迁移、LFS、OCI、构建产物和数据持久化示例 | 进阶使用场景 |
| 了解 Git、HTTP API、Libra 和 CLI 操作 | 使用指南 |
| 任务 | 文档 |
|---|---|
| 查找配置来源、SecretRef、热加载和校验方式 | 配置参考；完整配置项见 ../config/config.toml |
| 部署或加固 trunk / storage-only 服务 | 部署指南；运行规则见 trunk 部署手册 |
| 配置授权或初始化 Monorepo 目录 | 认证与授权手册 · 初始化手册 |
| 任务 | 文档 |
|---|---|
| 本地构建、运行测试和启动集成测试服务 | 本地开发与测试 |
| 了解模块边界、数据存储和写入流程 | 架构设计 |
| 准备代码改动、运行提交门禁和新增模块 | 贡献指南；仓库约定见 ../AGENTS.md |
| 查阅错误类型和 HTTP 状态码的对应规则 | 错误模型 |
refactoring/README.md：配置、协议、存储、Vault、通知等子系统的契约和实现记录。部分文档记录了演进过程；涉及当前行为时，请以源码和配置为准。plan/：任务卡、路线图和计划模板。计划记录的是决策与工作安排，不代表当前实现状态。gap/：竞品差距分析与待办线索。- OOM / SIGKILL 排查记录：本机测试进程被终止时的诊断与监控方法。