修改文档

README.md

@@ -1,50 +1,73 @@
-# APM 
+# APM 琥珀软件包管理器
 
 
 
-APM 是一款基于 fuse-overlayfs ， dpkg ， ACE 的容器软件包管理系统
+APM 是一款基于 fuse-overlayfs ， dpkg ， AmberCE 容器的软件包管理系统，支持在debian, fedora, arch等发行版上运行
 
-源码在 src
+APM 目前提供 debian 12/13 和 deepin 25 基础环境，支持把适配以上环境中的应用转换成 APM 应用
 
-原理：https://www.cnblogs.com/arnoldlu/p/13055501.html
+APM 会自动从主机获取 Nvidia 驱动文件，因此无需担心 N 卡无法加速问题
 
-## 体验demo: 查看 https://gitee.com/amber-ce/amber-pm/releases
+您可在 [src](src/) 目录找到 apm 的源代码
+
+overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html
+
+## 使用方法
+```
+APM - Amber Package Manager 1.0.10
+
+Usage:
+  apm [COMMAND] [OPTIONS] [PACKAGES...]
+
+Commands:
+  install      安装软件包
+  remove       卸载软件包
+  update       更新软件包信息
+  list         查看可用软件包信息
+  search       搜索软件包
+  download     下载包
+  clean        清除缓存软件包
+  autoremove   自动移除不需要的包
+  full-upgrade 完全升级软件包
+  run <package> 运行指定软件包的可执行文件
+  ssaudit <path> 使用 ssaudit 进行本地软件安装，详情见 spark-store
+  debug        显示调试系统信息并进入调试环境
+  amber      彩蛋功能
+  xmp360     彩蛋功能
+  bronya     彩蛋功能
+
+  -h, --help   显示此帮助信息
+
+```
 
 
 
-制作apm包upperdir的流程
 
-先安装 apm （从release）
+## APM deb 包全自动转换器使用方法
 
-sudo apm install base包后，在 
+```
+用法: amber-pm-convert --base <basename> [--base <basename> ...] <deb文件路径> [--pkgname <包名>] [--version <版本号>]
 
-sudo mount -t overlay  overlay   -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/amber-pm-trixie/files/ace-env',upperdir=core/,workdir=work/ ./ace-env
+参数说明:
+  --basename   必填参数，指定基础环境名称，可多次使用指定多个基础环境
+  deb文件路径  必填参数，要转换的DEB文件路径
+  --pkgname    可选参数，指定新包的包名（默认使用原DEB包名）
+  --version    可选参数，指定新包的版本号（默认在原版本后追加'-apm'）
 
-随后chroot进入进行安装操作，直接进行 apt install 或者其他都可以，完成后
-
-core: 保存新增文件
-work: 保存变更信息
-需把这两个目录重新拥有并权限换成755
+示例:
+  amber-pm-convert --base amber-pm-trixie /path/to/package.deb
+  amber-pm-convert --base amber-pm-bookworm-spark-wine /path/to/package.deb --pkgname new-pkg --version 1.0.0
+最下层的base在最后面，从上到下写base
 
 
-fuse-overlayfs -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/amber-pm-trixie/files/ace-env',upperdir=core/,workdir=work/ ./ace-env
+```
 
-即可只读挂载。这一步 apm run 包名 会帮你做好。
+> 注意：因为 apm 软件包为特殊的 deb 软件包，若您在使用 Debian 或其他使用 dpkg 管理软件包的发行版，您可使用apt直接把 apm 软件包安装到系统中，同样可使用。对于这种情况，请使用系统自带的 apt 进行软件包管理。
 
-> apm run 包名： 寻找 /var/lib/apm/包名/是否存在。若存在，根据info文件合成 fuser-overlayfs 参数进行挂载，随后用ACE工具chroot进入进行启动
+## APM 的原理和软件包的介绍
 
-./ace-run 即可进入，可以尝试启动一下刚刚安装的应用
+详见 [Packaging-demo](Packaging-demo)
 
-spec（对于APM内的包）：
-对于base
-/var/lib/apm/包名/files/ace-env 是 lowerdir
+## APM 构建 Tips
 
-对于core
-/var/lib/apm/包名/files/core是upperdir
-/var/lib/apm/包名/files/work是upperdir的work
-/var/lib/apm/包名/files/ace-env是chroot进的目录（需要在打包好的包内加上允许读写这个目录——或者后续换成tmp的挂载点）
-/var/lib/apm/包名/info是配置信息，目前只写了依赖的base，后续可以定义默认启动指令等
-/var/lib/apm/包名/entries是desktop位置，后续会加到自动展示中
-
-
-core的依赖需要写base
+APM 使用了特殊的精简版 AmberCE 兼容环境。相关的 Tips 见 [Tips](tips.md)