DSH-Desktop-个人用户使用指南

                    <div class="detail-content-box has-mask large">
                        <section><span leaf=""><br></span></section><blockquote style="font-size: 15px;font-weight: 400;color: rgba(0,0,0,0.55);line-height: 1.8;margin-bottom: 24px;"><p style="font-size: 17px;font-weight: 400;color: rgba(0,0,0,0.9);line-height: 1.8;margin-bottom: 24px;"><span leaf="">适用对象：想用 AI <a href="https://www.53ai.com/news/LargeLanguageModel/2024052823549.html">Agent</a> 帮自己写代码、整理资料、自动化日常任务的个人用户</span><br><span leaf="">参考范围：DSH / <a href="https://www.53ai.com/news/tishicijiqiao/2025020128143.html">DeepSeek</a> Harness 官方文档、DSH Desktop 官方技术文档、社区红皮书《从开机到拆开》；对比章节另引各产品 2026 年公开资料（详见文末）</span><br><span leaf="">文档版本基准：DeepSeek Harness v0.1 开发者预览版 / DSH Desktop v2.x（项目高速迭代中，操作以你本地实际版本为准）</span></p></blockquote>

🧭 ：你有没有过这种时刻——看别人演示"一句话让 AI 把一桌乱文件整理干净""一个 Agent 自己写完脚本还顺手跑了测试"，自己点开教程却被 npx、Node 版本、端口占用一路劝退？

这篇指南要做的，就是帮你把那道门槛拆掉：不装环境、不敲命令，点一下图标，让你的电脑里住进一个"会自己动手"的 AI。它叫 DSH Desktop，背后是 DeepSeek 开源的 Agent 框架 Harness。下面从"它到底是什么"讲到"你能拿它干哪些活、怎么干"，全程个人玩家视角，能截图的地方我给你留了占位。

〇、先搞清楚你装的是什么

一句话：DSH Desktop 就是给 DeepSeek 的 AI Agent 套了个"桌面壳"。你不用懂 Node.js，不用敲一行命令，双击图标——一个能读你文件、跑你终端、调你工具的本地 AI 助手，就坐在屏幕上等你派活了。

名字别搞混：

• DeepSeek Harness（DSH）：DeepSeek 官方开源的 AI Agent 运行时，核心理念是"一切皆插件"——模型、工具、Skill、会话、存储、循环、调度全由插件拼出来。
• DSH Desktop：社区（anywhere-labs）维护的开源桌面壳（Electron + MIT 协议），把官方 Harness 原样跑在窗口里。它不是 DeepSeek 官方产品，但特别在哪？它把"窗口、托盘、终端、更新"也按 Harness 的插件规则挂进来，和你装的官方能力跑在同一个运行时。

⚠️ 两点前提（务必记住）：① Harness 仍是开发者预览（Developer Preview），官方明示未来会有破坏性变更，重要项目请锁版本；② DSH Desktop 是社区项目，无官方 SLA。把它当"顺手的本地助手"，别当"不能出错的生产系统"。

一、核心优势（个人用户最该在意的 6 点）

二、DSH Desktop vs 其他知名 Agent：一张表看懂怎么选

市面上的 Agent 很多，但定位差别巨大——有的是命令行编码利器，有的是云端替你跑完交差，有的是搭平台给别人用。下面这张表帮你三秒对号入座（对比部分基于各产品 2026 年公开资料整理）：

DSH Desktop 的差异化定位（干货点评）：

• 对比 Claude Code / Cursor：它们强在"编码专业 + 生态成熟"，但 Claude Code 要 Node + 命令行 + 订阅，Cursor 要花钱买编辑器。DSH Desktop 赢在零门槛 + 本地优先 + 多模型可换 + 轨迹可溯——你不想被某家模型或某个订阅绑死时，它是更自由的那个。
• 对比 Manus：Manus 在云端替你跑完、直接交成品（报告/网站/PPT），但你失去对本地文件的直接控制，且 credit 消耗不可预估。DSH Desktop 在你自己机器上干活，文件不越出你设的工作区边界（除发往模型服务端那部分），成本看得见、控得住。
• 对比 Dify：Dify 是"搭平台给别人用"，需要 Docker 自托管、画工作流。DSH Desktop 是"自己本地用"，开箱即用，不让你先学一套运维。
• 一句话总结：DSH Desktop 不是最专业的编码工具，也不是最自主的云端工人，但它是离你个人电脑最近、最不挑模型、最不挑钱包的那一个。

三、快速上手：15 分钟跑通第一个 Agent

来源：DSH Desktop 官方文档（docs/why-desktop.md、快速开始）与官方 Harness 文档站入门章节。

第 1 步｜下载安装前往 DSH Desktop 官网下载对应安装包：

• macOS：Apple Silicon / Intel 的 DMG，拖入"应用程序"即可
• Windows：x64 的 NSIS 安装包，按向导完成
  无需安装 Node.js，无需执行命令。

第 2 步｜首次启动双击图标。首次启动会稍慢（需在本地准备默认 Profile 并初始化 Harness 服务与插件），耐心等待，不要反复重启。启动后主界面直接是 Harness，不再需要浏览器。

第 3 步｜配置模型 API Key左下角「设置 → 模型」，在对应服务商卡片（如 DeepSeek）填入 API Key 并保存。

🔒 安全习惯（红皮书重点提醒）：不要截图 Key，不要把 Key 写进会提交到 Git 的文件。Key 只存在本地凭据里。

第 4 步｜添加工作区点工作区旁的「+」，选一个项目文件夹作为 Agent 的工作目录。

⚠️ 技巧：第一次建议新建一个空的 dsh-demo 文件夹，不要直接选用户主目录或私人文件目录。Agent 会对工作区做文件读写，误删也只伤得到这个文件夹。

第 5 步｜发起第一个任务点「新会话」，保持默认：Agent = 标准模式，权限 = Workspace Write，模型 = 默认。输入：

"阅读当前目录，告诉我这里有哪些文件。先不要修改任何内容。"

能正常返回目录信息，说明桌面版已跑通。

四、核心实操技能（Skill）：你必须懂的 4 个概念

来源：社区红皮书《从开机到拆开》Part 3「skill、MCP、插件到底谁管谁」，以及官方 Harness 文档「概念」章节。

4.1 Skill / Plugin / MCP 三者关系（红皮书经典比喻）

• Skill = 人的经验（一道菜的菜谱）：告诉 Agent"怎么做一件事"的可复用方法论，比如"怎么做一次代码审计"。
• MCP = 厨房接口（煤气灶、水龙头的标准插口）：让 Agent 连接外部工具/数据的标准协议接口。
• Plugin = 厨房设备（电饭煲、微波炉）：真正提供能力的插件，往 Harness 里挂工具、UI 或系统提示。

一句话：Skill 教 Agent 做事的方法，Plugin 给 Agent 干活的工具，MCP 是工具接进来的标准口子。三者都跑在同一个插件运行时上，可自由组合。

4.2 四种运行模式，什么时候用哪个（红皮书"人话版"）

新建会话时可选择运行模式，本质是四套预置的插件组合模板：

4.3 权限边界：Agent 能碰什么（红皮书"它被允许碰什么"）

技巧：日常用「工作区可写」足够；让 Agent 动系统级东西前，先想清楚工作区是不是隔离的。

4.4 轨迹（Trajectory）：每一步都可回放

Harness 的设计是"有迹可循"——append-only 日志记下每一步（系统提示、推理链、工具输入/输出、调度事件）。界面提供回放、分支、还原。这是个人用户排查"Agent 为什么跑偏"的最强工具，也是它和普通聊天机器人的本质区别。

4.5 让 Agent 给自己造工具（创造模式实战）

这是 Harness 最惊艳的能力（红皮书全书最精彩部分）：因为整套系统本身也是插件拼出来的，它在运行时能检查自己缺什么插件，当场写一个挂上去。

例如红皮书实测：在标准/创造模式下让 Agent "数一下这句话里有几个汉字"，它发现自己没有这个工具，于是翻自己的安装目录、读类型声明，现场写一个名为 count_chinese 的 TypeScript 插件、挂载、立刻调用，回答"6"。

个人技巧：把重复性小工具（格式转换、特定统计、批量重命名逻辑）交给创造模式生成，比每次手敲命令省力。

五、一系列操作：从入门到进阶

5.1 安装一个实用插件：dsh-workspace-enhance

官方 Web UI 默认没有文件树侧栏，Agent 靠反复工具调用扫描目录，浪费 Token。社区插件dsh-workspace-enhance添加可视化文件树侧栏，并把结构化工作区上下文注入 Agent 提示，减少重复扫描。

命令行方式（需 DSH CLI）：

dsh plugin --profile web add git+https://github.com/luis1232023/dsh-workspace-enhancedsh restart web

重启后侧栏出现「Workspace Files」标签页。在 DSH Desktop 中，也可通过内置插件市场（发现/安装/管理）完成同类操作。

注：DSH Desktop 内置插件市场（dsh-community-market）是官方上游能力之外的桌面扩展；安装受"预览令牌 + 5 分钟 TTL 两阶段"防误操作保护，且 dsh-desktop-app、dsh-plugin-desktop、dsh-community-market 被设为不可禁用，避免把自己锁在门外。

5.2 导入场景配方（Preset）

DSH 生态有"Preset 广场"，提供场景化配方（如某类助手指南）。在官网 Preset 广场复制安装请求，回到客户端粘贴导入，即可一键获得针对某场景调好的 Agent 预设。适合不想自己调参数的个人用户。

5.3 子代理、工作流与后台任务

标准模式内置：子 Agent 调度、计划（Plan）、目标（Goal）、后台任务（Background）、工作流（Workflow）。

• 子代理：把大任务拆给专精的子 Agent 并行处理。
• 后台任务：长任务丢后台跑，DSH Desktop 任务完成弹系统通知，不用一直盯着。
• 工作流：把多步流程固化成可复用序列。

5.4 成本与隐私自查

• 成本：无订阅，按 API 调用计费；DeepSeek 自 2026-08-17 起改分时计价，单价以官方价格页为准。会话里可查看 Token 用量（类似 /cost）。
• 隐私（红皮书"我的东西会不会传出去"）：① 进程在本地，但你让 Agent 看的文件内容会发到模型服务端才能得到回答；② 遥测默认关闭，出厂即禁用；③ 有一项关不掉——首次鉴权后本机生成匿名编号，之后每次请求都带它（官方模块 README 的"已知限制"已写明）。敏感文件别放进工作区，是最直接的做法。

六、实际应用场景：分步操作

场景 A｜本地项目代码审计 / 改 Bug

1. 工作区选你的项目文件夹，权限"工作区可写"。
2. 新会话，标准模式，输入："读取 README 和目录结构，找出 3 个最值得先修的问题，并给出修改建议。先只分析，不要改文件。"
3. 确认方案后，再发："按第 1 点修改，改完跑一遍测试。"
4. 用轨迹回放核对每一步改动。

场景 B｜资料整理 / 写作辅助

1. 工作区放一个"素材"文件夹（论文 PDF、笔记、网页存档）。
2. 输入："总结这个文件夹里所有材料关于 XX 主题的要点，输出一份大纲。"
3. 想深入某点，发："基于大纲第 2 点，起草一段 300 字说明。"

场景 C｜日常文件批处理

1. 工作区放待处理文件。
2. 输入："把工作区里所有 .md 文件名按日期前缀重命名，列出将要执行的改动，等我确认再执行。"（先让 Agent 列计划、你确认，再执行，是个人用户最稳的防误删姿势。）

场景 D｜学习 / 研究

1. 工作区放学习资料。
2. 用极简模式做模型对比，或用标准模式："用通俗语言解释这份文档的核心方法，并举一个生活例子。"

七、实用技巧与避坑清单

• 🔑 Key 安全：Key 只存本地凭据；别截图、别进 Git。
• 📁 工作区隔离：永远给 Agent 一个" sacrificial（可牺牲）"文件夹，别让它碰主目录。
• 💰 先列计划再执行：让 Agent 改动文件前，先要它输出将执行的操作清单，你确认后再跑。
• 🔒 权限从紧：默认"工作区可写"足够，别开"完全放开"。
• 🔄 锁版本：Developer Preview 阶段升级可能破坏性变更，重要项目先在隔离环境验证再升。
• 🪟 端口冲突：DSH Desktop 自动管理随机回环端口，一般无冲突；若提示端口被占用，说明本机已有旧 Harness 服务在跑，先关掉旧进程。
• 📊 用轨迹复盘：Agent 跑偏时，别只信最终结果，翻轨迹看它哪一步理解错了。
• 🧩 插件按需装：仓库里有大量扩展包但默认闭包未包含（红皮书整理过"装上没有"的扩展清单），功能不全时先确认是不是没装对应插件。

八、参考来源

一、DSH / DeepSeek Harness 专属资料（本文主体事实锚定于此）

1. DeepSeek Harness 官方文档站：https://deepseek-harness.github.io/deepseek-harness/
2. deepseek-ai/deepseek-harness GitHub 仓库：https://github.com/deepseek-ai/deepseek-harness
3. DeepSeek Harness 产品页：https://www.deepseek.com/harness/
4. anywhere-labs/deepseek-harness-desktop 仓库与 docs/architecture.md、docs/why-desktop.md：https://github.com/anywhere-labs/deepseek-harness-desktop
5. DSH Desktop 官网（下载、快速开始、Preset 广场）：https://www.dshdesktop.com/
6. 《DeepSeek Harness:从开机到拆开》橙皮书（花叔 著，社区红皮书）：https://github.com/alchaincyf/deepseek-harness-orange-book

二、对比章节引用的各产品公开资料（2026 年）

• Claude Code：Anthropic 官方（claude.com / code.claude.com）
• Cursor：cursor.com
• Manus：manus.im
• Dify：dify.ai
• Aider：aider.chat
• OpenAI Codex / Agents SDK：openai.com
• AutoGPT：github.com/Significant-Gravitas/AutoGPT

说明：DSH Desktop 主体内容均对应上述专属资料；第二章对比表基于各产品 2026 年公开官网信息与公开评测整理，仅用于横向定位参考，不构成对各产品的背书或评测结论。Harness 与 DSH Desktop 均处于高速迭代期，具体路径、版本号与功能以官方文档站与对应仓库 Release 页的最新说明为准。