前言¶
DSH（DeepSeek Harness）默认通过浏览器访问：要自己起服务、记地址，也没有系统托盘和桌面快捷方式。若你同时在用 chat.deepseek.com，窗口往往和 DSH 来回切换，很难固定成「左 Harness、右 Chat」的工作区。
dsh-oneclick-desktop 是社区插件，面向 Windows，在 DSH ≥ 0.2.0-rc.2 的前提下，用一次安装补上桌面启动、托盘菜单，以及侧边栏一键分屏。下面介绍它做什么、怎么装、怎么用，以及安装前需要了解的权限与限制。
这是什么¶
维护者 MKInori 在 GitHub 开源的客户端类 DSH 插件（目录页）。一句话：把 DSH 变成可双击启动的桌面体验，并用 Win32 把 DSH 窗口与 chat.deepseek.com 的浏览器窗口并排摆好，而不是在页面里嵌 iframe。
chat.deepseek.com 的 CSP 为 frame-ancestors 'none'，浏览器会拒绝被 iframe 嵌入，因此「在 DSH 里嵌一个 Chat 面板」在技术上不可行。本插件用两个独立窗口对齐可视区域，看起来像一体两栏。
核心功能¶
装一次后，README 归纳为三块能力：
| 能力 | 说明 |
|---|---|
| 桌面启动 | 双击桌面图标启动 DSH：拉起服务（若未运行）、无边框窗口、托盘图标 |
| 托盘控制 | 托盘菜单：打开 / 重启 / 查看状态 / 退出 |
| chat 分屏 | 侧边栏按钮把 DSH（约左 2/3）与 chat.deepseek.com（约右 1/3）并排；Ctrl+Alt+D 收起或拉出 chat |
分屏依赖 Microsoft Edge 或 Google Chrome，chat 使用独立 profile（~/.dsh/edge-deepseek-profile），与日常浏览器配置隔离。首次打开 chat 会稍慢：插件会等页面渲染完成再调整 DSH 窗口，避免分屏后出现白屏或空白条。
仅 Windows。 分屏、托盘、快捷方式都走 Windows 机制；其他平台安装后会给出明确提示，不会静默失败。
安装与启用¶
前提：Windows，已安装 Edge 或 Chrome，DSH ≥ 0.2.0-rc.2。DSH 本体仍需你先按官方方式装好；启动器由本插件安装，存在「先有 DSH 才能装插件、装完才有桌面图标」的先后顺序。
在 DSH 侧边栏「插件」页点 Add plugin，填入：
dsh-oneclick-desktop
或使用命令行（web profile）：
dsh plugin --profile web add dsh-oneclick-desktop
dsh plugin --profile web add github:MKInori/dsh-oneclick-desktop
安装完成后刷新页面（Ctrl+Shift+R）。桌面集成在插件加载时自动执行宿主侧的 lib/desktop.ps1 -Mode install，一般会：
- 把启动器脚本复制到稳定目录
~/.dsh/dsh-oneclick-desktop/launcher/（避免插件升级替换包目录导致快捷方式失效） - 在桌面创建
DSH.lnk，指向上述目录 - 在注册表写入 URL 协议
HKCU\Software\Classes\dshsplit
查看或重装集成状态：
powershell -ExecutionPolicy Bypass -File ~\.dsh\plugins\dsh-oneclick-desktop\plugin\lib\desktop.ps1 -Mode status
将 -Mode status 改为 -Mode install 可幂等重跑安装；-Mode remove 可撤销快捷方式、协议与复制文件。
典型用法¶
桌面启动：双击桌面 DSH 图标。
托盘：右键托盘图标，按需选择打开、重启、状态或退出。
chat 分屏：
| 目标 | 操作 |
|---|---|
| 打开分屏 | 点侧边栏 DeepSeek 按钮 |
| DSH 全屏（收起 chat） | Ctrl+Alt+D |
| 恢复分屏 | 再按 Ctrl+Alt+D |
| 关闭 chat 窗口 | 再点一次侧边栏按钮（文案变为「关闭 chat.deepseek」） |
若你手动最大化或拖动 DSH，插件不会自动纠正布局；可按两次 Ctrl+Alt+D（收起再拉出）重新贴合。分屏四周有缝时，可先最大化 DSH 再点一次分屏按钮重新计算边框。
排错时可查看 ~/.dsh/dsh-oneclick-desktop.log；桌面图标异常时用上面的 desktop.ps1 -Mode status / -Mode install 检查。
适用场景与注意¶
适合谁：主要在 Windows 上长期用 DSH，希望有桌面入口、托盘常驻，并固定「Harness + Chat」并排布局的开发者。
权限与安全：插件分客户端（页面按钮）与宿主半（跑在 DSH 宿主进程、以当前用户权限执行）。DSH 的工具审批不会沙箱化插件宿主代码。安装前建议阅读仓库源码与 MIT 许可证。宿主半会：写桌面快捷方式与注册表、启动随包发布的 PowerShell（lib/window.ps1、lib/desktop.ps1、launcher/DSH-Tray.ps1）、通过 user32.dll 移动/缩放窗口并设置任务栏归组、用 Edge/Chrome 打开 chat.deepseek.com、在服务未运行时执行 dsh web --no-open、在 ~/.dsh/ 写状态与日志、在 chat 打开时注册全局热键 Ctrl+Alt+D。README 写明它不会读取或上传任意文件内容、访问 chat 以外地址、修改日常浏览器 profile 或 DSH 安装目录。
卸载：
dsh plugin --profile web remove dsh-oneclick-desktop
powershell -ExecutionPolicy Bypass -File ~\.dsh\plugins\dsh-oneclick-desktop\plugin\lib\desktop.ps1 -Mode remove
~/.dsh/edge-deepseek-profile/ 以及 ~/.dsh/dsh-oneclick-desktop.state、dsh-oneclick-desktop.log 可按需手动删除。
社区插件目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本仓库是其中一条 Windows 客户端增强路径。
结尾¶
dsh-oneclick-desktop 解决的是 Windows 下 DSH 的启动与窗口形态问题，并在 CSP 限制下用真实窗口实现与 Chat 的并排协作。需要细节、排错表或实现说明时，以 GitHub README 与 DEVELOPING.md 为准。
- 目录页：https://www.skillhub.cn/plugins/MKInori/dsh-oneclick-desktop
- 源码：https://github.com/MKInori/dsh-oneclick-desktop
