---
title: "如何使用 web 交互模式"
---

SolonCode 启动 Web 交互模式。启动时，浏览器的 tab 显示为工作区名与路径。

### 启动方式

默认端口（4808）

```bash
> soloncode web
```

随机端口（多工作区，可随机使用一个有效的端口）

```bash
> soloncode web 0
```

指定端口（多工作区，可指定一个具体的端口）

```bash
> soloncode web 1212
```

### 启动效果

<div>
<img  src="/img/soloncode/show2.png" />
</div>

### Web 模式特性

Web 模式相比 CLI 模式更适合新手，提供了更丰富的可视化交互体验：

- **Mermaid 渲染**：支持图表渲染显示
- **皮肤主题**：内置 default/eyecare/contrast 三套主题，支持上传安装自定义皮肤
- **心智记忆管理**：Web 界面可直接查看、编辑、删除长期记忆，支持作用域切换
- **模型搜索**：模型选择支持搜索过滤
- **消息列表复制**：一键复制消息内容
- **语音输入**：按住说话，松开发送
- **消息来源显示**：Web 界面显示消息来源通道（微信/飞书/钉钉/Web）
- **Web 认证**：支持登录页密码认证（通过 `webAuthUser` / `webAuthPass` 配置）
- **文件详情预览**：支持图片、视频、Markdown 预览和全屏模式
- **对话管理**：支持对话置顶、分叉（复制）、删除，`Ctrl + Enter` 快捷换行发送
- **刷新配置**：支持手动刷新引擎配置（多实例同步）

### 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl + Enter` | 发送消息 |
| `↑` / `↓` | 浏览历史输入 |
| `/(tab)` | 命令补全 |
| `@(tab)` | 子代理补全 |