Skip to content

0.3 启动与界面总览

本节目标

认识 dsh 主界面的每一个区域:侧边栏、对话区、输入区状态和设置入口,知道每一步该点哪里。

打开 http://127.0.0.1:3080/,你会看到下面这个界面:

dsh 主界面

一眼看过去信息不多,但每个角落都有讲究。我们从上到下、从左到右拆一遍。

左上角:新会话按钮

界面最左上角是新会话按钮。每点一次,就新建一个独立的对话,你可以理解成开了个新聊天窗口。多个会话之间互不干扰,各自有各自的上下文。

左侧边栏:工作区和会话导航

左边界面上有一栏导航,目前只显示工作区一个入口。

工作区这个概念贯穿整个 dsh,它就是你让 agent 干活的那个项目目录。没选工作区之前,dsh 不知道你的文件在哪,所以对话区是"闲置"的。我们在 Part 2 专门讲它,这里先记住一句话:没有工作区,dsh 就没法真正动手干活

底部输入区:预设、权限和模型

底部输入框周围有一组状态信息,这组信息新手最容易忽略,但很重要:

  • Agent 预设:输入框上方显示当前预设,示例界面是标准模式。它决定了新建会话时 agent 的角色和默认行为,在设置里可以换,6.3 节会讲。
  • 权限agent 能执行的操作范围,由沙箱和审批策略共同决定。/pərˈmɪʃn/:输入框下方一行的访问模式按钮,示例界面显示 Workspace Write。权限决定 agent 能干多少事,越高越要小心它乱来,4.4 节和 7.2 节会细讲。
  • 模型提供智能的大模型服务,dsh 负责调度它来思考与生成。/ˈmɒdl/:输入框下方一行的选择模型按钮,示例界面显示的是 DeepSeek 的模型。你可以把它理解成"这单活交给哪个大脑",后面 1.1 节教你配置和更换。

中间主区:对话区

中间一大片空白就是对话区。你发出的指令、agent 的回复、它调用工具的每一步,都会在这里滚动展示。

初次打开时它显示"探索未至之境"和预览版标识,这是 dsh 的启动页。等我们发出第一条指令后,这里就会热闹起来。

底部:输入框

对话区下方是输入框,这是你给 agent 下指令的地方。注意现在它是不可用的,因为还没有选中工作区。选中工作区后输入框才会解锁,我们在 3.1 节发出第一条指令。

左侧边栏底部:设置入口

左侧边栏最下方有一个设置按钮,点开后弹出设置面板:

设置面板

设置面板有四个 tab,后面会逐个用到:

Tab干什么的学习章节
通用设置Agent 预设、权限模式、语言、外观主题Part 6
模型配置 API 密钥、选择模型提供方Part 1
插件查看和启停插件6.2
Agent 预设选择或编写会话预设6.3

在继续之前,你可以先点开设置面板逛一圈,只看不点,放心不会弄坏什么。

小结

  • 左上角新会话建对话,左侧工作区是 agent 干活的地盘
  • 底部输入区显示预设、权限、模型,先混个脸熟
  • 对话区展示整个过程,输入框要等选中工作区后才解锁
  • 左下角设置是总控制台,四个 tab 对应后面的章节

界面认全了,下一章我们做第一件必做的事:配置模型,给 dsh 接上"大脑"。

发现错误?提交反馈 · 欢迎 提 PR 改进本书