SHORTCUTS_GUIDE.md

# 🍎 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) 的入站连接，或者暂时关闭防火墙测试。