chore: initial repository setup

xifan2333 · xifan2333 · commit 4be7eda5fb10 · 2025-10-13T03:41:41.000+08:00
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,11 @@
+/pkg/
+/src/
+pkgs/*/pkg/
+pkgs/*/src/
+*.pkg.tar.zst
+*.pkg.tar.xz
+*.pkg.tar.*
+*.AppImage
+*.log
+*.cache/
+*.tmp
diff --git a/README.md b/README.md
@@ -0,0 +1,27 @@
+<!-- This file is generated from docs/readme.en.template.md. Run scripts/build-readme.sh to regenerate. -->
+
+# aur-auto
+
+[![AUR Maintainer](https://img.shields.io/badge/AUR-xifan-1793D1?logo=arch-linux&logoColor=white)](https://aur.archlinux.org/packages?SeB=m&K=xifan)
+
+Automation toolkit for maintaining Arch User Repository packages with GitHub Actions.
+
+## Overview
+- Detect upstream releases per package by calling dedicated hooks in `pkgs/<pkgname>/upstream.sh`.
+- Regenerate PKGBUILD metadata, build packages in clean chroots, and publish to AUR.
+- Provide bilingual documentation for contributors and maintainers.
+
+## Maintainers
+- xifan `<xifan2333@gmail.com>`
+
+## Documentation
+- Repository Guidelines: [English](docs/guidelines.en.md) · [中文](docs/guidelines.zh.md)
+- Packaging Workflow: [English](docs/packaging.en.md) · [中文](docs/packaging.zh.md)
+- README (中文版本): [docs/readme.zh.md](docs/readme.zh.md)
+
+## Packages
+| Package | Description | Upstream | Version | Build Status |
+| --- | --- | --- | --- | --- |
+| `kdenlive-appimage-pure` | A non-linear video editor for Linux using the MLT video framework (AppImage build) | `Kdenlive` | 25.08.2 | [![Build Status](https://img.shields.io/github/actions/workflow/status/xifan/aur-auto/release.yml?branch=main&logo=github&label=build)](https://github.com/xifan/aur-auto/actions/workflows/release.yml) |
+
+Regenerate this README after documentation or metadata changes with `scripts/build-readme.sh`.
diff --git a/README.zh.md b/README.zh.md
@@ -0,0 +1,27 @@
+<!-- 该文件由 docs/readme.zh.template.md 渲染而来，执行 scripts/build-readme.sh 生成。 -->
+
+# aur-auto
+
+[![AUR 维护者](https://img.shields.io/badge/AUR-xifan-1793D1?logo=arch-linux&logoColor=white)](https://aur.archlinux.org/packages?SeB=m&K=xifan)
+
+使用 GitHub Actions 自动维护 Arch User Repository 软件包的工具集。
+
+## 项目概览
+- 每个包通过 `pkgs/<pkgname>/upstream.sh` 钩子检测上游新版本。
+- 自动更新 PKGBUILD 元数据，在 clean chroot 中构建并推送至 AUR。
+- 为贡献者与维护者提供双语文档。
+
+## 维护者
+- xifan `<xifan2333@gmail.com>`
+
+## 文档
+- 仓库规范：[English](docs/guidelines.en.md) · [中文](docs/guidelines.zh.md)
+- 打包流程：[English](docs/packaging.en.md) · [中文](docs/packaging.zh.md)
+- README (English Version): [docs/readme.en.md](docs/readme.en.md)
+
+## 软件包
+| Package | Description | Upstream | Version | Build Status |
+| --- | --- | --- | --- | --- |
+| `kdenlive-appimage-pure` | A non-linear video editor for Linux using the MLT video framework (AppImage build) | `Kdenlive` | 25.08.2 | [![Build Status](https://img.shields.io/github/actions/workflow/status/xifan/aur-auto/release.yml?branch=main&logo=github&label=build)](https://github.com/xifan/aur-auto/actions/workflows/release.yml) |
+
+文档或元数据更新后，请运行 `scripts/build-readme.sh` 重新生成 README。
diff --git a/docs/guidelines.en.md b/docs/guidelines.en.md
@@ -0,0 +1,25 @@
+# Repository Guidelines (English)
+
+[中文版本](guidelines.zh.md)
+
+## Project Structure & Module Organization
+This repository automates Arch User Repository maintenance: it monitors upstream releases, rebuilds packages, and publishes to AUR. GitHub Actions workflows reside in `.github/workflows/`—`monitor-upstream.yml` handles scheduled detection, while `release.yml` publishes successful builds. Shared tooling lives in `scripts/`; orchestration happens in `update-package.sh`, and reusable helpers will be added under `scripts/lib/`. Each package stores its materials in `pkgs/<pkgname>/`, including `PKGBUILD`, `.SRCINFO`, and a package-specific `upstream.sh`.
+
+## Build, Test, and Development Commands
+Activate any project toolchain via `source scripts/env.sh` (when available) and run scripts with `./scripts/<name>.sh`. Typical local checks:
+- `scripts/update-package.sh kdenlive-appimage-pure` – detect upstream releases, refresh PKGBUILD and `.SRCINFO`.
+- `makepkg --syncdeps --cleanbuild` – reproducible local build.
+- `namcap PKGBUILD` & `namcap *.pkg.tar.zst` – static quality checks.
+- `extra-x86_64-build` – clean-chroot validation mirroring the AUR toolchain.
+
+## Coding Style & Naming Conventions
+Shell scripts target Bash, begin with `set -euo pipefail`, and use two-space indentation. Python helpers (when present) should follow `black` and `isort` defaults and export type hints on public functions. Name directories with lowercase-kebab style; shell files mirror that convention, while Python modules use snake_case. Reuse shared logging utilities under `scripts/lib/` to keep CI output consistent.
+
+## Testing Guidelines
+Execute `makepkg --syncdeps --cleanbuild` before publishing, and ensure `namcap` passes with no critical findings. Add regression coverage whenever you fix a bug; automation scripts should ship with minimal bats/shunit2 tests where feasible. CI jobs must build within a clean chroot, run QA, and upload artifacts plus logs for review.
+
+## Commit & Pull Request Guidelines
+Adopt Conventional Commits (`feat:`, `fix:`, `ci:`). Include upstream version bumps in commit subjects (e.g., `fix: bump kdenlive to 25.08.2`). Pull requests must update both `PKGBUILD` and `.SRCINFO`, attach CI logs, and link upstream releases or issues. Ensure GitHub Actions workflows succeed before requesting review.
+
+## Security & Configuration Tips
+Store AUR SSH keys and tokens inside repository secrets (e.g., `AUR_SSH_KEY`, `AUR_GIT_URL`) and rotate them quarterly. Never print secrets in scripts—use environment files or GitHub Actions secrets. Document any new credentials in `docs/secrets.md`, including rotation steps, so maintainers can audit quickly.
diff --git a/docs/guidelines.zh.md b/docs/guidelines.zh.md
@@ -0,0 +1,25 @@
+# 仓库规范（中文）
+
+[English Version](guidelines.en.md)
+
+## 项目结构与模块组织
+本仓库用于自动化维护 AUR 软件包：负责检测上游新版本、重新构建并推送到 AUR。GitHub Actions 工作流位于 `.github/workflows/`：`monitor-upstream.yml` 用于定时检测，`release.yml` 负责发布。通用脚本集中在 `scripts/`，编排逻辑由 `update-package.sh` 负责，后续的共享函数会放在 `scripts/lib/`。每个软件包在 `pkgs/<包名>/` 下维护自己的 `PKGBUILD`、`.SRCINFO` 以及对应的 `upstream.sh`。
+
+## 构建与测试命令
+如需本地操作，可执行 `source scripts/env.sh`（若存在）并使用 `./scripts/<脚本名>.sh`。常见的本地检查包括：
+- `scripts/update-package.sh kdenlive-appimage-pure`：检测上游版本并刷新 `PKGBUILD` 与 `.SRCINFO`。
+- `makepkg --syncdeps --cleanbuild`：在本地执行可复现构建。
+- `namcap PKGBUILD`、`namcap *.pkg.tar.zst`：静态质量检查。
+- `extra-x86_64-build`：使用官方 clean chroot 验证，与 AUR 工具链保持一致。
+
+## 代码风格与命名
+Shell 脚本统一使用 Bash，开头加上 `set -euo pipefail`，并采用两个空格缩进。若有 Python 辅助脚本，需遵循 `black` 和 `isort` 的格式，并为公共函数添加类型注解。目录与 Shell 文件推荐使用全小写加短横线；Python 模块则使用 snake_case。请复用 `scripts/lib/` 中的日志工具，保持 CI 输出风格一致。
+
+## 测试规范
+发布前必须运行 `makepkg --syncdeps --cleanbuild`，并保证 `namcap` 无严重问题。修复缺陷时务必增加回归测试；自动化脚本可酌情加入 bats/shunit2 等基础测试。CI 需要在干净 chroot 中构建，完成 QA 后上传构建产物与日志，方便审阅。
+
+## 提交与合并规范
+提交信息遵循 Conventional Commits（如 `feat:`、`fix:`、`ci:`），并在标题中注明上游版本号（示例：`fix: bump kdenlive to 25.08.2`）。PR 必须同时更新 `PKGBUILD` 与 `.SRCINFO`，附上 CI 日志，并关联上游发布或问题链接。确保 GitHub Actions 全部通过后再请求评审。
+
+## 安全与配置提示
+AUR 的 SSH 密钥和令牌应存储在仓库的 Secrets（如 `AUR_SSH_KEY`、`AUR_GIT_URL`）中，并建议按季度轮换。脚本中禁止直接输出敏感信息，可通过环境文件或 Actions Secrets 注入。若新增凭据，请记录在 `docs/secrets.md`，包含轮换流程，方便维护人员审计。
diff --git a/docs/packaging.en.md b/docs/packaging.en.md
@@ -0,0 +1,31 @@
+# Packaging Workflow (English)
+
+[中文版本](packaging.zh.md)
+
+## Repository Layout
+- `pkgs/<pkgname>/PKGBUILD`: canonical package recipe.
+- `pkgs/<pkgname>/.SRCINFO`: regenerated via `makepkg --printsrcinfo`.
+- `pkgs/<pkgname>/upstream.sh`: package-specific hooks for update automation.
+- `scripts/update-package.sh`: framework script invoking per-package hooks.
+
+Auxiliary patches or launchers should live alongside the PKGBUILD. AppImage desktop integration (wrappers, icons, `.desktop` entries) is generated inside `package()` instead of being committed as static files.
+
+## Auto-Update Flow
+1. Run `scripts/update-package.sh <pkgname>` to detect upstream releases.
+2. The package hook reports the download URL; the framework fetches the artifact and calculates the new SHA256.
+3. `pkg_update_files` writes `pkgver`, resets `pkgrel`, updates `source_x86_64`/`sha256sums_x86_64`, and calls `makepkg --printsrcinfo > .SRCINFO`.
+4. The script prints the version transition (`old -> new`). Use `--force` to refresh metadata even when versions match.
+
+Current example:
+- `kdenlive-appimage-pure`: AppImage build sourced from KDE downloads with automatic version discovery.
+
+## Manual Verification Checklist
+- `makepkg --cleanbuild --syncdeps`
+- `namcap PKGBUILD` and `namcap *.pkg.tar.zst`
+- Install test: `sudo pacman -U kdenlive-appimage-pure-*.pkg.tar.zst`, verify launch and icon.
+- Cleanup: `rm -rf src pkg *.pkg.tar.* *.AppImage`
+
+## Release Gates
+- Commit both `PKGBUILD` and `.SRCINFO`.
+- Attach build/test logs in PRs or CI artifacts.
+- If upstream structure changes, update `upstream.sh` promptly and emit clear error messages so CI fails fast.
diff --git a/docs/packaging.zh.md b/docs/packaging.zh.md
@@ -0,0 +1,31 @@
+# 打包流程（中文）
+
+[English Version](packaging.en.md)
+
+## 仓库布局
+- `pkgs/<包名>/PKGBUILD`：标准打包脚本。
+- `pkgs/<包名>/.SRCINFO`：通过 `makepkg --printsrcinfo` 重新生成。
+- `pkgs/<包名>/upstream.sh`：定义包的更新钩子，实现自动化。
+- `scripts/update-package.sh`：通用框架脚本，调用各包钩子。
+
+补丁或启动脚本请放在对应包目录下。AppImage 的桌面集成（包装脚本、图标、`.desktop` 文件）应在 `package()` 中生成，不要直接提交二进制资产。
+
+## 自动更新流程
+1. 执行 `scripts/update-package.sh <包名>` 检测上游新版本。
+2. 包的钩子返回下载地址，框架负责下载并计算新的 SHA256。
+3. `pkg_update_files` 写入 `pkgver`、重置 `pkgrel`、更新 `source_x86_64` 与 `sha256sums_x86_64`，然后运行 `makepkg --printsrcinfo > .SRCINFO`。
+4. 脚本输出版本变更（`old -> new`）。需要强制刷新时可使用 `--force`。
+
+目前的示例：
+- `kdenlive-appimage-pure`：从 KDE 官方下载 AppImage，自动解析最新稳定版。
+
+## 手动验证清单
+- `makepkg --cleanbuild --syncdeps`
+- `namcap PKGBUILD`、`namcap *.pkg.tar.zst`
+- 安装测试：`sudo pacman -U kdenlive-appimage-pure-*.pkg.tar.zst`，确认应用与图标可用。
+- 清理：`rm -rf src pkg *.pkg.tar.* *.AppImage`
+
+## 发布前检查
+- 提交时务必包含 `PKGBUILD` 与 `.SRCINFO`。
+- PR 或 CI 需要附上构建/测试日志。
+- 若上游目录结构变化，应及时更新 `upstream.sh` 的解析逻辑，并输出明确错误信息，便于 CI 快速定位问题。
diff --git a/docs/readme.en.md b/docs/readme.en.md
@@ -0,0 +1,27 @@
+<!-- This file is generated from docs/readme.en.template.md. Run scripts/build-readme.sh to regenerate. -->
+
+# aur-auto
+
+[![AUR Maintainer](https://img.shields.io/badge/AUR-xifan-1793D1?logo=arch-linux&logoColor=white)](https://aur.archlinux.org/packages?SeB=m&K=xifan)
+
+Automation toolkit for maintaining Arch User Repository packages with GitHub Actions.
+
+## Overview
+- Detect upstream releases per package by calling dedicated hooks in `pkgs/<pkgname>/upstream.sh`.
+- Regenerate PKGBUILD metadata, build packages in clean chroots, and publish to AUR.
+- Provide bilingual documentation for contributors and maintainers.
+
+## Maintainers
+- xifan `<xifan2333@gmail.com>`
+
+## Documentation
+- Repository Guidelines: [English](docs/guidelines.en.md) · [中文](docs/guidelines.zh.md)
+- Packaging Workflow: [English](docs/packaging.en.md) · [中文](docs/packaging.zh.md)
+- README (中文版本): [docs/readme.zh.md](docs/readme.zh.md)
+
+## Packages
+| Package | Description | Upstream | Version | Build Status |
+| --- | --- | --- | --- | --- |
+| `kdenlive-appimage-pure` | A non-linear video editor for Linux using the MLT video framework (AppImage build) | `Kdenlive` | 25.08.2 | [![Build Status](https://img.shields.io/github/actions/workflow/status/xifan/aur-auto/release.yml?branch=main&logo=github&label=build)](https://github.com/xifan/aur-auto/actions/workflows/release.yml) |
+
+Regenerate this README after documentation or metadata changes with `scripts/build-readme.sh`.
diff --git a/docs/readme.en.template.md b/docs/readme.en.template.md
@@ -0,0 +1,25 @@
+<!-- This file is generated from docs/readme.en.template.md. Run scripts/build-readme.sh to regenerate. -->
+
+# aur-auto
+
+[![AUR Maintainer](https://img.shields.io/badge/AUR-{{AUR_USER}}-1793D1?logo=arch-linux&logoColor=white)](https://aur.archlinux.org/packages?SeB=m&K={{AUR_USER}})
+
+Automation toolkit for maintaining Arch User Repository packages with GitHub Actions.
+
+## Overview
+- Detect upstream releases per package by calling dedicated hooks in `pkgs/<pkgname>/upstream.sh`.
+- Regenerate PKGBUILD metadata, build packages in clean chroots, and publish to AUR.
+- Provide bilingual documentation for contributors and maintainers.
+
+## Maintainers
+- {{AUR_USER}} `<{{AUR_EMAIL}}>`
+
+## Documentation
+- Repository Guidelines: [English](docs/guidelines.en.md) · [中文](docs/guidelines.zh.md)
+- Packaging Workflow: [English](docs/packaging.en.md) · [中文](docs/packaging.zh.md)
+- README (中文版本): [docs/readme.zh.md](docs/readme.zh.md)
+
+## Packages
+{{PACKAGE_TABLE}}
+
+Regenerate this README after documentation or metadata changes with `scripts/build-readme.sh`.
diff --git a/docs/readme.zh.template.md b/docs/readme.zh.template.md
@@ -0,0 +1,25 @@
+<!-- 该文件由 docs/readme.zh.template.md 渲染而来，执行 scripts/build-readme.sh 生成 README.zh.md。 -->
+
+# aur-auto
+
+[![AUR 维护者](https://img.shields.io/badge/AUR-{{AUR_USER}}-1793D1?logo=arch-linux&logoColor=white)](https://aur.archlinux.org/packages?SeB=m&K={{AUR_USER}})
+
+使用 GitHub Actions 自动维护 Arch User Repository 软件包的工具集。
+
+## 项目概览
+- 每个包通过 `pkgs/<pkgname>/upstream.sh` 钩子检测上游新版本。
+- 自动更新 PKGBUILD 元数据，在 clean chroot 中构建并推送至 AUR。
+- 为贡献者与维护者提供双语文档。
+
+## 维护者
+- {{AUR_USER}} `<{{AUR_EMAIL}}>`
+
+## 文档
+- 仓库规范：[English](docs/guidelines.en.md) · [中文](docs/guidelines.zh.md)
+- 打包流程：[English](docs/packaging.en.md) · [中文](docs/packaging.zh.md)
+- README (English Version): [docs/readme.en.md](docs/readme.en.md)
+
+## 软件包
+{{PACKAGE_TABLE}}
+
+文档或元数据更新后，请运行 `scripts/build-readme.sh` 重新生成 README。
diff --git a/metadata/maintainers.env b/metadata/maintainers.env
@@ -0,0 +1,3 @@
+AUR_USER=xifan
+AUR_EMAIL=xifan2333@gmail.com
+GITHUB_SLUG=xifan/aur-auto
diff --git a/metadata/packages/kdenlive-appimage-pure.env b/metadata/packages/kdenlive-appimage-pure.env
@@ -0,0 +1,2 @@
+BUILD_WORKFLOW=release.yml
+UPSTREAM_NAME_OVERRIDE=Kdenlive
diff --git a/pkgs/kdenlive-appimage-pure/.SRCINFO b/pkgs/kdenlive-appimage-pure/.SRCINFO
@@ -0,0 +1,15 @@
+pkgbase = kdenlive-appimage-pure
+	pkgdesc = A non-linear video editor for Linux using the MLT video framework (AppImage build)
+	pkgver = 25.08.2
+	pkgrel = 1
+	url = https://www.kdenlive.org
+	arch = x86_64
+	license = GPL
+	depends = fuse2
+	provides = kdenlive
+	conflicts = kdenlive
+	options = !strip
+	source_x86_64 = kdenlive-25.08.2-x86_64.AppImage::https://download.kde.org/stable/kdenlive/25.08/linux/kdenlive-25.08.2-x86_64.AppImage
+	sha256sums_x86_64 = 81f83c9518176224fad81bfc4f47e4ca6addc62c8f2405069036744e4a0ea33f
+
+pkgname = kdenlive-appimage-pure
diff --git a/pkgs/kdenlive-appimage-pure/PKGBUILD b/pkgs/kdenlive-appimage-pure/PKGBUILD
@@ -0,0 +1,64 @@
+# Maintainer: xifan <xifan2333@gmail.com>
+
+pkgname=kdenlive-appimage-pure
+_pkgname=kdenlive
+pkgver=25.08.2
+pkgrel=1
+pkgdesc="A non-linear video editor for Linux using the MLT video framework (AppImage build)"
+arch=('x86_64')
+url="https://www.kdenlive.org"
+license=('GPL')
+provides=("$_pkgname")
+conflicts=("$_pkgname")
+depends=('fuse2')
+options=(!strip)
+_filename="${_pkgname}-${pkgver}-${arch}.AppImage"
+_folder="${pkgver%.*}"
+source_x86_64=("kdenlive-25.08.2-x86_64.AppImage::https://download.kde.org/stable/kdenlive/25.08/linux/kdenlive-25.08.2-x86_64.AppImage")
+sha256sums_x86_64=('81f83c9518176224fad81bfc4f47e4ca6addc62c8f2405069036744e4a0ea33f')
+
+prepare() {
+	cd "${srcdir}"
+	chmod +x "${_filename}"
+	if [[ ! -d squashfs-root ]]; then
+		"./${_filename}" --appimage-extract >/dev/null
+	fi
+}
+
+package() {
+	cd "${srcdir}"
+
+	local appdir="${pkgdir}/opt/appimages/${_pkgname}"
+	install -d "${appdir}"
+	install -Dm755 "${_filename}" "${appdir}/${_filename}"
+
+	install -Dm755 /dev/stdin "${pkgdir}/usr/bin/${_pkgname}" <<EOF
+#!/bin/sh
+exec /opt/appimages/${_pkgname}/${_filename} "\$@"
+EOF
+
+	if [[ -d squashfs-root/usr/share/icons/hicolor ]]; then
+		while IFS= read -r -d '' icon; do
+			local rel="${icon#squashfs-root/usr/share/icons/hicolor/}"
+			local target_dir="${pkgdir}/usr/share/icons/hicolor/${rel%/*}"
+			local filename="${rel##*/}"
+			install -Dm644 "${icon}" "${target_dir}/${filename}"
+
+			case "${filename}" in
+				org.kde.kdenlive.*)
+					local ext="${filename##*.}"
+					install -Dm644 "${icon}" "${target_dir}/kdenlive.${ext}"
+					;;
+				kdenlive.*)
+					local ext="${filename##*.}"
+					install -Dm644 "${icon}" "${target_dir}/org.kde.kdenlive.${ext}"
+					;;
+			esac
+		done < <(find squashfs-root/usr/share/icons/hicolor -type f \( -name 'kdenlive.*' -o -name 'org.kde.kdenlive.*' \) -print0)
+	fi
+
+	if [[ -f squashfs-root/usr/share/applications/org.kde.kdenlive.desktop ]]; then
+		install -Dm644 squashfs-root/usr/share/applications/org.kde.kdenlive.desktop \
+			"${pkgdir}/usr/share/applications/org.kde.kdenlive.desktop"
+	fi
+}
diff --git a/pkgs/kdenlive-appimage-pure/upstream.sh b/pkgs/kdenlive-appimage-pure/upstream.sh
diff --git a/scripts/build-readme.sh b/scripts/build-readme.sh
diff --git a/scripts/update-package.sh b/scripts/update-package.sh
