commit 54a480fbe4c468cd81dfd3507720d4ed5489344d
Author: Lyizai <Lyizai@bgjq.top>
Date:   Mon Aug 17 04:46:26 2026 +0000

    AutoStore 百科：使用说明与常见问题

diff --git a/Home.md b/Home.md
new file mode 100644
index 0000000..927456f
--- /dev/null
+++ b/Home.md
@@ -0,0 +1,110 @@
+# AutoStore 自动扩地模组
+
+AutoStore 是一个 Minecraft 1.21.4 Fabric 客户端模组，用于在支持 `/u claimmode` 的领地插件服务器上自动扩张领土。
+
+## 功能特性
+
+- **一键 GUI**：按 `Ctrl+R` 打开自动扩地界面
+- **四种扩地策略**：
+  1. 方形外扩：从中心向外逐圈扩张
+  2. 区域扩地：在地图上圈选矩形区域后自动占领
+  3. 玩家周围：围绕玩家当前位置扩张
+  4. 绕国一圈：沿邦国边界向外扩张
+- **自动寻路**：基于 Baritone 自动寻路到目标区块
+- **自动进食**：饥饿时自动从背包寻找食物并进食
+- **实时地图**：自动拉取邦国地图并高亮显示已占领/待占领区块
+- **自动刷新**：定时刷新地图数据
+
+## 安装方法
+
+1. 安装 [Fabric Loader](https://fabricmc.net/) 0.16.14+ 与 Fabric API
+2. 下载 `autostore-1.0.0.jar`（见 Releases 页面）
+3. 将 jar 放入 `.minecraft/mods/` 目录
+4. 启动游戏，按 `Ctrl+R` 打开 GUI
+
+## 使用说明
+
+### 基本流程
+
+1. 进入游戏后按 `Ctrl+R` 打开 AutoStore 界面
+2. 选择扩地策略
+3. 点击"开始"自动扩地
+4. 可通过 `/autostore status` 查看当前状态
+
+### 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/autostore gui` | 打开 GUI |
+| `/autostore start [数量]` | 开始扩地（-1 为持续） |
+| `/autostore stop` | 停止扩地 |
+| `/autostore status` | 查看状态 |
+| `/autostore refresh` | 手动刷新地图 |
+| `/autostore auto` | 自动识别当前邦国 |
+| `/autostore state <邦国名>` | 设置目标邦国 |
+| `/autostore strategy <1-4>` | 设置扩地策略 |
+| `/autostore rings <层数>` | 设置扩圈上限 |
+
+### 区域扩地
+
+1. 选择"区域扩地"策略
+2. 在地图上按住鼠标左键拖拽，圈选需要占领的矩形区域
+3. 松开鼠标完成圈选，点击"开始"即可自动占领区域内所有无主区块
+
+## 配置说明
+
+配置文件位于 `.minecraft/config/autostore.json`，包含以下选项：
+
+- `stateName`：目标邦国名称
+- `strategy`：扩地策略（1-4）
+- `targetCount`：目标区块数量（-1 为持续）
+- `maxRings`：最大扩圈层数（0 为持续）
+- `refreshIntervalSeconds`：地图刷新间隔（秒）
+- `waitTimeoutSeconds`：等待超时时间
+- `retries`：失败重试次数
+- `autoEat`：是否自动进食
+- `eatThreshold`：饥饿值低于此值时进食
+
+## 常见问题
+
+### 为什么按 Ctrl+R 没反应？
+
+请确认：
+1. 模组已正确安装（mods 目录包含 jar）
+2. 没有其他模组占用 Ctrl+R 快捷键
+3. 可在"控制设置"中查看并重新绑定 AutoStore 快捷键
+
+### 扩地失败怎么办？
+
+1. 检查是否已设置正确的目标邦国（`/autostore auto` 可自动识别）
+2. 确认当前邦国与目标邦国相邻
+3. 检查网络连接（地图数据需要从远程拉取）
+4. 查看 `/autostore status` 了解失败原因
+
+## 技术信息
+
+- **模组 ID**：`autostore`
+- **版本**：1.0.0
+- **环境**：客户端（Client）
+- **依赖**：Fabric API、Baritone（内嵌）
+- **Minecraft 版本**：1.21.4
+- **Java 版本**：21
+
+## 源码构建
+
+```bash
+# 依赖 JDK 21+
+./build_mod.sh
+```
+
+输出文件：`autostore-1.0.0.jar`
+
+## 更新日志
+
+### v1.0.0
+
+- 首次正式发布
+- 快捷键改为 Ctrl+R
+- 高级设置默认展开
+- 区域扩地支持玩家圈选
+- 切换模式时清除圈选区域