name: window-transparency-tool
description: "窗口透明管理器：设置任意 Windows 窗口 Alpha 透明度（0-255）最大化透出桌面壁纸，支持鼠标穿透+置顶、右键三连击一键切换穿透、F11 全屏保护、零宽字符鲁棒匹配窗口标题。当用户需要「窗口透明」「透出壁纸」「鼠标穿透」「调整透明度」时使用。"
agent_created: true
技能元配置
skill_id: win‑transparent‑window‑manager
skill_name: 窗口透明管理器‑最大化透出壁纸
os_support: ["Win10","Win11"]
background_run: true
tray_icon: true
hotkey_support: true
功能模块列表
modules:
- name:基础透明度调节
desc: 设置窗口整体 Alpha 透明度（0‑255），并可选开启鼠标穿透
- name:鼠标穿透 + 置顶模式
desc: 透明窗口不再拦截鼠标点击，点击可透到后方窗口；开启穿透时自动置顶，防止点击后方窗口后本窗口被遮挡消失
- name:一键切换穿透(toggle)
desc: 仅翻转鼠标穿透开关，保留透明度与置顶；用于「想操作时关穿透」「操作完再开穿透」之间快速切换
- name:鼠标热键监听(默认右键3连击)
desc: 后台轮询监听鼠标按键，连击指定按键 N 次即自动切换目标窗口穿透；默认右键连点3次，参数可自定义(次数/按键/间隔)。基于 GetAsyncKeyState 轮询，无需全局钩子，跨会话稳定
restriction:
- F11 全屏模式禁用透明效果
- 热键监听为全局按键轮询，系统任意位置连击都会触发；避免误触可改用 middle(中键) 或调大次数
- 监听进程须在用户真实桌面会话中运行（通过 cmd/PowerShell 执行），才能读到真实鼠标按键
usage:
- 开启透明+穿透+置顶: python win_transparent.py "窗口标题" 70 穿透
- 恢复不透明并取消穿透/置顶: python win_transparent.py "窗口标题" 255
- 一键切换穿透(保留透明/置顶): python win_transparent.py "窗口标题" toggle
- 启动热键监听(默认右键3连击): python win_transparent.py "窗口标题" listen
- 自定义热键(次数 按键 间隔ms): python win_transparent.py "窗口标题" listen 3 right 600
- 另: listen 后可接 次数 / 按键(left,right,middle) / 间隔ms 三个可选参数
支付宝付费改造契约（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），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
