始终扫描 - 常开扫描仪高亮

========================================================================
Starfield Always Scan (SFSE)
为《Starfield》提供始终开启的扫描仪高亮
========================================================================

版本 : 1.0
游戏 : Starfield 1.16.244.0（需要匹配的版本）
依赖 : SFSE (Starfield Script Extender) 0.2.21+
"(1.16.244.0) SFSE Address Library"

------------------------------------------------------------------------
功能简介
------------------------------------------------------------------------
厌倦了要一直举着手持扫描仪才能看清什么值得捡？
本模组让扫描仪高亮始终开启，即使你手中拿着武器或工具也一样，
并且会高亮你周围可配置半径内的所有东西，而不仅仅是屏幕
中央的那个小圆圈。

视觉效果使用的是游戏自带的轮廓系统——与原版扫描仪完全相同的颜色
和粗细——所以看起来就像原版功能一样，只是一直开着。

高亮按类别进行颜色编码（所有值均可配置）：
* 可拾取物品（杂项 / 书籍 / 护甲 / 武器 / 弹药 / 辅助品……） 蓝色
* 容器（去搜刮好东西吧） 橙色
* 交互设备 / 电脑 绿色
* 门 红色
* 植物（可采集植物） 绿色

按下切换热键（默认：F8）即可随时开启或关闭整个功能。HUD 上会
显示一条简短消息确认新状态。

------------------------------------------------------------------------
需求
------------------------------------------------------------------------
* Starfield 版本 1.16.244.0
* SFSE (Starfield Script Extender) 0.2.21 或更新版本。
* 最新的 "(1.16.244.0) SFSE Address Library"（一个加载顺序插件）。

------------------------------------------------------------------------
安装（模组管理器——推荐）
------------------------------------------------------------------------
使用 Mod Organizer 2 或 Vortex 安装此压缩包。压缩包根目录就是
Data 文件夹结构，因此其内容会映射到 ...\Starfield\Data\ ：

StarfieldAlwaysScan.esm
Scripts\SAS_Bridge.pex
Scripts\Source\SAS\SAS_Bridge.psc （源代码，运行时可选）
SFSE\Plugins\SAS_AlwaysScan.dll
SFSE\Plugins\SAS_AlwaysScan.ini

然后在你的加载顺序中启用 "StarfieldAlwaysScan.esm"。

------------------------------------------------------------------------
手动安装
------------------------------------------------------------------------
将压缩包内容解压到 ...\Starfield\Data\，并在提示时合并
文件夹。

------------------------------------------------------------------------
配置
------------------------------------------------------------------------
所有选项都位于 Data\SFSE\Plugins\SAS_AlwaysScan.ini
（该文件带有大量注释）。游戏在启动时只读取一次，因此编辑后
请重启游戏。

最常用的选项：
StartEnabled=1 加载存档后立即开始高亮
HotkeyVK=119 切换热键，119 = F8（按键表见该文件）
RadiusMeters=50 玩家周围的高亮半径
MaxTargets=256 同时显示轮廓的对象数量
StateLoot=2 每个类别的轮廓颜色状态
EnableOther=0 也勾勒可移动的静态物体（箱子、桌子）。
默认关闭：它们无法被拾取，原版扫描仪
也不会勾勒它们。
NotifyOnToggle=1 切换时显示 HUD 消息
LogStats=1 每 5 秒向日志写入一行统计信息

------------------------------------------------------------------------
故障排除
------------------------------------------------------------------------
日志文件：
Documents\My Games\Starfield\SFSE\Logs\SAS_AlwaysScan.log

启动时，日志会打印当前生效的配置以及是否找到了原生轮廓函数
（"native outline ready"）。游戏过程中，它每 5 秒打印一行统计信息
（对象数量、计时、类别）。

* 没有任何高亮：
- 检查插件 "StarfieldAlwaysScan.esm" 是否已启用；
- 检查日志中是否有 "forms bound" / "native outline ready"；
- 确保 Address Library 与你的游戏版本匹配。
* 有些你不想要的东西被高亮了：
在 INI 中将对应的 EnableXxx=0。日志中的 "candTypes" 行
会打印所有被考虑对象的表单类型。
* 颜色难以区分：
日志中的 "stateByCategory" 行会显示每个类别使用的是
哪个状态；修改 StateXxx 值并重启。

------------------------------------------------------------------------
备注
------------------------------------------------------------------------
* 本模组只决定引擎勾勒哪些引用。它从不触及激活、拾取、
对话或任何其他交互。
* 使用原版手持扫描仪没问题：当你放下它时，模组会自动
重新应用其高亮（ResyncOnScannerClose=1）。
* 对象会在当前单元格 / 加载空间内被高亮，与原版扫描仪的
范围相同，并受 RadiusMeters 限制。

------------------------------------------------------------------------
致谢 / 许可
------------------------------------------------------------------------
使用 SFSE 和 CommonLibSF 构建。感谢 SFSE 和 CommonLibSF
团队，以及所有参与测试和报告问题的人。

源代码已包含在内（Scripts\Source\SAS\SAS_Bridge.psc）；C++
源代码位于项目仓库中。请勿重新上传此压缩包。
========================================================================