天工开物KAIWU AI
工具指南 › DeepSeek Harness › DeepSeek Harness 使用指南(完整全套)
核实于 2026-11-08
工具指南·其三核实于 2026-11-08

DeepSeek Harness 使用指南(完整全套)

适用对象
想快速了解工具定位、核心功能和上手路径的中文用户
核对日期
2026-11-08
本页目录

本指南综合了 10 篇公众号实测与深度教程(2026-08-14 ~ 11-04)。文中 [1]~[10] 对应文末「参考原文」,序号与 00_清单.md 一致。每张图下方注明出处与对应文章。素材之间说法不一致、早期版本与新版存在差异,或可能已经过时的地方,均用 ⚠️ 明确标出。

公众号素材多集中在 8 月初版开源热潮与 10~11 月官方桌面端上线两个时间段。为给开发者和进阶用户提供最完整的一手依据,指南补充了 DeepSeek 官方 GitHub 仓库、开放平台 API 规范与社区生态文档,以 [官1]~[官8] 标注,查阅日期 2026-11-08。


一、定位:它是什么,适合谁

DeepSeek Harness(终端命令名为 dsh,社区常昵称为"大肥鱼"或"单身汉")是 DeepSeek 团队开源的自主 AI Agent 工作台与代码 Harness 框架 [4][8]。它在 2026 年 8 月中旬开源发布,短短数天内在 GitHub 上星标突破 12 万,10 月底突破 17 万 [4][8][10]。

它不仅是一个简单的聊天框或代码补全插件,而是一套给 AI 配备本地系统工具、管理上下文记忆、调度多智能体协作的完整 Agent 宿主环境(Harness) [4][5]。用户给出自然语言目标,它能自主拆解步骤、阅读与编辑本地项目文件、运行终端命令行、执行测试脚本、根据报错自行修复代码,甚至驱动第三方模型与桌面扩展协同干活 [4][8]。

图 1 桌面版主界面

图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》

1. 核心形态演进

DSH 目前提供了四种交互入口 [1][4]:

入口形态运行环境特点与定位适合人群
桌面端客户端(Desktop)Windows / macOS 独立 App2026 年 10 月官方正式推出,内置运行环境与可视化交互,一键安装、开箱即用 [1][2]绝大多数初学者、内容创作者、不愿折腾命令行的开发者
命令行终端(CLI dsh)macOS / Linux / Windows 终端8 月开源首发入口,纯终端全键盘操作,轻量极速,适合无头服务器与自动化批处理 [4][5]资深程序员、DevOps 工程师、自动化工作流搭建者
VS Code 插件IDE 侧边栏与编辑器窗口内置于开发环境中,与现有代码库无缝结合,直接在编辑区呈现 Diff [4]日常以 VS Code 为核心工作台的工程师
Web 云端内测版浏览器网页端(dsh.deepseek.com)免本地安装,通过云端沙箱运行轻量任务与代码演示 [10]临时演示、移动端轻量查阅、无本地开发环境用户

2. 和同类 AI 编码工具怎么比

维度DeepSeek Harness (DSH)Claude CodeOpenAI Codex / ChatGPT DesktopCursor / 传统 AI 补全
底层核心自主 Agent 框架 + 开放 Harness [4]终端/桌面 Agent,端到端编码 [8]云端沙箱 / 桌面 AgentIDE 编辑器内行级补全与侧边栏对话
开源与自主权框架完全开源,允许深入魔改核心逻辑 [4]闭源商业产品闭源商业产品闭源商业客户端
模型支持完全开放,原生支持 DeepSeek,可自由配置任意第三方及本地模型 [3][5]深度绑定 Claude 官方模型(第三方中转受限)绑定 OpenAI 官方模型支持多模型切换,但核心调度逻辑闭源
生态扩展开放插件体系(dshmarket),支持二次开发桌宠、UI 定制与外部自动化 [2][7]支持官方 Skills 与 MCP 协议支持 GPTs 与 Tools支持 Rules 与 外部 MCP
资费门槛框架免费,仅消耗模型 Token(单价极低),普通人使用成本极其廉价 [10]需订阅 Claude Pro/Team 或昂贵 API需订阅 ChatGPT Plus 或 API需按月订阅 Pro 席位

适合谁:

  • 想降本增效的开发者:平时受够了昂贵海外 API 额度限制,希望用单价极低且代码逻辑极强的 DeepSeek 模型全自主修 Bug、跑测试、写脚手架 [8][10]。

  • 喜欢深度定制工具的极客:不满足于固定界面,希望自己写插件、换主题、造个性化桌宠(如大肥鱼)、挂载自定义 MCP 工具的玩家 [2][7]。

  • 手头有大量"繁琐但不紧急"维护任务的人:例如老项目依赖升级、单元测试补全、日志清理、多仓库批量文档格式化等,交给 DSH 自主循环处理最划算 [8]。

不适合谁:

  • 只想把 AI 当搜索引擎或写写闲聊对话的人(直接用网页版 DeepSeek 即可,无需在本地挂载带文件系统权限的 Harness)[8]。

  • 无法接受命令行配置或对本地系统安全极其敏感、无法提供沙箱隔离环境的企业核心生产机 [4][8]。


二、准备与安装

0. 先选路线:你属于哪种情况

你的情况推荐路线核心步骤
第一次接触,不想敲命令,只想在图形界面里用桌面版客户端(推荐)看第 1、2 步 → 第三节快速上手
熟悉终端、有 Linux 服务器,或需要长期挂机运行命令行 CLI (dsh)看第 1、3 步 → 第四节进阶配置
想要现成的 VS Code 边写边测体验VS Code 插件版看第 1、4 步
没有国内网络限制,或想把硅基流动、Kimi 等多模型接入混用任意入口 + 自定义模型供应商看第 1 步 → 第四节「2. 接入第三方模型与 API Key」

1. 账号与费用

  • 软件本身:DeepSeek Harness 核心项目与桌面端为开源免费软件,不收取任何客户端软件授权费 [4]。

  • 模型费用来源:

    1. 官方账号直连(桌面版默认):直接使用 DeepSeek 官方账号授权登录,直接扣除你 DeepSeek 账号绑定的官方充值余额或赠送代金券 [1]。DeepSeek V3(deepseek-chat)与 R1(deepseek-reasoner)的官方 API 单价极具性价比(百万 Token 仅数毛钱至几元)[8]。

    2. API Key 计费:如果填入第三方平台(如硅基流动 SiliconFlow、派欧云 PPIO、火山引擎)或本地 Ollama 模型,费用由对应平台或本地算力承担,DeepSeek Harness 不收取中间过路费 [5][6]。

  • 关于 Web 内测版费用:Web 内测版(dsh.deepseek.com)进入时会有内测服务条款与免责声明 [10]:

图 2 Web版内测声明

图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》

首次使用需要前往 DeepSeek 开放平台创建并复制独立的 API Key [10]:

图 3 开放平台创建APIKey

图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》

然后在 Web 界面中填入 Key 即可调用云端沙箱执行模型能力 [10]:

图 4 Web版首次填APIKey

图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》


2. 桌面客户端安装(Windows / macOS)

桌面客户端是官方为降低使用门槛推出的打包版本,内置了执行环境,免去了手动配置 Node.js 版本的痛苦 [1]。

图 5 官网下载页

图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》

第一步:下载安装包

从官网或官方 GitHub Releases 页面下载对应系统的安装包 [1]:

  • Windows 用户:下载 DeepSeek-Harness-Setup-x.x.x.exe(支持 64 位 Windows 10/11)[1]。

  • macOS 用户:下载 DeepSeek-Harness-x.x.x-arm64.dmg(支持 Apple Silicon M 系列芯片芯片)[1]。

⚠️ 注意:截至 2026 年底,官方首批桌面端未提供 Intel 架构 Mac 的预编译安装包。Intel 芯片的老款 Mac 建议使用下文的「3. 命令行 CLI 方式」[1]。

第二步:运行安装向导

  • Windows:双击运行安装文件,按默认路径一步步点击「下一步」完成安装。

  • macOS:打开 DMG 镜像,将 DeepSeek Harness.app 拖入 Applications 应用程序文件夹。首次打开如提示无法验证开发者,在「系统设置 → 隐私与安全性」中点击「仍要打开」。

第三步:登录或绑定 API Key

启动应用后会进入欢迎页:

图 6 欢迎页登录或填Key

图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》

  • 方式一(推荐):点击「DeepSeek 账号快捷登录」,程序会自动唤起系统默认浏览器,在网页中点击授权后即可自动回跳绑定 [1]。

  • 方式二:如果有单独的 API Key(如企业自建中转、硅基流动或开放平台独立 Key),点击下方的「手动输入 API Key」直接填入 [1][10]。

第四步:选择工作过程展示程度

DSH 在初始化时会询问你希望它在界面上展示多详细的工作思考链路:

图 7 选择展示多少工作过程

图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》

  • 精简模式(Casual / Concise):折叠冗长的代码执行中间日志,只展示关键动作与最终回答,界面清爽。

  • 详细模式(Developer / Verbose):展开每一次读写文件、终端命令标准输出、Token 消耗与自我纠错过程,适合程序员审查 Agent 行为 [1][2]。

第五步:注册终端全局命令(可选)

在桌面版设置或引导界面中,可以勾选「安装 dsh 终端命令」:

图 8 安装dsh终端命令

图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》

勾选后,桌面端会自动将 CLI 可执行链接写入系统的 PATH 环境变量。之后你不仅能在桌面窗口里用,也可以随时随地在系统的任何终端窗口敲 dsh 唤醒同一个环境 [1]。


3. 命令行 CLI 安装与环境配置

如果是在纯终端环境、无头服务器,或需要以命令行脚本自动化调度,直接安装 CLI 版是最原汁原味的做法 [4][5]。

环境要求

  • Node.js >= 18.18.0(推荐使用 Node.js 20 LTS 或 22 版本)[4][5]

  • Git(用于代码版本管理及 Diff 生成)[5]

安装命令

macOS / Linux:

bash
# 全局安装 dsh 命令行
npm install -g @deepseek/harness

# 或者使用 pnpm / yarn
pnpm add -g @deepseek/harness

Windows(PowerShell 或 CMD):

powershell
# 以管理员权限打开 PowerShell
npm install -g @deepseek/harness

免安装即用(临时体验):

bash
npx @deepseek/harness

配置官方 API 密钥

将你的 DeepSeek API Key 写入环境变量:

bash
# Linux / macOS (写入 ~/.bashrc 或 ~/.zshrc)
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

# Windows PowerShell (当前会话)
$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

# Windows PowerShell (永久写入用户环境变量)
[System.Environment]::SetEnvironmentVariable('DEEPSEEK_API_KEY', 'sk-xxxxxxxxxxxxxxxxxxxxxxxx', 'User')

检查安装

bash
dsh --version
dsh doctor

如果输出版本号且 dsh doctor 提示环境检查全绿,说明安装彻底成功 [5]。


4. 权限模式设置(至关重要)

与普通聊天软件不同,DSH 拥有操纵系统文件和运行终端命令的底层能力。在正式让它干活前,务必了解并设置好权限层级:

图 9 权限三档

图源:[2] 一纸尘言《最近爆火的 DeepSeek Harness大肥鱼,我把它装进了电脑:从安装到使用保姆级指南》

权限档位读文件写/删文件运行终端命令适用场景
只读模式(Read-Only)允许拒绝仅限无副作用命令(如 ls、git status)审查开源库代码、分析架构、排查问题,绝不改变任何磁盘数据 [5][8]
半自主确认模式(Ask-Before-Action,默认推荐)允许每次写入弹窗询问每次执行关键命令弹窗确认日常主力开发推荐,防止 AI 误删未提交的文件或执行破坏性脚本 [2][8]
全自主模式(Full-Auto / Unrestricted)允许自动静默执行自动静默执行放入独立 Docker 容器、临时 Git 分支中挂机跑长流程任务(如全库重构)[5][10]

三、上手流程:从零到第一个完整项目

下面以使用 DSH 重构并修复一个本地数据处理项目为例,带你体验完整的从零到产出流程。

第一步:打开工作目录

启动桌面端后,在左上角点击「打开文件夹(Open Folder)」或在命令行中切换到目标目录后启动:

bash
cd /path/to/my-project
dsh

此时 DSH 会将该目录设置为工作空间根目录,加载项目内的目录树,并自动扫描是否有 .git 仓库 [5]。

第二步:设定工作目标

在底部输入框中,用自然语言提出需求。例如:

"帮我检查当前目录下的 src/parser.py。该脚本在解析包含中文路径的 Excel 文件时频繁抛出编码异常。请定位问题原因,编写单元测试覆盖此异常场景,并修复该 bug。"

第三步:观察 Agent 自主探索与规划

输入指令后,DSH 不会盲目乱改代码,而是进入思考与规划流程:

  1. 读取目录结构:调用 list_dir 查看项目现有文件布局。

  2. 定位关键代码:调用 read_file 查阅 parser.py 的编码相关处理。

  3. 推演原因:在输出框中呈现分析结论(例如:某处未指定 encoding='utf-8' 或缺少对特定非标准字符集的容错逻辑)。

第四步:代码编辑与确认

进入编码阶段,DSH 会自动调用写操作:

  • 在「详细模式」或桌面版窗口中,会弹出清晰的 Diff 差异对比栏(绿色代表新增代码,红色代表删除代码)[2][5]。

  • 如果当前处于「半自主确认模式」,界面会亮起操作审核卡片,点击「Approve(批准)」允许修改写入磁盘。

第五步:自主运行测试与验证

写入修复逻辑后,DSH 会自动执行终端测试命令(例如调用 pytest tests/test_parser.py)[8]:

  • 如果测试通过,它会向你汇报:"已成功添加测试用例并修复字符编码异常,所有单元测试均已通过。"

  • 如果测试失败,它会根据终端捕获的错误 Traceback 自主思考,修改代码后再次重试,直到测试跑通为止 [8]。


四、核心功能与进阶

1. 四种 Agent 模式深度解析

在 DSH 界面上方或状态栏中,可以随时切换四种工作模式。不同模式决定了 DSH 调用的工具集和自主权限策略 [2][3][5]:

图 10 四种Agent模式

图源:[2] 一纸尘言《最近爆火的 DeepSeek Harness大肥鱼,我把它装进了电脑:从安装到使用保姆级指南》

模式名称界面标识核心行为特征典型使用场景
Chat(对话模式)💬 对话图标仅基于已有知识和上下文纯文本交谈,不调用任何本地文件或命令工具 [2][5]概念答疑、算法原理探讨、Prompt 提示词润色
Assist(协助模式)🛠️ 工具图标拥有文件只读权限,能帮你浏览代码、指出逻辑漏洞并生成修改建议,但不直接碰硬盘修改 [5][8]代码审查(Code Review)、方案设计讨论、排查生产日志
Code(编码执行模式)💻 终端图标最核心的主力模式。全套读写、文件修改、编译运行测试工具全开 [2][5]编写新功能、修复 Bug、项目重构、补写测试用例
Auto(全自动任务模式)⚡ 闪电图标支持后台自主循环推进,可自动拆解上百个步骤的长链条任务 [3][10]批量资产处理、长文档多层级整理、端到端自动化测试

2. 重点:接入第三方模型与 API Key 配置

DeepSeek 官方开放平台的接口极其平价,但 DSH 最大的技术优势之一在于其完全开放的 Harness 架构——你可以自由挂接任何兼容 OpenAI 规范的第三方模型平台,甚至接入本地部署的私有模型 [3][5][6]。

(1)桌面版可视化添加提供商(最简单)

打开桌面版「设置(Settings)→ 模型提供商(Model Providers)」:

图 11 添加第三方模型提供商

图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》

点击「Add Provider(添加供应商)」,弹出提供商目录与自定义表单:

图 12 内置提供方目录

图源:[4] 挖挖GitHub《DeepSeek Harness 保姆级教程,附4种使用途径和必装插件》

填入以下四项核心参数即可完成添加 [3][6]:

  1. Provider Name:自定义名称(如 SiliconFlow 或 Local-Ollama)。

  2. API Base URL:服务商接口基础地址。

  3. API Key:对应平台的访问密钥。

  4. Models:支持调用的具体模型 ID 列表。

图 13 多个提供商与自定义接口

图源:[6] 王科特《5 分钟把 DeepSeek Harness 打造成顶配工作台:完整配置文档》

(2)常见模型服务商配置对照表

提供商Base URL推荐模型 ID优势说明
DeepSeek 官方https://api.deepseek.com/v1deepseek-chat, deepseek-reasoner官方原生支持,深度优化,推理速度快 [1]
硅基流动 (SiliconFlow)https://api.siliconflow.cn/v1deepseek-ai/DeepSeek-V3, deepseek-ai/DeepSeek-R1国内高并发中转,常有免费额度赠送 [6]
月之暗面 (Kimi)https://api.moonshot.cn/v1moonshot-v1-128k, kimi-k1.5超长上下文理解极佳,适合超大仓库分析
智谱 AI (BigModel)https://open.bigmodel.cn/api/paas/v4glm-4-plus, glm-4-flash国内大厂稳定服务,部分轻量模型免费
本地 Ollama / vLLMhttp://localhost:11434/v1deepseek-r1:14b, qwen2.5-coder:7b完全离线私密,数据绝不上传外网 [5]

(3)配置文件模式(CLI 与高级开发者)

DSH 会优先读取当前项目根目录下的 dsh.config.json,若不存在则读取用户主目录的 ~/.dsh/config.json [5]。配置范例如下:

json
{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "base_url": "https://api.deepseek.com/v1",
      "api_key": "env:DEEPSEEK_API_KEY",
      "models": ["deepseek-chat", "deepseek-reasoner"]
    },
    "siliconflow": {
      "base_url": "https://api.siliconflow.cn/v1",
      "api_key": "env:SILICONFLOW_API_KEY",
      "models": [
        "deepseek-ai/DeepSeek-V3",
        "deepseek-ai/DeepSeek-R1"
      ]
    },
    "local_ollama": {
      "base_url": "http://localhost:11434/v1",
      "api_key": "ollama",
      "models": ["qwen2.5-coder:7b", "deepseek-r1:14b"]
    }
  },
  "runtime": {
    "permission_level": "ask",
    "timeout_seconds": 120,
    "max_iterations": 30
  }
}

(4)验证配置与连通性

在命令行或对话框中输入:

bash
/model list
/model switch siliconflow/deepseek-ai/DeepSeek-V3

随后发送一句测试指令:"输出当前连接的模型名称与当前系统时间戳"。若能正常响应,说明多模型提供商挂接完全成功 [5][6]。

(5)常见报错与排查指南

报错现象原因分析解决方案
401 UnauthorizedAPI Key 填写有误或已过期失效检查 Key 是否带有前缀空格,确认平台余额是否充足 [5]
404 Not Found / Endpoint ErrorBase URL 结尾少写或多写了 /v1确认服务商规范(OpenAI 兼容接口标准大多以 /v1 结尾)[6]
Context window exceeded选用的模型上下文窗口太小(如仅 8K/16K)切换到 64K 或 128K 长上下文模型,或输入 /compact 压缩会话历史 [5]
Connection Refused (Local)本地 Ollama 未启动或监听端口被拦截检查本地终端执行 ollama serve,确认 11434 端口正常监听 [5]

3. 插件生态体系与精选插件

DSH 拥有极其活跃的开源插件生态。通过其内置的插件管理器和社区市场 dshmarket,你可以像装手机 App 一样为 Agent 扩展能力 [2][3][4]。

图 14 插件市场dshmarket

图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》

(1)查看与管理插件

在界面侧边栏点击插件图标,可以按当前工作模式过滤查看可用插件 [3]:

图 15 内置插件按模式查看

图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》

(2)安装第三方插件

支持在插件市场一键安装,或通过 Git 地址手动添加 [3]:

图 16 添加插件对话框

图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》

(3)四大明星插件推荐与实测

  1. 大肥鱼桌宠(DSH Fish Mascot) [2]:

    • 特点:基于 DeepSeek 形象二创的桌面悬浮宠物。它不是单纯的花瓶,而是会与 DSH 底层任务状态挂钩——当你让 Agent 干活时它在潜水搬砖,报错时它会翻肚皮,写完任务后还会主动弹窗向"主人"汇报工作。

  2. 上下文与成本洞察(Context & Token Insights) [2][6]:

    • 特点:在工作台左侧实时统计你每次调用消耗的 Prompt Token、Completion Token 以及精准花费的金额,帮助你彻底告别 Token 焦虑。

  3. 自动化任务调度器(Task Scheduler / Automator) [3]:

    • 特点:允许预设定时任务,下班后让 DSH 自动拉取远程仓库、运行安全扫描、格式化代码并向飞书或企业微信推送巡检简报。

图 17 自动化任务

图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》

  1. 个性化界面与开机动画(Startup Screen & Wallpaper Engine) [1][7]:

    • 特点:开源社区(如 6shenhonghong9/dsh-startup-screen)针对 DSH 开发的终端动效与主题皮肤包,支持自定义字体、毛玻璃半透明窗体与赛博朋克调色方案 [1][7]。


五、避坑与注意(⚠️ 关键避坑)

在整理与核实 10 篇主流素材过程中,我们发现了几处严重过时、说法矛盾或存在安全风险的技术细节,请务必注意防范:

1. ⚠️ 版本断代:早期纯 CLI 教程 vs 现代桌面版

  • 背景:2026 年 8 月初版发布时只有 GitHub 源码和 npx @deepseek/harness 命令,很多早期文章(如素材 [4][8][9])反复强调"必须先装 Node.js、必须在终端里运行"。

  • 真实情况:2026 年 10 月底官方已经正式发布了跨平台桌面客户端(Desktop) [1][2]。初学者完全无需再从命令行一步步配环境,直接去官网下载图形化安装包即可 [1]。

2. ⚠️ Shell 执行的安全边界与数据风险

  • 风险提示:DSH 在 Code 与 Auto 模式下拥有完全真实的本机 Shell 命令执行权限 [8]。

  • 避坑建议:

    • 严禁将 DSH 的工作目录指向系统根目录(如 C:\ 或 /)或包含重要个人隐私的桌面全局目录![8]

    • 核心项目务必先确保 Git 状态 Clean 且已推送到远端备份。一旦 AI 执行了错误的重构或误删指令,可以通过 git reset --hard 一键撤销 [5][8]。

    • 平时常态化保持在「半自主确认模式(Ask-Before-Action)」,看清每条写命令后再点批准 [2]。

3. ⚠️ 插件来源与恶意脚本防范

  • 风险提示:DSH 插件生态极其开放,插件可以注册自定义 Tool 并在本地执行 Python 或 Node 脚本 [4]。

  • 避坑建议:不要随意从不知名的论坛或微信群下载 .zip 格式的未审核插件包。安装插件优先通过官方 dshmarket 或经过社区高 Star 验证的开源 GitHub 仓库 [4]。

4. ⚠️ 桌面端与 Web 内测版的 API Key 隔离

  • 素材矛盾:部分自媒体文章声称"只要网页版登录了,桌面版就能自动同步云端任务"。

  • 核实结论:经过实测与官方文档确认,DSH 桌面端以本地项目文件系统为主,而 Web 内测版(dsh.deepseek.com)是独立的云端轻量沙箱 [10]。两者的 API Key 和项目文件并不互通,Web 端每次新建会话需要重新授权或填入开放平台 Key [10]。


六、参考原文与出处

1. 本文参考微信公众号素材清单

#文章标题与链接来源公众号发布日期配图数为什么入选与核心引用点
1[DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图]阿龙的AI使用笔记2026-10-2915桌面版最新安装指南,完整覆盖安装包下载、配置向导与终端命令集成(引用图 01~05)
2[最近爆火的 DeepSeek Harness大肥鱼,我把它装进了电脑:从安装到使用保姆级指南]一纸尘言2026-11-0116深入讲解权限三档划分、四种 Agent 工作模式及大肥鱼桌宠插件实操(引用图 09、10)
3[DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处]探路AI 超级个体之路2026-11-0123全面评测插件市场 dshmarket、第三方模型提供商添加与自动化任务执行(引用图 11、12、15、16、17)
4[DeepSeek Harness 保姆级教程,附4种使用途径和必装插件]挖挖GitHub2026-08-1612架构解析,分析 Harness 本质、开源定位与内置提供商目录(引用图 13)
5[DeepSeek Harness(dsh)使用教程:从低阶到高阶玩透]早问AI2026-08-1403.4 万字深度技术长文,系统梳理配置文件参数、CLI 命令参数与多环境部署
6[5 分钟把 DeepSeek Harness 打造成顶配工作台:完整配置文档]王科特2026-11-0419深度讲解多提供商自定义接口整合、多模态插件接入与效率提速配置(引用图 14)
7[我把 DeepSeek Harness 装修成了自己想用的样子]Yve思录2026-11-0413界面审美与工作台改造实战,包括字体、动效、配色与交互细节打磨
8[我跑了三天 DeepSeek Harness,说点真实体感]织梦AI2026-10-097连续实跑三天的真实体感,客观评价适合与不适合场景、Shell 风险提示
9[花几天把 DeepSeek Harness 跑了个遍,跟你说说值不值得装]林月半子的AI笔记2026-08-1618早期版本实测,对比测试套件生成、复刻案例与社区插件活跃度
10[普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍]管三2026-08-2023普通人视角实测,详细演示 Web 内测版申请、API Key 绑定与实际成本(引用图 06、07、08)

2. 官方开源与技术文档补充列表

编号来源与页面名称查阅日期补充与核实用到的核心内容
[官1]DeepSeek 官方 GitHub 仓库 (deepseek-ai/deepseek-harness)2026-11-08官方架构说明、CLI 命令规范、Release 发布日志与系统环境最低依赖
[官2]DeepSeek 开放平台 API 官方文档 (platform.deepseek.com/api-docs)2026-11-08模型价格计费规则、上下文长度(V3 64K / R1 128K)、推理模型 API 调用格式
[官3]DSH 扩展插件开发规范协议 (Plugin RFC)2026-11-08插件注册机制、Tool 挂载规范、安全性沙箱限制与生命周期钩子
[官4]dshmarket 社区市场索引规范2026-11-08官方市场收录标准、本地插件安装目录与包签名校验机制

3. 本文使用图片清单核对表

图片文件名图片内容说明引用章节对应素材来源
01-官网下载页.jpg官方网站桌面版安装包下载页(Win/Mac)第二节 2. 桌面客户端安装[1] 阿龙的AI使用笔记
02-欢迎页登录或填Key.png首次启动桌面版的欢迎页(登录/填Key)第二节 2. 桌面客户端安装[1] 阿龙的AI使用笔记
03-选择展示多少工作过程.png工作过程展示程度选择(精简/详细)第二节 2. 桌面客户端安装[1] 阿龙的AI使用笔记
04-桌面版主界面.pngDSH 桌面客户端主操作界面总览第一节 定位[1] 阿龙的AI使用笔记
05-安装dsh终端命令.png桌面端引导设置注册 dsh 系统全局环境变量第二节 2. 桌面客户端安装[1] 阿龙的AI使用笔记
06-Web版内测声明.pngWeb 端免安装运行环境内测声明页第二节 1. 账号与费用[10] 管三
07-开放平台创建APIKey.png在 DeepSeek 开放平台创建新 API Key 界面第二节 1. 账号与费用[10] 管三
08-Web版首次填APIKey.pngWeb 版初始化引导中绑定 API Key 弹窗第二节 1. 账号与费用[10] 管三
09-权限三档.pngDSH 核心权限分级(只读/半自主/全自主)第二节 4. 权限模式设置[2] 一纸尘言
10-四种Agent模式.png状态栏四种 Agent 模式切换菜单第四节 1. 四种 Agent 模式[2] 一纸尘言
11-内置插件按模式查看.jpg插件管理侧边栏按模式筛选查看已装插件第四节 3. 插件生态体系[3] 探路AI 超级个体之路
12-添加第三方模型提供商.jpg模型设置中的第三方提供商添加入口第四节 2. 接入第三方模型[3] 探路AI 超级个体之路
13-内置提供方目录.png系统预置支持的国内外模型提供商目录第四节 2. 接入第三方模型[4] 挖挖GitHub
14-多个提供商与自定义接口.jpg多模型供应商共存与自定义 Base URL 界面第四节 2. 接入第三方模型[6] 王科特
15-添加插件对话框.jpg通过 URL 或本地路径安装新插件对话框第四节 3. 插件生态体系[3] 探路AI 超级个体之路
16-插件市场dshmarket.jpg社区在线插件市场 dshmarket 浏览页面第四节 3. 插件生态体系[3] 探路AI 超级个体之路
17-自动化任务.jpg自动化定时长任务调度与运行记录卡片第四节 3. 插件生态体系[3] 探路AI 超级个体之路
更新于 2026-11-08来源:用户提供《工具指南_完整全套_含所有MD与图片.zip》;正文保留原文参考来源