精确时间新建文件夹技能
触发指令
用户可以通过以下方式触发此技能：
- “在 [路径] 创建一个以当前时间命名的文件夹”
- “帮我在 [路径] 新建一个时间文件夹”
- “新建一个精确到毫秒的时间文件夹，位置在 [路径]”
工作流程
-
获取目标路径
- 从用户的指令中提取目标文件夹路径（例如：C:\Users\Admin\Documents或/sdcard/Download）。
- 如果用户未明确指定路径，则默认使用当前工作目录（或提示用户输入）。 -
生成文件夹名称
- 获取当前系统时间，按照以下格式生成字符串：- 格式：
YYYYMMDDHHMMSSmmm - 示例：
20260721143526789（表示 2026年07月21日 14时35分26秒789毫秒） - 该名称将作为新建文件夹的名称。
- 格式：
-
执行新建操作
- 拼接完整路径：[目标路径]/[时间字符串]
- 调用系统 API 或命令行工具创建文件夹。
- 确保文件夹名称唯一（时间精度到毫秒，几乎不会重复）。 -
反馈结果
- 如果创建成功，向用户返回完整的新文件夹路径。
- 如果失败（如路径不存在或权限不足），返回具体错误信息并提示用户检查。
使用示例
用户输入：
> “在 D:\Projects\Backup 创建一个以当前时间命名的文件夹”
技能执行：
- 获取当前时间：2026-07-21 14:35:26.789
- 生成文件夹名：20260721143526789
- 创建路径：D:\Projects\Backup\20260721143526789
- 返回：✅ 文件夹已创建：D:\Projects\Backup\20260721143526789
用户输入：
> “新建一个时间文件夹，位置在 /storage/emulated/0/DCIM”
技能执行：
- 获取当前时间：2026-07-21 14:35:26.789
- 生成文件夹名：20260721143526789
- 创建路径：/storage/emulated/0/DCIM/20260721143526789
- 返回：✅ 文件夹已创建：/storage/emulated/0/DCIM/20260721143526789
注意事项
- 支持 Windows、macOS、Linux 以及 Android 文件系统路径格式。
- 若目标路径不存在，技能会提示错误，不会自动创建父级目录（出于安全考虑）。
- 毫秒部分使用三位数字表示，不足三位时前面补零（例如
007）。
错误处理
| 错误情况 | 返回信息 |
|---|---|
| 未提供路径 | “请指定一个有效的文件夹路径。” |
| 路径不存在 | “目标路径不存在，请检查后重试。” |
| 权限不足 | “没有权限在该位置创建文件夹，请检查权限设置。” |
| 名称冲突（极低概率） | “文件夹已存在，请稍后重试（时间已更新）。” |
跨端适配说明
- PC端：使用 Node.js
fs模块或系统命令mkdir。 - 移动端（Android/iOS）：使用 Work Buddy 提供的文件系统 API（如
FileSystem模块）。 - 技能内部会自动识别运行环境并选择合适的创建方式。
支付宝付费改造契约（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），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
