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

2026-09-30 起本站默认安装为 0.2.0-rc.2（默认工作区行为与 0.1.7 相同）：全新安装第一次启动会自动创建默认工作区并选中空白会话，条件和目录见下方 0.1.7 小节。DSH 页面可以打开但不能开始任务时，先看当前会话是否已关联工作区，再确认模型与错误发生阶段。下面的基础操作以 0.1.5-rc.1 固定用户指南为准；0.1.7-alpha.1 另见首次默认工作区。仅出现目录名称，不代表当前 Session 已选中，也不代表任务已经通过验证。

先按四种工作区状态定位

这些现象通常指向 Workspace

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

直接修复

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

可观察的成功结果是：当前界面显示明确 Workspace，输入区可以输入，并且一次只读任务只返回该目录中的内容。

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

官方 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.1.5-rc.1 基于 base 的新会话默认使用 workspace-write 权限预设，文件和 Bash 写入边界与会话 Workspace 相关；选错目录会扩大可写范围。

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

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

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

• 工作区与模型均已选择，只有写入失败：转权限与沙箱诊断，检查目标路径和实际策略。
• 页面失联或服务已经退出：转Web UI 启动排障。

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 错误。
• 刷新页面后重新选择 Workspace，观察界面是否保留状态。
• 若出现 MISSING_CREDENTIAL、UNKNOWN_MODEL 或 401，查看模型、API Key 与 Provider 配置或凭据错误排障。
• 若页面本身无法打开，查看Web UI 启动失败；端口占用则查看3080 端口修复。

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