前言¶

在 Cadence Virtuoso 環境裏做自動化，常常要維持 SSH 隧道、CIW 側 daemon，並在 Python 裏調用 virtuoso-bridge-lite 的 API。對話式智能體裏，這些進程和虛擬環境若隨會話結束而散落，每次都要手動重裝、重連，成本和出錯面都偏大。DeepSeek Harness（DSH）側若只臨時調用腳本，也難以把連接狀態、實例選擇與運行時健康度穩定地交給 Agent。

下面介紹社區插件 dsh-virtuoso-bridge（npm 包名 @nekomona/dsh-virtuoso-bridge）：它把 virtuoso-bridge-lite 納爲持久化 Profile 插件，由 DSH 管理隧道與 daemon、隔離 Python venv，並通過工具與側欄面板把配置與運行態暴露給智能體。

這是什麼¶

dsh-virtuoso-bridge 是由維護者 nekomona 發佈的 DSH 客戶端 類 bundle 插件。源碼與 Issue 位於 GitHub：nekomona/dsh-virtuoso-bridge，社區目錄頁爲 skillhub.cn/plugins/nekomona/dsh-virtuoso-bridge。

一句話定位：在 DSH 裏把 virtuoso-bridge-lite 的背景 SSH 隧道與 CIW daemon 變成跨對話仍存活的管理型運行時，向 Agent 暴露完整 Python API，支持在隔離 venv 中批量執行 Python，並在左側全頁 Virtuoso Bridge 配置面板與右側 Bridge runtime 面板中呈現狀態。

當前 npm 版本爲 0.1.1（MIT 許可證）。

核心功能¶

資料中列出的能力面如下，各對應明確的 UI 或工具入口。

上游工具以 git submodule virtuoso-bridge-lite/ 形式固定提交（pin 文件 virtuoso-bridge-lite.pin.json）；發佈到 npm 的 tarball 已包含所需源碼，npm 安裝不依賴 git 與子模塊。資料明確警告：不要執行 git submodule update --remote，以免跟隨上游移動分支。

安裝完成後，插件會把上游文檔（skills/、README.md、AGENTS.md）裝入數據目錄下的 instructions/，並在 DSH 技能目錄註冊 virtuoso-bridge 技能；系統提示會指向該路徑，要求 Agent 在執行 bridge 操作前閱讀對應 skill/reference，而非猜測 CLI 參數。

安裝與啓用¶

插件以 DSH bundle 形式發佈，推薦通過 npm 包名安裝。

向智能體說明安裝意圖，或讓插件管理器執行 install_bundle 並使用下列包名：

Install the DSH bundle @nekomona/dsh-virtuoso-bridge.

無需單獨檢出 virtuoso-bridge-lite：tarball 內已捆綁上游工具源碼；插件會自建 venv 並用 pip 安裝該源碼。

運行時與配置、venv、腳本任務存放在（Windows 示意爲 %USERPROFILE%）：

%USERPROFILE%\.dsh\virtuoso-bridge\<profile>\

其中 <profile> 爲 Host 進程導出的 $DSH_PROFILE，否則爲 default。可通過 config.dataDir 或環境變量 VB_PLUGIN_DATA_DIR 覆蓋。

兼容性（資料原文）：在 DSH 0.2.2-rc.1 / Cordis 4.1 上驗證通過——四類工具可註冊執行，runtime 啓動、daemon 與 dashboard 健康檢查、已安裝的 virtuoso-bridge 技能與系統提示片段、配置頁與右側 runtime 頁等均可用。插件自有 Paramiko/OpenSSH 傳輸，不受 DSH 部分 PTC / SSH-v3 變更影響。

安裝與運行以當前 DSH Host 進程的用戶權限爲準；啓用前請自行審閱 倉庫源碼 與 MIT 許可證，確認符合你的環境合規要求。

首次配置¶

1. 在左側邊欄全局面板列表（與 Plugins、Automation tasks 並列）打開 Virtuoso Bridge 波形圖標，進入全頁配置面板；也可讓 Agent 執行 virtuoso_bridge_setup，action 爲 status。
2. 選擇工具源碼來源之一：
   - Bundled source（默認）：使用插件內固定的 virtuoso-bridge-lite/；npm 用戶通常走此路徑。
   - Local development repo：通過 source.localRepoPath 以 editable 方式安裝本地目錄；改代碼後下次 runtime 啓動生效，元數據變更可用 Repair 重裝。
   - Git repository：從 source.repoUrl 與 source.gitRef 克隆到插件數據目錄後安裝；Update 可再次拉取該 ref。
3. 點擊 Install。插件創建私有 venv、安裝工具及依賴，默認安裝 SSH extra（paramiko + PySocks），並用 runtime/vb_probe.py 驗證 import virtuoso_bridge。若系統 PATH 上沒有 OpenSSH（ssh），安裝會中斷並詢問是否僅以 Paramiko 後端繼續；同等邏輯可通過 virtuoso_bridge_setup 的 install / update（confirm: true）或 preflight 完成。

環境要求（資料原文）：Python 3.9+ 與 git 須在 PATH；Python 可執行文件可通過 source.pythonPath / settings.pythonPath 配置。

典型用法¶

查看安裝與健康狀態

讓 Agent 調用 setup 工具：

virtuoso_bridge_setup，action: status

或 preflight 查看支持的後端與 extra 定義。

管理運行時與實例

• 連接與憑據：左側 Virtuoso Bridge 配置頁，或 virtuoso_bridge_runtime。
• 固定端口或自動 session：配置頁或通過工具的 instances / select_instance。
• 實時狀態：右側 Bridge runtime 面板。

調用上游 API

通過 virtuoso_bridge_api：先用 describe 瞭解簽名，再用 call 執行；避免 Agent 自行拼湊未讀的 CLI 標誌。連接、部署、自動 session 與實例選擇行爲應參考安裝到 <dataDir>/instructions/ 下的 skills/virtuoso/references/connection.md（ reinstall / update 可刷新文檔）。

在 venv 中批處理 Python

使用 virtuoso_bridge_script 提交 job，用 status 查詢、用 cancel 中止。

更細的步驟見倉庫內中文指南：docs/plugin-guide.zh-CN.md。

適用場景與注意¶

適合誰：已在用或打算用 virtuoso-bridge-lite、希望在 DSH 對話中穩定維持隧道與 daemon，並需要通過 Agent 工具而非散落腳本操作 Virtuoso/Spectre 相關自動化的開發者。

需要注意：

• 插件在 Host 側創建與管理子進程與 venv，權限邊界與 DSH Profile 一致；生產環境應對憑據與 SSH 策略單獨評估。
• 默認捆綁的上游 pin 包含自動 session/實例發現、實例綁定 daemon 認證、Maestro/Spectre 等能力（以 pin 提交時上游爲準）；若需跟蹤上游 main 最新代碼，應使用配置中的 Git 或本地 repo 來源，並理解升級風險。
• 社區插件目錄 skillhub.cn 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；「一切皆插件」是 DSH 產品理念，本文介紹的是第三方集成方案。

結尾¶

dsh-virtuoso-bridge 把 virtuoso-bridge-lite 從「單次腳本附加件」收攏爲 DSH 可管的持久運行時：安裝走 npm bundle，配置與憑據在左欄，狀態在右欄，四類 Agent 工具覆蓋安裝、runtime、API 與腳本作業。若你正在 DSH 裏做 Virtuoso 相關 Agent 工作流，可從目錄頁與倉庫 README 繼續覈對版本與兼容說明。

• 目錄頁：https://www.skillhub.cn/plugins/nekomona/dsh-virtuoso-bridge
• GitHub：https://github.com/nekomona/dsh-virtuoso-bridge
• npm：@nekomona/dsh-virtuoso-bridge