dsh-venv
为每个 DSH 工作区 / 项目提供独立的运行时环境。自动识别项目用了哪些运行时,自动创建/接管 python venv,并把各运行时的环境变量注入到工作区——python/pip 永远走项目环境,绝不静默落到系统 Python。
DeepSeek Harness(DSH)项目环境管理插件。
为什么需要它
在 DSH 里打开多个项目时,如果所有会话共享系统 Python,容易出现:
- 不同项目依赖互相污染(A 项目装了包,B 项目"看到了")
- 系统 Python 被项目改动弄得不可控
- 换机器 / 换工作区,环境没法跟着项目走
dsh-venv 给每个项目一个独立环境,让 agent 跑 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