linyaps-agents (如意玲珑打包 Agents)是一组把 Linux 软件包迁移到玲珑格式的 Agents,三段组成一条流水线:

  • linyaps-app-packaging-script-generator:把 deb、AppImage、tar 转成玲珑构建工程;
  • debian-rules-to-linyaps-rules:把 Debian 源码构建规则翻译成玲珑规则;
  • linyaps-packaging-scripts-running-skill:负责跑构建、上传结果。

伴随着对 1.0 版本的深入体验,一些问题逐渐凸显:流水线每段“干完自己的活就停”,软链断了、依赖缺了、备选依赖看不懂、补丁被忽略、apt 报错没注意、长构建超时被杀,剩下全靠人接。如意玲珑打包工具集 linyaps-agents v3.2026.10 的 145 次提交、48 项新功能,核心就是:把断掉的三段接回去,让 Agents 自己走到构建成功。

 

升级后,有哪些变化?

变化一:自己补依赖、修链接、调试到能跑  

linyaps-app-packaging-script-generator 补上了“生成之后”的活:

  • 自动解析缺失依赖,用 apt-file 搜归属包,补 depends、生成下载脚本;

  • 自动修复非标准目录下指向错误路径的 .so 软链;
  • 构建前禁用 desktop 文件中在玲珑环境不生效的 Path 键;
  • 新增 bin2linyaps.debug 五阶段调试:提取、分析、修复、验证、报告,生成后自己跑到能启动;
  • 模板增强:透传额外构建参数、嵌套脚本启动器、按需禁用 runtime、跳过特殊路径处理、文件级包名查询。

以前它交作业,现在交完还自己检查一遍。

 

变化二:读懂构建规则,而不是匹配文本  

debian-rules-to-linyaps-rules 接入 LLM 语义分析,不再机械匹配:

  • 遇到 | 分隔的备选依赖,理解语义再生成,不再跳过;
  • quilt 补丁自动迁移,并补全补丁引入的构建依赖;
  • 根据 build-depends 递归解析 runtime-depends,依赖一次配齐;
  • 源码构建默认走 ccache + clang;
  • 新增 src2linyaps.debug 五阶段调试,修完再跑验证;
  • 校验从黑名单升级为基于参考的校验:从“不能错什么”变成“应该对什么”。

以前照着模板套,现在看懂了再写

 

变化三:对构建过程负责到底

linyaps-packaging-scripts-running-skill 的关键词是“可追溯”:

  • 打包前预检查 linglong.yaml 格式、依赖、版本号,不对就阻塞;
  • 日志发现 apt 错误立即终止并阻塞该包,不再连锁失败;
  • 长构建放后台,配合进程存活检测,不怕超时;
  • 强制只能通过脚本入口打包,堵住绕过工程化流程的捷径;
  • 预检查阶段验证上传通道,构建成功自动上报状态;
  • 修复日志结构化记录,构建后发到 issue 评论,每步留痕。

以前构建是黑盒,跑挂只能重来;现在每步留痕,错了知道错在哪。

 

变化四:三仓库同步做 token 优化

分析高 token 来源后,各仓库收紧输出边界:子技能只返回任务级短摘要,完整日志保留本地,异常诊断限 100–200 行尾部,不再把全量编译日志送进上下文。debian-rules 仓库还删掉了自身就是上下文开销的“节省上下文”建议节和重复约束节。token 省下来,Agent 长时间自主跑的成本才撑得住,闭环才能落地。

单看是各修各的 bug,合起来是补同一条链路的三个断点:生成不验证 → 规则读不懂 → 构建不可控。以前靠人接,是因为人有闭环:看报错、查原因、改完再跑。这个版本让 Agent 学同一件事:每个环节自己收尾,整条链路才不需要人一直盯着。

 

安装部署

系统要求

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

安装依赖包

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

  • sudo apt install python3-yaml python3-ruamel.yaml

导入 Agents 与 Skills

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

工具 Agents 导入 Skills 导入
OpenCode https://opencode.ai/docs/zh-cn/agents/#markdown https://opencode.ai/docs/zh-cn/skills/
Codex https://learn.chatgpt.com/docs/customization/overview#agents-guidance https://learn.chatgpt.com/docs/customization/overview#skills
VS Code https://code.visualstudio.com/docs/agent-customization/custom-agents https://code.visualstudio.com/docs/agent-customization/agent-skills
TRAE IDE https://docs.trae.ai/ide/subagents?_lang=zh https://docs.trae.ai/ide/skills?_lang=zh

 

这个版本意味着什么

以前判断 AI 打包工具,看它能不能生成构建工程;现在看它能不能生成优质的构建工程——依赖自己补全、链接自己修好、规则自己读懂、构建自己验证,拿到就能跑。

这是从“能生成”到“生成得好”的差别。玲珑生态要适配的发行版越来越多、包越来越杂,靠人逐个检查质量有上限;Agent 能自己兜住质量,上限才抬得起来。

以前的版本证明会打包;linyaps-agents v3 在证明:不只是会打包,还能把包打好。

现在,把 Linux 软件包交给它,看它自己跑到构建成功!