前言¶

在 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