fenxin-fx/dsh-default-workspace-plugin

Project Overview项目介绍

This is a native DeepSeek Harness plugin that removes the blocking requirement of selecting an existing workspace to start a new conversation. Out of the box, brand new DSH profiles have no registered workspaces, so they get stuck on the workspace selection screen with no way to proceed. This plugin adds two separate fixes to that dead end: it automatically provisions and registers a default workspace on first boot, and it adds a "Chat without a workspace" option to the workspace picker menu. It can be installed via a single DSH CLI command that pulls the source directly from this GitHub repository, no building required.

This plugin is ideal for users who frequently create fresh DSH profiles or want the option to start quick, ungrouped conversations without attaching them to a specific project workspace. After installation, a full restart of the DSH web profile is required for the node-side code to take effect, but later updates only need a browser refresh. You can override the default workspace path via a plugin configuration entry in your cordis.patch.yml or set the DSH_DEFAULT_WORKSPACE environment variable before launching DSH. If you already have existing workspaces registered, the auto-provision step runs as a no-op so it does not change your existing setup.

The plugin has zero external dependencies, relying only on Node built-in modules and browser APIs, so there is no build step required to use it. It is released under the permissive MIT open-source license, so you can modify or redistribute it freely per the license terms. Any failures that occur during the auto-provisioning step are logged as warnings rather than errors, so they will never block DSH from booting. The no-workspace option creates an ungrouped session that falls back to the host’s current working directory, which is useful for quick ad-hoc questions that don’t need project context.

这是一款面向 DeepSeek Harness (DSH) 的原生插件,用于解决新创建的 DSH 配置文件无法启动对话的问题。默认情况下,DSH 要求必须选择一个工作区才能开始对话,但全新配置文件的工作区注册表是空的,会停留在工作区选择页无法继续。该插件通过两个功能解决这个死循环问题:自动创建注册默认工作区,以及在工作区选择器添加无工作区对话选项。

对于全新初始化的 DSH 配置,安装该插件并重启 Web 配置后,插件会自动在指定路径(默认是 <DSH_HOME>/workspaces/default,可通过配置或环境变量修改)创建并注册默认工作区,让新配置直接进入对话界面,无需手动创建工作区。如果用户不想绑定工作区,也可以直接在工作区选择页选择“不在工作区中对话”,启动一个未分组的临时对话。

该插件采用 MIT 许可证开源,零外部依赖,仅使用 Node 内置模块和浏览器 API,无需构建步骤,可直接通过 DSH 插件命令从 Git 源安装。首次安装后需要重启 DSH Web 配置才能生效,后续更新仅需刷新浏览器即可。插件支持通过配置文件或环境变量自定义默认工作区的路径和名称。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add "git+https://github.com/fenxin-fx/dsh-default-workspace.git#main"

把 fenxin-fx/dsh-default-workspace-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-default-workspace

A DeepSeek Harness plugin — start a new conversation without selecting a workspace.

license

Out of the box, DeepSeek Harness will not let a conversation start until a workspace directory has been selected. On a fresh profile the workspace registry is empty, so the web GUI lands on the workspace-picker hero and there is nothing to pick.

This plugin removes that dead-end in two ways, from one package:

  1. Node half — at boot it resolves a default workspace directory, creates it if missing, and registers it. The runtime's existing "recent workspace" fallback then connects it, so a brand-new profile opens straight into a conversation.
  2. Client half — it adds a "Chat without a workspace" (不在工作区中对话) entry to the new-session workspace picker. Selecting it starts a session with no workspace: its working directory falls back to the host's process.cwd() and the session shows up as Ungrouped in the sidebar.

What it does

Behaviour Detail
Auto-provision Creates and registers a default workspace on first boot
No-workspace option Adds a "Chat without a workspace" row to the workspace picker
Zero footprint Auto-provision is a no-op when workspaces already exist (unless always: true)
Idempotent Re-registering the same path reuses the existing record
Non-fatal A failure is logged as a warning and never fails the boot
Zero dependencies Imports only Node built-ins / browser APIs; no build step

The default directory is <DSH_HOME>/workspaces/default (or ~/.dsh/workspaces/default when DSH_HOME is unset). It can be overridden per-deployment with a config row, or globally with the DSH_DEFAULT_WORKSPACE environment variable.

Install

Recommended — one line from the git source (no build runs on install, since the source is committed directly):

# HTTPS git source. The `github:` shorthand is rewritten to SSH by pnpm and
# fails on machines without SSH keys — use the explicit git+https form.
dsh plugin --profile web add "git+https://github.com/fenxin-fx/dsh-default-workspace.git#main"

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev DSH-Basic-Right-Sidebar 下一个 Next dsh-session-toc →