前言¶
在 DSH 裏改代碼常見的問題是上下文來回搬:對話裏要的文件得先手動找路徑、再想辦法塞進去,改完又要重新貼回來確認。dsh-vscode 做的事情是把 VS Code 這條鏈路接到側邊欄上——啓動編輯器、瀏覽工作區、把文件投遞給當前對話、在懸浮工作臺裏邊寫邊同步。下面介紹這個插件。
這是什麼¶
wenjun81/dsh-vscode,維護者 wenjun81,分類「客戶端」,目錄頁 star 爲 0,屬於較早期的社區作品。它把 VS Code 橋接進 DSH 側邊欄:左側新增「VScode」入口,主面板提供打開編輯器、瀏覽工作區文件、把文件作爲原文件附件交給當前正在打開的對話、以及用多文檔標籤的懸浮工作臺編輯代碼。插件按 DSH 的「一切皆插件」思路實現,宿主半體 index.js、客戶端半體 client.js,包名 @wenjun81/dsh-vscode,當前版本 1.1.1,MIT 許可證。
安裝與啓用¶
安裝不依賴 dsh plugin add 之類的命令,需要先把插件目錄放進 profile,再在 package.json 裏登記 bundle。示例以桌面 profile 目錄 %USERPROFILE%\.dsh\profiles\desktop 爲例。
1、獲取插件源碼目錄(README 給出兩種方式:git clone https://github.com/wenjun81/dsh-vscode,或下載源碼 zip 解壓),把它放到本機任意位置。
2、在 profile 目錄下用 npm 安裝該目錄的絕對路徑:
cd $env:USERPROFILE\.dsh\profiles\desktop
npm install <dsh-vscode 目錄的絕對路徑>
3、在 profile 的 package.json 中把 bundle 加進啓用列表:
{
"dependencies": { "@wenjun81/dsh-vscode": "<上一步安裝出的版本或鏈接>" },
"dsh": { "profile": { "bundles": ["@wenjun81/dsh-vscode"] } }
}
4、在 DSH 插件管理器中啓用「dsh-vscode」,刷新頁面,左側邊欄出現「VScode」入口。
README 提到:npm 發佈後也可直接 npm install @wenjun81/dsh-vscode,目前以 GitHub 獲取爲準。
典型用法¶
面板 打開 VS Code:自動探測 Windows/macOS/Linux 上的安裝位置,一鍵啓動,可攜帶工作區;打開文件時用 -g 參數跳到指定行列。
工作區瀏覽:插件讀取 VS Code 的 workspaceStorage,列出最近打開的工作區;選擇後列出其中文件,自動排除 node_modules、.git 等目錄與二進制文件。
發送文件給 DSH:點擊「選擇文件…」可多選本機任意位置的文件,拖進面板則進入「暫存區」,可選擇發送給 dsh、在工作臺編輯或移除。投遞目標是當前正在打開的對話,不是首個會話——README 明確說明曾誤投到後臺子代理會話。對普通會話走官方附件暫存協議(fileUploads + receiptId),文件以真正附件到達;對由子代理路由持有的會話,官方守衛會拒絕附件,此時文本文件自動降級爲文本內容並明確說明。
懸浮工作臺:可拖到任意位置的編輯卡片,Word/WPS 式多文檔標籤支持拖動排序,關閉時詢問是否保存;任意邊界或角都可縮放,字號可輸入 10–40 的數值;語法着色使用 VS Code Dark+ 配色,支持 Python、JavaScript、TypeScript、C、C++,按擴展名加內容啓發式自動檢測,也可手動選擇;另有括號/引號自動配對與自動縮進。保存回磁盤走 fs.writeText,「發送給 DSH」把編輯後的內容作爲文件附件發出。「自動同步」用 fs.watch 監聽文件變化(1.5s 防抖),保存即自動把改動後的文件發到你指定的對話。
配置¶
配置寫在 profile 的 cordis.patch.yml,給本 bundle 的 config 行傳值,全部可選,均有默認值:
- insert:
- id: '@wenjun81/dsh-vscode'
name: '@wenjun81/dsh-vscode'
config:
# 自定義 VS Code 可執行文件路徑;Windows 上也可以是 .lnk 快捷方式。空 = 自動探測。
vscodePath: ''
# 診斷日誌開關(啓動/投遞探針寫系統臨時目錄)。默認關閉,不寫任何文件。
probeEnabled: false
# 探針日誌目錄。空 = 系統臨時目錄下的 dsh-vscode。
probeDir: ''
# Windows:優先嚐試桌面的 Visual Studio Code.lnk(explorer.exe 打開 = 等價雙擊)。
desktopShortcut: true
適用場景與注意¶
適合在 Windows 上使用 VS Code、希望在 DSH 對話裏直接遞交和修改本地文件的開發者。Windows 已實機驗證(含桌面快捷方式啓動、附件投遞、工作臺全功能);macOS 與 Linux 的探測鏈和路徑已按平臺適配,代碼含平臺分支,但作者暫無條件實機驗證,屬實驗性支持。
幾點需要留意。插件以當前 DSH 進程權限運行,可讀寫你指定的本地文件並啓動 VS Code,安裝前應檢查 index.js、client.js 源碼與 MIT 許可證。隱私方面插件聲稱不採集、不存儲、不傳輸使用數據,無遙測,除 DSH 自身 RPC 外無網絡請求;診斷探針默認關閉,開啓後日志只寫系統臨時目錄。目錄站 SkillHub 是獨立社區站點,與 DeepSeek / 幻方無官方從屬關係,該插件也不是官方應用商店上架產品。
目錄頁:https://www.skillhub.cn/plugins/wenjun81/dsh-vscode
GitHub:https://github.com/wenjun81/dsh-vscode