/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
1. 项目缘起：当iPhone遇上Linux，一个“穷”极思变的方案
作为一个常年混迹在Linux桌面环境下的开发者，我对Mac Mini的优雅和生态整合能力一直心向往之。那种iPhone与Mac之间丝滑的接力、随航、AirDrop，是每个多设备用户梦寐以求的体验。然而，看着Mac Mini的价格标签，再看看手边那台性能过剩但“孤岛”般的Linux主机和口袋里时刻在线的iPhone，一个想法冒了出来：为什么一定要花钱买硬件？软件和协议的本质是相通的，我能不能在Linux上，用代码“复刻”出类似的核心体验？
这就是「OpenClaw直连苹果」项目的起点。它不是一个商业产品，而是我个人为了解决“买不起Mac Mini”这个现实问题，而编写的一系列“Skills”（技能）。本质上，它是一个运行在Linux上的服务端程序，通过逆向工程和模拟苹果的私有协议（如AirPlay、Continuity等），让iPhone能够将Linux电脑识别为一个“类Mac”设备，从而实现文件无线传输、消息通知同步、甚至是将iPhone作为电脑的扩展屏幕等高级功能。最近网络上关于 openclaw llamap svr operator(): got exception 的错误讨论很热，恰恰说明了有很多朋友在尝试类似的事情，但被复杂的协议和配置拦住了。我的目标就是把这些踩坑的经验固化下来，做成一套开箱即用、可高度定制的Skills集合。
这套Skills适合谁？首先是像我一样的Linux桌面用户，尤其是开发者和极客，渴望打破苹果生态壁垒。其次是那些拥有iPhone和Windows/Linux双机，苦于跨平台文件传输和协同效率低下的用户。它不需要你购买任何新硬件，只需要一台能运行Linux的电脑（甚至是一台树莓派）和一点动手配置的耐心。接下来，我会详细拆解整个项目的设计思路、核心实现、以及我趟过的所有坑，希望能给你提供一个切实可行的“平替”方案。
2. 核心设计：逆向、模拟与模块化Skills架构
整个项目的核心思路可以概括为“协议逆向、服务模拟、技能插件化”。苹果设备间的协同功能，底层依赖于一个名为“Bonjour”（mDNS）的服务发现协议和一系列基于HTTP/HTTPS或私有端口的二进制协议。我的工作就是让Linux主机在局域网内“伪装”成一台苹果设备。
2.1 协议层逆向与选择
完全逆向苹果的所有协议是不现实且法律风险极高的。因此，我的策略是站在巨人的肩膀上，利用开源社区已有的成果。经过调研，我锁定了几个关键的开源项目作为基础：
- AirPlay 2 音频/视频接收 ：使用 shairport-sync 。这是一个非常成熟的高保真AirPlay音频接收器，可以完美地将Linux电脑变成一个AirPlay音箱。对于视频，我采用了 uxplay ，它支持AirPlay 2镜像，可以将iPhone屏幕投射到Linux桌面。
- AirDrop 文件传输 ：这是难点。苹果的AirDrop使用了一种基于TLS和Bonjour的加密P2P传输协议。我找到了 OpenDrop 这个项目，它是一个Python实现的AirDrop逆向工程库。但它更偏向于研究，直接使用体验不佳。我的工作是对其进行封装和增强，使其成为一个稳定的后台服务。
- Continuity 相机与通用剪贴板 ：这部分协议更为封闭。对于“连续互通相机”（用iPhone给电脑拍照），我通过模拟一个虚拟的USB视频类（UVC）设备，并编写一个守护进程监听iPhone通过Bonjour发出的配对请求来实现。通用剪贴板则通过一个在本地网络同步剪贴板内容的小型服务来模拟。
注意 ：模拟这些协议可能处于法律灰色地带，且极度依赖苹果未公开的细节。任何iOS系统更新都可能导致模拟失效。因此，这个项目的核心价值在于学习和探索，而非追求商业级的稳定性。
2.2 Skills的模块化架构设计
为了避免将所有功能糅杂在一个巨型单体应用中，我采用了微服务化的“Skills”架构。每个Skill都是一个独立的守护进程（Daemon），负责一项特定功能。它们通过一个中央的“Skill Manager”进行生命周期管理、状态汇报和统一配置。
+——————-+ +—————————+
| iPhone (Client) |<—>| Linux Host (Server) |
+——————-+ +—————————+
| |
| (Bonjour/mDNS Discovery) |
| |
+————————->[Skill Manager]
|
+————————+————————+
| | | | |
[AirPlay] [AirDrop] [Continuity] [Clipboard] [Notification]
Skill Skill Camera Skill Sync Skill Proxy Skill
这样设计的好处显而易见：
