From 930b1b37fc7420313fe2d2f5416f68f80cfeb7ed Mon Sep 17 00:00:00 2001
From: Melorise <0d00@0721.hk>
Date: Thu, 30 Jul 2026 12:11:37 +0800
Subject: [PATCH] release: establish v2.0.3 clean deployment baseline

---
 README.md       |  9 +++++++--
 nix/module.nix  | 18 ------------------
 nix/package.nix |  2 +-
 3 files changed, 8 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md
index 3173aeb..70c3b86 100644
--- a/README.md
+++ b/README.md
@@ -157,8 +157,9 @@ journalctl -fu npanel-agent
 sudo systemctl restart npanel-agent npanel-core
 ```
 
-升级 nPanel 输入并执行常规 `nixos-rebuild switch` 即可。nPanel 不提供面板内自更新，
-软件版本始终由你的 Flake lock 和 NixOS 世代决定。
+同一兼容发布线内，升级 nPanel 输入并执行常规 `nixos-rebuild switch` 即可。nPanel 不提供
+面板内自更新，软件版本始终由你的 Flake lock 和 NixOS 世代决定。破坏性版本必须遵循对应
+发布说明，不得直接原地升级。
 
 若主机安装并启用了 NVIDIA 驱动，`nvidia-smi` 位于当前 NixOS 世代的系统命令路径时，
 nPanel agent 会自动用于 GPU 监控；无需将独立 NVIDIA 包打进 nPanel 配置。
@@ -169,6 +170,10 @@ nPanel 使用 `x.y.z` 产品版本号。`x` 仅与上游 1Panel 的主版本线
 nPanel 独立演进，不随上游的小版本号变动。首个发布版本为 `2.0.0`，应用商店协议兼容
 基线为上游 `v2.2.3`，两者是独立概念。
 
+> **2.0.3 破坏性变更：**2.0.3 不提供从 2.0.1 或 2.0.2 原地升级的兼容迁移。这两个版本
+> 创建的应用配置可能具有不一致的文件权限和数据库启动参数；继续复用原状态目录可能导致
+> 数据库无法启动。升级者必须自行迁移所需业务数据，并以 2.0.3 重新部署面板及数据库。
+
 发布分支同时是建议的 Flake 输入来源；不要以 Git tag 作为输入。tag 仅用于标记对应的
 unstable 发布提交，不能表达你正在使用的 NixOS 输入渠道。
 
diff --git a/nix/module.nix b/nix/module.nix
index f5adabf..3878205 100644
--- a/nix/module.nix
+++ b/nix/module.nix
@@ -93,24 +93,6 @@ EOF
     update_control_value MANAGED_PORT ${lib.escapeShellArg (toString cfg.port)}
     update_control_value MANAGED_ENTRANCE ${lib.escapeShellArg cfg.securityEntrance}
     update_control_value MANAGED_VERSION ${lib.escapeShellArg (cfg.package.version or "unknown")}
-
-    # nPanel 2.0.0-2.0.1 ran the agent with UMask=0077. Application archives
-    # were therefore extracted with root-only database configuration files,
-    # even when the public archive declared mode 0644. Repair only the known
-    # non-secret database server configuration files; never relax .env files,
-    # credentials, private keys, or the rest of the mutable application tree.
-    for app_root in \
-      "$state_dir/1panel/apps" \
-      "$state_dir/1panel/resource/apps"
-    do
-      if [ -d "$app_root" ]; then
-        find "$app_root" -type f \
-          \( -path '*/mysql/*/conf/my.cnf' \
-             -o -path '*/mysql-cluster/*/conf/my.cnf' \
-             -o -path '*/mariadb/*/conf/my.cnf' \) \
-          -exec chmod 0644 {} +
-      fi
-    done
   '';
 
   commonServiceConfig = {
diff --git a/nix/package.nix b/nix/package.nix
index 0901984..c2c45e0 100644
--- a/nix/package.nix
+++ b/nix/package.nix
@@ -5,7 +5,7 @@
 }:
 
 let
-  version = "2.0.2";
+  version = "2.0.3";
 
   frontend = buildNpmPackage {
     pname = "npanel-frontend";