Spaces:
Running
Running
| # 🍎 iOS 快捷指令配置指南 (悬浮球版) | |
| **告别网页版！** | |
| 你可以通过配置 iOS 的 **快捷指令 (Shortcuts)** 和 **辅助触控 (AssistiveTouch)**，实现你想要的 **“点击悬浮球 -> 自动截图 -> 自动上传 -> 弹出回复建议”** 的原生体验。 | |
| 这是一个非常“极客”且高效的低嵌入式方案，**完全不需要在手机上打开浏览器或网页**。 | |
| ## 🛠️ 准备工作 | |
| 1. 确保电脑上的服务已经启动 (`python main.py`)。 | |
| 2. 确保手机和电脑在同一 WiFi 下。 | |
| 3. 获取你电脑的局域网 IP (例如 `192.168.1.5`)。 | |
| 4. 准备好你的 **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) | |
| 1. 打开 iPhone **设置** -> **辅助功能** -> **触控** -> **辅助触控**。 | |
| 2. 开启 **辅助触控** (屏幕上会出现小白点)。 | |
| 3. 点击 **“自定义顶层菜单”**。 | |
| * 点击任意一个图标（或者点 + 号新增）。 | |
| * 下滑到底部，找到 **“快捷指令”** 分类。 | |
| * 选择刚才创建的 **“AI 帮我回”**。 | |
| 4. 或者设置 **“轻点两下”** / **“长按”** 触发该快捷指令，操作更顺滑。 | |
| --- | |
| ## 📱 使用场景演示 | |
| 1. 正在微信和女神聊天，不知道回什么。 | |
| 2. 点击屏幕上的 **小白点** -> 点击 **“AI 帮我回”**。 | |
| 3. (屏幕闪烁一下，表示已截图)。 | |
| 4. 顶部弹窗询问：`对方是谁？` -> 选择 `普通朋友`。 | |
| 5. 稍等 2-3 秒 (取决于网速和 AI 思考时间)。 | |
| 6. 顶部弹窗列出 3 条高情商回复。 | |
| 7. 点击最满意的一条。 | |
| 8. 提示“已复制”。 | |
| 9. 点击微信输入框 -> 粘贴 -> 发送！😎 | |
| ## ⚠️ 注意事项 | |
| * **IP 地址变动**: 如果电脑重启或重连 WiFi，IP 可能会变。建议在路由器里给电脑设置静态 IP，或者每次使用前检查一下。 | |
| * **隐私权限**: 第一次运行时，快捷指令会询问“是否允许访问 api.siliconflow.cn”以及“是否允许发送截图”，请选择“始终允许”。 | |
| * **局域网防火墙**: 如果手机连不上电脑，请检查电脑防火墙是否允许了 Python (uvicorn) 的入站连接，或者暂时关闭防火墙测试。 | |