本册导览

十三节按「装好 → 用起来 → 出问题」的顺序排。只想解决某个具体问题，可以直接跳到第十二节。

• 一 · 这是什么——三层结构，日常只碰最上面那一层。
• 二 · 安装——三个平台各取哪个包、怎么装。
• 三 · 第一次打开——七步向导，以及「关闭不等于退出」。
• 四 · 主界面速览——四个区域各自管什么。
• 五 · 第一次对话——怎么把需求说清楚。
• 六 · 托盘菜单——系统级入口都在这里。
• 七 · 设置页——每个分区能改什么。
• 八 · Profile——多套配置怎么切换、失败怎么回退。
• 九 · 插件——出厂自带什么、三条安装途径、怎么卸载。
• 十 · 安全模式与恢复模式——装坏插件、起不来时怎么救。
• 十一 · 更新——五个阶段与四个可复用操作。
• 十二 · 遇到问题——常见现象对照表与诊断导出。
• 十三 · 数据与帮助——文件位置与更多文档入口。

一、这是什么

一句话：它把 DeepSeek Harness 的智能体能力装进了一个桌面应用，双击图标就能开始对话、让它读写文件、执行命令、调用工具。

整个产品由三层组成，你只需要和第三层打交道，前两层在后台自动运行。

二、安装

到产品下载页取对应平台的安装包，双击即可。安装包已经内置 Electron、Node.js、pnpm 和固定版本的 DSH 运行时，不需要另外装任何环境。本版内置的是 Electron 44.0.0、Node.js 24.21.0、pnpm 11.8.0、Python 3.12.14，以及 DSH 运行时 0.2.2-rc.1。

升级安装不需要手动关旧版。安装器会先请求正在运行的旧版本退出，等不到就强制结束它，再覆盖文件；如果确实关不掉，安装会明确报错并停下，而不是装完打不开。升级前仍建议先保存手上的工作。

注：Windows ARM64 目前是实验性构建。主程序是 ARM64 原生，但包内部分载荷（内置 Python / Node / Office 运行时、部分原生模块）仍是 x64，未在 ARM 设备上完成完整验证，普通用户建议使用 x64 版本。

三、第一次打开

首次启动会自动准备好一套默认配置（名为 desktop 的 Profile），并在本机启动界面服务。你会先看到一段向导，共七步，随时可以「跳过设置」，之后在设置页里补。

向导完成后会进入主界面。关闭窗口不等于退出应用：默认关闭只是把窗口收进托盘，后台服务与正在跑的任务继续运行；要真正退出，请用托盘菜单里的「退出」。

四、主界面速览

五、开始第一次对话

1. 新建一个会话，选好工作目录。
2. 用一句话说清「做什么 + 在哪做 + 结果要什么样」。例如：「读一下这个目录里的 README，把里面过期的下载链接找出来并列成表」。
3. 它开始干活后，留意工具调用与改动的文件；需要它换方向，直接打断并说新要求。
4. 结果不满意就说清哪里不对，它会带着上下文改，不必重开一个会话。

把需求说清楚的三个要点：

• 范围：只改哪个目录、哪些文件，别让它自由发挥。
• 验收：什么样的结果算完成（能跑起来、测试通过、表格里没有空值）。
• 约束：不能动的东西、必须保留的格式、可以联网或不可以联网。

六、托盘菜单

窗口关掉后，托盘图标就是应用的总入口。右键托盘图标可看到：

七、设置页

设置入口在侧边栏底部（设置 → 桌面设置）。各分区如下：

八、Profile：多套配置

Profile 是一套独立的配置环境：会话、插件、设置都各归各的，互不干扰。典型用法是「工作」和「个人」各一套，或「日常」与「试验新插件」各一套。

三条实用规则：

• 一套 Profile 装坏了，换另一套就能继续干活，不必先救它。
• 新建 Profile 是空的（只有官方基础组件），需要重新装插件——这正是它干净的原因。
• 删除 Profile 会连同本地配置与插件文件一起删除，且不可撤销。

九、插件：出厂状态与安装方法

9.1 出厂自带什么

安装包不预装任何第三方插件。首次启动时创建的默认 Profile 只加载两个官方基础组件：

• @deepseek-ai/dsh-base——Host 内核：会话、工具、文件访问、模型接入。
• @deepseek-ai/dsh-web-app——你看到的 Web 界面。

也就是说，刚装好时你得到的是一个干净、能对话、能读写文件、能跑命令的桌面应用；插件市场、专家团、语音输入、任务看板、代码图谱等等，都要你自己装。这是有意的设计：装什么由你决定，出问题也容易定位到「最近装的那个」。

9.2 三条安装途径

插件页（左侧「插件」，副标题是「安装、启用和配置插件」）分两件事：

• 装新插件：点「添加插件」，选「安装第三方插件」，填入 npm 包名（如 dsh-xxx 或 @作者/插件名）、GitHub 仓库地址或本机目录。安装时可以选安装源：默认安装源、官方源、中国大陆镜像源，或自定义的内网 npm 源。
• 管已装的：在「已安装插件」里启用、停用、卸载、检查更新，也能看到每个插件的版本、来源与运行状态。

有一部分插件是随 DSH 一起提供的：它们显示为「插件已随 DSH 提供 · 无需下载，启用即可使用」，点启用就生效；当它比当前 DSH 版本旧时会出现「更新」。属于这一类的有专家团、语音输入、插件市场、自动审查、终端、会话搜索、会话标题、徽章技能、Ralph、思维链翻译、Inspector、LiveShare、Forge、工作树工具、个性化推荐等。体积或依赖较重、默认不装的（Claude Code 子代理、Codex 子代理、Computer Use 桌面控制）同样从插件页按需启用。

随 DSH 内置的基础组件（dsh-base、dsh-web-app 这类）不出现在插件页的可管理列表里，它们的运行状态在设置 →「内置插件」查看。

插件市场当前有两个可选：dsh-community-market（内置的开放市场，支持自定义数据源）与 dsh-market（社区热门市场，数据来自 awesome-dsh-plugin）。两者一次只能启用一个。

终端里的三条命令（不带 --profile 时作用于当前激活的 Profile）：

9.3 装完要重启，装完要确认

装完插件后重启应用才会加载——安装完成时界面会提示「已安装，请重启 DSH 加载它」。确认是否装上：

1. 打开插件页，看它是否出现在「已安装插件」里、是否处于启用状态。
2. 看侧边栏有没有出现它的入口（市场、看板、专家团之类的页面）。
3. 仍不确定就打开「设置 → 日志」，把日志级别调高后重启一次，加载失败通常会有明确报错。

9.4 停用与卸载

• 先停用、再卸载：停用只让它下次启动不加载，安装文件和配置都还在，随时能开回来；卸载会走 dsh plugin remove 把包删掉，界面会问一句「卸载后它提供的功能会消失」。恢复助手里把「停用」叫作「禁用」，是同一件事。
• 插件管理器本身需要的组件（Host、Web 服务、文件访问等）会标着「插件管理所需，不能停用或卸载」——这是防止把应用卸成砖。dsh-base、dsh-web-app 这类内置基础组件则根本不进可管理列表，只能在「设置 → 内置插件」里看状态。
• 从旧版升级上来的 Profile，插件市场默认保持关闭，直到你在设置里明确选一次。这不是故障。

9.5 插件把应用装坏了怎么办

不用重装系统，也不用删数据目录。走第十节的恢复助手：先在「插件管理」里禁用最近装的那个，再启动；实在不行用「回滚」退回到上一个能启动的检查点。

十、安全模式与恢复模式

这两个功能解决的是同一类问题：装了什么之后起不来了。区别在于，安全模式是「干净地进去干活」，恢复模式是「停在门外修」。

10.1 安全模式

安全模式用一套独立的临时数据目录启动：不读你原有的插件、设置、会话与工作区记录，因此也不会被它们拖垮。原数据一个字节都不动。

进入方式：托盘 →「进入安全模式…」；或在恢复助手首页点「安全模式」。

在安全模式里能做什么：

• 确认「到底是不是插件的问题」——如果安全模式下一切正常，问题基本就在插件或配置上。
• 用网页界面正常对话、读写文件，先把急事办完。
• 查看日志、导出诊断信息（诊断包在恢复助手里也导得出）。

限制（设计如此）：

• 桌面设置页固定为只读，改不了。
• 浏览器访问、局域网访问、Agents-Anywhere、桌面通知等依赖持久配置的项不可用。
• 界面顶部会一直显示「安全模式」提示条，提醒你现在跑在临时环境里。

退出：托盘 →「退出安全模式并重启…」。退出后，临时环境会在下次正常启动时自动清理，不会留在磁盘上占地方。

10.2 恢复助手（恢复模式）

什么时候会进来：

• 你主动从托盘「重启到恢复模式」，或设置页 → 版本与更新 →「重启到恢复模式」。
• 启动连续失败，应用自己退到恢复助手。
• 界面实在起不来时，会单独弹出「恢复 DSH Desktop」对话框，可以再试一次恢复，不必重启后台服务。

恢复助手会告诉你三件事：为什么进来（手动进入会写明「已手动进入恢复模式」）、当前用的是哪个 Profile 和哪个目录、启动停在了哪一步（Electron 初始化 → Shell 环境准备 → 桌面运行时准备 → Profile 选择 → 插件配置组合 → 启动插件服务 → 桌面界面启动 → 确认启动结果）。卡在哪一步，问题的范围就缩到哪。

回滚是怎么工作的：每次成功启动后，应用会存一个「启动检查点」——记下那一刻能跑起来的配置。回滚就是把 Profile、settings.yaml 和插件启用状态一起退回到那个时间点。检查点会显示「可恢复 / 无法读取 / 尚无检查点」三种状态；「无法读取」说明那个检查点本身坏了，换一个更早的。

恢复出厂设置：把当前数据目录整体移入废纸篓（Windows 为回收站），重启后新建一套默认 Profile。数据目录之外的项目文件不会被删——它只清自己的配置与会话。执行前请确认你真的不再需要旧会话。

10.3 出口

修好之后不必手动清理：直接正常退出恢复助手并启动应用即可。如果是从恢复模式点「重启」，应用会重新走一遍正常启动流程；再失败就回到恢复助手，不会无限循环刷屏。

十一、更新

五个阶段：检查 → 下载 → 安装 → 重启 → 确认版本。四个可复用的操作：

• 手动检查：托盘 →「检查更新…」，或设置 → 版本与更新 →「检查更新」。
• 重启：设置 → 版本与更新 →「重启」；标题栏有更新提示时也可直接点。
• 清理安装残留：更新失败通常是被旧实例占着文件。托盘退出应用后重跑安装包即可，不必手动删目录。
• 回退：从测试通道回稳定版用托盘「安装稳定版…」；只想回到上一个能启动的状态，用恢复助手的「回滚」。

十二、遇到问题怎么办

导出诊断信息

托盘 →「导出诊断信息…」，或设置页底部同项。导出包里有本地路径、日志、系统信息、崩溃时的内存片段。分享前自己先看一遍：路径和会话片段可能包含隐私内容。

十三、数据在哪、去哪找帮助

更多文档

• README.md / README.zh.md：安装、构建、开发环境。
• docs/：架构说明、发布流程、插件开发指南。
• 同目录 Nonead-DSH-Desktop-User-Manual.en.md 与八个语言的 HTML 版：内容对应，便于对照。

致谢

本产品建立在上游 DeepSeek Harness 与开源社区之上：Electron、Node.js、pnpm、Python，以及 Cordis 插件体系与官方 bundle 生态。感谢上游维护者与所有贡献者。

第三方插件的作者信息随各自插件分发，可在插件页或插件市场的详情里查看；本手册不再逐个罗列具体版本与作者，因为那属于你的安装选择，而非产品出厂状态。

手册随版本更新。发现与当前版本不符之处，欢迎通过 GitHub / GitCode 提 issue。