Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ bash macos/tests/run-tests.sh
<details>
<summary><strong>这是 Wallpaper Engine 的替代品吗?</strong></summary>

不是。它只控制 Codex 应用内部的主题背景。Windows 管理器可以导入普通 MP4/WebM,但不渲染 Wallpaper Engine 的 Scene、Web 或打包项目
不是。它只控制 Codex 应用内部的主题背景。Windows 管理器可以扫描并直接引用 Wallpaper Engine 已下载到本地的 `type: video` MP4/WebM 项目;超过 1080p 时会生成本地流畅代理。`type: scene` 的 `scene.pkg` 目前可通过独立 GPL-3.0 侧车进行开发预览;Web 壁纸和项目脚本仍不会执行
</details>

<details>
Expand Down
1 change: 1 addition & 0 deletions docs/platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,7 @@ Windows 启动、失败回滚与恢复重开均从已注册的 `OpenAI.Codex`
- macOS 的选图脚本会把这些字段写入主题库,可通过 `--appearance`、`--focus-x`、`--focus-y`、`--safe-area`、`--task-mode` 设置。
- Windows 安装会把运行所需的 `assets/` 与 `scripts/` 原子复制到 `%LOCALAPPDATA%\CodexDreamSkin\engine`,所有快捷方式均指向该受管副本,因此安装后可移动或删除源码目录。安装还会初始化 `active-theme`、`themes` 与 `images`,并把「桥本有菜」同时设为首次默认和可切换的已保存主题。系统托盘支持更换背景、保存当前主题、从「已保存主题」切换、暂停和恢复;图片与 `theme.json` 保存在主题仓库中,不写进 Codex 的 `config.toml`。安装会保留用户已有的 `appearanceTheme`;仅在识别到旧版精确托管的浅色三元组时按备份迁移。
- Windows 渲染器仍支持在注入前用 `window.__CODEX_DREAM_SKIN_CONFIG__` 提供内存级可选覆盖(形状同上,颜色覆盖使用 `palette.accent`),但普通用户应优先使用持久化主题仓库与托盘。
- Windows 管理器的「Wallpaper Engine」入口会扫描用户已经通过 Steam / Wallpaper Engine 下载到本机的 `steamapps\workshop\content\431960` 项目,并读取 Steam 的 `libraryfolders.vdf` 发现第二库。每个 `type: video` 的 MP4/WebM 或 `type: scene` 的 `scene.pkg` Workshop 项目只列出一次;用户可多选导入主页,之后从主页切换。视频继续直接引用或生成本地 1080p 流畅代理;Scene 由独立 GPL-3.0 侧车在本机渲染成 H.264 fragmented MP4,再通过带随机令牌的 `127.0.0.1` HTTP 流交给 Chromium MSE,MIT 主程序不链接或内嵌 GPL 代码。侧车支持多 renderer 客户端和标准输入优雅退出,临时流位于 `%LOCALAPPDATA%\CodexDreamSkin\scene-stream`。Web、脚本壁纸暂不执行。每次启动或刷新主页都会重新校验 Workshop ID、库根目录、相对路径和文件存在性,取消订阅、移动或删除的条目会自动消失。

## 预设与图片类型

Expand Down
9 changes: 9 additions & 0 deletions windows/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Windows Changelog

## Unreleased

### 修复

- 图形管理器启动 Codex 后不再等待被后台注入器继承的 stdout/stderr 管道,避免界面长期停在“正在启动”并禁用壁纸切换。
- 应用视频壁纸或把管理器收进托盘时立即停止 WPF 视频预览,避免隐藏窗口与 Codex 同时解码同一媒体。
- Codex 页面隐藏或壁纸完全遮盖时中止 Scene 的 Chromium 流读取并释放 MediaSource,重新显示时再建立回环连接。
- Scene 侧车启动时立即排空 stderr,关闭管理器时不再在 UI 线程同步等待异步退出;旧的场景流临时文件会在后续启动时清理。

## 1.1.0 — 2026-07-19

### 新增
Expand Down
5 changes: 4 additions & 1 deletion windows/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ Codex 动态壁纸通过本机回环 CDP 给官方 Codex Windows 桌面应用加
管理器支持:

- 浏览、搜索并预览桌面壁纸库中的 PNG、JPEG、WebP、MP4 和 WebM。
- 扫描 Wallpaper Engine 本地 Workshop 中的视频和 `scene.pkg` 场景;Scene 通过独立 GPL-3.0 本地渲染侧车输出回环 fMP4 流,Web 壁纸暂不支持。
- 一键启动或重新应用动态壁纸、切换壁纸、暂停/恢复以及还原官方外观。
- 调整「壁纸透出」程度,100% 时视频保持原始画面且整页主题蒙层为零。
- 系统托盘控制和可选的当前用户开机启动。
Expand Down Expand Up @@ -103,7 +104,9 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-s

导入图片必须是纯背景,不要使用包含窗口、侧栏、输入框、文字或按钮的效果截图。图片上限为 16 MB;宽或高不能超过 16384 像素,总像素不能超过 5000 万。

动态壁纸始终静音、循环且不拦截鼠标操作;Codex 页面隐藏时会自动暂停。视频上限为 128 MB,并通过有界 CDP 分块传入当前 renderer,不会上传到网络,也不会把整段视频嵌入启动脚本。当前 MVP 不提供声音、播放列表或 Live2D。
动态壁纸始终静音、循环且不拦截鼠标操作;Codex 页面隐藏时会暂停普通视频,并中止 Scene 在 Chromium 中的流读取,重新显示后再连接。视频上限为 128 MB,并通过有界 CDP 分块传入当前 renderer,不会上传到网络,也不会把整段视频嵌入启动脚本。Wallpaper Engine 的超 1080p 视频在首次应用时会生成本地 1080p 流畅代理,缓存位于 `%LOCALAPPDATA%\CodexDreamSkin\media-cache`;原 Workshop 文件不会被修改,仍会在每次刷新时校验。当前 MVP 不提供声音、播放列表或 Live2D。

Scene 支持目前是开发预览:`SceneViewer.exe` 必须作为独立组件放在 `%LOCALAPPDATA%\CodexDreamSkin\scene-runtime`,并随附 GPL-3.0 许可证与对应源码信息。主程序只通过标准输入和带随机令牌的 `127.0.0.1` HTTP 接口与其通信;不会把 GPL 二进制嵌入 MIT 管理器。发布前仍需完成独立侧车包、源码提供说明和更多场景兼容性验证。

## 恢复与卸载快捷方式

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<Nullable>enable</Nullable>
<AssemblyName>CodexDreamSkinManager</AssemblyName>
<RootNamespace>CodexDreamSkin.Manager</RootNamespace>
<Version>1.1.0</Version>
<Version>1.1.1</Version>
<Product>Codex 动态壁纸</Product>
<Description>One-click wallpaper manager for the official Codex Windows app.</Description>
<Authors>CCDawn</Authors>
Expand Down
Loading
Loading