xb-init 2.5.2__tar.gz → 2.6.2__tar.gz

{xb_init-2.5.2 → xb_init-2.6.2}/.gitignore

@@ -36,3 +36,5 @@ htmlcov/
 *.log
 .env
 .env.local
+
+uv.lock

{xb_init-2.5.2 → xb_init-2.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xb-init
-Version: 2.5.2
+Version: 2.6.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
@@ -41,7 +41,6 @@ Description-Content-Type: text/markdown
 - 自动 `git init` 并提交首个 commit（含 lock 文件）
 - 自动生成 `AGENTS.md`（AI 编码助手协作约定）
 - 内置全局亮色/暗色主题切换
-- 可选 sudo 免密配置（`--sudoers`）
 - 可选内置终端（`--terminal`）
 - 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
 - 可选自定义应用图标（`--icon`）
@@ -75,15 +74,10 @@ xb --help
 # 创建项目
 xb init demo
 
-# 带 sudo 免密配置
-xb init demo --sudoers
 # 带内置终端
 xb init demo --terminal
 
-# 同时启用终端和 sudo 免密配置
-xb init demo --terminal --sudoers
-
-# 启用应用内自动更新（自动附带 --sudoers 免密，输入 sudo 密码即可）
+# 启用应用内自动更新（Linux 提权走 polkit，管理员组无感更新，无密码落盘）
 xb init demo --update
 
 # 带自定义图标
@@ -110,16 +104,14 @@ xb dev stop
   ────────────────────────────────────────────────────────
 ❯ [ ] 应用显示名 : Demo
   [ ] 端口（后端/前端） : 8000 / 8001
-  [ ] sudo 免密  ✘  (Linux 应用内更新需要)
   [ ] 内置终端  ✘  (Web 终端组件)
-  [ ] 应用内更新  ✘  (自动附带 sudo 免密)
+  [ ] 应用内更新  ✘  (Linux 提权走 polkit，无密码落盘)
   [ ] 应用图标 : 使用默认
   [ ] 跳过依赖安装  ✘  (离线环境可跳过)
 ```
 
-- `--name/--port/--sudoers/--terminal/--update/--icon/--skip-install` 传了的参数
+- `--name/--port/--terminal/--update/--icon/--skip-install` 传了的参数
   直接预填进表单并勾上，回车即确认，老用法不受影响
-- 勾选"应用内更新"会自动勾上"sudo 免密"，且后者此时不可单独取消
 - 文本行（显示名/端口/图标）勾选时若仍是默认值则自动清空，直接输入即可
 - stdin 非终端时（脚本/CI 管道调用）自动跳过表单，沿用 CLI 参数
 
@@ -149,8 +141,8 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 >     nrm 全局管理
 >   - electron 约 200MB 二进制走华为云镜像下载
 >   - uv 源同样自动优化：首次依赖同步（dev.py）与后端构建（build.py -b/-a）
->     前用 [chsrc](https://github.com/RubyMetric/chsrc) 测速切换最快镜像
->     （`chsrc set uv first`，未安装 chsrc 时自动安装）
+>     前并行实测各镜像（要求最终 HTTP 200），自动切换到最快可用源（约
+>     1-6 秒，纯标准库实现，无需额外工具）
 >   - 若安装失败或超时，会打印提示但不中断项目创建，可稍后手动重试
 > - 执行 `git init` 并提交首个 commit（包含所有文件和 lock 文件）
 > - 若检测到 PyPI 有新版 xb，会询问是否先升级再创建项目
@@ -160,12 +152,12 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--name 显示名] [--port 9000] [--sudoers] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
+| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
 | `xb version [patch\|minor\|major]` | 读取或更新版本号 |
-| `xb doctor` | 检查开发环境 |
+| `xb doctor [--fix]` | 检查开发环境；`--fix` 自动安装 nrm/uv、交互式配置 git 身份 |
 | `xb --upgrade` | 升级 xb 到 PyPI 最新版本 |
 
 ## 应用图标
@@ -209,8 +201,8 @@ xb init demo --icon ./my-icon.png
 
 **客户端：** 启动时 / 每小时 / 点版本号徽章时检查更新；发现新版本后下载
 （4 线程分块 + SHA256 校验 + `.part` 防半截包）→ 备份配置 → 按
-`config_changes.json` 迁移 → Ubuntu 趁应用存活时免密 `sudo dpkg -i`
-（`--update` 默认附带 `--sudoers` 免密），Windows 等退出后静默安装。
+`config_changes.json` 迁移 → Ubuntu 走 polkit 免密安装（授权规则由 DEB
+postinst 预部署，管理员组无感、无密码落盘），Windows 等退出后静默安装。
 
 **飞书侧准备：** 开放平台建自建应用 → 开通 `drive:drive` 权限并发布 →
 建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
@@ -279,8 +271,8 @@ xb/
 ## 环境要求
 
 - **Python**: 3.12+
-- **Node.js**: 16+
-- **npm**: 8+
+- **Node.js**: 20.19+（推荐 22 LTS；模板前端使用 Vite 8，Node 18 及以下会构建报错）
+- **npm**: 10+
 - **uv**: 已安装
 - **OS**: Windows 10/11 或 Ubuntu/Debian
 - **Windows 终端**: 使用 `--terminal` 时自动安装 Windows 专用 `pywinpty`

{xb_init-2.5.2 → xb_init-2.6.2}/README.md

@@ -12,7 +12,6 @@
 - 自动 `git init` 并提交首个 commit（含 lock 文件）
 - 自动生成 `AGENTS.md`（AI 编码助手协作约定）
 - 内置全局亮色/暗色主题切换
-- 可选 sudo 免密配置（`--sudoers`）
 - 可选内置终端（`--terminal`）
 - 可选应用内自动更新（`--update`，飞书云盘发布 + 版本检查 + 下载校验 + 自动安装）
 - 可选自定义应用图标（`--icon`）
@@ -46,15 +45,10 @@ xb --help
 # 创建项目
 xb init demo
 
-# 带 sudo 免密配置
-xb init demo --sudoers
 # 带内置终端
 xb init demo --terminal
 
-# 同时启用终端和 sudo 免密配置
-xb init demo --terminal --sudoers
-
-# 启用应用内自动更新（自动附带 --sudoers 免密，输入 sudo 密码即可）
+# 启用应用内自动更新（Linux 提权走 polkit，管理员组无感更新，无密码落盘）
 xb init demo --update
 
 # 带自定义图标
@@ -81,16 +75,14 @@ xb dev stop
   ────────────────────────────────────────────────────────
 ❯ [ ] 应用显示名 : Demo
   [ ] 端口（后端/前端） : 8000 / 8001
-  [ ] sudo 免密  ✘  (Linux 应用内更新需要)
   [ ] 内置终端  ✘  (Web 终端组件)
-  [ ] 应用内更新  ✘  (自动附带 sudo 免密)
+  [ ] 应用内更新  ✘  (Linux 提权走 polkit，无密码落盘)
   [ ] 应用图标 : 使用默认
   [ ] 跳过依赖安装  ✘  (离线环境可跳过)
 ```
 
-- `--name/--port/--sudoers/--terminal/--update/--icon/--skip-install` 传了的参数
+- `--name/--port/--terminal/--update/--icon/--skip-install` 传了的参数
   直接预填进表单并勾上，回车即确认，老用法不受影响
-- 勾选"应用内更新"会自动勾上"sudo 免密"，且后者此时不可单独取消
 - 文本行（显示名/端口/图标）勾选时若仍是默认值则自动清空，直接输入即可
 - stdin 非终端时（脚本/CI 管道调用）自动跳过表单，沿用 CLI 参数
 
@@ -120,8 +112,8 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 >     nrm 全局管理
 >   - electron 约 200MB 二进制走华为云镜像下载
 >   - uv 源同样自动优化：首次依赖同步（dev.py）与后端构建（build.py -b/-a）
->     前用 [chsrc](https://github.com/RubyMetric/chsrc) 测速切换最快镜像
->     （`chsrc set uv first`，未安装 chsrc 时自动安装）
+>     前并行实测各镜像（要求最终 HTTP 200），自动切换到最快可用源（约
+>     1-6 秒，纯标准库实现，无需额外工具）
 >   - 若安装失败或超时，会打印提示但不中断项目创建，可稍后手动重试
 > - 执行 `git init` 并提交首个 commit（包含所有文件和 lock 文件）
 > - 若检测到 PyPI 有新版 xb，会询问是否先升级再创建项目
@@ -131,12 +123,12 @@ Electron 二进制镜像通过 `ELECTRON_MIRROR` 环境变量注入。
 
 | 命令 | 说明 |
 |------|------|
-| `xb init <name> [--name 显示名] [--port 9000] [--sudoers] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
+| `xb init <name> [--name 显示名] [--port 9000] [--terminal] [--update] [--icon PATH] [--skip-install]` | 初始化项目 |
 | `xb dev [start\|stop\|status]` | 启动/停止/查看开发环境 |
 | `xb build [all\|frontend\|backend\|electron]` | 构建项目 |
 | `xb build -f / -b / -e / -a` | 构建快捷 flag |
 | `xb version [patch\|minor\|major]` | 读取或更新版本号 |
-| `xb doctor` | 检查开发环境 |
+| `xb doctor [--fix]` | 检查开发环境；`--fix` 自动安装 nrm/uv、交互式配置 git 身份 |
 | `xb --upgrade` | 升级 xb 到 PyPI 最新版本 |
 
 ## 应用图标
@@ -180,8 +172,8 @@ xb init demo --icon ./my-icon.png
 
 **客户端：** 启动时 / 每小时 / 点版本号徽章时检查更新；发现新版本后下载
 （4 线程分块 + SHA256 校验 + `.part` 防半截包）→ 备份配置 → 按
-`config_changes.json` 迁移 → Ubuntu 趁应用存活时免密 `sudo dpkg -i`
-（`--update` 默认附带 `--sudoers` 免密），Windows 等退出后静默安装。
+`config_changes.json` 迁移 → Ubuntu 走 polkit 免密安装（授权规则由 DEB
+postinst 预部署，管理员组无感、无密码落盘），Windows 等退出后静默安装。
 
 **飞书侧准备：** 开放平台建自建应用 → 开通 `drive:drive` 权限并发布 →
 建云盘文件夹，完整链接填入 `update_folder_url`。开发模式（源码运行）不支持
@@ -250,8 +242,8 @@ xb/
 ## 环境要求
 
 - **Python**: 3.12+
-- **Node.js**: 16+
-- **npm**: 8+
+- **Node.js**: 20.19+（推荐 22 LTS；模板前端使用 Vite 8，Node 18 及以下会构建报错）
+- **npm**: 10+
 - **uv**: 已安装
 - **OS**: Windows 10/11 或 Ubuntu/Debian
 - **Windows 终端**: 使用 `--terminal` 时自动安装 Windows 专用 `pywinpty`

{xb_init-2.5.2 → xb_init-2.6.2}/pyproject.toml

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

{xb_init-2.5.2 → xb_init-2.6.2}/tests/test_cli.py

@@ -15,15 +15,9 @@ def test_upgrade_option_runs_without_subcommand(monkeypatch):
     assert "Missing command" not in result.output
 
 
-def _invoke_init(monkeypatch, tmp_path, args, password, platform="linux"):
-    """跑 init 命令但替换掉耗时/有副作用的步骤，捕获传给模板引擎的参数。
-
-    - 密码通过 monkeypatch rich Prompt.ask 注入而非 stdin 管道
-    - platform 默认 patch 为 linux（询问密码的行为只在 Linux 分支），
-      否则真 Windows runner 上 sys.platform=win32 会直接跳过密码询问
-    """
+def _invoke_init(monkeypatch, tmp_path, args, platform="linux"):
+    """跑 init 命令但替换掉耗时/有副作用的步骤，捕获传给模板引擎的参数。"""
     captured = {}
-    asked = []
     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)
@@ -34,46 +28,39 @@ def _invoke_init(monkeypatch, tmp_path, args, password, platform="linux"):
         lambda self, **kwargs: captured.update(kwargs),
     )
 
-    def fake_ask(*_args, **_kwargs):
-        asked.append(True)
-        return password
-
-    monkeypatch.setattr(init_module.Prompt, "ask", fake_ask)
-
     result = CliRunner().invoke(
         cli.main, ["init", str(tmp_path / "demo"), *args], input="\n"
     )
     assert result.exit_code == 0, result.output
-    return captured, result.output, asked
+    return captured, result.output
 
 
-def test_update_implies_sudoers(monkeypatch, tmp_path):
-    captured, _output, _asked = _invoke_init(monkeypatch, tmp_path, ["--update"], "pw123")
+def test_update_passed_through(monkeypatch, tmp_path):
+    captured, output = _invoke_init(monkeypatch, tmp_path, ["--update"])
 
     assert captured["enable_update"] is True
-    assert captured["enable_sudo"] is True
-    assert captured["sudo_password"] == "pw123"
+    # Linux 上 --update 提示走 polkit（不再有 sudoers 密码询问）
+    assert "polkit" in output
 
 
-def test_sudoers_alone_still_prompts(monkeypatch, tmp_path):
-    captured, output, asked = _invoke_init(monkeypatch, tmp_path, ["--sudoers"], "pw123")
+def test_update_hint_suppressed_on_windows(monkeypatch, tmp_path):
+    captured, output = _invoke_init(
+        monkeypatch, tmp_path, ["--update"], platform="win32"
+    )
 
-    assert captured["enable_update"] is False
-    assert captured["enable_sudo"] is True
-    assert captured["sudo_password"] == "pw123"
-    assert "自动附带" not in output
+    assert captured["enable_update"] is True
+    assert "polkit" not in output
 
 
-def test_plain_init_has_no_sudo(monkeypatch, tmp_path):
-    captured, output, asked = _invoke_init(monkeypatch, tmp_path, [], "")
+def test_plain_init_has_no_update(monkeypatch, tmp_path):
+    captured, _ = _invoke_init(monkeypatch, tmp_path, [])
 
     assert captured["enable_update"] is False
-    assert captured["enable_sudo"] is False
-    assert captured["sudo_password"] == ""
+    assert captured["enable_terminal"] is False
 
 
 def test_display_name_passed_through(monkeypatch, tmp_path):
-    captured, _, _asked = _invoke_init(
+    captured, _ = _invoke_init(
         monkeypatch, tmp_path, ["--name", "我的应用"], ""
     )
 
@@ -81,19 +68,19 @@ def test_display_name_passed_through(monkeypatch, tmp_path):
 
 
 def test_display_name_defaults_to_none(monkeypatch, tmp_path):
-    captured, _, _asked = _invoke_init(monkeypatch, tmp_path, [], "")
+    captured, _ = _invoke_init(monkeypatch, tmp_path, [])
 
     assert captured["display_name"] is None
 
 
 def test_port_passed_through(monkeypatch, tmp_path):
-    captured, _output, _asked = _invoke_init(monkeypatch, tmp_path, ["--port", "9100"], "")
+    captured, _output = _invoke_init(monkeypatch, tmp_path, ["--port", "9100"])
 
     assert captured["backend_port"] == 9100
 
 
 def test_port_defaults_to_none(monkeypatch, tmp_path):
-    captured, _, _asked = _invoke_init(monkeypatch, tmp_path, [], "")
+    captured, _ = _invoke_init(monkeypatch, tmp_path, [])
 
     assert captured["backend_port"] is None
 
@@ -123,14 +110,3 @@ def test_pick_fastest_from_nrm_output():
 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):
-    captured, output, asked = _invoke_init(
-        monkeypatch, tmp_path, ["--sudoers"], "should-not-be-used", platform="win32"
-    )
-
-    assert captured["enable_sudo"] is True
-    assert captured["sudo_password"] == ""
-    assert asked == []  # Windows 不询问密码
-    assert "跳过密码输入" in output

{xb_init-2.5.2 → xb_init-2.6.2}/tests/test_config_form.py

@@ -1,17 +1,10 @@
-"""配置表单（ConfigForm）交互逻辑测试：不进键盘循环，直接驱动方法。
-
-表单在 Windows 上会隐藏 sudoers 行，逻辑测试统一以 Linux 形态为准
-（mock os.name），Windows 隐藏行为由 test_sudoers_row_hidden_on_windows 覆盖。
-"""
-
-import unittest.mock as mock
+"""配置表单（ConfigForm）交互逻辑测试：不进键盘循环，直接驱动方法。"""
 
 from xb.utils.config_form import ConfigForm, run_config_form
 
 
 def make_form(cli=None):
-    with mock.patch("xb.utils.config_form.os.name", "posix"):
-        return ConfigForm("demo", cli)
+    return ConfigForm("demo", cli)
 
 
 def _cursor_key(form, key):
@@ -19,28 +12,13 @@ def _cursor_key(form, key):
         i for i, r in enumerate(form.rows) if r["key"] == key)
 
 
-def test_update_checks_sudoers_and_blocks_unchecking():
-    form = make_form()
-    _cursor_key(form, "update")
-    form.toggle()
-    assert form._row("update")["checked"] is True
-    assert form._row("sudoers")["checked"] is True
-
-    # update 勾着时 sudoers 无法单独取消
-    _cursor_key(form, "sudoers")
-    form.toggle()
-    assert form._row("sudoers")["checked"] is True
-    assert form.message  # 有提示
-
-
-def test_sudoers_toggle_without_update():
+def test_toggle_switches_rows():
     form = make_form()
-    _cursor_key(form, "sudoers")
+    _cursor_key(form, "terminal")
     form.toggle()
-    assert form._row("sudoers")["checked"] is True
+    assert form._row("terminal")["checked"] is True
     form.toggle()
-    assert form._row("sudoers")["checked"] is False
-    assert not form.message
+    assert form._row("terminal")["checked"] is False
 
 
 def test_text_row_clears_default_on_first_check():
@@ -68,12 +46,16 @@ def test_text_row_keeps_custom_value_when_rechecked():
     assert form._row("display_name")["value"] == "机器人"
 
 
+def test_no_sudo_row_in_any_platform():
+    """sudoers 行已随 polkit 方案彻底移除，任何平台都不应出现。"""
+    assert not make_form()._has("sudoers")
+
+
 def test_collect_unchecked_items_are_none():
     form = make_form()
     result = form.collect()
     assert result["display_name"] is None
     assert result["port"] is None
-    assert result["sudoers"] is False
     assert result["terminal"] is False
     assert result["update"] is False
     assert result["icon"] is None
@@ -88,7 +70,6 @@ def test_collect_valid_port():
         form.feed_char(ch)
     result = form.collect()
     assert result["port"] == 9200
-    assert result["sudoers"] is False
 
 
 def test_collect_invalid_port_falls_back_to_none():
@@ -102,14 +83,6 @@ def test_collect_invalid_port_falls_back_to_none():
     assert form._row("port")["checked"] is False
 
 
-def test_sudoers_row_hidden_on_windows():
-    with mock.patch("xb.utils.config_form.os.name", "nt"):
-        form = ConfigForm("demo")
-    assert not form._has("sudoers")
-    result = form.collect()
-    assert result["sudoers"] is False
-
-
 def test_backspace_only_on_checked_text_row():
     form = make_form({"display_name": "abc"})
     _cursor_key(form, "display_name")
@@ -124,14 +97,13 @@ def test_run_config_form_skipped_when_not_tty():
     result = run_config_form("demo", {
         "display_name": None,
         "port": 9100,
-        "sudoers": False,
         "terminal": True,
         "update": True,
         "icon": None,
         "skip_install": False,
     })
-    # 非 tty 环境跳过表单，CLI 值原样透传且 update 联动 sudoers
+    # 非 tty 环境跳过表单，CLI 值原样透传
     assert result["port"] == 9100
-    assert result["sudoers"] is True
     assert result["terminal"] is True
+    assert result["update"] is True
     assert result["display_name"] is None

xb_init-2.6.2/tests/test_doctor.py

@@ -0,0 +1,167 @@
+import subprocess
+
+from click.testing import CliRunner
+
+import xb.commands.doctor as doctor_module
+from xb import cli
+from xb.commands.doctor import CheckResult, _fix_nrm
+
+
+def test_doctor_plain_run_does_not_fix(monkeypatch):
+    called = []
+    monkeypatch.setattr(
+        doctor_module,
+        "_collect_checks",
+        lambda: [CheckResult("uv", False, "未找到", fixable=True)],
+    )
+    monkeypatch.setitem(doctor_module._FIXERS, "uv", lambda: called.append(1) or True)
+
+    result = CliRunner().invoke(cli.main, ["doctor"])
+
+    assert result.exit_code == 0
+    assert called == []
+    assert "需要处理" in result.output
+    assert "正在修复" not in result.output
+
+
+def test_doctor_fix_invokes_fixer_and_rechecks(monkeypatch):
+    calls = []
+
+    def fake_checks():
+        return [
+            CheckResult("uv", False, "未找到", fixable=True),
+            CheckResult("Node.js", False, "未找到"),
+        ]
+
+    monkeypatch.setattr(doctor_module, "_collect_checks", fake_checks)
+    monkeypatch.setitem(doctor_module._FIXERS, "uv", lambda: calls.append("uv") or True)
+
+    result = CliRunner().invoke(cli.main, ["doctor", "--fix"])
+
+    assert result.exit_code == 0, result.output
+    assert calls == ["uv"]
+    assert "可自动修复" in result.output
+    assert "uv 已修复" in result.output
+    assert "修复后复查" in result.output
+    # Node.js 缺失不可自动修复，修复循环不应触碰它
+    assert "Node.js 已修复" not in result.output
+
+
+def test_doctor_fix_reports_failure(monkeypatch):
+    monkeypatch.setattr(
+        doctor_module,
+        "_collect_checks",
+        lambda: [CheckResult("uv", False, "未找到", fixable=True)],
+    )
+    monkeypatch.setitem(doctor_module._FIXERS, "uv", lambda: False)
+
+    result = CliRunner().invoke(cli.main, ["doctor", "--fix"])
+
+    assert result.exit_code == 0
+    assert "uv 修复失败" in result.output
+
+
+def test_doctor_fix_nothing_fixable(monkeypatch):
+    monkeypatch.setattr(
+        doctor_module,
+        "_collect_checks",
+        lambda: [CheckResult("Node.js", False, "未找到")],
+    )
+
+    result = CliRunner().invoke(cli.main, ["doctor", "--fix"])
+
+    assert result.exit_code == 0
+    assert "没有可自动修复的问题" in result.output
+
+
+def test_doctor_fix_git_identity(monkeypatch):
+    commands = []
+
+    def fake_run(cmd, **kwargs):
+        commands.append(cmd)
+        return subprocess.CompletedProcess(cmd, 0)
+
+    monkeypatch.setattr(
+        doctor_module,
+        "_collect_checks",
+        lambda: [CheckResult("git 身份", False, "未配置 user.name, user.email", fixable=True)],
+    )
+    monkeypatch.setattr(doctor_module.shutil, "which", lambda name: "/usr/bin/git")
+    monkeypatch.setattr(doctor_module.subprocess, "run", fake_run)
+
+    result = CliRunner().invoke(cli.main, ["doctor", "--fix"], input="张三\nzhangsan@test.com\n")
+
+    assert result.exit_code == 0, result.output
+    assert ["git", "config", "--global", "user.name", "张三"] in commands
+    assert ["git", "config", "--global", "user.email", "zhangsan@test.com"] in commands
+    assert "git 身份 已修复" in result.output
+
+
+def test_git_identity_check_in_collect_checks(monkeypatch):
+    monkeypatch.setattr(doctor_module.shutil, "which", lambda name: "/usr/bin/git")
+    monkeypatch.setattr(
+        doctor_module,
+        "_git_global_config",
+        lambda key: "xb-test" if key == "user.name" else None,
+    )
+    monkeypatch.setattr(doctor_module, "_command_version", lambda *a, **k: "v22.12.0")
+
+    checks = {item.name: item for item in doctor_module._collect_checks()}
+
+    assert checks["git 身份"].ok is False
+    assert "user.email" in checks["git 身份"].detail
+    assert checks["git 身份"].fixable is True
+    assert checks["uv"].fixable is True
+    assert checks["nrm (npm 源测速)"].fixable is True
+    assert checks["Node.js"].fixable is False
+
+
+def test_version_tuple_parses_tool_output():
+    assert doctor_module._version_tuple("v22.23.2") == (22, 23, 2)
+    assert doctor_module._version_tuple("npm 10.9.8") == (10, 9, 8)
+    assert doctor_module._version_tuple("git version 2.43.0") == (2, 43, 0)
+    assert doctor_module._version_tuple("无版本号输出") is None
+    assert doctor_module._version_tuple(None) is None
+    assert doctor_module._version_tuple("") is None
+
+
+def test_node_version_too_low_rejected(monkeypatch):
+    versions = {
+        "uv": "uv 0.12.8 (x86_64-unknown-linux-gnu)",
+        "node": "v18.19.0",
+        "npm": "9.8.1",
+        "git": "git version 2.43.0",
+    }
+    monkeypatch.setattr(doctor_module, "_command_version", lambda name, *a, **k: versions.get(name))
+    monkeypatch.setattr(doctor_module.shutil, "which", lambda name: None)
+
+    checks = {item.name: item for item in doctor_module._collect_checks()}
+
+    assert checks["Node.js"].ok is False
+    assert "版本过低" in checks["Node.js"].detail
+    assert "20.19" in checks["Node.js"].detail
+    assert checks["npm"].ok is False
+    assert checks["uv"].ok is True
+    assert checks["git"].ok is True
+
+
+def test_node_version_met_passes(monkeypatch):
+    versions = {
+        "uv": "uv 0.12.8",
+        "node": "v20.19.0",
+        "npm": "10.9.8",
+        "git": "git version 2.43.0",
+    }
+    monkeypatch.setattr(doctor_module, "_command_version", lambda name, *a, **k: versions.get(name))
+    monkeypatch.setattr(doctor_module.shutil, "which", lambda name: None)
+
+    checks = {item.name: item for item in doctor_module._collect_checks()}
+
+    assert checks["Node.js"].ok is True
+    assert checks["npm"].ok is True
+
+
+def test_fix_nrm_skips_without_npm(monkeypatch):
+    monkeypatch.setattr(doctor_module.shutil, "which", lambda name: None)
+
+    assert _fix_nrm() is False