cloverfield11/codex-inject-doom
GitHub: cloverfield11/codex-inject-doom
一个利用 CDP 与 WebSocket 将 DOOM 无文件注入 Codex Electron 运行时并实现沉浸式演示的概念验证项目。
Stars: 0 | Forks: 0
# ☢️ Codex.inject(DOOM)
[](https://js-dos.com)
[](https://electronjs.org)
**DOOM 原生注入到 Codex IDE 运行时。**
一个概念验证项目，演示如何使用 Chrome DevTools Protocol (CDP) 和 WebSockets 动态注入和执行遗留软件（通过 WebAssembly 运行的 DOOM），并将其原生嵌入到任意 Electron/React 应用程序（Codex）中。
## 🚀 工作原理
整个过程完全无文件且侵入性极小。项目仅由两个文件组成：一个 Bash/Python 注入器和一个前端 HTML 外壳。
1. **CDP 劫持：** `doom-inject.sh` 会自动安全地重启后台的 Codex 进程，并启用 `--remote-debugging-port`。
2. **WebSocket 注入：** 一个原生 Python 脚本利用调试 WebSocket，持续使用无头 `Runtime.evaluate` 评估，将一个与 CSS 匹配的可交互标签页注入到基于 React 的 Codex DOM 中。
3. **云端原生启动：** 一旦注入的标签页激活，环境会被重定向到一个轻量级本地 HTTP 服务器，用于提供 DOS WebAssembly 模拟器。
4. **零重量资产：** 整个 `DOOM.WAD` 和模拟器核心会通过 `dos.zone` CDN 无缝流式传输，以保持极轻量的体积（总计 < 30KB）。不会在本地的存储任何实际的游戏二进制文件。
## 🛠 功能特性
- **无痛 UI 注入：** 绕过 React 的 DOM 管理机制，直接将高度凝聚的元素挂载到 Codex 侧边栏中。
- **深度清洁模拟器：** 移除所有 JS-DOS 视觉包装、工具栏、虚拟键盘和设置按钮，通过极端的 CSS DOM 穿透技术留下一个 100% 沉浸式、无边框的游戏画布。
- **自动清理守护进程：** 通过 `trap` 集成后台进程处理。关闭终端（`Ctrl+C`）会优雅地关闭 HTTP 服务器、断开 CDP 套接字，并干净地关闭注入的实例。
- **主题化 UI：** 支持 `Light` 和 `Dark` 偏好模式的系统感知交互启动画面。
## 🎮 使用方法
无需 Node.js，无需 `npm install`，也无需庞大的依赖项。如果你拥有 Python 3 和 macOS，你就可以直接运行。
```
git clone https://github.com/cloverfield11/codex-inject-doom.git
cd doom-codex
# 启动自动注入序列
./doom-inject.sh
```
观察终端报告成功的 WebSocket 握手和启动序列。
Codex 打开后：
1. 点击侧边栏中嵌入的 **`Codex.inject(DOOM);`** 标签页。
2. 运行 DOOM。
3. 按下 **`✕ Return to Codex`** 干净地关闭画布并返回代码。
## 👤 致谢与工具
* 注入逻辑和 UI 设计由 [@cloverfield11](https://github.com/cloverfield11) 提供
* 在浏览器中使用令人惊叹的 [js-dos](https://js-dos.com/) v8 运行 DOOM。
* DOOM 资源由 [dos.zone](https://dos.zone/) 的索引器托管。
## 🚀 工作原理
整个过程完全无文件且侵入性极小。项目仅由两个文件组成：一个 Bash/Python 注入器和一个前端 HTML 外壳。
1. **CDP 劫持：** `doom-inject.sh` 会自动安全地重启后台的 Codex 进程，并启用 `--remote-debugging-port`。
2. **WebSocket 注入：** 一个原生 Python 脚本利用调试 WebSocket，持续使用无头 `Runtime.evaluate` 评估，将一个与 CSS 匹配的可交互标签页注入到基于 React 的 Codex DOM 中。
3. **云端原生启动：** 一旦注入的标签页激活，环境会被重定向到一个轻量级本地 HTTP 服务器，用于提供 DOS WebAssembly 模拟器。
4. **零重量资产：** 整个 `DOOM.WAD` 和模拟器核心会通过 `dos.zone` CDN 无缝流式传输，以保持极轻量的体积（总计 < 30KB）。不会在本地的存储任何实际的游戏二进制文件。
## 🛠 功能特性
- **无痛 UI 注入：** 绕过 React 的 DOM 管理机制，直接将高度凝聚的元素挂载到 Codex 侧边栏中。
- **深度清洁模拟器：** 移除所有 JS-DOS 视觉包装、工具栏、虚拟键盘和设置按钮，通过极端的 CSS DOM 穿透技术留下一个 100% 沉浸式、无边框的游戏画布。
- **自动清理守护进程：** 通过 `trap` 集成后台进程处理。关闭终端（`Ctrl+C`）会优雅地关闭 HTTP 服务器、断开 CDP 套接字，并干净地关闭注入的实例。
- **主题化 UI：** 支持 `Light` 和 `Dark` 偏好模式的系统感知交互启动画面。
## 🎮 使用方法
无需 Node.js，无需 `npm install`，也无需庞大的依赖项。如果你拥有 Python 3 和 macOS，你就可以直接运行。
```
git clone https://github.com/cloverfield11/codex-inject-doom.git
cd doom-codex
# 启动自动注入序列
./doom-inject.sh
```
观察终端报告成功的 WebSocket 握手和启动序列。
Codex 打开后：
1. 点击侧边栏中嵌入的 **`Codex.inject(DOOM);`** 标签页。
2. 运行 DOOM。
3. 按下 **`✕ Return to Codex`** 干净地关闭画布并返回代码。
## 👤 致谢与工具
* 注入逻辑和 UI 设计由 [@cloverfield11](https://github.com/cloverfield11) 提供
* 在浏览器中使用令人惊叹的 [js-dos](https://js-dos.com/) v8 运行 DOOM。
* DOOM 资源由 [dos.zone](https://dos.zone/) 的索引器托管。标签：CDP, Chrome DevTools Protocol, CSS匹配, DOM操作, DOOM, Electron, Electron应用, headless调试, Hijacking, React, React应用, SEO注入, Syscalls, UI注入, WebAssembly, WebSocket, 云端分发, 依赖分析, 侧边栏挂载, 前端注入, 动态注入, 后端开发, 应用安全, 技术演示, 文件注入, 游戏模拟器, 远程调试, 逆向工具, 零文件存储