前言¶
DSH 是一个以插件为核心扩展能力的平台。在进行 Python 开发时，管理虚拟环境往往需要依赖本机 Shell 或全局工具。dsh-uvm 插件通过在 DSH Web 界面内直接调用 uv，解决了环境管理的痛点。
插件定位¶
这是一个由 Harzva 维护的客户端插件，用于在 DSH Web 中管理 Python 虚拟环境。它将 uv 的生命周期（创建、安装、同步、运行）集成到 DSH 的原生 UI 中，并提供对 pip 的回退支持和 conda 环境的只读查看。
核心能力¶
- 环境生命周期管理：支持创建、删除虚拟环境，并读取环境根目录下的
pyvenv.cfg以列出环境信息。 - 工具链检测：自动探测本机的
uv、python3 -m pip以及conda路径与版本。 - 包管理：支持在指定环境内安装、卸载包，并同步
requirements文件。 - 项目同步：针对本地项目进行依赖差异预览（M2），比较
pyproject.toml与已安装包的差异。 - 环境运行：支持在插件管理的环境中执行
python或pip命令，包含 60 秒超时与 512KB 输出上限限制。 - Conda 可见性：仅展示
conda环境列表，不进行任何写入操作。
安装与启用¶
使用官方提供的命令即可安装。
dsh plugin --profile web add github:Harzva/dsh-uvm
若需从源码构建，请按以下步骤操作：
git clone https://github.com/Harzva/dsh-uvm.git
cd dsh-uvm
pnpm install --frozen-lockfile
pnpm check
pnpm run pack:dsh
dsh plugin --profile web add ./artifacts/harness-flow-dsh-uvm-0.1.0-alpha.1.tgz
dsh web
注意事项与边界¶
该插件为非官方插件，所有操作仅在本机执行。
* 写入限制：所有写入操作严格限制在环境根目录（默认为 ~/.dsh-uvm/envs）内。
* 安全机制：路由仅接受 loopback + 同源请求；子进程通过 spawn 参数数组调用，不经过 shell；环境名需匹配 [A-Za-z0-9][A-Za-z0-9._-]{0,63}。
* 数据隐私：插件不会读取 DSH 会话、凭据或用户其他目录。
结语¶
dsh-uvm 为需要在 DSH 环境中进行 Python 开发的用户提供了标准化的虚拟环境管理方案。更多细节与源码可参考其 GitHub 仓库：https://github.com/Harzva/dsh-uvm
