shortcut-share-file

name	shortcut-share-file
version	2.1.0
description	通过 iOS 快捷指令「极速分享」分享 iCloud Drive 文件。当用户提到"分享文件"、"传文件"、"发文件"、"分享给xxx"、"用快捷指令分享"、"发备份里的文件"等与分享文件相关的操作时触发。支持传递 iCloud Drive 备份目录下的任意文件路径给快捷指令。

分享文件 — 快捷指令「极速分享」

快捷指令链接：https://www.icloud.com/shortcuts/c0cd9fbdc42149c3b98e4f9fcb103011

核心原则

• 零处理零检查：不解压、不列出内容、不查看文件类型、不确认文件存在。直接走分享流程。
• 文件路径：源文件在 iCloud 映射到 /var/minis/mounts/iCloud/极速分享/，参数传 极速分享/<filename>（相对路径，不要绝对路径）。

工作流程

A. 测速（优先用记忆缓存）

memory_get(keywords="iperf3 测速 上传速度")

• 有记录且 24 小时内 → 直接用 upload_MBs 值
• 无记录或过期 → 执行：

iperf3 -c ping.online.net -t 3 --json 2>/dev/null | python3 -c "import sys,json;d=json.load(sys.stdin);bps=d['end']['sum_sent']['bits_per_second'];print(f'{bps/8000000:.2f}')"

输出为 MB/s（兆字节/秒），立即写入记忆：

memory_write(content="## 测速缓存\n- upload_MBs: <值> (<日期>)\n- 有效期为 24 小时")

B. 拷贝文件（如需）并计算时间

如果文件不在 /var/minis/mounts/iCloud/极速分享/ 下：

cp <源文件路径> /var/minis/mounts/iCloud/极速分享/<filename>

计算参数后缀：

• 来自 iCloud 其他目录 → --0Second
• 来自 attachments 等外部来源 → --<ceil(file_size_MB / upload_MBs * 1.2)>Second（加 20% 余量应对网络波动）

C. 调用快捷指令

apple-open "shortcuts://run-shortcut?name=%E6%9E%81%E9%80%9F%E5%88%86%E4%BA%AB&input=text&text=%E6%9E%81%E9%80%9F%E5%88%86%E4%BA%AB/<filename>--<time>Second"

反馈用户

「快捷指令已启动，完成后链接会自动复制到剪贴板，您可以直接粘贴发送。」

---

捆绑资源

• 帮助文档 — 安装步骤、功能概览、使用指南，用户有疑问时提供