前言¶
DSH(DeepSeek Harness)的插件生态强调「一切皆插件」。社区插件目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不应理解为官方应用商店。
在 DSH 中,新建会话默认需要先选择一个工作区目录。全新 profile 的工作区列表为空时,界面会停在“选择工作区”的起点,用户无法直接开始对话。下面介绍 fenxin-fx/dsh-default-workspace-plugin:它通过自动准备一个默认工作区,或提供一个“不在工作区中对话”的入口,减少这个前置步骤。
这是什么¶
这是一个由 fenxin-fx 维护的 DSH 插件,包标识为 @dsh-external/dsh-default-workspace,许可为 MIT。它解决的问题是:新会话启动前,默认需要选择一个工作区目录;该插件让这一步可以被自动完成,也可以被显式跳过。
核心功能¶
它提供两条路径:先做默认工作区准备,再让用户选择是否不使用工作区。
- 自动准备默认工作区:首次启动时解析默认工作区目录,缺失则创建,并注册到工作区记录中。
- 提供不使用工作区的入口:在新会话的工作区选择器中加入
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。
典型用法¶
经过上面的步骤后,可以直接使用:
- 安装并重启 web profile。
- 全新 profile 会直接进入默认工作区的对话。
- 在新会话的工作区选择器中,可以选择
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