---
title: "使用 DSH Headless 运行一次性 Agent 任务"
seo_title: "DeepSeek Harness Headless 教程：用 DSH 运行一次性 Agent 任务"
description: "使用 DeepSeek Harness Headless 运行一次性任务，按当前默认 DSH 0.2.2-rc.1 说明启动认证、权限参数、完成判定、Session 续接与输出边界，并保留历史版本说明。"
canonical: https://52dsh.com/tutorials/dsh-headless-guide/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 24.9.0 或更高版本","已准备可用的模型 Provider 与凭据"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-08-24
updated_at: 2026-11-11
verified_on: 2026-11-11
maintenance_status: community
verification_level: source_reviewed
risk_level: medium
dsh_version: 0.2.2-rc.1
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

# 使用 DSH Headless 运行一次性 Agent 任务

使用 DeepSeek Harness Headless 运行一次性任务，按当前默认 DSH 0.2.2-rc.1 说明启动认证、权限参数、完成判定、Session 续接与输出边界，并保留历史版本说明。

## 0.2.2-rc.1：当前默认版的权限参数与 Auto 审核

2026-11-06 按固定提交 `66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db` 复核 [Headless 说明](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/bundle/headless/README.zh.md)，本站没有运行 Headless 或模型请求。启动认证、`--session-id` 续接和 `--json` 输出的规则沿用下方 rc.5 小节；0.2.2-rc.1 要求 Node.js ≥24.9.0。

新增三个运行参数：

| 参数 | 作用 | 注意 |
|---|---|---|
| `--permission-mode <预设>` | 任务开始前选择已有权限预设，覆盖 runner 配置和该会话保存的选择 | 不修改已保存的配置档或用户设置；续接时要再次传入 |
| `--approval-policy ask\|never` | 选择审批策略 | Headless 没有实时审批通道，需要人工确认的调用无法当场批准 |
| `--add-dir <绝对路径>` | 在 `workspace-write` 下额外开放一个可写的物理绝对目录，可重复 | 官方示例用它授权共享 Git 目录；该目录里的钩子和配置之后可能在沙箱外执行，只对可信任务使用 |

**工具模式改为配置叠加。** Headless 配置不再读取 `DSH_TOOLS_MODE`；需要 PTC 时改用官方的 [PTC overlay](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/cli/config/examples/ptc.yml)。脚本里仍设置该变量的，升级后先删掉并确认实际工具。

**实验性 Auto 审核**：先为 headless Profile 安装 `@deepseek-ai/dsh-experimental-auto-review`，再用 `--permission-mode auto --approval-policy never` 运行。Auto 在支持的调用执行前由模型审核，然后以完全访问权限执行，**不提供文件沙箱**；被拒绝时结果里出现 `AUTO_REVIEW_DENIED`，审核本身失败为 `AUTO_REVIEW_FAILED`。它适合由监督脚本检查结果再用 `--session-id` 发修订指令的流程，不能当作只读保护。依据：[Auto 审核说明](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/experimental/auto-review/README.zh.md)。

**2026-11-11 复核补充：**

- **当前命令：** `npx @deepseek-ai/dsh@0.2.2-rc.1 --profile headless "任务"`（也可简写 `dsh headless`），Node.js ≥24.9.0。省略任务或传 `-` 时，任务从标准输入读取。
- **怎样判断任务真的完成：** 进程退出码为 0，且 JSON 输出里 `final.reason.kind` 为 `completed`，两者同时满足才算完成。收到 `SIGTERM` 时以 0 退出，收到 `SIGINT` 时以 130 退出，脚本不要只看退出码。（[Headless 说明](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/bundle/headless/README.zh.md)、[CLI 参考](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/cli/reference/README.zh.md)）
- **`--add-dir` 只对本次调用有效：** 续接会话时要再次传入。Windows 的 ACL 后端会拒绝带额外目录的子进程调用。
- **普通 Fork 可以续接：** 0.2.1-rc.3 起，通过 cwd 和权限预设检查的普通 Fork 会话也能用 `--session-id` 续接，只有子代理会话仍被拒绝。（[官方升级指南](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/docs/upgrade-guide/v0.2.1-rc.3/independent-session-forks/guide.zh.md)）
- **网页抓取可以访问内网：** 默认的 `web_fetch` 能访问本机、内网和云元数据地址。受限部署要做网络隔离，或用 `tools/pre-execute` 策略拦截。
- **Auto 会话续接：** 必须加载同一个 Auto 审核插件，换别的权限预设也不行。

## 0.2.1-rc.5：当前默认版的一次性任务

**历史快照（2026-11-01 至 11-05 的默认版本）。** 下列判断在 0.2.2-rc.1 上仍可参考，新增变化见上一节。

2026-11-01 固定源码复核：rc.5 的 Headless 默认 patch、参数解析与运行器和下方 rc.2 专节对应实现一致；本页旧版主体仍保留 0.1.5-rc.1 的范围，未运行模型任务。当前用户先确认启动认证和有效 Profile，再使用精确版本：

```bash
npx @deepseek-ai/dsh@0.2.1-rc.5 --profile headless "只读取当前目录并概括文件用途，不要修改文件"
```

随附 headless 默认不读取 GUI 保存的 Key 和登录凭据，使用启动环境、项目 .env、Home .env；需要恢复存储时按下方[三行覆盖与撤销步骤](#021-rc2headless-凭据与显式恢复)准备 `headless-auth.patch.yml`，配置内容在 rc.5 中相同。当前精确版本的组合检查和任务命令为：

```bash
npx @deepseek-ai/dsh@0.2.1-rc.5 --profile headless --patch ./headless-auth.patch.yml --dump-config
npx @deepseek-ai/dsh@0.2.1-rc.5 --profile headless --patch ./headless-auth.patch.yml "只读取当前目录并概括文件用途，不要修改文件"
```

第一条不附带任务参数，输出仅在本机查看并脱敏；确认有效组合后才执行第二条。恢复后的已保存值仍优先；不再需要时去掉覆盖参数，不删除共享凭据或其他 Profile。默认不加载认证服务也不构成文件隔离。

rc.5 可从 stdin 接收任务，并支持 `--session-id`、`--json`。续接要求已组合持久化与查询服务、匹配的工作目录和 preset；未知 Session 失败而不是新建。普通输出检查最终文本、诊断与退出码；JSON 是事件流，退出 0 只表示运行器报告完成。已有会话和自动化脚本先在可丢弃副本验收，不以旧版输出示例推断新参数。

依据：[固定 Headless 说明](https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/README.zh.md)、[默认 patch](https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/cordis.patch.yml)、[参数实现](https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/src/startup.ts)。命令供读者执行，本轮没有执行 DSH。

## 0.2.1-rc.2：Headless 凭据与显式恢复

**2026-10-19 按 rc.2 固定来源补充。** 下方原有任务示例仍适用于各自标注版本。本节只解释新版认证与相应命令；本站未使用真实凭据运行 DSH，默认安装仍是 0.2.0-rc.2。

随附 headless Profile 默认禁用 `credentials`、`authorization` 和 `deepseek-account` 三行。API Key 路由按“启动环境 → 运行目录 .env → DSH Home .env”读取；GUI 保存过的 Key 与登录账号不会自动继承，原存储文件保持原样。需要登录凭据的 Provider 因而可能失败；Provider 自己的外部认证链不由此统一关闭。

### 路径一 使用启动认证

在可丢弃工作区准备测试 Provider，通过本机受保护的启动环境或 .env 配置它需要的引用，具体名称按 Provider 确认；Key 不写进任务文本、命令参数或公开日志。已导出的空变量会挡住 .env 后备，需要取消导出后再启动。

以下精确版本示例由读者按需执行，本站未执行：

```bash
npx @deepseek-ai/dsh@0.2.1-rc.2 --profile headless "只读取当前目录并概括文件用途，不要修改文件"
```

提示中的“不要修改”不是沙箱；运行前仍要确认工具权限、有效 Profile 与测试目录。npx 和首次 Profile 初始化可能下载依赖或写入配置。

### 路径二 显式恢复存储认证

确实需要复用已保存认证时，先备份 Profile 配置。将以下官方三行恢复项保存为测试目录里的 `headless-auth.patch.yml`，不要放入密钥：

```yaml
- id: credentials
  disabled: false
- id: authorization
  disabled: false
- id: deepseek-account
  disabled: false
```

按固定 CLI 规则，launcher 的覆盖参数放在任务文本前：

```bash
npx @deepseek-ai/dsh@0.2.1-rc.2 --profile headless --patch ./headless-auth.patch.yml --dump-config
npx @deepseek-ai/dsh@0.2.1-rc.2 --profile headless --patch ./headless-auth.patch.yml "只读取当前目录并概括文件用途，不要修改文件"
```

第一条只检查组合配置，不附带任务参数；dump 仍可能初始化 Profile，输出也可能包含部署配置中的敏感字面值，只在本机查看并脱敏。确认三个目标行在最终组合中启用后，再决定是否执行第二条。原 Profile、Home 和后续覆盖都可能改变配置，不能只看 patch 文件就断言生效。

恢复后使用[已保存值优先的顺序](/tutorials/deepseek-harness-model-provider/#021-rc2先分清已保存密钥与启动环境)。撤销本次覆盖时，后续命令去掉 `--patch ./headless-auth.patch.yml`；若曾把条目合入 Profile，则恢复备份或仅撤销本次三行修改，再检查有效组合。不删除凭据文件或其他 Profile。默认不加载认证服务，不代表同一 OS 用户的文件工具读不到该文件。

### 怎样检查这次任务

先区分加载或认证失败、请求 401 和任务本身失败。普通输出模式检查 stdout 最终文本、stderr 诊断及退出码；0 表示运行器报告完成，不证明答案正确。JSON 模式与 Session 的旧版补充仍保留原适用范围，不把旧命令和新版参数混用。

缺少引用或 401 进入[凭据排障](/errors/dsh-missing-credential-401/)，准备认证回到[模型配置](/tutorials/deepseek-harness-model-provider/)。依据：[rc.2 Headless 说明](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/bundle/headless/README.zh.md)、[随附默认 patch](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/bundle/headless/cordis.patch.yml)、[凭据迁移](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/docs/upgrade-guide/v0.2.1-alpha.2/stored-credentials-precedence/guide.zh.md)与[固定 CLI](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/apps/cli/reference/README.zh.md)；提交 `687f282e8625c6b8d11ff58211a90524be2e4317`。

## 先看结论

DSH Headless 在一次进程中创建新的持久化 Agent，执行一项任务，等待停稳并 flush Session，再向 stdout 输出最终文本并退出；随附 Profile 不打开 Web UI 或监听端口。以下操作基于 `0.1.5-rc.1` 固定提交，2026-09-12 核对；本站未使用真实凭据运行任务。

依据：[固定 Headless 说明](https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/README.zh.md)与[运行器实现](https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/src/index.ts)。退出码表示轮次结束状态，不证明生成的答案正确或用户任务验收通过。

新版管道、续接与 JSON 事件另见[0.1.6-alpha.1 差异](#016-alpha1管道输入会话续接与-json-输出)，不要把新参数加到下方 rc.1 示例中。

## 如何运行一次性任务

先确认 Node.js 满足运行版本要求、pnpm/安装环境可用，且已配置模型 Provider 与凭据。进入可丢弃的测试工作区，使用固定版本：

```bash
npx @deepseek-ai/dsh@0.1.5-rc.1 --profile headless "只读取当前目录并概括文件用途，不要修改文件"
```

查看帮助，不执行 Agent 任务：

```bash
npx @deepseek-ai/dsh@0.1.5-rc.1 --profile headless --help
```

npx 仍可能下载包，首次使用 Profile 也可能初始化配置，不能把帮助命令称为绝对无副作用。启动器参数要放在应用参数之前，任务文本作为 Headless 的位置参数传入。任务参数省略或为 `-` 时从标准输入读取；只有空白的参数、空的管道输入，或在交互终端里省略任务，都会被拒绝；一次调用不支持交互式追问。

当前工作目录决定本次 Agent 的 cwd；任务文本中的“不要修改”不是沙箱。凭据准备见[模型与 Provider 配置](/tutorials/deepseek-harness-model-provider/)，不要把 Key 放进任务文本或命令行。

## stdout、stderr 和退出码分别意味着什么

| 信号 | rc.1 固定实现 | 怎样判断 |
|---|---|---|
| stdout | 所属事件区间最后一条非空 assistant 文本，末尾换行 | 作为结果文本，不当成逐步工具执行日志 |
| stderr | 提供方非空推理增量以 `dsh: reasoning:` 开始，也用于错误诊断 | 有内容不等于失败；没有推理增量的成功运行可为空 |
| 退出码 0 | 最终 `turn/end` 为 completed | 继续检查任务自身的文件、测试或其他验收结果 |
| 退出码 1 | aborted、error、没有所属轮次，或启动/驱动失败 | 根据错误信息判断失败阶段，不仅检查 stdout 是否非空 |

运行器按结束原因决定退出码，并非以“有没有答案文本”作为成功条件。stderr 在第一个推理增量之前可能保持安静，不能只凭短时间无输出判断卡死。推理日志和最终输出都可能包含任务信息，分享前脱敏。

在 macOS/Linux 的 shell 中，可以分别保存两路输出并立即读取状态：

```bash
npx @deepseek-ai/dsh@0.1.5-rc.1 --profile headless "只概括当前目录，不要修改文件" > result.txt 2> diagnostic.log
task_exit=$?
printf 'exit=%s\n' "$task_exit"
```

PowerShell 运行后使用 `$LASTEXITCODE` 读取原生程序退出码。重定向会创建本地文件，敏感任务不要将日志自动上传到公共 CI 产物。以上为验证步骤，未作为本站运行成功记录。

## Session 是否保留，下一次能继续追问吗

本版通过注册表创建新的持久化 Agent，提交任务、等待完全停稳、flush Session，再折叠该次调用拥有的事件区间得到最终结果。新一次命令会创建新 Agent，不能当作自动恢复上次聊天。历史会话的读取与恢复另见[Session 指南](/tutorials/dsh-session-guide/)。进程退出也不等于 Session、插件缓存或工作区文件已删除。

需要备份或升级时，按[更新、回退与卸载](/tutorials/dsh-update-uninstall/)分别处理程序、Profile 和数据；不要把打印的最终文本当成完整会话备份。

## Headless、Web minimal 和 Python SDK 怎样区分

| 模式 | 本页核对范围 | 不能直接套用的结论 |
|---|---|---|
| 完整 Headless | rc.1 的 base + headless 组合、任务驱动与退出 | 不能因无界面就认为无网络、只读或不持久化 |
| Web minimal Agent | 0.2.2-rc.1 CLI 文档说明模型侧提供持久 shell、`read_image` 和 `working_directory`，仍有共享 Web 宿主 | 工具少不代表 shell 无法写文件 |
| Python sdk-minimal | 独立组合，CLI 文档说明固定 danger-full-access 且省略审批与权限 settings | 不继承完整 Headless 的权限结论 |
| rc.2 与其他版本 | 本页未完成完整对应核验 | 包已发布不等于本文已经运行兼容验收 |

本轮不提供未经核对的 SDK 安装命令或工具启用 patch。依据：[rc.1 CLI 与模式说明](https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md)。

## 无界面任务怎样处理权限与审批

基于 base 的新会话默认使用 workspace-write 预设。它限制文件修改位置，读取与网络不由这项文件策略限制；部署的工具、patch 与系统后端仍需独立核对。

Headless 不提供浏览器审批界面。`ask` 没有可用应答者时不能放行，`never` 也不是全部允许。不要为绕过审批错误直接切换 danger-full-access。先缩小任务和工作区，按[权限与沙箱指南](/tutorials/dsh-permissions-sandbox/)检查实际策略。

## 首次验证与故障分流

1. 在测试目录记录运行版本、Profile 和工作区，不使用生产凭据。
2. 运行一个范围明确的读取任务，分别记录 stdout、stderr 与退出码。
3. 对照输出检查目录范围，并检查文件差异；退出 0 也需要人工验收结果。
4. 401 或缺少凭据进入[凭据与搜索认证排障](/errors/dsh-missing-credential-401/)；无法写入先检查[工作区与权限](/tutorials/dsh-permissions-sandbox/)。
5. 若需要持续多轮交互，改用[Web UI 安装与启动](/tutorials/deepseek-harness-install-web-ui/)；只有 Web 服务启动失败才进入[启动排障](/errors/web-ui-start-failed/)。

## 0.1.6-alpha.1：管道输入、会话续接与 JSON 输出

以下三项仅适用于 `0.1.6-alpha.1`，2026-09-16 按固定源码核对；上方默认命令和版本卡仍为 `0.1.5-rc.1`。未使用真实模型运行这些示例，不将源码审阅写成跨平台或 CI 验收。

### 从标准输入传入任务

macOS/Linux shell 示例，在可丢弃工作区、已配置测试模型与实际权限策略的前提下运行：

```bash
printf '%s\n' '只回答 OK，不调用工具' | npx @deepseek-ai/dsh@0.1.6-alpha.1 --profile headless -
```

省略任务且 stdin 不是终端，或任务仅为 `-`，才会读取标准输入；读到 EOF 后将完整文本作为任务，保留尾换行。给了普通位置参数时不会读取或自动拼接管道内容。空白位置参数、空管道会被拒绝；`-` 与其他任务词混用也会失败。交互终端上省略任务是用法错误。单独 `-` 读取终端时需要结束输入，不能当成会逐行执行的交互聊天。

“不要调用工具”只是任务文字，不是权限限制。上面是 POSIX 风格 shell 示例，不声称原样适用于 Windows cmd。

### 用 --json 获取运行事件

```bash
npx @deepseek-ai/dsh@0.1.6-alpha.1 --profile headless --json "只回答 OK，不调用工具" > run.jsonl 2> diagnostic.log
task_exit=$?
printf 'exit=%s\n' "$task_exit"
```

stdout 改为逐行 JSON，而非最终答案文本；stderr 保留诊断。正常进入运行器时先有 `session` 事件，其 `sessionId` 是后续续接要保存的精确 ID。`text` 和 `thinking` 来自已提交步骤，不是逐 token 流；中间还可能有 `status`、`tool_call` 和 `tool_result`。`final.text` 保存本次最终文本，但 **出现 final 不等于任务成功**：轮次内失败仍可输出 final，须结合进程退出码与 `status` 的 `turn_end` 原因。

运行器外失败可能输出 `error` 而没有 `final`；加载失败发生在运行器之前时，可能只有 stderr。不要把“没有 final”统一判定为网络错误。除终止 final 外，事件存在截断限制，JSON 投影也会省略未建模事件，因此 `run.jsonl` 不能替代完整 Session 备份。输出可能含任务、推理与工具信息，不自动上传公共 CI 产物。

### 用 --session-id 继续已有会话

从上一次 `session` 事件取得精确 `sessionId`，回到同一工作目录，并使用能访问该持久化数据的原 Profile/数据根；将占位符替换后再执行：

```bash
npx @deepseek-ai/dsh@0.1.6-alpha.1 --profile headless --session-id "替换为实际sessionId" --json "继续上一项任务，只回答简短总结"
```

未知 ID 会失败，不会自动创建空会话。续接要求已组合 Session 查询与持久化服务；记录的 cwd 不匹配或缺失、子 Agent/fork 会话、记录了该运行器不组合的 preset、preset 记录畸形，以及本进程内已有存活 Agent 持有的 ID，都会被拒绝。不要通过改会话 header 绕过检查，也不要让另一个进程同时驱动同一份会话。

每次调用仍只运行一个任务；续接不是保持终端里的多轮交互。旧格式会话是否可读取还受迁移规则约束，不承诺任意 Web 会话或旧版本数据都能续接。无界面不等于自动批准，不把 rc.1 沙箱说明当作对新版所有工具的运行验收；评估前按[升级与备份](/tutorials/dsh-update-uninstall/)和[权限指南](/tutorials/dsh-permissions-sandbox/)核对环境。

依据：[固定 Headless 文档](https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/README.zh.md)、[参数解析](https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/startup.ts)、[任务与恢复校验](https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/index.ts)、[JSON 投影](https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/json-stream.ts)。同版 CLI 总览尚有“缺任务即错误”的旧概述，本节按上述更具体的参数解析与运行器实现说明 stdin 分支。

## 历史版本补充

以下两段是旧批次的版本变化记录，不替代上方 rc.1 操作约定。

## 0.1.5-rc.1：SDK 与平台修复范围

[本次发行说明](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-rc.1)汇总了旧 rc.1 以来的 SDK 变化，包括 Python 单文件 runtime 不再把 Bash 中以 `node` 开头的命令错误重写为 DSH runtime、Windows SDK 启动崩溃修复，以及 macOS x64 runtime wheel。不能把所有汇总项都称为 alpha.2 之后新增。

先确认使用的是 npm CLI 还是 Python SDK、平台与架构、实际运行版本，再选择对应排障路径。完整 SDK、Headless、ACP 的文件工具与 minimal 分开核对；只有持久 shell 也可以写文件，仍不等于只读。本站未执行 SDK 安装和上述故障复现，不提供未经验证的 wheel 安装命令。

## 0.1.5-alpha.2：minimal 默认只有持久 shell

本节仅适用 `0.1.5-alpha.2`：Web `minimal` 与 Python `sdk-minimal` 默认只提供持久 shell，`str_replace_editor` 改为显式启用。完整 SDK、Headless、ACP 的工具集合不能直接套用 minimal 的说明，后文历史示例仍保留各自版本范围。

固定 `sdk-minimal` 文档说明它不继承 `dsh-base`，使用平台对应的 Bash 或 PowerShell，并省略 Web、settings、托管凭据、文件系统工具与 subagent 等层。**工具少不等于只读**：其 danger-full-access 策略允许 shell 修改进程可访问路径，因此只能在隔离工作区评估。

若任务依赖独立编辑工具，先核对实际 Profile 的工具清单与配置，再明确启用；不要因为旧提示词出现工具名就认为工具存在。本页不提供未经本批运行验证的 patch 命令。持久 Bash 的完成和超时状态也应分别检查，不能只看最后一段文本。

来源：[固定 sdk-minimal 文档](https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/bundle/sdk-minimal/README.zh.md)、[发行说明](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.2)。本节为源码与文档审阅，未运行 SDK 或 shell 任务；升级选择见[alpha.2 专题](/tutorials/deepseek-harness-0-1-5-alpha-2/)。

### alpha.4 起，Headless 默认可见 web_fetch

在 `0.1.2-alpha.4` 的固定组合中，完整 Python SDK、Headless、ACP 和只使用 `dsh-base` 的自定义 Profile 默认继承 `web_search` 与 `web_fetch`；不使用 base 的 `sdk-minimal` 不在此范围。这个变化不会改变 stdout、stderr 和退出码的职责，却会扩大模型默认可见的公网工具集合。

官方实现只接受经过验证的公开 `http:`、`https:` 目的地址，但抓取不经过 shell 或文件系统审批 preset，也不需要逐次文件审批。公开地址校验并不能阻止任务内容被发送到公网。受限部署应重新检查 Profile 的 `tool-web` 配置、敏感 URL、签名链接、内网地址、任务输入和日志脱敏，必要时在组合层显式关闭抓取。

“工具可见”不等于所有网址都会成功，也不代表模型一定调用它。本文没有运行 alpha.4 或 alpha.5 的真实网络任务；版本范围、Web PTC 工具变化与升级判断见[alpha.5 更新说明](/tutorials/deepseek-harness-0-1-2-alpha-5/)，底层文件与网络权限继续按[DSH 权限与沙箱指南](/tutorials/dsh-permissions-sandbox/)核对。


## 0.1.3-alpha.2 的默认工具变化怎样影响本文？

2026-09-07 的官方发布说明将 SDK、Headless、ACP 的默认工具补充为可用 `read`、`write`、`edit`；同一说明保留 Web minimal 和 SDK minimal 的精简定位。这是 **0.1.3-alpha.2 的版本变化**，不能反推更早的 `0.1.1-rc.2` 工具组成，也不能据此认为 Headless 只读。[alpha.2 官方发布说明](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.3-alpha.2)

本节记录 `0.1.3-alpha.2` 的历史变化；本文当前操作命令以首屏标明的 `0.1.5-rc.1` 为准。本站未执行真实模型调用或 CI 任务验证。需要评估新版时，先按[版本选择与更新指南](/tutorials/dsh-update-uninstall/)核对目标版本，在隔离副本重新确认默认工具、权限、退出码和 Session 行为。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/cli/reference/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/docs/upgrade-guide/v0.2.1-rc.3/independent-session-forks/guide.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/docs/upgrade-guide/v0.2.1-rc.2/web-fetch-private-destinations/guide.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/apps/cli/config/examples/ptc.yml
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/experimental/auto-review/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/cordis.patch.yml
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/bundle/headless/src/startup.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/bundle/headless/cordis.patch.yml
- https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/docs/upgrade-guide/v0.2.1-alpha.2/stored-credentials-precedence/guide.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/apps/cli/reference/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/startup.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d/packages/bundle/headless/src/json-stream.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/apps/cli/reference/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/src/startup.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/183f08e9c6dde7e36cd2318eaee70b0da08fb35e/packages/bundle/headless/cordis.patch.yml
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-rc.1
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.2
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/bundle/sdk-minimal/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.3-alpha.2
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.1-rc.2
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/apps/cli/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/apps/cli/reference/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/headless/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/headless/src/startup.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/headless/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/headless/cordis.patch.yml
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/base/cordis.patch.yml
- https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/docs/development.zh.md
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.4
- https://github.com/deepseek-ai/deepseek-harness/blob/4e84901e6471b79ec0338099867ebb4606d12bb5/.agents/notes/implemented/feature/2026-09-01-shared-base-web-fetch-default.zh.md
