前言¶
在 DeepSeek Harness（DSH）里做桌面 computer-use，常见路径是打开聊天窗口写一长段 prompt，等模型在独立会话里慢慢点网页、截图、读图。任务其实早就完成了，后续仍可能为了「总结页面」继续消耗工具调用和 token。若你还想在不打断当前对话的前提下，用一句话触发桌面操作，并把快捷键、任务协议、步数上限都放在设置页里改，而不是手改 YAML，dsh-quickdesk（QuickDesk，快捷桌面）就是针对这一类入口与成本问题的客户端插件。
下面介绍它的定位、能力、安装方式与使用注意。事实以仓库 README 与 npm 包 dsh-quickdesk@1.2.0 为准；社区目录页见 SkillHub。
这是什么¶
QuickDesk 由维护者 aofchas（Gaoyuan Zhang）发布，许可证 MIT，当前包版本 1.2.0。它是一个可安装、可分发的 DSH 桌面助手插件，把「全局快捷键 → 一句话任务 → 桌面 computer-use 执行」封装成独立包：快捷键、语言、任务协议、状态浮窗等均在 DSH 设置页（设置 → Plugins → QuickDesk）调整，无需直接编辑 cordis.patch.yml。
运行环境限定 Windows 10/11，依赖 PowerShell 5.1 与 WinForms；package.json 声明 node >= 22、dsh 版本 >=0.2.2-rc.1 <0.3.0，且 os 仅为 win32。它不是 DSH 或 DeepSeek 官方组件；SkillHub 等社区目录为独立站点，与官方无从属关系。
核心功能¶
全局快捷键与输入框¶
默认全局快捷键为 Ctrl+Alt+Space。任意程序处于前台时都可呼出半透明输入框；按配置的提交键执行任务，按取消键关闭。字段 hotkey、submitKey、cancelKey 可在设置页修改，默认值分别为 Ctrl+Alt+Space、Enter、Escape。
DSH 设置页统一配置¶
在设置 → Plugins → QuickDesk 可编辑：快捷键、语言、状态浮窗位置与开关、工作目录、任务协议、步数预算、审批选项等。保存后写入当前 profile 的配置层（对应 cordis.patch.yml 中 id: quickdesk 的配置）；多数改动即时生效，仅快捷键或状态条位置变化时，浮窗 sidecar 会重启约 1 秒。
完成优先的任务协议与硬步数预算¶
每条任务前会按语言附加内置说明（来自 locale/<language>.json 的 prompt）。协议要点包括：
- 完成即停：目标状态出现（结果页已加载、文字已输入、文件已保存等）即结束，不再为收尾而滚动、截图或读取页面。
- 默认不写总结：最终只回 1 行结果；除非用户明确要求「告诉我 / 总结 / 列出内容」，否则禁止复述页面内容。
- 步数预算：目标在约 10 步内完成；
maxSteps默认 20，超限后插件会强制中止本轮（enforceMaxSteps默认true）。 - 工具纪律：优先 UIA；截图整场最多 2 张且仅作兜底；禁止用
pwsh、grep、read等文件工具处理页面内容。 - 仍要求使用用户可见的 Chrome 操作网页，不可逆动作前先询问。
README 中记载：同一「YouTube 搜索」类任务，旧版约 53 次工具调用；在 v1.0.3 起上述策略下，搜索约在第 10 步完成，截图从 12 张降为预期 ≤2 张。该对比来自仓库自述，仅作设计目标说明，非第三方测评。
界面与审批¶
- 语言：
language: auto跟随系统（中文系统用中文，否则英文），也可强制zh/en；输入框、状态浮窗、审批弹窗、设置页与任务协议共用同一套文案。 - 单行状态浮窗：置顶、鼠标穿透；运行中显示「第 N/20 步 · 动作」，结束显示「已完成 · N 步 · X 秒」；超过步数上限时显示「已停止 · 超过 20 步上限」。
- 审批弹窗：需确认的操作在右下角弹出，默认 Enter 通过、Backspace 拒绝（
approveKey/rejectKey可配置）。 - 桌面后端自检：提交前检查是否已注册桌面 computer-use 工具；未安装如
dsh-computer-use-win时直接提示，不启动会话。 - 新会话：默认自动套用自动审查（Auto review）预设，任务在默认工作区创建。
与 computer-use 插件的关系¶
QuickDesk 不 import、不修改 computer-use 插件，仅通过 DSH 工具注册表判断桌面工具是否存在。换用其他 computer-use 提供方时，检测逻辑剥离 mcp__<server>__ 前缀，不硬绑 dsh-computer-use-win。可选配置 disableComputerUseUi 尝试在 Host 端关闭 computer-use-win 的浮窗等（尽力而为，默认关闭）。
安装与启用¶
要求：Windows、PowerShell 5.1、DSH（web 或 desktop profile），以及提供桌面工具的 computer-use 插件（README 推荐 dsh-computer-use-win）。
从 npm 安装（推荐）：
# Web profile（DSH 插件市场一键安装用的就是这条命令）
dsh plugin --profile web add dsh-quickdesk
# DSH Desktop 也可以装到 desktop profile
dsh plugin --profile desktop add dsh-quickdesk
也可从 GitHub Release 下载 dsh-quickdesk-1.2.0.tgz，在 DSH「插件 → 添加插件」中安装；或在本地源码目录（需你自行准备的仓库路径）执行：
dsh plugin --profile desktop add .
安装或升级后需完全退出并重启 DSH，再在「设置 → Plugins → QuickDesk」中调整选项。安装前应阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，涉及桌面操控与审批，请按团队安全规范评估。
典型用法¶
- 确认已安装桌面 computer-use 插件，并完成 QuickDesk 安装与 DSH 重启。
- 在任意前台窗口按
Ctrl+Alt+Space（或你配置的hotkey），在半透明输入框中用一句话描述任务，例如搜索某关键词、在可见 Chrome 中完成表单填写等。 - 按
Enter（或submitKey）提交；观察右上角（默认statusCorner: top-right）单行 HUD 的步数与动作。 - 出现不可逆操作时，在右下角审批弹窗用 Enter / Backspace（或自定义键）通过或拒绝。
- 任务结束：HUD 显示完成与耗时；若超过
maxSteps，会中止并提示超限。
需要更省 token 的简单任务，可在设置页将 maxSteps 调低（README 示例 12）；复杂多窗口任务可调高（示例 40），或将 enforceMaxSteps 设为 false 仅保留 prompt 提示。若确实需要模型列出页面内容，应在任务句中明确「列出 / 总结 / 告诉我内容」。
高级分发可在 ~/.dsh/profiles/<profile>/cordis.patch.yml 整行覆盖 id: quickdesk 的 config（Loader 为整行替换）。常用字段默认值如下，完整表见 README：
- id: quickdesk
name: dsh-quickdesk
config:
hotkey: Ctrl+Alt+Space
submitKey: Enter
cancelKey: Escape
maxSteps: 20
enforceMaxSteps: true
language: auto
approvalPopup: true
适用场景与注意¶
适合：已在 Windows 上使用 DSH 与桌面 computer-use，希望用全局热键快速起独立会话、并把「完成即停 + 步数硬上限」当作默认纪律的开发者或重度用户。
不适合或未覆盖：非 Windows 平台；没有桌面操控后端时仅会提示安装，无法执行任务；重度依赖 YAML/GitOps 的团队仍可用 patch 覆盖，但日常仍以设置页为主。
安全与权限：插件不偷偷改其他插件设置；缺失后端时明确提示。审批超时默认 popupTimeoutMs: 120000（自动拒绝）。自定义任务协议可写设置页「任务协议」或 defaultPrompt，支持 {{MAX_STEPS}} 占位符。
仓库 README 还附带 UIA 使用说明 skills/uia/SKILL.md，供会话或团队约定参考。兼容与升级策略见 COMPATIBILITY.md。
结尾¶
QuickDesk 把 DSH 桌面自动化的调用入口收到快捷键与设置页里，并用完成优先协议与 maxSteps 硬约束控制单轮工具调用规模。若你在 Windows 上已部署 DSH 与 computer-use 后端，可按上文 npm 命令安装，在设置页核对快捷键与步数预算后再试一句话任务。
