Skip to content

Releases

Lumen v0.3.2

Choose a tag to compare

@wangwanjie wangwanjie released this 22 Nov 09:17

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

  • 官网:https://lumen.vanjay.cn

下载

芯片 文件 大小 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

Choose a tag to compare

@wangwanjie wangwanjie released this 21 Nov 19:27

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 位图生成、描边形状层溢出判断大幅提速

  • 大纲展开记忆与结构路径查询在大层级下不再卡顿

  • 官网:https://lumen.vanjay.cn

下载

芯片 文件 大小 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

Choose a tag to compare

@wangwanjie wangwanjie released this 20 Nov 11:49

Lumen 0.2.2

新功能

  • 目标选择改为卡片网格:按平台分组、按设备归类,标明 USB / Wi-Fi / 局域网 / 模拟器 / 本机,卡片显示主窗口预览;工具栏选择器弹出同样的切换面板,当前目标带选中态
  • 手势:大纲行首的竖条标出挂有手势识别器的视图,点按弹出手势面板,列出类名、父类、持有它的实例变量、状态、代理、目标与操作,可直接开关手势;属性面板的手势改为卡片,文字可拖选复制
  • 屏蔽的类:在设置中维护要屏蔽的类,画布不渲染命中节点及其子树,大纲灰显标识,可临时显示、重新屏蔽或一键屏蔽此类
  • 加载与刷新时显示进度浮层:层级与纹理进度、实时耗时与图层数
  • 目标 App 进入后台或被挂起时给出提示与重试,恢复后自动重新拉取详情、层级与纹理
  • 画布“定位”后目标图层闪烁高亮

界面

  • 设置窗口改为工具栏标签页(通用、源码定位、屏蔽的类、层级树),新增层级树字号、行高与层级引导竖线设置
  • 层级树完整显示每行信息,宽度不够时横向滚动
  • 主界面加毛玻璃底,画布背景半透明(开启“降低透明度”时保持不透明)
  • 外观覆盖菜单标明各平台支持项与不支持原因,提供全部恢复

修复

  • 还原 iOS 26 / 27 标签栏的液态玻璃底板与选中镜片,修复分层视图中黑色胶囊与白色模板字
  • 系统配置了 SOCKS / HTTP 代理时,连接始终直连目标,不可达的目标不再被误判为已连接
  • App 重启后手动刷新只更新部分图层
  • 切换目标面板中第一张卡片显示焦点环

安全与性能

  • 对端发来的预览图与纹理只解码 PNG,并限制大小
  • 大纲列宽只重新测量内容变化的行,上万节点时展开、过滤、屏蔽与缩放窗口不再卡顿;纹理加载进度统计改为增量计数

命令行与 AI 助手

  • 层级与节点输出带 gestures= 字段(JSON 中为 gestures 数组),帮助与 MCP 工具说明同步更新

  • 官网:https://lumen.vanjay.cn

下载

芯片 文件 大小 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

Choose a tag to compare

@wangwanjie wangwanjie released this 20 Nov 03:36

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

Choose a tag to compare

@wangwanjie wangwanjie released this 19 Nov 23:18

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

Choose a tag to compare

@wangwanjie wangwanjie released this 19 Nov 19:57

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。