dsh-dotenv

DSH PLUGIN开发与运行时

仓库 LIghtJUNction/dsh-dotenv · npm @lightjunction/dsh-dotenv

开发与运行时 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

为 DeepSeek Harness 启动阶段显式加载 dotenv 文件,仅填入尚未定义的变量,不覆盖 shell 已有值。

一句话选型结论

按资料字段整理

dsh-dotenv 是开发与运行时类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-02 创建于 2026-11-02
README 3.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:LIghtJUNction/dsh-dotenv
  1. 1
    确认版本与运行环境

    Node.js 要求 >=24;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求>=24来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@4.0.5、@deepseek-ai/dsh-agent@0.2.1-rc.2 等 5 个需要同时安装的同级依赖
npm 包名@lightjunction/dsh-dotenv可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-dotenv:为 DeepSeek Harness 启动阶段显式加载环境变量

  • 启动时显式加载 dotenv
  • 保留已有环境变量
  • 支持 Node parseEnv 语法
  • 路径与符号链接安全校验

适用场景

文件读写存储

上游标签

deepseek-harnessdsh-plugin

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-04): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 插件目录树加载失败
  • L5.3_HTTP_SERVED HTTP 服务响应

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-dotenv当前 L4 · 沙盒安装通过 低风险 0 未标注 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方LIghtJUNction仓库 dsh-dotenv · 默认分支 main
分类开发与运行时developer
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言TypeScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-02 · 2026-11-02最后推送 2026-11-12
本站收录2026-11-02首次进入本站目录的时间

README 全文

3.8 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-dotenv

为 DSH 0.2.1-rc.2 启动阶段显式加载 dotenv 文件。使用 Node util.parseEnv,仅填入 process.env 中尚未定义的变量;已有空字符串同样保留。Node 24+,本地验收环境为 Node 26。

安装与配置

GitHub Release 发布 v0.1.0 后,可安装其 npm tarball;此说明不表示版本已经发布:

dsh plugin --profile tui add https://github.com/LIghtJUNction/dsh-dotenv/releases/download/v0.1.0/lightjunction-dsh-dotenv-0.1.0.tgz

软件包的 bundle 默认 config: {},不设置 path 就不加载任何文件。它不会自动发现 .env,也不读取 Pi 的 --env-file 参数。通过 profile 的 cordis.patch.yml 或 --patch overlay 显式配置:

- id: dsh-dotenv
config:
root: /absolute/path/to/project
path: .env.local

root 默认是 DSH 进程启动时的 process.cwd();path 相对于 root,也可使用 root 内的绝对路径。它不是 agent 的会话目录。文件由 DSH 进程所在主机的 Node filesystem 读取,不支持远程 world、sandbox 文件系统或远程 shell 环境注入。

文件示例(占位内容,不使用真实凭据):

export APP_ENDPOINT="https://example.invalid"
APP_LABEL="Local # development"
APP_BANNER="first line
second line"

加载前可以从 shell 设定变量;文件不会覆盖它们。遵循 Node parseEnv 的引号、注释、export、多行语法;支持开头 BOM。无 shell 执行、命令替换或 $VARIABLE 插值。

启动顺序与生命周期

插件只加载一次,没有工具、命令、文件监听器或模型提示词注入,也不会输出变量名、数量或值。读取失败只抛固定错误,避免文件内容进入错误信息。

依赖环境值的其他插件必须在 dotenv 加载完成后初始化。尤其需要配置提供者/凭据插件的启动顺序;安装此 bundle 不会追溯重建已经启动的模型客户端。若消费者在模块导入时就读取环境,插件 apply 可能已经太晚;这种情况应由启动 shell 或进程管理器设置环境。

多个加载实例都遵守“已有值保留”:谁先完成读取,谁先填入,同名变量后续不覆盖;并发完成顺序不保证。请优先使用一个显式文件。plugin dispose 会取消并等待尚在进行的读取,不会删除已经成功加载的环境变量;这些值属于进程,恢复旧值可能破坏其他插件。修改文件或重新加载不会替换已有值,需要新的 DSH 进程才能获得一套干净的环境。

限制

  • 文件必须位于 canonical root 内、为普通单硬链接文件,不得通过符号链接访问;支持 root 内普通子目录。空路径、路径逃逸、目录、FIFO/设备和超过 256 KiB 的文件均拒绝。不自动修改 .gitignore 或文件权限。
  • 需要支持 O_NOFOLLOW 的主机;已在 Linux 验证,未做 Windows 验收。路径检查不是 OS sandbox,无法抵御恶意本地进程在检查和打开之间替换父目录。
  • “不向模型提供秘密工具”不代表隔离整个进程:环境变量对同进程插件及后续继承环境的子进程可见,其他已授权 shell 工具仍有自己的能力。不要要求模型打印环境或凭据。
  • 读取失败时不应用部分环境值;parseEnv 按 Node 自己的容错规则处理文本,不额外实现 dotenv 语法检查器。

开发验证

npm run check --workspace @lightjunction/dsh-dotenv

测试在真实 DSH Host 内挂载插件:验证 Node dotenv 语法、BOM/多行、不覆盖已有值/空字符串、无 path 时不加载、路径/符号链接/硬链接/大小拒绝、并发首次写入、dispose 及 offline agent 模型请求不含秘密值或秘密工具。未验收远程环境注入或 Pi CLI。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-dotenv 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:LIghtJUNction/dsh-dotenv` 即可。对应的 npm 包名是 `@lightjunction/dsh-dotenv`。

dsh-dotenv 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-dotenv 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-dotenv 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-dotenv 需要什么运行环境?

Node.js >=24;需要同时安装 @deepseek-ai/cordis@4.0.5、@deepseek-ai/dsh-agent@0.2.1-rc.2、@deepseek-ai/dsh-llm@0.2.1-rc.2、@deepseek-ai/dsh-tools@0.2.1-rc.2、@deepseek-ai/dsh-working-directory@0.2.1-rc.2。环境不满足时安装会失败,建议先确认本机版本。

dsh-dotenv 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-dotenv 有哪些功能?

启动时显式加载 dotenv、保留已有环境变量、支持 Node parseEnv 语法、路径与符号链接安全校验。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

LIghtJUNction 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-04。