---
title: "DSH Web UI 输入框不可用：先选择 Workspace"
seo_title: "DSH Web UI 输入框不可用：先选择 Workspace"
description: "按未添加、未选中、选择报错与任务失败四种状态排查 DSH 工作区；保留 rc.1 操作，补充 0.1.7-alpha.1 首次默认工作区的触发条件。"
canonical: https://52dsh.com/errors/dsh-workspace-not-selected/
authors: ["52DSH 编辑部"]
audience: ["页面能打开但无法开始对话的用户"]
outcomes: ["为当前 Session 选择明确的 Workspace","用只读任务确认访问范围"]
prerequisites: ["Web UI 已成功打开"]
difficulty: beginner
estimated_action_time: "3～8 分钟"
next_steps: {"success":["/tutorials/deepseek-harness-model-provider/","/tutorials/dsh-complete-guide/"],"failure":["/errors/web-ui-start-failed/","/errors/dsh-missing-credential-401/"]}
published_at: 2026-08-18
updated_at: 2026-09-30
verified_on: 2026-09-12
maintenance_status: community
verification_level: source_reviewed
risk_level: low
dsh_version: 0.1.5-rc.1
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

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

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

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

## 先按四种工作区状态定位

| 当前状态 | 观察什么 | 下一步 | 完成标志 |
|---|---|---|---|
| 未添加目录 | 选择列表中没有预期项目 | 按[直接修复](#直接修复)添加明确允许访问的测试目录 | 预期目录已出现在列表，尚须选中 |
| 已添加但未选中 | 当前会话仍提示选择 Workspace | 选中目录并返回当前 Session，核对模型选择 | 当前会话关联预期目录，输入区可用 |
| 选择操作报错 | 错误发生在添加目录、选中目录还是创建会话 | 保存原文和阶段，按[选择失败与任务失败](#已选工作区但任务仍然失败怎么办)分流 | 原失败步骤可完成；不以刷新后错误消失代替验证 |
| 已选中但任务失败 | 当前目录、模型及任务错误码 | 写入拒绝转[权限诊断](/tutorials/dsh-permissions-sandbox/)，认证失败转[模型配置](/tutorials/deepseek-harness-model-provider/) | 原失败任务通过检查，不重复添加同一目录 |

## 这些现象通常指向 Workspace

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

## 直接修复

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

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

## 启动目录、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` 范围内，下面的命令能决定默认位置，但不能代替界面选择：

```bash
cd /path/to/project
npx @deepseek-ai/dsh@0.1.5-rc.1 web
```

## 用只读任务验证范围

先核对实际权限与预期目录，再发送下方只读目标。任务文字中的“不要修改”不构成沙箱，也不会自动将 `workspace-write` 改成 `read-only`；权限设置见[任务权限选择](/tutorials/dsh-permissions-sandbox/#如何为任务选择权限)。

选中 Workspace 后，发送：

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

检查输出是否只涉及预期目录，并用 Git 状态或文件时间确认没有变化。官方 `0.1.5-rc.1` 基于 base 的新会话默认使用 `workspace-write` 权限预设，文件和 Bash 写入边界与会话 Workspace 相关；选错目录会扩大可写范围。

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

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

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

- 工作区与模型均已选择，只有写入失败：转[权限与沙箱诊断](/tutorials/dsh-permissions-sandbox/)，检查目标路径和实际策略。
- 页面失联或服务已经退出：转[Web UI 启动排障](/errors/web-ui-start-failed/)。

2026-09-12 核对依据为 [rc.1 固定用户指南](https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/docs/user/guide/index.zh.md)与 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`，这不代表工作区出错。依据：[语言中立的默认工作区命名](https://github.com/deepseek-ai/deepseek-harness/blob/477b4f420553e8a52c2fbccc464d7561b239c443/.agents/notes/implemented/feature/2026-09-23-language-neutral-default-workspace-naming.zh.md)、[目录常量](https://github.com/deepseek-ai/deepseek-harness/blob/477b4f420553e8a52c2fbccc464d7561b239c443/packages/api/workspace-controller/src/default-workspace.ts)、[0.1.7-rc.2 发行说明](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.7-rc.2)。

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

依据：[首次使用资格与持久标记](https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/packages/workspace/workspace/README.zh.md)、[Host 目录解析](https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/packages/api/workspace-controller/src/default-directory.ts)、[客户端流程说明](https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/.agents/notes/implemented/feature/2026-09-20-default-workspace.zh.md)。这不改变本文 `0.1.5-rc.1` 的手动选择说明，也不是新版全面兼容验收。

## 仍然不能输入怎么办

- 确认当前 Session 已选择模型，而不只是保存了 API Key。
- 检查 Web UI 与终端是否显示配置或 Provider 错误。
- 刷新页面后重新选择 Workspace，观察界面是否保留状态。
- 若出现 `MISSING_CREDENTIAL`、`UNKNOWN_MODEL` 或 401，查看[模型、API Key 与 Provider 配置](/tutorials/deepseek-harness-model-provider/)或[凭据错误排障](/errors/dsh-missing-credential-401/)。
- 若页面本身无法打开，查看[Web UI 启动失败](/errors/web-ui-start-failed/)；端口占用则查看[3080 端口修复](/errors/dsh-port-3080-in-use/)。

Workspace 与模型配置完成后，返回[DeepSeek Harness 中文入门](/tutorials/dsh-complete-guide/)执行第一次可验证任务。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/blob/477b4f420553e8a52c2fbccc464d7561b239c443/.agents/notes/implemented/feature/2026-09-23-language-neutral-default-workspace-naming.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/477b4f420553e8a52c2fbccc464d7561b239c443/packages/api/workspace-controller/src/default-workspace.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/477b4f420553e8a52c2fbccc464d7561b239c443/packages/api/workspace-controller/src/default-directory.ts
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.7-rc.2
- https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/packages/workspace/workspace/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/packages/api/workspace-controller/src/default-directory.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/c36a83ff6bb95e3f82cf79f9be7c724270a8aa61/.agents/notes/implemented/feature/2026-09-20-default-workspace.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/docs/user/guide/index.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/docs/user/guide/index.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/apps/cli/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/apps/cli/reference/README.zh.md