在 Linux 生态中,应用打包的工作一直以来都有一定门槛。面对 Debian 构建规则、玲珑的 linglong.yaml 配置、各种格式的软件包转换……即使是经验丰富的开发者,也难免在重复劳动中消耗大量精力。

现在,这些问题有了更智能的解法。

如意玲珑(Linyaps)打包 Agents 工具集 1.0.0linyaps-packaging-agents-toolset-1.0.0)正式面向社区开放!这是一套覆盖构建规则生成、便捷打包脚本创建到工程模板执行全链路的 AI Agents 工具集,配套 deepin 25 / 统信桌面操作系统 v25 专业版 使用效果更佳。

 

如意玲珑打包 Agents 工具集

Toolset 简介

工具集内置三个 Agents 及其职责:

Agent

版本

职责

debian-rules-to-linyaps-rules

v2026.7.20.1

分析项目源码的 Debian 构建规则,生成玲珑构建配置 linglong.yaml

linyaps-app-packaging-script-generator

v2026.7.20.1

将 deb / tar 归档 / AppImage 批量转换为玲珑便捷打包脚本工程

linyaps-packaging-scripts-running-skill

v2026.7.20.1

基于已有打包工程模板,接受新版来源执行构建,产出 layer 包

谁适合使用这套工具集?

  • 开源软件维护者:想把自己维护的项目上架玲珑应用商店,但初次接触如意玲珑对适配开发文档了解有限
  • 社区打包志愿者:需要批量将常用 Linux 应用“玲珑化”
  • 企业应用分发团队:需要定期更新内部应用的玲珑版本
  • Linux 打包新手:不熟悉 Debian 规则和 linglong.yaml 语法,希望 AI 辅助完成入门

 

接下来,我们逐一拆解每个 Agent 的能力和使用场景。

 

Agent 1:debian-rules-to-linyaps-rules

把 Debian 构建规则“翻译”成玲珑配置

如果你手里有一个已经提供了 debian/ 目录的开源项目,想把它转成玲珑应用,这个 Agent 就是为你准备的。

仓库地址https://github.com/OpenAtom-Linyaps/debian-rules-to-linyaps-rules

 

它的核心能力是一套完整的 Skills 流水线:

Skill 名称

功能描述

src2linyaps.debian.analyze-control

解析 debian/control 文件,提取源码包名、构建依赖列表、描述信息等结构化数据;处理多个 Package 条目的全量合并去重;基于 apt 仓库解析构建依赖的运行时依赖

src2linyaps.debian.analyze-rules

分析 debian 构建规则和资源文件,输出构建工具类型、编译参数及默认值、baseline 版本、源码包名、合并后资源列表、build_section 的最终 YAML

src2linyaps.debian.build-res-generate

基于 analyze-control 输出的依赖信息和 analyze-rules 输出的 build 段,结合模板和默认值配置,生成完整的 linglong.yaml 玲珑构建规则

src2linyaps.debian.test-deps

读取 debian/control 中的 Build-Depends 字段,通过 apt-get build-dep --dry-run 模拟安装检测依赖可用性,输出依赖包状态:可用、部分缺失或完全不可用

src2linyaps.source.analyze-args

根据构建工具类型读取对应的构建配置文件,解析可修改的编译参数(如 prefix、DESTDIR、CMAKE_INSTALL_PREFIX 等),输出构建工具类型和编译参数列表

src2linyaps.source.detect-tool

扫描项目源码根目录,按优先级匹配特征文件,检测项目使用的构建工具类型

建议使用场景

  • 项目已提供 Debian 构建规则(debian/ 目录),需转译为玲珑构建配置
  • 不熟悉 Linux 打包规范和 linglong.yaml 手工编写的入门用户
  • 希望复用现有 Debian 生态构建资源,加速玲珑适配过程

 

建议提示词

https://linux.apps.demo.com/download/demo.orig.tar.xz 是一个开源项目源码包,
/path/to/your/sourceDebianRules 是此项目的 debian 构建目录,帮我转换为玲珑构建配置文件 linglong.yaml

https://linux.apps.demo.com/download/demo.orig.tar.xz 是一个开源项目源码包,
帮我转换为玲珑构建配置文件 linglong.yaml

 

Agent 2:linyaps-app-packaging-script-generator

批量转换 deb / tar / AppImage 为玲珑工程

这个 Agent 主打“省事”——无论你手里是 Debian 软件包(.deb)、tar 二进制归档包(.tar.zst 等),还是 AppImage 应用,它都能帮你批量转换为玲珑便捷打包脚本工程目录。

仓库地址https://github.com/OpenAtom-Linyaps/linyaps-app-packaging-script-generator

 

它的 Skills 能力同样丰富:

Skill 名称

功能描述

appimage-linyaps

将 AppImage 应用程序转换为玲珑包格式,基于 tar-linyaps 技能架构,针对 AppImage 特性进行优化

tar-linyaps

将 Linux binary release tar 归档包转换成玲珑应用便捷打包脚本

compat-testing

执行玲珑打包构建测试,验证生成工程能否正常构建,并运行兼容性检测确保应用在玲珑环境中正常运行

deb-analysis

解析 Debian 软件包(.deb)文件,提取元数据信息并解压文件内容,为后续玲珑打包工程生成提供基础数据

linglong-fix

根据验证报告自动修复玲珑构建项目中的问题,包括 linglong.yaml 格式、desktop 文件、图标目录结构、二进制文件权限等

linglong-project-gen

根据 deb 包信息和 CSV 配置,生成完整的玲珑打包工程,包括 linglong.yaml 配置文件和 pak_linyaps.sh 打包脚本

project-structure-validator

验证玲珑打包项目目录结构和必要文件的完整性,确保项目符合打包要求

resource-collector

从 deb 包解压后的目录中提取应用资源文件(desktop 文件、图标、appdata、补全脚本等),按照玲珑打包规范整理到 files_res/ 目录结构中

 

输出资源目录结构

支持手动修改、重复使用的应用打包脚本工程目录 CI_${ll_id}

 

打包工程使用示例

./pak_linyaps.sh \

--linyaps_arch=x86_64 \

--origin_version="3.6.5" \

--src_path="/media/deepin/Data/top100-CI/260602-init/src/siyuan-3.6.5-linux.deb" \

--output_dir="/media/deepin/Data/top100-CI/260602-init/output" \

--build_tmp_dir="/home/deepin/.cache/siyuan"

 

建议使用场景

  • 需要批量将 deb / tar 归档 / AppImage 转换为玲珑工程
  • 手动编写 linglong.yaml 存在客观门槛
  • 现有转制工具不支持的非标准格式包,需 AI 辅助处理

 

建议提示词

帮我把本地目录 /path/to/your/file 安装包转换为玲珑应用

https://linux.apps.demo.com/download/demo.deb 是一个 Linux 应用,帮我转换为玲珑应用

 

Agent 3:linyaps-packaging-scripts-running-skill

用已有工程模板持续构建新版本

前两个 Agent 负责“从 0 到 1”创建工程,而第三个 Agent 负责“1”的版本迭代——在已经持有可重复使用的构建工程模板后,接受用户传递的同一个应用的新版本来源(新 deb / 新源码),根据指定的工程模板目录进行打包。

仓库地址https://github.com/OpenAtom-Linyaps/linyaps-packaging-scripts-running-skill

 

它的 skills 能力如下:

Skill 名称

功能描述

linglong-binary-runner

通过 pak_linyaps.sh 执行玲珑二进制打包。用于已适配便捷打包脚本的项目(特征:目录下有 pak_linyaps.sh

linglong-source-updater

更新已初始化的 linglong.yaml,补充上游源码信息,更新构建规则,并打包为玲珑 layer。用于 source 类型任务(特征:目录下有 linglong.yaml 但缺少 sources 段)。支持 archive / git / file / dsc 四种源码类型

建议使用场景

  • 已有打包工程模板,需定期更新版本(新 deb / 新源码)
  • 需要将前两个 Agent 产出的工程模板落地为实际 layer 构建
  • 日常打包维护中使用已有工程模板执行构建

 

建议提示词

使用此软件包 https://linux.apps.demo.com/download/demo.deb 更新玲珑应用,
已经适配的工程目录在 /path/to/your/pak_linyaps.sh

使用此项目源码 https://linux.apps.demo.com/download/demo.orig.tar.xz 更新玲珑应用,
已经适配的工程目录在 /path/to/your/linglong.yaml

 

安装部署

系统要求

  • 操作系统:deepin 25统信桌面操作系统 V25 专业版
  • CPU 架构:x86_64 / arm64 (按实际环境选择)

 

安装依赖包

三个 Agent 均依赖以下软件包,需通过 apt 安装:

sudo apt install python3-yaml python3-ruamel.yaml

从对应 Agent 仓库的 Release 页面下载指定版本的 linglong-binlinglong-builder 后进行升级/降级:

sudo apt install ./linglong-bin_1.13.7-ziggy2_amd64.deb ./linglong-builder_1.13.7-ziggy2_amd64.deb

* 需要安装的文件和路径以实际为准

 

导入 Agents 与 Skills

根据所使用的 Coding Agent CLI 工具,参考对应文档导入 agents 配置和 skills 目录:

工具

Agents 导入

Skills 导入

OpenCode

查看文档

查看文档

Codex

查看文档

查看文档

VS Code

查看文档

查看文档

TRAE IDE

查看文档

查看文档

 

除基础安装部属外,以下工具也支持一键安装

支持在OpenCode CLI、Codex CLI、TRAE IDE下执行命令一键安装skills:

bash <(curl -fsSL https://raw.gitcode.com/ziggy1030/linyaps-agents-easy-installer/blobs/5a94907a07638690023a339f48a689e8cb81438e/easy-to-install-linyaps-agents.sh)

 

如意玲珑官方文档更新

随着如意玲珑的持续演进,官方文档也在不断丰富和完善,现已形成入门指南、用户手册、开发者文档、参考文档、精选课程五大知识板块,并设有“提示与常见问题”。这套文档不仅能帮助普通用户快速上手日常操作、轻松排查常见问题,也可以让开发者系统学习打包规范、按需查阅底层原理,并通过精选课程将知识转化为实战能力。遇到文档无法解决的问题,还可通过 deepin 社区论坛或 GitHub Issues 获取进一步帮助。欢迎前往查阅:

https://linyaps.org.cn/guide/start/whatis.html

 

 

如意玲珑打包 Agents 工具集 1.0.0 的发布,标志着玲珑生态在智能化、自动化方向上迈出了重要一步。三个 Agent 各司其职,覆盖从“规则转译”到“批量转换”再到“持续构建”的完整链路,让 AI 真正成为打包工作的得力助手。

赶快去试试吧,让 AI 帮你搞定打包那些事儿!

 

 

如意玲珑始终致力于打造开放、包容、国际化的基础软件生态。本次西语本地化的落地,既是社区全球化进程中的重要一步,也是一个全新的开始。未来,我们期待更多来自世界各地的开发者加入,共同构建属于所有人的开源生态!

👉加入如意玲珑生态共建小组

 

了解更多

 

关于项目
如意玲珑(Linyaps)是一种新型的独立包管理工具集,专注于解决 Linux 系统下由传统软件包格式的复杂性和交叉依赖关系引起的兼容性问题。项目通过先进的隔离技术,将应用与系统完全解耦,从根本上解决因环境变化引发的应用兼容性问题,实现“一个架构,一次构建”,致力于简化软件开发流程、降低维护成本、加强数据安全,促进技术与平台间的协同合作,构建一个更加繁荣、安全和高效的 Linux 软件生态环境。