doc: 修改注释

README.md

@@ -2,13 +2,17 @@
 
 这是一个用于快速构建 ImmortalWrt 固件的自动化项目，基于 ImmortalWrt 官方 Image Builder 生成自定义固件。
 
-当前仓库提供两个构建脚本：
+当前仓库提供多个构建脚本：
 
 - `x86-64.sh`：构建 x86/64 通用固件
 - `r2s.sh`：构建 FriendlyARM NanoPi R2S 固件
+- `hiwifi-b70.sh`：构建 极路由 B70 固件
+- `newifi3-d2.sh`：构建 新三路由 固件
 
 脚本会自动安装构建依赖、下载对应版本的 Image Builder、复制 `files/` 目录中的自定义文件，并执行固件构建。
 
+固件的默认登录地址是 `192.168.1.1`. 登录账号: `root`. 密码: `无`
+
 ## 环境要求
 
 建议在 Debian/Ubuntu 或 WSL Ubuntu 环境中运行。
@@ -29,19 +33,19 @@ cd immortalwrt_image_builder
 ### 构建 x86-64 固件
 
 ```bash
-sudo bash x86-64.sh
+bash x86-64.sh
 ```
 
 构建完成后，固件文件会生成到：
 
 ```text
-output/
+x86-64_output/
 ```
 
 ### 构建 NanoPi R2S 固件
 
 ```bash
-sudo bash r2s.sh
+bash r2s.sh
 ```
 
 构建完成后，固件文件会生成到：
@@ -53,7 +57,7 @@ r2s_output/
 ### 构建 新三路由 wifi3-d2 固件
 
 ```bash
-sudo bash newifi3_d2.sh
+bash newifi3_d2.sh
 ```
 
 构建完成后，固件文件会生成到：
@@ -65,7 +69,7 @@ newifi3_output/
 ### 构建 极路由 B70 固件
 
 ```bash
-sudo bash hiwifi-b70.sh
+bash hiwifi-b70.sh
 ```
 
 构建完成后，固件文件会生成到：
@@ -80,7 +84,7 @@ hiwifi_b70_output/
 
 ### x86-64
 
-- ImmortalWrt 版本：`25.12.0`
+- ImmortalWrt 版本：`25.12.1`
 - Target：`x86/64`
 - Profile：`generic`
 - 根分区大小：`600 MB`
@@ -88,7 +92,7 @@ hiwifi_b70_output/
 
 ### NanoPi R2S
 
-- ImmortalWrt 版本：`25.12.0`
+- ImmortalWrt 版本：`25.12.1`
 - Target：`rockchip/armv8`
 - Profile：`friendlyarm_nanopi-r2s`
 - 根分区大小：`600 MB`
@@ -96,7 +100,7 @@ hiwifi_b70_output/
 
 ### 新三路由（Newifi3 D2）
 
-- ImmortalWrt 版本：`25.12.0`
+- ImmortalWrt 版本：`25.12.1`
 - Target：`ramips/mt7621`
 - Profile：`d-team_newifi-d2`
 - 输出目录：`newifi3_output/`
@@ -104,40 +108,18 @@ hiwifi_b70_output/
 
 ### 极路由 B70
 
-- ImmortalWrt 版本：`25.12.0`
+- ImmortalWrt 版本：`25.12.1`
 - Target：`ramips/mt7621`
 - Profile：`hiwifi_hc5962`
 - 输出目录：`newifi3_output/`
 
 ## 自定义固件
 
-### 修改 ImmortalWrt 版本
+### ImmortalWrt 版本
 
-编辑对应脚本中的 `version` 变量：
+脚本在运行时会询问用户 ImmortalWrt 版本. 不知道用什么版本的, 直接默认版本就好.
 
-```bash
+版本查询 https://github.com/immortalwrt/immortalwrt/tags
-version="25.12.0"
-```
-
-例如改为：
-
-```bash
-version="24.10.2"
-```
-
-请确认该版本在 ImmortalWrt 官方下载站中存在，否则 Image Builder 下载会失败。
-
-x86-64 对应下载路径：
-
-```text
-https://downloads.immortalwrt.org/releases/<version>/targets/x86/64/
-```
-
-NanoPi R2S 对应下载路径：
-
-```text
-https://downloads.immortalwrt.org/releases/<version>/targets/rockchip/armv8/
-```
 
 ### 修改预装软件包
 
@@ -157,18 +139,11 @@ PKG_LIST=(
 如果要从固件中移除某个包，可以在包名前加 `-`，例如：
 
 ```bash
--dropbear
+PKG_LIST=(
-```
+  -dropbear # 排除 dropbear
-
+  openssh-sftp-server
-### 修改根分区大小
+  luci-i18n-firewall-zh-cn
-
+)
-脚本最后会调用 `build` 函数并传入根分区大小，单位为 MB。
-
-示例：
-
-```bash
-rootfs_partsize=500 # 根分区大小，单位为 MB
-build $builder_dir $rootfs_partsize
 ```
 
 ### 添加自定义文件
@@ -189,12 +164,25 @@ files/etc/uci-defaults/99-sshd-root-login
 
 这个机制适合放置默认配置、初始化脚本、SSH 配置、LuCI 配置等文件。
 
-## 注意事项
+## 关于开发
 
-- 不建议直接使用 `curl | bash` 运行脚本，因为脚本依赖仓库中的 `files/` 目录。
+如果需要增加新设备固件. 你可以用以下`提示词`和`材料`喂给 AI
-- 如果下载或安装依赖失败，请检查网络、系统源以及当前用户权限。
+
-- 如需查看某个目标支持的全部 profile，可进入解压后的 Image Builder 目录执行：
+#### 材料:
+
+- 代码模板: 找项目其中一个构建脚本作为模板, 比如: x86-64.sh
+- ImmortalWrt image builder 下载地址: 其中下载地址可以在[https://downloads.immortalwrt.org/](https://downloads.immortalwrt.org/)找. 名字以x86-64为例,叫这个`immortalwrt-imagebuilder-25.12.1-x86-64.Linux-x86_64.tar.zst`  
+- 设备系统架构:  如果设备已安装了`openwrt`系统, 可以通过命令`cat /etc/os-release | grep ARCH`查找设备系统架构信息. 
+
+#### AI 提示词:
+
+```
+image builder的下载地址: xxxx
+
+目标设备型号: xxx
+
+设备系统架构是: xxx
+
+我想构建xxx设备固件, 请你按这个代码模板编写代码.
 
-```bash
-make info
 ```

files/etc/uci-defaults/98-network-setting

@@ -0,0 +1,65 @@
+#!/bin/sh
+
+# 仅在首次启动时执行（/etc/uci-defaults机制）
+
+# 获取当前 OpenWrt/ImmortalWrt 的主版本号
+get_openwrt_version() {
+    local version=""
+    if [ -f /etc/openwrt_release ]; then
+        # 提取形如 25.12 或 23.05 的前两位数字版本
+        version=$(grep "DISTRIB_RELEASE" /etc/openwrt_release | cut -d"'" -f2 | cut -d'.' -f1,2)
+    fi
+    echo "$version"
+}
+
+# 比较版本号是否大于或等于 25.12
+# 返回 0 表示 >= 25.12，返回 1 表示较旧版本
+is_version_25_12_or_newer() {
+    local current_ver=$(get_openwrt_version)
+    
+    # 如果没获取到版本号，保守起见当做旧版本处理
+    [ -z "$current_ver" ] && return 1
+
+    # 使用 awk 进行浮点数版本比较
+    awk -v cur="$current_ver" 'BEGIN { if (cur >= 25.12) exit 0; else exit 1 }'
+}
+
+# 修改 LAN 口 IP 地址
+update_lan_ip(){
+    local NEW_LAN_IP="$1"
+
+    # 检查 network 配置是否存在
+    if [ -f /etc/config/network ]; then
+
+        # 检查 lan 接口是否存在
+        if uci get network.lan >/dev/null 2>&1; then
+
+            # 设置为静态 IP 协议
+            uci set network.lan.proto='static'
+
+            # 根据版本号执行不同的设置逻辑
+            if is_version_25_12_or_newer; then
+                # 25.12+ 版本：合并为 CIDR 格式，并清除可能残留的旧 netmask
+                uci set network.lan.ipaddr="${NEW_LAN_IP}/24"
+                uci del network.lan.netmask >/dev/null 2>&1
+            else
+                # 25.12 以下旧版本：拆分为 ipaddr 和 netmask
+                uci set network.lan.ipaddr="${NEW_LAN_IP}"
+                uci set network.lan.netmask="255.255.255.0"
+            fi
+
+            # 保存配置
+            uci commit network
+        fi
+    fi
+
+    # 重启网络服务
+    if [ -x /etc/init.d/network ]; then
+        /etc/init.d/network restart
+    fi
+}
+
+
+# update_lan_ip "192.168.50.100"   修改lan口ip
+
+exit 0

files/etc/uci-defaults/99-sshd-root-login

@@ -20,8 +20,13 @@ if [ -f "$SSHD_CONF" ]; then
     else
         echo "PasswordAuthentication yes" >> "$SSHD_CONF"
     fi
+    
+    # 创建root用户ssh公钥目录和文件
+    mkdir -p /root/.ssh
+    touch /root/.ssh/authorized_keys
 fi
 
+
 # 重启 OpenSSH 服务（如果已安装）
 if [ -x /etc/init.d/sshd ]; then
     /etc/init.d/sshd enable

hiwifi-b70.sh

@@ -2,7 +2,7 @@
 set -e
 
 install_dependencies() {
-  apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
+  sudo apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
     gettext libssl-dev xsltproc rsync wget unzip python3 qemu-utils mkisofs zstd
 }
 
@@ -141,12 +141,31 @@ build() {
   echo -e "固件输出: ${PROJECT_OUTPUT_DIR}"
 }
 
+# =============================================================
+# 交互输入函数
+# 参数1: 提示信息
+# 参数2: 默认值
+# 返回: 用户输入值，直接回车返回默认值
+# =============================================================
+ask_input() {
+  local prompt="$1"
+  local default="$2"
+
+  read -p "${prompt} [ 默认: ${default} ]: " value
+
+  if [ -z "$value" ]; then
+    echo "$default"
+  else
+    echo "$value"
+  fi
+}
 
 project_dir="$(cd "$(dirname "$0")" && pwd)"
 cd "$project_dir"
 
-# 要构建的 ImmortalWrt 版本
+# 要构建的 ImmortalWrt 版本, 可以在 https://github.com/immortalwrt/immortalwrt 查询版本号
-version="25.12.0"
+default_version="25.12.1"
+version=$(ask_input "请输入 ImmortalWrt 版本" "$default_version")
 
 install_dependencies
 

newifi3_d2.sh

@@ -2,7 +2,7 @@
 set -e
 
 install_dependencies() {
-  apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
+  sudo apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
     gettext libssl-dev xsltproc rsync wget unzip python3 qemu-utils mkisofs zstd
 }
 
@@ -32,6 +32,25 @@ download_imagebuilder() {
   echo "$(pwd)/$folder"
 }
 
+# =============================================================
+# 交互输入函数
+# 参数1: 提示信息
+# 参数2: 默认值
+# 返回: 用户输入值，直接回车返回默认值
+# =============================================================
+ask_input() {
+  local prompt="$1"
+  local default="$2"
+
+  read -p "${prompt} [ 默认: ${default} ]: " value
+
+  if [ -z "$value" ]; then
+    echo "$default"
+  else
+    echo "$value"
+  fi
+}
+
 build() {
   # =============================================================
   #  设备 Profile（必须与 ImageBuilder 支持的设备一致）
@@ -146,7 +165,8 @@ project_dir="$(cd "$(dirname "$0")" && pwd)"
 cd "$project_dir"
 
 # 要构建的 ImmortalWrt 版本, 可以在 https://github.com/immortalwrt/immortalwrt 查询版本号
-version="25.12.0"
+default_version="25.12.1"
+version=$(ask_input "请输入 ImmortalWrt 版本" "$default_version")
 
 # 安装依赖
 install_dependencies

r2s.sh

@@ -3,12 +3,12 @@ set -e
 
 # 安装 Image Builder 构建所需依赖
 install_dependencies() {
-  apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
+  sudo apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
     gettext libssl-dev xsltproc rsync wget unzip python3 qemu-utils mkisofs zstd
 }
 
 # 下载并解压 FriendlyARM NanoPi R2S 的 Image Builder
-# 参数 1: ImmortalWrt 版本号，例如 25.12.0
+# 参数 1: ImmortalWrt 版本号，例如 25.12.1
 # 输出: 解压后的 Image Builder 目录绝对路径
 download_imagebuilder() {
   local version="$1"
@@ -137,15 +137,6 @@ build(){
     echo -e "${YELLOW}[提示] 未找到自定义 files/ 目录，跳过复制${NC}"
   fi
 
-  # 禁用 x86 Image Builder 中常见的额外镜像格式；rockchip 目标不存在时会自动跳过
-  sed -i \
-  -e 's/^CONFIG_ISO_IMAGES=y/# CONFIG_ISO_IMAGES is not set/' \
-  -e 's/^CONFIG_QCOW2_IMAGES=y/# CONFIG_QCOW2_IMAGES is not set/' \
-  -e 's/^CONFIG_VDI_IMAGES=y/# CONFIG_VDI_IMAGES is not set/' \
-  -e 's/^CONFIG_VMDK_IMAGES=y/# CONFIG_VMDK_IMAGES is not set/' \
-  -e 's/^CONFIG_VHDX_IMAGES=y/# CONFIG_VHDX_IMAGES is not set/' \
-  .config
-
   if [ ! -f "Makefile" ]; then
       echo -e "${RED}[错误] 未找到 Makefile，请在 imagebuilder 根目录下运行本脚本！${NC}"
       exit 1
@@ -197,16 +188,36 @@ build(){
   fi
 }
 
+# =============================================================
+# 交互输入函数
+# 参数1: 提示信息
+# 参数2: 默认值
+# 返回: 用户输入值，直接回车返回默认值
+# =============================================================
+ask_input() {
+  local prompt="$1"
+  local default="$2"
+
+  read -p "${prompt} [ 默认: ${default} ]: " value
+
+  if [ -z "$value" ]; then
+    echo "$default"
+  else
+    echo "$value"
+  fi
+}
 
 # 项目根目录，保证从任意位置执行 r2s.sh 都能找到其他资源
 project_dir="$(cd "$(dirname "$0")" && pwd)"
 cd "$project_dir"
 
-# 要构建的 ImmortalWrt 版本
+# 要构建的 ImmortalWrt 版本, 可以在 https://github.com/immortalwrt/immortalwrt 查询版本号
-version="25.12.0"
+default_version="25.12.1"
+version=$(ask_input "请输入 ImmortalWrt 版本" "$default_version")
 
 # 根分区大小(单位: MB)
-rootfs_partsize=600
+default_rootfs_partsize="600"
+rootfs_partsize=$(ask_input "请输入根分区大小(MB)" "$default_rootfs_partsize")
 
 install_dependencies
 

x86-64.sh

@@ -3,12 +3,12 @@ set -e
 
 # 安装 Image Builder 构建所需依赖
 install_dependencies() {
-  apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
+  sudo apt install -y build-essential libncurses-dev zlib1g-dev gawk git \
     gettext libssl-dev xsltproc rsync wget unzip python3 qemu-utils mkisofs zstd
 }
 
 # 下载并解压 x86-64 的 Image Builder
-# 参数 1: ImmortalWrt 版本号，例如 25.12.0
+# 参数 1: ImmortalWrt 版本号，例如 25.12.1
 # 输出: 解压的后 Image Builder 目录绝对路径
 download_imagebuilder() {
   local version="$1"
@@ -58,8 +58,8 @@ build(){
   # ────────────────────────────────────────────
   #  固件输出目录
   # ────────────────────────────────────────────
-  OUTPUT_DIR="$BUILDER_DIR/output"
+  OUTPUT_DIR="$BUILDER_DIR/x86-64_output"
-  PROJECT_OUTPUT_DIR="$SCRIPT_DIR/output"
+  PROJECT_OUTPUT_DIR="$SCRIPT_DIR/x86-64_output"
 
   # ────────────────────────────────────────────
   #  固件文件名附加标识（可留空）
@@ -214,16 +214,36 @@ build(){
 
 }
 
+# =============================================================
+# 交互输入函数
+# 参数1: 提示信息
+# 参数2: 默认值
+# 返回: 用户输入值，直接回车返回默认值
+# =============================================================
+ask_input() {
+  local prompt="$1"
+  local default="$2"
+
+  read -p "${prompt} [ 默认: ${default} ]: " value
+
+  if [ -z "$value" ]; then
+    echo "$default"
+  else
+    echo "$value"
+  fi
+}
 
 # 项目根目录，用来保证从任意位置执行 main.sh 都能找到其他脚本
 project_dir="$(cd "$(dirname "$0")" && pwd)"
 cd "$project_dir"
 
 # 要构建的 ImmortalWrt 版本, 可以在 https://github.com/immortalwrt/immortalwrt 查询版本号
-version="25.12.0" 
+default_version="25.12.1"
+version=$(ask_input "请输入 ImmortalWrt 版本" "$default_version")
 
 # 根分区大小(单位: MB)
-rootfs_partsize=600
+default_rootfs_partsize="600"
+rootfs_partsize=$(ask_input "请输入根分区大小(MB)" "$default_rootfs_partsize")
 
 # 安装依赖
 install_dependencies