feat(debian): 添加 DEB 包构建和发布工作流及相关文件

pkg/DEB-CI.md

@@ -0,0 +1,103 @@
+# DEB Package CI/CD
+
+本文档说明了 chsrc 项目的 DEB 包自动构建和发布流程。
+
+## 自动触发
+
+DEB 包构建 CI 会在以下情况下自动触发：
+
+1. **Release 事件**: 当创建新的 release 时自动构建并上传 DEB 包到 release assets
+2. **手动触发**: 可以在 GitHub Actions 页面手动触发构建
+
+## 支持的架构
+
+当前支持以下架构的 DEB 包构建：
+
+- `amd64` (x86_64)
+- `arm64` (aarch64) 
+- `armhf` (ARMv7)
+
+## 构建产物
+
+每次构建会生成：
+
+1. **DEB 包文件**: `chsrc_<version>-1_<arch>.deb`
+2. **仓库元数据**: `Packages` 和 `Packages.gz` 文件用于创建 APT 仓库
+
+## 本地测试
+
+### 构建 DEB 包
+
+```bash
+# 准备构建环境
+sudo apt-get install build-essential debhelper devscripts fakeroot
+
+# 构建包
+make deb-build
+
+# 清理构建产物
+make deb-clean
+```
+
+### 测试安装
+
+```bash
+# 安装生成的包
+sudo dpkg -i ../chsrc_*.deb
+sudo apt-get install -f  # 修复依赖问题
+
+# 运行测试
+./test/deb-test.sh
+
+# 卸载
+sudo apt-get remove chsrc
+```
+
+## 文件结构
+
+```
+debian/
+├── changelog      # 版本更新日志
+├── compat         # debhelper 兼容性版本
+├── control        # 包控制信息和依赖
+├── copyright      # 版权信息
+├── postinst       # 安装后脚本
+├── prerm          # 卸载前脚本
+└── rules          # 构建规则
+```
+
+## 手动发布流程
+
+1. 确保所有代码已合并到主分支
+2. 更新版本号和 changelog
+3. 创建并推送 git tag: `git tag v1.2.3 && git push origin v1.2.3`
+4. 在 GitHub 上创建 release
+5. CI 将自动构建并上传 DEB 包
+
+## 故障排查
+
+### 常见问题
+
+1. **构建失败**: 检查 debian/control 中的依赖是否正确
+2. **交叉编译失败**: 确认目标架构的工具链已正确安装
+3. **安装测试失败**: 检查 postinst 脚本是否有错误
+
+### 调试构建
+
+```bash
+# 启用详细输出
+DEB_BUILD_OPTIONS="nocheck" debuild -us -uc -b
+
+# 检查构建日志
+less ../chsrc_*.build
+
+# 检查包内容
+dpkg-deb --contents chsrc_*.deb
+```
+
+## 相关文件
+
+- `.github/workflows/pkg-deb.yml` - CI 工作流配置
+- `debian/` - Debian 包配置目录
+- `test/deb-test.sh` - DEB 包功能测试脚本
+- `pkg/DEB-INSTALL.md` - 用户安装指南

pkg/DEB-INSTALL.md

@@ -0,0 +1,77 @@
+# DEB Package Installation
+
+## Installing from Release
+
+1. Download the appropriate DEB package from the [releases page](https://github.com/RubyMetric/chsrc/releases)
+2. Install using dpkg:
+   ```bash
+   sudo dpkg -i chsrc_*.deb
+   sudo apt-get install -f  # Fix any dependency issues
+   ```
+
+## Building from Source
+
+### Prerequisites
+
+Install the required build dependencies:
+
+```bash
+sudo apt-get update
+sudo apt-get install build-essential debhelper devscripts fakeroot
+```
+
+### Building the Package
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/RubyMetric/chsrc.git
+   cd chsrc
+   ```
+
+2. Build the DEB package:
+   ```bash
+   make deb-build
+   ```
+
+3. Install the generated package:
+   ```bash
+   sudo dpkg -i ../chsrc_*.deb
+   ```
+
+### Cross-compilation
+
+To build for different architectures:
+
+```bash
+# For ARM64
+CC=aarch64-linux-gnu-gcc dpkg-buildpackage -us -uc -b -aarm64
+
+# For ARMv7 (armhf)
+CC=arm-linux-gnueabihf-gcc dpkg-buildpackage -us -uc -b -aarmhf
+```
+
+### Cleaning Build Artifacts
+
+```bash
+make deb-clean
+```
+
+## Package Information
+
+- **Package Name**: chsrc
+- **Architecture**: amd64, arm64, armhf
+- **Dependencies**: Standard C library
+- **Installation Path**: `/usr/bin/chsrc`
+- **Manual Page**: `/usr/share/man/man1/chsrc.1`
+
+## Uninstalling
+
+```bash
+sudo apt-get remove chsrc
+```
+
+Or completely remove including configuration:
+
+```bash
+sudo apt-get purge chsrc
+```