# undercurrent **Repository Path**: nixius/undercurrent ## Basic Information - **Project Name**: undercurrent - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-27 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 暗流 · undercurrent 一个独立的 Windows 桌面壁纸程序:把四种动态形态画在桌面图标之下,随系统音频起伏。 不依赖 Lively / Wallpaper Engine,单文件绿色运行,**零第三方依赖**。 版本 1.1.1 ## 截图 - 流动丝带 ![](./res/流动丝带.png) - 几何呼吸 ![](./res/几何呼吸.png) - 柔色光场 ![](./res/柔色光场.png) - 暗夜星空 ![](./res/暗夜星空.png) - 设置 ![](./res/设置.png) ## 使用 双击 `undercurrent.exe`。启动后: - 不弹窗口,直接进入托盘 - **左键**托盘图标 → 打开设置 - **右键**托盘图标 → 「设置」「退出」 设置改动即时生效,自动保存在 `%APPDATA%\undercurrent\config.json`。 ## 功能 **四种形态** | 形态 | 特征 | |---|---| | 流动丝带 | 三条贝塞尔光带,柔边累积,随节奏起伏 | | 柔光色场 | 缓慢漂移的椭圆光团,呼吸式明暗 | | 几何呼吸 | 偏心螺旋光弧,逐拍胀缩 | | 暗夜星空 | 银河 + 三层星点视差,鼓点整片点亮 | **音乐律动**:WASAPI loopback 采集系统正在播放的声音(不采集麦克风、不发声)。 低频/中频/高频三段 + 谱通量节拍检测,带 30 秒自适应增益与 1 秒自适应门限。 可在设置里关闭(会释放音频设备)。 **配色**:6 套预设 + 自定义(OKLCH 色相/明度取样)。 **暂停策略**(任一成立即停止渲染与音频采集) - 手动开关「暂停渲染」 - 使用电池时暂停(默认开) - 全屏应用时自动暂停 - 锁屏时自动暂停 **自愈**:每秒检查一次桌面宿主,任务栏换边、Explorer 重启后 1 秒内重建壁纸与托盘图标。 ## 配置 ```json { "version": 1, "scene": "ribbons", "palette": 0, "color": "#7FA6C9", "speed": 1.0, "sensitivity": 1.0, "brightness": 1.0, "fps": 30, "audioReactive": true, "pauseOnBattery": true, "paused": false } ``` `scene`:`ribbons` / `aurora` / `rings` / `starfield` `palette`:0–5 为预设,6 为自定义(此时 `color` 生效) 日志:`%APPDATA%\undercurrent\logs\undercurrent.log`(UTF-8,允许共享读取) ## 命令行(调试用) ``` undercurrent.exe --scene=starfield 临时指定形态 undercurrent.exe --capture=out.bmp 离屏渲染若干帧存图,不挂桌面 undercurrent.exe --size=1920x1080 指定离屏尺寸 undercurrent.exe --frames=120 离屏帧数 undercurrent.exe --pulse=1 离屏时固定鼓点值(0–1) undercurrent.exe --ui-shot=ui.bmp 把设置界面渲染成图片 undercurrent.exe --ui-paused 配合 --ui-shot,渲染暂停态 ``` ## 构建 需要 VS Build Tools 2022(MSVC)与 Windows SDK 10。 ``` build.bat # 开发版 -> build\undercurrent.exe build_dist.bat # 发布版 -> dist\undercurrent.exe ``` 图标由 `tools/make_icon.py` 生成(需要 Pillow),产物 `app.ico` 通过 `app.rc` 嵌入。 ## 交付内容 ``` dist/undercurrent.exe 单文件发布版(约 370 KB,静态链接 CRT) dist/README.md 本文件 ``` ## 结构 | 文件 | 内容 | |---|---| | `src/main.cpp` | 窗口、WorkerW 挂载、渲染循环、托盘、配置、暂停与自愈 | | `src/scenes.h` | 四个形态的 HLSL、丝带实例化与合成 | | `src/color.cpp` | OKLCH 调色板派生 | | `src/audio.cpp` | WASAPI loopback、FFT、包络、谱通量节拍检测 | | `src/ui.cpp` | Direct2D + DirectWrite 设置界面 | | `app.rc` / `app.ico` | 图标与版本信息 | ## 已知边界 - 只支持单显示器 - 壁纸不接受鼠标键盘输入(窗口 input-transparent) - 壁纸不发出声音 - 不做开机自启