name: windowsvoicedictationtool
description: "Windows一键语音听写助手：指导制作独立EXE后台启动全局热键，按下自定义按键唤起Windows原生语音听写Win+H，解决任务栏双图标与取消固定图标消失的痛点，附AutoHotkey-V1官方下载地址、编译教程与开机自启全套方案。当用户需要「语音输入」「语音转文字」「win+H听写」「免键盘打字」时使用。"
agent_created: true
Windows一键语音听写（独立EXE版，解决任务栏双图标）
技能简介
带你从零制作独立可执行程序，后台启动全局热键，按下自定义按键唤起Windows原生语音听写Win+H。解决原始AHK脚本固定任务栏出现双图标捆绑、取消固定图标全部消失的痛点；附带AutoHotkey‑V1官方下载地址、编译教程、开机自启全套方案。
基础信息
- 适用系统：Windows10 / Windows 11
- 难度等级：中等
- 分类标签：autohotkey,语音输入,win+H,全局快捷键,exe编译,任务栏图标,开机自启
- 前置依赖：AutoHotkey v1.1.37.02（V2版本不兼容本教程代码）
前置软件‑官方下载地址
1.AutoHotkey V1官网主页
https://www.autohotkey.com/
2.V1.1下载专区（必须下载V1，禁止首页默认V2）
https://www.autohotkey.com/download/1.1/
>安装完成后自带编译器Ahk2Exe，右键ahk脚本即可看见 `Compile Script (GUI)...`，无需额外下载工具。
## 🎯功能目标
生成独立exe程序，点击后台运行；按下自定义按键即可在浏览器、文档、聊天框任意输入位置呼出Windows自带语音听写。编译后exe与AHK本体解绑，能够安全固定到任务栏，无捆绑双图标问题。
## 操作步骤
### 步骤 1：创建AHK脚本源代码
1.桌面空白位置右键 → 新建文本文档
2.粘贴下方代码
```autohotkey
#SingleInstance Force
;请把下方"你的按键"替换成你想要使用的触发按键
你的按键::
Send, #{h}
return
>
> 修改示例：F2:: 代表 F2 按键；CapsLock:: 代表大小写锁定键
> 3. 文件‑另存为
- 文件名：
语音听写工具.ahk - 保存类型：所有文件
- 编码：UTF‑8
步骤 2：编译脚本生成独立 EXE（解绑双图标最关键一步）
- 右键
语音听写工具.ahk - 选择
Compile Script (GUI)... - 编译窗口所有参数保持默认，无需修改任何选项
- 点击蓝色 Convert 按钮编译完成，同目录生成
语音听写工具.exe
步骤 3：快捷方式创建 + 任务栏安全固定
- 右键 exe 文件 →【发送到】→【桌面快捷方式】
- 鼠标左键按住桌面快捷方式，拖拽到屏幕下方任务栏空白位置松开
✅现在点击任务栏图标启动程序，不会再出现两个 H 图标捆绑的问题
步骤 4：测试运行
- 点击任务栏图标启动工具，程序后台静默运行
- 点击输入框，让光标闪烁
- 按下你自定义设置好的按键，Windows 语音听写弹窗即可呼出
步骤 5（可选）开机自动运行
- 按下
Win + R - 输入命令：
shell:startup，回车打开开机启动文件夹 - 复制桌面 exe 快捷方式，粘贴进启动文件夹
之后电脑开机语音热键程序自动后台加载，无需手动点开。
⚠️避坑清单
- ❌禁止直接将
.ahk原始脚本钉任务栏，会触发双图标捆绑，取消固定图标全部消失 - 脚本运行后右下角托盘绿色 H 图标是后台进程，关闭 H 图标热键就会失效
- Windows 语音听写 Win+H 为系统自带功能，离线可用，不需要网络
- 禁止 AutoHotkey V2 运行本代码，语法不匹配，快捷键无响应
产出成果物
- 语音听写工具.ahk 源代码脚本
- 语音听写工具.exe 独立可执行主程序
- 任务栏快捷方式
4.（可选）开机启动快捷方式
支付宝付费改造契约（PAYSKILL）
本技能为付费技能（PAYSKILL）。调用遵循支付宝 AI 生意画像契约，由平台调度层执行 probe → pay → complete → ack 流程：
- probe（探测）：平台调用前先探测是否已持有本技能的支付宝有效订阅 / 付费凭证。已付费则直接放行。
- 402 Payment-Needed：未付费时，脚本向标准输出返回 HTTP 状态
402与Payment-Needed标记，提示用户通过支付宝完成付费（pay），平台据此唤起付费页。 - complete（扣费确认）：用户在支付宝完成扣费后，平台下发
Payment-Proof（付费凭证）。 - ack（验签放行）：平台携带
Payment-Proof重试本次调用；scripts/payment_gate.py验签该凭证，确认有效后放行主流程。
订阅持久化与幂等：
- 付费状态缓存在本地
.pay_cache/state.json，避免每次调用重复付费（订阅持久化）。 - 同一
Payment-Proof在 24h 幂等窗口内仅生效一次，避免重复扣费。
现金流改造后的调用套路：
用户调用 → 平台 probe →
未付费：下发 402 Payment-Needed → 支付宝 pay → complete → 下发 Payment-Proof
已付费/携带 Proof：脚本 ack 验签 → 放行主流程
> 本契约由 SkillHUB 平台调度层解析，脚本本地仅处理 402 / 验签 / 持久化 三环节；付费本体交给支付宝。
支付宝 AI 按量付费（Machine Pay / A2M）改造说明
本 Skill 已按支付宝官方 A2M 协议改造为 Pay Skill，付费闸口位于 scripts/payment_gate.py，统一调用云端计费服务 https://pay.pembroli.cn/api/resource。
付费流程
- 未付费调用时，服务端返回 HTTP 402 +
Payment-Needed头，携带金额、商户、订单号及 RSA2 签名。 - 买家侧
payment_gate.py收到 402 后引导用户完成支付，平台回传Payment-Proof。 - 客户端携带
Payment-Proof重试资源端点。
验付调用
服务端收到 Payment-Proof 后，调用支付宝验付接口（alipay.aipay.agent.payment.verify）核验凭证有效性（trade_no、out_trade_no、active 状态），验证失败返回 400，验证通过才进入资源发放。
履约确认
资源发放成功后，服务端异步调用履约确认接口（alipay.aipay.agent.fulfillment.confirm，trade_no）回执，标记本笔订单已履约；并按 out_trade_no 做幂等，重复请求直接返回已缓存结果，杜绝重复收费。
幂等与缓存
买家侧按 slug 本地缓存 Payment-Proof（24h TTL），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
```
