界面导览
本页介绍 LoongCode 主界面的各个区域，帮你快速熟悉界面布局，找到你需要的功能。
① 左侧任务栏
左侧任务栏是管理工作区和任务的主要区域。从上到下依次包含：
- 应用 Logo 与折叠侧栏：左上角是应用 Logo——「衔尾圆环龙」徽章（v0.9.4 起换新，并随当前主题变换配色，见常规设置 → 主题）。将鼠标悬浮到 Logo 区域，可点击收起侧栏将任务栏折叠；点击展开侧栏恢复（v0.7.0 起支持）。macOS 上窗口控制按钮（红绿灯）独占侧栏顶部一行，Logo 与字标排在其下一行（v0.9.8 起），不再与红绿灯挤在同一行。
- 顶部功能区：Logo 下方是四个入口行——新建任务（
Ctrl+N，快速新建任务草稿）、搜索（Ctrl+K，打开居中的搜索浮层——默认按任务标题过滤，可勾选深度搜索检索会话内容，另有包含归档勾选项，详见深度搜索）、打开工作区（添加项目文件夹）、新建群聊（仅开启群聊 Beta后显示）。 - 已置顶：置顶的任务集合，独立显示于任务列表上方，不受「折叠全部」影响。
- 「全局」标签行：任务区顶部的分区标题，右侧是三个作用于整个任务区的图标——看板入口（独立按钮，点击把主区切换为任务看板）、视图筛选菜单（漏斗图标，切换「按工作区分组」/「按时间线」）与归档入口（归档图标，切换到归档视图，查看或管理已归档的历史任务）。
- 「工作区」分区：列出所有已打开的工作区（项目文件夹）。鼠标悬浮到工作区名称行，右侧出现新建任务、查看文件、移除工作区三个快捷图标；点击查看文件会将左侧栏切换为该工作区的文件树视图，点击文件树顶部的返回任务可退回任务列表。按住工作区名称行拖动可手动调整工作区的先后顺序（v0.9.8 起，详见任务与工作区 → 拖拽调整工作区顺序）。
- 任务列表：每个工作区下方展示该工作区的任务条目。任务状态（空闲、运行中、成功、出错、提问中）通过任务行的左侧书签条与行尾徽标表达——运行中显示金色书签条、橙色旋转圆环和「已工作」计时；提问中显示蓝色书签条与蓝色「?」徽标；有未读消息时标题加粗并在行尾出现金色小圆点，看过后恢复灰色。详见任务与工作区。
- 「任务」分区：「工作区」分区下方的独立分区，承载不属于任何工作区的任务（存放于内置默认工作区）；分区标题右侧悬浮出现 ＋ 按钮，可确保默认工作区存在并新建任务。没有这类任务时分区显示为空态。
另外，左侧栏底部还有新手引导快捷入口、账号用量徽标（环形进度 + 百分比，悬浮查看已登录 Claude / Codex / Kimi 账号的实时用量，可在常规设置 → 账号用量中整体关闭，v0.9.9 起、Kimi 自 v0.10.0 起纳入；详见模型供应商 → 账号用量）、已分享入口（分享图标带有效分享数角标，管理已创建的分享链接，详见会话分享，v0.9.8 起）、定时总览入口（时钟图标，集中管理所有任务的定时执行）和打开设置按钮。
在这里你可以切换任务、管理工作区，以及快速定位历史对话。详细说明见任务与工作区。
② 顶部标题栏
标题栏横跨界面顶部，包含：
- 当前工作区 / 分支切换器：显示当前任务所在的工作区名称和 Git 分支（worktree 即 Git 的一种独立检出目录，允许同时在多个分支上工作）；点击分支名称可新建分支、切换分支或新建 worktree。
- 提交菜单：位于顶部标题栏，提供提交与更多 Git 操作入口，可查看未提交的变更并完成提交。
- 更新徽标：当检测到新版本时，右上角会出现更新徽标；点击后可立即重启完成更新。
- 侧边面板按钮与终端按钮：分别切换右侧面板（详见下文 ⑤）和底部终端面板的显示状态。
后台活动指示灯已下放到各分栏输入框
早期版本的后台活动 ⚡N 指示灯位于标题栏，只跟随当前选中的分栏；当前版本已改为每个分栏输入框自带一枚 ⚡N 指示灯（见下文 ④），分屏时每栏都能独立看到自己的后台活动，无需切换选中栏。详见后台任务活动。
在这里你可以快速切换 Git 分支、管理代码版本，以及检查应用更新。
③ 中央对话区
中央区域是与 AI 交互的主舞台，显示当前任务的完整对话历史：
- 消息气泡：用户消息和 AI 回复以时间顺序排列；AI 回复实时流式渲染，Markdown 自动格式化。
- 思考过程块：AI 的内部推理过程以折叠块形式呈现，标题为「思考过程」；点击可展开或收起。
- 工具调用时间线：AI 调用工具（读写文件、执行命令等）时，连续的调用会聚合成一条时间线，每个调用占一行（状态符 + 工具名 + 目标文件 + 简短结果摘要）；点击任意一行可就地展开该次调用的详情，对代码的修改以 Diff（新旧代码对比）形式展示。
- 提问卡片：需要用户授权时弹出，包含允许 / 拒绝按钮供你选择。
- 分屏：可同时打开多个对话分栏，每栏独立运行一个任务（各栏有自己的输入框与 AI 会话）。每个分栏还可切换到终端 TUI 模式（v0.9.8 起），在 CLI 原生的命令行界面里续接同一会话继续对话。
在这里你可以查看对话历史、审阅 AI 的操作，以及对 AI 的权限请求作出回应。
④ 输入框
输入框位于界面底部，是向 AI 发送消息的入口：
- 选择器条（输入框上方）：从左到右依次为 CLI 选择（Claude CLI / Codex CLI / OpenCode CLI / Kimi Code / Qoder CLI / Hermes / Pi / dsh，后四者为实验性，需开启实验功能才可选）、模型选择、思考深度（Claude：low / medium / high / xhigh / max / ultracode；Codex：minimal / low / medium / high / xhigh；OpenCode：default / minimal / low / medium / high / xhigh；Kimi 供应商模型：default / off / minimal / low / medium / high / max；Qoder：default / low / medium / high / xhigh / max；Pi：default / 思考档位；dsh：通用档位；Hermes 无思考深度选项）、执行授权（Claude：default / plan / acceptEdits / auto / dontAsk / bypassPermissions；Codex：只读 / 自动 / 完全访问；OpenCode：auto / ask；Kimi：default / plan / auto / yolo；Qoder：default / acceptEdits / auto / dontAsk / bypassPermissions；Pi：审批 / 计划 / 完全访问；dsh：只读 / 工作区写入 / 完全访问；Hermes 无授权选项）、当前分支。dsh 任务的 Agent 预设选择器位于 CLI 选择器之后。
- 上下文用量指示器：选择器条最右侧显示已用 / 总量的上下文 token 比例（token 是 AI 处理文本的计量单位）；可点击压缩对话历史以释放空间。
- 触发器：在输入框中输入
@可从工作区文件列表添加文件上下文，输入/可打开命令面板使用内置命令、插件命令和技能（技能和命令统一从/调用）。 - 占位提示：「向 Claude 提问，输入 @ 添加文件，/ 使用命令，$ 使用技能」；其中
$ 使用技能只是对技能类命令的说明文字，技能实际同样通过/命令面板调用（详见斜杠命令）。等待 AI 回答时占位提示变为「请在上方卡片作答;或在此草拟下一条消息…」。 - 后台活动指示：发送按钮左侧按需出现「已工作 X 秒/分」计时与 ⚡N 徽标——分别指示本分栏任务是否在工作、以及正在运行的后台任务数；点击 ⚡N 可打开该分栏的后台活动浮层。详见后台任务活动。
- 发送 / 停止按钮：输入框右下角的圆形金色按钮用于发送；AI 运行期间它变为红色实心停止按钮（内含小方块），左侧实时显示本轮已运行时长，点击即可中断。
在这里你可以配置每次对话的 AI 参数，以及向 AI 发送指令。详细说明见对话面板。
⑤ 右侧面板
右侧面板（点击标题栏侧边面板按钮切换显示）是文件查看与代码审阅的主区域。标签栏由四类标签组成，采用 Windows Terminal 风格的标签样式（等比压缩、溢出箭头、浮动选中态）：
| 标签类型 | 说明 |
|---|---|
| 文件标签（动态） | 每个打开的文件对应一个标签；代码等文本文件用 Monaco 编辑器展示，支持语法高亮与 Diff 对比，图片、Office 文档、表格数据、音视频等格式则自动切到对应的专属预览器；标签标题为文件名，有未保存修改时显示脏点 |
| 审查 | 查看工作区的代码 Diff（未暂存 / 已暂存 / 全部分支更改 / 上一轮更改），确认后可提交 |
| 浏览器 | 内嵌浏览器，可在应用内打开网页，并把网页元素直接加入对话上下文 |
| 终端 | 右侧面板内的集成终端标签，直接在工作区目录运行命令；与底部终端面板同一套 PTY 终端，可在右侧常驻使用 |
打开文件的方式：在左侧栏的文件树中单击文件节点，文件即在右侧面板新建文件标签打开；也可按 Ctrl+P 搜索并打开文件，或点击标签栏右侧的 + 按钮选择「打开文件」或「终端」。还没有打开任何标签时，右侧面板显示「打开标签页」卡片面板（随面板宽度自动在网格 / 列表布局间切换），点卡片即可新建文件、审查、浏览器或终端标签；关闭最后一个标签后面板停留展示该空状态，不再自动收起。面板开合带 200ms 滑动动画。
文件树不是右侧面板的标签页，而是左侧栏的一种视图：在工作区行点击查看文件即可进入，点击顶部返回任务可退回任务列表。
终端有两个入口：一是从中央对话区底部弹出的独立面板，点击标题栏的终端按钮（快捷键 Ctrl+`）即可打开；二是作为右侧面板的终端标签常驻侧边（见上表）。两者共用同一套 PTY 终端，直接在工作区目录运行命令。
浏览器标签
在浏览器标签中点击 + 可新增一个内嵌浏览器窗口；点击选中元素加入聊天，可将网页上的元素直接发送给 AI 进行分析。
在这里你可以查看和编辑项目文件、审阅 AI 的代码改动，以及配合内嵌浏览器做前端调试。详细说明见文件与编辑器。
⑥ 设置入口
设置入口位于左侧任务栏底部，图标为齿轮形状，点击即可打开设置页面。
设置页面提供以下分类（左侧导航）：
- 常规：主题、数据目录、CLI 路径、提示音、代码快照、自动压缩、使用引导等
- 依赖管理：检测并安装 Claude CLI / Codex CLI / OpenCode CLI / Kimi Code CLI / Qoder CLI / Hermes / Pi / dsh 等依赖；展开后还有 Hermes、Pi 与 DeepSeek Harness 的专属配置页（实验性，开启对应开关后显示）
- 模型供应商：配置各 AI 服务商的 API 密钥（API 密钥是服务商发给你的专属访问凭证）、接口地址、可用模型列表、OAuth 登录与网络代理
- 记忆：管理 Claude / Codex / OpenCode / Kimi / Qoder / Hermes / Pi / dsh 的持久化指令文件（CLAUDE.md / AGENTS.md）、Claude / Qoder 的 auto-memory，以及 Pi 的增强记忆（实验）
- 插件：发现、安装和管理插件
- 技能：创建或编辑可复用的提示词技能
- MCP 服务器：增删改 MCP（Model Context Protocol）服务器配置，扩展 AI 可用的外部工具
- 钩子：管理 Claude / Codex / Kimi / Qoder / Hermes / Pi 生命周期事件的自动化钩子（Hooks）
- 子智能体：管理子智能体配置
- 移动端配对：绑定 LoongCode App，远程查看与驱动电脑上的任务
- 分享：配置会话分享所用的分享服务器与访问密钥（留空即用官方服务）
- 使用统计：查看 token 用量、费用、活跃热力图等
- 关于：版本信息、检查更新、协议、赞助与联系方式
详细说明见设置 → 常规。
下一步
熟悉界面之后，建议深入了解核心功能——前往任务与工作区学习如何高效管理任务与项目。