Solon v3.10.0

安装或更新

</> markdown
2026年3月31日 下午12:49:05

1、如何安装（或更新升级）

系统要求

  • Java 8+（支持 Java 8 到 Java 26 环境，需要提前安装好）
  • 支持 macOS、Linux、Windows

安装命令

# Mac / Linux:
curl -fsSL https://solon.noear.org/soloncode/setup.sh | bash

# Windows (PowerShell):
irm https://solon.noear.org/soloncode/setup.ps1 | iex

安装目录结构

~/.soloncode/
+-- bin/                    # 可执行文件目录
|   +-- AGENTS.md           # 智能体定义（升级时保留）
|   +-- config.yml          # 配置文件（升级时保留）
|   +-- soloncode-cli.jar   # 核心程序
|   +-- soloncode           # Linux/macOS 启动脚本
|   +-- soloncode.ps1       # PowerShell 启动脚本
|   +-- uninstall.sh          # Linux/macOS 卸载脚本
|   +-- uninstall.ps1         # PowerShell 卸载脚本
+-- skills/                 # 全局技能目录

首次安装后配置

安装完成后，需修改配置文件 ~/.soloncode/bin/config.yml：

  1. 找到 chatModel 配置项
  2. 配置你的 AI 模型 API（支持 OpenAI、DeepSeek、通义千问等）
  3. 详细配置参考：《模型配置与请求选项》
soloncode:
  chatModel:
    apiUrl: "https://api.deepseek.com/v1/chat/completions"
    apiKey: "sk-xxxxxx"
    model: "deepseek-chat"
    timeout: "120s"

升级说明

重新执行安装命令即可升级：

  • config.yml 配置文件 自动保留
  • AGENTS.md 智能体定义 自动保留
  • 其他文件会被更新

2、如何卸载

Mac / Linux

sh ~/.soloncode/bin/uninstall.sh

Windows (PowerShell)

& "$HOME/.soloncode/bin/uninstall.ps1"

3、快速验证（以 mac 为例）

配置完成后，打开终端验证：