dsh-direnv

dsh plugin add dsh-direnv

装好之后，harness 运行的每条命令都会继承它自己工作目录的 direnv 环境。安装约两分钟；需要 PATH 里有 direnv。

~/.dsh $ dsh web                 # no .envrc here
           └── session in ~/projects/api
                 └── bash: build      → has `cargo`, `DATABASE_URL`, …

安装

1. 先跑 direnv version。失败就先装 direnv——本插件绝不会替你执行 direnv allow。
2. 装上插件：

# once it is on npm
dsh plugin add dsh-direnv

# from a checkout instead: `npm install` runs the build that produces lib/
npm install && dsh plugin add "file:$PWD"

1. 确认补丁生效。期望看到 disabled: true：

dsh --profile <name> --dump-config | grep -A3 'id: subprocess'

检查它是否生效

1. 在一个有已批准 .envrc 的工作区里开一个会话。
2. 让模型执行 bash -c 'echo $SOME_VAR_YOUR_ENVRC_SETS'。
3. 看右侧栏的 direnv tab：状态、变量名，以及按优先级排列的 PATH 差分。

第 2 步打印出空行，就说明环境没加载进来，去「排障」。

它做什么

插件接管 harness 的 subprocess 缝隙，按工作目录求值 direnv export json。 三条流程共用这一个事实来源，且互不阻塞：

上溯交给 direnv 自己：锚点是每次 spawn 自己解析出来的 cwd，所以 cd 进子目录的命令拿到的是那个子目录的环境，任何 .envrc 的改动都在下一次工具调用时生效。

配置

- id: direnv-subprocess
  name: 'dsh-direnv'
  config:
    enabled: true
    direnvPath: ''            # empty = resolve `direnv` from PATH
    loadTimeoutMs: 300000     # tool calls wait at most this long, then proceed
    evaluateTimeoutMs: 0      # kill the direnv child after this long (0 = never kill)
    gateTools: all            # all | spawning | none   ('spawning' currently behaves like 'all')
    injectSensitive: all      # all | filter
    notifyModel: true         # one sourced message per workspace state change
    sidebar: true             # right-sidebar tab and composer placeholder
    disabledDirs: []          # absolute paths to leave alone

• injectSensitive: filter 会扣下名字像凭据的变量（/KEY|PASSWORD|SECRET|TOKEN/i）。只适合谨慎场景——它会让需要这些值的 dev shell 半残。
• loadTimeoutMs 是门闸的预算：一次工具调用最多被拦多久，超过就带着当时已知的信息放行。
• evaluateTimeoutMs 约束 direnv 子进程本身。0 表示永不杀，因为冷启动的 use flake 时长不可预测。代价是：一个永不结束的 .envrc 会在每个目录留一个 direnv 进程活到会话结束。

排障

这里几乎每一种失败都是安静的。别假定它工作了，先读启动输出。下面五条覆盖绝大多数情况：

--dump-config 并不能预测一切：它只组合补丁、不跑行级预检。补丁类警告只在它那里出现，兼容性拒绝只在启动时出现。两处都要读。

如果插件起来了、但某个工作区没有环境，就打开侧边栏那个 tab：它把 blocked、 unreadable、absent 分开报告，也会告诉你某个目录只是与「这里没有 .envrc」无法区分。

安全

• .envrc 就是任意代码。 求值会以你的身份在沙箱之外跑 bash。插件只求值 direnv 本来就会求值的文件，且绝不替你批准任何一个。
• 变量值不会以文本形式进模型上下文。 提示里只有数量、路径与警告；要看名字、要按需展开值，去侧边栏。
• 名字像凭据的变量默认照注入。 overlay 叠在 harness 已清洗的环境之上。这正是插件的意义——也正是 injectSensitive 存在的原因。
• 求值器会剔除全部 DIRENV_*，所以从一个 direnv 加载过的 shell 里启动的 harness，无法复活它已经清洗掉的变量。
• 状态路由自带围栏。 请求走 harness 自己的连接校验，不像零围栏的 /plugins/* 载体。

局限

• MCP server 与 host 侧辅助进程绕过这个缝隙。 任何经 MCP SDK 或 host 进程直接 spawn 的东西都看不到工作区环境。覆盖到的是 harness 自己的 shell、subprocess、搜索、git 与 PTY 消费方。
• 另一个 subprocess provider 会把它挤掉。 一个 context 只能有一个实现；插件输掉时会响亮报错。
• 有些目录看起来就是空的。 不可读的 .envrc（chmod 000）或被 direnv deny 的目录，与「这里没有 .envrc」产出的空输出一模一样。
• 失败的 .envrc 可能半成功。 source 找不到文件、语法错误时 direnv 仍然退出 0，而更早的变量已经生效。侧边栏与模型提示都会把它标成 degraded。
• harness 自己的名字过滤会赢两次。 环境里名字含有 KEY、PASSWORD、SECRET、TOKEN 的变量（包括 TURKEY_MODE 这种无辜名字）会在 overlay 之前被清洗掉。只有 .envrc 显式设置的值能活下来。

开发

npm run typecheck           # three projects: host, browser half, tests and harness
npm test                    # unit tests: evaluator (real direnv) + host wiring
npm run test:client         # client half: boot row, byte-identical module, and the fenced status route
test/harness/run.sh --all   # end-to-end cases, no API key needed

严格 TypeScript；装已发布的包不需要你这边构建：src/**/*.ts 逐文件编译到 lib/ （host 半边），client/**/*.ts 打成单文件 lib/client.js 交给浏览器。npm install 会通过 prepare 构建；lib/ 不入库。DESIGN.md 记录了架构与每个决策背后的实测证据。

npm test 故意用显式的 test/*.test.ts glob：裸 node --test 会顺带执行 test/harness/ 下的脚本。测试台要走 run.sh，而不是 node test/harness/run.ts—— 包装会先清掉 DSH_HOME/DSH_PROFILE_DIR，而测试台按设计拒绝对一个活着的 DSH home 运行。 测试台用一个桩 LLM 驱动 dsh headless，所以真实的一轮对话与真实工具执行可以离线跑。

# build the checkout once (`npm install` runs the build through `prepare`)
cd /path/to/dsh-direnv && npm install

# a demo workspace in a scratch home
export DSH_HOME=$(mktemp -d)/dsh-home && mkdir -p "$DSH_HOME" /tmp/demo/proj
cd /tmp/demo/proj && printf 'export HANDS_ON=yes-from-envrc\n' > .envrc && direnv allow
dsh --profile demo --from-default-profile web --dump-config   # seed a profile
dsh plugin --profile demo add "file:/path/to/dsh-direnv"      # appends our bundle last
dsh --profile demo --no-open --port 30100                     # open the printed URL

curl -s -H "Cookie: $COOKIE" \
  "http://127.0.0.1:30100/plugins/dsh-direnv/status.json?dir=/tmp/demo/proj&force=1"
# {"ok":true,…,"status":{"state":"ok","envrcPath":"/tmp/demo/proj/.envrc","variables":[{"name":"HANDS_ON",…}]}}

cat > /tmp/dsh-direnv.yml <<'EOF'
- id: subprocess
  disabled: true
- insert:
    - id: direnv-subprocess
      name: '/path/to/dsh-direnv/lib/index.js'
EOF
dsh --profile web --patch /tmp/dsh-direnv.yml --no-open --port 30100
# then, in a workspace with an .envrc, ask the model to run:
#   bash -c 'echo $YOUR_VAR'

许可证

MIT