前言¶
DeepSeek Harness（DSH）桌面端若希望每次登录 Windows 后自动打开，常见做法是手动往注册表 Run 项或「启动」文件夹里写一条启动命令。路径随安装位置变化，改开关时还要记注册表键名或 .cmd 位置，和 DSH 设置界面也脱节。
dsh-harness-autostart 是社区维护的 DSH 客户端插件（维护者 lolitakawayi），在 Settings → General 增加「Autostart」开关，并注册 dsh_autostart 工具，供模型查询、启用或关闭自启动项。两种入口共用同一套宿主逻辑，状态一致。仅支持 Windows；其他平台上开关为禁用，工具返回 unsupported-platform。
这是什么¶
插件 bundle 名 dsh-harness-autostart，在 cordis.patch.yml 中的条目 id 为 dsh-autostart。当前 npm 包版本 1.0.0，许可证 MIT。分类属于客户端侧 UI 与本地 HTTP 路由注入，依赖 Cordis 与 DSH 客户端设置 General 等 peer 包（见仓库 package.json）。
卸载插件时会删除已写入的自启动项，README 说明不会留下残留。
写入方式与路径检测¶
默认配置 method: run-key，在当前用户 Run 键下写入字符串值，不需要管理员权限：
HKCU\Software\Microsoft\Windows\CurrentVersion\Run
DeepSeekHarness REG_SZ "D:\ProgramData\dsh\DeepSeek Harness.exe"
示例中的 exe 路径仅为说明格式；实际路径由插件检测，而非写死。检测顺序为：环境变量 DSH_DESKTOP_EXE；若当前进程可执行文件不是 node.exe 则用该路径；否则使用默认安装路径。可在配置里设置 executable 覆盖。
method: startup-folder 则在 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\<entryName>.cmd 写入启动脚本，适合需要在登录后延迟几秒再打开应用的场景（配合 delaySeconds）。
核心功能¶
设置页开关¶
安装完成后，Settings → General 在「Performance usage」下方增加一行 Autostart。
- 控件为
role="switch"，带aria-checked；可用 Tab 聚焦后按空格切换。 - 切换后立即写入或删除自启动项，无需刷新页面或再调模型。
- 行内展示当前状态、写入方式（method）、条目名称（entryName）以及解析后的可执行文件路径。
浏览器端（client.js）只负责渲染；注册表与文件写入均在宿主 index.js 完成。读写通过同源 fetch 访问宿主注册的本地 HTTP 路由：
GET /dsh-autostart-8f3c/statusPOST /dsh-autostart-8f3c/enablePOST /dsh-autostart-8f3c/disable
三者均返回 JSON。
dsh_autostart 工具¶
插件注册工具 dsh_autostart，参数为单个 action：
| action | 作用 |
|---|---|
status |
返回当前状态、写入方式、条目名、解析后的 executable，以及注册表或文件中实际存在的值/路径 |
enable |
写入自启动项 |
disable |
删除自启动项 |
开关与工具调用同一宿主函数，不会出现一边开、一边关的不一致。
安装与启用¶
在 DSH 内通过插件管理器从 npm 安装：
plugin_manager action=install_bundle target=dsh-harness-autostart
从本地目录安装时：
plugin_manager action=install_bundle target=<absolute path to this directory>
安装后重启或按 DSH 惯例加载 bundle，即可在 General 中看到 Autostart。默认配置 autoEnable: true 时，插件加载时会写入自启动项；若只希望保留开关和工具、不自动改系统，将 autoEnable 设为 false。
配置¶
修改 cordis.patch.yml 里 dsh-autostart 条目的 config 块后，重启 DSH 生效。
| key | 默认值 | 含义 |
|---|---|---|
autoEnable |
true |
插件加载时是否写入自启动项 |
method |
run-key |
run-key 写 Run 键；startup-folder 写启动文件夹 .cmd |
entryName |
DeepSeekHarness |
Run 值名或 Startup 下文件名，净化为 [A-Za-z0-9_.-] |
executable |
'' |
空则自动检测 |
args |
[] |
传给应用的额外参数 |
delaySeconds |
0 |
登录后等待秒数；非零时在 Run 键方式用 cmd /c start 包装，或在 .cmd 中加 timeout |
卸载与手动清理¶
plugin_manager action=remove_bundle target=dsh-harness-autostart
卸载会删除自启动项。若异常残留，可手动删除 Run 值（条目名默认 DeepSeekHarness）：
reg delete "HKCU\Software\Microsoft\Windows\CurrentVersion\Run" /v DeepSeekHarness /f
适用场景与注意¶
适合在 Windows 上长期开机使用 DSH 桌面端、又希望用图形开关或模型工具统一管理自启动的用户。插件以 当前 DSH 进程权限 写 HKCU 或当前用户 Startup 目录，不涉及提升权限；安装前仍建议阅读仓库源码与 MIT 许可证，确认写入路径与 executable 检测逻辑符合你的环境。
DSH 生态强调「一切皆插件」；社区目录页与 GitHub 仓库由维护者发布，与 DeepSeek / 幻方无官方从属关系，本文不以「官方应用商店」表述。
