桌面端上手指南 9daywinter/dsh-desktop-starter-guide

DeepSeek Harness 桌面端 · 小白从零上手指南

一份面向完全新手的 DeepSeek Harness（dsh）桌面端上手教程，单文件 HTML，可离线打开。

仓库地址： https://github.com/9daywinter/dsh-desktop-starter-guide

它想解决的，是官方指南没说清的四个问题：

| # | 问题 | 这一页给出的东西 |
| 1 | 首次启动向导到底会问什么？ | 交互式复刻：可以反复走一遍真实流程，再决定装不装 |
| 2 | 装完之后那一小时该做什么？ | 六步确认式安装 + 12 项可勾选的装完后检查清单 |
| 3 | 安全声明看不懂 | 把 SAFETY 的法律/工程声明翻译成能照做的操作规则 |
| 4 | 插件该装哪些？ | 逐个查过 npm registry 的桌面端推荐，分用途、标注可信度 |

打开方式

直接双击 dsh-desktop-新手从零上手指南.html，或用浏览器打开。无需联网、无需服务器、无外部依赖（样式与脚本全部内联，图标是内联 SVG）。

深色 / 浅色主题会跟随系统，也可以手动切换。安装进度和检查清单的勾选状态存在浏览器 localStorage 里，关掉再打开还在。

内容结构

1. 首次启动向导 · 交互式复刻 — 欢迎 → 可用额度 → 用途 → 工作过程，含两种弹窗与余额分支
2. 安装：六步确认式教程 — 每步都要你确认条件满足，进度条与勾选状态可持久化
3. 装完之后的第一小时 — 工作区选哪里、权限给多少、模型怎么配、第一个任务做什么
4. 权限到底给多少 — 三档的原始界面文案与真实含义，含「完全权限」的风险确认原文
5. 模型怎么配 — 什么情况下零配置，以及手动配置的确切入口
6. 第一个任务做什么 — 三个能一眼判断对错的小任务
7. 桌面端特有的 5 件事 — 关窗口 ≠ 退出、后台任务面板、与命令行共用 ~/.dsh
8. 装完后检查清单 — 12 项可勾选待办，带「在哪个界面做」
9. 安全注意事项（人话版） — 该做/别做对照、插件 30 秒检查、出事自救表
10. 插件推荐（桌面版） — 均衡起步三件套 + 按用途可选 + 三条纪律
11. 速查卡 — 快捷键、关键路径、常用命令、新手最常犯的 5 个错

这份教程的取材方式

界面文案、权限模式、默认工作区路径、后台任务行为、退出拦截规则、插件安装规则，都取自本机安装的 DeepSeek Harness 0.2.0-rc.2 实际文件，逐字核对而非改写：

- 客户端文案字典（如用途卡片 办公与创作 / 代码与开发、过程三档 聚焦结果 / 关键细节 / 完整过程）
- 权限预设文案（仅可查看 / 工作区内修改 / 完全权限 及风险确认原文）
- 桌面壳的退出与托盘提示原文
- 默认工作区的构造逻辑（<文档>\deepseek-harness\default-workspace，语言无关的固定值）
- 插件管理器的兼容性检查与构建脚本批准规则

插件部分逐个查询了 npm registry 的真实包名、版本与周下载量。

两个必须纠正的常见错误

流传的「新手插件组合 dsh-market + dsh-at-file + ModLens」里，有两个包名在 npm 上不存在：

| 流传的名字 | 真相 |
| dsh-market | npm 上不存在，它是 GitHub 仓库/组织名。真正的包是 dshmarket |
| ModLens / modlens | 都不存在。真正的包是 @liustack/modlens |
| dsh-at-file | ✅ 名字正确 |

照错名字去装，要么装不上，要么可能在 npm 上撞到别人抢注的同名包。这也是本仓库存在的意义之一：新手教程里的包名必须能被验证。

一个重要的预期修正

桌面端最痛的那件事，没有插件能解决。 「窗口关了任务还在跑」「后台任务怎么管」是应用内置能力：

- 关窗口只是收进系统托盘，任务继续（原文提示：「正在运行的任务不会中断，可在系统托盘中重新打开窗口」）
- 后台任务面板是内置的，带实时输出与两击式停止
- 退出程序前会检查并拦截：「当前正在运行的任务将会中断」/「应用关闭期间，定时任务不会运行」

同样，没有插件的用途是「让桌面端和命令行共享数据」——因为两者本来就共用 %USERPROFILE%\.dsh。真正需要注意的是不能同时运行（端口冲突）。

所以插件推荐只聚焦三类精华：花钱看得见、装起来方便、跑完了叫你。

可信度标注

教程里对插件刻意分了两档标注，而不是笼统写「实测可用」：

- 已在本机桌面端安装 — 有实际安装记录可查（dsh-whale-widget）
- 已声明兼容当前版本 — 包的元数据里有指向 0.2.0-rc.2 的版本约束

没有任何第三方插件被保证「装得上、跑得通」——那需要在你的机器上真的装一次。安装前请按教程里的「30 秒检查」自己过一遍。

验证状态

这份教程不是「读完文档写出来的」，而是对着真实安装逐项核对的。说明清楚哪些验过、哪些没验：

已逐字核对（对照本机安装的 0.2.0-rc.2 实际文件）

- 首次启动向导的界面文案与分支逻辑：欢迎页、额度页、用途页、工作过程页，以及「跳过设置？」和「暂时跳过充值？」两个弹窗
- 权限三档的名称与「完全权限」的风险确认原文
- 桌面壳的退出拦截文案与托盘提示
- 默认工作区的构造规则
- 插件管理器的兼容性检查与构建脚本批准规则

程序化验证（tools/check-tutorial.mjs，本地 12 项全通过）

- 单文件自包含：无外部脚本/样式、无运行时远程请求
- 内联脚本能解析并跑完初始化
- 47 个 id 全部唯一；33 处 getElementById 目标全部存在
- 页面内锚点无断链
- 向导交互逐分支走通：卡片独立多选、只选办公→跳过过程页、选开发→进入过程页、三档过程值映射、两个弹窗、前进/后退

没有验证

- 没有生成任何界面截图。 本仓库只提供单文件网页，图示请以你机器上的客户端为准。
- 没有实际安装并运行任何第三方插件。 插件信息来自 npm registry 的公开元数据（包名、版本、周下载量、dsh 字段与 peer 依赖），「声明兼容」不等于「实测跑通」——教程里对这两者做了明确区分。
- 未在 macOS / Linux 上核对。文案取自 Windows 版，路径示例以 Windows 为主。

免责声明

- 本仓库是独立编写的非官方教程，与 DeepSeek 无关，不代表官方立场。
- 版本会变。本教程核对的是 0.2.0-rc.2；升级后请以实际界面为准，也欢迎提 issue/PR 更新。
- dsh 官方自己的说明是「尚未接受安全审计，不得视为安全或可用于生产环境的软件」。请据此安排你的使用方式。

贡献

欢迎修正文案、补充新版本差异、修正失效的插件信息。提 PR 时请一并说明你的版本号与信息来源，这样容易被验证。

仓库自带一个结构校验脚本，CI（.github/workflows/check.yml）会在每次提交时运行它。本地也可以跑：

node tools/check-tutorial.mjs

它检查的是「这一页有没有被改坏」，而不是内容对不对：

- 保持单文件自包含（无外部 / 、无运行时远程地址）
- 内联脚本能解析、能初始化完成（会真正执行一遍初始化路径）
- 每个 id 唯一，脚本里所有 getElementById 目标都真实存在
- 页面内锚点没有断链

改完教程记得跑一次；新增了界面元素而忘了接上事件，这个脚本能拦下一部分。

如果 Actions 尚未启用，CI 贴纸会一直不出现，但那只是没在跑，不代表校验通过。请以上面本地命令的输出为准，或到仓库的 Actions 页手动触发。

许可

MIT © 2026 9daywinter