dsh-workspace-plus:给 DeepSeek Harness 工作区加上多目录标签映射
sen70s/dsh-workspace-plus
为 DeepSeek Harness 工作区增加多级目录标签映射,把「标签→绝对路径」表注入 agent 上下文,让跨仓库项目不再手写路径、避免改错文件。
dsh-workspace-plus 是一个 DSH plugin,用来把「一个工作区只能对应一个目录」扩展成「一个工作区登记 N 个带标签的目录」。真实项目常常前后端分在两个仓库、文档又在第三个目录,过去每次都要在对话里手写绝对路径,目录名相似时 agent 还容易改错文件。这个插件在每个请求里把「标签 → 绝对路径」映射注入 agent 上下文,于是直接说「把 backend 的登录接口改成 JWT」就能命中正确目录。它由 Sen70s 维护,采用 MIT 协议,提供工作区行目录按钮、输入框 @ 引用和 workspace_dirs 工具三个入口。
如何安装
dsh plugin --profile web add dsh-workspace-plus- 分类
- 开发与运维
- 平台
- DSH Plugin
- 作者
- sen70s
- 分发方式
- 插件
dsh-workspace-plus 核心特性
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。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
