Merge remote-tracking branch 'refs/remotes/origin/master'

2026-02-04 10:11:36 +08:00 · 2025-12-27 18:51:00 +08:00
parent 31a38e66dc 2568548873
commit 285508a92c
10 changed files with 478 additions and 173 deletions
--- a/Packaging-demo/README.md
+++ b/Packaging-demo/README.md
@@ -1,16 +1,19 @@
+
+
 # APM 软件包打包流程

-本文档为开发者准备，若您只是想从 deb 软件包打包 APM 软件包，您可以通过 `amber-pm-convert`指令进行全自动一键转换
+本文档为开发者准备，若您只是想从 deb 软件包打包 APM 软件包，您可以通过 `amber-pm-convert` 指令进行全自动一键转换。

-通过 `apm search amber-pm- ` 即可搜索到所有可用的 base 列表
+通过 `apm search amber-pm-` 即可搜索到所有可用的 base 列表。

 ---

 ## APM 软件包结构规范

-在阅读前，请确保您对overlayfs有了基本的了解
+在阅读前，请确保您对 OverlayFS 有了基本的了解。

-overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html
+OverlayFS 原理解析：
+[https://www.cnblogs.com/arnoldlu/p/13055501.html](https://www.cnblogs.com/arnoldlu/p/13055501.html)

 ---

@@ -18,16 +21,25 @@ overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html

 APM 使用 OverlayFS 来管理软件包的文件系统层级，从上到下的层叠顺序为：

-1. **Upperdir** - 当前包的可写层 `files/core/`
-2. **Info Layer Override** - 覆盖层指定的目录（位于所有依赖层之上）
-3. **依赖层** - 从 `info` 文件递归解析出的所有依赖包
-3. **底层** - 最基础的运行时环境
+1. **Upperdir**
+   当前包的可写层：`files/core/`

-这种层叠结构允许上层文件覆盖下层文件，实现依赖管理和自定义覆盖。
+2. **Info Layer Override**
+   由 `info_layer_override` 指定的覆盖层，位于所有依赖层之上
+
+3. **依赖层**
+   由 `info` 文件递归解析出的所有依赖包
+
+4. **底层 Runtime**
+   最基础的运行时环境（如 `amber-pm-bookworm`）
+
+这种层叠结构允许上层文件覆盖下层文件，实现灵活、高效的依赖管理与环境定制。

 ---

-一个典型的 APM 软件/中层依赖包应当包含以下内容
+## APM 软件包目录结构示例
+
+一个典型的 APM 应用或中层依赖包应当包含以下内容：

 ```
 ├── DEBIAN
@@ -41,20 +53,23 @@ APM 使用 OverlayFS 来管理软件包的文件系统层级，从上到下的
                │   ├── applications
                │   ├── doc
                │   ├── glib-2.0
-│   │   └── man
-│   ├── files
-│   │   ├── core
-│   │   └── work
+                │   └── man
+                ├── files
+                │   ├── core
+                │   └── work
                ├── info
-                └── info_layer_override  # 可选，用于自定义覆盖层
-
+                ├── info_layer_override    # 可选
+                └── info_env               # 可选（高级功能）
 ```

-### DEBIAN 目录
+---

-包含软件包的基本信息和依赖的环境信息
+## DEBIAN 目录说明
+
+包含软件包的基本信息和依赖环境声明。
+
+### control 文件示例

-**control 文件示例：**
 ```
 Package: eom
 Version: 1.26.0-2-apm
@@ -63,18 +78,34 @@ Maintainer: APM Converter <apm-convert@spark-app.store>
 Depends: amber-pm-bookworm
 Installed-Size: 45228
 Description: APM converted package from eom
-  This package was automatically converted from the original deb package.
-  Based on: amber-pm-bookworm
+ This package was automatically converted from the original deb package.
+ Based on: amber-pm-bookworm
 ```

- **Package**: 包名，应当唯一。若使用转换器进行转换，默认和原包名一致
- **Version**: 版本号。若使用转换器进行转换，默认在原版本号后加 `-apm`
- **Architecture**: 软件包架构，同 dpkg 规范填写
- **Depends**: 直接依赖的 base 包名
- **Installed-Size**: 安装后的大小，转换器会自动计算
- **Description**: 包描述，转换器会自动填写
+字段说明：
+
+* **Package**
+  包名，应当唯一。使用转换器时默认与原 deb 包名一致
+
+* **Version**
+  软件包版本号，转换器会自动追加 `-apm`
+
+* **Architecture**
+  架构信息，遵循 dpkg 规范
+
+* **Depends**
+  直接依赖的 base 包名
+
+* **Installed-Size**
+  安装后大小，转换器自动计算
+
+* **Description**
+  软件包描述信息
+
+---
+
+### postinst 文件

-**postinst 文件内容：**
 ```
 #!/bin/bash
 PACKAGE_NAME="$DPKG_MAINTSCRIPT_PACKAGE"
@@ -82,121 +113,268 @@ PACKAGE_NAME="$DPKG_MAINTSCRIPT_PACKAGE"
 if [ "$1" = "remove" ] || [ "$1" = "purge" ]; then
    echo "清理卸载残留"
    rm -rf "/var/lib/apm/$PACKAGE_NAME"
-for username in $(ls /home)
-    do
-        echo /home/$username
-        if [ -d "/home/$username/.apm/$PACKAGE_NAME" ]
-        then
-            rm -fr "/home/$username/.apm/$PACKAGE_NAME"
+
+    for username in $(ls /home); do
+        if [ -d "/home/$username/.apm/$PACKAGE_NAME" ]; then
+            rm -rf "/home/$username/.apm/$PACKAGE_NAME"
        fi
-done
+    done
 else
    echo "非卸载，跳过清理"
 fi
 ```

-若无特殊需求，内容保持一致即可，用于在卸载软件包后清理环境。
+若无特殊需求，保持该内容即可，用于卸载时清理残留环境。

-### /var/lib/apm 目录结构
+---

-包含 APM 软件容器的文件和信息：
+## /var/lib/apm 目录结构说明

- **entries** (可选)：包含需要放置到 `/usr/share/` 的文件，如 desktop、icon 等
- **files** (必须)：包含软件包的 upperdir 和 workdir
- **info** (必须)：包含直接依赖的 base 信息。若应用使用了多层的依赖，会一层一层寻找 info 信息，直到找到底层依赖。如填写 amber-pm-bookworm-spark-wine10 会自动解析出 amber-pm-bookworm
- **info_layer_override** (可选)：用于指定自定义覆盖层的目录
+该目录包含 APM 软件包的运行环境与元数据。

-> 关于 Info: 使用多层的依赖并不是必须的，即使不使用也可以正常打包，但恰当地使用多层依赖可大大降低包体积。 可用的多层依赖见 `apm search amber-pm-[base名称]- ` 。若有必要，可申请新增 base 
+### 必须目录

+* **files/**

-**entries 目录说明：**
- `entries/applications`：存放 `.desktop` 文件
- `entries/doc`：存放文档
- `entries/glib-2.0`：存放 GLib 相关文件
- `entries/man`：存放帮助文档
+  * `core/`：upperdir，可写层
+  * `work/`：OverlayFS 工作目录

-> **重要提示**：`.desktop` 文件应当添加一行 `X-APM-APPID=包名` 来允许软件管理器管理应用
+* **info**

-### info_layer_override 文件
+  * 声明直接依赖的 base 包
+  * 支持多层递归解析

-`info_layer_override` 是一个可选文件，用于在当前包的依赖层之上插入额外的覆盖层。这个功能在以下场景特别有用：
+### 可选目录 / 文件

-1. **自定义库版本**：覆盖依赖包中的特定库文件，如你想要用更新版本的 mesa 覆盖 debian 默认提供的版本作为运行环境
-2. **配置文件自定义**：使用自定义配置覆盖默认配置
- **语法**：与 `info` 文件一致，每行一个包名
- **层叠位置**：位于所有依赖层之上、当前包的 upperdir 之下
- **文件位置**：`${PATH_PREFIX}/var/lib/apm/${coredir}/info_layer_override`
+* **entries/**

-**示例：**
-假设您想用自定义的 `override-layer` 包来覆盖 `base-package` 中的某些文件：
+  * `applications/`：`.desktop` 文件
+  * `doc/`：文档
+  * `glib-2.0/`：GLib 相关文件
+  * `man/`：手册页
+
+> ⚠ `.desktop` 文件中 **必须** 添加：
+>
+> ```
+> X-APM-APPID=包名
+> ```
+>
+> 以允许软件管理器正确识别和管理应用。
+
+---
+
+## info 文件说明（依赖解析）
+
+`info` 文件用于声明当前包直接依赖的 base 包，每行一个包名：
+
+```
+amber-pm-bookworm-spark-wine10
+```
+
+APM 会递归解析该 base 的 `info` 文件，直到找到最底层 runtime（如 `amber-pm-bookworm`）。
+
+> 使用多层依赖并非强制，但合理拆分 base 能显著减小包体积。
+> 可用的 base 列表可通过：
+>
+> ```
+> apm search amber-pm-
+> ```
+>
+> 查看。
+
+---
+
+## info_layer_override 文件（覆盖层）
+
+`info_layer_override` 是一个可选文件，用于在**所有依赖层之上**插入额外覆盖层。
+
+### 使用场景
+
+1. 覆盖依赖中的特定库版本（如 mesa）
+2. 覆盖默认配置文件
+3. 提供特殊运行环境
+
+### 规则说明
+
+* 语法与 `info` 完全一致
+* 每行一个包名
+* 层级位置：
+
+  ```
+  upperdir
+    ↑
+  info_layer_override
+    ↑
+  info 递归依赖
+  ```
+
+### 示例
+
+`info`：

-`my-package/info` 内容：
 ```
 amber-pm-bookworm
 ```

-`my-package/info_layer_override` 内容：
+`info_layer_override`：
+
 ```
 amber-pm-bookworm-mesa
 ```

-最终的挂载 lowerdir 为：`amber-pm-bookworm-mesa:amber-pm-bookworm`
+最终 lowerdir 顺序：

-这样，`override-layer` 中的文件会覆盖 `base-package` 中的同名文件（除非当前包的 upperdir 中也有该文件）。
-
-## APM upperdir 制作流程
-
-以下为手动制作 upperdir 的流程：
-
-1. **安装依赖**：首先安装 apm 并使用 `sudo apm install` 安装所需的 base
-
-2. **创建目录结构**：
-```bash
-mkdir -p core work ace-env
+```
+amber-pm-bookworm-mesa:amber-pm-bookworm
 ```

-3. **挂载 overlay**：
-```bash
-sudo mount -t overlay overlay \
-  -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/base包的包名（如amber-pm-trixie）/files/ace-env',upperdir=core/,workdir=work/ ./ace-env
+---
+
+## info_env（环境变量层 · 高级功能）
+
+`info_env` 是一个 **可选的高级特性**，用于为 APM 容器运行时提供**分层的环境变量配置能力**。
+
+### 功能概述
+
+* 为软件包及其依赖提供环境变量
+* 支持 **多层叠加**
+* **上层自动覆盖下层**
+* 与 OverlayFS 层级顺序完全一致
+* 不执行 shell 代码，仅解析键值对，安全可靠
+
+---
+
+### info_env 文件位置
+
+```
+/var/lib/apm/<包名>/info_env
 ```

-4. **chroot 安装**：chroot 进入 `./ace-env` 进行安装操作，可以使用 `apt install` 或其他方式
+---

-5. **卸载并打包**：完成后解除挂载 `./ace-env`
+### info_env 应用顺序（重要）

-您将得到：
- **core**：保存新增文件
- **work**：保存变更信息
+环境变量的加载顺序为：

-将这两个目录权限设置为 755 后放入对应的目录进行 apm 打包。
+1. 底层 runtime 的 `info_env`
+2. 中间依赖包的 `info_env`
+3. 当前包的 `info_env`
+4. `info_layer_override` 中包的 `info_env`（最高优先级）
+
+**后加载的变量会覆盖之前的同名变量。**
+
+---
+
+### info_env 文件格式
+
+每行一条环境变量定义：
+
+```
+KEY=VALUE
+```
+
+示例：
+
+```
+QT_QPA_PLATFORM=dxcb;xcb
+LANG=zh_CN.UTF-8
+XMODIFIERS="@im=fcitx"
+PATH="/custom/bin:$PATH"
+```
+
+#### 规则说明
+
+* 支持分号 `;`
+* 支持带引号的值
+* 支持引用已有环境变量（如 `$PATH`）
+* 支持注释行（`#`）
+* 不允许执行任何 shell 语句
+
+❌ 以下内容将被忽略：
+
+```
+export A=1
+rm -rf /
+$(whoami)
+```
+
+---
+
+### 使用场景示例
+
+* 指定 Qt / GTK 平台插件
+* 设置输入法变量
+* 调整运行时 PATH / LD_LIBRARY_PATH
+* 为特定应用注入兼容性环境变量
+
+---
+
+## APM upperdir 制作流程（手动）
+
+1. 安装 APM 并安装所需 base：
+
+   ```bash
+   sudo apm install amber-pm-xxx
+   ```
+
+2. 创建目录结构：
+
+   ```bash
+   mkdir -p core work ace-env
+   ```
+
+3. 挂载 OverlayFS：
+
+   ```bash
+   sudo mount -t overlay overlay \
+     -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/amber-pm-xxx/files/ace-env',upperdir=core/,workdir=work/ \
+     ./ace-env
+   ```
+
+4. chroot 进入 `ace-env` 进行安装
+
+5. 卸载并打包
+
+---

 ## APM 软件包测试

-您可以测试刚刚打包的软件：
-
 ```bash
-fuse-overlayfs -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/base包的包名（如amber-pm-trixie）/files/ace-env',upperdir=core/,workdir=work/ ./ace-env
+fuse-overlayfs -o lowerdir='...',upperdir=core/,workdir=work/ ./ace-env
 ```

-即可只读挂载。`apm run 包名` 会自动完成：
- 寻找 `/var/lib/apm/包名/` 是否存在
- 根据 `info` 文件（和可选的 `info_layer_override`）合成 fuse-overlayfs 参数进行挂载
- 使用 ACE 工具 chroot 进入并启动应用
+或直接使用：

-使用 `./ace-run` 即可进入容器环境，测试您安装的应用。
+```bash
+apm run 包名
+```

-## APM 打包
+APM 会自动完成：
+
+* 解析 `info` / `info_layer_override`
+* 应用 `info_env`
+* 构建 OverlayFS
+* 进入容器并运行应用
+
+---
+
+## APM 软件包打包

-使用以下命令进行打包：
 ```bash
 dpkg-deb --build 软件包目录 输出目录
 ```

-## APM 底层 Base Runtime 的构建
+---

-详见 https://gitee.com/amber-ce/amber-pm-common
+## APM 底层 Base Runtime 构建
+
+详见：
+[https://gitee.com/amber-ce/amber-pm-common](https://gitee.com/amber-ce/amber-pm-common)

 ---

-**备注**：APM 打包工具和转换器会为您自动处理大部分复杂操作，手动打包主要用于特殊情况或自定义需求。
+### 备注
+
+APM 的打包工具与转换器会自动处理绝大多数复杂操作。
+手动打包与 `info_env` 主要用于 **特殊运行环境、深度定制或调试用途**。
+
--- a/apm-dummy/DEBIAN/control
+++ b/apm-dummy/DEBIAN/control
@@ -1,5 +1,5 @@
 Package: apm
-Version: 1.1
+Version: 1.1.2
 Maintainer: shenmo <jifengshenmo@outlook.com>
 Priority: optional
 Section: utils
--- a/apm-dummy/usr/bin/amber-pm-dstore-patch
+++ b/apm-dummy/usr/bin/amber-pm-dstore-patch
@@ -98,7 +98,7 @@ function exec_link_clean(){
    find /usr/share/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/help -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/locale -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
-    find /usr/lib/$(gcc -dumpmachine)/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
+#    find /usr/lib/$(gcc -dumpmachine)/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/lib/mozilla/plugins -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/polkit-1/actions -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/fonts -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
--- a/build.config
+++ b/build.config
@@ -1 +1 @@
-@VERSION@=1.1.5
+@VERSION@=1.1.6
--- a/src/etc/apt/sources.list.d/apm.list
+++ b/src/etc/apt/sources.list.d/apm.list
@@ -0,0 +1,2 @@
+deb [signed-by=/etc/apt/trusted.gpg.d/apm.gpg] https://d.spark-app.store/apm-deb-source /
+# 上面这行配置可在4.1.2+版本普及后启用，可以做到分不同目录
--- a/src/etc/apt/trusted.gpg.d/apm.gpg
+++ b/src/etc/apt/trusted.gpg.d/apm.gpg
--- a/src/usr/bin/amber-pm-convert
+++ b/src/usr/bin/amber-pm-convert
@@ -233,7 +233,7 @@ log.debug "最终 lowerdir: $LOWERDIR"

 # 3. 进行融合挂载
 log.info "正在进行融合挂载..."
-sudo mount -t overlay overlay \
+sudo fuse-overlayfs \
    -o "lowerdir=$LOWERDIR,upperdir=$CRAFT_DIR/core/,workdir=$CRAFT_DIR/work/" \
    "$CRAFT_DIR/mergedir"

@@ -322,6 +322,7 @@ resolve_symlink() {
    echo "$file"
 }

+# 函数：交互式选择文件复制到entries目录（用于手动模式无DEB情况）
 # 函数：交互式选择文件复制到entries目录（用于手动模式无DEB情况）
 interactive_copy_entries() {
    local core_dir="$CRAFT_DIR/core"
@@ -330,13 +331,13 @@ interactive_copy_entries() {
    log.info "开始交互式选择文件复制到 entries 目录..."
    mkdir -p "$entries_dir/applications" "$entries_dir/icons"
    
-    # 查找桌面文件
+    # 查找桌面文件（保留完整路径）
    local desktop_files=()
    while IFS= read -r -d '' file; do
        [[ -f "$file" ]] && desktop_files+=("$file")
    done < <(find "$core_dir/usr/share" -name "*.desktop" -print0 2>/dev/null || true)
    
-    # 查找图标文件
+    # 查找图标文件（保留完整路径）
    local icon_files=()
    while IFS= read -r -d '' file; do
        [[ -f "$file" ]] && icon_files+=("$file")
@@ -347,8 +348,9 @@ interactive_copy_entries() {
        log.info "找到 ${#desktop_files[@]} 个桌面文件:"
        for i in "${!desktop_files[@]}"; do
            local file="${desktop_files[$i]}"
-            local filename=$(basename "$file")
-            echo "  $((i+1)). $filename"
+            # 显示完整路径（相对于 core_dir）
+            local relative_path="${file#$core_dir}"
+            echo "  $((i+1)). $relative_path"
            
            # 检查是否是符号链接
            if [ -L "$file" ]; then
@@ -357,7 +359,8 @@ interactive_copy_entries() {
                # 解析符号链接获取实际文件
                local resolved_file=$(resolve_symlink "$file" "$core_dir")
                if [ "$resolved_file" != "$file" ] && [ -f "$resolved_file" ]; then
-                    echo "      → 解析为: $(basename "$resolved_file")"
+                    local resolved_relative="${resolved_file#$core_dir}"
+                    echo "      → 解析为: $resolved_relative"
                    desktop_files[$i]="$resolved_file"
                fi
            fi
@@ -367,10 +370,22 @@ interactive_copy_entries() {
        read -r -p "请选择要复制的桌面文件编号（多个用逗号分隔，all=全部，none=跳过）: " desktop_choice
        
        if [[ "$desktop_choice" =~ ^[Aa][Ll][Ll]$ ]]; then
-            # 复制所有桌面文件到 entries/applications
+            # 复制所有桌面文件到 entries/applications，但保持目录结构
            for file in "${desktop_files[@]}"; do
-                local filename=$(basename "$file")
-                local dest_path="$entries_dir/applications/$filename"
+                local relative_path="${file#$core_dir}"
+                local dest_filename=$(basename "$file")
+                
+                # 如果文件在 applications 目录下，直接复制到 entries/applications
+                if [[ "$relative_path" == /usr/share/applications/* ]]; then
+                    local dest_path="$entries_dir/applications/$dest_filename"
+                else
+                    # 其他位置的桌面文件，保持相对路径结构
+                    local path_dir=$(dirname "$relative_path")
+                    local dest_dir="$entries_dir/applications$path_dir"
+                    mkdir -p "$dest_dir"
+                    local dest_path="$dest_dir/$dest_filename"
+                fi
+                
                cp -v "$file" "$dest_path"
                
                # 处理桌面文件内容
@@ -384,8 +399,19 @@ interactive_copy_entries() {
                if [[ "$choice" =~ ^[0-9]+$ ]] && [ "$choice" -ge 1 ] && [ "$choice" -le ${#desktop_files[@]} ]; then
                    local idx=$((choice-1))
                    local file="${desktop_files[$idx]}"
-                    local filename=$(basename "$file")
-                    local dest_path="$entries_dir/applications/$filename"
+                    local relative_path="${file#$core_dir}"
+                    local dest_filename=$(basename "$file")
+                    
+                    # 根据路径决定目标位置
+                    if [[ "$relative_path" == /usr/share/applications/* ]]; then
+                        local dest_path="$entries_dir/applications/$dest_filename"
+                    else
+                        local path_dir=$(dirname "$relative_path")
+                        local dest_dir="$entries_dir/applications$path_dir"
+                        mkdir -p "$dest_dir"
+                        local dest_path="$dest_dir/$dest_filename"
+                    fi
+                    
                    cp -v "$file" "$dest_path"
                    
                    # 处理桌面文件内容
@@ -406,8 +432,8 @@ interactive_copy_entries() {
        log.info "找到 ${#icon_files[@]} 个图标文件:"
        for i in "${!icon_files[@]}"; do
            local file="${icon_files[$i]}"
-            local filename=$(basename "$file")
-            echo "  $((i+1)). $filename"
+            local relative_path="${file#$core_dir}"
+            echo "  $((i+1)). $relative_path"
            
            # 检查是否是符号链接
            if [ -L "$file" ]; then
@@ -416,7 +442,8 @@ interactive_copy_entries() {
                # 解析符号链接获取实际文件
                local resolved_file=$(resolve_symlink "$file" "$core_dir")
                if [ "$resolved_file" != "$file" ] && [ -f "$resolved_file" ]; then
-                    echo "      → 解析为: $(basename "$resolved_file")"
+                    local resolved_relative="${resolved_file#$core_dir}"
+                    echo "      → 解析为: $resolved_relative"
                    icon_files[$i]="$resolved_file"
                fi
            fi
@@ -426,10 +453,23 @@ interactive_copy_entries() {
        read -r -p "请选择要复制的图标文件编号（多个用逗号分隔，all=全部，none=跳过）: " icon_choice
        
        if [[ "$icon_choice" =~ ^[Aa][Ll][Ll]$ ]]; then
-            # 复制所有图标文件到 entries/icons
+            # 复制所有图标文件到 entries/icons，保持目录结构
            for file in "${icon_files[@]}"; do
-                local filename=$(basename "$file")
-                local dest_path="$entries_dir/icons/$filename"
+                local relative_path="${file#$core_dir}"
+                local dest_filename=$(basename "$file")
+                
+                # 如果文件在 icons 主题目录下，直接复制到 entries/icons
+                if [[ "$relative_path" == /usr/share/icons/* ]] || 
+                   [[ "$relative_path" == /usr/share/pixmaps/* ]]; then
+                    local dest_path="$entries_dir/icons/$dest_filename"
+                else
+                    # 其他位置的图标文件，保持相对路径结构
+                    local path_dir=$(dirname "$relative_path")
+                    local dest_dir="$entries_dir/icons$path_dir"
+                    mkdir -p "$dest_dir"
+                    local dest_path="$dest_dir/$dest_filename"
+                fi
+                
                cp -v "$file" "$dest_path"
            done
        elif [[ ! "$icon_choice" =~ ^[Nn][Oo][Nn][Ee]$ ]] && [ -n "$icon_choice" ]; then
@@ -440,8 +480,20 @@ interactive_copy_entries() {
                if [[ "$choice" =~ ^[0-9]+$ ]] && [ "$choice" -ge 1 ] && [ "$choice" -le ${#icon_files[@]} ]; then
                    local idx=$((choice-1))
                    local file="${icon_files[$idx]}"
-                    local filename=$(basename "$file")
-                    local dest_path="$entries_dir/icons/$filename"
+                    local relative_path="${file#$core_dir}"
+                    local dest_filename=$(basename "$file")
+                    
+                    # 根据路径决定目标位置
+                    if [[ "$relative_path" == /usr/share/icons/* ]] || 
+                       [[ "$relative_path" == /usr/share/pixmaps/* ]]; then
+                        local dest_path="$entries_dir/icons/$dest_filename"
+                    else
+                        local path_dir=$(dirname "$relative_path")
+                        local dest_dir="$entries_dir/icons$path_dir"
+                        mkdir -p "$dest_dir"
+                        local dest_path="$dest_dir/$dest_filename"
+                    fi
+                    
                    cp -v "$file" "$dest_path"
                else
                    log.warn "无效的选择: $choice"
@@ -456,6 +508,7 @@ interactive_copy_entries() {
 }


+
 # 函数：处理桌面文件内容
 # 函数：处理桌面文件内容（安全版本，避免重复处理）
 process_desktop_file() {
@@ -538,6 +591,7 @@ if [ -n "$DEB_PATH" ]; then
        exit 1
    fi
    log.info "安装前检查通过，准备进行提取与修改..."
+    sudo -E chrootEnvPath="$chrootEnvPath" /var/lib/apm/apm/files/ace-run-pkg mkdir -p /var/cache/apt/archives/partial

    # 提取 DEB 包内容并准备修改
    log.info "提取并修改原DEB包..."
@@ -594,6 +648,23 @@ fi
    sudo -E chrootEnvPath="$chrootEnvPath" /var/lib/apm/apm/files/ace-run-pkg rm -vfr /var/lib/aptss/lists || true
    sudo -E chrootEnvPath="$chrootEnvPath" /var/lib/apm/apm/files/ace-run-pkg rm -vfr /var/cache/apt/* || true

+#清理 .dpkg-new 文件
+log.info "搜索并清理 .dpkg-new 文件..."
+# 在 core 目录下查找并删除所有以 .dpkg-new 结尾的文件
+find "$CRAFT_DIR/core" -name "*.dpkg-new" -type f 2>/dev/null | while read -r file; do
+    log.info "删除: $file"
+    rm -f "$file"
+done
+
+# 统计清理结果
+COUNT=$(find "$CRAFT_DIR/core" -name "*.dpkg-new" -type f 2>/dev/null | wc -l)
+if [ "$COUNT" -eq 0 ]; then
+    log.info "已清理所有 .dpkg-new 文件"
+else
+    log.warn "仍有 $COUNT 个 .dpkg-new 文件存在"
+fi
+
+
 # 5. 创建新的 APM 包结构
 log.info "创建新的APM包结构..."
 PKG_BUILD_DIR="$CRAFT_DIR/new-pkg"
--- a/src/usr/bin/amber-pm-dstore-patch
+++ b/src/usr/bin/amber-pm-dstore-patch
@@ -98,7 +98,7 @@ function exec_link_clean(){
    find /usr/share/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/help -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/locale -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
-    find /usr/lib/`dpkg-architecture -qDEB_HOST_MULTIARCH`/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
+#    find /usr/lib/$(gcc -dumpmachine)/fcitx -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/lib/mozilla/plugins -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/polkit-1/actions -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
    find /usr/share/fonts -xtype l -exec echo '{} is invalid now and going to be cleaned' \; -exec unlink  {} \; 2>/dev/null &
--- a/src/usr/bin/apm
+++ b/src/usr/bin/apm
@@ -50,32 +50,36 @@ Commands:
 EOF
 }

-
 apm_exec(){
-    # 递归读取info文件并构建lowerdir
+    # ===============================
+    # 基础变量
+    # ===============================
    local lowerdirs=()
-    local current_dir="${PATH_PREFIX}/var/lib/apm/${coredir}"  # 当前目录开始
+    local env_layers=()
+    local current_dir="${PATH_PREFIX}/var/lib/apm/${coredir}"
    local next_info_file=""
-    
-    # 使用统一的 ace-run 脚本
-    APM_RUN_EXEC=/var/lib/apm/apm/files/ace-run
-    
-    while : ; do
-        # 构建info文件的路径
-        next_info_file="${current_dir}/info"
-        # 检查info文件是否存在
-        if [[ ! -f "$next_info_file" ]]; then
-            break
-        fi
-        
-        # 读取info文件的每一行并构建lowerdir
-        while IFS= read -r basedir; do
-            [[ -z "$basedir" ]] && continue  # 跳过空行
+    local APM_RUN_EXEC=/var/lib/apm/apm/files/ace-run
+
+    # ===============================
+    # 递归读取 info / info_env
+    # ===============================
+    while : ; do
+        next_info_file="${current_dir}/info"
+
+        # 记录 info_env（底层优先）
+        if [[ -f "${current_dir}/info_env" ]]; then
+            env_layers+=("${current_dir}/info_env")
+        fi
+
+        # 没有 info 就停止
+        [[ ! -f "$next_info_file" ]] && break
+
+        # 读取依赖层
+        while IFS= read -r basedir; do
+            [[ -z "$basedir" ]] && continue

-            # 检查ace-env目录是否存在
            if [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env" ]]; then
                lowerdirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env")
-            # 如果ace-env不存在，检查core目录
            elif [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/core" ]]; then
                lowerdirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/core")
            else
@@ -83,61 +87,111 @@ apm_exec(){
            fi
        done < "$next_info_file"

-        # 尝试获取下一个依赖信息的路径
-        local next_basedir=$(tail -n 1 "$next_info_file")
-        if [[ -z "$next_basedir" || ! -d "${PATH_PREFIX}/var/lib/apm/${next_basedir}" ]]; then
-            break
-        fi
-        # 更新当前目录，递归处理下一个依赖
+        # 递归到下一个
+        local next_basedir
+        next_basedir="$(tail -n 1 "$next_info_file")"
+        [[ -z "$next_basedir" || ! -d "${PATH_PREFIX}/var/lib/apm/${next_basedir}" ]] && break
        current_dir="${PATH_PREFIX}/var/lib/apm/${next_basedir}"
    done
-    
-    # 添加info_layer_override功能
+
+    # ===============================
+    # info_layer_override（最高优先级）
+    # ===============================
    local override_file="${PATH_PREFIX}/var/lib/apm/${coredir}/info_layer_override"
    if [[ -f "$override_file" ]]; then
-        log.debug "Found info_layer_override file: $override_file"
+        log.debug "Found info_layer_override: $override_file"
+
        local override_dirs=()
-        
-        # 读取override文件并构建override目录数组
+        local override_envs=()
+
        while IFS= read -r basedir; do
            [[ -z "$basedir" ]] && continue
-            
-            # 检查override目录是否存在
-            if [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env" ]]; then
-                override_dirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env")
-            elif [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/core" ]]; then
-                override_dirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/core")
+            local base="${PATH_PREFIX}/var/lib/apm/${basedir}"
+
+            if [[ -d "${base}/files/ace-env" ]]; then
+                override_dirs+=("${base}/files/ace-env")
+            elif [[ -d "${base}/files/core" ]]; then
+                override_dirs+=("${base}/files/core")
            else
-                log.warn "Neither ace-env nor core directory found for override base: $basedir"
+                log.warn "Override layer not found: $basedir"
+            fi
+
+            if [[ -f "${base}/info_env" ]]; then
+                override_envs+=("${base}/info_env")
            fi
        done < "$override_file"
-        
-        # 将override目录插入到现有lowerdirs数组的最前面（最左侧/最顶层）
+
+        # override 层放最前（最高）
        if [[ ${#override_dirs[@]} -gt 0 ]]; then
-            log.debug "Adding override directories to the top layer"
            lowerdirs=("${override_dirs[@]}" "${lowerdirs[@]}")
        fi
+
+        # override env 最后应用（最高）
+        if [[ ${#override_envs[@]} -gt 0 ]]; then
+            env_layers+=("${override_envs[@]}")
+        fi
    fi
-    
-    # 检查是否找到了有效的lowerdir
+
+    # ===============================
+    # 检查 lowerdir
+    # ===============================
    if [[ ${#lowerdirs[@]} -eq 0 ]]; then
        log.error "No valid lower directories found for package: $coredir"
        return 1
    fi
-    
-    # 将lowerdirs数组用冒号连接起来
-    local lowerdir=$(IFS=:; echo "${lowerdirs[*]}")
-    # 创建挂载点目录
+
+    local lowerdir
+    lowerdir=$(IFS=:; echo "${lowerdirs[*]}")
+
    mkdir -p "/tmp/apm/${coredir}"
-    
-    # 使用fuse-overlayfs挂载
-    log.debug "Mounting with lowerdir: $lowerdir"
-    fuse-overlayfs -o lowerdir="$lowerdir",upperdir="${PATH_PREFIX}/var/lib/apm/${coredir}/files/core/",workdir="${PATH_PREFIX}/var/lib/apm/${coredir}/files/work/" "/tmp/apm/${coredir}"
-    
-    # 执行命令
+
+    # ===============================
+    # 应用 info_env（从下到上）
+    # ===============================
+    for env_file in "${env_layers[@]}"; do
+        log.debug "Applying env: $env_file"
+
+        while IFS= read -r line || [[ -n "$line" ]]; do
+            [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue
+
+            if [[ "$line" =~ ^[A-Za-z_][A-Za-z0-9_]*= ]]; then
+                local key="${line%%=*}"
+                local val="${line#*=}"
+
+                # 去首尾空白
+                val="${val#"${val%%[![:space:]]*}"}"
+                val="${val%"${val##*[![:space:]]}"}"
+
+                # 去外层引号
+                if [[ "$val" =~ ^\".*\"$ || "$val" =~ ^\'.*\'$ ]]; then
+                    val="${val:1:-1}"
+                fi
+
+                export "$key=$val"
+            else
+                log.warn "Invalid env line ignored: $line"
+            fi
+        done < "$env_file"
+    done
+
+    # ===============================
+    # 挂载 overlay
+    # ===============================
+    log.debug "Mounting overlayfs"
+    log.debug "lowerdir=$lowerdir"
+
+    fuse-overlayfs \
+        -o lowerdir="$lowerdir",upperdir="${PATH_PREFIX}/var/lib/apm/${coredir}/files/core/",workdir="${PATH_PREFIX}/var/lib/apm/${coredir}/files/work/" \
+        "/tmp/apm/${coredir}"
+
+    # ===============================
+    # 执行
+    # ===============================
    chrootEnvPath="/tmp/apm/${coredir}" "${APM_RUN_EXEC}" "$@"
-    
+
+    # ===============================
    # 卸载
+    # ===============================
    umount "/tmp/apm/${coredir}"
 }

--- a/src/var/lib/apm/apm/files/bin/ace-init
+++ b/src/var/lib/apm/apm/files/bin/ace-init
@@ -112,7 +112,7 @@ chown -R root $chrootEnvPath
 mkdir -p $chrootEnvPath/amber-ce-tools/data-dir
 ln -sv ../../usr/share/applications $chrootEnvPath/amber-ce-tools/data-dir/
 ln -sv ../../usr/share/icons $chrootEnvPath/amber-ce-tools/data-dir/
-mkdir -p chrootEnvPath/usr/share/templates  
+mkdir -p $chrootEnvPath/usr/share/templates  
 ln -sfv ../../usr/share/templates/   $chrootEnvPath/amber-ce-tools/data-dir/