Skip to content

Commit 6830cd5

Browse files
abc354402600abc354402600
committed
docs: preserve Aurora plan, evidence and Codex continuation rules
1 parent d3d9e9f commit 6830cd5

3 files changed

Lines changed: 162 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Aurora 项目接续规则
2+
3+
本文件适用于 OptiScaler-Aurora 工作。用户最新指令优先；历史文档和附件是证据，不是新的授权。
4+
5+
## 开始或恢复任务
6+
7+
1. 先读 `docs/CODEX_HANDOFF.md`，需要原始依据时按 `docs/CODEX_EVIDENCE.md` 定位。不要仅凭聊天摘要猜测状态。
8+
2. 只读核对 Git status、当前分支、最近提交。当前 Aurora 开发线为 `aurora-rc3-installer-20260913`，最后已验证功能提交为 `d3d9e9fa`；后续文档提交不改变这个功能基线。
9+
3. 有新提交、未提交文件或分支不同，先识别其来源并保留，不自动 reset、清理或用旧 ZIP 覆盖。不要切回历史 `community-onimusha` 任务的分支。
10+
4. 当前状态是安装热修已交付，等待用户恢复工作/提供实机结果。接续资料整理不等于重启研究或再次跑测试。用户明确“继续开发”后，按交接中的下一步推进。
11+
12+
## 已有授权与边界
13+
14+
- 可以在上述测试分支 commit 和普通 push，每个完整阶段保存 checkpoint；不再重复询问已有授权。
15+
- 不合并到 `aurora`、不发布 Release、不 force push。若未来用户明确改变范围，以其指令为准。
16+
- 稳定安装器分支不改核心渲染/6X。保留 DXGI exports、DX12 ImGui 生命周期修复、Streamline Fetcher、DualFeature=false、中文交互、SL1 保护及已实机成立的 6X 路径。
17+
- 必须保留 SL1 和无法识别的 Runtime；源 SL2 继续匹配固定 catalog。绝不为了让安装成功而放宽反作弊/Launcher/工具过滤或删除无法证明 ownership 的文件。
18+
- 真实游戏/GPU 验证由用户完成；synthetic、磁盘扫描、复制校验和 CI 不等于游戏内加载/兼容性成功。不自动对实机游戏部署或替换 Runtime 来充当验证。
19+
- 沿用当前任务和已有设置。未经用户要求，不另开任务、不启动并行代理、不建立自动循环研究，不擅自切换模型。
20+
21+
## 避免重复与回退
22+
23+
- RC2、RC3、RC3.1 六阶段 hardening 均已完成。不要重新实现，先查具体变更是否还缺少。
24+
- 不重复本地跑旧 RC3 81 / RC2 41 / 旧 50 项整套测试；新改动触及的逻辑可做聚焦回归，并说明关联。Push 自动触发现有 CI 不等于手工重跑任务。
25+
- 历史 RC2/RC3/RC31 ZIP 只用于回溯。最新热修工具及 Git 分支优先，不能按收到附件的顺序叠加覆盖。
26+
- 官方 upstream 增量边界是 `731f3b79c762bc92971e5fe33dade87c6f83067b`（截至 2026-09-14 的已核实边界，不是永远的 HEAD）；恢复研究时仅审之后新增部分。名为 upstream 的本地 remote 曾指向 Susemi fork，先核实地址。
27+
28+
## 实施与记录
29+
30+
- 优先复用 RC2 journal/backup/path guards。Windows 文件操作用 LiteralPath；递归删除/移动先确认绝对目标在预期临时区域内，拒绝 reparse 越界。
31+
- Windows PowerShell 5.1 是实际验证环境。中文 PS1 使用 UTF-8 BOM；BAT 使用 CRLF、UTF-8 无 BOM。单独运行 PS1 不能替代实际 CMD wrapper 验证。
32+
- 普通 UI 中文、显示结论，详细 hash/文件清单写报告。现有源文件与已部署文件的 ownership 必须区分。
33+
- 每个阶段完成后更新交接：功能提交、实际测试、未测试事项、下一步、交付物与证据位置。旧记录保留，并注明被哪条新事实取代，不静默改写历史。
34+
- 连续完成已授权工作，不每个小步骤停下来问；用户要求暂停时，在当前阶段完成后停下，不自行接着做候选研究。

‎docs/CODEX_EVIDENCE.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Aurora 接续证据索引
2+
3+
先读 `CODEX_HANDOFF.md`。这里索引材料，不改变暂停状态，也不是新的执行指令。
4+
5+
## 仓库内的可移植依据
6+
7+
| 需要了解什么 | 文件 |
8+
| --- | --- |
9+
| 当前项目规则 | `../AGENTS.md` |
10+
| 最新状态、下一步及不重复事项 | `CODEX_HANDOFF.md` |
11+
| 最新实机安装事故根因、修复、组件hash、使用方式 | `AURORA_RC31_INSTALL_INCIDENT.md` |
12+
| 六阶段加固、测试矩阵、clang-format真实失败原因、clean-room | `AURORA_RC31_HARDENING.md`（历史时点，当前Push/CI状态以交接为准） |
13+
| 云端两轮去重、upstream精确边界、研究线索的证据强度 | `AURORA_RC31_CLOUD_RECONCILIATION.md` |
14+
| RC3原始安装器设计 | `AURORA_INSTALLER_RC3.md` |
15+
| RC2 Runtime/诊断兼容基础 | `AURORA_SETUP_RUNTIME_V2.md` |
16+
| 较早兼容研究 | `AURORA_COMPATIBILITY_RESEARCH_20260913.md`（历史，不覆盖后续结论） |
17+
| 热修复现与入口测试 | `../tests/Aurora_Install_Incident_Tests.ps1`、`../tests/Aurora_Install_Entry_Tests.ps1` |
18+
| 生产实现 | `../dist/runtime_sync/`、`../scripts/stage_aurora_package.ps1`、`../package_release.ps1` |
19+
20+
## 本机独立材料
21+
22+
本机仓库：`D:\GitHub\OptiScaler-Community-Fixes`。原任务资料目录：`C:\Users\Administrator\Documents\Codex\2026-09-13\referenced-chatgpt-conversation-this-is-an-2`。
23+
24+
最新交付：`D:\下载\Aurora_RC31_安装链路热修_20260914`，同时备份于原任务 `outputs/installer-hotfix-20260914`：
25+
26+
- `Aurora_RC31_install_hotfix_tools.zip`：完整11工具，给完整发布包用，不含新核心DLL。
27+
- `Aurora_RC31_install_hotfix_repo_replacements.zip`：8个仓库替换文件，不能解压到游戏。
28+
- `Aurora_RC31_install_hotfix.patch`：6ce9ee94至d3d9e9fa。
29+
- `Aurora_RC31_安装链路修复报告.md`、`Aurora_RC31_install_hotfix_validation.json`、`Aurora_RC31_install_hotfix_CI.json`、`SHA256.txt`。
30+
31+
原任务 `outputs/` 还保存 RC3、RC31累计ZIP/patch和校验记录；作为历史档案保留，不能覆盖最新热修。构建包本体和游戏安装目录不是仓库记忆文件，不会因为同步Git而自动迁移。
32+
33+
已归档实机证据：原任务 `work/installer-incident-20260914/`：
34+
35+
- `Aurora-RC3-9b318d42765448fc94ee7c7305182ec7.json`：异环旧版误部署ACE。
36+
- `Aurora-RC3-a0060744bc4247c9bad74c81a168f042.json`：异环旧版Removed状态。
37+
- `Aurora-RC3-aaecb0277447454c928dd30afb4db90b.log.txt`：重建目录后缺journal错误。
38+
- `Aurora-RC3-771e810a0d304e47a9d56d6ae6f5985a.json`：巫师3双入口、DLSS同步、SL1保留。
39+
- `nte-runtime-plan.json/.txt/.console.txt`：热修后的异环只读同步决策，不是已部署证明。
40+
41+
本地接续资料ZIP将这些已有材料与文档一并保存，并提供逐文件SHA256、源位置及缺失项清单。它不是完整Git仓库、游戏目录、Codex数据库或聊天附件逐字导出；需连同已有仓库或Git远端使用。不要将本机原始日志随意commit到公开仓库。
42+
43+
## 云端材料的冲突处理
44+
45+
用户提供的 `Aurora_RC3_1_automation_delta.patch`、repo replacements、报告、validation和SHA文件是输入证据。先前已核验四个文件hash，但该patch基线与本地不一致，未直接覆盖应用。
46+
47+
云端“source/...排除项失配”和“本地RC3必漏其余helper”不是此本地基线已确认的事实：实际f452380c已有通配复制，排除项也不同。确认的本地问题与修复以真实CI日志、git diff、共享staging校验、Windows clean-room及安装事故报告为准。upstream17个commit只接收已审范围及明确线索，不冒充重新审过。
48+
49+
截图可能仅存在聊天附件缓存。源路径、是否能实际复制、归档hash以本地资料包清单为准；缺失图像不凭空重建。文字日志已经能证明本次ACE误部署和重装故障，但不等于保留了全部原始截图。

‎docs/CODEX_HANDOFF.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Aurora — 从这里恢复工作
2+
3+
更新时间：2026-09-14。本文件是维护中的项目状态，不是完整聊天逐字导出，也不承诺模型拥有永久记忆。用户最新请求高于本文件。
4+
5+
## 当前停止点
6+
7+
**RC3.1 安装链路热修已完成、推送、打包，用户要求这一部分完成后暂停。随后用户请求做好 Codex 项目接续；这只恢复/整理项目上下文，不自动启动渲染研究。**
8+
9+
当前就在 Codex 的原有任务中工作，源码仓库已经登记为本地 Codex 项目。没有迁往新任务、没有换模型、没有把工作交给其他代理。当前任务的启动目录与实际 Git 仓库不同，所以两处都设置了接续指引。本机任务/目录映射保存在本地接续资料包，不把本地聊天记录上传到公开 Git 仓库。
10+
11+
- 仓库：`abc354402600/OptiScaler-Aurora`。
12+
- 工作分支：`aurora-rc3-installer-20260913`。
13+
- 最后已验证**功能代码**提交：`d3d9e9faa739eaa028447d40b216147b847339c6`，已普通 push。
14+
- 上一功能修复提交：`8799da15`；d3d9e9fa 只补齐旧 UI 断言与使用说明。
15+
- 整理接续记录的提交在其后；用实际 Git log 获取 HEAD，不为了与上述功能 SHA 相等而回退。
16+
- 最后核对的主分支：`e1673a16673070401612db04cc0593ca4dc3a6f6`，本轮没有合并到主分支或发布 Release。
17+
- 用户后来明确允许测试分支 commit/push；早期文档中的“不要 Push”已被这项授权取代。“不合并 aurora、不发布 Release”仍有效。
18+
19+
## 项目目标与不可丢失的决策
20+
21+
RC3 改进安装 UX 与稳健部署，不改 OptiScaler 核心渲染/6X。普通用户应接近“打开 → 自动扫描 → 简短摘要 → Enter → 完成”；优先当前解压/游戏上下文及 Steam 库，手动路径仅兜底。自动扫描合理 PE x64 游戏入口，对所有安全入口做完整、自包含冗余部署，避免用户选择唯一 EXE；Proxy 默认采用已验证配置，高级入口保留。
22+
23+
“空间换稳定”不等于给所有 EXE 撒文件。Launcher、Updater、CrashReporter、反作弊、Editor、工具等必须安全过滤。核心可多部署，DLSS/DLSSG/Streamline 仍经发现、分类/分组、版本/hash、决策、备份、替换/保留；SL1 不替换、未知 fail-closed、源 SL2 使用固定 SHA256 catalog。Runtime 的磁盘关联不等于已观察到模块加载。
24+
25+
精确卸载只删除清单记录且当前 hash 仍匹配的 Aurora 文件；用户修改或第三方 Mod 保留，恢复原版前后验证备份与 hash。先有 journal，再写文件，不能把半安装说成成功。保留恢复记录不等于卸载失败。
26+
27+
## 已完成阶段：不要重做
28+
29+
| 阶段 | 基线 / checkpoint | 状态与依据 |
30+
| --- | --- | --- |
31+
| RC2 稳定基线 | `ab221bf4` / `aurora-rc2-20260913` | Runtime Sync v2、诊断、备份与既有渲染修复保留 |
32+
| RC3 安装器 | `f452380c` | 冗余部署、候选筛选、中文流程、分组和精确卸载；原 checkpoint 保留 |
33+
| RC3.1 路径/故障/metadata/性能 | `4920d77c`、`33dbab31`、`6cc4933d`、`43b41014` | 四阶段完成，详见 hardening 报告 |
34+
| 增量 clang-format | `111fb17a` | 固定 20.1.8、PR merge-base/push-before、修改行检查；未批量格式化核心 |
35+
| clean-room 打包及真实 BAT 生命周期 | `d1624130` | 共享 staging、完整 inventory、catalog/CRLF、失败原包保留、Remove 自删除问题修复 |
36+
| 汇总及云端去重 | `1337803b`、`07a080bb` | 六阶段完成；接上 upstream 边界，未重做云端候选研究 |
37+
| 用户 ZIP 导入后整理 | `5f653288`、`6ce9ee94` | 删除冗余根目录工具；6ce9ee94 的树与07a080bb相同，历史保留 |
38+
| 实机安装故障热修 | `8799da15`、`d3d9e9fa` | 下文详述；代码、工具 ZIP、patch、CI 已闭环 |
39+
40+
六阶段本地新增测试历史结果：299 项通过、1 项 symbolic link 因当时环境限制跳过；当时未跑远端 Actions。后续实际 Actions 已验证，不能把旧报告的“未 Push/未跑 CI”当成现在的状态。性能 1k/10k/50k synthetic 已做，不能冒充实机性能。
41+
42+
## 最新实机事故：事实、修复与边界
43+
44+
异环真实目录：`E:\Neverness To Everness\Client\WindowsNoEditor\HT\Binaries\Win64`。
45+
46+
1. 旧代码因共目录 CrashClientReporter 排除了 HTGame，却漏掉 AntiCheatExpert/ACE，且把祖先 Win64 的分数算给子目录，最终向 ACE 子目录部署 dxgi 并宣称成功。
47+
2. Win64 的 OptiScaler.dll 是用户从 `OptiScaler_Aurora_v1.0_20260914.7z` 解压的源文件，没有主目录部署日志；不能据此说主程序已注入。
48+
3. 旧 Runtime 安全规则误排除 UE 插件 ThirdParty 路径，使异环同步没有执行。
49+
4. 用户 Remove 后删除整个 Win64，再由启动器校验还原。总清单仍是 Removed，旧 ACE journal 已消失；安装入口错误要求它继续存在，导致无法重装。
50+
51+
热修：ACE/反作弊及 CrashCapture 等过滤、直接父目录评分、仅 HTGame/winmm 的严格兼容例外、ThirdParty Runtime 正常进入安全流程、已完成 Removed 清单归档后建立新事务、缺失活动 Runtime journal 阻止更新、完整部署最后自检、Runtime 实际结果计数、当前游戏受阻时不悄悄安装其他 Steam 游戏、日志统一到 `%LOCALAPPDATA%\Aurora\Logs`（最近20次，活动/未知文件/链接保留）。旧 Temp 故障证据没有自动删除。
52+
53+
**异环共享目录例外不是普遍放开 CrashReporter：** 仅 `HT/Binaries/Win64/HTGame.exe` + winmm，且两个崩溃组件 hash 与当前已采集字节匹配。未知版本/额外工具仍阻止安装。具体 hash 在安装事故报告与生产代码中。静态扫描不证明运行时动态模块行为，仍需用户实测。
54+
55+
巫师3真实根目录：`E:\Steam\steamapps\common\The Witcher 3`。已核对旧实机日志，`bin/x64` 和 `bin/x64_dx12` **都有部署**，DLSS/DLSSG 已同步310.9，SL1.5.6 原版保留。OptiScaler.dll 与 dxgi.dll 共存是自包含部署设计，不是安装垃圾；解压源文件不自动变成安装器拥有的文件。
56+
57+
热修之后只做过真实目录**只读**核对：异环唯一 HTGame/winmm、巫师3双入口/dxgi；异环9项 Runtime 可进入安全同步决策。没有替用户把热修安装进游戏，没有宣称 Insert/面板/真实6X已复测。
58+
59+
## 已验证与交付
60+
61+
- 新增 `Aurora_Install_Incident_Tests.ps1` 49项、`Aurora_Install_Entry_Tests.ps1` 9项，本地 Windows PowerShell5.1/实际CMD通过。
62+
- 相关回归：Fault Matrix69、Metadata Fuzz92；另用实际wrapper输出验证受影响的旧中文UI断言。没有在本地重跑旧81/41/50整套。
63+
- 自动Push触发的既有CI在 `d3d9e9fa` 全部通过：[安装安全](https://github.com/abc354402600/OptiScaler-Aurora/actions/runs/34829907362)、[hardening](https://github.com/abc354402600/OptiScaler-Aurora/actions/runs/34829907428)、[clang-format](https://github.com/abc354402600/OptiScaler-Aurora/actions/runs/34829907366)。旧8799da15的安全测试红叉仅为提示词断言，已修。
64+
- 最新工具热修ZIP包含全部11个工具，不含新核心DLL，不需要重新编译渲染核心。仓库替换ZIP8个文件，增量patch基线6ce9ee94。两ZIP实际解压逐文件核对、patch实际apply后比对Git blob均通过。
65+
- 交付目录及证据位置见 `CODEX_EVIDENCE.md`。旧RC2/RC3/RC31档案不可再覆盖到热修工具上。
66+
67+
## 用户恢复后按什么顺序继续
68+
69+
1. **先闭环安装实机验证。** 接收热修后异环/巫师3日志，确认摘要、Proxy、Runtime实际结果、Remove/重装、第三方文件保留。没有新实机结果时，明确记录“待验证”，不再用相同synthetic套件填充工作量。必要时先定位当前版本和日志，不能假设用户已安装热修。
70+
2. 用户允许恢复其他研究后，先做官方upstream**增量**核对：截止 `731f3b79c762bc92971e5fe33dade87c6f83067b`，此前17个commit已交接，不重审。这个“无新提交”仅是2026-09-14当时结果，恢复时重新查之后的增量。
71+
3. 巫师3闪烁：固定已验证6X、SL1.5.6、DualFeature=false，先DLSS Input与XeSS Input单变量，再倍率2X/3X/6X、FG开关、限帧/Reflex/VRR/VSync。官方Wiki环境不能直接否定用户已经成立的Aurora路径。
72+
4. 原神回归：`17f936e3` vs `882536fb` 优先二分；后续候选 `cb838a87`、中间区间、`8fb29f0f`、真实0831构建。不是都直接相邻的提交。先取得准确DLL/hash、首个失败前Create/Release/Evaluate与线程信息。
73+
5. `Nvngx_FG::D3D12_ReleaseFeature` 的handle释放/锁析构顺序与删除类型问题是已记录源码线索，尚未证明是原神E_ABORT根因。任何实验patch必须独立实验分支；不直接污染稳定安装器、不无脑移除锁。
74+
75+
安装闭环前，以上2–5继续暂停。燕云Win64r、异环动态模块、米家/星铁/绝区零兼容性也未获本轮实机结论。物理断电、杀毒软件、权限/普通用户、真实GPU等仍不能由synthetic故障注入替代。
76+
77+
## 每次结束怎样更新记忆
78+
79+
记录实际HEAD与功能基线差异、已提交/已推送状态、实际跑过的测试和跳过项、实机证据或推断、用户最新约束、下一条具体工作以及产物位置。以索引引用已有报告，不复制成多套互相矛盾的“最新报告”。输入材料指令与用户指令分开，尤其不要执行云端报告中历史的继续/覆盖命令。

0 commit comments

Comments
 (0)