Skip to content
dsh marketplace

dsh-envsel

Verified

@beihaizb/dsh-envsel · v0.2.0 · MIT · Web UI

Session environment selector for DeepSeek Harness: per-language conda / standalone R / WSL / custom-path slots behind a /env command, the session_env tool, DSH_ENV_* shell facts, and a conversation-header dropdown. Installs with dsh plugin add.

Install

dsh plugin add @beihaizb/dsh-envsel

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-envsel

English | 中文

DeepSeek Harness（DSH）的会话环境选择器。按语言槽位 —— Python、R、CLI 工具 —— 每个槽位各持有一个来自 conda、独立 R 安装、WSL 发行版或手动固定路径的首选环境。选择按会话隔离、重启后保留，并从下一轮起对模型生效。

这是一个独立的、可通过 npm 安装的 DSH 插件。用 dsh plugin add 安装即可 —— 无需打源码补丁，也无需 monorepo 检出。

功能

  • /env 命令 —— 在对话中查看、设置、清空和列出环境。
  • session_env 模型工具 —— 智能体可以自行列出、选择、固定和取消固定环境。
  • DSH_ENV_* shell 事实 —— 每次 shell 调用都会看到会话所选环境的 DSH_ENV_PYTHON、DSH_ENV_RSCRIPT、DSH_ENV_CLI_PREFIX。
  • 头部下拉框 —— 会话头部提供按语言（Python / R / CLI 工具）选择的面板，并带「添加路径」表单，可固定任意解释器或安装目录。
  • 跨平台发现 —— conda 环境、独立 R（Windows Program Files、macOS 框架 + Homebrew、Linux /opt/R）、Windows 上的 WSL 发行版，以及手动固定的路径。WSL 扫描在非 Windows 主机上自动跳过。
  • 中英双语 UI —— 产品文案（/env 命令、头部下拉框、发现警告）跟随 DSH 界面语言：默认英文，当 DSH 语言偏好设为中文时显示中文。

环境要求

  • DeepSeek Harness 0.1.7-rc.1 或更新版本（web profile），现在也覆盖 0.2.0-rc 线：所有 @deepseek-ai/dsh-* peer 都声明为 ^0.1.7-rc.1 || ^0.2.0-rc.1。已在 0.1.7-rc.2 上验证；该区间同时接纳 0.2.0-rc.1、0.2.0-rc.2 与 0.2.1-alpha.2。DSH 会跳过 @deepseek-ai/dsh* peer 区间不包含当前运行版本的插件 bundle——决定插件能否加载的是这个区间，而不是运行时的版本探测。
  • PATH 上有 pnpm（dsh plugin 会用到）。

DSH 版本兼容性

插件 DeepSeek Harness 原因
0.2.0 0.1.7-rc.1 或更新版本（0.1.7-rc 与 0.2.0-rc 两条线） 覆盖 DSH 0.2.0-rc：18 个 @deepseek-ai/dsh-* peer 现在都接纳 ^0.2.0-rc.1，启动期的兼容性门禁不再跳过整个 bundle。此前它们仍钉在 ^0.1.7-rc.1，其上界 <0.2.0 会拒绝 0.2.x 运行时。
0.1.6 0.1.7-rc.1 或更新版本 修复 0.1.7 上的头部下拉框：该版本改了 UI 图标命名（IconCheckOutline14 改为 IconCheckOutlineRegular），0.1.5 的按钮因此渲染出 undefined 元素、该 slot 条目崩溃。
0.1.5 0.1.7-rc.1 或更新版本 发射带 create() 工厂的 strict Typert codec，该契约由 0.1.7-rc.1 引入。宿主侧（/env、session_env、DSH_ENV_*）可用；头部下拉框不可用。
0.1.3 及更早（已发布） 0.1.0-rc.7 至 0.1.5-rc.x 发射这些 loader 所校验的即刻构造 schema 实例。

DSH 在 0.1.7-rc.1 改了 strict codec 契约：dsh-typert-loader 与 dsh-typert-registry（宿主端和浏览器端）要求 typeof codec.create === 'function'，且不再校验即刻构造的 schema 字段。因此只带 schema 的 codec 在 0.1.7-rc.1 及更新版本上加载失败，只带 create() 的 codec 在 0.1.0-rc.x 上加载失败，两代无法共用同一份产物。本版本只针对新契约；在旧版 DSH 上请改装该线最后一个已发布版本（v0.1.4 打了标签但从未发布到 npm）：

dsh plugin --profile web add @beihaizb/[email protected]

本包中每个生成的 codec 都经 strictCodec()（src/strict-codec.ts）发射，契约只有一个改动点。

安装

dsh plugin --profile web add @beihaizb/dsh-envsel

重启 dsh web，打开一个已有会话，对话头部就会出现 Env 下拉框；/env 和 session_env 立即可用。

从本地检出安装：

dsh plugin --profile web add "file:/绝对/路径/到/本仓库"

使用

/env 命令

/env                        查看当前选择
/env python=mycondaenv    设置 Python 槽位（conda 名 / 独立R名 / wsl:发行版:名 / custom:名）
/env r=R-latest            设置 R 槽位
/env cli=base               设置 CLI 槽位（PATH 前缀）
/env python=                清空某个槽位
/env list [过滤词]           列出所有可发现的环境
/env add <路径>              把解释器或安装目录记入本机缓存
/env unpin custom:<名>       移除一条固定路径
/env clear                  清空全部选择
/env wsl                    重新扫描 WSL 发行版（仅 Windows）

session_env 工具

智能体可以用 action=list|get|set|pin|unpin 自行管理选择。

头部下拉框

会话头部的 Env 按钮会打开按语言分类的下拉面板。目录在首次打开时惰性扫描（探测 conda 和 WSL 需要几秒）。「添加路径」可把任意绝对解释器或安装路径固定进本机缓存。

配置

插件无需任何配置即可工作。可选的在 profile 的 cordis.patch.yml 中给 envsel 行加 config：

键 默认值 含义
listTtlMs 300000 目录缓存 TTL（毫秒）。
condaCommand conda conda 可执行文件名或绝对路径。
standaloneRRoots [] 在平台默认值之后额外扫描的独立 R 根目录。
wslEnabled true 是否启用 WSL 发现（仅 Windows）。
registerTool true 是否注册 session_env 模型工具。
probeTimeoutMs 20000 每次探测的看门狗超时（毫秒）。

示例：

# 在你的 profile 的 cordis.patch.yml 中，位于 bundle 层之后
- id: envsel
  name: '@beihaizb/dsh-envsel'
  config:
    wslEnabled: false
    registerTool: true

选择如何存储

选择保存在本机 JSON 存储（$DSH_HOME/envsel-state.json，按会话 id 键控）中 —— 而不是会话事件日志。harness 的 session-persistence 读取器会拒绝包含未知事件类型的日志（除非事件标记为可忽略），而 Session.append 没有为下游插件提供设置该标记的途径。把选择变更写进日志会让该会话在重启后无法读取，因此本插件自带独立的状态存储。

开发

pnpm install
pnpm run build    # tsc（类型）+ tsdown（lib/index.js 宿主 + lib/client.js 浏览器包）
pnpm run test     # node:test 单元测试

构建产生两个产物：lib/index.js（宿主插件，从包根加载）和 lib/client.js（浏览器包，由 client-modules 扫描器根据包的 dsh.client 声明提供）。单个包可以同时是宿主行和 client 行。

已知限制

  • 没有按会话的 runtime-context 文本。 官方 AssembleContext 没有 agent 绑定，因此选择不会渲染进模型的系统提示。模型仍会通过每次 shell 调用的 DSH_ENV_* 看到选择，并可用 /env / session_env 查询。
  • peer 绑定 0.1.7-rc 与 0.2.0-rc 两条线。 插件把每个 @deepseek-ai/dsh-* peer 都声明为 ^0.1.7-rc.1 || ^0.2.0-rc.1，并已在 0.1.7-rc.2 上验证；0.2.0-rc 线由该区间覆盖。在 DSH 0.1.0-rc.7 至 0.1.5-rc.x 上请改装 @beihaizb/[email protected]（该线最后一个已发布版本）；未来改变这些 API、或再次改动 Typert 产物契约的 DSH 版本，都需要插件跟版。若某条版本线不被 peer 区间接纳，请用精确版本豁免（dsh plugin allow-version 或插件管理器），不要强行安装。
  • 选择不属于会话日志。 它们会在重启后保留在 envsel-state.json 中，但不会从（或由）会话日志重放。

License

MIT