ci: 统一 Debian 发布为 stable 发行版并更新相关文档

- 去除多发行版支持（bookworm、trixie），改为 stable 单一发行版 - 更新 CI 配置：Debian 包统一上传到 debian/pool/stable/main - 简化 Release 说明生成脚本 - 更新安装指南、发布指南和 CI/CD 架构文档 - 补充系统设计和配置参考文档
2025-12-25 10:55:04 +08:00
parent b13d06aae7
commit b491d8af32
9 changed files with 112 additions and 100 deletions
--- a/.gitea/workflows/ci.yaml
+++ b/.gitea/workflows/ci.yaml
@@ -130,29 +130,19 @@ jobs:
            }
          done

-          # 上传 Debian 包到 Debian Package Registry (支持多个发行版)
+          # 上传 Debian 包到 Debian Package Registry (通用稳定版)
          echo ""
          echo "📦 上传 Debian 包到 Debian Package Registry..."
          for file in *.deb; do
            [ ! -f "$file" ] && continue

-            # 上传到 bookworm (Debian 12)
-            echo "  ⬆️  $file → bookworm"
+            # 上传到 stable (通用稳定版)
+            echo "  ⬆️  $file → stable"
            curl -fsSL -X PUT \
              -H "Authorization: token ${TOKEN}" \
              --upload-file "$file" \
-              "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/bookworm/main/upload" || {
-              echo "❌ Debian 包上传失败: $file (bookworm)"
-              exit 1
-            }
-
-            # 上传到 trixie (Debian 13)
-            echo "  ⬆️  $file → trixie"
-            curl -fsSL -X PUT \
-              -H "Authorization: token ${TOKEN}" \
-              --upload-file "$file" \
-              "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/trixie/main/upload" || {
-              echo "❌ Debian 包上传失败: $file (trixie)"
+              "https://${REGISTRY}/api/packages/${OWNER}/debian/pool/stable/main/upload" || {
+              echo "❌ Debian 包上传失败: $file (stable)"
              exit 1
            }
          done
@@ -162,7 +152,7 @@ jobs:
          echo "📝 生成 Release..."

          export REGISTRY OWNER TAG
-          RELEASE_DATA=$(python3 -c 'import json,glob,os;r=os.environ["REGISTRY"];o=os.environ["OWNER"];p=os.environ["PRODUCT_NAME"];t=os.environ["TAG"];b=["## Release "+t,"","Mond 是 Monero 守护进程 (monerod) 的定制版本。","","### ✨ 主要特性","","- 🔗 **纯静态链接** - 无需依赖，可在任意 Linux 系统运行","- 🏗️ **多架构支持** - 原生支持 AMD64 和 ARM64","- 📦 **官方构建系统** - 使用 Monero 官方 depends 系统构建，确保可靠性","","### 📥 下载方式","","#### 方式一：直接下载（推荐）","","点击下方 **Assets** 区域的文件名直接下载。","","**可用安装包：**",""]+[f"- [`{f}`](https://{r}/api/packages/{o}/generic/{p}/{t}/{f})" for f in sorted(glob.glob("*.tar.gz"))]+["","#### 方式二：通用软件包仓库","","通过命令行下载：",""]+[f"```bash\nwget https://{r}/api/packages/{o}/generic/{p}/{t}/{f}\n```" for f in sorted(glob.glob("*.tar.gz"))[:1]]+["","#### 方式三：Debian 软件源","","**Debian 12 (Bookworm)：**","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian bookworm main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```","","**Debian 13 (Trixie)：**","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian trixie main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```"];print(json.dumps({"tag_name":t,"name":f"Release {t}","body":"\n".join(b),"draft":False,"prerelease":False}))')
+          RELEASE_DATA=$(python3 -c 'import json,glob,os;r=os.environ["REGISTRY"];o=os.environ["OWNER"];p=os.environ["PRODUCT_NAME"];t=os.environ["TAG"];b=["## Release "+t,"","Mond 是 Monero 守护进程 (monerod) 的定制版本。","","### ✨ 主要特性","","- 🔗 **纯静态链接** - 无需依赖，可在任意 Linux 系统运行","- 🏗️ **多架构支持** - 原生支持 AMD64 和 ARM64","- 📦 **官方构建系统** - 使用 Monero 官方 depends 系统构建，确保可靠性","","### 📥 下载方式","","#### 方式一：直接下载（推荐）","","点击下方 **Assets** 区域的文件名直接下载。","","**可用安装包：**",""]+[f"- [`{f}`](https://{r}/api/packages/{o}/generic/{p}/{t}/{f})" for f in sorted(glob.glob("*.tar.gz"))]+["","#### 方式二：通用软件包仓库","","通过命令行下载：",""]+[f"```bash\nwget https://{r}/api/packages/{o}/generic/{p}/{t}/{f}\n```" for f in sorted(glob.glob("*.tar.gz"))[:1]]+["","#### 方式三：Debian 软件源","","```bash","# 下载 GPG 密钥",f"sudo curl https://{r}/api/packages/{o}/debian/repository.key -o /etc/apt/keyrings/gitea-{o}.asc","","# 添加软件源",f"echo \"deb [signed-by=/etc/apt/keyrings/gitea-{o}.asc] https://{r}/api/packages/{o}/debian stable main\" | sudo tee -a /etc/apt/sources.list.d/{o}.list","","# 更新并安装","sudo apt-get update","sudo apt-get install mond","```"];print(json.dumps({"tag_name":t,"name":f"Release {t}","body":"\n".join(b),"draft":False,"prerelease":False}))')

          # 创建 Release
          echo ""
--- a/README.md
+++ b/README.md
@@ -16,36 +16,16 @@

 ## 🚀 快速开始

-### 方式一：Debian/Ubuntu（推荐）
-
-#### Debian 12 (Bookworm)
+### Debian/Ubuntu（推荐）

 ```bash
-# 1. 下载并添加 GPG 密钥
-sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \
-  -o /etc/apt/keyrings/gitea-wangdefa.asc
+# 下载 GPG 密钥
+sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key -o /etc/apt/keyrings/gitea-wangdefa.asc

-# 2. 添加软件源
-echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian bookworm main" | \
-  sudo tee -a /etc/apt/sources.list.d/wangdefa.list
+# 添加仓库
+echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian stable main" | sudo tee -a /etc/apt/sources.list.d/wangdefa.list

-# 3. 安装
-sudo apt-get update
-sudo apt-get install mond
-```
-
-#### Debian 13 (Trixie)
-
-```bash
-# 1. 下载并添加 GPG 密钥
-sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \
-  -o /etc/apt/keyrings/gitea-wangdefa.asc
-
-# 2. 添加软件源
-echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian trixie main" | \
-  sudo tee -a /etc/apt/sources.list.d/wangdefa.list
-
-# 3. 安装
+# 更新并安装
 sudo apt-get update
 sudo apt-get install mond
 ```
@@ -54,10 +34,10 @@ sudo apt-get install mond

 ```bash
 # 1. 下载对应架构的包
-wget https://gitea.bcde.io/releases/download/VERSION/mond-amd64-ubuntu-VERSION.tar.gz
+wget https://gitea.bcde.io/releases/download/v0.18.4.4/mond-amd64-ubuntu-v0.18.4.4.tar.gz

 # 2. 解压
-tar -xzf mond-amd64-ubuntu-VERSION.tar.gz
+tar -xzf mond-amd64-ubuntu-v0.18.4.4.tar.gz

 # 3. 运行
 ./mond --help
--- a/llmdoc/architecture/cicd-pipeline.md
+++ b/llmdoc/architecture/cicd-pipeline.md
@@ -27,12 +27,12 @@
 ### 发布流程
 1. **标签创建：** 手动或自动创建语义化版本标签
 2. **构建制品：**
-   - 多架构 Docker 镜像
-   - Debian 包
+   - 多架构 Debian 包（amd64, arm64）
   - 二进制可执行文件
 3. **发布到：**
-   - GitHub/Gitea Release
-   - 包管理仓库
+   - Gitea Release（附件形式）
+   - Generic Package Registry（通用软件包仓库）
+   - Debian Package Registry（stable 发行版）

 ## 4. 设计原理

--- a/llmdoc/architecture/system-design.md
+++ b/llmdoc/architecture/system-design.md
@@ -0,0 +1,29 @@
+# Mond 架构设计
+
+## 1. 组件概览
+
+- 主守护进程二进制文件
+- 项目初始化和定制脚本
+- 多架构构建配置
+
+## 2. 核心文件类型
+
+- 源代码文件
+- 构建脚本
+- Docker 构建配置
+- CMake 配置文件
+
+## 3. 构建流程
+
+1. **源代码准备**：克隆 Monero 源代码
+2. **定制应用**：替换 Monero 特定标识符
+3. **依赖构建**：使用 Monero 的 depends 系统
+4. **编译**：使用 CMake 和 Make 构建
+5. **打包**：生成多架构二进制和 Debian 包
+
+## 4. 关键设计决策
+
+- 使用纯静态链接以提高可移植性
+- 支持多架构（AMD64、ARM64）
+- 保留原始 Monero 核心功能
+- 简化安装和配置过程
--- a/llmdoc/guides/how-to-install.md
+++ b/llmdoc/guides/how-to-install.md
@@ -3,38 +3,19 @@
 ## 支持的平台

 Mond 支持以下平台和安装方式：
- Debian 12 (Bookworm)
- Debian 13 (Trixie)
+- Debian stable
 - Ubuntu 最新 LTS 版本
 - 通用 Linux 二进制包（支持 AMD64 和 ARM64）

 ## 方式一：Debian/Ubuntu 安装（推荐）

-### Debian 12 (Bookworm)
-
 ```bash
 # 1. 下载并添加 GPG 密钥
 sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \
  -o /etc/apt/keyrings/gitea-wangdefa.asc

 # 2. 添加软件源
-echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian bookworm main" | \
-  sudo tee -a /etc/apt/sources.list.d/wangdefa.list
-
-# 3. 安装
-sudo apt-get update
-sudo apt-get install mond
-```
-
-### Debian 13 (Trixie)
-
-```bash
-# 1. 下载并添加 GPG 密钥
-sudo curl https://gitea.bcde.io/api/packages/wangdefa/debian/repository.key \
-  -o /etc/apt/keyrings/gitea-wangdefa.asc
-
-# 2. 添加软件源
-echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian trixie main" | \
+echo "deb [signed-by=/etc/apt/keyrings/gitea-wangdefa.asc] https://gitea.bcde.io/api/packages/wangdefa/debian stable main" | \
  sudo tee -a /etc/apt/sources.list.d/wangdefa.list

 # 3. 安装
--- a/llmdoc/guides/how-to-release.md
+++ b/llmdoc/guides/how-to-release.md
@@ -38,17 +38,17 @@ git push origin v1.2.3
 ## 4. 包管理仓库上传

 ### 自动上传
- CI 流水线将自动处理
- 触发条件：新的版本标签推送
+CI 流水线将自动上传到以下位置：
+- **Generic Package Registry**：通用软件包仓库
+- **Debian Package Registry**：stable 发行版

-### 手动上传（备选）
-```bash
-# 构建 Debian 包
-./debian/build-deb.sh
+触发条件：新的版本标签推送

-# 上传到包仓库
-dput ppa:your-ppa-name/mond mond_1.2.3_amd64.changes
-```
+### 上传目标
+所有 Debian 包统一上传到：
+- 发行版：stable
+- 组件：main
+- 路径：`debian/pool/stable/main`

 ## 5. 发布后验证

--- a/llmdoc/index.md
+++ b/llmdoc/index.md
@@ -1,20 +1,21 @@
-# Mond 项目文档
+# Mond 文档

-## 概述
-Mond 是一个基于 Monero 的区块链项目，专注于隐私和去中心化。
+## 概览

-## 文档导航
+[项目概述](/overview/project-overview.md)

-### 项目概览
- [项目背景](/overview/project-overview.md)
- [系统配置参考](/reference/configuration.md)
+## 指南

-### 构建指南
- [如何构建项目](/guides/how-to-build.md)
+- [安装指南](/guides/installation.md)

-### 架构
- [构建系统](/architecture/build-system.md)
+## 架构

-### 参考
- [常见问题](/reference/faq.md)
- [配置文件详解](/reference/configuration.md)
+- [系统设计](/architecture/system-design.md)
+
+## 参考资料
+
+- [配置参考](/reference/configuration-reference.md)
+
+## 许可证
+
+本文档遵循 BSD-3-Clause 许可证，与 Mond 项目保持一致。
--- a/llmdoc/overview/project-overview.md
+++ b/llmdoc/overview/project-overview.md
@@ -1,12 +1,19 @@
-# Mond 项目概览
+# Mond: Monero Daemon 定制版

-## 1. 项目定位
+## 1. 身份

-Mond 是一个基于 Monero 区块链技术的开源项目，专注于提供更加安全、私密的去中心化交易解决方案。
+- **定义**：Monero 守护进程的定制开源实现
+- **目的**：提供高度可移植、易于部署的 Monero 节点解决方案

-## 2. 核心特点
+## 2. 高级描述

- 高度私密的交易机制
- 基于 Monero 核心技术
- 跨平台支持（Ubuntu, Alpine Linux, amd64/arm64）
- 灵活的构建系统
+Mond 是基于 Monero 项目的定制守护进程实现，专注于多架构支持、简化部署和增强可移植性。通过纯静态链接和多种安装方式，Mond 为不同 Linux 环境中运行 Monero 节点提供了灵活的选择。
+
+## 3. 关键特性
+
+- 多架构支持（AMD64、ARM64）
+- 多发行版兼容（Ubuntu、Debian）
+- 纯静态链接
+- 灵活的安装和配置选项
+- 隐私保护
+- 自动更新支持
--- a/llmdoc/reference/configuration-reference.md
+++ b/llmdoc/reference/configuration-reference.md
@@ -0,0 +1,24 @@
+# Mond 参考信息
+
+## 核心摘要
+
+Mond 是 Monero 守护进程的定制开源实现，提供高度可配置和可移植的 Monero 节点解决方案。
+
+## 关键信息源
+
+- **源代码库**：https://github.com/monero-project/monero
+- **官方网站**：未定义（本项目为定制版）
+- **授权协议**：BSD-3-Clause
+
+## 配置选项参考
+
+### 常用命令行参数
+
+- `--data-dir <path>`：指定数据目录
+- `--log-file <path>`：指定日志文件路径
+- `--log-level <level>`：日志级别（0-4）
+- `--detach`：后台运行
+- `--rpc-bind-ip <ip>`：RPC 绑定 IP
+- `--rpc-bind-port <port>`：RPC 绑定端口
+- `--p2p-bind-ip <ip>`：P2P 绑定 IP
+- `--p2p-bind-port <port>`：P2P 绑定端口