fenxin-fx/dsh-default-workspace-plugin:新会话不必先选工作区

前言

DSH(DeepSeek Harness)的插件生态强调「一切皆插件」。社区插件目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不应理解为官方应用商店。

在 DSH 中,新建会话默认需要先选择一个工作区目录。全新 profile 的工作区列表为空时,界面会停在“选择工作区”的起点,用户无法直接开始对话。下面介绍 fenxin-fx/dsh-default-workspace-plugin:它通过自动准备一个默认工作区,或提供一个“不在工作区中对话”的入口,减少这个前置步骤。

这是什么

这是一个由 fenxin-fx 维护的 DSH 插件,包标识为 @dsh-external/dsh-default-workspace,许可为 MIT。它解决的问题是:新会话启动前,默认需要选择一个工作区目录;该插件让这一步可以被自动完成,也可以被显式跳过。

核心功能

它提供两条路径:先做默认工作区准备,再让用户选择是否不使用工作区。

  1. 自动准备默认工作区:首次启动时解析默认工作区目录,缺失则创建,并注册到工作区记录中。
  2. 提供不使用工作区的入口:在新会话的工作区选择器中加入 Chat without a workspace,中文入口为 不在工作区中对话。选择后创建一个不绑定工作区的会话,工作目录回落到 host 的 process.cwd(),侧边栏显示为 Ungrouped

行为约束如下:

  • Auto-provision:首次启动创建并注册默认工作区。
  • No-workspace option:在工作区选择器中新增一行。
  • Zero footprint:已有工作区时自动准备不做操作,除非配置 always: true
  • Idempotent:重复注册相同路径时复用已有记录。
  • Non-fatal:失败记录为 warning,不会导致启动失败。
  • Zero dependencies:仅使用 Node 内置模块和浏览器 API,没有 build 步骤。

默认目录

默认工作区目录为:

<DSH_HOME>/workspaces/default

如果 DSH_HOME 未设置,则为:

~/.dsh/workspaces/default

优先级为:

config.path → DSH_DEFAULT_WORKSPACE → <DSH_HOME>/workspaces/default

配置

插件配置项如下:

Key Type Default 说明
path string <DSH_HOME>/workspaces/default 默认工作区目录
title string Default 工作区显示标题
always boolean false true 时,即使已有其他工作区也确保该默认工作区

也可以在启动前通过环境变量指定默认目录:

DSH_DEFAULT_WORKSPACE="$HOME/projects/scratch" dsh web

安装与启用

推荐安装命令如下。该命令使用显式 git+https 源;github: shorthand 在缺少 SSH keys 的机器上可能失败:

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

首次安装后,需要重启 web profile,使 Node 侧生效。之后的升级只需要浏览器刷新。启用或停用可以在 Settings → Plugins 中操作,包标识为 @dsh-external/dsh-default-workspace

典型用法

经过上面的步骤后,可以直接使用:

  1. 安装并重启 web profile。
  2. 全新 profile 会直接进入默认工作区的对话。
  3. 在新会话的工作区选择器中,可以选择 Chat without a workspace,开始一个未分组、不绑定工作区的会话。

适用场景与注意

适合:

  • 希望在全新 profile 中减少“先建/先选工作区”的前置步骤。
  • 偶尔需要一次不归属工作区的对话。
  • 想保留 DSH 原有工作区机制,只增加一个默认入口和一个无工作区入口。

使用前注意:

  • 插件以当前 dsh 进程权限运行;安装前应检查源码与许可证。
  • Chat without a workspace 会话的工作目录为 host 的 process.cwd(),请确认该目录符合预期。
  • 该插件来自社区目录,不代表 DeepSeek 或幻方的官方应用商店。

相关链接

  • 插件目录页:https://www.skillhub.cn/plugins/fenxin-fx/dsh-default-workspace-plugin
  • GitHub 安装源:git+https://github.com/fenxin-fx/dsh-default-workspace.git#main
  • 来源中另有仓库入口:https://github.com/fenxin-fx/dsh-default-workspace-plugin
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜