> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 界面导览

> 按区域认一遍客户端窗口：首页、拓展、会话、对话、文件树、Git、终端、搜索和设置。

客户端是完整桌面窗口，不是插件侧栏。先按区域认一遍，知道东西在哪。怎么用见后面对应页面。

## 首页

启动后先到首页。你可以：

* 搜索或选择已有项目
* **添加新项目**
* 查看分支 / worktree 信息

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/home-workspace.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=5353bc1c92edd044ecd422fafe657f24" alt="首页：选择或添加项目" width="100%" data-path="images/desktop/home-workspace.png" />

选中项目后进入主界面。

## 拓展

左侧栏点 **拓展**（和 **首页** 同级）。中间换成顶栏：使用统计、AI框架、Skills、Mcps 等。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/extensions-view.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=d9b6f450a588f16d0fd1c3ddeeb9ad54" alt="左侧拓展入口和顶栏" width="100%" data-path="images/desktop/extensions-view.png" />

默认打开使用统计。Skills / Mcps 可继续管理；其余顶栏入口尚未交付。

详见 [拓展](/desktop/extensions)。

## 主界面

典型布局从左到右：

| 区域      | 是什么                    |
| ------- | ---------------------- |
| 侧栏      | 会话列表、项目切换              |
| 中间      | 对话画布和输入框               |
| 右侧 / 底部 | 文件树、Git、终端、搜索、Plan 等面板 |
| 顶栏      | 搜索、设置、窗口控制             |

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/app-overview.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=c65450255166dd956fc337300bfcda29" alt="主界面总览" width="100%" data-path="images/desktop/app-overview.png" />

面板宽度和高度可以拖动。布局会记住。

下面按区域单独看一眼。

## 会话列表

左侧侧栏列出当前工作区的会话。可以搜索、收藏、重命名、删除，或开新会话。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/history-sidebar.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=41ca91c9acd9217a3144801bae801ebc" alt="侧栏会话列表" width="100%" data-path="images/desktop/history-sidebar.png" />

详见 [会话与历史](/desktop/chat/sessions)。

## 对话画布

中间是当前会话：消息、思考过程、工具调用、Diff。底部是输入框。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/chat-canvas.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=d5566551c686fd03fb3d9ea7c8101a23" alt="对话画布" width="100%" data-path="images/desktop/chat-canvas.png" />

输入框底部可以切换供应商、模型和模式。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/chat-input.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=5563407dfa5e16a8abb9bd4497d0e787" alt="输入框和底部选择器" width="100%" data-path="images/desktop/chat-input.png" />

详见 [对话区域](/desktop/chat/overview) 和 [输入框](/desktop/chat/input)。权限模式见 [运行模式与权限](/desktop/chat/modes)。

## 文件树

浏览当前工作区文件。可以预览、重命名，或把文件拖进输入框。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/file-tree.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=aa666dde29e4b829a2c418c80acf7775" alt="文件树" width="100%" data-path="images/desktop/file-tree.png" />

详见 [工作区与面板](/desktop/workspace/overview)。

## Git 面板

查看变更、暂存、提交，以及分支和提交历史。也可以用 AI 生成提交说明。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/git-panel.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=afec2ba58233ce07fd4955417039120b" alt="Git 面板" width="100%" data-path="images/desktop/git-panel.png" />

详见 [Git 与 Commit](/desktop/workspace/git)。

## 终端

在客户端里开终端，不用切到外部窗口。适合边看 AI 输出边跑命令。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/terminal-panel.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=f3f730a03d4247d07b6e36c1e25f5b7b" alt="终端面板" width="100%" data-path="images/desktop/terminal-panel.png" />

详见 [工作区与面板](/desktop/workspace/overview)。

## 全局搜索

一个搜索框覆盖文件、会话、历史消息、技能和命令。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/search-palette.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=aa502e14047bc2f7057925ef6b5d4d00" alt="全局搜索" width="100%" data-path="images/desktop/search-palette.png" />

详见 [工作区与面板](/desktop/workspace/overview)。

## 设置

打开设置后，左侧是入口，右侧是对应表单。供应商和 CLI 在 **CLI配置管理**。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/settings-sidebar.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=010734252c6562a1428e4adffc11ca03" alt="设置侧栏" width="100%" data-path="images/desktop/settings-sidebar.png" />

完整对照见 [设置总览](/desktop/settings/overview)。

## 下一步

<Columns cols={2}>
  <Card title="对话区域" icon="message-square" href="/desktop/chat/overview">
    消息、思考过程、工具调用和状态。
  </Card>

  <Card title="输入框" icon="keyboard" href="/desktop/chat/input">
    `@`、`/`、附件和底部选择器。
  </Card>

  <Card title="工作区与面板" icon="folder" href="/desktop/workspace/overview">
    文件树、终端、搜索和 Plan。
  </Card>

  <Card title="Git 与 Commit" icon="git-branch" href="/desktop/workspace/git">
    变更、提交和 AI 提交说明。
  </Card>

  <Card title="拓展" icon="blocks" href="/desktop/extensions">
    使用统计、Skills 和 MCP。
  </Card>
</Columns>
