config.yml 配置详解

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

1、核心配置项

2、安全与行为配置

3、行为重试配置

4、CLI 控制台配置

5、Web 服务配置（可选）

6、ACP 协议配置（可选，IDE 集成）

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

示例：限制危险操作

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

8、上下文大小优化

影响上下文大小的因素：

优化建议：

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

9、models 模型配置

支持所有主流大模型 API：

soloncode:
  models:
    - apiUrl: "https://api.deepseek.com/v1/chat/completions" #这里要用完整地址（不是 baseUrl）
      apiKey: "sk-xxxxxx"
      model: "deepseek-chat"
      description: "适合简单的聊天对话" #描述适用场景
      timeout: "300s"

详细配置参考：《模型配置与请求选项》

10、完整配置示例

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

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

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

  # CLI 配置
  cliPrintSimplified: true

  # Web 服务（可选）
  webEndpoint: "/cli"

  # ACP 协议（IDE 集成）
  acpTransport: "websocket"
  acpEndpoint: "/acp"
  
  
  # 技能池或只读文件池（可选）
  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"]