
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 软件包交给它,看它自己跑到构建成功!

English