Repository navigation
Releases
Lumen v0.3.2
Lumen 0.3.2
图文介绍见官网:https://lumen.vanjay.cn/#new
启动调试
- 兼容 Electron / Chromium 内核的 App(Google Chrome、balenaEtcher、Mac App Store 上的网易云音乐等):采集端只在主进程启动,带沙盒继承的辅助程序随主程序一起重签,副本使用独立的用户数据目录(
~/Library/Caches/lumen/resigned-data/),不与原 App 争用单实例锁,也不读写原 App 的登录状态 - iPad 版 Mac App(如酷狗音乐)、包内带非 Mach-O 文件的 Qt App(如 DB Browser for SQLite)可以重签启动
- 被 Gatekeeper 拦下的 App(带下载隔离标记且未公证)改为启动去掉隔离标记的重签副本,原 App 不改动
- 新增“隐藏注入库”(默认开启):启动时枚举已加载库、发现外来库就退出的 App 看不到注入库;命令行
--show-injection关闭。只能挡住按镜像名 / 数量枚举的检测,请仅用于你有权调试的 App - 模拟器标签分组列出用户 App 与系统 App(设置、Safari 等),系统 App 同样可以注入调试;
lumen simulators <UDID> --system - “Mac 应用”“模拟器”标签支持列表 / 图标两种显示,显示 App 的真实图标;模拟器标签加入搜索;列表与说明区之间的分隔条可拖动
- “最近启动”右键菜单列出原始文件与安装位置,可在访达中显示或复制路径
- 模拟器设备菜单用绿点标出已启动的设备,启动结束和回到窗口时自动刷新
画布与纹理
- SwiftUI 逻辑节点渐进加载:首次读取慢的宿主先显示平台层级,空闲时在后台逐个补读并推送,iOS“设置”首屏从 25.7 秒降到 0.4 秒
- Electron / Chromium 的网页内容在分层视图中完整显示
- OpenGL 绘制的窗口(Qt 5 App)不再空白
- SwiftUI 列表图标、
foregroundStyle等乘色滤镜着色正确显示;液态玻璃按真实模糊半径还原;不对齐位置的传送门内容不再丢失
修复
- App 自身集成了 LumenServer 又被注入时,切换列表里出现两份
- 自动刷新关闭时,窗口晚于采集端创建的 App 连接后层级为空
- Electron App 注入后启动不稳定(辅助进程也起采集端、早期监听与分配器钩子冲突)
- 使用向导“接入 App”页底部内容被裁掉;“真机”标签状态说明显示不全
安全
- 局域网中的设备伪造本机 App 的进程信息时,不能再顶替本机的真实连接,也不能隐藏本机的版本不兼容提示
性能
-
Metal、视频、网页等需要整窗截图补画的内容,同一轮纹理请求只截一次窗口
-
启动面板对同一台模拟器的 App 列表读取去重,打开面板不再重复运行
simctl listapps
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.3.2_arm64.dmg | 15M | fdbc6c55d5c8d30ec1a09c66f983243934516ee85f6ee9b2bd0687ac46279963 |
| Intel | Lumen_v0.3.2_x86_64.dmg | 16M | dc5943034d5d4a02bbcf0c980d0d241884b70d687430d3c946cb2e03dc024761 |
采集端 SDK(LumenServer_v0.3.2.xcframework.zip)通过 Swift Package Manager / CocoaPods 自动下载,无需手动获取。\n
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。
Lumen v0.3.0
Lumen 0.3.0
演示视频与图文介绍见官网:https://lumen.vanjay.cn/#new
启动调试
- 新增“启动调试”窗口(⌘N):不改工程,注入采集端并启动 Mac 应用(含 Mac Catalyst)、模拟器中的 App、iOS 安装包与 USB 真机上的 App,成功后自动连接;最近启动可一键重启,“重新启动当前 App”(⌥⌘R)恢复选中的节点
- iOS 安装包可在 Apple 芯片的 Mac 上直接运行,可按 iPhone 机型或自定义尺寸运行,默认隐藏窗口标题栏、禁用最大化;拖入
.ipa时询问在本机还是真机运行 - 真机借 Xcode 中登录的 Apple ID(免费账号即可)自动重签安装,到期前一天提醒续签;瘦身包可装到任意机型,缺失权限的重签不再闪退
- Hardened Runtime 的 Mac 应用自动重签副本,原 App 不改动;无法启动时说明原因并给出可一键执行的处理
- 命令行
lumen launch支持--mac、--simulator、--ios、--device、--resign、--iphone-model、--device-size等
应用日志
- 底部“应用日志”面板显示 stdout / stderr 与 os_log;集成了 LumenServer 的 App 经 Lumen 连接推送日志,不经启动调试也能看,断线重连只补发错过的部分
- 虚拟化列表应对大量日志;文本筛选、来源与级别过滤、白名单与黑名单规则(支持正则),右键把选中文本或子系统加入规则
检查器
- 几何读数卡:父视图与所选节点的尺寸、四边边距、原点与窗口坐标,右键拷贝
- App 自定义属性:实现
@objc lumen_debugInfo()把业务状态显示在检查器最前面,带 setter 的项可直接修改;+lumen_colorAliases为颜色显示设计色别名 contentMode、textAlignment等枚举显示名称并可下拉修改;控件新增“事件处理”栏;实例变量显示持有者,继承链显示所在镜像- 值为 nil 的颜色与文本可以直接编辑
画布与大纲
- 画布工具条贴在上缘,底部新增路径栏(从根到所选节点逐段可点),缩放百分比;加载进度、阶段与耗时显示在状态栏
- 按
layer.mask裁剪,网页、Metal、视频、Lottie 图层内容完整显示;无内容图层可选透明、只描边框或淡色底板 - 3D 改为透视投影,分层跟随大纲的展开与折叠;层间距快捷键 ⌘[ / ⌘];测量分关闭、父视图边距、锁定两节点三档
- 层级深度预设(⌥⌘1…⌥⌘5)、聚焦模式(只看某个节点的子树)、按 App 记住展开状态、键入类名前缀定位;顶层列出
UIWindowScene与 Layout Guide;层级很深时缩进自动收窄 - 搜索结果在画布上着色并可下钻;悬停大纲行时画布同步高亮
诊断与连接
- 审计新增遮罩诊断:找出被 mask 整个挡住或只露出一小部分的视图,给出原因与修复建议
- 目标退出、崩溃或断网时保留现场:最后的层级、详情与纹理只读显示,可另存为
.lumen快照,App 重新出现后自动切回实时 - 控制台方法名预测与 Tab 补全,参数按签名逐个填写,返回的对象可以继续调用
- 协议版本不兼容的 App 也出现在列表中,并说明该升级哪一方
界面
- 界面语言(简体中文、English、繁體中文)、外观(跟随系统、浅色、深色)与更新设置
- 设置中的“签名与调试”拆为“签名”与“真机调试”两页
修复
- 检查器单元格复用后 frame / bounds 等两行属性的第二行被裁掉;可编辑输入框单击即可进入编辑
- 窗口 hook 库让被调试的 iOS 包启动即崩溃
- 启动调试窗口拖放 ipa 时的约束冲突;脚本在 C locale 下报 unbound variable
安全
- 恶意
.ipa借路径穿越或符号链接改写包外文件;bundle ID 与图标名做合法性校验 - 遮罩 alpha 位图的解压炸弹;日志推送的畸形位置让客户端崩溃
- 经对象句柄调用安全输入框相关对象时,返回的字符串仍以掩码返回
- 经“启动调试”安装到真机的副本会开启局域网连接以便 Wi-Fi 发现,请在可信网络中调试
性能
-
采集端日志历史裁剪、遮罩 alpha 位图生成、描边形状层溢出判断大幅提速
-
大纲展开记忆与结构路径查询在大层级下不再卡顿
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.3.0_arm64.dmg | 15M | 44cb4f9dabfa33f6e4228a0f19f467256146307bc3b8ef259dad7be95195a357 |
| Intel | Lumen_v0.3.0_x86_64.dmg | 16M | af1b65b52e72197e5bdf8465ae75a73d38842bb2fc289006aab0ecb3e52a50d1 |
采集端 SDK(LumenServer_v0.3.0.xcframework.zip)通过 Swift Package Manager / CocoaPods 自动下载,无需手动获取。\n
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。
Lumen v0.2.2
Lumen 0.2.2
新功能
- 目标选择改为卡片网格:按平台分组、按设备归类,标明 USB / Wi-Fi / 局域网 / 模拟器 / 本机,卡片显示主窗口预览;工具栏选择器弹出同样的切换面板,当前目标带选中态
- 手势:大纲行首的竖条标出挂有手势识别器的视图,点按弹出手势面板,列出类名、父类、持有它的实例变量、状态、代理、目标与操作,可直接开关手势;属性面板的手势改为卡片,文字可拖选复制
- 屏蔽的类:在设置中维护要屏蔽的类,画布不渲染命中节点及其子树,大纲灰显标识,可临时显示、重新屏蔽或一键屏蔽此类
- 加载与刷新时显示进度浮层:层级与纹理进度、实时耗时与图层数
- 目标 App 进入后台或被挂起时给出提示与重试,恢复后自动重新拉取详情、层级与纹理
- 画布“定位”后目标图层闪烁高亮
界面
- 设置窗口改为工具栏标签页(通用、源码定位、屏蔽的类、层级树),新增层级树字号、行高与层级引导竖线设置
- 层级树完整显示每行信息,宽度不够时横向滚动
- 主界面加毛玻璃底,画布背景半透明(开启“降低透明度”时保持不透明)
- 外观覆盖菜单标明各平台支持项与不支持原因,提供全部恢复
修复
- 还原 iOS 26 / 27 标签栏的液态玻璃底板与选中镜片,修复分层视图中黑色胶囊与白色模板字
- 系统配置了 SOCKS / HTTP 代理时,连接始终直连目标,不可达的目标不再被误判为已连接
- App 重启后手动刷新只更新部分图层
- 切换目标面板中第一张卡片显示焦点环
安全与性能
- 对端发来的预览图与纹理只解码 PNG,并限制大小
- 大纲列宽只重新测量内容变化的行,上万节点时展开、过滤、屏蔽与缩放窗口不再卡顿;纹理加载进度统计改为增量计数
命令行与 AI 助手
-
层级与节点输出带
gestures=字段(JSON 中为gestures数组),帮助与 MCP 工具说明同步更新
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.2.2_arm64.dmg | 10M | c693791a4bfaa15cdc73188dea051c219af67503cea17c3f0168512ec003be93 |
| Intel | Lumen_v0.2.2_x86_64.dmg | 10M | 74734c957c807bf30429e78b079701342d84c8f22799c8c50de25ce598eaa89e |
采集端 SDK(LumenServer_v0.2.2.xcframework.zip)通过 Swift Package Manager / CocoaPods 自动下载,无需手动获取。\n
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。
Lumen v0.2.0
Lumen 0.2.0
界面重新设计
- 侧栏大纲:节点类别图标、层级引导线与自适应缩进,列表单元格显示 section / row,位置徽标改为紧凑的“0 · 2”;修复悬停底色残留与类名横向截断
- 属性检查器、工具栏目标选择器与设置窗口重新设计
- 画布:胶囊浮动工具条、缩放控件、点阵背景,3D 模式自动适配;底部面板重新设计,工具栏新增“面板”按钮,一键显示或隐藏控制台、时间轴、点击诊断与修改记录
- 状态栏、窗口过渡与提示横幅重新设计;未连接状态页改为雷达扫描动画与接入方式卡片
- 新增使用向导:分步介绍接入、连接、画布操作、检查与修改,首次启动自动弹出,可在帮助菜单重新打开
操作
- 3D 视图中触控板双指滑动改为平移画布,旋转用拖动(⌥ 双指滑动仍可旋转)
接入
- 新增一键接入脚本
lumen_setup.py:在工程目录运行即可让 App 在 Debug 下集成采集端,不改 Podfile、Package 或代码,支持--remove原样撤销与 CocoaPods 钩子 - 采集端新增 Objective-C 入口类
LumenServer(start/startAllowingNetworkConnections:/stop),ObjC 工程无需 Swift 桥接文件 - 新增 ObjC、Swift、SwiftUI 与混编四个 iOS 示例工程
AI 助手
- 官网与 README 补充 Codex、ChatGPT 桌面 App 的 MCP 接入方式,新增“用 AI 排查、写页面、改 bug”使用示例
- 官网:https://lumen.vanjay.cn
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.2.0_arm64.dmg | 11M | 95f1cd10fdb6b83997d4533c7163cb2ac29cc46866aef48a1ae416a4352b062b |
| Intel | Lumen_v0.2.0_x86_64.dmg | 9.9M | d4bf1d998205c4bf417adbb81b679a1246c5f005c30d396ededaae3545ced458 |
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。
Lumen v0.1.1
Lumen 0.1.1
新增与改进
- 真机显示真实设备名与机型(如“VanJay's iPhone 16 Pro”),
--device可按设备名匹配 - SwiftUI:
Label做标题的 Button,以及 Toggle、Picker、Link、NavigationLink、Menu 的标题都能采集到 - Liquid Glass、背景模糊等效果在截图中正确显示(整窗截图使用系统快照,单节点截图使用近似材质),不再出现白块或缺失
- MCP 增加 resources / prompts(含“UI 调试工作流”提示词)
lumen --version显示构建类型与架构
修复
- 真机上 SwiftUI 深层视图因主线程栈较小被截断的问题
- 画布半透明节点的颜色偏浓;子视图文字变化后画布未刷新
- 检查器拖动微调不起作用;修改记录、AI 提示与审计报告中的文案瑕疵
- 设计稿对比默认对齐到错误的窗口
- 退出点击诊断后着色残留;审计规则开关后报告未更新
- 启动即打开快照时画布未适配窗口;工具栏外观菜单标题被隐藏
- “帮助 › 集成指引”内容不完整;多 App 选择页端口被截断
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.1.1_arm64.dmg | 8.3M | c7b4c201735b185f8cc728adfb5ea62d8aeae5a52ffb71d7bc18eae6895c4771 |
| Intel | Lumen_v0.1.1_x86_64.dmg | 8.7M | b78b6177fad1aa88bfd63a9b54bff5c108c647c9dc9cff10068807e7ea5d7249 |
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。
Lumen v0.1.0
Lumen 0.1.0
Lumen 的第一个公开版本:一套面向 iOS / macOS 的 UI 调试工具,包含 macOS 图形客户端、lumen 命令行与 MCP 服务,以及嵌入被调试 App 的采集端 LumenServer。
查看与调试
- 2D / 3D 层级画布(Metal 渲染),间距测量、隐藏节点、边框线、3D 层次感
- 层级大纲与属性检查器,选择器查询(类名、
#identifier、[text*="登录"]、:visible、组合) - SwiftUI 逻辑视图树:
Text文字、控件、修饰符链与参数、@State等调试数据 - 运行时改属性、调用方法、开关手势,修改记录可撤销、可复制为 AI 提示
- Auto Layout 约束与歧义诊断、点击诊断(hit-test 与响应链)、无障碍元素、外观覆盖(深色、字号、RTL)
- 审计:触控区域、文字截断、对比度、遮挡、布局歧义、无障碍缺失等,可用于 CI
- 时间轴回看与差异对比、设计稿叠加与差异对比、
.lumen完整归档离线打开
连接
- 本机(macOS App、iOS 模拟器)、USB 真机、可选的局域网 Bonjour
- 零改动注入:
lumen launch --mac/--simulator
AI 助手
lumen mcp:层级、查询、截图、快照对比、审计、hit-test、约束、无障碍、改属性、调用方法、源码定位等工具
接入
- Swift Package Manager:
https://github.com/wangwanjie/Lumen,产品LumenServer - CocoaPods:
pod 'LumenServer', :configurations => ['Debug'] - 只应在 Debug 构建中集成;默认只接受本机与 USB 连接
下载
| 芯片 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| Apple 芯片(M 系列) | Lumen_v0.1.0_arm64.dmg | 7.2M | 88091820006df1a9e082510cf7d31af04b839a5a8663582da28f9e310c36d7b9 |
| Intel | Lumen_v0.1.0_x86_64.dmg | 8.5M | a0f4f2a5fe843724f31c0f4d3dac7caccb851299b5d1734a158b4da0cf5f493b |
不确定芯片类型:点击屏幕左上角的苹果菜单 → 关于本机,「芯片」一栏显示 Apple M 系列即选 arm64,显示 Intel 即选 x86_64。