# 塔科夫工具箱使用指南

这是一个给《Escape from Tarkov》玩家使用的 Windows 桌面工具。地图定位、撤离点、任务追踪、物品查价、OCR 识价、备忘录、屏幕调色、队友位置和手机地图都放在了同一个程序里。

程序读取自动识别或手动选择的截图和日志目录，不会修改游戏文件或游戏设置。默认保留截图和日志；只有主动开启自动删除已处理截图时，才会清理已处理的旧坐标截图。

## 每次开局的最快用法

1. 启动 `TarkovToolbox.exe`。
2. 在右侧“本局状态”点击“开始监听”，再打开“自动刷新”。
3. 进入对局后，程序会根据日志自动切换地图；在游戏中按你的坐标截图快捷键（通常为 `·`）生成新的坐标截图，地图会更新当前位置。
4. 需要任务点时，在右侧“任务点位”搜索并勾选任务。
5. 需要查价时，先到“市场”刷新一次对应的 PVP、PVE 或赛季服行情；之后可手动搜索，或进入“识价”启动游戏内 OCR 查价。

如果地图、当前位置或 OCR 没有反应，优先查看“设置 → 运行日志”，里面会记录实际读取到的路径、地图识别结果和错误原因。

## 启动与文件位置

### 便携版

双击 `TarkovToolbox.exe` 即可启动。请始终保留整个程序文件夹，不要只把 EXE 单独复制到别处；地图、任务数据、OCR 识别文件都与 EXE 同目录。

### 安装版

如果你拿到的是安装程序，可以选择完整、精简或自定义安装。完整安装包含全部功能；精简安装只有核心地图；自定义安装可以单独选择市场、战局查价、清单、备忘录、任务追踪、屏幕调色、队友共享、手机地图和小工具。安装时也可以修改目录并选择是否创建桌面快捷方式。

如果左侧没有某个功能入口，通常是安装时没有选择对应组件，重新运行安装器补选即可。

程序为 64 位 Windows 程序。物品行情刷新需要联网；地图监听、已有缓存、任务进度和局域网共享不需要外部服务器。

## 第一次使用：选择模式和配置目录

首次打开会弹窗让你选择 PVE、PVP 或赛季服。确认后会记住，后续不再询问；升级用户没有保存过这个选择时也会提示一次。市场、游戏内查价、任务追踪、物品清单、藏身处利润和剧情攻略统一跟随这个模式。你可以在“设置 → 工具箱模式”修改，也可以在功能页面切换，其他功能会一起更新。各模式已有的任务进度和物品数量仍单独保存。

赛季服使用赛季任务和物价；剧情攻略、物品清单暂时没有独立的赛季数据，使用 PVP 数据。

第一次启动会在后台扫描缺失的截图、日志目录，找到后自动填入并保存，两项齐全后进入地图页。扫描当前用户的文档／OneDrive 文档目录、运行中游戏的位置、登记的安装位置、Steam 库及常见安装位置，不递归遍历整块硬盘，也不会创建游戏目录或修改游戏文件。多个候选目录优先使用较新的坐标截图、运行中游戏及较新的游戏日志。已手动设置的路径保持不变；扫描期间新选择的路径也不会被扫描结果覆盖。

也可以从左下角“设置 → 一键配置游戏目录”点击“一键配置”补全缺失项。未找到时，请先运行游戏并生成坐标截图，再重试，或用下方的“选择目录”手动配置。选择下面两个**文件夹本身**，不要选择其中的单个文件。

1. **坐标截图目录**：存放带游戏坐标信息的 PNG 截图的目录。
   - 常见参考路径：`%USERPROFILE%\Documents\Escape from Tarkov\Screenshots`
2. **游戏日志目录**：Escape from Tarkov 的 `Logs` 目录。
   - 常见参考路径：`D:\SteamLibrary\steamapps\common\Escape from Tarkov\build\Logs`

选择完成后，确认每一项下方显示“目录可访问”，再回到地图页面点击“开始监听”。如果你的游戏安装盘或 Windows 用户名不同，以你电脑的实际目录为准。

## 地图、当前位置与点位

### 基础操作

- 左侧列表可手动切换地图；监听到支持的地图后会自动切换。
- 鼠标滚轮缩放地图，按住鼠标左键拖动地图。
- 右下角 `+`、`−` 可缩放，`⟳` 恢复默认视图。
- 左右栏都可收起，给地图留出更大的显示区域。
- 有楼层的地图可通过顶部“楼层”下拉框选择对应楼层；仅在该地图具备楼层图时显示。
- 点击“悬浮地图”可打开独立小地图窗口，固定为 2.5 倍，并在打开、切图、调整窗口尺寸和收到新坐标时居中玩家；没有坐标时显示地图中央。此行为独立于主地图的自动缩放开关和倍率。可拖动查看周边，新坐标到来后恢复居中；悬浮地图滚轮不再改变倍率。
- 悬浮地图顶部的齿轮位于锁图标左侧，点击后在地图下方平滑展开设置，再次点击可收起，快速点击时可反向过渡。动画只改变设置栏的裁剪和透明度，地图尺寸固定，不会因展开而反复重排、居中。地图名称保持紧凑，长名称会省略以免覆盖按钮。可选择方形或圆形：圆形模式使用等宽高的地图视口，标题、按钮、图例和缩放尺寸手柄均在圆形边界内，四角透明且不拦截点击；设置面板仅展开时显示在圆形下方。透明度滑块范围为 0% 不透明到 100% 完全透明，按钮和设置不随地图变透明。“尺寸”滑块调整圆形直径，或按比例调整方形宽高，不改变 2.5 倍地图倍率；锁定时也可通过设置主动调整尺寸，圆形始终保持正圆。拖动尺寸滑块或右下方手柄时，地图会实时改变大小；以拖动开始时的屏幕坐标、DPI 和灵敏度计算位移，避免伸缩的滑块轨道和移动的手柄干扰拖动。拖动期间窗口左上角不变，松开后再做屏幕边界校正并记住尺寸；取消拖动、切换形状、收起设置或关闭窗口会还原未确认的尺寸。点击滑块轨道或键盘调整也立即生效。形状、透明度和尺寸会记住，重新打开或重启后仍保留；锁图标的开／闭状态表示位置和尺寸是否锁定，解锁后也可拖动右下方手柄调整尺寸。

### 自动截图

点击地图顶部“自动截图”并勾选“启用”后，程序先进入待命，不会在菜单、仓库或藏身处持续截图。游戏日志出现本局的 `GameStarted` 后，程序才会按设定间隔发送截图键；检测到战局结束或游戏关闭后自动停止，并继续等待下一局。实际发送截图键时，游戏仍需位于前台。

按钮上的“待”表示正在等待战局，“30s”等时间表示已经进入战局并开始计时。全局切换热键控制的是待命开关，不需要每局重新开启。

设置页的“坐标截图目录”下可以开启“自动删除已处理的坐标截图”，默认关闭。监听期间成功定位到新截图后，会删除上一张已处理的坐标截图，始终保留最新一张，供重新启动或恢复监听时使用。普通截图、没有成功定位的截图和未被处理的历史文件不会被批量清理。开关会记住，重启后无需重新设置。

### 自定义标点

点击地图顶部“自定义标点”，再点击“添加标点”，然后在地图上点一下位置，标点就会直接保存。每张地图默认按“点1、点2……”命名，不必自己填写名称。放置前可以在顶部面板选择颜色、填写可选备注或设置显示楼层。按 `Esc` 或再点“取消添加”可退出放置模式。

标点按地图保存；默认只在添加时所在的楼层显示，也可以勾选“所有楼层都显示”。点击标点、右键选择编辑，或在顶部面板的下拉列表选中标点，就能直接修改名称、备注、颜色和楼层范围，改好后点击“保存”；“还原”会撤销尚未保存的修改。清空名称后保存会保留原名称，也可用“删除”移除标点。2D 和卫星底图切换后，标点仍对应同一个游戏坐标；悬浮地图也会显示标点。

标点保存在本机配置目录的 `custom-map-markers.json`，重启或升级不会清空。每次保存都会保留上一份有效文件作为 `.bak` 备份。

### 点位显示

点击地图顶部“点位显示”，可按需开启或关闭：

任务列表与已勾选任务点都只使用随程序附带的中文 Wiki 离线数据，使用时不需要联网。Wiki 没收录的任务不会出现在列表或地图上。撤离点、地图分区等其他内容、显示开关和紫色任务标记样式都不变。

- 地图分区（破桥、主播房、老工地等常用地标俗称）；
- 撤离点与转移点；
- 已勾选任务的任务点；
- 钥匙房／上锁点；
- 拉闸点；
- 赛季文件；
- BTR 位置预测（支持的地图才会显示）。
- 自定义标点。

#### BTR 自动预测

森林、街区和灯塔支持 BTR 位置预测。开启“开始监听”和“自动刷新”，并勾选“点位显示 → BTR 位置预测”后，程序读取日志中的 `GameStarted` 时间，自动计算战局剩余时间，无需手动填写计时。已经开局后再打开工具也会按日志时间追上当前进度。

路线与停靠时刻表来自中文 Wiki 的 BTR 追踪页面，随程序内置并离线计算；森林有 5 条候选路线、街区 3 条、灯塔 4 条。多条 BTR 标记代表本局可能采用的路线，不代表同时出现多辆车。悬停可查看预测的下一站和到达／离站倒计时。战局结束、停止监听、游戏关闭、转移目标尚未确认或时刻表结束时隐藏预测位置，下一局按新的开始日志重新计时。

这不是实际车辆坐标。预测依赖网站时刻表与默认战局时长，生成延迟、游戏版本变化或中途加入的 Scav 战局可能造成偏差；请以游戏中观察到的车辆为准。内置快照为 `btr-prediction.json`，维护时可运行 `update-btr-prediction-data.ps1` 输出新快照供审阅。

地图上的常用颜色含义：

- 红色箭头：当前玩家位置与面朝方向；
- 蓝色箭头：过期坐标。它仍保留在地图上供参考，等新截图到来后会恢复红色；
- 绿色：撤离点；
- 黄色：转移撤离点；BTR 候选路线使用不同颜色区分；
- 紫色：任务点；
- 钥匙图标：钥匙房／上锁区域。

把鼠标放在撤离点名称或图标附近，会显示该撤离点的使用条件，例如阵营、人数、钥匙、信号弹或付费要求。任务点坐标来源不会改变撤离点及其提示；条件仍需在游戏内核对，工具箱不会自动判断当前是否可用。

### 任务点位

任务点默认不显示，避免遮挡地图。

1. 选中地图后，在右侧“任务点位”搜索任务名称。
2. 勾选想追踪的任务。
3. 已勾选任务的名称和点位会显示在地图上。
4. 点击任务旁“完成”后，该任务会从默认地图点位中隐藏；需要重新显示时可取消完成状态或清空选择。

## 空投定位

空投定位通过两次不同位置、不同朝向的坐标截图计算两条视线的交点，因此只能给出近似落点。

1. 保持工具箱在“地图”页面，点击“空投定位”，或按下你在“设置 → 热键配置 → 空投定位”里绑定的快捷键（默认**单独轻按一次 `Ctrl`**）开启模式。
2. 站在 A 点，瞄准同一个空投后，按你的坐标截图键（通常为 `·`）生成一张新截图。
3. 横向移动一段距离后，在 B 点再次瞄准同一个空投，再生成一张新截图。
4. 地图会显示两条定位射线与红色估算点。

注意：这个快捷键只在工具箱的地图页面生效。改键时按一个组合键即可绑定全局热键；只按住 `Ctrl` / `Alt` / `Shift` / `Win` 中任意一个再松开，则绑定为“单击触发”，此时按住期间碰过其他键或鼠标（例如 `Ctrl + 左键`、`Ctrl + 右键`、`Ctrl + 滚轮`）都不会触发空投模式。两次位置不要太近，也不要让两次视线几乎平行；否则程序会提示重新取 B 点。再次按下同一个快捷键、点击“退出”或“重置”即可结束或重新开始。

## 物品查价

1. 点击左侧“市场”。
2. 选择 **PVP、PVE 或赛季服**。三种模式的行情和缓存彼此独立。
3. 首次打开行情相关功能时加载缓存并检查更新；也可点击“刷新价格”立即更新。
4. 使用搜索框输入中文名、简称、英文名或物品 ID。
5. 点击某张物品卡片或“报价明细”，查看跳蚤价格、商人收购价和报价来源。

刷新时页面会显示进度条。刷新失败时，程序会优先保留并显示最近一次成功的本地缓存。网络恢复后再点击“刷新价格”即可。没有缓存时，市场和 OCR 识价都无法给出实时行情。

同一份行情按模式共享只读数据，搜索和查询不再反复转换整份目录。离开行情相关页面约 30 秒后，若没有刷新或后台 OCR 使用数据，会释放行情目录和隐藏市场/藏身处利润列表；磁盘缓存、搜索筛选与已选物品保留，重新打开时自动恢复。地图与攻略图片不在此释放范围内。

## 任务物品数量清单

1. 点击左侧“清单”。
2. 选择 PVP 或 PVE 后点击“刷新清单”。
3. 用顶部搜索框查找物品。
4. 用物品卡片上的 `− / +` 记录当前持有数量。
5. 可切换“任务”“藏身处”“显示已完成”，并展开“来源明细”查看需求来自哪些任务或模块。

物品数量、完成状态和 PVP/PVE 选择会保存在本机。清单不读取你的游戏仓库，只记录你手动填写的数量。

## 备忘录

“备忘”分成文字备忘和物品备忘。文字内容会自动保存；物品可以按名称或简称搜索后加入，并填写需要的数量。

打开“显示悬浮窗”后，备忘内容会显示在独立小窗中，适合记录本局要找的物品、任务顺序或临时提醒。

## 任务追踪

“任务”页面提供 PVP、PVE 和赛季服任务树，可以按商人和关键词筛选，也能拖动、缩放任务关系图。

- 任务状态可以手动设为“未接取、进行中、已完成”。
- “自动识别任务”会根据游戏新写入的日志同步任务状态。
- “自动补全前置任务”会在完成后续任务时补齐前置任务。
- “标记任务”可以把任务放进悬浮窗。
- 勾选“标记任务时同步地图任务点位”后，对应点位会同时出现在电脑地图和手机地图上。
- “查看攻略”中可以查看目标、前后置任务、所需钥匙和奖励。

攻略配图按最长边不超过 1280 像素解码成预览，不放大小图；磁盘缓存仍保留原图。离开攻略或切换到其他页面时释放界面的图片引用，再次打开时恢复图片与原有文字、滚动位置。此优化不改变地图底图分辨率。

自动识别依赖正确的游戏日志目录。如果刚改过路径，先回地图页确认监听正常，再点击“立即同步”。

## 游戏内 OCR 识价

“识价”会识别游戏内物品提示上的名称，在物品提示旁显示透明文字行情。它使用本机的市场缓存，不会把游戏截图上传到网络。

### 正常使用

1. 先在“市场”中选择与你游戏一致的 PVP、PVE 或赛季服模式，并至少成功刷新一次价格。
2. 点击左侧“识价”。
3. 再次确认 PVP/PVE，点击“启动识别”。
4. 回到游戏，打开物品详情。
5. 识别成功后，物品提示旁会出现透明文字：物品名、跳蚤均价、跳蚤底价、最高收购商人和单格价值。

商人名称会自动显示为常用中文简称，例如俄商、大妈、黑商、滑雪商、美商、机械师、服装商、猎人和竞技场裁判。

### 价格文字颜色

悬浮文字按**单格价值**着色，整段文字使用同一种颜色：

- 灰色：无有效价格；
- 浅蓝色：低于 100,000 ₽／格；
- 紫色：100,000–499,999 ₽／格；
- 金色：500,000–999,999 ₽／格；
- 红色：1,000,000–9,999,999 ₽／格；
- 粉色：10,000,000 ₽／格及以上。

悬浮窗本身没有背景、边框或遮罩，只显示文字；鼠标和键盘输入仍会传给游戏。

### 自动 OCR、识别区域与定位画面

- 默认使用 PP-OCR 自动识别：打开物品检视窗口后，把鼠标停在物品名称或“重量 kg”附近即可；无需模板或 OCR 框校准。
- **识别区域**：仅在检视窗口总是出现在固定位置时使用。框选后，识别只扫这块区域。
- **清除区域** 或 **自动修复**：恢复为扫描鼠标附近；自动修复还会清除旧版定位记录。
- **查看定位画面 / 窗口化定位画面**：用于确认识别结果或反馈问题。红、绿、蓝分别表示物品标题、重量 kg 和价格悬浮窗位置。

定位画面只读：可用滚轮缩放、在空白处拖动平移，不需要也不能调整标题／重量 OCR 框。调试画面只在内存中显示，不会写进你的截图目录。

## 屏幕调色

“调色”修改的是所选显示器的系统 Gamma 曲线，不是仅修改本工具或游戏窗口。参数刻度、RGB 三通道计算顺序和最终曲线均与 Gamma Panel 一致。

1. 进入“调色”，选择预设和目标屏幕。
2. 勾选“联动 RGB”时，调整任意颜色会同步修改另外两个通道；取消勾选后可分别调整红、绿、蓝。
3. Gamma 与对比度的 `100` 等于 Gamma Panel 中的 `1.00`，亮度直接使用相同的正负整数。
4. 拖动滑块或输入数值后会实时生效；“立即应用”可以手动确认一次当前参数。
5. 不需要调色时点击“恢复系统颜色”。

程序会在第一次修改前备份原始曲线，并使用独立守护进程处理强退恢复。如果画面异常，优先点击“恢复系统颜色”。

## 队友位置共享

队友位置来自每个人自己的坐标截图。所有参与者都要先配好截图、日志目录，并在地图页开始监听。房主端建议同时安装“队友位置共享”和“手机地图”组件，因为这两项功能共用一个服务端口。

### 房主

1. 在“手机”页面确认共享端口，默认是 `17428`。
2. 进入“队友”，填写显示名称并选择标记颜色。
3. 点击“我是房主”，设置一个至少 12 位的房间密钥。
4. 点击“开启房间”。如果共享服务还没启动，程序会自动启动。
5. 把房主地址和房间密钥通过可信渠道发给队友。

### 队友

1. 填写显示名称并选择颜色。
2. 点击“我要加入队友”。
3. 同一局域网填写房主的 `IP:端口`；跨网络可以填写房主的完整 `https://` 手机地图地址。
4. 填写与房主相同的房间密钥，点击“加入队友”。

首次使用时如 Windows 防火墙询问权限，请允许程序通过**专用网络**通信。过期坐标不会继续作为实时位置发送。

## 手机地图

“手机地图”组件会把电脑端的当前地图、楼层、当前位置、任务点和队友位置显示在手机浏览器中。普通局域网可以直接使用；跨网络连接可以配合 SakuraFrp。

卫星地图会按设备自动使用手机 2048 或平板 3072 清晰度的 WebP 资源，并使用版本化缓存；切换地图时会先在后台加载新图，减少黑屏和重复下载。

### 同一局域网

1. 电脑和手机连接同一个路由器或热点。
2. 进入“手机”，点击“启动共享服务”。
3. 点击“复制地址”，把地址发到手机上并用浏览器打开。

### 使用 SakuraFrp

手机地图和队友共享只需要一条隧道：

1. 在 SakuraFrp 创建 **HTTPS** 隧道。
2. 本地 IP 填 `127.0.0.1`，本地端口填写“手机”页面显示的端口。
3. 启动隧道，在“公网入口”填写域名和远程端口（输入框已带 `https://`）；直接粘贴 SakuraFrp 提供的完整 HTTPS 地址也可以。
4. 点击“启动共享服务”，再复制工具生成的手机访问地址。

手机端可拖动、双指缩放、回到当前位置，并独立开关撤离点、任务点、当前定位和队友。

工具不会读取或保存 SakuraFrp 账户密钥，隧道由官方启动器管理。手机访问地址包含本次启动随机生成的访问码，首次访问后会立即从地址栏移除，停止服务后失效，运行日志也不会记录访问码。公网入口强制使用 HTTPS；局域网服务只监听回环地址和一张私有网络接口。局域网直连仍使用 HTTP，只适合可信家庭网络或个人热点，公共 Wi-Fi 下请使用 HTTPS 隧道。

## 小工具

“小工具”里目前有邪教圈配方、赛季文档刷新位置、藏身处利润和剧情攻略。

- 邪教圈配方可按祭品或奖励搜索。
- 赛季文档可以查询刷新点、地图和所需钥匙。
- 藏身处利润支持 PVP、PVE、赛季服，可按利润、时间和每小时利润排序；刷新数据时会显示进度条。
- 剧情攻略会按模式显示解锁条件、任务步骤和配图。
- 剧情攻略来源为 [塔科夫中文 Wiki 的主线剧情](https://www.eftarkov.com/storyline)。包含 10 个章节；“门票”可选择 4 个结局以及交箱 / 留箱的 8 条路线。刷新按当前模式重新读取，配图可点击放大。

## 运行日志与常见问题

### 查看运行日志

“设置 → 运行日志”提供三个实用按钮：

- **复制全部**：方便发给他人协助排查；
- **清空显示**：只清空当前界面显示，不删除历史文件；
- **打开目录**：打开按天保存的完整日志目录。

日志会记录路径读取、地图识别、坐标解析、市场刷新、OCR、滤镜和队友共享等信息。

### 不自动切换地图

1. 确认“设置”中的日志目录选到了 `build\Logs`，而不是游戏根目录。
2. 确认右侧已经点击“开始监听”，并开启“自动刷新”。
3. 进入一局后等待游戏写入新日志，再查看“运行日志”中是否有地图名称或解析失败信息。

### 没有当前位置或位置一直是蓝色

1. 确认截图目录内直接存在新的带坐标 PNG 截图。
2. 用游戏／坐标截图工具的快捷键重新生成一张截图（常用为 `·`）。
3. 蓝色表示截图已过期，或坐标已因战局结束／切图／新战局失效，最后位置仍可参考；只有当前战局的新坐标被接受后才恢复为红色。显式失效不会被截图年龄检查恢复，也不会向队友共享为实时位置。

### 自动截图等待松键

自动截图遇到玩家正在按住截图键或任一侧 Ctrl／Alt／Shift／Win 时会跳过本次触发，松开后由下一个定时周期再试；不会通过释放玩家按键强制截图。部分注入失败时只清理本次已发送、尚未配对释放的键。

### 市场刷新或 OCR 无价格

1. 确认网络可访问行情服务。
2. 在“市场”内选择正确的 PVP/PVE，再点击“刷新价格”。
3. OCR 识价启动前必须至少有一次成功的对应模式行情缓存。
4. OCR 仍不识别时，先点“自动修复”恢复鼠标附近扫描，再查看“定位画面”；只有检视窗口固定在同一位置时才需要设置“识别区域”。

图标、攻略配图、行情、任务清单及藏身处资料下载同时限制响应字节数和完整响应的读取时间，包含错误响应正文；超时后释放下载槽，保留原缓存，用户取消不继续重试。队友响应采用有界流读取，在完整缓冲或校验签名前拒绝超大响应。

### 队友无法加入或没有位置

1. 确认房主和队友填写了完全相同的房间密钥。
2. 同一局域网使用房主的私网 `IP:端口`；跨网络使用完整 HTTPS 地址。
3. 检查 Windows 防火墙是否允许本工具走专用网络。
4. 确认双方都已开始监听，并且各自都有新坐标截图。
5. 房主端需要安装手机地图组件，统一的共享服务才能启动。

## 本机数据与隐私

路径配置、地图任务选择、任务进度、清单数量、行情缓存和运行日志保存在 `%LOCALAPPDATA%\TarkovMapLocatorDesktop`。程序不会主动上传你的截图、游戏日志或个人文件；只有你主动开启队友共享或手机地图时，才会向对应的局域网连接或 SakuraFrp 隧道提供地图与实时位置数据。