前言¶
在 DSH 裏切換工作區時，側欄會列出當前可用的 workspace 標題。名稱一旦偏長——例如帶項目前綴、環境後綴或完整目錄語義——在固定寬度的側欄裏往往會被截斷或擠在一行裏，掃一眼很難區分。改工作區本身的標題或路徑並不是好辦法：那會影響別處展示，也和「只想讓 UI 更易讀」的目標不對齊。
下面介紹的 dsh-workspace-name-wrap 走另一條路：只在客戶端側欄對名稱做換行排版，行高隨內容增長，不改動 workspace 標題與目錄名。它屬於 DSH 的客戶端插件，通過擴展點注入樣式，禁用時隨 bundle 卸載，不增加工具、模型提示、外部請求或會話記錄。
這是什麼¶
dsh-workspace-name-wrap 由維護者 MeirinRuan 發佈，在社區插件目錄中歸類爲客戶端插件（SkillHub 目錄頁：dsh-workspace-name-wrap）。當前 package.json 版本爲 1.0.0，許可證爲 MIT。
一句話定位：在 DSH 原生工作區側欄中，讓過長的 workspace 名稱在可用寬度內自動換行，短名稱仍保持單行；文件夾與操作控件與標題首行對齊。
核心功能¶
依據倉庫 README 與 package.json 中的 dsh.client 配置，插件能力可以概括爲：
- 側欄換行：樣式僅作用於原生 workspace 側欄中的 workspace 行；長標題按側欄寬度換行，短標題保持一行。
- 不篡改數據：workspace 標題與目錄名稱在數據層不變，只是展示層排版變化。
- 輕量邊界：使用 DSH 擴展點與
cordis.patch.yml打包；immediately: true在 Web 客戶端注入目標模塊@deepseek-ai/dsh-client-ui-workspace。 - 零配置：官方文檔說明沒有可配置項；禁用 bundle 即恢復原生布局。
聲明的運行環境包括 Node.js ^22.19.0 || >=24.0.0，以及 DSH 0.2.2-rc.1（engines.dsh 寫死爲該版本，其他 DSH 版本需自行驗證，因插件依賴 DSH 的 DOM 結構）。
安裝與啓用¶
官方安裝說明見倉庫 docs/guide.md。推薦路徑是從 GitHub Releases 下載預構建的 .tgz，再用 DSH Plugin Manager 安裝；也可在本地替換爲實際下載路徑後執行：
dsh plugin --profile web add <absolute-path-to-downloaded.tgz>
其中 --profile 換成你實際使用的 profile 名稱（示例中爲 web）。
若使用 Desktop CLI：需先打開 Desktop 一次以初始化 profile，再完全退出 Desktop 後執行插件命令。
衝突注意：不要同時啓用本公開包與 @local/dsh-workspace-name-wrap，二者會貢獻相同樣式。啓用本插件前，應先禁用或移除舊的 local bundle。
從示例 profile 卸載：
dsh plugin --profile web remove dsh-workspace-name-wrap
典型用法¶
安裝並啓用後，無需額外配置。打開 DSH Web 客戶端（或對應 profile 下的界面），在原生工作區側欄查看列表即可：名稱較短時仍爲單行；名稱較長時會在側欄寬度內換行，操作按鈕與標題第一行對齊。
官方文檔明確：會話名稱不在該樣式選擇器範圍內，本插件不負責會話側欄標題的換行。
開發與打包（僅供維護者或自測）時，可在倉庫內做語法檢查並打出 npm 格式歸檔：
pnpm run check
pnpm pack --out <external-output-directory>/dsh-workspace-name-wrap.tgz
輸出目錄應設在倉庫 checkout 之外；打包前建議在目標 DSH 版本上做界面驗證。
適用場景與注意¶
適合誰
- 經常在 DSH 側欄切換 workspace，且命名偏長、截斷影響辨認的開發者。
- 希望在不動 workspace 元數據的前提下，只改善 Web 客戶端側欄可讀性的場景。
兼容性
- 標題選擇器依賴 workspace 行的 folder、chevron、title-container、action 等 DOM 順序。若第三方側欄完全替換該結構，樣式可能不生效；懸停出現的操作區也會擠佔名稱可用寬度。
- 樣式繼承原生字體與顏色，不向外部發送 workspace 名稱、路徑或會話內容。
安全與權限
- 插件隨當前 DSH 進程權限運行，安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認符合你的使用與合規要求。
DSH 生態奉行「一切皆插件」；SkillHub 等目錄由社區維護，與 DeepSeek / 幻方無官方從屬關係，本文鏈接僅作發現與覈對來源之用。
結尾¶
dsh-workspace-name-wrap 解決的是側欄長名稱可讀性問題：換行展示、行高隨行數增長、禁用即還原。若你需要在 0.2.2-rc.1 環境下驗證，可按官方文檔從 Release 安裝 .tgz 並避免與 local 同名樣式包並存。
