第 2 章　第一次启动：桌面、模型、工作区

约 4 分钟 · 1,965 字 · 12 个小节

本章你会学会

• 打开 DSH Desktop；
• 连接一个模型；
• 选一个安全的工作区；
• 用标准模式完成第一次只读对话；
• 看懂界面上的工具卡片和审批提示。

2.1 打开 Desktop

安装完成后，打开 DeepSeek Harness。

第一次打开时，你可能会看到：

• 欢迎页；
• 模型/账号设置；
• 工作区选择；
• 新建任务输入框。

不同版本界面会略有差异，但顺序基本是：

打开应用 → 连接模型 → 选择工作区 → 新建任务 → 开始对话

如果你还没有模型服务，先看下一节。

2.2 连接模型

DSH 需要一个模型来“思考”。通常有两种方式：[1][2]

1. DeepSeek 官方账号/API：在设置里登录或填入 API Key；
2. 兼容 OpenAI 接口的提供方：填入 Base URL、API Key、模型名。

操作路径

通常在：

设置（Settings） → 模型（Models） → 添加/选择提供方

你需要准备：

• Provider（提供方）；
• API Key；
• 模型名称（例如 deepseek-chat / deepseek-flash，以实际提供方为准）；
• 可选的 Base URL。

怎么判断成功

• 设置页显示模型已连接；
• 新建任务后，Agent 能正常回复；
• 没有 401、Invalid API key 之类的错误。

常见错误：401

401 基本只有一个意思：Key 不对，或者没有生效。

检查：

• Key 是否复制完整；
• 是否有多余空格；
• 提供方和 Base URL 是否匹配；
• 账号是否有余额/权限；
• 是否把别的服务的 Key 填到了这里。

不要把 API Key 贴进对话里让 Agent 帮你检查。 在设置页里改。

2.3 选择工作区

工作区就是 Agent 工作的文件夹。

第一次使用，建议这样做：

1. 在桌面或文档目录新建一个空文件夹，例如 dsh-test；
2. 在里面放一两个不重要的文本文件；
3. 在 DSH 里选择这个文件夹作为工作区。

为什么不用整个用户目录？

• Agent 能看到的东西太多，容易误操作；
• 上下文会变复杂；
• 出问题不好回滚。

工作区选好后，Agent 的“当前目录”通常就是这个文件夹。它读写相对路径时，默认以这里为基准。

2.4 选择标准模式

新建任务时，通常会让你选一个 Agent Preset（模式）。

第一次使用，选 标准模式（Standard）。

标准模式有完整的日常工具：读写文件、运行命令、搜索、子代理、计划、待办、交付文件。

不要一上来选 创造模式（Creator）。创造模式是给“扩展 DSH 本身”用的，会多出插件管理、运行时检查等能力，也会带来更高的权限风险。第 7 章会详细讲。

2.5 界面地图

你不需要记住每个按钮，但要知道四类信息在哪里：

最重要的习惯：

不要只看 Agent 的最后一段话，要看它中间做了什么。

工具卡片会告诉你它读了哪些文件、跑了什么命令、改了什么东西。

2.6 第一次对话：只读、可观察

第一次不要让它改文件。先做两个只读练习。

练习一：自我介绍

输入：

你好。请用三句话介绍你能做什么、不能做什么。
先不要读取或修改任何文件。

观察它是否：

• 说明自己是 Agent；
• 说明需要工作区/权限；
• 没有擅自调用工具。

练习二：只读盘点

输入：

请只读当前工作区的文件，按类型分组列出来。
不要修改任何文件，也不要运行会改变文件的命令。
最后告诉我你用了哪些工具。

你会看到类似这样的工具卡片：

读取目录
读取文件

如果它想写文件，你可以拒绝，并提醒：

这一步只需要只读，请不要写入。

2.7 第一次对话的目标

不是“让它做一件大事”，而是让你熟悉三件事：

1. 它会在哪里工作：工作区；
2. 它怎么做事：工具调用；
3. 你怎么控制它：审批、拒绝、补充要求。

换一种入口：Web / Headless

• Web：通常用 dsh --profile web 启动，浏览器打开带 token 的地址。界面与 Desktop 类似，适合远程服务器。
• Headless：用 dsh --profile headless "你的任务" 一次性执行，没有图形界面，适合脚本/自动化。
• Desktop：由桌面应用管理 desktop profile，不建议手动改它的配置文件。

本书后续仍以 Desktop 为主。

常见坑

• 没连模型就开始任务：只会得到错误或空回复。
• 工作区选得太大：先小后大。
• 一上来就选创造模式：日常任务用标准模式。
• 把 Key 贴在聊天里：在设置里填。
• 只看最后一段话：中间的工具调用才是它真正做的事。

小结

• 启动顺序：打开应用 → 连模型 → 选工作区 → 选标准模式 → 开始对话。
• 401 先查 Key。
• 工作区要小、要可回滚。
• 第一次对话以只读为主，观察工具卡片。
• 标准模式是日常默认；创造模式是另一件事。

参考

1. DeepSeek Harness 快速开始
2. 配置模型

链接均为公开来源；产品行为可能随版本变化。