前言¶
在 Windows 上使用 DeepSeek Harness 桌面端时，主窗口容易被其他应用挡住，需要频繁切回前台。系统自带的窗口管理或手动拖叠并不能在 Harness 界面里一键切换「始终置顶」。dsh-pintop 是社区维护的 DSH 客户端插件，在 Harness 左侧边栏底部增加置顶控制，安装后可在「大肥鱼」界面左下角操作，无需离开对话界面。
下面介绍插件定位、能力与安装方式。事实以 GitHub 仓库 与 SkillHub 目录页 为准。
这是什么¶
dsh-pintop（npm 包名 dsh-pintop，当前版本 0.1.2）由 waterha 维护，分类为客户端插件。它为 DeepSeek Harness 提供 Windows 原生窗口置顶：通过侧边栏按钮切换 Harness 主窗口是否始终在最前。
插件默认使用当前 Harness 宿主进程的 process.execPath 定位 DeepSeek Harness.exe，不绑定固定安装目录；移动或重装 Harness 后一般无需改配置。
核心功能¶
- 侧边栏置顶控件：按钮位于左侧边栏底部。侧边栏展开时显示「窗口置顶 / 取消置顶」；收起时显示图钉图标，并保留无障碍标签。
- 路径回退：若宿主无法通过
process.execPath提供正确的DeepSeek Harness.exe路径，可在插件配置中设置executablePath，或设置环境变量DSH_PINTOP_EXECUTABLE。值必须是已存在的DeepSeek Harness.exe绝对路径。 - 平台与依赖：面向
platform: web的客户端注入；要求 DSH 引擎>=0.2.0-rc.2（见package.json中dsh.engines）。
运行前置¶
使用前请确认：
- 操作系统为 Windows。
- 已安装 PowerShell 7，命令名为
pwsh.exe，且已加入PATH。
不满足上述条件时，插件自带的原生置顶逻辑无法按设计运行。
安装与启用¶
官方 README 提供三种方式，任选其一。
方法一：在 Harness 对话中安装
在 DeepSeek Harness 对话框中输入（含仓库地址）：
请帮我安装这个插件https://github.com/waterha/dsh-pintop.git
等待安装完成后 重启 DSH。
方法二：CLI（web profile）
dsh plugin --profile web add dsh-pintop
方法三：插件管理器本地包
在正在运行的 Harness 插件管理器中，使用本地包路径安装，将示例路径替换为你的实际目录：
file:C:/path/to/dsh-pintop
安装插件会以当前 DSH 进程权限执行相关逻辑；安装前建议阅读仓库源码与 MIT 许可证。
典型用法¶
- 按上一节完成安装并重启 Harness。
- 打开 DeepSeek Harness 桌面端，在左侧边栏底部找到置顶入口（展开为文字按钮，收起为图钉）。
- 点击一次开启窗口置顶，Harness 主窗口将保持在其他窗口之上；再次点击取消置顶。
若置顶无效，检查 pwsh.exe 是否在 PATH 中，并按 README 配置 executablePath 或 DSH_PINTOP_EXECUTABLE。
适用场景与注意¶
适合：主要在 Windows 上使用 Harness 桌面端、需要长时间对照文档或其它窗口、又希望少切换焦点的开发者或日常用户。
注意：
- 仅支持 Windows；Linux / macOS 不在 README 声明范围内。
- 依赖 PowerShell 7 与正确的
DeepSeek Harness.exe路径。 - SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；插件亦非官方应用商店分发包。
结尾¶
dsh-pintop 把「窗口是否置顶」收进 Harness 左侧边栏，减少在系统任务栏与其它窗口间来回切换。需要进一步了解或查看星标与分类信息时，可访问目录页 skillhub.cn/plugins/waterha/dsh-pintop 与源码仓库 github.com/waterha/dsh-pintop。
