config.yml 配置详解

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

1、核心配置项

2、安全与行为配置

3、行为重试配置

4、CLI 控制台配置

5、工具权限配置选择（tools）

示例：限制危险操作

soloncode:
  tools: "*,read,edit"  # 仅公域工具 + 文件读写

6、上下文大小优化

影响上下文大小的因素：

优化建议：

• 大上下文模型（如 GPT-4-turbo）：调大 summaryWindowSize 和 summaryWindowToken
• 小上下文模型：调小这两个参数，更频繁地触发摘要压缩

7、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 可以参考：《支持哪些模型？及方言定制》。

8、完整配置示例

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

soloncode:
  # 核心配置
  tools: "**"
  maxSteps: 20
  autoRethink: true
  sessionWindowSize: 8
  summaryWindowSize: 15
  summaryWindowToken: 15000

  # 安全配置
  sandboxMode: true
  thinkPrinted: true
  hitlEnabled: false
  subagentEnabled: true

  # CLI 配置
  cliPrintSimplified: true
  
  # 技能池或只读文件池（可选）
  skillPools:
    "@shared": "/path/to/shared-skills"

  # 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"]