Manus v2.0调用本地Swift开发iOS小组件实战指南
想在Mac上通过Manus v2.0直接调用本地Swift代码生成iOS小组件？关键在于遵循标准Xcode Widget Extension结构，通过CLI绑定路径或手动配置.config.json，明确指定extensionTarget和swiftSourceDir，开启实时监听后注入逻辑、签名打包，最后部署到模拟器或真机进行验证。
说白了，就是绕过云端编译限制，直接在本地Xcode工程中完成全流程：编写Swift代码、签名生成IPA、再到模拟器上跑一轮测试。
搭建可调试的Swift小组件工程
打开Xcode，新建Project，选择“App”模板，务必勾选“Widgets Extension”。完成后Xcode会自动在主App Target下添加同名Widget Extension Target。
这一步Widget Extension模板不能跳过。Manus v2.0只认标准Xcode Widget Extension结构，如果手动新建Bundle或修改Info.plist，它不会触发正确的构建上下文。
另外，将Widget Extension的Deployment Target设为与目标设备一致（例如iOS 17.4），否则Manus注入时架构不匹配会直接报错。
让Manus v2.0识别并接管本地Swift源码
方法一：通过Manus CLI绑定路径
终端cd到项目根目录，执行manus init，按提示输入Widget Extension的Target名称（例如MyAppWidget）。Manus自动生成.manus/config.json，并将extensionPath字段指向Sources/MyAppWidget目录。
方法二：手动配置config.json
手动创建也行：在项目根目录建.manus文件夹，新建config.json，写入类似{ "extensionTarget": "MyAppWidget", "swiftSourceDir": "./MyApp/MyAppWidget" }。注意路径必须为相对路径，以./开头，绝对路径Manus不认。
方法三：启用实时源码监听模式
更便捷的方式是打开实时监听：Manus UI右上角点⚙️，开启“Watch Swift Sources”。之后只要修改WidgetProvider.swift里的@main struct或TimelineProvider实现，保存后约3秒，Manus自动触发增量编译，无需手动点Run。
注入Manus逻辑并生成可安装Widget Bundle
第一步：打开WidgetExtension目录下的WidgetProvider.swift，找到getTimeline()方法。
第二步：把光标放在return Timeline(entries: entries, policy: .atEnd)这行上面。
第三步：在Manus UI左侧找到“Swift Snippet”，将“Fetch Local JSON Data”拖拽到代码区，它会自动插入let data = try? Data(contentsOf: URL(fileURLWithPath: "/tmp/widget_input.json"))这类代码。
第四步：点击Manus界面顶部的“Build & Export IPA”按钮，等待进度条完成，生成的IPA默认存放在./manus_build/MyAppWidget.ipa。
注意：这个IPA带开发签名，必须用Apple Developer账号登录Xcode Preferences → Accounts才能完成签名。否则真机安装时会出现“无法验证开发者”。
在iOS模拟器或真机部署验证
双击生成的MyAppWidget.ipa，它会自动唤起Xcode Devices and Simulators窗口。把IPA拖到已启动的iOS模拟器列表里，等待安装完成。
真机部署：用USB连接Mac，Xcode菜单栏选Window → Devices and Simulators，选中你的设备，点+号添加IPA。安装完成后进入iPhone设置，主屏幕页面，长按空白处，点左上角+号，搜索你的小组件名称并添加。
首次加载可能卡在“Loading…”状态。此时回到Mac，打开/tmp/widget_input.json，检查JSON格式是否合法，至少包含一个有效entry对象。否则Timeline无数据，UI会冻结。