DeepSeek Harness 插件

dsh-tool-workspace

DeepSeek Harness 工作区管理工具集:查看、创建注册、重命名、删除工作区记录(纯注册,不触碰磁盘目录);破坏性操作(删除注册、改注册路径)走用户审批 fail-closed。(英文原文)

跳到安装方式

来源信息

GitHub 仓库
wangxing-git/dsh-tool-workspace
最近更新
2026年8月20日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/wangxing-git/dsh-tool-workspace
插件名:dsh-tool-workspace
作者:wangxing-git

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-tool-workspace

DeepSeek Harness 的工作区管理工具集插件:向模型提供工作区注册记录的查看、创建注册、重命名、删除注册能力。

纯注册记录语义:所有操作只改 DSH 的 workspace 注册记录(storage),不创建、不删除、不移动磁盘目录。删除注册与改注册路径属于破坏性操作,执行前走用户审批(fail-closed)。

工具列表

工具说明审批
list_workspaces列出所有工作区(id/路径/标题/时间/会话数,可选 query 关键词对 id/路径/标题做大小写不敏感子串模糊搜索、可选实时目录状态)
get_workspace按 id 查看单个工作区详情(含实时目录状态与会话 id)
get_current_workspace获取当前会话目录对应的已注册工作区(未注册时返回 null)
create_workspace把一个已存在目录注册为工作区(不创建目录)
rename_workspace改显示标题;或改注册路径(delete+create,新 id,会话不迁移)仅改路径时
delete_workspace删除注册(保留磁盘目录与会话日志);其下仍有未归档会话时拒绝删除,需先归档

权限模型

  • 破坏性操作(删除注册、改注册路径)在执行前通过 ctx.approval.request 发起用户审批;只有 allowed-once 才放行,rejected / cancelled / unavailable 一律拒绝。
  • 未挂载审批服务、或 agent-less 调用时,破坏性操作直接拒绝(fail-closed)。
  • 纯注册记录模式不触碰文件系统,故不携带 sandbox_permissions 提权字段(该字段仅文件系统写操作使用);破坏性操作与沙箱提权共用同一条 approval/request 审批通道。未来若扩展目录级操作,复用 dsh-tool-fs 的 FsSandboxController / dsh-sandbox 的 approveEscalation 即可。

安装与集成

1. 从 GitHub 安装到 profile(以 web 为例):

``bash dsh plugin --profile web add github:wangxing-git/dsh-tool-workspace ``

或在 ~/.dsh/profiles/web/package.json 手动声明:

``json { "dsh": { "profile": { "bundles": [ "dsh-tool-workspace" ] } }, "dependencies": { "dsh-tool-workspace": "github:wangxing-git/dsh-tool-workspace" } } ``

2. (仅手动声明时需要)在 profile 目录执行 pnpm install;使用 dsh plugin add 时内部已自动执行。 3. dsh --profile web --dump-config 确认插件与 6 个工具已加载。

开发

npm run typecheck   # 类型检查
npm test            # vitest 单元测试
npm run build       # 产出 lib/

结构

  • src/index.ts —— 插件入口(name/inject/Config/apply 编排)
  • src/approval.ts —— 破坏性操作的 fail-closed 审批 helper
  • src/value.ts —— workspace 投影 + 共享 output schema
  • src/tools/*.ts —— 6 个工具实现
  • src/client.ts / src/client/* —— 客户端注入与工具调用展示(对应 ./client 导出)