DSH Plugins
返回列表
⚙️

dsh-nix-dev-shell

工作流 更新于 2026.10.31

在终端中运行以下命令:

dsh plugin install running-grass/dsh-nix-dev-shell

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install running-grass/dsh-nix-dev-shell 安装本插件(源码:https://github.com/running-grass/dsh-nix-dev-shell),安装或更新后需重启 DSH 进程以加载 Host 插件。

插件介绍

在 Nix flake 项目里,工具链和依赖通常锁在 devShell 里;若 Agent 仍用宿主机的 bash,就会出现「文档说能跑、命令却找不到编译器或包」的落差。本插件不改执行器本身,而是修饰 ctx.shell 的 execute:从 spec.workdir 向上找 flake.nix,命中后让每条 bash 命令在 nix develop 提供的环境里执行,与你在仓库根手工 nix develop 的意图一致。

默认 env 模式会一次性运行 nix print-dev-env,把相对当前进程新增或变化的环境变量缓存并注入后续命令,避免每条命令都启动 nix,也不会把 shellHook 的杂输出混进工具结果;wrap 模式则把命令包进 nix develop --command,语义更贴近交互式 develop,但每条命令多一次 nix 求值。找不到 flake、nix 不可用或捕获失败时,会原样退回原生 bash 并写日志;文件沙箱、超时、后台任务与 DSH_* 环境变量等行为仍由原执行器负责。

适合在 DeepSeek Harness 里用 Agent 维护或构建 Nix flake 仓库的开发者:希望命令自动带上 devShell 的 PATH 与构建变量,又需要 workspace 沙箱与审批流程不被绕开。若在不可信仓库里上层目录也可能存在 flake,请注意祖先查找会作用于子树内全部 bash 命令这一安全边界,必要时可关闭插件或收紧配置。

使用场景

  • 在含 flake.nix 的仓库里让 Agent 自动用 devShell 跑构建与测试
  • 需要 PATH 与工具链与 nix develop 一致,又不想每条命令手工包一层 nix
  • workspace-write 沙箱下仍希望显式 nix 命令有可写缓存目录

适合人员

  • 用 DeepSeek Harness 维护 Nix flake 项目的开发者
  • 希望 Agent 命令环境与本地 nix develop 一致的团队
  • 在可信工作区里做自动化 shell 任务的用户