如何3分钟上手DSH Desktop：从下载macOS安装包到第一次官方DSH会话-育师

如何3分钟上手DSH Desktop：从下载macOS安装包到第一次官方DSH会话

【免费下载链接】dsh-desktopDeepSeek Harness Desktop App: a local AI desktop workspace for DSH Sessions, projects, files, web research, plugins, and Office artifacts.项目地址: https://gitcode.com/gh_mirrors/de/dsh-desktop

DSH Desktop 是一款基于 DeepSeek Harness 构建的本地 AI 桌面工作台，面向新手与普通用户：下载 macOS 安装包、拖入应用程序、启动应用，就能在官方 DSH Web 界面里发起第一次 DSH 会话，无需手写配置，也不用理解 Node、Profile 或 Bundle 这些概念。本教程用 3 分钟带你走完「下载 → 安装 → 初始化 → 第一次会话」的完整路径，并顺手介绍插件市场、任务看板等默认能力。

DSH Desktop 是什么？先花 30 秒搞清楚

一句话：DSH Desktop 把官方 DSH Web 直接装进了桌面应用里。

主窗口加载的就是官方 DSH Web 界面，会话、消息排队、工具审批、历史回放全部走官方链路；
安装包内置了官方 DSH 运行时和一套精选默认插件，首次启动不依赖网络下载；
数据默认保存在本机~/.dsh目录，打开历史不会自动上传。

你得到的不是"一堆需要手工配置的东西"，而是一个开箱即用的本地 AI 桌面环境。

第 1 分钟：下载并安装 macOS 安装包

DSH Desktop 目前提供macOS Apple Silicon（M 系列芯片）安装包，这是最省心的安装路径：

前往项目发行版页面，下载 macOS Apple Silicon 的.dmg安装包；
双击打开.dmg，将DSH Desktop图标拖入"应用程序"文件夹；
首次打开时，macOS 会验证 Developer ID 签名与 Apple 公证，通过后直接运行即可。

💡 Windows x64 与 macOS Intel 版本暂无正式安装包，可以先看文末的"从源码运行"方案。

安装完成后，不需要额外安装 Node.js，也不需要修改任何源码——官方 DSH 运行时和默认插件已经随包内置，并且通过了 Apple 公证验收。

第 2 分钟：启动应用，完成初始化

双击启动DSH Desktop，首次启动会经历一次离线初始化：

应用用内置的固定产物和随包 pnpm 原子初始化一个全新的 DSH Profile，失败不会留下"半个 Profile"；
默认安装一套经过审查的插件组合（插件市场、附件输入、Git Worktree、任务看板、Office 产出工具等），每一个都可以之后在设置里停用或卸载；
如果启动失败，应用会进入本地恢复页而不是白屏，你可以重试或启动一个只含官方基础组件的安全 Profile，原 Profile 不会被静默改写。

初始化完成后，进入「设置 → 模型」，填入你的 DeepSeek API Key 并选择模型（例如 DeepSeek-V4-Flash）。密钥只注入当次运行的临时进程，不会写入截图或多余配置里。

第 3 分钟：发起你的第一次官方 DSH 会话

点击左侧「新会话」，在底部输入框输入你的第一个问题，比如：

请用一句话说明 DSH Desktop 能怎样帮助我的工作，并举三个例子。

发送后你会看到官方会话的完整体验：模型思考过程、结构化回答、底部状态栏实时显示 token 与速度。

这个界面就是官方 DSH Web本体，不是第三方仿制客户端。你还能体验到：

问题卡片：模型不确定时会向你发起选项式提问，点选即可继续；
工具审批：模型请求执行命令时弹出审批卡片，你可以"仅本次允许"或拒绝，权限完全在你手里；
消息排队：上一轮没跑完时发的新消息会自动排队，不丢消息。

走到这里，恭喜——你已经在 3 分钟内完成了 DSH Desktop 的上手。

装完顺手逛：3 个默认自带的实用入口

设置里的插件市场：搜索、安装、卸载一站式

左下角「设置 → 插件市场」内置了dshmarket可视化市场：按分类筛选、查看插件的权限与兼容性，一键安装或卸载。市场读写的是同一个 DSH Profile，不会出现"页面显示已安装、实际没加载"的双状态问题。

任务看板：把 AI 会话变成可追踪的任务

左侧「任务看板」提供待规划 / 待办 / 进行中 / 已完成 / 已失败五列看板，可以把长任务交给 DSH 会话自动推进，状态实时同步到看板上。

Git Worktree：一个仓库，多个隔离工作区

在 Workspace 中打开 Git Worktree 面板，可以为独立任务创建隔离的 worktree，每个 worktree 作为官方 Workspace 打开，互不干扰——适合"一个功能一个分支"的并行开发。

新手常见问题 FAQ

Q：我的数据存在哪里？安全吗？Profile、Session 和本地运行数据默认都在~/.dsh，官方 Web 窗口没有通用 Node/IPC 权限，第三方插件拿不到 Electron 或通用系统能力。隐私与安全细节可参考 PRIVACY.md 与 SECURITY.md。

Q：启动失败、白屏了怎么办？不会白屏。启动失败会进入本地恢复页，提供重试、安全 Profile 启动、打开数据目录、移除指定插件和导出诊断等选项。

Q：Windows 用户现在能装吗？Windows x64 安装包还在完成真实打包验收。可以暂时从源码运行（需要 Node.js 24+）：

git clone https://gitcode.com/gh_mirrors/de/dsh-desktop cd dsh-desktop npm install npm run doctor npm run dev:electron

Q：插件坏了会影响应用吗？可以单个停用或卸载，重启后仍保持你选择的组合；应用更新也不会把已卸载的插件静默装回来。

写在最后

DSH Desktop 的核心理念是"官方 Web 唯一主界面 + 可复现的默认插件组合 + 最小权限的原生能力"。按照本教程，3 分钟即可完成从 macOS 安装包下载、安装到第一次官方 DSH 会话的全过程；之后花十分钟逛一逛插件市场、任务看板和 Git Worktree，你就能把它当成日常使用的本地 AI 工作台。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考