⚡ dsh 完全配置优化指南

⚡ npm 一键启动（推荐，最简单）#

前置要求： Node.js 18+（推荐 20+）

1
# 方法一：npx 直接运行（无需安装）
2

3
npx @deepseek-ai/dsh web   # 官方一行启动命令；本地界面端口为 3080
4

5
# 方法二：全局安装（推荐，更新方便）
6

7
npm install -g @deepseek-ai/dsh
8

9
dsh   # 启动 Web UI
10

11
# 方法三：终端 TUI 模式
12

13
dsh --tui

启动后访问 http://localhost:3080（Web UI 默认端口）。首次启动会引导配置 API Key。

🐳 Docker 部署（服务器推荐）#

1
docker run -d \
2

3
--name dsh \
4

5
-p 5173:5173 \
6

7
-v ~/.dsh:/root/.dsh \
8

9
-v /var/run/docker.sock:/var/run/docker.sock \
10

11
--restart unless-stopped \
12

13
# 官方文档未公开此镜像名，请以官方仓库说明为准
14
# deepseek/dsh:latest

访问 http://服务器 IP<5173> 打开 Web UI。

🔧 源码安装（开发者/想改代码）#

1
git clone https://github.com/deepseek-ai/deepseek-harness.git
2

3
cd dsh
4

5
npm install
6

7
npm run build
8

9
npm start   # 或 npm run dev 开发模式

📦 其他环境#

macOS： npm 全局安装即可，支持 Apple Silicon 和 Intel

Windows： npm 全局安装，或使用 WSL2（推荐）

Linux 服务器： Docker + systemd 守护进程

树莓派/ARM： Docker 镜像支持 linux/arm64

💡 更新： npm update -g @deepseek-ai/dsh（或重新执行 npx）

🖥️ 桌面版优势场景#

• 日常编程对话（Web UI 代码高亮、diff 预览）
• 可视化管理插件（dsh-do / dsh-plugin-manager）
• 会话 fork/replay 可视化操作
• VS Code 侧边栏集成（边写代码边对话）
• Token 用量实时监控
• 非纯命令行用户首选

💻 终端版优势场景#

• 服务器/SSH 远程管理（无 GUI）
• TUI 界面（dsh —tui），终端里也能鼠标操作
• 自动化脚本和 CI/CD 集成
• Profile 快速切换（dsh —profile web）
• 查看原始日志和调试
• 开发者和运维首选

桌面版： 社区提供了 Electron 与 Tauri 两种桌面壳，以及 VS Code 侧边栏扩展；这些均非官方出品，安装前请自行甄别来源。Web UI 启动后访问 http://localhost:3080。

▍初始配置向导#

1. 启动 dsh 后，Web UI 会引导配置
2. 输入 DeepSeek API Key（platform.deepseek.com 获取）
3. 选择默认模型（推荐 deepseek-v4-pro）
4. 选择默认运行模式（推荐先试 standard，熟悉后用 code）
5. 配置工作目录（默认 ~/.dsh/workspace）
6. 完成，开始使用

▍四种运行模式详解（dsh 核心特色）#

1
# 切换模式
2

3
# 预设的切换方式以官方文档 / dsh --help 为准（配置或 profile 层选择）
4
# dsh --profile <方案名>（无 --mode；预设按会话选 ptc）   # 启动时指定 code 模式
5

6
dsh --profile <方案名>（无 --mode；预设按会话选 minimal）       # 极简模式
7

8
# 或在 Web UI 中切换（设置 → 运行模式）
9

10
# 或在对话中切换预设（具体命令以 dsh --help 为准）

▍添加模型提供商#

1
# 字段路径以 dsh --profile web --dump-config 的输出为准
2
编辑 ~/.dsh/settings.yaml 的 agent-default-model（无 dsh config 命令）

1
# dsh 的模型是插件，可以安装任意 OpenAI 兼容模型插件
2

3
dsh plugin --profile <方案名> add @dsh/model-openai-compatible
4

5
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：model.base_url "https://api.moonshot.cn/v1"
6

7
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：model.api_key "sk-你的kimi-key"

▍DeepSeek 一方优化（dsh 独有优势）#

dsh 是 DeepSeek 官方出品，对 DeepSeek 模型有深度优化：

• Prefix Cache（前缀缓存）：DeepSeek 官方默认开启磁盘前缀缓存，命中/未命中单价约差 50 倍（$0.006 vs$0.3 / 1M，高峰价）；官方文档为 best-effort、不保证命中率（36 氪报道的 99.93% 是特定集成个案）
• 工具调用优化：针对 DeepSeek 模型的工具调用格式做了专门调优，减少无效调用
• code 模式深度集成：DeepSeek 模型的代码生成能力强，code 模式效果最好
• 上下文压缩优化：针对 DeepSeek 的长上下文能力做了压缩策略调优

实测数据： DEV Community 用户用 dsh + DeepSeek 处理 8 亿 Token 只花了 $36（约 ¥260），平均每百万 Token $0.045。这是前缀缓存 + code 模式的综合效果。

▍code 模式 vs 传统模式对比#

▍code 模式配置与使用#

1
# 启动时指定 code 模式（参数形式以 dsh --help 为准）
2

3
dsh --profile <方案名>（无 --mode）ptc
4

5
# 或在对话中切换当前会话
6

7
/mode ptc
8

9
# 配置 code 模式参数
10

11
# 键名以 dsh --profile <名> --dump-config 输出的实际值为准
12
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：mode code
13

14
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：sandbox.type docker # 用 Docker 沙箱执行程序（安全）
15

16
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：ptc.max_program_length 200
17

18
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：ptc.batch_size 10

code 模式要求模型有较强的代码生成能力。DeepSeek-v4-pro 效果最好。如果用其他模型，可能需要调整 max_program_length。

📚 权威依据： AWS Bedrock 官方博客《Implementing programmatic tool calling on Amazon Bedrock》（2026-05-19）在 8 个模型上实测 PTC 使 Token 消耗下降 87–92%，成本估算降约 90%；文中亦明确说明该范式“模型无关、不再依赖特定厂商”。36 氪报道的 99–100% 是 dsh 与 DeepSeek 的 缓存命中率；另有第三方基准称 DeepSeek V4 Flash 在 dsh 上单任务成本约 $0.028、低于 Claude Code 的约 $0.195（7 倍差）。「8 亿 Token 花 $36」出自单篇社区文章，属个例。

🔴 优化 1：批量任务用 code 模式（同类范式实测省 87–92%，效果最大）#

对于批量操作、文件处理、重复性任务，程序化工具调用可以把中间结果留在沙箱里、只回传最终摘要，实测可减少 87–92% 的 Token 消耗。需要说明的是这套范式并非 dsh 独有，dsh 的价值在于把它做成了开箱即用的预设。

1
dsh --profile <方案名>（无 --mode；预设按会话选 ptc）   # 预设切换的确切参数以 dsh --help 为准
2

3
# 或在会话内切换预设

注意：code 模式适合批量操作，复杂决策任务仍用 standard 模式。切换预设的具体命令请以 dsh —help 为准。

🟠 优化 2：用 DeepSeek 模型 + prefix cache（省 60-80% 输入成本）#

dsh 由 DeepSeek 官方开源，与 DeepSeek 的输入缓存机制天然对齐，系统提示词与重复上下文可被缓存，输入侧成本明显降低。

1
# 字段路径以 dsh --profile web --dump-config 的输出为准
2
编辑 ~/.dsh/settings.yaml 的 agent-default-model（无 dsh config 命令）
3

4
# prefix cache 是 DeepSeek API 自动开启的，无需额外配置

🟡 优化 3：子任务用便宜模型 + 启用压缩（省 20-30%）#

1
# 子 Agent 用便宜模型
2

3
delegation.model
4

5
# 启用上下文压缩
6

7
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：context.compaction.enabled true
8

9
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：context.compaction.threshold 0.7
10

11
编辑 ~/.dsh/settings.yaml（无 dsh config 命令）：context.compaction.model "deepseek-flash"

🟢 优化 4：用 minimal 模式做简单任务（省 15-25%）#

minimal 模式只保留 bash + 文件编辑器，系统提示词最短。简单编辑、快速问答时用 minimal 模式比 standard 省很多。

1
# 简单任务用 minimal 模式
2

3
dsh --profile <方案名>（无 --mode；预设按会话选 minimal）
4

5
# 或 /mode minimal

▍使用习惯（dsh 编程场景特供）#

▍推荐省 Token 插件#

在 dsh.so 或运行 dsh plugin search “token” 发现更多。

▍“一切皆插件”的 Cordis 架构#

dsh 基于 Cordis 插件内核 构建，以下全部是可替换的插件：

• 🧠 模型适配器
• 🔧 工具集
• 💬 会话存储
• 📦 沙箱
• 🔄 执行循环
• 🎨 Web UI
• 🤖 子 Agent
• 📋 工作流
• 💬 消息渠道

这意味着你可以把任何组件换成自己喜欢的实现。比如把模型从 DeepSeek 换成 Claude，把会话存储从 SQLite 换成 PostgreSQL，把沙箱从 Docker 换成 SSH。

🏪 dsh.so（官方推荐市场）#

• 网址： dsh.so
• 特点： 官方推荐的插件信任与发现市场
• 安全提示：从第三方市场安装插件前，请自行审查其代码与权限
• 中文支持： 完整中文界面和文档
• 安装： dsh plugin —profile web add <插件名>

🖥️ dsh.do（市场+桌面面板）#

• 网址： dsh.do（社区站点）
• 特点： 插件市场 + 桌面管理面板
• 安装面板： npm i -g dsh-do
• 功能： 可视化管理插件、查看状态、一键安装

🌐 其他插件市场#

• dshmarketplace.dev / dshplugin.app：第三方站点，请谨慎对待
• GitHub topic: dsh-plugin：GitHub 上的 dsh 插件
• 设置页可见约 133 个插件（官方内置插件清单）

📚 文档与社区#

• 官方文档： deepseek-harness.github.io/deepseek-harness/
• 官网： deepseek.com/harness
• GitHub： github.com/deepseek-ai/deepseek-harness
• Discord： DeepSeek 官方 Discord
• 中文社区： 掘金/CSDN/V2EX 搜索 dsh

▍插件管理命令#

1
dsh plugin --profile <方案名> list                    # 列出已安装插件
2

3
dsh plugin search "关键词"          # 搜索插件
4

5
dsh plugin --profile <方案名> add <名称>           # 安装插件
6

7
dsh plugin --profile web add <名称> # 从 dsh.so 安装
8

9
dsh plugin enable <名称>            # 启用插件
10

11
dsh plugin disable <名称>           # 禁用插件
12

13
dsh plugin uninstall <名称>         # 卸载插件
14

15
dsh plugin update                   # 更新所有插件

▍append-only 事件日志（dsh 特色会话管理）#

dsh 的会话存储是 append-only 事件日志——所有交互（用户消息、工具调用、模型回复）都以事件形式追加写入，不可修改。这带来了独特的能力：

1
在 Web UI 中操作（无 dsh session 命令）：list                # 列出所有会话
2

3
在 Web UI 中操作（无 dsh session 命令）：resume          # 恢复历史会话
4

5
在 Web UI 中操作（无 dsh session 命令）：fork            # 从历史节点分叉新会话（类似git branch）
6

7
在 Web UI 中操作（无 dsh session 命令）：replay          # 重放会话（重新执行所有事件）
8

9
在 Web UI 中操作（无 dsh session 命令）：search "关键词"      # 全文搜索历史会话
10

11
在 Web UI 中操作（无 dsh session 命令）：export          # 导出会话为 JSON

省 Token 技巧： 用 fork 从历史节点分叉尝试不同方案，不用重新开始整个会话。用 search 快速定位历史对话，不用翻长长的上下文。

▍消息渠道配置（dsh 短板，全靠社区插件）#

dsh 官方不内置消息渠道，需要安装社区插件。以下是常用的渠道插件：

注意： dsh 的渠道插件都是社区维护，稳定性和功能完整性不如 OpenClaw/Hermes 的官方渠道。如果消息渠道是核心需求，建议用 OpenClaw 或 Hermes。dsh 更适合在 Web UI/终端中直接使用。

▍Q: dsh 和 Claude Code 有什么区别？#

A: dsh 是开源的 Claude Code 替代品，基于“一切皆插件”架构。相比 Claude Code：① 完全开源 MIT 协议 ② 支持任意模型（不绑定 Anthropic）③ 程序化工具调用（code 模式）在批量场景可省 87–92% Token ④ 可深度定制每个组件 ⑤ append-only 会话日志支持 fork/replay。但 Claude Code 的成熟度和工具生态目前更完善。

▍Q: code 模式什么时候用？什么时候不用？#

A: 用 code 模式： 批量文件操作、重复性任务、数据处理、多步骤有明确流程的任务。 不用 code 模式： 探索性任务、需要每步根据结果调整决策的复杂任务、创造性工作。可以在对话中随时 /mode 切换。

▍Q: 怎么查看 Token 消耗？#

A: Web UI 右上角显示当前会话 Token 用量。运行 （无此命令；用量见 Web UI） 查看统计。也可安装社区监控类插件，做更精细的计量。

▍Q: dsh 支持微信/飞书吗？#

A: 官方不内置，需要安装社区插件（dsh-wx-bridge、dsh-feishu-gateway 等）。稳定性不如 OpenClaw/Hermes。如果消息渠道是核心需求，建议用 OpenClaw（飞书最好）或 Hermes（微信/钉钉最好）。dsh 更适合在 Web UI 中直接编程使用。

📌 总结#

dsh 是三者中最极客、最高效的编程 Agent——一切皆插件可深度定制，code 模式在批量场景可省 87–92% Token，与 DeepSeek 输入缓存机制对齐，专为编程场景设计。

省 Token 三步走（dsh 特供）： ① 批量任务用 code 模式（AWS 基准 87–92%）② 用 DeepSeek 模型充分利用输入缓存③ 简单任务用 minimal 模式 + 子任务用便宜模型

dsh 的短板是消息渠道（全靠社区插件）和上手难度（面向开发者）。如果你主要写代码，dsh 是最佳选择；如果你需要在微信/飞书里用 AI，选 OpenClaw 或 Hermes。

参考来源：DeepSeek Harness 官方仓库与文档站 github.com/deepseek-ai/deepseek-harness· InfoQ《The Open-Sourcing of DeepSeek Harness》· AWS Bedrock 官方博客《Implementing programmatic tool calling on Amazon Bedrock》（2026-05-19）· DeepSeek 官方站点 · 以及社区评测

dsh 完全配置优化指南 · 2026 年 9 月

本文已于 2026-09-23 依据官方文档与本机实测校订（命令与配置键以 Hermes v0.21.3 / OpenClaw 2026.9.5 / dsh 0.1.5-rc.2 为准）。