没有需要翻译的内容。请提供需要翻译的游戏文本。

StardewNavigator

StardewNavigator 是一款用于《星露谷物语》的独立寻路与导航模组。它帮助玩家在地图上导航至各种兴趣点（建筑、区域、坐标）。

功能特性

• 自动寻路：使用 BFS 算法计算跨地图的最短路径。
• 动态路径：当您传送或改变位置时，自动调整路径。
• 数字键盘导航与网格移动：经典的数字键盘布局，用于手动移动、检查、坐标、菜单和扫描器控制（在 NumLock 开启时激活）。
• Stardew-Access 反射桥接：通过数字键盘，与 stardew-access 的 TileViewer 光标和 Auto-Walk 扫描器功能进行直接、动态的集成。
• 鼠标与窗口缩放支持：窗口大小改变时重新计算菜单布局，鼠标悬停时高亮显示元素，并允许有视力玩家单击确认 POI 选择。
• 无障碍集成：如果安装了 Stardew Access，导航指引和数字键盘检查将由其屏幕阅读器集成功能朗读出来。
• 独立 TTS 备用方案：如果未安装 Stardew Access，模组将使用内置的语音合成引擎（Windows 上为 SAPI）来朗读路线指引和地块详情。
• 可自定义：
  • 打开导航菜单的热键（默认：G）。
  • 左 Alt + T 快捷键，用于在游戏内打开交互式数字键盘配置菜单（允许交换操作、选择有视力/无视力配置文件，并可选择 无 来禁用按键）。
  • 在配置中启用/禁用数字键盘控制（默认：true）。
  • 与通用模组配置菜单完全兼容。

安装方法

1. 安装 SMAPI (https://smapi.io/)
2. 从 GitHub Releases 页面下载最新版本
3. 解压缩并将 StardewNavigator 文件夹复制到 Stardew Valley/Mods/ 目录下
4. 通过通用模组配置菜单或 左 Alt + T 快捷键启动配置选项。

可选：安装 Stardew Access 以获得完整的屏幕阅读器集成。

兼容性

• 星露谷物语 1.6+
• SMAPI 4.0+
• 通用模组配置菜单（可选）
• Stardew Access（可选 — https://github.com/stardew-access/stardew-access）：
  • StardewNavigator 可以完全独立模式运行，使用内置 TTS 引擎作为备用方案。
  • 当存在 stardew-access 时，将通过专用层（“StardewAccessBridge”）进行集成。如果集成未激活或在运行过程中变得不可用，模组将自动回退到本地独立行为。

配置

您可以通过以下方式配置模组：在启动游戏一次后，在模组文件夹中生成的 config.json 文件；在游戏内通过 通用模组配置菜单；或直接在游戏内使用 左 Alt + T 按键映射菜单：

• NavigatorMenuKey：用于打开导航菜单的按键（默认：G）。
• NumpadControlsActive：启用/禁用数字键盘快速导航控制（默认：true）。
• ActiveNumpadProfile：在 无视力（为屏幕阅读器提供完整控制）和 有视力（仅限移动/工具栏/物品栏）配置文件之间选择。
• NumpadOverrides：运行时的自定义物理逻辑按键覆盖（通过 左 Alt + T 在游戏内管理）。

数字键盘控制（NumLock 开启）

[!注意] 有关包含所有修饰键层级、扫描器交互和模拟详情的完整映射图，请阅读完整的 数字键盘映射文档。

当 NumLock 开启 时，数字键盘将作为移动、光标、操作和朗读的分层界面：

1. 基础层（无修饰键）

• 8, 2, 4, 6：向上、下、左、右移动网格（如果可用则委托给 stardew-access，否则使用本地备用方案）。
• 1：使用工具：模拟物理按下已配置的工具使用按钮（默认：C / 鼠标左键），冷却时间为 20 tick。支持所有工具类型，包括近战武器（剑）。
• 3：操作/交互 — 模拟物理按下 SButton.X，以可靠地触发宝箱打开、NPC 对话和机器交互（绕过 Stardew Access 的拦截）。
• 5：朗读玩家正前方的地块（玩家面向的地块）。
• 7：选择上一个工具栏槽位（在 12 个槽位间循环）。
• 9：选择下一个工具栏槽位（在 12 个槽位间循环）。
• 0：朗读当前坐标和位置的显示名称（如 K）。
• .（数字键盘小数点）：在所有上下文中作为 回车键 的别名（世界、物品栏、导航菜单、任何打开的菜单）。无需任何修饰键。数字键盘的 . 与主键盘的 . 是不同的 — 无冲突。

导航菜单（通过 G 或 / 打开时）

当导航菜单激活时，数字键盘提供直接导航，而无需切换到主键盘：

• 8：在列表中向上移动光标（上一个目的地或 POI）。
• 2：在列表中向下移动光标（下一个目的地或 POI）。
• 左 Ctrl + 5：确认当前选择并开始自动寻路。

左 Alt + T 是全局快捷键，可在世界中的任何时刻（当玩家空闲时）打开数字键盘配置菜单。 左 Ctrl + 数字键盘5 是上下文相关的：当导航菜单打开时确认其选择；在任何其他菜单（物品栏、商店、对话…）中充当 左 Ctrl + 回车键；当没有菜单打开时，激活物品追踪自动行走。

2. LeftCtrl 层（角色物理与操作）

• 左 Ctrl + 8, 2, 4, 6：精确微移动（玩家逐像素平滑行走）。
• 左 Ctrl + 5：上下文相关：当导航菜单打开时确认其选择；在任何其他菜单（物品栏、商店…）中充当 左 Ctrl + 回车键；在世界中激活物品追踪自动行走（等同于 左 Ctrl + Home）。
• 左 Ctrl + 9：取消当前导航。
• 左 Ctrl + 0：左 Ctrl + 回车键 的别名（在菜单/木匠建造中模拟鼠标左键点击，并在世界中激活自动行走）。

3. LeftAlt 层（地块光标、坐标、生命值和导航）

• 左 Alt + 8, 2, 4, 6：移动 stardew-access 的 TileViewer 光标（从 LeftShift 迁移，以避免与 NVDA 冲突）。
• 左 Alt + 3：朗读当前地块（等同于 stardew-access 中的 左 Alt + J；从 Alt+5 迁移而来）。
• 左 Alt + 5：朗读当前坐标和位置的显示名称（从 Shift+5 迁移而来）。
• 左 Alt + 7：朗读当前选中的工具栏物品（仅保留在 Alt+7 上；Alt+9 已重新分配）。
• 左 Alt + 9：朗读当前导航路径的状态（从 Shift+9 迁移而来）。
• 左 Alt + 0：朗读玩家的生命值和体力（生命统计）。

5. 实用工具与扫描器控制

• *（乘号）：打开物品栏。
• /（除号）：打开导航菜单。
• +（加号）：向上滚动（无修饰键为分组，Ctrl 为类别，Shift 为组内物品）。
• -（减号）：向下滚动（无修饰键为分组，Ctrl 为类别，Shift 为组内物品）。

当 NumLock 关闭 时，这些按键将充当标准键盘导航键。在聊天或菜单中输入时，数字键盘按键也将被忽略，以避免布局冲突。

制作人员与致谢

本模组是 Navigator 模块的独立提取版本，最初作为对 stardew-access 项目的贡献而开发： https://github.com/stardew-access/stardew-access

Navigator 模块由 Nemex81 设计和实现，并通过 PR #549 提交： https://github.com/stardew-access/stardew-access/pull/549

特别感谢 stardew-access 团队、为 SMAPI 和 ModBuildConfig 做出贡献的 Pathoschild，以及星露谷物语的模组制作社区。

更新日志

有关各版本之间所有更改的详细历史记录，请参阅 更新日志。