chat-helper / SHORTCUTS_GUIDE.md
ruoxi01's picture
Upload 11 files
41ea7df verified

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