第 6 卷

2.3 模式一：Web UI（`dsh web`）

启动

dsh web

预期输出：

dsh web: http://127.0.0.1:3080

浏览器打开 http://127.0.0.1:3080。

界面认识（对照截图）


区域内容

左栏会话列表 / 工作区切换 / 新建会话

中栏对话区：输入框、模型选择（DeepSeek V4 Flash）、推理等

级（High）

右侧/底部插件侧边栏（默认空；安装社区插件后出现）

右上Session log（会话日志）/ 轨迹（工具调用轨迹）

第一次对话

1. 点「新建会话」
2. 输入框输入：`你好，请用一句话介绍你自己`
3. 回车发送

预期回复类似：

> 你好！我是 DeepSeek 驱动的 AI 编程助手，可以帮你写代码、调试问题、处理文件、搜索资料，以及完成各种开发和办公任务。

模型与推理档位

点输入框旁的「选择模型」，打开模型与推理档位选择器：


模型定位

deepseek-v4-flash（默认）性价比：快、便宜，日常够用

deepseek-v4-pro旗舰：更强，更贵更慢

**推理等级**（思考模式三档，2026-08-13 起支持）：

批量、工具链廉价轮次

划

<!-- [fix] 技术准确性核验：上表档位为本白皮书实测环境（pi-ai / opencode-go 网关）所支持。DeepSeek 官方适配器（默认 provider=deepseek-official，llm-deepseek 插件）

只接受 `off`（关闭思考，最快）/ `high` / `max` 三档，`low` 会抛 `UNSUPPORTED_REASONING_EFFORT`。在 settings.yaml 里对默认 provider 请使用

`off` / `high` / `max` -->

> 💡 **性能关键认知**：模型在**每次工具调用前都会重新思考**。实测一个"创建文件"任务，思考占 ~90% 墙钟时间；50 步工具链任务思考累计可达数分钟到十几分钟。**调低推理档位是性

价比最高的提速手段**（见第 6 章 + 示例提速插件）。

2.4 模式二：Headless（一次性任务，适合脚本/CI）

dsh --profile headless "你好，请用一句话介绍你自己"

预期输出（打印结果后进程退出）：

你好！我是 DeepSeek 驱动的 AI 编程助手，可以帮你写代码、调试问题、处理文件、搜索资料，以及完成各种开发和办公任务。

**Headless 的核心价值**：

• **自动化**：可进 CI、服务器、cron
• **脚本友好**：非零退出码 = 失败；输出可管道处理
• **会话隔离**：每次调用一个新鲜会话（`--resume` 可恢复，见 `dsh --profile headless

--help`）

**实战**：写个脚本每天跑一次"生成日报"：

dsh --profile headless "读取工作区今天的 git log，生成一份中文日报摘要" > daily-report.md echo "exit=$?"

2.4.1 官方四种运行模式总览

> 来源：官方站点 https://deepseek.com/harness/ 与官方仓库 `docs/`（2026-08 快照）。前两节（web / headless）是白皮书实测详讲的；后两种模式官方已公布但白皮书暂未逐项实测。

个工具

次程序内编排多轮工具调用

• 组合新模式

> 对新手：日常用 **Standard（web）**、脚本用 **Headless** 即可；Code/Creator 模式属于进阶能力，等官方文档稳定后再深挖。官方文档站（VitePress）：https://deepseek-

harness.github.io/deepseek-harness/

2.5 你的第一个插件：给 web 加个 Git 面板

dsh 的侧边栏默认是空的——安装社区插件 `dsh-better-sidebar` 体验"一切皆插件"（详细原理见第 3 章，这里先跑通）：

# 1. 找到你的 web profile #Windows: %USERPROFILE%\.dsh\profiles\web #macOS/Linux:

~/.dsh/profiles/web # 2. 在 package.json 的 dependencies 加一行（link: 指向插件源码） # "dsh-better-sidebar": "link:C:\\path\\to\\DSH-better-sidebar" # 3. 在 cordis.patch.yml 加挂

载行 #- insert: #- id: better-sidebar #name: dsh-better-sidebar # 4.

安装并重启 cd ~/.dsh/profiles/web && pnpm install #（Windows cmd 下 `~` 不展开，请用：cd %USERPROFILE%\.dsh\profiles\web） dsh web

重启后，右侧出现文件管理 / 终端 / **Git 面板** / 浏览器等标签：


> 图中「拉取远端 / 拉取合并 / 推送」按钮是社区 PR 实现的（见第 5 章案例）——**这就是"插件生态"的运转方式**。

2.6 配置与目录速查

首次运行后生成的目录：

~/.dsh/ ├── settings.yaml# 全局设置（模型、推理档位） ├── profiles/# profile 目录 │└── web/ │├── package.json# 插件依赖 + 清单 │└──

cordis.patch.yml# 补丁层（挂载插件） ├── sessions/# 会话数据 └── storages/ # 持久化存储

`settings.yaml` 示例：

agent-default-model:model: deepseek-v4-flashreasoningEffort: high

2.7 命令速查

命令用途

dsh web启动 Web UI（=dsh --profile