DeepSeek Harness 工作区怎么选?dsh 工作区是什么、目录配置与多工作区管理指南

配置与使用发布于 2026-08-25作者: DSH Plugin 插件中心
DeepSeek HarnessDSH plugin工作区目录配置权限
DeepSeek Harness 工作区 = agent 能读写文件、跑命令的项目目录,默认根目录是调用 dsh 时的目录;Web UI 里「选择工作区」添加并选中目录,未选中前会话输入框不可用;可添加多个工作区切换,涉及权限策略的操作 Web UI 会先询问。

DeepSeek Harness 工作区就是 agent 本次会话能读写文件、跑命令的项目目录,默认根目录是调用 dsh 时所在的位置(cd /path/to/project && dsh web);Web UI 里点「选择工作区」添加并选中目录,未选中前会话输入框不可用;支持多工作区随时切换,权限策略要求审批的操作 Web UI 会先询问(来源)。

概览:工作区 = agent 的操作边界

一句话:工作区是 agent 能读取、编辑文件并运行命令的目录,它是每次会话的边界——选错工作区,agent 就在你不想让它碰的目录里干活。 三步上手:

  1. 理解概念:默认根目录 = 调用 dsh 时的目录,启动前用 pwd 确认;
  2. 界面配置:Web UI 点「选择工作区」,添加并选中项目目录;
  3. 多区管理:可添加多个目录随时切换,审批型操作 Web UI 先问你再执行。

下面按这三步拆开讲。

第一步:工作区概念与默认根目录

dsh 进程会把调用它时的目录作为默认文件系统位置,但新 Web UI 在添加工作区前不会选中任何工作区(来源)。 关键动作在启动之前:

bash
# 1. 确认当前目录是不是你想让 agent 操作的项目
pwd

# 2. 不是的话,先切过去再启动
cd /path/to/project

# 3. 在这个目录里启动 Web UI(或 npx 免安装版)
dsh web
# 或
npx @deepseek-ai/dsh web

两个要点

  1. 启动目录决定默认位置dsh web 的调用目录就是默认工作区根,所以 cd 要在 dsh web 之前;
  2. 启动后还能改:默认位置 ≠ 锁定,Web UI 里可以添加任意目录作为工作区,不限于启动目录。

第二步:Web UI 里添加并选择工作区

打开 Web UI 后点「选择工作区」,添加启动 dsh 时所在的项目目录并选中它;选中工作区前,会话输入框不可用(来源)。 操作步骤:

  1. 点「选择工作区」:Web UI 顶部的入口,点击打开目录列表;
  2. 添加目录:把第一步 cd 进去的项目目录加进来;
  3. 选中它:选中后会话输入框才可用,此时才能发第一条任务;
  4. 验证边界:发一句「Summarize this repository」,看 agent 的操作是否都落在该目录内。

为什么先选才能发消息:这是官方的安全设计——必须明确 agent 的操作边界,才能开始会话,防止它在你没授权的位置乱动。

第三步:多工作区切换与权限管理

一个 profile 可以添加多个工作区随时切换,agent 只对当前选中的工作区操作;权限策略要求审批的操作,Web UI 会先询问你(来源)。 管理要点:

  1. 多工作区切换:在「选择工作区」里维护一个目录列表,接不同项目时切换选中即可,不用重启;
  2. agent 的能力范围:agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划——一切都在当前工作区内;
  3. 审批机制:当操作在当前权限策略下需要审批时,Web UI 会先询问你,确认后才执行;不确定的操作它会停下来等答复;
  4. 多 profile 隔离:不同任务想用不同插件集,用 dsh --profile <名字> web 建多个 profile,工作区与插件各自独立。

配好工作区之后:按需装会话/工具类插件

工作区定了,下一步是按需增强 agent 的能力——在 DSH Plugin Hub 的「设置 → 插件中心」里挑会话、工具类插件装上。 先装 Hub 本体:

bash
dsh plugin --profile web add dsh-plugin

装完重启 dsh web,打开设置 → 插件中心:4,600+ 个社区插件按分类浏览,会话管理、文件工具、代码开发、工作流自动化各取所需,点卡片一键安装、实时进度。工作区 + 插件组合好,就是一个可交付的 agent 环境。

dsh-plugin-hub · 插件中心
DSH Plugin Hub 插件市场界面

注意事项

一句话:工作区决定 agent 能碰什么,权限决定 agent 能做什么。 三点提醒:

  1. 别在根目录启动:在 ~ 或盘符根目录启动,等于给 agent 全盘权限,务必 cd 到具体项目再 dsh web
  2. 切换工作区前想清楚:当前会话的上下文与操作记录都绑定在工作区上,中途切换要确认 agent 不会读到不该读的目录;
  3. 审批提示别手滑:Web UI 弹审批时先看清操作内容(命令、目标路径),确认无误再点允许——这是最后一道闸。

来源:DeepSeek Harness 官方文档 - Quickstartdsh CLI READMEDeepSeek Harness 官网

常见问题

DeepSeek Harness 工作区是什么?

工作区是 agent 本次会话能读取、编辑文件并运行命令的项目目录。它是会话的边界:agent 的一切操作都发生在选中的工作区内,选错目录等于让 agent 在你的整个用户目录里干活。

默认工作区根目录是哪个?怎么指定?

dsh 进程会把调用它时的目录作为默认文件系统位置——想用哪个项目做工作区,就 cd 进去再启动:cd /path/to/project && dsh web。启动前用 pwd 确认一下当前目录,别在错误目录里启动。

Web UI 里怎么添加和选择工作区?

点「选择工作区」,添加启动 dsh 时所在的项目目录并选中它。选中工作区前,会话输入框不可用;添加多个目录后可以随时切换,agent 只对当前选中的工作区操作。

为什么选中工作区前不能发消息?

因为会话输入框在选中工作区前不可用——DeepSeek Harness 要求先明确 agent 的操作边界,再开始会话。这是官方的安全设计,确保 agent 知道该在哪个目录里干活。

agent 能对我的工作区做什么?权限怎么管?

agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划;当操作在当前权限策略下需要审批时,Web UI 会先询问你,你确认后才执行。不确定的操作它会停下来等答复,不会悄悄干。

来源