本册导览

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

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

一、这是什么

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

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

这个版本（Essentials 版）和软件仓库里的通用版还有一个区别：它不是「装了壳子等你装插件」的空应用，而是把 35 个已经挑过、互相能配合的插件一起装进安装包。装完第一次打开，这些能力就已经在插件页里等着了，不用你逐个去 npm 上找。

二、安装

到产品下载页取对应平台的安装包，双击即可。安装包已经内置 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 x64、macOS 通用包与 Linux x64 三种。Linux 的 arm64 产物在测试通道构建，尚未进入稳定下载链接；ARM 设备上若遇到原生模块问题，请改用对应平台的 x64 版本或测试通道产物。

三、第一次打开

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

最后一页会先给你一张大类概览：记忆与上下文、界面与工作区、智能体与技能、文档与媒体、代码与工程、机器人与仿真、连接与自动化，每一类写明「这一类能帮你做什么」和插件数量。点「完成并开始」后，向导才会逐个安装，并在每个插件轮到时展示它的名称、版本、所属大类、完整说明，以及一句「感谢某某带来这个插件」。安装期间不需要你操作，等进度走完即可——35 个包逐个装，首次启动会比平时多花一点时间。

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

四、主界面速览

装了预装插件之后，侧边栏和输入框还会多出一些入口：技能中心、任务看板、费用看板、输入历史、专家团等。它们都是第九节里那些插件提供的，关掉对应插件就会消失。

五、开始第一次对话

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

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

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

六、托盘菜单

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

上一版手册里提到的「模式：增强 / 兼容 / 扩展」已经取消：2.2.9 起窗口模式固定，只在设置里保留「窗口外观（材质）」这一项。

七、设置页

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

安全模式下这个页面是只读的，浏览器访问、局域网、远程控制、通知等项也会被禁用——这是设计如此，不是坏了。

八、Profile：多套配置

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

三条实用规则：

• 一套 Profile 装坏了，换另一套就能继续干活，不必先救它。
• 新建的 Profile 只有官方基础组件，预装的 35 个插件只装进向导完成的那一套。换了 Profile 想继续用，去插件页确认实际列表，缺哪个补哪个。
• 删除 Profile 会把它移入恢复备份目录（不是立即抹掉），共享的会话与设置会保留；但对该 Profile 而言已不可用，操作前确认。

九、预装的插件

这一节是本版手册的重点。2.2.9 的安装包自带 35 个插件，分布在七个大类里，第一次向导完成时自动装进当前 Profile。下面先讲清「装了什么、怎么装的」，再按分类逐个介绍，最后讲怎么管、怎么再装。

9.1 出厂预装了哪些

安装包把 35 个插件的压缩包一起分发（plugins/ 目录），首次向导结束时逐个装进 Profile。它们不是「可选下载」，而是装完就在：打开插件页，能在「已安装插件」里看到全部 35 个，默认处于启用状态。

9.2 预装是怎么发生的

几个值得知道的细节：

• 安装是逐个进行的，每装一个就在向导上显示它的名称、版本、大类、说明与作者。全部装完前不要关窗口。
• 成功判据是 Profile 的 package.json 依赖里出现这个包名，而不是命令有没有报错；装完还会把名字补进 profile.bundles，否则会出现「装了但没启用」。
• 单个插件失败不会拦住启动：装完若有失败，会弹一个汇总提示框逐条列出名称与原因，同时写进桌面日志（bundled plugin not installed: <名称>: <原因>），向导照常结束。事后可在插件页核对哪些真的在列表里。
• 只装进向导完成的那一套 Profile。之后新建的 Profile 是干净的，需要时重跑向导或从插件页补。

9.3 分类详单

以下按七个大类列出全部 35 个插件。名称后的 v 是随包版本；「适合」一句是给你的选择建议，不是功能限制。

9.4 停用、卸载与再装回来

• 先停用、再卸载：停用只让它下次启动不加载，安装文件和配置都还在，随时能开回来；卸载会走 dsh plugin remove 把包删掉，界面会问一句「卸载后它提供的功能会消失」。
• 卸载预装插件释放不了多少空间：安装包里的原始 .tgz 仍在程序目录的 plugins/ 下，删掉的是 Profile 里的安装副本。真想彻底瘦身，得换一个不带这些包的安装包，而不是逐个卸载。
• 装回来：设置 → 桌面工具 →「设置向导」，重跑到第 6 页点「完成并开始」，它会把 Profile 里缺的包补装；也可以按 9.5 的途径手动装。
• 受保护的组件不能动：插件管理器本身需要的组件（Host、Web 服务、文件访问等）会标着「插件管理所需，不能停用或卸载」；dsh-base、dsh-web-app 这类内置基础组件根本不进可管理列表，只能在「设置 → 内置插件」里看状态。

9.5 自己再装插件：三条途径

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

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

插件市场有两个可选：dsh-community-market（内置的开放市场，支持自定义数据源，Beta）与 dsh-market（社区热门市场，数据来自 awesome-dsh-plugin，随包插件名为 dshmarket）。两者一次只能启用一个；市场本身就是插件，所以也能在插件页里直接开关。

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

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

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

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

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

不用重装系统，也不用删数据目录。走第十节的恢复助手：先在「插件管理」里禁用最近装的那个，再启动；实在不行用「回滚」退回到上一个能启动的检查点。预装插件同样适用——它们和后来装的没有区别。

十、安全模式与恢复模式

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

10.1 安全模式

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

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

在安全模式里能做什么：

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

限制（设计如此）：

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

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

10.2 恢复助手（恢复模式）

什么时候会进来：

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

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

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

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

10.3 出口

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

十一、更新

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

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

十二、遇到问题怎么办

导出诊断信息

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

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

更多文档

• README.md / README.zh.md：安装、构建、开发环境。
• docs/：架构说明、发布流程、插件开发指南。
• 同目录 Nonead-DSH-Desktop-User-Manual.en.md 与八个语言的 HTML 版：内容对应，便于对照。
• CHANGELOG.md：每个版本的变更；2.2.9 条目下有与本册一致的「内置插件清单（35 个）」。

致谢

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

随包分发的 35 个插件来自以下作者与团队（按名称排序，同一作者可能贡献多个）：

每个插件的具体版本、作者与完整说明，都随包写在 plugins/manifest.json 里，也可以在插件页的详情中查看。

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