running-grass/dsh-nix-dev-shell ↗★ 0

dsh-nix-dev-shell

DeepSeek Harness plugin: runs bash commands inside the workspace's Nix dev shell when a flake.nix is present

Package
dsh-nix-dev-shell
Compatibility
Unverified
Version
0.2.1
License
MIT
Last updated
Oct 30, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:running-grass/dsh-nix-dev-shell

配置

行内 config(cordis.patch.yml 已给出默认值):

键默认说明
enabledtrue总开关。
mode'env''env' 注入环境 / 'wrap' 走 nix develop --command。
flakeFile'flake.nix'向上查找的文件名。
maxAncestors40最多向上查找的目录层数。
captureTimeoutMs30000单次环境捕获的超时。
retryMs60000捕获失败后的重试间隔。
ttlMs600000捕获结果的最长复用时间。
cacheDir'.dsh-plugins/.cache/nix'(随行配置;代码内默认为 '' = 临时目录)沙箱内 nix 的缓存目录(NIX_CACHE_HOME,helper 里同时设 XDG_CACHE_HOME);相对路径按 flake 根目录解析(不是 Harness 进程的 cwd)。
injectCacheHometrue在 flake 工作区内、且命令受沙箱约束时,把 NIX_CACHE_HOME 注入命令环境,使显式 nix 命令开箱可用。
nixCommand'nix'nix 可执行文件的名称或绝对路径。
promptContexttrue向模型注入一条运行时上下文,说明 devShell 已生效、来源于本插件(而非 direnv)。

缓存与失效

每个 flake 目录的戳记由 flake.nix、flake.lock 与目录三层以内所有 *.nix(有界扫描,最多 256 项)的 mtime + size 组成:拆到 nix/*.nix 的 devShell 模块改动也能立即刷新,其余情况由 ttlMs 兜底。失败结果在 retryMs 内负缓存,避免每条命令都付出失败代价。

刷新失败时优先复用上一次捕获成功的环境(flake 正在改动、网络抖动等临时故障不会把命令悄悄降级成原生 bash),只有从未成功捕获过才回退到原生 shell。

环境注入范围

注入的是 devShell 相对当前进程变化或新增的变量(与 process.env 做差集),并额外屏蔽:

  • shell/交互状态:PWD、OLDPWD、SHLVL、_、SHELL、PS1/PS2/PS4、BASH_ENV、BASHOPTS、SHELLOPTS、IFS、OPTERR、LINENO、RANDOM/SECONDS/EPOCH*;
  • Harness 的终端策略:TERM、NO_COLOR、PAGER、GIT_PAGER(保持执行器的 TERM=dumb 等设定);
  • Nix 构建期临时路径:TMP、TMPDIR、TEMP、TEMPDIR、NIX_BUILD_TOP、XDG_CACHE_HOME、NIX_CACHE_HOME、shellHook;
  • Harness 受管命名空间:DSH_*、npm_*。

stdenv 的其余变量(PATH、CC/CXX/AR、NIX_CFLAGS_COMPILE、NIX_LDFLAGS、CAML_LD_LIBRARY_PATH、OCAMLPATH、OCAMLFIND_DESTDIR、XDG_DATA_DIRS、buildInputs、buildPhase、out 等)保留,行为与手工 nix develop 一致。

沙箱里的 nix 缓存(NIX_CACHE_HOME)

workspace-write 沙箱会把 ~/.cache 设为只读,于是直接执行 nix develop / nix build / nix flake update 会失败:

error: … unable to open database file (in '~/.cache/nix/fetcher-cache-v4.sqlite')

插件因此在 flake 工作区内自动注入 NIX_CACHE_HOME(只在受沙箱约束时;danger-full-access 下不注入):

  • 只影响 nix,不会像 XDG_CACHE_HOME 那样顺带改变其它工具(cargo/clangd 等)的缓存位置;
  • 缓存目录由 cacheDir 决定;本 profile 的 bundle patch 设为 .dsh-plugins/.cache/nix(相对 flake 根目录,即本仓库根),跨工具调用复用;
  • 不需要时设 injectCacheHome: false,手动在命令前加 NIX_CACHE_HOME=/some/writable/dir。
  • /tmp 不能用来做跨调用缓存:Harness 的每条 bash 命令都跑在独立沙箱里,/tmp 是每次新建的 tmpfs(实测相邻两次调用 /tmp 设备号 82 → 72,写入的文件下次即消失)。因此 /tmp/dsh-nix-shell/ 之类的方案每条命令仍是冷缓存;唯一能跨调用持久化的可写位置是工作区(bind mount)。

冷缓存 vs 热缓存的实测开销

本机测 nix develop --command true(Nix 2.34.9,flake 输入已在 store 中;同一进程内交替测量以抵消文件系统缓存偏差):

缓存位置每条 nix 命令耗时说明
NIX_CACHE_HOME 指向全新临时目录(每次工具调用都重建)~540 ms冷缓存:需重建 2.3 MB 的 eval/fetcher sqlite 缓存
NIX_CACHE_HOME 指向工作区内持久目录(第二次及以后)~125 ms热缓存;nix --version 的启动基线约 18 ms

即:持久化缓存每条 nix 命令省 约 0.4 秒(4 倍以上),代价是工作区内约 2.3 MB 的缓存目录。注意:

  • 这个差值只作用于真正调用 nix 的命令;不跑 nix 的命令不受影响(插件只多几次 stat,可忽略);
  • 缓存目录若在仓库内,需加入 .gitignore(本仓库的 .dsh-plugins/ 已通过 .git/info/exclude 忽略);
  • nix build/nix flake update 等需要下载或求值更多的命令,冷缓存的劣势通常比上表更明显。