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
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:running-grass/dsh-nix-dev-shell說明文件
閱讀完整 README ↗配置
行内 config(cordis.patch.yml 已给出默认值):
| 键 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关。 |
mode | 'env' | 'env' 注入环境 / 'wrap' 走 nix develop --command。 |
flakeFile | 'flake.nix' | 向上查找的文件名。 |
maxAncestors | 40 | 最多向上查找的目录层数。 |
captureTimeoutMs | 30000 | 单次环境捕获的超时。 |
retryMs | 60000 | 捕获失败后的重试间隔。 |
ttlMs | 600000 | 捕获结果的最长复用时间。 |
cacheDir | '.dsh-plugins/.cache/nix'(随行配置;代码内默认为 '' = 临时目录) | 沙箱内 nix 的缓存目录(NIX_CACHE_HOME,helper 里同时设 XDG_CACHE_HOME);相对路径按 flake 根目录解析(不是 Harness 进程的 cwd)。 |
injectCacheHome | true | 在 flake 工作区内、且命令受沙箱约束时,把 NIX_CACHE_HOME 注入命令环境,使显式 nix 命令开箱可用。 |
nixCommand | 'nix' | nix 可执行文件的名称或绝对路径。 |
promptContext | true | 向模型注入一条运行时上下文,说明 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等需要下载或求值更多的命令,冷缓存的劣势通常比上表更明显。