DeepSeek Harness 桌面版使用
DeepSeek Harness 是 DeepSeek 推出的开源 AI Agent 工作环境，不只是回答问题的聊天窗口，还可以围绕本地工作区读取文件、执行命令、编写代码和处理文档。
现在 DeepSeek Harness 提供了 Windows 和 macOS 桌面版，安装后打开应用即可使用，不必先配置 Node.js 或手动启动网页服务。
本篇重点介绍桌面版的下载安装、界面区域、首次设置和实际任务操作。
官方网站：https://www.deepseek.com/harness/
DeepSeek Harness 桌面版是什么？
普通 AI 聊天主要输出文字，而 Harness 可以在授权范围内调用工具并操作工作区文件。
桌面版将 Harness 的 Web 界面和本地运行环境封装在桌面应用中，使用方式更接近常见的编辑器和办公软件。
| 功能 | 能够完成什么 | 使用场景 |
|---|---|---|
| 文件处理 | 读取、整理、修改工作区文件 | 整理 Markdown、表格、文档 |
| 编程开发 | 分析项目、编辑源码、执行测试命令 | Python、前端和其他软件项目 |
| 工作区管理 | 围绕指定目录创建会话 | 让任务与具体项目关联 |
| 插件 | 安装或开发能力扩展 | 增加特定工具、界面和技能 |
| 自动化任务 | 按计划执行任务（依赖相应插件） | 定期整理项目记录、生成周报 |
| 执行轨迹 | 查看运行轮次和工具调用详情 | 调试 Agent 行为及排查问题 |
下载与安装桌面版
访问 DeepSeek Harness 官方页面，选择相应系统的桌面安装包。
| 系统 | 官方提供的版本 | 安装方式 |
|---|---|---|
| Windows | 64 位 | 下载安装程序，按照安装向导操作 |
| macOS | Apple 芯片版本 | 打开 DMG，将应用拖入"应用程序"文件夹 |
Windows 安装完成后，可以从开始菜单打开 DeepSeek Harness。
-
macOS 安装完成后，可以从应用程序或启动台打开。
安装版已包含应用所需的运行环境，普通用户不必另行安装 Node.js、pnpm，也不需要执行 dsh web。
请优先从官网获取安装包。本文介绍的是 DeepSeek 官方桌面版，不要与 GitHub 上同名的第三方桌面封装混淆。
桌面版界面介绍
首次进入工作区后，可以把应用理解为三个主要区域：左侧导航、中央对话与任务区，以及任务执行和结果查看区域。
下面是根据官网展示内容绘制的布局示意，具体按钮位置以实际安装版本为准。
| 区域 | 主要功能 | 操作建议 |
|---|---|---|
| 新会话 | 发起独立任务 | 一个相对独立的目标使用一个会话 |
| 工作区 | 选择要处理的本地项目文件夹 | 从测试目录开始 |
| 会话区 | 查看回答、执行步骤与输出结果 | 检查工具做了什么，而不只看最终回答 |
| 输入区 | 填写任务、引用文件、指定要求 | 说明目标、范围和禁止操作 |
| 插件 | 管理扩展和技能 | 优先启用来源可信的插件 |
首次配置模型
首次使用前，需要确认模型服务已经配置完成。
在应用的设置页面找到模型配置入口，按当前版本提供的方式填写 API 凭据或完成支持的账号接入。
| 项目 | 作用 | 说明 |
|---|---|---|
| 模型提供方 | 选择使用的模型服务 | 优先选择官方明确支持的提供方 |
| API Key | 用于模型 API 鉴权 | 通过官方 API 平台申请，申请地址：https://platform.deepseek.com/api_keys |
| 模型 | 指定执行任务的模型 | 按应用内当前可用模型列表选择 |
| 自定义端点 | 连接兼容的模型接口 | 仅在了解兼容性和数据安全时配置 |
配置成功后，先创建一个新会话，输入：
你好，请简单介绍你有哪些能力。暂时不要修改任何文件。
能够得到模型回复，就说明基本会话功能已经可用。
不要将 API Key 放在对话内容、项目 README 或共享截图中。模型 API 可能产生独立的调用费用，具体以账号和服务商计费规则为准。
选择工作区并创建会话
工作区是 Harness 执行文件任务的基础。
建议先在电脑上创建一个专门的测试文件夹，不要直接选择包含重要数据的整个磁盘或个人主目录。
实例
mkdir -p ~/runoob-harness-demo
# 创建一个测试说明文件
printf '# RUNOOB Demo\n这是一个 Harness 测试项目。\n' > ~/runoob-harness-demo/README.md
Windows 用户也可以直接在"文档"中创建 runoob-harness-demo 文件夹，然后新建一个 README.md。
返回桌面应用，选择"工作区"或"选择工作区"，在系统文件夹选择器中选中这个目录。
确认工作区后，创建新会话，即可围绕该文件夹处理任务。
实战：让 Harness 分析一个项目
新手的第一个任务建议只读，不要立刻让 Agent 大规模修改代码。
在输入框粘贴以下提示词：
实例
要求：
1. 查看当前目录中的文件和子目录。
2. 阅读 README.md，概括项目用途。
3. 如果有代码，说明使用了哪些语言和框架。
4. 给出三条改进建议。
5. 这次任务只允许读取，不要修改或删除任何文件。
Harness 可以根据任务需要调用文件读取、搜索或终端工具。
执行过程中，应留意工具请求和权限提示，确认没有超出预期的文件操作。
最终结果一般会包含项目说明、文件结构和建议。具体内容取决于工作区真实文件。
实战：让 Harness 生成一个网页
熟悉只读任务后，可以尝试在测试目录中创建一个小网页。
实例
要求：
1. 页面标题为 RUNOOB Python 学习计划。
2. 使用原生 HTML、CSS 和 JavaScript。
3. 页面包含学习路线、每日任务和进度勾选。
4. 采用响应式布局，手机也可以正常使用。
5. 不引入任何外部付费服务。
6. 仅允许创建或修改 index.html，不要删除其他文件。
7. 完成后检查文件是否存在，并说明如何本地预览。
执行完成后，在工作区中打开 index.html，即可检查生成的实际页面。
如需继续完善，可以在同一会话中提出增加深色模式、优化移动端布局等明确要求。
关键不是一次生成多复杂的结果，而是让每次修改都能检查、预览和回退。
预览效果：
插件页面与创造模式
DeepSeek Harness 的一个核心设计是 一切皆插件。
官网展示了插件管理页面，以及通过对话创建"番茄时钟"插件的示例。
在桌面版中，可以进入"插件"页面查看当前可用和已安装的扩展。
| 功能 | 用途 |
|---|---|
| 官方插件 | 使用产品提供的扩展能力 |
| 社区插件 | 安装第三方功能，需自行评估来源和权限 |
| 创造模式 | 通过对话辅助生成和安装插件 |
| 插件管理 | 检查已安装扩展、启用情况及必要的重启提示 |
例如可以尝试：
帮我设计一个简单的番茄钟插件，包含 25 分钟专注和 5 分钟休息。先给出实现方案和需要的权限，不要直接安装。
确认方案后，再决定是否创建和安装。
第三方插件可能获得本地工具或文件访问能力。正式安装前应检查来源、依赖、权限和运行行为，不要把"插件能安装"当成"插件安全"。
点我分享笔记