dsh-venv

Venv

Per-project runtime environments for DeepSeek Harness: auto-adopt or create a project-local Python venv (.venv_local/python) and wire in the toolchains/env vars for the runtimes each project uses.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:emuco/dsh-venv#5b1b7bbf1a9f3c39be775db7e7d6883ec4461e57

Compatibility and provenance

Venv is published as dsh-venv and currently resolves to version 0.3.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 9/7/2026

Versions

0.3.0stable

9/7/2026

README

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

README

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 层的条件）。

使用

目录结构

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

Venv

Compatibility and provenance

Versions

Related plugins

Venv

README

dsh-venv

为什么需要它

设计理念

功能

安装

使用

目录结构

开发

License

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

dsh-venv

为什么需要它

设计理念

功能

安装

使用

目录结构

开发

License