settings.json 与 Web 设置页

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

1、保存位置与作用域

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

2、通用设置

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

• sessionWindowSize
• summaryWindowSize
• summaryWindowToken
• sandboxMode
• apiRetries
• mcpRetries
• modelRetries
• bashAsyncEnabled
• memoryEnabled
• mcpEnabled
• openApiEnabled
• lspEnabled

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

3、大语言模型

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

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

4、挂载

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

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

5、技能市场

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

• Clawhub
• Skillhub

安装时可以选择安装到不同技能池。

6、MCP 服务器

对应字段：mcpServers。支持：

• 新增、更新、删除 MCP Server。
• 启用或停用。
• 连接检测。
• 查看服务暴露的工具。
• 保存禁用工具配置，控制可调用范围。

7、OpenAPI 服务器

对应字段：apiServers。支持通过 OpenAPI 文档接入 REST API，并管理接口启用状态。

8、LSP 服务器

对应字段：lspServers。用于配置代码语言服务。需要本机已安装对应语言服务器命令，例如 jdtls、typescript-language-server、gopls、pyright-langserver 等。

9、与 config.yml 的关系

• config.yml 更适合基础配置和手写维护。
• settings.json 更适合 Web 设置页维护。
• 同一字段在两处都有值时，运行时会合并，通常以 settings 中的具体值为准。
• 不建议手动编辑 settings.json，除非你熟悉其结构。