dsh-dotenv
在终端中运行以下命令:
dsh plugin install LIghtJUNction/dsh-dotenv
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install LIghtJUNction/dsh-dotenv,即可从开源仓库 https://github.com/LIghtJUNction/dsh-dotenv 安装 dsh-dotenv 并在 profile 或 patch 中配置 path。
插件介绍
在 DSH 里,很多插件和模型客户端会在启动早期就读取 process.env 里的配置与凭据。若依赖 shell 或进程管理器事先 export,容易漏配;若指望框架自动发现项目根下的 .env,DSH 默认也不会替你加载。dsh-dotenv 的作用,是在 DSH 启动阶段按你在 profile 或 patch 里显式指定的路径,用 Node 自带的 util.parseEnv 读入 dotenv 格式文件,并把变量写进当前进程环境——且只填入尚未定义的键,已有值(包括空字符串)一律保留。
它不会自动扫描 .env,也不会读取 Pi 的 --env-file;不配置 path 就不加载任何文件。路径相对于 DSH 启动时的 process.cwd()(canonical root),由主机上的 Node 文件系统读取,不支持远程 world 或 sandbox 注入。插件在生命周期内只加载一次,不提供工具、命令或向模型暴露秘密;读取失败会抛出固定错误,避免把文件内容带进错误信息。对路径、符号链接、文件大小等有明确限制,适合在可控的 Linux 主机上把「一份显式 dotenv 文件」接进 DSH 启动链。
适合需要在 DSH 0.2.1-rc.2 及 Node 24+ 环境中、用标准 dotenv 语法集中管理启动配置的团队;尤其当你希望凭据插件、配置提供者在 dotenv 加载完成后再初始化时,应把本插件排在依赖环境变量的其他 bundle 之前。若某消费者在模块 import 瞬间就读环境,仅靠插件 apply 可能已晚,那时仍应靠 shell 或 systemd 等在外层设置环境。
使用场景
- 需要在 DSH 启动早期注入 API 密钥或端点,且不想覆盖 shell 已 export 的变量
- profile 或 patch 里指定单一 dotenv 文件,让凭据类插件在其后初始化
- 本地 Linux Host 上运行 DSH,配置集中在 canonical root 内的普通文件
适合人员
- 在 DSH 0.2.1-rc.2 上编排插件启动顺序的运维或集成者
- 用 Node 24+ 部署 DSH Host、需显式 dotenv 而非自动发现 .env 的团队
- 依赖 process.env 的配置/凭据插件维护者