DSH Web UI 输入框不可用:先选择 Workspace

按未添加、未选中、选择报错与任务失败四种状态排查 DSH 工作区;保留 rc.1 操作,补充 0.1.7-alpha.1 首次默认工作区的触发条件。

社区整理已复核原始来源
完成后
为当前 Session 选择明确的 Workspace;用只读任务确认实际工作目录
适合
页面能打开但无法开始对话的用户
DSH
0.2.2-rc.1
系统
Windows / macOS / Linux
操作时间
3~8 分钟
风险
low
本页目录(8)

2026-11-12 按当前默认 0.2.2-rc.1(固定提交 66491b05)复核: 全新安装第一次启动仍会自动创建默认工作区(文稿/Documents/deepseek-harness/default-workspace)并选中空白会话,条件见下方 0.1.7 小节;创建失败时会提示“无法创建默认工作区,请通过‘选择工作区’选择文件夹”,下次启动才会重试。DSH 页面可以打开但不能开始任务时,先看当前会话是否已关联工作区,再确认模型与错误发生阶段。仅出现目录名称,不代表当前 Session 已选中,也不代表任务已经通过验证。

0.2.2-rc.1 还要注意三点:

先按四种工作区状态定位

当前状态观察什么下一步完成标志
未添加目录选择列表中没有预期项目按直接修复添加明确允许访问的测试目录预期目录已出现在列表,尚须选中
已添加但未选中当前会话仍提示“请先选择工作区”,输入框显示“选择一个工作区开始”选中目录并返回当前 Session,核对模型选择当前会话关联预期目录,输入区可用
选择操作报错错误发生在添加目录、选中目录还是创建会话保存原文和阶段,按选择失败与任务失败分流原失败步骤可完成;不以刷新后错误消失代替验证
已选中但任务失败当前目录、模型及任务错误码写入拒绝转权限诊断,认证失败转模型配置原失败任务通过检查,不重复添加同一目录

这些现象通常指向 Workspace

如果 DSH 页面已经打开,但出现“输入框灰色”“不能输入消息”“页面提示选择工作区”或“新建 Session 后没有可用项目目录”,先不要重装 DSH。当前 Session 很可能还没有选中 Workspace;如果界面显示“选择模型”,则还要补模型选择。

直接修复

  1. 在 Web UI 中点击选择工作区。
  2. 用“添加工作区”加入一个你明确允许 Agent 访问的测试项目目录。
  3. 选中该目录,返回当前 Session。
  4. 确认输入区变为可用。
  5. 若模型按钮仍显示“请选择模型”,进入 设置 → 模型 配置 Provider 并选择模型。

可观察的成功结果是:当前界面显示明确的工作区,输入区可以输入,一次只读任务列出的正是这个目录的内容。注意这只说明 Agent 的工作目录对了,不代表它只能访问这个目录:默认的 workspace-write 只限制写入和命令执行,读取和网络访问不受这项限制。

启动目录、Workspace 与 Session 有什么区别

概念它决定什么不等于什么
启动目录dsh 进程使用的默认文件系统位置和可添加 Workspace 的起点不等于新 Web UI 已自动选中 Workspace
Workspace当前 Agent 可处理的项目目录和默认写入边界不等于所有 Session 自动切换到这个目录
Session保存消息、模型选择和任务上下文的一次会话没有 Workspace 或模型时不能直接开始任务

官方 0.1.5-rc.1 用户指南明确说明:dsh 进程把启动目录作为默认文件系统位置,但全新的 Web UI 不会选中任何 Workspace,需要用户添加并选择。

在上述 0.1.5-rc.1 范围内,下面的命令能决定默认位置,但不能代替界面选择:

cd /path/to/project
npx @deepseek-ai/[email protected] web

用只读任务验证范围

先核对实际权限与预期目录,再发送下方只读目标。任务文字中的“不要修改”不构成沙箱,也不会自动将 workspace-write 改成 read-only;权限设置见任务权限选择。

选中 Workspace 后,发送:

只列出当前工作区的一级文件和目录,不要修改文件,不要运行安装命令。

检查输出列出的是不是预期目录,并用 Git 状态或文件时间确认没有变化。0.2.2-rc.1(与 0.1.5-rc.1 相同)基于 base 的新会话默认使用 workspace-write 权限预设:文件和 Bash 写入被限制在会话工作区和临时目录,读取和网络访问不受这项限制。选错目录会扩大可写范围。

第一次建议使用专门测试目录,不要直接选择整个用户目录、多个客户项目的共同父目录或生产部署目录。要更换项目,优先在界面切换到另一个明确 Workspace。

已选工作区,但任务仍然失败怎么办

工作区已经显示,并不证明目标路径一定可写。若错误包含 workspace selection failed,先记录发生在添加目录、选中目录还是创建会话阶段;这段用户可见错误本身不能确定根因。按实际界面状态重新核对目录、模型与脱敏错误,不把所有失败都当成“尚未选择”。

2026-09-12 核对依据为 rc.1 固定用户指南(外部链接,在新标签页打开)与 CLI 说明,未运行浏览器工作区验收,也未据错误文字断言某一版本缺陷。

0.1.7-alpha.1:首次默认工作区何时生效

2026-09-22 固定源码补充,未运行 DSH 浏览器验收。 新版启动时,客户端等待完整的工作区和会话列表;符合首次使用条件时,由 Host 准备默认工作区,客户端随后创建或复用并选中空白 Session。创建空白会话不会自动发送消息,也不代表模型与任务已经可用。

首次创建要求没有工作区登记,且没有运行时、持久化或已归档会话;隐藏会话和没有工作目录的会话也计入判断。因此侧栏空白不等于全新安装。初始化成功会保存标记;改名、切换语言、重启或删除登记都不会使它再次自动创建。不要为了触发此功能清空历史数据。

默认路径由运行 DSH 的 Host 账户的系统 Documents 目录解析,再进入 deepseek-harness/<客户端语言对应的初始目录名>;远程 Web 使用的是服务器账户的位置。它不是浏览器所在电脑的目录,也不由一次 cd 直接决定。系统目录查询不可用、路径冲突或目录准备失败时,客户端提供文件夹选择器,不应假设已经自动选好工作区。

0.1.7-rc.2 起目录名固定。 2026-09-26 按 rc.2(477b4f420553e8a52c2fbccc464d7561b239c443)核对:新建的默认工作区目录固定为 Documents/deepseek-harness/default-workspace,不再按界面语言命名(此前中文环境是 默认工作区,英文环境是 Default workspace,其他语言是 default-workspace)。界面上显示的名称仍会跟随语言;手动改过名的工作区显示你改的名称。升级前已经创建的默认工作区保留原来的目录和名称,不会被重命名或迁移。首次创建的条件没有变化。会话标题为空时,侧栏可能直接显示目录名 default-workspace,这不代表工作区出错。依据:语言中立的默认工作区命名(外部链接,在新标签页打开)、目录常量(外部链接,在新标签页打开)、0.1.7-rc.2 发行说明(外部链接,在新标签页打开)。

看到默认工作区后,仍需检查当前 Session 的实际目录、权限和模型,并按只读目标验证。自动准备失败时保存错误,使用明确的测试目录完成手动选择;已选中后的认证或写入失败按上方四状态表分流。

依据:首次使用资格与持久标记(外部链接,在新标签页打开)、Host 目录解析(外部链接,在新标签页打开)、客户端流程说明(外部链接,在新标签页打开)。这不改变本文 0.1.5-rc.1 的手动选择说明,也不是新版全面兼容验收。

仍然不能输入怎么办

  • 确认当前 Session 已选择模型,而不只是保存了 API Key。
  • 检查 Web UI 与终端是否显示配置或 Provider 错误。
  • 刷新页面后重新选择工作区,观察界面是否保留状态;页面整体无响应时,先用终端打印的带令牌地址重新打开。
  • 若出现 MISSING_CREDENTIAL、UNKNOWN_MODEL 或 401,查看模型、API Key 与 Provider 配置或凭据错误排障。
  • 若页面本身无法打开,查看Web UI 启动失败;端口占用则查看3080 端口修复。

Workspace 与模型配置完成后,返回DeepSeek Harness 中文入门执行第一次可验证任务。

来源与维护信息

本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续,不要停在文章末尾