Files
deepseek-harness/packages/bundle/headless/README.zh.md
Turtle 2365b2c54f feat(bundle): ship dsh-base, dsh-web-app, and dsh-headless profile bundles
Profile bundles are npm packages declaring dsh.patch in their manifest:
dsh-base carries the former base.cordis.yml rows as one insert over the empty
profile root; dsh-web-app carries the web overlay plus a runtime glue plugin
owning what used to be launcher code (frontend dist resolution via
frontend-static, the web-surface prompt section, bash runtime variables, the
readiness-gated URL line); dsh-headless carries the one-shot runner driving a
task turn through the in-process API carrier under the launcher-provided
ctx.headlessIo seam.
2026-08-06 04:40:11 +08:00

1.6 KiB
Raw Blame History

@deepseek-ai/dsh-headless

English | 中文

dsh 一次性任务组合包。cordis.patch.yml 叠加在 dsh-base + dsh-web-app 之上:把 webserver 移到 OS 分配的端口(并行运行绝不冲突),关闭 URL 行输出,并插入本包的 headless-runner 插件(配置为 {task}。runner 通过进程内 API 载体(架在 toFetchHandler(ctx.apiProxy) 之上的 InProcessApiClient因此序列化、zod、SSEServer-Sent Events帧封装这整条 wire 链路都会真实运行)驱动一个任务轮次,聚合该轮次最终的 assistant 文本,写到 stdout再经启动器提供的 ctx.headlessIo seam 请求退出(完成 → 0否则 1。Web 组合保持挂载,因此运行中的会话可在浏览器中通过 stderr 公告的 URL 观察。启动器把任务文本 patch 进来(dsh --profile headless "task");如果向没有这一行的 profile 传入任务,则大声失败。

模型体验

无。runner 把任务作为普通用户消息经共享组合提交;提示词与工具归 baseweb 组合包所有。

KV Cache 影响

runner 不向请求前缀添加任何内容。

已知限制与延期工作

  • 只运行一个轮次runner 锚定第一个由消息触发的轮次,并在其结束时退出;排队的后续消息与多轮任务不在范围内。
  • ctx.headlessIo 由启动器持有:在 dsh 启动器之外启动 headless profile 会在激活时大声失败,直到宿主提供该 seam。