首次使用 DSH Web UI
让 DSH 在测试文件夹里创建 hello-dsh.txt，再亲自打开文件检查内容。桌面版和浏览器版都可以完成这个练习，不需要准备代码仓库。
本页内容
这个练习会创建一个文件。不要选择重要项目、系统目录或存放密钥的文件夹。
打开 DSH
使用 DSH Desktop 时，直接打开应用；不需要再运行 npx。已经看到对话界面，可以进入选择测试文件夹。
使用命令行启动（仅 CLI 用户）
完成对应系统的安装准备后，在终端执行：
npx @deepseek-ai/dsh web保持终端运行，打开它打印的完整地址，包括可能附带的访问令牌。默认本机地址为 http://127.0.0.1:3080；实际输出不同时，以终端为准。带令牌的地址不要公开分享。
启动命令所在目录不会自动变成 Web UI 已选择的工作区，仍需在界面中选中它。
官方 v0.2.2-alpha.2 发布说明称，Web Fetch 不再拒绝非公网地址，可访问代理和内网。自托管或共享部署应自行限制进程的出站网络、可访问地址及用户权限，避免访问不应暴露的内部服务。这是版本行为变化，不是已确认漏洞；不要将本地 Web Fetch 与 DeepSeek 的远程 Fetch API 混为一谈。 官方发布说明 ↗
SSH 环境下不自动打开浏览器，需要通过 SSH 客户端或编辑器转发端口，再访问本机转发地址。当前官方 Web alias 不支持 --host 0.0.0.0，不要直接向公网开放 DSH。
输入框不可用？检查这三项
API Key
在设置 → 模型中保存所选服务商的 Key。保存后用于后续请求，无需重启。
工作区
点击选择工作区，添加并选中一个文件夹。
模型
选择已配置服务商下的模型。输入区仍显示 Select model 时，需要重新选择。
三项均已设置仍无法发送时，查看输入框灰色的排查方法。
选择测试工作区
在文件资源管理器（Windows）、访达（macOS）或 Linux 文件管理器中新建空文件夹 dsh-test。如果安装教程中已经创建，就继续使用它。
回到 DSH，点击选择工作区（Choose workspace），添加并选中 dsh-test。确认显示的路径与电脑上的文件夹一致。
工作区是这次任务的工作目录，不等于文件访问的安全沙箱；实际访问范围取决于工具和权限设置。
选择已配置模型
打开模型选择器，选择已配置的 DeepSeek 模型。还没有配置 Key 时，先完成模型配置。
这个练习使用新会话。新选的模型会成为新会话的默认模型；已发送过请求的旧会话，仍会使用日志中记录的模型。
创建一个文本文件
在 dsh-test 工作区中新建会话，发送：
请在当前工作区创建 hello-dsh.txt，内容只有一行：Hello from DeepSeek Harness。如果文件已经存在，请停止并告诉我，不要覆盖。不要修改或删除其他文件。等待任务结束。若 DSH 只在聊天里给出文字、没有调用写入工具，文件可能还没创建，需按第 4 步检查。
阅读授权请求
出现授权提示时，检查目标是否为 dsh-test 中的 hello-dsh.txt，操作是否只与创建这个文件有关。遇到删除文件、访问其他目录或安装软件的请求，先拒绝并检查原因。
是否弹出授权提示取决于当前权限策略与预设，没有弹窗不等于任务失败。
打开文件，核对内容
回到电脑的文件管理器，打开 dsh-test，找到 hello-dsh.txt。用文本编辑器打开，内容应为：
Hello from DeepSeek Harness路径、文件名和内容都一致，这次文件任务才算完成。没有找到文件时，检查 DSH 当前工作区、工具执行记录和报错；不要只根据聊天中的“已完成”判断。
可选：阅读已有代码项目
这项练习需要一个已有代码项目，空的 dsh-test 不适用。选择不含密钥的项目副本作为新工作区，再发送：
只读取这个项目，概括顶层目录和主要包的用途，并列出参考的文件路径。不要编辑文件，也不要运行会修改数据的命令。打开回答引用的文件，核对目录、入口和用途。没有文件依据的判断，可以要求 DSH 标明不确定之处。
可选：生成项目架构图
在上一个有代码的项目中继续。Mermaid 是一种用文本描述图表的格式，下面的任务会生成图表文本：
只读取这个工作区。梳理顶层目录、入口点和主要依赖，返回 Mermaid 流程图，并列出参考文件与不确定之处。不要编辑文件，也不要运行会修改数据的命令。将图中的关系与源文件对照后，再用支持 Mermaid 的编辑器查看图表。
用于日常工作
写清范围
开始改动前说明工作区、允许修改的文件和预期产物。
阅读授权
不要批准自己不理解的命令或文件操作。
独立核验
在聊天回答之外打开改动文件，并运行与任务相符的检查。
遇到启动或端口错误？打开按错误码排查 →