← 返回列表
未验证
一个小巧且轻量的置顶工具
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/9/14 · 已提供中文文档
综合分
28.9
GitHub 分
28.9
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add MARIOMLY/dsh-window-pin该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
信任档位：已验证本站已于 0 天前真实安装成功
- 是什么
- dsh 原生插件 · desktop
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 11 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/24（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-tools@deepseek-ai/dsh-typert-protocol用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-window-pin
给 DSH 桌面应用窗口加一个置顶（始终在最前）开关。
左侧栏底栏（「设置」左边）会出现一个图钉按钮：
- 空心图钉 = 未置顶，点击把窗口固定在最前面；
- 实心图钉 + 高亮 = 已置顶，点击取消。
另外注册了一个模型工具 window_pin，可以直接说「把窗口置顶」让 Agent 代劳：
window_pin { action: "status" | "on" | "off" | "toggle" }
它到底做了什么
浏览器没有把原生窗口设为置顶的 API，所以真正的动作在宿主侧完成：
图钉按钮 → windowPin Remote 命名空间 → 宿主 spawn PowerShell
→ SetWindowPos(hwnd, HWND_TOPMOST) → 读回 WS_EX_TOPMOST 确认
跨进程改 z-order 是允许的。不要把它和跨进程子类化混为一谈：后者
（SetWindowLongPtr）会被 Windows 以 ERROR_ACCESS_DENIED 拒绝，本项目实测过。
置顶状态会被记住
落盘的是意愿（desired），不是窗口句柄。桌面窗口重建后（重启服务、
关掉窗口再从托盘叫回），句柄变了、也不再是 topmost，但页面再次加载时会读到
desired 并把置顶补回来——只在桌面应用窗口里做这件事，普通浏览器标签页
的加载不会去动别人的原生窗口。
目标窗口是怎么选出来的
按顺序（lib/window-topmost.ps1）：
1. 上次记住、且仍然活着的窗口句柄；
2. 前台窗口——只要它的标题带着标记。点按钮就会让那个窗口成为前台，所以这条最准；
3. 标题带标记、且进程看起来是 Chromium --app 的可见窗口；
4. 第一个标题带标记的可见窗口。
标记默认是 DeepSeek Harness：这个字符串硬编码在
@deepseek-ai/dsh-client-ui-layout 里（const productTitle = "DeepSeek Harness"），
不是从品牌服务来的，所以换皮肤不会让它失效。
status / 工具输出会带上「选中的是哪个窗口、依据是什么、候选有几个」，
选错时能直接看出来。
安装
dsh plugin --profile web add
dsh.bundle.patch 会把 window-pin 这一行插进 profile 的组合树，重启后生效。
本机的两个硬约束（都实测过，别踩回去）
1. 子进程必须用 spawn + 文件句柄，不能用 execFile。
execFile 为了把输出收集成字符串一定会建管道，传给它的 stdio 文件句柄
根本不被使用，于是：输出进了管道（读文件恒为 0 字节，退出码 0、stderr 也空），
受限模式下还直接抛 spawn EPERM。spawn 严格照 stdio 数组执行。
2. 辅助脚本必须 ASCII-only 且无 BOM。
PowerShell 5.1 用 ANSI 代码页解码无 BOM 的 .ps1，一个非 ASCII 字节就是
一个潜在解析崩溃。中文目录靠 import.meta.url / 调用方传参绕开，不写进脚本字面量。
脚本开头强制 [Console]::OutputEncoding = UTF8，否则 CJK 标题会以 OEM 代码页
发出去变成乱码。
离线校验
pnpm run typecheck # 客户端半
pnpm run build # tsdown(cjs) + tools/wrap-client.mjs
node verify.mjs # 静态断言 + 只读跑一次辅助脚本，失败即 exit 1
node verify.mjs --live # 额外做一次真实的「置顶 → 读回 → 取消 → 读回」
verify.mjs 的每一条断言都对应一个真实踩过的坑（客户端必须是 ModuleLoader
工厂而不是裸 ESM、strict codec 必须带非空 typeSymbol、解包必须同时要求
ok 与 value、端点名不能撞网关保留名……），改代码前先看它。
已知边界
- 只支持 Windows（需要 Win32 SetWindowPos）。
- 没有托盘菜单项：托盘属于 dsh-desktop-app，本插件刻意不碰它。
- 一次调用约 400–500 ms（PowerShell 启动 + Add-Type 编译 C#）；
按钮图标是即时反馈的，不至于觉得卡。
License
MIT