dsh-workspace-plus:给 DeepSeek Harness 工作区加上多目录标签映射

sen70s/dsh-workspace-plus

开发与运维已验证
收录时间 2026-09-27
页面最后更新 2026-10-04

为 DeepSeek Harness 工作区增加多级目录标签映射,把「标签→绝对路径」表注入 agent 上下文,让跨仓库项目不再手写路径、避免改错文件。

dsh-workspace-plus 是一个 DSH plugin,用来把「一个工作区只能对应一个目录」扩展成「一个工作区登记 N 个带标签的目录」。真实项目常常前后端分在两个仓库、文档又在第三个目录,过去每次都要在对话里手写绝对路径,目录名相似时 agent 还容易改错文件。这个插件在每个请求里把「标签 → 绝对路径」映射注入 agent 上下文,于是直接说「把 backend 的登录接口改成 JWT」就能命中正确目录。它由 Sen70s 维护,采用 MIT 协议,提供工作区行目录按钮、输入框 @ 引用和 workspace_dirs 工具三个入口。

如何安装

install
npmdsh plugin --profile web add dsh-workspace-plus
分类
开发与运维
平台
DSH Plugin
作者
sen70s
分发方式
插件

dsh-workspace-plus 核心特性

工作区登记多个带标签目录标签表自动注入 agent 上下文输入框 @ 插入目录路径引用workspace_dirs 工具增删改查默认工作区开关,默认关闭
Listed on dsh-plugin.org

dsh-workspace-plus 仓库简介

它是做什么的?

Workspace Plus 是 DeepSeek Harness(DSH)的工作区多目录增强插件,把「一个工作区只能对应一个目录」扩展成「一个工作区登记 N 个带标签的目录」。它解决真实项目跨多个仓库时反复手写绝对路径、目录名相似导致 agent 改错文件的问题,由 Sen70s 维护,采用 MIT 协议。插件在每个请求里把「标签 → 绝对路径」映射注入 agent 上下文,让对话中直接说标签就能定位到正确目录。

核心功能

  • 多目录登记:一个工作区可登记多个目录,每个目录带标签与备注,标签在对话里可直接指代。
  • 上下文自动注入:宿主半注册 runtime-context 贡献,每次请求都把标签表注入会话上下文,无需工具调用;该 cwd 没有登记目录时返回空串,不产生 token 开销。
  • workspace_dirs 工具:支持 list / add / remove / update 四种动作,省略 workspace 时默认用当前会话的 cwd,agent 可直接落库或确认映射。
  • 对话输入框 @ 引用:输入 @ 即可看到本工作区标签,选中后插入指向该目录绝对路径的引用。
  • 默认工作区开关:设置页 workspace+ 提供「对默认工作区启用」开关,默认关闭,打开后立即生效,无需重启或刷新。
  • 独立状态文件:数据写在 $DSH_HOME/workspaceplus/directories.json,采用临时文件加 rename 写入,损坏或缺失时按空配置启动,不拖垮 DSH 启动。

怎么使用这个插件?

在 DSH 中启用后,点工作区行上的目录按钮打开弹窗,为当前工作区登记目录并给每个目录起一个标签,例如把后端仓库标为 backend、文档目录标为 docs。之后在对话里直接说「把 backend 的登录接口改成 JWT」,agent 会依据注入的标签表去对应绝对路径,不会因为旁边有名字相似的目录而改错文件;也可以直接说「加一个 infra 指向某个部署目录」,由 agent 调用工具落库。若想对 DSH 首次启动时自动创建的默认工作区启用本功能,需到设置页的 workspace+ 打开开关,其它工作区始终启用;状态文件也可手工编辑,改完刷新页面即可。

报错怎么排查?

默认工作区探测可能早于注册表服务初始化完成而失败,此时状态保持「未决」并在下一次请求或工具调用时重试,不会把「没有默认工作区」永久缓存下来。若状态文件损坏或缺失,插件会按空配置启动,不会影响 DSH 启动,按官方说明修复该文件即可。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:sen70s/dsh-workspace-plus。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。

安装、更新、卸载这个插件,都在 DeepSeek Harness 的 DSH Plugin Hub 插件市场完成

DSH Plugin 常见问题