前言¶

在 DSH web UI 中，工作區加入後，開發者常需要把某個文件交給模型讀取。如果缺少目錄瀏覽入口，手動輸入路徑會不夠方便。dsh-workspace-explorer 是一個 DSH 工作區文件資源管理器插件：它在會話頭部提供 “Workspace Files” 膠囊按鈕，打開當前工作區的目錄樹，並支持點擊或拖拽把文件引用追加到 composer。下面介紹它的功能、安裝方式和注意事項。

這是什麼¶

@jiyr0119/dsh-workspace-explorer 是由 Jiyr0119 維護的 DSH 原生插件，許可證爲 MIT。它面向 DSH web UI，解決“工作區裏有文件，但會話面板中缺少可瀏覽、可插入的文件樹”的問題。

核心功能¶

• 在會話頭部提供 “Workspace Files” 膠囊按鈕，點擊後打開當前工作區目錄樹彈出面板。
• 面板頂部可切換 Files 與 Settings 標籤。
• Settings 頁可即時調整隱藏噪音目錄、顯示大小、引用格式、預覽行數、面板寬度，並同步到 DSH Settings → Workspace Explorer。
• 目錄按需懶加載，並自動隱藏 node_modules、.git、dist、__pycache__ 等噪音目錄。
• 按文件擴展名顯示彩色文件類型圖標。
• 點擊文件行，向 composer 追加 [file: relative-path] 引用。
• 拖拽文件到 composer 可插入引用；拖拽文件夾可插入深度有限的緊湊目錄列表。
• 支持 Shift / ⌘ 多選，並批量插入文件引用或目錄列表。
• 基於 DSH 的 --dsw-alias-* 設計令牌適配明暗主題。
• 可按名稱跨已加載目錄過濾文件，並顯示匹配數。
• 支持文本文件分頁預覽；小文件（≤ 32 KB）可粘貼完整內容。
• 支持分欄預覽，左側爲 340px 預覽面板，右側保持文件樹可見。
• 預覽面板內可編輯文件，保存直接寫入磁盤，並檢測外部修改。
• 通過 DSH locale service 註冊 zh / en 詞典，並跟隨 DSH UI 語言。

安裝與啓用¶

原生安裝命令如下。該命令安裝 npm 包，安裝後在 DSH web UI 中使用：

dsh plugin --profile web add -w @jiyr0119/dsh-workspace-explorer@latest

-w 用於規避 pnpm 9/10 默認拒絕在 workspace root 添加依賴的行爲。若不使用 -w，可創建 ~/.dsh/profiles/web/.npmrc 並寫入：

ignore-workspace-root-check=true

需要說明：僅列出插件不會自動安裝；需要用戶點擊安裝或運行安裝命令。

也可以採用動態插件方式，適合快速驗證或沒有 storefront 的環境：

1、在 DSH web UI 中運行 cordis_define。
2、將 dynamic/host.js 粘貼到 Host code。
3、將 dynamic/client.js 粘貼到 Client code。
4、運行 cordis_run 激活。
5、首次運行時，在 Run card 中完成授權。

典型用法¶

1、運行安裝命令，或按動態插件方式完成激活。
2、在會話頭部點擊 “Workspace Files” 膠囊按鈕，打開面板。
3、展開目錄瀏覽文件。
4、點擊文件行，或把文件拖入 composer，然後發送。
5、如需調整隱藏目錄、顯示大小、引用格式、預覽行數或面板寬度，使用面板頂部 Settings 標籤，或進入 DSH Settings → Workspace Explorer。

適用場景與注意¶

適合在 DSH web UI 中進行本地工作區開發、調試，並需要頻繁把源碼、配置、文檔等文件引用給模型的開發者。它把目錄瀏覽、文件引用、預覽和編輯放在同一個會話面板中，減少手動輸入路徑的步驟。

使用前建議檢查倉庫源碼、依賴和當前版本。已抓取資料未展示完整 scripts、依賴和項目結構，安裝前以 GitHub 倉庫當前版本爲準。

注意以下行爲邊界：

• 文件編輯保存會直接寫入磁盤。
• 保存時會檢測文件是否被外部修改，並給出提示。
• 插件以當前 dsh 進程權限運行，因此安裝前需要確認你有權限修改對應工作區文件。
• DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；不要把目錄頁理解成官方應用商店。

鏈接¶

• GitHub 倉庫：https://github.com/Jiyr0119/dsh-workspace-explorer
• 社區目錄頁（來自插件線索，未包含在已抓取資料中，使用前請覈實）：https://www.skillhub.cn/plugins/Jiyr0119/dsh-workspace-explorer