settings.json 与 Web 设置页

settings.json 是 Web 设置页持久化配置的主要文件。它适合管理模型、MCP、OpenAPI、LSP、挂载、供应商、通用开关等结构化配置。

1、保存位置与作用域

启动时先读取用户级，再读取工作区级。工作区配置会覆盖或补充用户级配置。

2、通用设置

对应字段：general。可配置项主要包括：

会话与压缩

• sessionWindowSize - 会话窗口大小（新指令使用几条历史消息）
• summaryWindowSize - 压缩触发消息数
• summaryWindowToken - 压缩触发 token 阈值
• summaryModel - 指定压缩使用的模型

安全与沙盒

• sandboxMode - 沙盒模式（安全隔离）
• sandboxAllowUserHome - 沙盒允许访问用户主目录
• sandboxSystemRestrict - 沙盒使用系统接口限制

记忆

• memoryEnabled - 是否启用记忆
• memoryIsolation - 记忆是否工作区隔离

重试

• apiRetries - API 重试次数
• mcpRetries - MCP 重试次数
• modelRetries - 模型重试次数

功能开关

• bashAsyncEnabled - 是否启用异步 bash
• mcpEnabled - 是否启用 MCP
• openApiEnabled - 是否启用 OpenAPI
• lspEnabled - 是否启用 LSP
• goalsEnabled - 是否启用 Goal 长任务模式
• subagentEnabled - 是否启用子代理模式
• hitlEnabled - 是否启用人工审核危险操作
• autoRethink - 是否允许自我反思重试

执行限制

• maxTurns - 单任务最大执行回合数
• userAgent - HTTP 请求标识（User-Agent）

控制台

• cliThinkPrinted - 控制台是否打印内心思考
• cliPrintSimplified - 控制台是否简化打印

Web 安全

• webAuthUser - Web 登录页认证用户名（留空则不启用）
• webAuthPass - Web 登录页认证密码

日志

• logLevel - 日志级别（TRACE/DEBUG/INFO/WARN/ERROR）
• logFileMaxSize - 日志文件大小限制（如 "10MB"）
• logMaxHistory - 日志存档保留天数

保存后，Web 设置页会尽量实时写入运行中的引擎，不一定需要重启。

3、权限与安全

对应字段：permission。可配置项：

• allowedTools - 允许的工具列表（白名单模式）
• disallowedTools - 禁止的工具列表（黑名单模式）

4、供应商管理

对应字段：providers。用于管理大模型供应商的统一配置，包括 API 地址、密钥等。在 Web 设置页中可新增、修改、启用/停用供应商。

5、大语言模型

对应字段：models。主要支持：

• 新增、删除、更新模型。
• 启用或停用模型。
• 测试模型连接。
• 设置作用域：全局或工作区。
• 保存后同步刷新对话区模型列表。

6、挂载

对应字段：mountPools。挂载用于把外部目录作为 Skills、Agents 或普通资源池暴露给 SolonCode。主要字段：

• alias：别名，通常以 @ 开头。
• type：挂载类型，如 SKILLS、AGENTS。
• path：目录路径。
• primary：是否作为主要池（即是否系统内置）。
• enabled：是否启用。
• writeable：是否允许写入。
• scope：user 或 workspace。

7、技能市场

Web 设置页内置技能市场入口，可浏览、查看详情并安装 Skills。当前源码包含以下市场适配：

• Clawhub（clawhub.ai，默认启用）
• Skillhub（api.skillhub.cn，默认启用）
• Skills.sh（skills.sh，HTML 爬取，当前默认未启用）

安装时可以选择安装到不同技能池。支持重新安装（达到更新升级效果）。

8、MCP 服务器

对应字段：mcpServers。支持：

• 新增、更新、删除 MCP Server。
• 启用或停用。
• 连接检测。
• 查看服务暴露的工具。
• 保存禁用工具配置，控制可调用范围。
• 传输协议支持：stdio（本地命令）、sse（HTTP 流）、streamable。

9、OpenAPI 服务器

对应字段：apiServers。支持通过 OpenAPI 规范文档（JSON/YAML）导入 REST API，并管理接口启用状态。

10、LSP 服务器

对应字段：lspServers。用于配置代码语言服务。需要本机已安装对应语言服务器命令，例如 jdtls、typescript-language-server、gopls、pyright-langserver 等。内置支持 18+ 种语言服务器模板，默认禁用。