Spaces:
Running
Running
🍎 iOS 快捷指令配置指南 (悬浮球版)
告别网页版! 你可以通过配置 iOS 的 快捷指令 (Shortcuts) 和 **辅助触控 (AssistiveTouch)**,实现你想要的 “点击悬浮球 -> 自动截图 -> 自动上传 -> 弹出回复建议” 的原生体验。
这是一个非常“极客”且高效的低嵌入式方案,完全不需要在手机上打开浏览器或网页。
🛠️ 准备工作
- 确保电脑上的服务已经启动 (
python main.py)。 - 确保手机和电脑在同一 WiFi 下。
- 获取你电脑的局域网 IP (例如
192.168.1.5)。 - 准备好你的 SiliconFlow API Key (以
sk-开头)。
🚀 第一步:创建快捷指令
打开 iPhone 上的 “快捷指令” (Shortcuts) App,点击右上角 + 号新建一个快捷指令,重命名为 “AI 帮我回”。
依次添加以下动作(可以直接搜索动作名称):
1. 截取屏幕
- 搜索 “截取屏幕”。
- (这一步不需要参数,默认截取全屏)。
2. 从列表中选择 (选择对象)
- 搜索 “从列表中选择”。
- 修改提示语为:
对方是谁?。 - 添加 5 个选项:
boss(或者写“领导”,但传递给后面变量时需要转换,建议直接用英文 key 或者加一步字典匹配,为了简单,我们这里先用中文显示,后面手动赋值)- 更简单的做法:直接写中文
领导、客户、同事、闺蜜、Crush。
3. 匹配角色代码 (词典)
- 搜索 “词典” (iOS 中叫“词典”,图标像一本打开的书)。
- 添加键值对:
- 键
领导-> 文本boss - 键
客户-> 文本client - 键
同事-> 文本colleague - 键
好朋友-> 文本good_friend - 键
普通朋友-> 文本normal_friend
- 键
- 搜索 “获取词典的值” (或者搜索“获取值”)。
- 配置动作:
- 显示为:
在 [词典] 中获取 [所选项目] 的 值。 - 关键点: 点击“键”的位置,插入第2步的
选中的项目。 - 确保“词典”参数连接到了上一步定义的词典。
- 显示为:
4. 获取 URL 内容 (发送请求)
这是最关键的一步。
- 搜索 “获取 URL 内容”。
- URL:
https://ruoxi01-chat-helper.hf.space/api/chat(🚨 必须使用 Direct URL,而不是 dashboard 网址)- ❌ 错误:
https://huggingface.co/spaces/ruoxi01/chat-helper/api/chat - ✅ 正确:
https://ruoxi01-chat-helper.hf.space/api/chat - 获取方法: 在 Hugging Face Space 页面,点击右上角菜单 -> "Embed this space" -> 复制 "Direct URL"。
- ❌ 错误:
- 方法: 选择
POST。 - 请求体: ⚠️ **必须选择
表单(Form)**,千万不要选JSON。 - 添加新字段 (点击加号):
- 字段名:
role- 点击右侧的输入框。
- 点击键盘上方的 “选择变量” (魔法变量)。
- 屏幕变暗后,向上滑动,找到第 3 步(获取词典的值)下方的 “值” 或 “词典的值” 小蓝标,点击它。
- 错误检查:如果这里显示为一个网址图标,说明你选错了,请删除重选。
- 字段名:
image- 点击右侧输入框,选择 “选择变量”。
- 向上滑动,找到第 1 步的 “屏幕快照”,点击它。
- ⚠️ 重要: 点击刚才选中的“屏幕快照”变量,在弹出的菜单中,将“类型”改为 “文件” 或 “图像”。
- (可选) 字段名:
api_key-> 你的 Key (如果后端已经内置了 Key,这里可以不填)。
- 字段名:
5. 获取词典值 (解析回复)
- 搜索 “获取词典的值”。
- 获取:
值,对于键:replies(注意是复数)。 - 输入:
URL 的内容(上一步的请求结果)。
6. 从列表中选择 (展示结果)
- 搜索 “从列表中选择”。
- 提示:
建议回复:。 - 输入:
词典的值(上一步解析出的 replies 列表)。 - (可选) 处理长文本: iOS 的列表弹窗可能会截断长文字。如果你发现看不全,可以把这一步改成 “显示结果” 或 “快速查看”,但这会失去直接点击复制的功能。
- 推荐做法: 保持“从列表中选择”,即使看不全,点击复制后粘贴出来就是完整的。
7. 拷贝至剪贴板
- 搜索 “拷贝至剪贴板”。
- 内容:
选中的项目(用户点击的那条回复)。
8. 自动跳回微信 (可选)
为了更顺滑的体验,你可以让快捷指令执行完后自动切回微信。
- 搜索 “打开 App”。
- 选择 “微信” (或者你常用的钉钉/小红书)。
- 这样你选完回复后,手机会自动跳回聊天界面,你只需要长按输入框 -> 粘贴即可。
9. 显示通知 (可选)
- 搜索 “显示通知”。
- 内容:
已复制:[选中的项目]。
🔘 第二步:绑定悬浮球 (AssistiveTouch)
- 打开 iPhone 设置 -> 辅助功能 -> 触控 -> 辅助触控。
- 开启 辅助触控 (屏幕上会出现小白点)。
- 点击 “自定义顶层菜单”。
- 点击任意一个图标(或者点 + 号新增)。
- 下滑到底部,找到 “快捷指令” 分类。
- 选择刚才创建的 “AI 帮我回”。
- 或者设置 “轻点两下” / “长按” 触发该快捷指令,操作更顺滑。
📱 使用场景演示
- 正在微信和女神聊天,不知道回什么。
- 点击屏幕上的 小白点 -> 点击 “AI 帮我回”。
- (屏幕闪烁一下,表示已截图)。
- 顶部弹窗询问:
对方是谁?-> 选择普通朋友。 - 稍等 2-3 秒 (取决于网速和 AI 思考时间)。
- 顶部弹窗列出 3 条高情商回复。
- 点击最满意的一条。
- 提示“已复制”。
- 点击微信输入框 -> 粘贴 -> 发送!😎
⚠️ 注意事项
- IP 地址变动: 如果电脑重启或重连 WiFi,IP 可能会变。建议在路由器里给电脑设置静态 IP,或者每次使用前检查一下。
- 隐私权限: 第一次运行时,快捷指令会询问“是否允许访问 api.siliconflow.cn”以及“是否允许发送截图”,请选择“始终允许”。
- 局域网防火墙: 如果手机连不上电脑,请检查电脑防火墙是否允许了 Python (uvicorn) 的入站连接,或者暂时关闭防火墙测试。