══════════════════════════════════════════════════════
  黑客模拟器 · Windows 版 v1.3.2   （单文件 EXE）
══════════════════════════════════════════════════════

【怎么用】
  把 HackerSim.exe 拷到电脑上，双击。
  就这样，没有安装过程，不用装 Java。

【关于文件存放在哪 —— 重要】
  第一次运行时会自动解压运行环境，解压位置按这个顺序找：

     ① 如果 exe 本身就放在 D 盘或 E 盘
        → 就在 exe 旁边建一个隐藏文件夹 .hsdata

     ② 否则找系统里第一个可写的非 C 盘
        → D:\HackerSim  →  E:\HackerSim  →  F:\HackerSim …

     ③ 整台电脑只有 C 盘？（学校机房常见）
        → 会弹一个窗问你，点「是」才会继续：
           释放到 C 盘你自己的用户文件夹（%LOCALAPPDATA%\HackerSim）
           不碰系统目录、不需要管理员权限
        → 窗口顶部会出现橙色提示条标明实际位置
        → 点提示条右边的「清理并退出」按钮可一键删干净
           （学校电脑有冰点还原的话，关机自动还原，更干净）

  ★ 只要有 D/E 盘，程序绝不会碰 C 盘 —— C 盘模式必须你亲手点「是」。
    全部拒绝时程序退出，不会偷偷写任何地方。

  解压约 54 MB（已压缩进 exe，exe 本身 31 MB）。
  之后每次启动直接复用，不会重复解压。

【双击后没反应？先看这条】
  v1.3.2 起，如果程序启动后立刻退出，会弹窗告诉你原因
  （以前是静默退出，什么都看不到）。

  如果连弹窗都没有，或弹窗一闪而过：
    1. 找到 exe 旁边的 startup.log，用记事本打开，看最后几行
    2. 给 exe 加 --selftest 跑一次自检（方法见下面「出问题怎么办」）
    3. 确认解压出来的目录里 app\HackerSim.jar 存在且不是 0 字节

  注意：第一次运行会在 exe 旁边建 .hsdata 或 D:\HackerSim 目录，
  解压 54MB 大概 3~8 秒，这期间没有窗口是正常的。

【第一次启动慢一点】
  要解压 150 个文件，大概 3~8 秒，之后都是秒开。

【★ v1.3.0 新增：导入自己的模型】
  除了内置的千问和 DeepSeek，现在可以导入任意 .gguf 模型：
    AI 助手页 → 右上角「模型」→「导入模型…」

  方式一：从网址获取
    粘贴一个 .gguf 文件的下载直链，点「检测并获取」。
    能拿到就直接下载（支持断点续传），拿不到会提示：
    「此应用暂时无法从此网站获取模型，请用户自行下载。」
    这时用浏览器手动下载，再用方式二导入即可。

  方式二：从本地选择
    已经下好的文件直接选。会复制到 models\imported\ 统一管理。

  导入前会自动做审核（界面会显示逐条结果）：
    · 是不是真 GGUF 格式（下成网页/压缩包/可执行文件的会拦下）
    · 内嵌文本有没有危险指令特征
    · 冒名检测：文件名写着 GPT-4 / Claude 但实际只有几 B 参数的，
      会明确标注（这几家公司从不发布 GGUF 权重，那必然是改名货）
    · 二次修改标记：uncensored / abliterated / merge 等会提示
    · 来源域名：hf-mirror / huggingface / modelscope 在可信列表；
      OpenAI / Anthropic 等境外域名会标注「重点关注」但不会拦

  诚实说明：这是「格式与特征检查」，不是安全认证。
  本地推理不会执行模型里的代码，但模型可能输出不当内容——
  所以导入后对话过程中仍会持续监测：
    · 命中可直接执行的危险操作（如 rm -rf /）→ 立即中断并提示
    · 累计 3 次敏感输出 → 该模型被标记为「风险模型」
    · 记录写在本机 audit.log，「模型 → 审核记录」可查看

【★ v1.3.0 新增：内存不够会提前说】
  加载模型前程序会读一下物理内存还剩多少，跟模型需求比一比：
    · 明显不够 → 弹窗「你的电脑暂不支持运行该大模型，
      请更换蒸馏版或者小版本」，你确认后仍然可以强行尝试
    · 偏紧 → 提醒一句，可以继续
    · 读不到内存信息 → 不拦，大胆去干

  生成过程中还有看门狗：内存快见底时抢先中断本次生成，
  把内存还给系统，避免整台电脑卡死。中断会明确提示原因。

【★ 出问题怎么办：自检模式】
  正常双击就是启动。但如果启动失败、白屏、闪退，这样做：

     在 exe 上右键 → 创建快捷方式 → 右键快捷方式 → 属性，
     在「目标」末尾加上一个空格和  --selftest   然后双击这个快捷方式。

  它不会启动界面，而是把整台机器相关的情况查一遍：
     · 每个 DLL 能不能加载（这是远程查不出来的关键项）
     · 解压出的文件齐不齐
     · Java 运行时能不能跑
     · 所有磁盘的类型 / 可写 / 剩余空间

  结果写在两个文件里（都在安装目录或 exe 旁边）：
     startup.log        全部检查项，每条标了 ✓ / ✗ 和错误码
     java_version.txt   Java 运行时的输出

  把这两个文件发回来就能定位问题，不需要截图也不需要描述现象。

  就算不用自检模式，正常启动也会默默写 startup.log——
  哪怕程序崩了，里面也会留一段 [java] 开头的异常记录。

【本地 AI 助手】
  窗口顶部有两个页签： 终端  /  AI 助手

  AI 是真正在你自己电脑上跑的，不是联网调接口：
    · 断网可用，数据不出电脑，不花钱，不限次数
    · 推理引擎是 llama.cpp（纯 CPU，8 核大概 1~3 秒出首字）
    · 模型不随 exe 一起发（太大），第一次用要先下载

  怎么开始：
    ① 切到「AI 助手」页签
    ② 点右上角「模型」按钮
    ③ 选千问 → 点下载（491MB，走 hf-mirror 国内镜像）
    ④ 下载完直接打字提问，首次提问要加载模型 3~10 秒

  两个模型：
    千问 Qwen2.5-0.5B          491MB   快，日常问答够用
    DeepSeek-R1-Distill-1.5B   1.04GB  推理更强，直接可下

  模型存在哪：
    <安装目录>\models\  （也就是 D 盘或 E 盘，同样不碰 C 盘）
    下载支持断点续传，断了重按继续，不会从头下。

  想删就删：
    「模型」菜单里可以单独删除某个模型，本体和 .part 续传文件
    一起清干净，不留残留。

【常用命令】
  help            全部命令
  pi              真实计算圆周率（spigot 算法，真算）
  pi mc 100000    蒙特卡洛估算
  nmap 1.2.3.4    端口扫描（本地模拟，不发真实数据包）
  hack            彩蛋
  pet             桌面宠物小龙
  clear / Ctrl+L  清屏
  exit            退出

【和手机版的关系】
  命令引擎是同一套 Java 源码，逻辑一字未改：
  CodeRunner(1399行)、MiniScript(367行)、IntentEngine(371行)
  与手机版逐字节对比，唯一差异是第 1 行的 package 声明（包名不同）。

  CommandEngine 有改动，但全是必要的：
    · android.content.Context → 本包的 Context 壳
    · EngineBridge 去掉跨包前缀
    · 新增 runQuiet()（桌面外壳用来抑制进度行）
    · 去掉「100 万位圆周率表」——那个 3MB 的 gzip 表是随 APK 分发的，
      桌面版没有；pi 命令改成纯 spigot 现算，≤1000 位照样真算

  AI 部分也是手机版那一套 llama.cpp，只是把 ARM 的 .so 重新
  交叉编译成了 Windows 的 .dll，推理代码本身没改。

  不含：权限版（Root/Shizuku 是手机专属，桌面版不提供）
  不含：关卡系统 / 密钥包（桌面版默认全解锁，直接自由终端）

【万一杀毒软件报警】
  这是自解压程序的常见误报（因为会写文件、启动子进程）。
  加信任即可。源码可查，AI 全程本地推理，没有任何联网行为
  （唯一联网的地方是你在点「下载模型」的时候）。

【在单盘电脑（机房）上跑完想清理】
  方式一：窗口顶部橙色提示条 →「清理并退出」按钮
  方式二：直接删 %LOCALAPPDATA%\HackerSim 文件夹
  方式三：学校有冰点还原 → 直接关机，自动还原

【免责】
  教学娱乐用途的模拟终端。所有渗透/网络命令均为本地仿真，
  不会发送任何真实数据包、不接触真实系统。