前言¶
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