Dkey Switch

---

name: dkey-switch

description: AI 窗口切换技能。用于定位并激活 Windows 上的目标窗口，支持智能模糊匹配、窗口查找、进程匹配、句柄激活与标签切换回退。

argument-hint: <窗口关键字|进程名|窗口句柄>

metadata: {

"clawdbot":{

"emoji":"🪟",

"requires":{

"bins":["powershell"]

},

"install":[

{"id":"winget-powershell","kind":"winget","package":"Microsoft.PowerShell","bins":["powershell"],"label":"Install PowerShell (winget)"}

]

}

}

核心定位

本技能可以 直接执行窗口切换动作，而非仅提供快捷键建议。

关键特性：

• 智能模糊匹配：支持缩写（如"企微"→"企业微信"）、拼音首字母、跳跃匹配
• 双步安全流程：先 find-window 确认，再 activate-window 激活
• 精确回退机制：激活失败时自动降级到 Dalt 或 Dctrl

命令速查表

AI 标准操作流程（重要）

Step 1: 总是先执行 find-window

scripts\d-switch.cmd find-window <用户关键词> 5 --json

Step 2: 分析返回结果

情况 A：完全匹配（高置信度）

• 条件：items[0].title 与用户说的窗口名基本一致
• 操作：直接激活，无需询问用户

情况 B：部分匹配（需确认）

• 条件：有候选结果，但第一项不完全匹配用户描述
• 操作：列出候选列表，询问用户确认

情况 C：无匹配

• 条件：count == 0 或 status == "not_found"
• 操作：尝试更通用关键词，或告知用户未找到

Step 3: 执行激活

# 用户确认后（或高置信度直接激活）
scripts\d-switch.cmd activate-window <关键词> <用户选择的序号> --json

流程图

用户："切到企微文档"
  ↓
AI：执行 find-window "企微" 5 --json
  ↓
检查 items[0]:
  ├─ 标题 ≈ "企业微信-文档" → 直接 activate-window "企微" 1
  ├─ 标题不匹配 → 列出列表让用户选择
  └─ 无结果 → 尝试其他关键词或告知未找到

模糊匹配规则

支持的匹配类型

内置别名表

状态处理与错误恢复

JSON 返回状态

退出码

典型场景示例

场景 1：用户说"切到企微"

# AI 执行：
scripts\d-switch.cmd find-window "企微" 3 --json

# 假设返回 items[0].title = "企业微信"
# 判定：完全匹配 → 直接激活

scripts\d-switch.cmd activate-window "企微" 1 --json

场景 2：用户说"切到文档"（有多个候选）

# AI 执行：
scripts\d-switch.cmd find-window "文档" 5 --json

# 假设返回多个：WPS文档、企业微信-文档、VS Code文档...
# 判定：不完全确定 → 询问用户

# AI 回复：找到以下窗口，请确认：
# 1. WPS文档
# 2. 企业微信-文档  
# 3. VS Code - document.txt
# 请输入序号（1-3）：

# 用户回复：2
scripts\d-switch.cmd activate-window "文档" 2 --json

场景 3：用户说"切到浏览器"

# AI 执行：
scripts\d-switch.cmd find-window "浏览器" 3 --json

# 返回：Chrome、Edge、Firefox...
# 判定：有歧义 → 询问用户

场景 4：只知道进程名

# 适合标题频繁变化的应用（如 VS Code）
scripts\d-switch.cmd activate-process "Code" 1 --json

场景 5：窗口内切换标签

# 先激活窗口，再切标签
scripts\d-switch.cmd activate-window "chrome" 1 --json
scripts\d-switch.cmd Dctrl -1

非触发场景（不执行脚本）

以下情况不应调用本技能：

• 用户仅询问快捷键知识（如"Alt+Tab 是什么"）
• 用户仅讨论原理/概念（如"怎么切换窗口"但无执行意图）
• 用户明确说"不要执行"

平台兼容性

最佳实践

1. 总是先 find-window：除非用户明确指定了进程名或句柄
2. 优先使用 --json：便于程序化解析结果
3. 高置信度直接执行：第一项完全匹配时无需询问
4. 低置信度询问确认：有候选但不完全匹配时列出选项
5. 失败时友好提示：未找到时建议用户可能的关键词

快速参考卡

用户："切到XXX"
  ↓
find-window "XXX" 5 --json
  ↓
items[0] 匹配？ ──Yes──→ activate-window "XXX" 1
    │
    No
    ↓
列出选项询问用户
    ↓
activate-window "XXX" <用户选择>