前言¶
在 Windows 上日常使用 DeepSeek Harness 桌面应用时，希望登录后自动启动客户端，常见做法是手动往「启动」文件夹放快捷方式，或自己在注册表 Run 项里写路径。路径一旦重装或升级变化，条目就会失效；若在任务管理器里禁用过启动项，状态和设置界面也未必一致。
下面介绍社区插件 dsh-desktop-autostart-win（维护者 nanwu98，分类：客户端）。它在 DSH 设置里增加一页 Startup / 开机自启，用一个开关维护当前用户下的启动项，并自动探测已安装的桌面端 .exe，不把路径重复存进插件配置。
这是什么¶
插件全名：dsh-desktop-autostart-win。作用范围是 DeepSeek Harness 桌面应用在 Windows 10/11 上的登录后自启：设置里一个开关，对应 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 里的一条 per-user 记录；页面展示的状态以 Windows 实际会执行的为准。
发行在 GitHub，无 npm 包。许可证 MIT。当前 package 版本为 1.0.0。DSH 侧要求 >=0.2.2-rc.1 且 <0.3.0，且 bundle 仅支持 win32（非 Windows 安装会被拒绝，而不是显示无效开关）。
核心功能¶
设置页与开关行为¶
安装后可在 设置 → 开机自启 操作：
| 开关 | 效果 |
|---|---|
| On | 在 HKCU\...\Run 写入 DeepSeek Harness = "<desktop app>.exe"，并清除任务管理器里此前的「已禁用」记录，使用户登录后 Windows 会启动该应用。 |
| Off | 删除该注册表值，应用不再自动启动。 |
插件配置里不重复保存启动状态；唯一持久状态就是上述 Run 项，因此页面反映的是系统真实行为。
自动查找桌面端可执行文件¶
不硬编码安装路径。按顺序尝试，遇到第一个存在的可执行文件即停止：
| 来源 | 读取内容 |
|---|---|
| 正在运行的桌面应用 | Host 为桌面应用时，使用 process.execPath |
| App Paths | HKCU/HKLM 下 App Paths\DeepSeek Harness.exe（含 64/32 位视图） |
| 安装目录 | %LOCALAPPDATA%\Programs、%ProgramFiles%、%ProgramFiles(x86)% 及常见产品文件夹名 |
| 卸载注册表 | HKCU/HKLM 卸载项中的 DisplayIcon、InstallLocation、UninstallString |
仅接受真实 .exe，会拒绝 node.exe、electron.exe 和卸载程序。设置页会显示匹配来源；未找到时下次打开页面会重试（结果缓存一分钟）。因此在纯 dsh CLI 会话里开关仍可用：CLI 虽是 node.exe，仍可从注册表等解析出桌面端路径。
与任务管理器启动项的关系¶
Windows 是否运行启动项，同时受 Run 键和任务管理器「启动」批准记录影响。插件写入 Run 项，并在打开开关时清除对应的 StartupApproved 记录，使曾在 任务管理器 → 启动 里被禁用的项在重新打开开关后恢复。若项仍存在但被禁用，页面会如实提示，而不会显示为已开启。
无需管理员权限：读写均在当前用户 HKCU，不写机器级配置。
权限与隐私¶
读取：用于定位应用与展示状态——Run、Explorer\StartupApproved\Run、App Paths、卸载相关字段（显示名、图标、安装目录、卸载命令等）。
写入：仅在使用开关时——增删 Run 下的 DeepSeek Harness 值，并在开启时删除匹配的 StartupApproved 项。
插件不发网络请求、不写文件、不采集遥测。检测到的路径与注册表状态仅返回给本机设置页（路由拒绝非 loopback 访问，除布尔开关外只读）。
安装与启用¶
环境：DSH 0.2.2-rc.1 或更新的 0.2.x、Windows 10/11、Node.js 22+（随 DSH 捆绑）。下面命令中的 desktop 请换成你实际启动 DSH 使用的 profile。
从 GitHub 安装（本机需 Git，DSH 会用 git ls-remote 校验仓库）：
dsh plugin --profile desktop add github:nanwu98/dsh-desktop-autostart-win
固定到 release v1.0.0：
dsh plugin --profile desktop add github:nanwu98/dsh-desktop-autostart-win#v1.0.0
无 Git 时可用 release 压缩包：
dsh plugin --profile desktop add https://github.com/nanwu98/dsh-desktop-autostart-win/releases/download/v1.0.0/dsh-desktop-autostart-win-1.0.0.tgz
也可在 DSH 插件 → 添加插件 中粘贴仓库 URL 或 tarball URL（仅包名对 registry 包有效）。若页面提示重启 DSH，重启后打开 设置 → 开机自启。
在 插件 → 发现 中可增加索引源以便 Discover 发现本包（需当前 DSH 版本启用实验性 plugin-market bundle），例如 jsDelivr：
https://cdn.jsdelivr.net/gh/nanwu98/dsh-desktop-autostart-win@main/index.json
典型用法¶
- 按上一节任选一种方式安装插件。
- 打开 设置 → 开机自启，确认页面显示的桌面端路径与匹配来源是否符合预期。
- 打开开关：下次 Windows 用户登录后应自动启动 DeepSeek Harness 桌面应用。
- 不再需要自启时，将开关关闭；若准备移除插件，建议先关开关再卸载 bundle（见下节）。
卸载 bundle：
dsh plugin --profile desktop remove dsh-desktop-autostart-win
移除插件会删掉路由与设置页，不会自动清除已写入的 Run 启动项；若需彻底取消自启，应先关开关或手动清理 Run 项。
适用场景与注意¶
适合谁： 在 Windows 上固定使用 DeepSeek Harness 桌面端、希望登录即启动、又希望路径随安装方式自动更新的 DSH 用户。
平台： 仅 Windows；Linux/macOS 用户不应安装此 bundle。
DSH 与插件权限： 插件随当前 DSH 进程运行，注册表操作以该用户上下文执行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认行为符合本机策略。
与其它做法的区别： 本插件管理的是 per-user Run 键，而非「启动」文件夹；与同名称其它插件无隶属关系，选型时以 README 说明为准。
DeepSeek Harness 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-desktop-autostart-win 把 Windows 登录自启收敛为一个设置开关、一条 HKCU\Run 记录和一套可解释的桌面端探测逻辑，并区分任务管理器禁用状态，适合需要稳定、可核对开机行为的桌面 DSH 场景。
- 目录页：https://www.skillhub.cn/plugins/nanwu98/dsh-desktop-autostart-win
- 源码与文档：https://github.com/nanwu98/dsh-desktop-autostart-win
