一条完整的交付路径
Git 是内容来源。平台校验固定提交，保存不可变版本，再通过渠道将完整快照交付给 Agent。
提交 Git → 流水线校验 → Skill 版本 → 发布快照 → Canary 验证 → Stable → Agent
构建成功不会自动上线；创建快照也不会修改渠道。只有推进渠道，跟随该渠道的客户端才会发现新版本。
从哪里开始
| 你想做什么 | 阅读指南 |
|---|---|
| 直接在平台创建 Git 仓库 | 托管 Git 指南 |
| 第一次操作平台 | 快速上手 |
| 理解版本、快照和渠道 | 核心概念 |
| 发布、更新或回滚 Skills | 发布与更新 |
| 配置扫描目录和校验规则 | 流水线配置 |
| 让 Agent 使用发布的内容 | 客户端与 Agent |
| 管理权限和凭据 | 权限与安全 |
| 部署、备份和排查问题 | 部署与排障 |
当前支持范围
管理端、Git 静态校验、不可变发布、Canary / Stable、Profile 授权和 Linux 只读 FUSE 挂载已实现。流水线不执行仓库脚本；原生 macOS / Windows 挂载属于后续里程碑。
这份手册描述当前实现。Agent 的内部上下文缓存与文件系统更新是两件事；切换文件版本后，仍可能需要重新加载 Skills 或开启新任务。
Python SDK
通过 SDK 接入自建 Agent：支持版本化发现、固定／动态视图与 Pydantic AI 集成。从 Python SDK 快速开始 阅读。