开始前
打开 管理控制台（管理端） 并登录。自建环境的管理员邮箱与密码由部署配置决定。本地首次启动方式见 部署指南。
如果列表里已有 enterprise-demo，可以直接使用其中的 sql-query 和 code-review。没有演示数据时，先按下一节接入自己的 Git 仓库。
1. 接入并同步仓库
进入 Git 仓库（管理端），添加仓库地址、凭据引用、默认 Ref（例如 refs/heads/main），并设置 Skill 根目录 skills。私有 Git 主机必须符合部署的允许列表和网络策略。
先测试连接，再执行同步。在 流水线（管理端） 查看结果；失败时按诊断中的文件、规则和行号修复，提交后重新同步。
2. 查看候选版本
进入 Skills Registry（管理端），确认名称、描述、来源提交和文件树。打开 SKILL.md，检查引用文件是否完整。
校验成功只说明候选内容已准备好，此时不会修改线上渠道。
3. 创建完整快照
进入 创建发布（管理端），检查从 Stable 继承的完整集合，勾选新增 Skills，并替换需要更新的版本。点击“预览完整视图”，审阅警告和影响范围，再创建不可变快照。
快照是完整集合，不是补丁。线上若包含 A、B、C，只更新 A 时也要选择 A 新版、B 原版和 C 原版。发布抽屉会默认继承 Stable 的完整集合；替换目标版本时保留其他 Skills，移除项会明确提示。
4. 先推进 Canary
进入 发布渠道（管理端），在 Canary 选择刚创建的快照，检查差异、填写原因并确认。记下快照 ID，验证通过后将同一个快照推进 Stable。
5. 连接测试 Agent
在 Agent Profiles（管理端） 创建测试 Profile：渠道 canary，选择允许访问的 Skills，模式 dynamic。再到 挂载终端（管理端） 注册客户端，保存仅展示一次的 Token。
按 客户端指南 在 Linux 挂载并接入 Agent。确认文件内容和预期行为后，再推进 Stable。
完成标准
- 流水线成功，Registry 中能看到预期提交的版本。
- Canary 指向新快照，Stable 在确认发布前保持不变。
- 测试客户端只能读取 Profile 授权的 Skills。
- 推进 Stable 后，dynamic 客户端的新文件打开看到新内容。
- 审计日志（管理端） 能找到本次发布记录。