# MC 指令生成器 · 离线版 / 本地中转

## 这是什么

《我的世界》指令生成器（对话式，支持 1.8.9 ~ 26.1）。
纯前端，**联网只是可选项** —— 断网也能用。

## 怎么用

### 方式一：直接开网页（最简单）

双击 `index.html` 就能用。`file://` 打开时功能齐全。

### 方式二：用本地中转启动（推荐，AI 功能要靠它）

| 系统 | 怎么做 |
|---|---|
| Windows | 双击 **`Windows一键启动.bat`** |
| macOS / Linux | 终端里 `python3 启动器.py` |

它会做两件事：

1. 在本地开一个网页服务（默认 <http://127.0.0.1:8790/>）并自动打开浏览器；
2. 开一个 `/__ai__` 转发接口 —— AI 生成走它，**绕开浏览器的跨域限制**，
   并且能带上自己的 API Key。

想把 Key 换成自己的：网页右上角 **🤖 AI 生成** → 顶栏选渠道 → 填 Key。
Key 只存在**你自己电脑的浏览器里**（localStorage），请求只发给你选的那个渠道，
**不经过任何第三方服务器，也不经过我们的服务器**。

### 为什么要本地中转，而不是我们服务器代转

AI 那些免 Key 渠道是按 **IP 限量**的（每天固定次数）。
如果服务器统一代转，就是拿**服务器的额度替所有访客买单**，
额度会被迅速刷爆，谁都别想用。
放在你本地跑，用的是**你自己的 IP 额度**，谁也影响不了谁。

## AI 不填 Key 也能用吗

能。顶栏渠道列表里有**免 Key** 的（默认就是），直接对话即可。
免 Key 渠道有每日次数上限，用完就等第二天，或者换成自己的 Key。

## 不想用 AI

完全不影响。AI 只是"帮你填参数"，生成命令的核心功能全是本地的。

## 数据存在哪

所有东西（方案库、NBT 预设、AI 会话、连接配置）都在浏览器 `localStorage` 里，
**不上传**。换个浏览器就看不到旧数据，想带走就用「方案库」导出。

## 怎么连同游戏

本站还有个配套的 Forge mod（McGenBridge），装到服务器上以后，
网页可以直接连上去执行命令、读在线玩家坐标。见 README.md。

## 版本

打包时间：%VER%