- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 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] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》
1. 核心形态演进
DSH 目前提供了四种交互入口 [1][4]:
| 入口形态 | 运行环境 | 特点与定位 | 适合人群 |
|---|---|---|---|
| 桌面端客户端(Desktop) | Windows / macOS 独立 App | 2026 年 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 Code | OpenAI Codex / ChatGPT Desktop | Cursor / 传统 AI 补全 |
|---|---|---|---|---|
| 底层核心 | 自主 Agent 框架 + 开放 Harness [4] | 终端/桌面 Agent,端到端编码 [8] | 云端沙箱 / 桌面 Agent | IDE 编辑器内行级补全与侧边栏对话 |
| 开源与自主权 | 框架完全开源,允许深入魔改核心逻辑 [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]。
模型费用来源:
官方账号直连(桌面版默认):直接使用 DeepSeek 官方账号授权登录,直接扣除你 DeepSeek 账号绑定的官方充值余额或赠送代金券 [1]。DeepSeek V3(
deepseek-chat)与 R1(deepseek-reasoner)的官方 API 单价极具性价比(百万 Token 仅数毛钱至几元)[8]。API Key 计费:如果填入第三方平台(如硅基流动 SiliconFlow、派欧云 PPIO、火山引擎)或本地 Ollama 模型,费用由对应平台或本地算力承担,DeepSeek Harness 不收取中间过路费 [5][6]。
关于 Web 内测版费用:Web 内测版(
dsh.deepseek.com)进入时会有内测服务条款与免责声明 [10]:
图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》
首次使用需要前往 DeepSeek 开放平台创建并复制独立的 API Key [10]:
图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》
然后在 Web 界面中填入 Key 即可调用云端沙箱执行模型能力 [10]:
图源:[10] 管三《普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍》
2. 桌面客户端安装(Windows / macOS)
桌面客户端是官方为降低使用门槛推出的打包版本,内置了执行环境,免去了手动配置 Node.js 版本的痛苦 [1]。
图源:[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
启动应用后会进入欢迎页:
图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》
方式一(推荐):点击「DeepSeek 账号快捷登录」,程序会自动唤起系统默认浏览器,在网页中点击授权后即可自动回跳绑定 [1]。
方式二:如果有单独的 API Key(如企业自建中转、硅基流动或开放平台独立 Key),点击下方的「手动输入 API Key」直接填入 [1][10]。
第四步:选择工作过程展示程度
DSH 在初始化时会询问你希望它在界面上展示多详细的工作思考链路:
图源:[1] 阿龙的AI使用笔记《DeepSeek Harness 桌面版小白安装教程:从下载到跑通,一步一图》
精简模式(Casual / Concise):折叠冗长的代码执行中间日志,只展示关键动作与最终回答,界面清爽。
详细模式(Developer / Verbose):展开每一次读写文件、终端命令标准输出、Token 消耗与自我纠错过程,适合程序员审查 Agent 行为 [1][2]。
第五步:注册终端全局命令(可选)
在桌面版设置或引导界面中,可以勾选「安装 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:
# 全局安装 dsh 命令行
npm install -g @deepseek/harness
# 或者使用 pnpm / yarn
pnpm add -g @deepseek/harnessWindows(PowerShell 或 CMD):
# 以管理员权限打开 PowerShell
npm install -g @deepseek/harness免安装即用(临时体验):
npx @deepseek/harness配置官方 API 密钥
将你的 DeepSeek API Key 写入环境变量:
# 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')检查安装
dsh --version
dsh doctor如果输出版本号且 dsh doctor 提示环境检查全绿,说明安装彻底成功 [5]。
4. 权限模式设置(至关重要)
与普通聊天软件不同,DSH 拥有操纵系统文件和运行终端命令的底层能力。在正式让它干活前,务必了解并设置好权限层级:
图源:[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)」或在命令行中切换到目标目录后启动:
cd /path/to/my-project
dsh此时 DSH 会将该目录设置为工作空间根目录,加载项目内的目录树,并自动扫描是否有 .git 仓库 [5]。
第二步:设定工作目标
在底部输入框中,用自然语言提出需求。例如:
"帮我检查当前目录下的
src/parser.py。该脚本在解析包含中文路径的 Excel 文件时频繁抛出编码异常。请定位问题原因,编写单元测试覆盖此异常场景,并修复该 bug。"
第三步:观察 Agent 自主探索与规划
输入指令后,DSH 不会盲目乱改代码,而是进入思考与规划流程:
读取目录结构:调用
list_dir查看项目现有文件布局。定位关键代码:调用
read_file查阅parser.py的编码相关处理。推演原因:在输出框中呈现分析结论(例如:某处未指定
encoding='utf-8'或缺少对特定非标准字符集的容错逻辑)。
第四步:代码编辑与确认
进入编码阶段,DSH 会自动调用写操作:
在「详细模式」或桌面版窗口中,会弹出清晰的 Diff 差异对比栏(绿色代表新增代码,红色代表删除代码)[2][5]。
如果当前处于「半自主确认模式」,界面会亮起操作审核卡片,点击「Approve(批准)」允许修改写入磁盘。
第五步:自主运行测试与验证
写入修复逻辑后,DSH 会自动执行终端测试命令(例如调用 pytest tests/test_parser.py)[8]:
如果测试通过,它会向你汇报:"已成功添加测试用例并修复字符编码异常,所有单元测试均已通过。"
如果测试失败,它会根据终端捕获的错误 Traceback 自主思考,修改代码后再次重试,直到测试跑通为止 [8]。
四、核心功能与进阶
1. 四种 Agent 模式深度解析
在 DSH 界面上方或状态栏中,可以随时切换四种工作模式。不同模式决定了 DSH 调用的工具集和自主权限策略 [2][3][5]:
图源:[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)」:
图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》
点击「Add Provider(添加供应商)」,弹出提供商目录与自定义表单:
图源:[4] 挖挖GitHub《DeepSeek Harness 保姆级教程,附4种使用途径和必装插件》
填入以下四项核心参数即可完成添加 [3][6]:
Provider Name:自定义名称(如
SiliconFlow或Local-Ollama)。API Base URL:服务商接口基础地址。
API Key:对应平台的访问密钥。
Models:支持调用的具体模型 ID 列表。
图源:[6] 王科特《5 分钟把 DeepSeek Harness 打造成顶配工作台:完整配置文档》
(2)常见模型服务商配置对照表
| 提供商 | Base URL | 推荐模型 ID | 优势说明 |
|---|---|---|---|
| DeepSeek 官方 | https://api.deepseek.com/v1 | deepseek-chat, deepseek-reasoner | 官方原生支持,深度优化,推理速度快 [1] |
| 硅基流动 (SiliconFlow) | https://api.siliconflow.cn/v1 | deepseek-ai/DeepSeek-V3, deepseek-ai/DeepSeek-R1 | 国内高并发中转,常有免费额度赠送 [6] |
| 月之暗面 (Kimi) | https://api.moonshot.cn/v1 | moonshot-v1-128k, kimi-k1.5 | 超长上下文理解极佳,适合超大仓库分析 |
| 智谱 AI (BigModel) | https://open.bigmodel.cn/api/paas/v4 | glm-4-plus, glm-4-flash | 国内大厂稳定服务,部分轻量模型免费 |
| 本地 Ollama / vLLM | http://localhost:11434/v1 | deepseek-r1:14b, qwen2.5-coder:7b | 完全离线私密,数据绝不上传外网 [5] |
(3)配置文件模式(CLI 与高级开发者)
DSH 会优先读取当前项目根目录下的 dsh.config.json,若不存在则读取用户主目录的 ~/.dsh/config.json [5]。配置范例如下:
{
"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)验证配置与连通性
在命令行或对话框中输入:
/model list
/model switch siliconflow/deepseek-ai/DeepSeek-V3随后发送一句测试指令:"输出当前连接的模型名称与当前系统时间戳"。若能正常响应,说明多模型提供商挂接完全成功 [5][6]。
(5)常见报错与排查指南
| 报错现象 | 原因分析 | 解决方案 |
|---|---|---|
401 Unauthorized | API Key 填写有误或已过期失效 | 检查 Key 是否带有前缀空格,确认平台余额是否充足 [5] |
404 Not Found / Endpoint Error | Base 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]。
图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》
(1)查看与管理插件
在界面侧边栏点击插件图标,可以按当前工作模式过滤查看可用插件 [3]:
图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》
(2)安装第三方插件
支持在插件市场一键安装,或通过 Git 地址手动添加 [3]:
图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》
(3)四大明星插件推荐与实测
大肥鱼桌宠(DSH Fish Mascot) [2]:
特点:基于 DeepSeek 形象二创的桌面悬浮宠物。它不是单纯的花瓶,而是会与 DSH 底层任务状态挂钩——当你让 Agent 干活时它在潜水搬砖,报错时它会翻肚皮,写完任务后还会主动弹窗向"主人"汇报工作。
上下文与成本洞察(Context & Token Insights) [2][6]:
特点:在工作台左侧实时统计你每次调用消耗的 Prompt Token、Completion Token 以及精准花费的金额,帮助你彻底告别 Token 焦虑。
自动化任务调度器(Task Scheduler / Automator) [3]:
特点:允许预设定时任务,下班后让 DSH 自动拉取远程仓库、运行安全扫描、格式化代码并向飞书或企业微信推送巡检简报。
图源:[3] 探路AI 超级个体之路《DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处》
个性化界面与开机动画(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-29 | 15 | 桌面版最新安装指南,完整覆盖安装包下载、配置向导与终端命令集成(引用图 01~05) |
| 2 | [最近爆火的 DeepSeek Harness大肥鱼,我把它装进了电脑:从安装到使用保姆级指南] | 一纸尘言 | 2026-11-01 | 16 | 深入讲解权限三档划分、四种 Agent 工作模式及大肥鱼桌宠插件实操(引用图 09、10) |
| 3 | [DeepSeek Harness保姆级教程:小白上手指南!看看它有哪些独特之处] | 探路AI 超级个体之路 | 2026-11-01 | 23 | 全面评测插件市场 dshmarket、第三方模型提供商添加与自动化任务执行(引用图 11、12、15、16、17) |
| 4 | [DeepSeek Harness 保姆级教程,附4种使用途径和必装插件] | 挖挖GitHub | 2026-08-16 | 12 | 架构解析,分析 Harness 本质、开源定位与内置提供商目录(引用图 13) |
| 5 | [DeepSeek Harness(dsh)使用教程:从低阶到高阶玩透] | 早问AI | 2026-08-14 | 0 | 3.4 万字深度技术长文,系统梳理配置文件参数、CLI 命令参数与多环境部署 |
| 6 | [5 分钟把 DeepSeek Harness 打造成顶配工作台:完整配置文档] | 王科特 | 2026-11-04 | 19 | 深度讲解多提供商自定义接口整合、多模态插件接入与效率提速配置(引用图 14) |
| 7 | [我把 DeepSeek Harness 装修成了自己想用的样子] | Yve思录 | 2026-11-04 | 13 | 界面审美与工作台改造实战,包括字体、动效、配色与交互细节打磨 |
| 8 | [我跑了三天 DeepSeek Harness,说点真实体感] | 织梦AI | 2026-10-09 | 7 | 连续实跑三天的真实体感,客观评价适合与不适合场景、Shell 风险提示 |
| 9 | [花几天把 DeepSeek Harness 跑了个遍,跟你说说值不值得装] | 林月半子的AI笔记 | 2026-08-16 | 18 | 早期版本实测,对比测试套件生成、复刻案例与社区插件活跃度 |
| 10 | [普通人要不要折腾DeepSeek Harness?我用WorkBuddy实测了一遍] | 管三 | 2026-08-20 | 23 | 普通人视角实测,详细演示 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-桌面版主界面.png | DSH 桌面客户端主操作界面总览 | 第一节 定位 | [1] 阿龙的AI使用笔记 |
05-安装dsh终端命令.png | 桌面端引导设置注册 dsh 系统全局环境变量 | 第二节 2. 桌面客户端安装 | [1] 阿龙的AI使用笔记 |
06-Web版内测声明.png | Web 端免安装运行环境内测声明页 | 第二节 1. 账号与费用 | [10] 管三 |
07-开放平台创建APIKey.png | 在 DeepSeek 开放平台创建新 API Key 界面 | 第二节 1. 账号与费用 | [10] 管三 |
08-Web版首次填APIKey.png | Web 版初始化引导中绑定 API Key 弹窗 | 第二节 1. 账号与费用 | [10] 管三 |
09-权限三档.png | DSH 核心权限分级(只读/半自主/全自主) | 第二节 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 超级个体之路 |