Wallpaper Engine Skin for Codex

English | 简体中文

一个 Codex 插件，使用已安装的 Wallpaper Engine 项目中兼容的媒体作为 Codex 应用本身的背景。它不会更改 Windows 桌面壁纸，也不需要 DSH 或 Cordis。

项目血统： 本 Codex 版本由仓库原始的 DSH Wallpaper Engine 集成开发而来。此后运行时已专门为 Codex 重写；先前的 DSH/Cordis 产物保留在 Git 历史中，而非当前发行版中。参见 NOTICE.md。

工作原理

该插件发现本地 Steam/Wallpaper Engine 项目，安全地嵌入兼容媒体，并通过本地 Chrome DevTools 连接将其插入到 Codex UI 之后。捆绑的启动器以绑定到 127.0.0.1 的调试方式启动官方安装的 Codex 可执行文件；不会修补或替换任何 Codex 文件。

• 当小视频文件符合安全的内联媒体限制时，它们会以循环视频的形式渲染。

• 超过 48 MB 的视频会自动缓存为完整时长的 MP4 文件，上限为 2560×1440、30 FPS 和约 10 Mbps。缓存结果会被复用；仍超过 512 MB 的输出会回退为解码后的动画序列。Web、Scene 或 Application 项目使用其预览图像。

• CDP 访问被白名单限制为确切的 Codex 主页 URL app://-/index.html；浏览器标签页、WebView、登录页面、HTTPS 页面和其他调试目标永远不会被检查或修改。

• 注入的“皮肤调整”面板可以在本地视频项目之间切换，并控制适配模式、缩放、位置、面板不透明度、遮罩和模糊。

• 视频切换在转码期间显示不确定的准备工作条，在传输期间显示 0–100% 的实测进度；成功变为绿色，失败变为红色。

• 当 Codex 失去焦点、最小化或隐藏时，视频和帧动画会自动暂停，并在 Codex 变为活动状态时恢复。

• 转码后的文件存储在 %LOCALAPPDATA%\CodexWallpaperEngineSkin\transcoded 下；源 Wallpaper Engine 项目永远不会被修改。

• 所选皮肤和调整设置持久保存在 %LOCALAPPDATA%\CodexWallpaperEngineSkin 下。结束任务不再移除图层，使用捆绑启动器启动的 Codex 实例会自动恢复上次启用的皮肤。codex_skin_remove 会移除图层并清除已保存的偏好设置。

动态背景是实验性的：Codex 支持的外观设置涵盖颜色、字体、对比度和半透明度，但目前不提供公开的背景媒体扩展点。该插件还可以生成原生的 codex-theme-v1 颜色主题字符串作为受支持的备用方案。

Related MCP server: ae-agent-lab-demo

快速安装与使用

本仓库是插件根目录。它需要 Node.js 22 或更高版本，并且仅使用 Node.js 内置模块，因此无需 npm install。

将以下行粘贴到 PowerShell 中：

$p = Join-Path $env:TEMP 'install-codex-wallpaper-skin.ps1'; Invoke-WebRequest 'https://raw.githubusercontent.com/JonathandNidhog/dsh-plugin-wallpaper-engine-codex/main/install.ps1' -OutFile $p; powershell -NoProfile -ExecutionPolicy Bypass -File $p

安装程序会下载或更新仓库，注册个人 Codex 市场条目，安装插件，并在桌面和开始菜单中创建 Codex Wallpaper Skin 快捷方式。之后再次运行同一命令即可更新。

如果常规 Codex 已在运行，快捷方式会询问是否以皮肤支持方式重启它。它不再静默关闭；选择“否”会保持当前任务不变。

安装后：

1. 关闭所有 Codex 窗口。

2. 从桌面或开始菜单启动 Codex Wallpaper Skin。

3. 在新的 Codex 任务中，要求列出兼容的 Wallpaper Engine 皮肤并应用一个。

当 Codex 已在运行时，启动器会拒绝继续。常规的 Codex 启动没有调试端点，无法接受动态皮肤；这仍然是必要的，因为 Codex 不提供公开的背景图像 API。要使用其他回环调试端口，请向启动器传递 -Port，并为插件进程将 CODEX_SKIN_CDP_PORT 设置为相同的值。

开发人员还可以克隆仓库，手动在本地 Codex 市场中注册，并直接运行 scripts/launch-codex-with-skin.ps1。

示例请求

• “显示我可以用作 Codex 皮肤的 Wallpaper Engine 项目。”

• “将 Neon City 背景应用到 Codex，并提高透明度。”

• “移除 Codex 皮肤。”

• “生成一个带有蓝色强调色的深色原生 Codex 主题。”

如果源发现失败，请将 WALLPAPER_ENGINE_HOME 设置为 Wallpaper Engine 目录，或将 WALLPAPER_ENGINE_STEAM_ROOT 设置为 Steam 根目录。

开发

npm run verify

MCP 服务器通过 stdio 上的 JSON-RPC 进行通信。Wallpaper Engine 项目是只读的；不接受任意媒体路径。

仓库结构

旧版 DSH 捆绑包、Cordis 补丁、生成的 lib/ 产物和嵌入的类型存档被有意排除在当前 Codex 发行版之外。

许可证

MIT。项目血统参见 NOTICE.md。Wallpaper Engine 和已安装的项目内容归其各自所有者所有。