应用入口
这部分收纳 Sage 的主要使用和启动入口。先看这一组文档，可以快速判断应该从 CLI、示例服务、主服务端，还是桌面端进入。
当前文档
- 快速开始 — 克隆、一键脚本、公共配置
- Web 应用 — 前后端、手动启动、Docker Compose 全栈
- 桌面应用 — 安装包、macOS/Windows 首次打开、从源码构建
- CLI 使用指南
- TUI 使用指南
- Chrome 扩展 — 加载未打包、连接本地服务
该选哪个入口
CLI
当你需要最快的开发测试入口、提示词迭代或运行时诊断时，使用 sage run、sage chat 和 sage doctor。
Terminal TUI
当你希望在同一套本地 Sage runtime 之上获得终端优先的交互体验，尤其是会话恢复、slash 命令和 transcript 浏览时，使用 sage-terminal。
Streamlit 演示
当你想快速看一个轻量演示 UI，而不想启动完整应用服务端时，使用 examples/sage_demo.py。
主服务端 + Web UI
当你需要主要的多用户应用栈时，使用 app/server/main.py 配合 app/server/web/：
- 认证
- 智能体管理
- 工具与技能管理
- 知识库集成
- 可观察性接口
- 浏览器聊天体验
桌面应用
当你需要带本地后端和 UI 壳层的打包应用时，使用 app/desktop/entry.py 与桌面源码树。
Web 应用结构
app/server/main.py：FastAPI 应用创建与启动app/server/routers/：HTTP 路由分组app/server/services/：应用服务层app/server/web/src/：Vue 应用源码
如何选择
- 想快速验证：优先 CLI
- 想体验主产品：优先服务端 + Web
- 想交付桌面安装包：进入桌面构建链路