DeepSeek Harness plugin

dsh-cli-workspaces

dsh profile bundle: workspace-switching one-shot CLI mode — dsh --profile cli -w <workspace> -c <task>, plus `ws` management subcommands.

Jump to install

Source facts

Repository
qingkong143/dsh-cli-workspaces
Latest update
Aug 16, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/qingkong143/dsh-cli-workspaces
Plugin: dsh-cli-workspaces
Author: qingkong143

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-cli-workspaces

给 dsh 的 cli profile 用的一键命令行模式:预置若干工作区,用 -w 切换 agent 的 运行目录(环境上下文),-c 或位置参数给任务文本,最终回复打到 stdout、退出码 0=完成/1=出错。附带 ws 子命令管理工作区注册表。

这是 dsh 的 bundle 包:包内 dsh.bundle.patch 声明了补丁层,安装后会自动加入 profile 的 dsh.profile.bundles 层栈。

依赖(bundle 层要求)

profile 的 bundles 中必须先于本包包含:

  • @deepseek-ai/dsh-base — 核心运行层
  • @deepseek-ai/dsh-headless — 提供 headless-runner(真正的 agent 执行)

本包只替换 headless 层的启动器并补上工作区切换,不自己实现 agent 循环。

安装

# 1. 建 profile 并装上依赖层(自动加入 bundles)
dsh plugin --profile cli add @deepseek-ai/dsh-headless
# 2. 装本包(registry 包名,或 git+https://...,或本地路径 ./dsh-cli-workspaces)
dsh plugin --profile cli add dsh-cli-workspaces

首次运行会把示例工作区表复制到 profile 目录,之后用 ws 命令管理:

dsh --profile cli -w 2 -c "git status"        # 切到第 2 个工作区执行任务
dsh --profile cli -c "帮我检查这个文件夹"      # 当前目录执行(或 default 工作区)
dsh --profile cli ws list                     # 列出工作区
dsh --profile cli ws add blog ~/blog          # 新增
dsh --profile cli ws rm blog                  # 删除
dsh --profile cli ws default 2                # 设置默认工作区
dsh --profile cli ws --help                   # 全部管理命令

想省掉 --profilealias dsh='dsh --profile cli'(launcher 要求 --profile,插件改不了)。

开发 / 发布

npm pack --dry-run      # 查看最终打进 tarball 的文件
npm publish             # 发布到 registry(或推 git 仓库,消费方用 git+https://... 安装)

结构

cordis.patch.yml          # bundle 补丁:禁用 headless-startup + 插入 cli-startup
lib/cli-startup.mjs       # 启动器插件(commander 解析 -w/-c;ws 子命令管理注册表)
example-workspaces.yml    # 首次使用时复制到 profile 目录的示例注册表

工作区数据文件(workspaces.yml)始终位于 profile 目录,由插件按 loader 的 ctx.baseUrl 定位;包目录只装代码与示例,不存用户数据。