跳到主要内容

快速开始

5 分钟内启动 Suzent。

1. 安装​

前提条件： Node.js 20+ 和 Git。

powershell -c "irm https://raw.githubusercontent.com/cyzus/suzent/main/scripts/setup.ps1 | iex"

安装脚本会自动安装 Suzent 及所有缺失的依赖项（Python/uv、Rust、构建工具等）。

2. 启动​

suzent start

此命令会启动后端并在浏览器中打开界面。默认地址为 http://localhost:25315。

3. 添加模型提供商​

界面打开后，进入 设置 → 提供商 配置 API 密钥。以下是最常用的三个提供商：

获取密钥： platform.openai.com/api-keys → 创建新密钥（以 sk-... 开头）

在设置中，将密钥粘贴到 OpenAI → API Key，启用所需模型，然后点击 保存 → 验证。

使用 DeepSeek、Grok、OpenRouter、Ollama 或其他提供商？请查看完整的提供商参考。

4. 开始对话​

在聊天窗口的模型选择器中选择一个模型，发送第一条消息即可。

就这样。 记忆系统、工具和自动化功能开箱即用。

故障排查​

"找不到命令：suzent" ——安装后重启终端以刷新 PATH。若仍无效，查看安装脚本输出，按提示手动添加脚本目录到 PATH。

"系统健康检查失败"

suzent doctor

启动时端口冲突 —— suzent start 会检测冲突并询问是否终止占用进程，输入 y 继续。

更新

suzent upgrade

后续步骤​