# 文档

从托管 Cloud 或本地 Solo 跑通第一个 SoyaOS Agent，并继续了解架构、SoyaPack、API 与 CLI。

- [能力与沙箱](https://soyaos.ai/zh/docs/capabilities-sandbox.md) — Comet 怎么强制一个 Agent 能做什么、不能做什么。
- [Solo 本地快速上手](https://soyaos.ai/zh/docs/quickstart.md) — 下载当前 SoyaOS 预览版，在本机运行内置 echo Agent。
- [SoyaPack v0 清单](https://soyaos.ai/zh/docs/soyapack-v0.md) — soyapack.yaml v0 清单参考——字段、能力、完整例子、常见坑。
- [从零写一个 Agent](https://soyaos.ai/zh/docs/writing-an-agent.md) — 搭一个多阶段 Agent——抓 URL、提要点、产出类型化产物。
- [联网选择微信公众号文章 Skill，并交付 HTML 报告](https://soyaos.ai/zh/docs/cloud-recipes/wechat-skill-research.md) — 用 SoyaOS Cloud、GitHub 实时搜索和确定性质量门禁，生成可追溯的 Skill 选型单文件 HTML。
- [CLI v0 参考](https://soyaos.ai/zh/docs/cli-v0.md) — soyaos 二进制在 v0 暴露的所有命令，含示例输出。
- [Cloud 快速上手](https://soyaos.ai/zh/docs/cloud-quickstart.md) — 五分钟登录 SoyaOS Cloud、创建 API Key，并跑通第一个托管 Agent 场景。
- [自托管 Moon（VPS）](https://soyaos.ai/zh/docs/self-host-moon.md) — 为团队拉起一个 cluster 版 Moon——仓库、鉴权、Comet。
- [虚拟模型与 BYOK](https://soyaos.ai/zh/docs/virtual-models.md) — soya:* 模型 ID 怎么解析；怎么把自己的 LLM Key 接进来。
- [用官方来源生成依赖升级决策报告](https://soyaos.ai/zh/docs/cloud-recipes/dependency-upgrade-advisor.md) — 实时核对 GitHub Release、CHANGELOG 与官方文档，用 SoyaOS Cloud 生成可追溯的依赖升级单文件 HTML。
- [架构](https://soyaos.ai/zh/docs/architecture.md) — Planet、Moon、Comet——组成每一种 SoyaOS 部署的三种节点角色。
- [HTTP API](https://soyaos.ai/zh/docs/http-api.md) — SoyaOS 的线协议——OpenAI 兼容的 chat completions 加 Scope 事件通道。
- [Scope 事件与可观测性](https://soyaos.ai/zh/docs/scope-events.md) — 每次 SoyaOS 运行都会发出的事件流，以及怎么消费它们。
- [签名与发布 SoyaPack](https://soyaos.ai/zh/docs/sign-and-publish.md) — 从笔记本上能跑的包，到 Moon 上签名、可审计、生产就绪的版本。
- [从结构化事实生成三语 Release Notes](https://soyaos.ai/zh/docs/cloud-recipes/multilingual-release-notes.md) — 用一个封闭事实源生成 zh、zh-hant、en 三份发布说明，并用不变量和 SHA-256 阻止事实漂移。
- [版本](https://soyaos.ai/zh/docs/editions.md) — 同一份二进制衍生出的六种部署形态——从 Solo 到 Enterprise Private。

---

Canonical HTML: https://soyaos.ai/zh/docs