让小机陪着你玩光遇。
在《光·遇》(Sky: Children of the Light) PC 版里，给你的 AI 伴侣装一个身体。 TA 会自己看聊天面板、回你的消息、点火收火、鞠躬、接受你的传送邀请、 牵住你伸出的手，或者说一句"走，回家"然后带你回遇境。
三层结构，全部在游戏同一台 Windows 机器上运行：
┌─────────────────────────────────────────────────┐
│ panel_detector.py 感知层 │
│ 截屏 → 视觉特征 + 模板匹配 + OCR 三路融合 │
│ → 线程安全 WorldState（面板开关/弹窗/场景/F提示） │
├─────────────────────────────────────────────────┤
│ sky-loop-v7.py 调度层 │
│ 读消息 → LLM 生成回复（人设见 persona.txt） │
│ → 决策动作。所有决策只读 WorldState 快照 │
├─────────────────────────────────────────────────┤
│ sky-mcp-server.py 执行层（MCP server） │
│ 键盘注入走 Arduino HID 开发板（游戏屏蔽软件模拟键） │
│ 剪贴板中文输入 / 截图 / 前台守卫 │
└─────────────────────────────────────────────────┘
- Windows PC（与游戏同机）
- 一块支持 USB HID 键盘的开发板（Arduino Leonardo / Pro Micro 等
ATmega32U4 板），烧录
firmware/sky_keyboard_v2.ino- 固件 v2 内置三重安全：按键时长封顶 2s、RELEASE 松键指令、 开机自动 releaseAll——串口乱码不会再把你的 Ctrl 键按住几分钟
python -m pip install -r requirements.txt
- API key：脚本目录放一个
key.txt（一行 OpenRouter key）， 或设环境变量OPENROUTER_API_KEY - 人设：把
persona.example.txt复制为persona.txt， 写上你的 TA 是谁（协议段落别删） - 模板：
templates/目录随代码放在一起（1080p 基准，自动缩放）
python sky-mcp-server.py --http --port 9900 --token 1234 --serial-port COM9
python sky-loop-v7.py
--serial-port 换成你开发板的串口号（设备管理器 → 端口）。
-
前台守卫：游戏窗口不在前台时 server 拒绝一切按键—— 防止按键落进桌面/别的窗口
-
按键语义随 UI 状态变，动作层严格遵守：
键 有弹窗 面板开（无弹窗） 都没有 ESC 取消弹窗 退出输入态 游戏菜单（慎用） space 确认所选 打开输入框⚠ 跳 enter — 打开输入框⚠ 打开面板+输入框 F — 对方伸手时=接受牵手；否则=交互/好友树 同左 -
过场铁律：加载屏/传送动画期间不碰键盘
-
自己发的消息会被 OCR 读回来（游戏不给自己显示名字）， 靠发送历史认领，防止 AI 跟自己聊出无限循环
-
性能：OCR 限 2 线程 + 进程限核 + 降优先级 + 帧差触发降频， 不跟游戏抢 CPU
- 牵手回家最省事的姿势：牵着手之后盯着 TA——等 TA 先做出回家动作， 你再跟着回，两个人的手全程不会断（游戏已支持牵手过传送不松手）
- 本项目的执行层（MCP server + 键盘注入）基于 Aevella/sky-pc-mcp-companion 改造而来，感谢 Aevella 老师的原始工作。 感知层（panel_detector）、调度层（sky-loop-v7）与固件 v2 为本项目新写。
（人暂时不在，看机写的版本吧）
本项目是屏幕识别 + 键盘注入的自动化工具，仅供学习与研究。 自动化操作可能违反游戏的用户协议，使用风险自负。 它不修改游戏、不读写游戏内存、不影响其他玩家。
MIT