emuco/dsh-venv

dsh-venv

为每个 DSH 工作区 / 项目提供独立的运行时环境。自动识别项目用了哪些运行时，自动创建/接管 python venv，并把各运行时的环境变量注入到工作区——python/pip 永远走项目环境，绝不静默落到系统 Python。

DeepSeek Harness（DSH）项目环境管理插件。

为什么需要它

在 DSH 里打开多个项目时，如果所有会话共享系统 Python，容易出现：

- 不同项目依赖互相污染（A 项目装了包，B 项目"看到了"）
- 系统 Python 被项目改动弄得不可控
- 换机器 / 换工作区，环境没法跟着项目走

dsh-venv 给每个项目一个独立环境，让 agent 跑 Python 工具时永远用项目自己的解释器。

设计理念

- 有则接管，无则自动建：目录存在就接管，不存在就 python -m venv .venv_local/python 自动创建——不需要任何配置步骤。
- 一个文件夹承载多运行时：.venv_local/ 是环境容器，每种运行时一个子目录：
项目根/
└── .venv_local/
├── python/   ← Python（venv，自动创建/接管）
├── node/     ← Node（检测到 package.json 时链接）
└── go/       ← Go（检测到 go.mod 时链接）

- 自动识别，零配置：检测到 pyproject.toml/requirements.txt→python、package.json→node、go.mod→go，把对应运行时的工具链 bin 前置 PATH 并注入专属变量（VIRTUAL_ENV、NODE_PATH、GOBIN）。
- 安全优先：缺少/无效的环境会报错，绝不静默回退到系统 Python；绝不覆盖已存在的环境。

功能

| 能力 | 说明 |
|---|---|
| 🎯 工具 | project_env_status（查看/自动接管）、project_env_ensure（缺失即自动建 venv）、project_env_run（在项目环境中执行命令） |
| 🖥️ Web 面板 | 设置页新增「项目环境」区，列出所有会话工作区的环境，状态一目了然 |
| 🧩 多运行时 | python（venv 真环境）+ node / go（工具链接入、变量注入） |
| 🔒 安全 | 无 venv 即报错，不回落系统 Python；不覆盖已有环境 |

安装

从 npm 安装：
dsh plugin --profile web add dsh-venv

或从 GitHub 源码安装：
dsh plugin --profile web add github:emuco/dsh-venv

安装后重启 DSH 生效（重启是 DSH 加载新 plugin 层的条件）。

使用

装好即可用，无需配置。agent 在上述系统提示的引导下会自动调用 project_env_* 工具；你也随时可以在设置页的「项目环境」面板查看各工作区的环境状态。

目录结构

- src/index.js — 核心：路径、detect/status/environment、resolveCommand、create、run、多运行时 environmentAll
- src/plugin.js — DSH host 插件：工具 + web API + 系统提示
- src/client.js — DSH client 端：设置面板
- cordis.patch.yml — DSH profile 插入补丁

开发

cd dsh-venv
npm test        # 运行测试（node --test）

License

MIT