RealisticVision v0.36.0

下载成品 / Download RealisticVision_v0.36.0.zip

中文安装与使用教程 · English installation & usage

不要下载 Source code / Code → Download ZIP：那是仓库源码，不能直接安装。请用上面的具名 ZIP。

适用范围

• Windows / 《Remains》1.02。
• 需要先完成 ModLoader 首次安装（一次性游戏补丁 + 扫描器）。
• 安装：解压 → 把 mods 合并进游戏目录（不要套成 mods/mods）→ 运行 mods/ModLoader/RemainsModScanner.exe → 完全退出并重启游戏。升级时保留你自己的 config.txt。
• 包内结构：mods/RealisticVision/RealisticVisionMod.swf、默认 mods/RealisticVision/release/config.txt、先读我-安装说明.txt、SHA256.json。

本版变化（v0.30.1 → v0.36.0）

这一版汇总了 v0.30.1 之后的多轮改动，逐版证据与限制记录在仓库 knowledge/experiments/、state/MEMORY.md 与 state/journal.md。主要变化按主题：

• 门 / 窗（透光木板、玻璃）后的视野边界：从整块瓦片纯色台阶改为子格光锥几何（v0.34.4），再补上覆盖率抗锯齿——光锥边缘按瓦片内被点亮的子格比例与墙场同构地做双线性过渡（本版 aperture_edge_aa）。离线夹具里门光锥原始亮度场最大步 198→99、显示场 54→37。
• 子弹 / 激光穿过阴影边界：从"只看中轴一条线"改为沿轴向的定向矢量裁剪（v0.35.2），本版再加法向 5 点二维裁剪（proj_clip_2d、proj_clip_step）——压在阴影里的那一侧不再整幅透出，短弹体跨界遮罩边界误差 10px→4px。
• 记忆区网格恢复 5px：fog_vision_quality 默认 0→1（08 子格 / 5px），即 CS 0.9.3 时期、≤v0.33.17 的网格；离线证实"移动时边界变粗"的主因是网格量化。
• 贴墙 / 坐姿看穿墙修复：视线眼点按当前姿态钳回实心自由格（eye_clamp/eye_guard），射线起点格实心即作废，透光门窗叶面与门景渐变重做（v0.34.9 / v0.35.0）。
• 单位与炮塔的阴影状态：修复炮塔/单位退出阴影后不重新显示、以及阴影边界上 0↔1 反复翻转（迟滞带）；弹体裁剪与实心墙剔除（v0.34.7 / v0.35.2）。
• ContinuousScene（CS）共存：大场景下把三个 map 级每帧循环收进"绘制域 ∪ 玩家视野"窗口，并做墙角分桶、代次戳、增量清空与视口内墙体重绘（v0.34.6 / v0.35.1）——隔离实测 RV 自身 12.63 → 9.95 ms/帧（−21.2%）；CS 对象剔除包装层导致狮鹫手臂漏遮挡的问题也已修复（v0.35.3）。
• 换地图 / 换楼层后第一个房间整间按"记忆"发暗：跨房间记忆改为按 Location 对象弱键保存（v0.33.17）。
• 仓库新增 MIT 许可证与 CONTRIBUTORS.md。

验证与限制（请按预发布看待）

已验证：

• 离线 A/B 夹具：本版 ClarityHarness 26/26；既有 SoftHarness 16/16、SharedExplorationHarness 20/21、CsOptHarness 31/34、ShadowFixHarness 23/25（失败项均为此前版本就存在或针对旧基线的断言，已在实验中注明）。
• 等价性：本版改动在门/窗锥内、锥外与 currentSight 上逐像素/逐字节不变；aperture_edge_aa=0 时与 v0.35.3 连跑 60 帧逐像素相同；只有实心墙的房间 120 帧逐像素相同。
• 真机加载：隔离沙箱用真实 pfe.swf 加载 17 个模组，init ok v0.36.0-clarity、设置注册、48×25 → 240×125 大图、tick 正常、err=0。

未验证 / 已知限制：

• 玩家真机观感（门窗光锥边缘、子弹跨界、移动时的边界抖动）尚未由玩家逐项确认。
• classic 模式、viewscale≠1、20+ 同屏弹体未覆盖。
• 5px 网格的帧率代价只在隔离沙箱量过（同 SWF、不同 fog_vision_quality，各自单跑：RV 自报 10.81 → 12.91 ms/帧，240×125 大图，约 +2.1ms/帧 +19%），不是交错的严格 A/B，也不代表你的机器。觉得卡就在 config.txt 里设 fog_vision_quality=0 回到 10px 网格。
• 单项回退键：aperture_edge_aa=0、proj_clip_2d=0、proj_clip_step=0、fog_vision_quality=0、arm_wrap_fix=0、cs_window=0。改完重启生效。

English

Requires Windows / Remains 1.02 and the ModLoader setup. Save and quit the game, extract the ZIP, merge its mods folder into the game folder, run mods/ModLoader/RemainsModScanner.exe, then restart. Keep your own config.txt when upgrading. Use the named ZIP above, not Source code / Code → Download ZIP.

What's new since v0.30.1: sub-tile light cones behind translucent doors and windows (v0.34.4) plus coverage anti-aliasing of their edges; directional vector clipping for projectiles/lasers (v0.35.2) plus 2D normal-direction clipping in this release; the 5px remembered-area grid restored as the default (fog_vision_quality=1); fixes for seeing through walls when hugging them or sitting (clamped eye point, solid start-cell guard); turret/unit shadow-state fixes and hysteresis; ContinuousScene coexistence work that cut RV's own per-frame cost by 21% in an isolated measurement; the "first room of a new floor fully dim" bug fixed; MIT license and CONTRIBUTORS.md added.

Verified: offline A/B harnesses (26/26 for this release), byte/pixel equivalence where claimed, and a real-host sandbox load (err=0, 17 mods). Not verified: in-game subjective look, classic mode, viewscale≠1, 20+ simultaneous projectiles, and the frame-rate cost of the 5px grid on your machine (~+2.1 ms/frame in two non-interleaved isolated runs). Set fog_vision_quality=0 if it feels heavy; per-feature rollback keys are listed above. This build is published as a pre-release.

校验 / Checksums

RealisticVision_v0.36.0.zip
  SHA256 d0ac183dc39feefb57d0e77abe15d26ba8ffe1538fae61023bd539656540de98
  size   59,589 bytes

mods/RealisticVision/RealisticVisionMod.swf   (v0.36.0-clarity, 56,589 bytes)
  SHA256 734896e6c3bda3ac97af9af67daeb866955d61c2b5be894e82d91a15743a42d6

mods/RealisticVision/release/config.txt       (768 bytes)
  SHA256 5c22141835ac8cbac4048fe9f56f0c82647ab54f2478b6f8a58cb265dd1b7aa3

包内 SHA256.json 列出同样的大小与哈希，可自行核对。

RealisticVision v0.30.1

下载成品 / Download RealisticVision_v0.30.1.zip

中文安装与使用教程 · English installation & usage

需要 Windows / Remains 1.02 与 ModLoader 首次安装。解压后将 mods 合并到游戏目录 → 运行扫描器 → 完全退出重启。升级前备份旧文件，保留自己的配置。

Requires Windows / Remains 1.02 and ModLoader setup. Extract, merge the mods folder, run the scanner and restart. Preserve existing settings when upgrading.

Source code / Code → Download ZIP 是开发源码，请使用上面的具名成品文件。 / Use the named download above; source archives are for developers.

---

已完成 v0.30.1 修正及安装后游戏冒烟验证。

仅包含已完成版本。下载 ZIP，先阅读安装说明；升级保留自己的配置。需 Remains 1.02 与 ModLoader 游戏补丁。

源码提交：ad7d858c71227bfa7259e79c3f00bb3785188041。包内 SHA256.json 可核对文件。

RealisticVision v0.30.0

RealisticVision v0.30.0

真实视线：视野迷雾与视线判定增强。

本版要点：可选共享探索接口（保留本地视线规则）；运行时 F11 开关、F12 轮换模式。

配置：mods\RealisticVision\release\config.txt（修改后重启生效）。

前置：游戏需打过 ModLoader 补丁（见 ModLoader 仓库 Releases 的 Remains-GamePatch）。安装说明见压缩包内 README.txt。