config.yml 手动配置详解

SolonCode 安装后，配置文件位于 ~/.soloncode/config.yml。

config.yml 是 SolonCode 的基础配置文件。用户级路径为 ~/.soloncode/config.yml，工作区路径为 .soloncode/config.yml。配置内容应放在 soloncode: 节下。

1、最小可用配置

soloncode:
  models:
    - name: "deepseek"
      apiUrl: "https://api.deepseek.com/v1/chat/completions"
      apiKey: "sk-xxxxxx"
      model: "deepseek-chat"
      timeout: "180s"

2、核心配置项

工具权限配置选择（for: tools、disallowedTools）

3、安全与执行配置

4、MCP Gateway、OpenAPI Gateway、LSP 配置与开关

MCP 配置

soloncode:
  mcpServers:
    memory:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-memory"]
    gitee:
      type: "streamable"
      url: "https://api.gitee.com/mcp"
      headers:
        Authorization: "Bearer xxx"

OpenAPI / REST API 配置

soloncode:
  apiServers:
    user-service:
      docUrl: "https://api.example.com/openapi.json"
      apiBaseUrl: "https://api.example.com"
      headers:
        Authorization: "Bearer xxx"

LSP 配置

soloncode:
  lspServers:
    java:
      command: ["jdtls"]
      extensions: [".java"]
    typescript:
      command: ["typescript-language-server", "--stdio"]
      extensions: [".ts", ".tsx", ".js", ".jsx"]

当前源码已内置了 Java、TypeScript、Go、Python、Rust、C/C++、C#、Ruby、PHP、Bash、Lua、Dart、Swift、Kotlin、YAML 等默认 LSP 模板，但默认不启用，需要在 Web 设置页或配置中开启并确保本机已安装对应语言服务器。

5、models 模型配置

支持所有主流大模型 API（注意 apiUrl 是全地址，不是 baseUrl）：

soloncode:
  models:
    - name: "bigmodel-glm5.1" #名字（管理用）。可选
      description: "Bigmodel coding plan（更新更强些）" #描述（管理和 llm 选的对参考用）。可选
      apiUrl: "https://open.bigmodel.cn/api/anthropic/v1/messages"
      apiKey: "***"
      model: "GLM-5.1"
      timeout: "300s"
      userAgent: "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; SolonCode/1.0; +https://solon.noear.org/)"
    - name: "aliyun-kimi2.5"
      description: "Aliyun coding plan（适合简单任务）"
      apiUrl: "https://coding.dashscope.aliyuncs.com/v1/chat/completions"
      apiKey: "***"
      model: "kimi-2.5"
      timeout: "300s"
      userAgent: "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; SolonCode/1.0; +https://solon.noear.org/)"

详细配置参考：《模型配置与请求选项》。关于 apiUrl 可以参考：《支持哪些模型？及方言定制》。

7、完整配置示例

solon.logging.appender:
  console:
    enable: false  # 控制台日志（启用会干扰 CLI）
  file:
    level: DEBUG

soloncode:
  # 核心配置
  tools: "**"
  # disallowedTools: "bash"
  maxTurns: 20
  autoRethink: true
  sessionWindowSize: 8
  summaryWindowSize: 40
  summaryWindowToken: 60_000

  # 安全与执行配置
  sandboxMode: true
  hitlEnabled: false
  subagentEnabled: true
  memoryEnabled: true
  memoryIsolation: false
  mcpEnabled: true
  openApiEnabled: true
  lspEnabled: true

  # CLI 配置
  cliPrintSimplified: true

  # AI 模型配置
  modelRetries: 3
  models:
    - apiUrl: "https://api.deepseek.com/v1/chat/completions"
      apiKey: "sk-xxxxxx"
      model: "deepseek-chat"
      timeout: "120s"

  # REST API 接入（可选）
  apiRetries: 3
  apiServers:
    api1:
      docUrl: "https://api.example.com/openapi.json"
      apiBaseUrl: "https://api.example.com"
      headers: { Authorization: "Bearer xxx" }

  # MCP 服务接入（可选）
  mcpRetries: 3
  mcpServers:
    memory:
      command: "npx"
      args: [ "-y", "@modelcontextprotocol/server-memory" ]
      
  # LSP 服务接入（可选）
  lspServers:
    java:
      command: ["jdtls", "-data", ".solon/lsp/java-workspace"]
      extensions: [".java"]
    typescript:
      command: ["typescript-language-server", "--stdio"]
      extensions: [".ts", ".tsx", ".js", ".jsx"]
    go:
      command: ["gopls"]
      extensions: [".go"]
    python:
      command: ["pylsp"]
      extensions: [".py"]