首次使用 DSH Web UI
先完成首次就绪条件，再选择测试工作区和模型，执行一次小改动并在磁盘上核验。
本页内容
DSH 可以在所选工作区中操作文件并运行命令。不要一开始就选择重要仓库或含有密钥的目录。
启动 DSH Web UI
npx @deepseek-ai/dsh web保持进程运行，并打开它打印的地址。默认地址是 http://127.0.0.1:3080。
DSH 会把启动命令所在目录作为初始文件系统位置，但这个目录不会自动变成 Web UI 已选择的工作区。
当 DSH 检测到 SSH 环境时，当前 CLI 会主动跳过自动打开浏览器，仍然打印主机 URL，由 SSH 客户端或编辑器负责端口转发。不要照搬旧教程中的 --host 0.0.0.0；当前官方 Web alias 明确暂不支持这个值。
输入框可用前，先检查 3 个首次就绪条件
1. 服务商凭证
在 Settings → Models 保存可用凭证。服务商修改会在下一次请求生效，不需要为了保存 Key 重启服务器。
2. 工作区
新的 Web UI 默认没有已选工作区。即使你是在项目目录里启动 DSH，也仍需要显式添加并选择这个目录。
3. 模型
选择当前已配置模型。如果默认模型属于一个已经删除的服务商，输入区会显示 Select model 并阻止发送。
如果页面能打开但看起来“卡住”，先核对这三个状态，不要直接重装 Node 或重启电脑。
选择测试工作区
点击 Choose workspace，添加可丢弃文件夹并选中它。选择工作区之前，输入框保持不可用。
从 C:\project 或 ~/project 启动 DSH 只会提供初始文件系统位置；Web UI 仍然要求明确选择工作区。
选择已配置模型
打开模型选择器，选择你在 Settings → Models 中配置的服务商和模型。
选择模型同时会把它设为新 Session 的默认模型。已经发过请求的 Session 会继续使用自己日志里记录的模型。
先做仓库导览
在要求 DSH 修改项目之前，先让它读取工作区。这也是官方 Web UI 指南中的第一个任务：
把回答与真实的顶层目录和包文件进行对照，找出模型判断准确与需要进一步提问的地方。
生成只读架构图
仓库导览基本准确后，再发送边界明确的只读任务：
渲染图表前先阅读 Mermaid 文本。它是辅助审查材料，不能替代打开被引用的源文件。
执行一次可控改动
从容易检查和撤销的小改动开始：
阅读授权请求
如果 DSH 请求授权，请先阅读操作类型、路径和命令。拒绝意外或具有破坏性的操作。
自行核验文件
在 DSH 之外打开工作区，确认 README.md 存在并包含指定文字。
在明确边界内循环工作
写清范围
开始改动前说明工作区、允许修改的文件和预期产物。
阅读授权
不要批准自己不理解的命令或文件操作。
独立核验
在聊天回答之外打开改动文件，并运行与任务相符的检查。
遇到启动或端口错误？打开按错误码排查 →