启动失败怎么办？（机房电脑排错手册）
================================================================
先看这一段
----------------------------------------------------------------
正确用法只有两步：
  1. 把「hadoop伪分布式-AI」整个文件夹（或收到的压缩包解压后的同名文件夹）准备好；
  2. 进入该文件夹，双击【启动.cmd】。

出现一个黑色窗口 + 自动打开浏览器，就说明成功了。
黑色窗口在整个上课期间不要关闭；下课直接关掉它就行。

如果报错，请先看下面几种情况。所有错误都会同时写进同目录的 run.log，
把 run.log 或窗口截图发给老师即可。


情况一：窗口一闪就没了 / 提示 'xxx' 不是内部或外部命令
----------------------------------------------------------------
原因：这是旧版本的编码问题（.cmd 里的中文在 cmd.exe 里被当成命令执行）。
现在的版本已经修好：启动.cmd 里只有英文，中文提示都放在 run.ps1 里。
处理：确认你用的是新解压出来的包（启动.cmd 的修改时间应该是最近一次）。
      如果还是同样报错，说明用的还是旧包，请重新解压最新的压缩包。


情况二：提示“无法加载文件 run.ps1，因为在此系统上禁止运行脚本”
----------------------------------------------------------------
原因：Windows 默认禁止运行 PowerShell 脚本。
处理：不用管它，【启动.cmd】里已经带了 -ExecutionPolicy Bypass 参数。
      如果你是直接右键 run.ps1 → 使用 PowerShell 运行的，请改用【启动.cmd】。
      也可以手动在 PowerShell 里执行：
          powershell -ExecutionPolicy Bypass -File run.ps1


情况三：提示“没有找到 Node.js 运行环境”
----------------------------------------------------------------
处理顺序：
  1. 看解压出来的文件夹里有没有 node\node.exe；
     如果 node 文件夹是空的，说明压缩包没解压完整（有些解压软件会跳过 exe），
     换用 Windows 自带的“解压到当前文件夹”，或者 7-Zip 重新解压。
  2. 检查杀毒软件/Windows 安全中心有没有把这几个文件隔离掉，加入信任区后重试。
  3. 也可以自行安装 Node.js 18 或更高版本（https://nodejs.org），再双击【启动.cmd】。


情况四：提示“Node 无法运行（可能被杀毒软件拦截或文件损坏）”
----------------------------------------------------------------
  1. 把整个文件夹加入杀毒软件 / Windows 安全中心的排除项；
  2. 右键 node\node.exe → 属性 → 下方若有“解除锁定”，勾选后确定；
  3. 或者安装系统版 Node.js 18+ 后重试。


情况五：提示“程序文件不完整，解压时可能丢文件了”
----------------------------------------------------------------
说明解压丢了文件。请重新完整解压，并且务必在“解压出来的文件夹里”双击【启动.cmd】，
不要直接在压缩包预览窗口里点运行。


情况六：浏览器没有自动打开
----------------------------------------------------------------
不影响使用。看黑色窗口里打印的地址（例如 http://127.0.0.1:6180/index.html），
手动复制到浏览器打开即可。
如果默认端口 6180 被别的软件占用，程序会自动换成 6181、6182……，
窗口里会明确打印实际地址，照那个地址打开就行。


情况七：页面能打开，但打开后一片空白 / 卡住
----------------------------------------------------------------
  1. 按 Ctrl+F5 强制刷新；
  2. 换用 Chrome、Edge 等新版本浏览器（不支持 IE）；
  3. 如果之前浏览器缓存了旧版本，清除一下缓存或换个浏览器再试。


情况八：想确认程序本身有没有问题（老师用）
----------------------------------------------------------------
在本目录打开命令行（Shift + 右键 → 在此处打开 PowerShell 窗口），执行：

    .\node\node.exe tools\selftest.mjs

会跑一遍完整部署流程并逐项断言（76 项），最后打印“通过 N 项，失败 M 项”。
全部通过（失败 0 项）说明模拟器本身没问题。


情况九：想换端口、想静默启动（老师用）
----------------------------------------------------------------
  换端口：在命令行里先设置环境变量再启动
      set PORT=7000
      .\node\node.exe server.mjs
  不自动打开浏览器：
      set LAB_NO_BROWSER=1
      .\node\node.exe server.mjs


附：目录里各文件的作用
----------------------------------------------------------------
  启动.cmd          双击这个（英文提示，任何 Windows 都能正常执行）
  run.ps1           真正干活的启动脚本（中文提示都在这里，先做环境自检再启动服务）
  server.mjs        本地静态服务（零依赖，只用 Node 内置模块，只监听 127.0.0.1）
  node\node.exe     随包携带的 Node 运行环境
  app\              网页应用本体
  资料\             使用说明、学生任务单、本排错手册
  run.log           每次启动生成的日志（排错用）
  tools\selftest.mjs 自动化验收脚本