dsh-venv

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；不覆盖已有环境 |

## 安装

```bash
# 从 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 插入补丁

## 开发

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

## License

MIT