---
title: "settings.json 与 Web 设置页"
---

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

### 1、保存位置与作用域

| 作用域 | 文件 | 适用场景 |
|---|---|---|
| 全局 `user` | `~/.soloncode/settings.json` | 多个项目共享的模型、技能池、常用 MCP |
| 工作区 `workspace` | `.soloncode/settings.json` | 仅当前项目需要的模型、API、LSP、挂载 |

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




### 2、通用设置

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

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

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


![](/img/82dce46c55f24f17993837a2a6068f16.png)



### 3、大语言模型

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

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

![](/img/a0c79aa868b44ab892a2914d48059bcb.png)




### 4、挂载

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

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

![](/img/ca8b5c4678ce46568c44364425119ed7.png)

### 5、技能市场

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

- Clawhub
- Skillhub

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

![](/img/ce997926990c419ea4356907547969f1.png)

### 6、MCP 服务器

对应字段：`mcpServers`。支持：

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

![](/img/e1070e644eec467a90ff35b21cb348c3.png)

### 7、OpenAPI 服务器

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

![](/img/96ffb3c295fb44f99d992282c8aa7397.png)

### 8、LSP 服务器

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


![](/img/2071253038af4f56b86d4c69cad86009.png)


### 9、与 config.yml 的关系

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