Summary

Application packaging has long remained technically challenging within the Linux ecosystem. Working with Debian build specifications, hand‑written linglong.yaml configurations and multi‑format package conversion drains plenty of repetitive work even for seasoned developers.

Now the community gains an intelligent workaround.

Version 1.0.0 of the Linyaps‑packaging‑agents‑toolset‑1.0.0 is officially available for open‑source contributors. This full‑chain AI‑agent toolkit covers build‑rule generation, packaging‑script creation and template‑based project deployment. It delivers optimal performance when operated under deepin 25.

Introduction to Linyaps Packaging‑Agent Toolkit

The toolkit integrates three independent agents with clear‑cut responsibilities:

Agent Function Description
debian‑rules‑to‑linyaps‑rules Parses Debian source‑package build specifications and outputs the complete linglong.yaml build configuration for Linyaps
linyaps‑app‑packaging‑script‑generator Batch‑converts deb archives, tar packages and AppImage files into ready‑to‑use Linyaps packaging projects
linyaps‑packaging‑scripts‑running‑skill Executes new‑version builds against existing packaging templates and generates Linyaps layer packages

Target Users

  • Open‑source maintainers who intend to publish software on the Linyaps application store

  • Community volunteers responsible for migrating mainstream Linux applications to Linyaps format in batches

  • Enterprise teams that carry out routine upgrades of in‑house Linyaps‑formatted software

  • Linux packaging beginners unfamiliar with Debian build syntax and linglong.yaml rules

Breakdown for Each Agent

debian‑rules‑to‑linyaps‑rules: Translate Debian Build Rules Into Linyaps Configurations

This agent is built for open‑source projects furnished with a standard debian/ build folder.

Repository: https://github.com/OpenAtom-Linyaps/debian-rules-to-linyaps-rules

Its multi‑skill pipeline handles the whole conversion workflow:

Skill Name Capability
src2linyaps.debian.analyze‑control Extracts structured metadata, build‑dependency lists and package descriptions from debian/control, merges multi‑package entries and parses runtime dependencies
src2linyaps.debian.analyze‑rules Scans build resources, identifies build tools, compiles flags and generates the build‑section data for linglong.yaml
src2linyaps.debian.build‑res‑generate Produces the final complete linglong.yaml file combining parsed dependencies and build‑section parameters
src2linyaps.debian.test‑deps Simulates dependency installation and detects missing build‑dependent packages
src2linyaps.source.analyze‑args Detects configurable compilation arguments such as CMAKE_INSTALL_PREFIX
src2linyaps.source.detect‑tool Recognizes build utilities including CMake, Meson and Make by scanning source‑root marker files

Applicable Scenarios

  • Projects carrying native Debian build folders requiring Linyaps adaptation

  • New‑comers without hands‑on experience of manual linglong.yaml editing

  • Teams re‑using existing Debian build assets to speed‑up Linyaps migration

Sample Prompt

The source‑code archive locates at https://linux.apps.demo.com/download/demo.orig.tar.xz, and Debian build files are stored under /path/to/your/sourceDebianRules. Generate the linglong.yaml configuration for Linyaps packaging.

linyaps‑app‑packaging‑script‑generator: Batch‑Migrate deb, tar and AppImage Packages

This agent automates the generation of Linyaps packaging projects from multiple mainstream Linux package formats.

Repository: https://github.com/OpenAtom-Linyaps/linyaps-app-packaging-script-generator

Built‑in Skill Modules

Skill Name Capability
appimage‑linyaps Adapts AppImage binaries to the Linyaps containerized format
tar‑linyaps Converts binary tar archives into standardized Linyaps packaging projects
compat‑testing Runs post‑generation build tests and environment‑compatibility inspection
deb‑analysis Extracts metadata and decompiles files from .deb packages
linglong‑fix Auto‑corrects yaml formatting, desktop entries, icon directories and binary permissions
linglong‑project‑gen Creates full‑scale packaging projects with linglong.yaml and executable build scripts
project‑structure‑validator Checks directory integrity and mandatory documents
resource‑collector Extracts desktop shortcuts, icons and metadata files to the standard resource directory

The final deliverable is a customizable, reusable packaging project directory named CI_${ll_id}.

Build‑Command Example

bash

./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"

Applicable Scenarios

  • Bulk conversion work for deb, compressed tar and AppImage packages

  • Developers blocked by the learning curve of hand‑written linglong.yaml

  • Processing non‑standard binary packages unsupported by legacy conversion utilities

Sample Prompt

Convert the installation file stored in /path/to/your/file to a Linyaps‑formatted application.

linyaps‑packaging‑scripts‑running‑skill: Iterative Build Based on Established Templates

While the former two agents create packaging projects from scratch, this tool streamlines recurring version upgrades. Developers may feed updated source archives or binary packages and trigger new builds with saved templates.

Repository: https://github.com/OpenAtom-Linyaps/linyaps-packaging-scripts-running-skill

Built‑in Skill Modules

Skill Name Capability
linglong‑binary‑runner Launches binary‑package builds through pak_linyaps.sh
linglong‑source‑updater Updates source‑file references inside linglong.yaml and produces new Linyaps layer packages, supporting archive, git, local file and dsc source types

Applicable Scenarios

  • Periodic version updates with mature packaging templates

  • Executing formal layer builds for projects generated by the other two agents

  • Daily maintenance and iterative packaging workflows

Sample Prompt

Upgrade the Linyaps application using the source archive https://linux.apps.demo.com/download/demo.orig.tar.xz. The existing template directory contains the linglong.yaml build file.

Installation Guide

System‑level Requirements

  • Operating‑system: deepin 25

  • Supported Architecture: x86_64, arm64

Dependency Installation

Execute the following command to install fundamental runtime packages:

sudo apt install python3‑yaml python3‑ruamel.yaml

Download linglong‑bin and linglong‑builder from the GitHub release page and complete installation:

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

Import Agents and Skills

Import agent configurations and skill directories according to your AI coding‑agent platform:

Platform Agent Import Document Skill Import Document
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=en https://docs.trae.ai/ide/skills?_lang=en

One‑Click Deployment Script

Run the installation script under OpenCode‑CLI, Codex‑CLI or TRAE‑IDE:

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

Updated Official Linyaps Documentation

The official Linyaps documentation site has been upgraded with five categorized sections: beginner guides, user manuals, developer references, specification documents and practical tutorials. Troubleshooting entries are also attached.

New packagers can quickly master daily operations and known fixes, while advanced developers access packaging specifications and underlying principles. Community forums and GitHub‑issue channels remain available for unresolved problems.

Official Guide: https://linyaps.org.cn/en/guide/start/whatis.html

The launch of version‑1.0.0 packaging‑agent toolkit marks a key milestone of intelligent automation for the Linyaps ecosystem. The three‑agent pipeline covers rule parsing, batch conversion and continuous building, empowering AI to simplify Linux application packaging.

Get your hands‑on with the toolkit and streamline your packaging workflow.

All Linux and open‑source enthusiasts are welcome to join our community. Bug reports, feature suggestions, code commits and social‑media sharing all contribute to Linyaps advancement.

Official Community Channels

1.Linyaps Official English Website: https://linyaps.org.cn/en

2.Linyaps Section on deepin English Forum:https://bbs.deepin.org/en

3.Official deepin Telegram Group: https://t.me/+sotJGV9DtyBiNDg0

4.DistroWatch: https://distrowatch.com/table.php?distribution=deepin…

Project Overview

Linyaps is an innovative container‑based package‑management toolkit built to resolve dependency‑conflict troubles across Linux distributions. It decouples applications from host operating systems via isolated runtime environments and implements "one‑time build for multi‑architecture deployment". The project aims to cut down software‑maintenance overhead, strengthen file‑system security and build a prosperous, efficient cross‑platform Linux application ecosystem.