xb-init 2.1.0__tar.gz → 2.2.2__tar.gz

{xb_init-2.1.0 → xb_init-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xb-init
-Version: 2.1.0
+Version: 2.2.2
 Summary: Project management tool for UV + FastAPI + Vue3 + Electron desktop applications
 Project-URL: Homepage, https://github.com/xuebli/xb
 Project-URL: Documentation, https://github.com/xuebli/xb#readme
@@ -43,6 +43,7 @@ Description-Content-Type: text/markdown
 - 内置全局亮色/暗色主题切换
 - 可选 sudo 免密配置（`--sudoers`）
 - 可选内置终端（`--terminal`）
+- 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
 - 可选自定义应用图标（`--icon`）
 - 内置开发、构建、版本管理命令
 - 自动版本检查与一键升级（`xb --upgrade`）
@@ -83,6 +84,9 @@ xb init demo --terminal
 # 同时启用终端和 sudo 免密配置
 xb init demo --terminal --sudoers
 
+# 启用应用内自动更新（自动附带 --sudoers 免密，输入 sudo 密码即可）
+xb init demo --update
+
 # 带自定义图标
 xb init demo --icon ~/icons/app.png
 
@@ -110,14 +114,18 @@ python .\dev.py stop
 使用 `--terminal` 时，Windows 终端使用 PowerShell + ConPTY，支持上下箭头
 命令历史、复制粘贴、Tab 补全和 Ctrl+C；Ubuntu/Debian 使用 bash + Unix PTY。
 
-Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入，不向 `.npmrc`
-写 npm 不识别的自定义键。若安装过程被网络中断，生成项目的
+Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
+若安装过程被网络中断，生成项目的
 `electron/prepare.js` 会在 `npm start` 或 `npm run build` 前自动检查并补装
 缺失的 Electron 二进制。
 
 > **`xb init` 自动行为**：
 > - 执行 `npm install`（frontend + electron），生成 `package-lock.json`
->   - 生成的 `.npmrc` 已配好华为云镜像；electron 约 200MB 二进制也走镜像下载
+>   - 生成的项目用 [nrm](https://github.com/Pana/nrm) 管理 npm 源：`xb init`
+>     安装依赖前与 `build.py` 构建前都会自动 `nrm test` 测速所有内置源并切换
+>     到最快的（未安装 nrm 时自动全局安装）；项目不放 `.npmrc`，npm 源完全由
+>     nrm 全局管理
+>   - electron 约 200MB 二进制走华为云镜像下载
 >   - 若安装失败或超时，会打印提示但不中断项目创建，可稍后手动重试
 > - 执行 `git init` 并提交首个 commit（包含所有文件和 lock 文件）
 > - 若检测到 PyPI 有新版 xb，会询问是否先升级再创建项目
@@ -127,7 +135,7 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入，不向 `.n
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--sudoers] [--terminal] [--icon PATH]` | 初始化项目 |
+| `xb init <name> [--sudoers] [--terminal] [--update] [--icon PATH]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
@@ -146,6 +154,39 @@ xb init demo --icon ./my-icon.png
 # ./assets/app-icon.png, ./assets/icon.png, ./resources/icon.png
 ```
 
+## 应用内自动更新（`--update`）
+
+`xb init demo --update` 会让生成的项目内置与 [leo_stm32_board_test](../leo_stm32_board_test) 同源的自动更新能力，
+以飞书云盘的一个文件夹作为发布"货架"：
+
+**生成内容：**
+
+| 位置 | 职责 |
+|------|------|
+| `backend/api/update/` | 更新接口（检查 / 信息 / 下载 / 进度 / 安装） |
+| `backend/services/updater.py` | 版本比较、信息拉取、下载校验、配置备份迁移、安装 |
+| `backend/services/feishu_client.py` | 飞书接口封装（文件夹列举、并发下载） |
+| `backend/managers/secret_obfuscator.py` | 敏感值混淆（`obf1:`，防围观级别） |
+| `backend/app_version.py` | 后端版本号（version_manager 提交时自动同步） |
+| `frontend/src/components/UpdateChecker.vue` | 版本号徽章 + 更新弹窗 + 进度条 |
+| `frontend/src/composables/useUpdate.js` | 定时检查 / 下载进度轮询 |
+| `scripts/feishu_upload.py` | 发版端：安装包与版本信息上传飞书 |
+| `configs/config_changes.json` | 配置迁移清单（顶层 key 是版本号） |
+| `build.py` | 增加 `--upload-only` 与构建后发布编排 |
+
+**发版流程：** 在 `configs/secrets.yaml` 填 `feishu.app_id` / `app_secret` /
+`update_folder_url` → `./build.py -a` → 确认上传。构建时敏感键自动混淆进
+`secrets.yaml.example` 随包分发，构建结束 example 恢复为留空模板。
+
+**客户端：** 启动时 / 每小时 / 点版本号徽章时检查更新；发现新版本后下载
+（4 线程分块 + SHA256 校验 + `.part` 防半截包）→ 备份配置 → 按
+`config_changes.json` 迁移 → Ubuntu 趁应用存活时免密 `sudo dpkg -i`
+（`--update` 默认附带 `--sudoers` 免密），Windows 等退出后静默安装。
+
+**飞书侧准备：** 开放平台建自建应用 → 开通 `drive:drive` 权限并发布 →
+建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
+应用内更新，检查接口返回 `packaged: false`。
+
 ## 生成的项目结构
 
 ```
@@ -162,13 +203,11 @@ demo/
 ├── frontend/               # Vue 3 前端
 │   ├── package.json
 │   ├── package-lock.json
-│   ├── .npmrc              # npm 镜像源（华为云）
 │   ├── vite.config.js
 │   └── src/
 ├── electron/               # Electron 主进程
 │   ├── package.json
 │   ├── package-lock.json
-│   ├── .npmrc              # npm + electron 二进制镜像源
 │   ├── main.js
 │   └── resources/          # icon + Linux DEB hooks
 ├── version/                # 版本管理（pre-commit hook）

{xb_init-2.1.0 → xb_init-2.2.2}/README.md

@@ -14,6 +14,7 @@
 - 内置全局亮色/暗色主题切换
 - 可选 sudo 免密配置（`--sudoers`）
 - 可选内置终端（`--terminal`）
+- 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
 - 可选自定义应用图标（`--icon`）
 - 内置开发、构建、版本管理命令
 - 自动版本检查与一键升级（`xb --upgrade`）
@@ -54,6 +55,9 @@ xb init demo --terminal
 # 同时启用终端和 sudo 免密配置
 xb init demo --terminal --sudoers
 
+# 启用应用内自动更新（自动附带 --sudoers 免密，输入 sudo 密码即可）
+xb init demo --update
+
 # 带自定义图标
 xb init demo --icon ~/icons/app.png
 
@@ -81,14 +85,18 @@ python .\dev.py stop
 使用 `--terminal` 时，Windows 终端使用 PowerShell + ConPTY，支持上下箭头
 命令历史、复制粘贴、Tab 补全和 Ctrl+C；Ubuntu/Debian 使用 bash + Unix PTY。
 
-Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入，不向 `.npmrc`
-写 npm 不识别的自定义键。若安装过程被网络中断，生成项目的
+Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
+若安装过程被网络中断，生成项目的
 `electron/prepare.js` 会在 `npm start` 或 `npm run build` 前自动检查并补装
 缺失的 Electron 二进制。
 
 > **`xb init` 自动行为**：
 > - 执行 `npm install`（frontend + electron），生成 `package-lock.json`
->   - 生成的 `.npmrc` 已配好华为云镜像；electron 约 200MB 二进制也走镜像下载
+>   - 生成的项目用 [nrm](https://github.com/Pana/nrm) 管理 npm 源：`xb init`
+>     安装依赖前与 `build.py` 构建前都会自动 `nrm test` 测速所有内置源并切换
+>     到最快的（未安装 nrm 时自动全局安装）；项目不放 `.npmrc`，npm 源完全由
+>     nrm 全局管理
+>   - electron 约 200MB 二进制走华为云镜像下载
 >   - 若安装失败或超时，会打印提示但不中断项目创建，可稍后手动重试
 > - 执行 `git init` 并提交首个 commit（包含所有文件和 lock 文件）
 > - 若检测到 PyPI 有新版 xb，会询问是否先升级再创建项目
@@ -98,7 +106,7 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入，不向 `.n
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--sudoers] [--terminal] [--icon PATH]` | 初始化项目 |
+| `xb init <name> [--sudoers] [--terminal] [--update] [--icon PATH]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
@@ -117,6 +125,39 @@ xb init demo --icon ./my-icon.png
 # ./assets/app-icon.png, ./assets/icon.png, ./resources/icon.png
 ```
 
+## 应用内自动更新（`--update`）
+
+`xb init demo --update` 会让生成的项目内置与 [leo_stm32_board_test](../leo_stm32_board_test) 同源的自动更新能力，
+以飞书云盘的一个文件夹作为发布"货架"：
+
+**生成内容：**
+
+| 位置 | 职责 |
+|------|------|
+| `backend/api/update/` | 更新接口（检查 / 信息 / 下载 / 进度 / 安装） |
+| `backend/services/updater.py` | 版本比较、信息拉取、下载校验、配置备份迁移、安装 |
+| `backend/services/feishu_client.py` | 飞书接口封装（文件夹列举、并发下载） |
+| `backend/managers/secret_obfuscator.py` | 敏感值混淆（`obf1:`，防围观级别） |
+| `backend/app_version.py` | 后端版本号（version_manager 提交时自动同步） |
+| `frontend/src/components/UpdateChecker.vue` | 版本号徽章 + 更新弹窗 + 进度条 |
+| `frontend/src/composables/useUpdate.js` | 定时检查 / 下载进度轮询 |
+| `scripts/feishu_upload.py` | 发版端：安装包与版本信息上传飞书 |
+| `configs/config_changes.json` | 配置迁移清单（顶层 key 是版本号） |
+| `build.py` | 增加 `--upload-only` 与构建后发布编排 |
+
+**发版流程：** 在 `configs/secrets.yaml` 填 `feishu.app_id` / `app_secret` /
+`update_folder_url` → `./build.py -a` → 确认上传。构建时敏感键自动混淆进
+`secrets.yaml.example` 随包分发，构建结束 example 恢复为留空模板。
+
+**客户端：** 启动时 / 每小时 / 点版本号徽章时检查更新；发现新版本后下载
+（4 线程分块 + SHA256 校验 + `.part` 防半截包）→ 备份配置 → 按
+`config_changes.json` 迁移 → Ubuntu 趁应用存活时免密 `sudo dpkg -i`
+（`--update` 默认附带 `--sudoers` 免密），Windows 等退出后静默安装。
+
+**飞书侧准备：** 开放平台建自建应用 → 开通 `drive:drive` 权限并发布 →
+建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
+应用内更新，检查接口返回 `packaged: false`。
+
 ## 生成的项目结构
 
 ```
@@ -133,13 +174,11 @@ demo/
 ├── frontend/               # Vue 3 前端
 │   ├── package.json
 │   ├── package-lock.json
-│   ├── .npmrc              # npm 镜像源（华为云）
 │   ├── vite.config.js
 │   └── src/
 ├── electron/               # Electron 主进程
 │   ├── package.json
 │   ├── package-lock.json
-│   ├── .npmrc              # npm + electron 二进制镜像源
 │   ├── main.js
 │   └── resources/          # icon + Linux DEB hooks
 ├── version/                # 版本管理（pre-commit hook）

{xb_init-2.1.0 → xb_init-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "xb-init"
-version = "2.1.0"
+version = "2.2.2"
 description = "Project management tool for UV + FastAPI + Vue3 + Electron desktop applications"
 readme = "README.md"
 requires-python = ">=3.12"

xb_init-2.2.2/tests/test_cli.py

@@ -0,0 +1,88 @@
+from click.testing import CliRunner
+
+import xb.commands.init as init_module
+from xb import cli
+
+
+def test_upgrade_option_runs_without_subcommand(monkeypatch):
+    called = []
+    monkeypatch.setattr(cli, "run_upgrade", lambda: called.append(True))
+
+    result = CliRunner().invoke(cli.main, ["--upgrade"])
+
+    assert result.exit_code == 0
+    assert called == [True]
+    assert "Missing command" not in result.output
+
+
+def _invoke_init(monkeypatch, tmp_path, args, password):
+    """跑 init 命令但替换掉耗时/有副作用的步骤，捕获传给模板引擎的参数。"""
+    captured = {}
+    monkeypatch.setattr(init_module, "get_latest_if_newer", lambda _v: None)
+    monkeypatch.setattr(init_module.shutil, "which", lambda _name: None)
+    monkeypatch.setattr(init_module, "init_git_repo", lambda *_a, **_k: True)
+    monkeypatch.setattr(
+        init_module.TemplateEngine,
+        "render_project",
+        lambda self, **kwargs: captured.update(kwargs),
+    )
+
+    result = CliRunner().invoke(
+        cli.main, ["init", str(tmp_path / "demo"), *args], input=f"{password}\n"
+    )
+    assert result.exit_code == 0, result.output
+    return captured, result.output
+
+
+def test_update_implies_sudoers(monkeypatch, tmp_path):
+    captured, output = _invoke_init(monkeypatch, tmp_path, ["--update"], "pw123")
+
+    assert captured["enable_update"] is True
+    assert captured["enable_sudo"] is True
+    assert captured["sudo_password"] == "pw123"
+    assert "自动附带 --sudoers" in output
+
+
+def test_sudoers_alone_still_prompts(monkeypatch, tmp_path):
+    captured, output = _invoke_init(monkeypatch, tmp_path, ["--sudoers"], "pw123")
+
+    assert captured["enable_update"] is False
+    assert captured["enable_sudo"] is True
+    assert captured["sudo_password"] == "pw123"
+    assert "自动附带" not in output
+
+
+def test_plain_init_has_no_sudo(monkeypatch, tmp_path):
+    captured, output = _invoke_init(monkeypatch, tmp_path, [], "")
+
+    assert captured["enable_update"] is False
+    assert captured["enable_sudo"] is False
+    assert captured["sudo_password"] == ""
+
+
+def test_pick_fastest_from_nrm_output():
+    output = """  npm ---------- 807 ms
+  yarn --------- 795 ms
+  tencent ------ 284 ms
+  cnpm --------- 803 ms
+* taobao ------- 163 ms
+  npmMirror ---- 1265 ms (Fetch error, if this is your private registry, please ignore)
+  huawei ------- 96 ms
+"""
+    assert init_module._pick_fastest_from_nrm_output(output) == ("huawei", 96)
+
+
+def test_pick_fastest_from_nrm_output_all_failed():
+    output = "  npmMirror ---- 1265 ms (Fetch error, if this is your private registry, please ignore)\n"
+    assert init_module._pick_fastest_from_nrm_output(output) == ("", None)
+
+
+def test_windows_skips_sudo_password(monkeypatch, tmp_path):
+    monkeypatch.setattr(init_module.sys, "platform", "win32")
+    captured, output = _invoke_init(
+        monkeypatch, tmp_path, ["--sudoers"], "should-not-be-used"
+    )
+
+    assert captured["enable_sudo"] is True
+    assert captured["sudo_password"] == ""
+    assert "跳过密码输入" in output

xb_init-2.2.2/tests/test_update_templates.py

@@ -0,0 +1,77 @@
+import json
+from pathlib import Path
+
+import pytest
+
+from xb.utils.template_engine import TemplateEngine
+
+UPDATE_FILES = [
+    "backend/services/updater.py",
+    "backend/services/feishu_client.py",
+    "backend/api/update/__init__.py",
+    "backend/managers/secret_obfuscator.py",
+    "backend/managers/sudoers_manager.py",
+    "backend/app_version.py",
+    "scripts/feishu_upload.py",
+    "configs/config_changes.json",
+    "frontend/src/components/version/UpdatePanel.vue",
+    "frontend/src/components/version/CommitHistoryPanel.vue",
+    "frontend/src/composables/useUpdate.js",
+]
+
+
+@pytest.fixture()
+def render_project(tmp_path):
+    def _render(name: str, **kwargs) -> Path:
+        target = tmp_path / name
+        TemplateEngine().render_project(
+            target_dir=target,
+            package_name=name,
+            **kwargs,
+        )
+        return target
+
+    return _render
+
+
+def test_init_without_update_skips_update_files(render_project):
+    target = render_project("plain_app")
+
+    for rel in UPDATE_FILES:
+        assert not (target / rel).exists(), f"不应生成 {rel}"
+    assert "update_router" not in (target / "backend" / "main.py").read_text()
+
+
+def test_init_with_update_renders_update_files(render_project):
+    target = render_project("updatable_app", enable_update=True)
+
+    for rel in UPDATE_FILES:
+        assert (target / rel).exists(), f"缺少 {rel}"
+
+    # 配置迁移清单是合法 JSON
+    json.loads((target / "configs" / "config_changes.json").read_text())
+
+    # main.py 注册了更新路由
+    assert "app.include_router(update_router" in (target / "backend" / "main.py").read_text()
+
+    # secret_obfuscator 与 feishu_upload 的混淆密钥保持一致
+    obf = (target / "backend" / "managers" / "secret_obfuscator.py").read_text()
+    upload = (target / "scripts" / "feishu_upload.py").read_text()
+    key_line = next(line for line in obf.splitlines() if line.startswith("_KEY ="))
+    key = key_line.split("=", 1)[1].strip()
+    assert key in upload
+
+    # version_manager 会同步 app_version.py 与 package-lock.json
+    vm = (target / "version" / "scripts" / "version_manager.py").read_text()
+    assert "update_backend_version" in vm
+    assert "update_package_lock_version" in vm
+
+    # build.py 具备发布编排
+    build = (target / "build.py").read_text()
+    assert "--upload-only" in build
+    assert "_upload_stage" in build
+
+    # App.vue 挂载的 GitVersionBadge 集成了更新面板
+    badge = (target / "frontend" / "src" / "components" / "GitVersionBadge.vue").read_text()
+    assert "UpdatePanel" in badge
+    assert "CommitHistoryPanel" in badge

{xb_init-2.1.0 → xb_init-2.2.2}/uv.lock

@@ -414,7 +414,7 @@ wheels = [
 
 [[package]]
 name = "xb-init"
-version = "2.1.0"
+version = "2.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

{xb_init-2.1.0 → xb_init-2.2.2}/xb/commands/init.py

@@ -4,6 +4,7 @@ xb init 命令实现
 """
 
 import os
+import re
 import shutil
 import subprocess
 import sys
@@ -140,6 +141,67 @@ def remove_existing_project(path: Path) -> None:
     shutil.rmtree(path, onexc=clear_readonly)
 
 
+def _pick_fastest_from_nrm_output(output: str) -> tuple[str, int | None]:
+    """解析 `nrm test` 输出，返回 (最快源名, 毫秒)；无可用源返回 ("", None)。
+
+    输出形如 "  huawei ------- 96 ms"，不可用源带 "(Fetch error ...)" 标记。
+    """
+    best_name, best_ms = "", None
+    for line in output.splitlines():
+        match = re.match(r"^\s*\*?\s*(\S+)\s+-+\s+(\d+)\s+ms\b(.*)$", line)
+        if not match or "Fetch error" in match.group(3):
+            continue
+        elapsed = int(match.group(2))
+        if best_ms is None or elapsed < best_ms:
+            best_name, best_ms = match.group(1), elapsed
+    return best_name, best_ms
+
+
+def nrm_speedtest(console: Console, npm_command: str) -> None:
+    """npm install 前用 nrm 测速所有内置源并自动切换到最快的源。
+
+    - 未安装 nrm 时自动全局安装（npm install -g nrm）
+    - nrm use 修改全局 npm 配置（~/.npmrc），对本机所有项目生效
+    - 任何失败只告警，不阻塞项目创建（沿用当前源继续安装）
+    """
+    nrm_command = "nrm.cmd" if os.name == "nt" and shutil.which("nrm.cmd") else "nrm"
+    try:
+        if not shutil.which(nrm_command):
+            console.print("[dim]未检测到 nrm，自动安装（npm install -g nrm）...[/dim]")
+            subprocess.run(
+                [npm_command, "install", "-g", "nrm"],
+                capture_output=True,
+                text=True,
+                timeout=120,
+                check=True,
+            )
+
+        console.print("[dim]正在测速 npm 镜像源（nrm test）...[/dim]")
+        result = subprocess.run(
+            [nrm_command, "test"],
+            capture_output=True,
+            text=True,
+            timeout=180,
+            check=True,
+        )
+    except Exception as e:
+        console.print(f"[yellow]⚠[/yellow]  nrm 测速不可用（沿用当前 npm 源）: {e}")
+        return
+
+    best_name, best_ms = _pick_fastest_from_nrm_output(result.stdout)
+    if not best_name:
+        console.print("[yellow]⚠[/yellow]  nrm 测速无可用结果（沿用当前 npm 源）")
+        return
+
+    console.print(f"[green]✓[/green] 最快 npm 源: [cyan]{best_name}[/cyan]（{best_ms} ms），切换中...")
+    try:
+        subprocess.run(
+            [nrm_command, "use", best_name], capture_output=True, text=True, check=True
+        )
+    except Exception as e:
+        console.print(f"[yellow]⚠[/yellow]  切换 npm 源失败（沿用当前源）: {e}")
+
+
 class ParamSummaryCommand(ChineseHelpCommand):
     pass
 
@@ -177,6 +239,13 @@ class XbGroup(click.Group):
     default=False,
     help="启用内置 Web 终端（Linux/macOS 使用 bash，Windows 使用 PowerShell）",
 )
+@click.option(
+    "--update",
+    "update",
+    is_flag=True,
+    default=False,
+    help="启用应用内自动更新（飞书云盘发布 + 版本检查 + 下载安装）；默认附带 --sudoers 免密",
+)
 @click.option(
     "--icon",
     "icon",
@@ -184,7 +253,13 @@ class XbGroup(click.Group):
     default=None,
     help="应用图标 PNG 路径；不传时自动查找 ./app-icon.png、./icon.png、./assets/icon.png 等约定路径",
 )
-def init_command(package: str, sudoers: bool, terminal: bool, icon: str | None):
+def init_command(
+    package: str,
+    sudoers: bool,
+    terminal: bool,
+    icon: str | None,
+    update: bool,
+):
     """
     初始化项目结构
 
@@ -196,6 +271,7 @@ def init_command(package: str, sudoers: bool, terminal: bool, icon: str | None):
         xb init demo
         xb init myapp --sudoers
         xb init myapp --terminal
+        xb init myapp --update
         xb init /home/user/projects/myapp
         xb init ../other_dir/demo
     """
@@ -240,23 +316,37 @@ def init_command(package: str, sudoers: bool, terminal: bool, icon: str | None):
         console.print(f"[green]→[/green] 使用应用图标: [cyan]{icon_path}[/cyan]")
 
     # sudo 免密配置
+    # --update 默认附带 --sudoers：Ubuntu 下应用内安装更新依赖免密 dpkg
     enable_sudo = False
     sudo_password = ""
 
-    if sudoers:
-        console.print()
+    if update and not sudoers:
         console.print(
-            Panel.fit(
-                "[bold cyan]Sudo 免密配置[/bold cyan]\n\n"
-                "启用 sudo 免密执行特定命令。\n"
-                "密码将以明文存储在 configs/secrets.yaml 中,\n"
-                "请确保该文件权限设置为 600 (仅所有者可读写)。",
-                border_style="cyan",
-            )
+            "[cyan]ℹ[/cyan] 已启用 --update，自动附带 --sudoers "
+            "（Ubuntu 应用内安装更新需要 sudo 免密）"
         )
+        sudoers = True
+
+    if sudoers:
+        if sys.platform.startswith("win"):
+            # Windows 没有 sudo 概念：仍生成 sudoers_manager（运行时自动 no-op），
+            # 但不询问、不写入密码
+            console.print("[dim]Windows 无需 sudo 免密，跳过密码输入[/dim]")
+            enable_sudo = True
+        else:
+            console.print()
+            console.print(
+                Panel.fit(
+                    "[bold cyan]Sudo 免密配置[/bold cyan]\n\n"
+                    "启用 sudo 免密执行特定命令。\n"
+                    "密码将以明文存储在 configs/secrets.yaml 中,\n"
+                    "请确保该文件权限设置为 600 (仅所有者可读写)。",
+                    border_style="cyan",
+                )
+            )
 
-        sudo_password = Prompt.ask("[cyan]请输入 sudo 密码[/cyan]", password=True)
-        enable_sudo = True
+            sudo_password = Prompt.ask("[cyan]请输入 sudo 密码[/cyan]", password=True)
+            enable_sudo = True
 
     # 创建项目
     console.print()
@@ -269,15 +359,19 @@ def init_command(package: str, sudoers: bool, terminal: bool, icon: str | None):
             package_name=package_name,
             enable_sudo=enable_sudo,
             enable_terminal=terminal,
+            enable_update=update,
             sudo_password=sudo_password,
             icon_path=icon_path,
         )
 
         # 安装前端和 Electron 依赖（生成 package-lock.json 纳入首次 commit）
-        # 镜像源由各子目录的 .npmrc 提供；electron 需下载约 200MB 二进制，超时给足 10 分钟
+        # npm 源由 nrm 全局管理；--no-audit/--no-fund 减少安装期网络请求
+        # electron 需下载约 200MB 二进制，超时给足 10 分钟
         if shutil.which("npm"):
             # Windows 上 npm 通常是 npm.cmd，CreateProcess 不能可靠地直接解析裸 npm。
             npm_command = "npm.cmd" if os.name == "nt" and shutil.which("npm.cmd") else "npm"
+            # 安装前测速切换最快 npm 源（nrm 缺失时自动安装；失败不阻塞创建）
+            nrm_speedtest(console, npm_command)
             for sub in ("frontend", "electron"):
                 sub_dir = target_dir / sub
                 if (sub_dir / "package.json").exists():
@@ -294,7 +388,7 @@ def init_command(package: str, sudoers: bool, terminal: bool, icon: str | None):
                                 ),
                             })
                         result = subprocess.run(
-                            [npm_command, "install"],
+                            [npm_command, "install", "--no-audit", "--no-fund"],
                             cwd=sub_dir,
                             env=environment,
                             capture_output=True,

{xb_init-2.1.0 → xb_init-2.2.2}/xb/templates/backend/api/config.py.j2

@@ -1,5 +1,6 @@
 import pathlib
 import shutil
+import sys
 import yaml
 from fastapi import APIRouter, HTTPException
 from pydantic import BaseModel, Field
@@ -12,6 +13,13 @@ from managers import sudoers_manager
 router = APIRouter()
 logger = get_logger(__name__)
 
+# 运行平台标识（windows / macos / linux），前端据此隐藏平台无关的配置项
+_PLATFORM = (
+    "windows" if sys.platform == "win32"
+    else "macos" if sys.platform == "darwin"
+    else "linux"
+)
+
 
 [% if enable_sudo %]
 class ConfigRequest(BaseModel):
@@ -111,9 +119,12 @@ async def get_settings():
             "config_path": str(config_file),
             "secrets_path": str(secrets_file),
             "is_packaged": path_manager.is_packaged,
+            "platform": _PLATFORM,
 [% if enable_sudo %]
             "sudo_password_configured": bool(path_manager.get_config_value("sudo_password", config_file="secrets.yaml")),
             "sudo_password_locked": _sudo_password_locked(),
+            # Windows/macOS 上 sudoers_manager.required 为 False，前端隐藏 Sudo 密码卡片
+            "requires_sudo": sudoers_manager.required,
 [% endif %]
             "ports": {
                 "backend": int(ports.get("backend") or 8000),
@@ -174,6 +185,9 @@ async def save_settings(req: AppSettingsRequest):
 @router.get("/config/check")
 async def check_config():
     secrets_file = path_manager.get_config_path("secrets.yaml")
+    # Windows/macOS 无 sudo 概念，前端据此隐藏配置入口、跳过首启弹窗
+    requires_sudo = sudoers_manager.required
+    platform = _PLATFORM
 
     if not secrets_file.exists():
         return {
@@ -182,6 +196,8 @@ async def check_config():
             "message": "密钥配置文件不存在",
             "config_path": str(secrets_file),
             "is_packaged": path_manager.is_packaged,
+            "requires_sudo": requires_sudo,
+            "platform": platform,
         }
 
     try:
@@ -194,6 +210,8 @@ async def check_config():
                 "message": "密码未设置",
                 "config_path": str(secrets_file),
                 "is_packaged": path_manager.is_packaged,
+                "requires_sudo": requires_sudo,
+                "platform": platform,
             }
 
         if not sudoers_manager.verify_password(password):
@@ -203,6 +221,8 @@ async def check_config():
                 "message": "密码不正确",
                 "config_path": str(secrets_file),
                 "is_packaged": path_manager.is_packaged,
+                "requires_sudo": requires_sudo,
+                "platform": platform,
             }
 
         sudoers_manager.setup()
@@ -212,6 +232,8 @@ async def check_config():
             "message": "配置正常",
             "config_path": str(secrets_file),
             "is_packaged": path_manager.is_packaged,
+            "requires_sudo": requires_sudo,
+            "platform": platform,
         }
     except HTTPException:
         raise