0.3 启动与界面总览
本节目标
认识 dsh 主界面的每一个区域:侧边栏、对话区、输入区状态和设置入口,知道每一步该点哪里。
打开 http://127.0.0.1:3080/,你会看到下面这个界面:

一眼看过去信息不多,但每个角落都有讲究。我们从上到下、从左到右拆一遍。
左上角:新会话按钮
界面最左上角是新会话按钮。每点一次,就新建一个独立的对话,你可以理解成开了个新聊天窗口。多个会话之间互不干扰,各自有各自的上下文。
左侧边栏:工作区和会话导航
左边界面上有一栏导航,目前只显示工作区一个入口。
工作区这个概念贯穿整个 dsh,它就是你让 agent 干活的那个项目目录。没选工作区之前,dsh 不知道你的文件在哪,所以对话区是"闲置"的。我们在 Part 2 专门讲它,这里先记住一句话:没有工作区,dsh 就没法真正动手干活。
底部输入区:预设、权限和模型
底部输入框周围有一组状态信息,这组信息新手最容易忽略,但很重要:
- Agent 预设:输入框上方显示当前预设,示例界面是标准模式。它决定了新建会话时 agent 的角色和默认行为,在设置里可以换,6.3 节会讲。
- 权限agent 能执行的操作范围,由沙箱和审批策略共同决定。:输入框下方一行的访问模式按钮,示例界面显示 Workspace Write。权限决定 agent 能干多少事,越高越要小心它乱来,4.4 节和 7.2 节会细讲。
- 模型提供智能的大模型服务,dsh 负责调度它来思考与生成。:输入框下方一行的选择模型按钮,示例界面显示的是 DeepSeek 的模型。你可以把它理解成"这单活交给哪个大脑",后面 1.1 节教你配置和更换。
中间主区:对话区
中间一大片空白就是对话区。你发出的指令、agent 的回复、它调用工具的每一步,都会在这里滚动展示。
初次打开时它显示"探索未至之境"和预览版标识,这是 dsh 的启动页。等我们发出第一条指令后,这里就会热闹起来。
底部:输入框
对话区下方是输入框,这是你给 agent 下指令的地方。注意现在它是不可用的,因为还没有选中工作区。选中工作区后输入框才会解锁,我们在 3.1 节发出第一条指令。
左侧边栏底部:设置入口
左侧边栏最下方有一个设置按钮,点开后弹出设置面板:

设置面板有四个 tab,后面会逐个用到:
| Tab | 干什么的 | 学习章节 |
|---|---|---|
| 通用设置 | Agent 预设、权限模式、语言、外观主题 | Part 6 |
| 模型 | 配置 API 密钥、选择模型提供方 | Part 1 |
| 插件 | 查看和启停插件 | 6.2 |
| Agent 预设 | 选择或编写会话预设 | 6.3 |
在继续之前,你可以先点开设置面板逛一圈,只看不点,放心不会弄坏什么。
小结
- 左上角新会话建对话,左侧工作区是 agent 干活的地盘
- 底部输入区显示预设、权限、模型,先混个脸熟
- 对话区展示整个过程,输入框要等选中工作区后才解锁
- 左下角设置是总控制台,四个 tab 对应后面的章节
界面认全了,下一章我们做第一件必做的事:配置模型,给 dsh 接上"大脑"。