dsh-exec-extension

npm · English

DeepSeek Harness bundle，一次性 exec，形状与官方 surface 插件相同（dsh.bundle.patch + parseCmdline + commander）。官方 headless-startup 只声明 [task...]；本包禁用该行并插入仍提供 headlessStartup.task 的实现，不改 headless-runner。

CLI 对齐 OpenCode run 与 Pi -p：stdin 拼进 prompt，@file / -f 附文件，--format json 打 session 事件流，--dir 设 cwd，--yolo 跳过审批询问（不关闭 sandbox，不是全开权限）。模型覆盖只在进程内（Rust WASM），不写 settings.yaml。

安装

dsh plugin --profile exec add @deepseek-ai/dsh-headless@$(npm view @deepseek-ai/dsh version)
dsh plugin --profile exec add dsh-exec-extension
dsh --profile exec --help

跟随 dsh CLI 的 npm latest 通道（官方默认：npx @deepseek-ai/dsh / npm install --global @deepseek-ai/dsh）。除非你装的是 dsh@next，否则不要用 @next。@deepseek-ai/dsh-headless 自己的 latest 标签是过期 rc，所以第一行取 CLI 的 latest 版本，而不是 headless 自己的 latest。dsh-exec-extension 走本包 latest。只有需要快照时才用 @<version> 冻结。npm 安装不必放行 prepare。

Git 备选：dsh plugin --profile exec add github:LvDAO/dsh-exec-extension

只用独立 profile。官方 headless --model 必须仍因未知选项失败。

命令行

dsh --profile exec [options] [--] [task|-]
cat README.md | dsh --profile exec "summarize this"
dsh --profile exec @notes.md --full-auto "use the notes"

旗标	含义
-m, --model	本进程模型（不进入 task）
--effort, --reasoning-effort	off|high|max
--thinking	Pi 档位；xhigh/max → max，minimal/low/medium/high → high
--provider	本进程 provider
-C, --cwd / --cd / --dir	工作目录（发布到 headlessStartup.cwd）
--timeout <seconds>	N 秒后 appExit(1)
-s, --sandbox / --permission-mode	read-only | workspace-write | danger-full-access
--approval ask|never|allow	ask 无 UI 则 fail-closed；never 自动拒绝；allow 自动批准
--full-auto	workspace-write + auto-allow（CI）
--yolo / --dangerously-skip-permissions	跳过审批询问（auto-allow）。不设 danger-full-access；默认 sandbox 仍是 workspace-write。全开权限请用 --sandbox danger-full-access
--tools-mode native|code|both	工具呈现
-f, --file / @path	把文件正文附进 task
--output-schema <path>	prompt 约束 JSON Schema，不是解码期强制
-o, --output-last-message <path>	同时把最终 assistant 文本写入文件
--format text|json / --mode json	json 为 session 事件 JSONL
-c, --config key=value	可重复的本进程覆盖
--env KEY=VALUE / --api-key	只改进程环境变量，不写盘
--print-selection	打印 overlay 后的 selection JSON 并退出

未知旗标报错。Overlay 从不调用 saveSelection()。

--output-schema 只是 prompt 约束，不是解码期强制。--approval allow 与 --yolo 会装本进程 auto-grant：dsh 的 never 是自动拒绝，headless 又没有审批 UI。--yolo 不会改成 danger-full-access；要全开请用 --sandbox danger-full-access。

headlessStartup 为 { task, cwd, permissionMode, approvalPolicy, autoApprove, toolsMode?, format }。sandbox-policy / approval / tools 通过 !!js ctx.headlessStartup.* 注入。官方 headless-runner 仍只读 task。

非目标

MCP、Host、HTTP、resume、--image、分叉 headless-runner。MCP 放 profile 静态 patch + 进程 env。

npm test
DSH_BIN=/path/to/dsh npm run acceptance