近期，如意玲珑（Linyaps）1.14 版本发布。从 1.13.0 到 1.14.0，这次更新把精力放在了修好一批实实在在的痛点上——无论是普通用户升级时的“丢模块”烦恼、打包者调试应用的麻烦，还是运维对磁盘占用和合规审计的需求，这一版都给出了更妥善的解决方案。

下文按不同角色分别介绍，您可以挑自己关心的部分看~

普通用户：日常使用更省心，不再为小毛病烦神

如果您只是用玲珑来安装和运行应用，下面这几个变化您升级后就能直接感受到。

1. 升级、降级应用，不再“丢三落四”

以前偶尔会遇到：升级一个应用后，它自己带的某个老模块被误删了，还得手动补装。1.14 修掉了这个逻辑错误，现在无论怎么切换版本，已安装的模块都会稳稳地保留。

2. 磁盘空间自动清理与透明化分析

自动清理无用依赖：以前每次安装、卸载或升级后攒下来的"没人再用但也没人删"的依赖，一直躺在硬盘里。现在系统会自动清理用不到的依赖；帮您省出硬盘空间。如果您有特殊原因想保留所有历史版本就加一句：

ll-cli install <应用> --no-auto-prune

精准分析磁盘占用：无需再四处翻找文件夹排查，新增命令支持查看应用的依赖关系与空间占用：

两条命令即可一目了然：

ll-cli analyze depends <应用>   # 它依赖了哪些东西

ll-cli analyze size <应用>      # 它到底多大

其中 analyze size 会从独占、共享、逻辑、实际四个维度的空间占用进行精细列示。

3. 中文输入法不“卡壳”了，音视频和读屏也更顺

以前在沙箱里运行一些 Qt 或 SDL 写的应用，偶尔切换不出中文输入法。1.14 把输入法需要的环境变量自动传进沙箱，现在打字稳多了。

如果您运行音视频类应用，加上 --enable-pipewire 参数，就能把当前用户的音频服务带进沙箱，声音和画面更流畅。使用读屏软件的用户加上 --enable-atspi，无障碍支持也更到位。

4. 下载加速：选个离你近的镜像源

想用国内镜像加速下载？一条命令搞定：

ll-cli repo enable-mirror myrepo --region CN

系统会自动切换到指定区域（如 CN、US、EU）的镜像，省时省力。

一些不起眼但很贴心的细节修复

如果您的电脑主目录不在 /home 下（比如挂载到别的路径），以前文件路径映射可能出错，现在系统会读取真实的 $HOME 环境变量，不再硬编码，文件访问准确无误。

/etc/resolv.conf 如果是软链接，沙箱也能正确拿到 DNS 配置，网络访问更可靠。

想看完整的容器 ID（不被截断），用 ll-cli ps --no-truncated 即可。

开发者/打包者：调试、导出、构建工具链全面增强

如果您是维护玲珑应用打包的开发者，下面这些新工具和优化能直接提升您的日常效率。

1. 新导出格式 UABX：轻量运行，不进容器

新增导出极轻量运行包：

ll-builder export --uabx

UABX 仅包含应用自身模块与 loader，不含 Base、Runtime、uab-loader 和 ll-box，运行时不进入容器隔离，适用于需要直接执行的轻量场景。

2. 专用调试入口：告别手工拼凑环境

以前调试沙箱里的应用总是很麻烦，现在有了专门命令：

ll-cli run --debug <应用>

它会通过 gdbserver 启动应用，支持三个调试参数：

--debug-listen：自定义监听地址（默认只监听回环地址，安全）

--debug-debuginfod：对接调试信息服务器

--debug-symbol-dir：指定本地符号目录

配合 -vv 参数可以输出更详细的日志和 backtrace，排查崩溃或异常更加得心应手。

3. 构建体验提效与配置精简

清理命令： 新增 ll-builder clean 命令快速清理构建产物。

配置智能推导： 打包 YAML 配置中， base 字段缺省时可根据 runtime 自动推导。

本地文件安装防错： 执行 ll-cli install ./xxx.uab 或 .layer 时，优先按本地文件路径识别，路径无效直接报错，杜绝误认作远程仓库引用的况。

命令传参与状态查看：修复了ll-init 空参数异常；ll-cli ps 新增 --no-truncated 参数，支持查看长格式的完整容器 ID。

Hook 脚本解析增强： 安装 hook 现支持按引号正确解析命令与参数，避免带空格或复杂字符串时被错误拆分，参数传递更准确。

4. UAB 导出更稳定：硬链接自动平滑降级

跨设备导出 UAB 包时，若因文件系统限制硬链接创建失败，ll-builder 会自动退回复制模式，确保导出不中断。目录符号链接在导出时完整保留。此改进避免应用因文件系统差异出错，打包更可靠。

系统架构与运维：Drop-in 增量配置，CDI 设备与安全增强

1. Drop-in 增量配置与多层级合并

支持 config.d/*.json 放置增量配置文件，无需修改主配置文件即可实现配置追加与覆盖。系统按系统级（System） -> 应用级（App） -> 用户级（User）的优先级秩序自动合并配置。

2. CDI（容器设备接口）支持与硬件识别

增加 /etc/linglong/cdi 为 CDI 设备声明搜索路径,方便集成第三方设备插件。

内置 ll-driver-detect 工具，按 SemVer 语义化版本比对 NVIDIA 等显卡驱动，确保图形渲染与硬件加速环境精准匹配。

3. 隔离与构建环境安全强化

宿主信息隔离： 构建环境不再挂载宿主机的 /etc/passwd 与 /etc/group，提升构建安全。

传递修复： 修复 QtDBus 文件描述符传递、bind mount 传播机制与 overlayfs 检测问题。

版本追踪： 非发布（Non-release）构建版本号强制附带 Git Hash 与 Channel 标识，配合 -vv 详细日志与 Backtrace 提升排查效率。

稳定性与守护进程：修复了 ll-package-manager 启动异常与任务最终状态获取不稳定的问题；优化 Overlayfs 检测并支持模式的显式覆盖。

30 秒速查

 ll-cli run --debug <应用>                 # gdbserver 启动 + 默认回环监听

ll-cli analyze depends <应用>             # 依赖树

ll-cli analyze size <应用>                # 四种口径体积

ll-builder export --uabx                  # 运行模式 UABX（不含 base/runtime/ll-box）

ll-builder clean                          # 清构建产物

ll-cli install ./xxx.uab                  # 本地包标准写法

# linglong.yaml 里的 base 字段现在可以省略，缺省从 runtime 推导

升级建议

1.14 版本与 1.13 的配置完全兼容，正常升级即可，无需额外调整。

普通用户：升级前可以先 ll-cli --version 看下当前版本。升级之后建议立刻试两件事：ll-cli analyze size 看看你最常用的那个应用到底多大，以及给常开的音视频应用加上 --enable-pipewire。

开发者：建议优先尝试 --uabx 导出和 --debug 调试模式，它们能显著缩短您的迭代周期。

参考链接：

Release 1.14.0：https://github.com/OpenAtom-Linyaps/linyaps/releases/tag/1.14.0

发布日志：https://www.linyaps.org.cn/guide/start/release_note.html

安装文档：https://www.linyaps.org.cn