aino

单头文件 C++17 桌面 UI 库 —— 立即模式、零第三方依赖、空闲 0.00% CPU。（这是一个纯vibo coding项目）

核心库只有一个 aino.hpp，使用系统绘制和字体接口，无第三方 UI 或图标依赖。采用 macOS 风格，背景材质以模糊近似。

Requirements:

• C++17 编译器：MSVC 19.29+、GCC 12+ 或 Clang 14+
• 核心 UI 无第三方开发依赖，不要求构建系统或资源文件；系统运行库说明见下文

main.cpp：

#define AINO_IMPLEMENTATION          // 只能出现在一个编译单元里
#include "aino.hpp"

#include <string>

int main() {
    aino::Window win(880, 560, "aino 示例");
    if (!win.ok()) return 1;

    std::string email;
    bool notify = true;

    win.run([&](aino::Ui& ui) {
        ui.panel({24, 24, 400, 240});
        aino::Stack col = ui.vbox({24, 24, 400, 240}, 10.0f, 18.0f);
        ui.heading("设置", col.next(34.0f), aino::Style().left());
        ui.input(&email, col.next(24.0f), aino::Style().hint("[email protected]"));
        ui.checkbox(&notify, "邮件通知", col.next(22.0f));
        if (ui.button("保存", col.next(24.0f), aino::Style().primary())) {
            win.set_title("设置已保存");
        }
    });
    return 0;
}

Build：

# MSVC（/utf-8 必须加，否则中文字面量按 GBK 编；/MT = 静态链 CRT，目标机不用装运行库）
cl /std:c++17 /utf-8 /EHsc /O2 /MT main.cpp user32.lib gdi32.lib

# MinGW（-static = 静态链接编译器运行时）
g++ -std=c++17 -O2 -mwindows -s -static main.cpp -o app.exe -lgdi32 -luser32

# GCC / X11
g++ -std=c++17 -O2 main.cpp -o app -lX11 -ldl

-static 需要工具链提供完整静态运行时；不能全静态链接时，可使用 -static-libgcc -static-libstdc++ 并按导入表随附所需的 libwinpthread-1.dll。 MSVC 的 /MT 静态链接 CRT；应用仍使用平台系统 DLL。

Run：

./app.exe

仓库里自带的 gallery 示例：

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
./build/Release/aino_gallery.exe  # Visual Studio；Ninja/Makefiles 使用 ./build/aino_gallery

CMake 自动扫描 examples/*.cpp，每个文件生成 aino_<文件名>； 新增或删除顶层示例源码后，构建会触发重新配置；Visual Studio 可能需重新加载后再构建一次。 也可先执行 cmake -S . -B build 更新目标。.hpp 不生成程序。 Visual Studio 产物在 build/Release/，Ninja/Makefiles 通常在 build/。

cmake --build build --config Release --target aino_primitives_demo

ssh_client.cpp 保留兼容目标名 aino_ssh，需额外安装 libssh2（MSVC 使用预编译 libssh2 + mbedTLS）。 缺依赖仅跳过此目标，-DAINO_BUILD_SSH=OFF 可禁用；详见 构建说明。

画廊“空状态”卡片中的“新建素材”会打开独立窗口，填写名称与说明后回填主窗口。 tools/child_window.py 验证点击、创建、取消以及两个消息循环的响应。

Windows 每个窗口线程使用独立帧定时器，多窗口实测不等于 Cocoa 支持后台线程建窗。

win.run(frame_cb) 就是完整主循环：没事件时阻塞在 WaitMessage，帧回调只在需要重绘时被调用 —— 窗口静止时 0 帧 / 0.00% CPU，不是低帧率空转。

Windows 本地回归覆盖组件状态、滚动布局、编辑、19 项整窗行为、空闲 CPU 与多窗口。 仓库 CI 仅在发布 GitHub Release（含预发布版本）时自动运行，也可在 Actions 页面手动触发。 普通提交、分支推送、PR 和单独推送 tag 不触发自动 CI。 CI 在 Windows/Linux/macOS 上编译、开窗冒烟并运行几何像素断言； 当前 mac 风格尚未完成 Linux/macOS 真机核对。输入、IME、剪贴板与 Cocoa 多窗口的限制见 平台支持。

X11 字体回退先检查 Fontconfig 字符覆盖集合再打开字体，避免缺字加载无关字体文件；字体顺序、字号和 metrics 保持原有规则。Linux 系统图标读取桌面图标主题，使用系统 GdkPixbuf/SVG loader，不初始化 GTK；运行依赖与返回约定见 系统图标。这批资源路径修复尚未在 Ubuntu 实机复测，未运行本轮回归。

Linux 应用可在 main(int argc, char** argv) 最前面调用 if (const int code = aino::system_icon_worker_entry(argc, argv); code >= 0) return code;，早于窗口、音频及业务初始化。短时子进程复用当前可执行文件，解码原系统图标后退出，最终 alpha 缓存在 $XDG_CACHE_HOME/aino-system-icons-v1（默认 ~/.cache/aino-system-icons-v1，8 MiB）。缓存无效会重建，失败回退原加载；未接入的应用保持原行为，其他平台返回 -1。首次空缓存有额外等待和瞬时进程树峰值。X11 字体覆盖表按文件/index 共享，十秒未使用的 FreeType face 可释放，缺字时重开，保留字形和 metrics。播放器专项记录 已验证受控场景的像素一致性；真实桌面和任意主题仍需实机验证。

aino.hpp             库本体，单文件（全部实现都在这一个头里）
examples/gallery.cpp 15 分类、43 示例卡片（固定侧栏与工具栏、连续滚动）
examples/sidebar_demo.cpp 侧边栏切换（新手第一个 demo）
examples/pomodoro.cpp 番茄钟（侧栏、工具栏、倒计时与时长设置）
examples/primitives_demo.cpp 基础图元、裁剪、变换与背景模糊
examples/function_viewer.cpp 函数可视化、自定义表达式、采样缓存与手动播放
examples/ssh_client.cpp 可选 SSH/SFTP 客户端、后台传输与取消（额外依赖见上文）
docs/                文档，01 快速开始 … 12 组件与示例索引
screenshots/         预览截图
tools/               构建、像素断言与回归脚本
tools/regress.py     默认核心交互检查，--only 指定探针，--full 完整检查
tools/perf_gallery.py 实际画廊空闲、移动、滚动、拖动与悬停 CPU 采样
tools/shot_pages.py  按分类截整窗图（改完版式先看一眼，不算回归）
tools/ci_smoke.cpp   CI 冒烟程序：开窗 + 跑满 20 帧就退（三平台共用）
tools/ci_pixels.cpp  跨平台像素断言：44 项（含 4 项 X11 专有），直接读后备缓冲（三平台共用）
tools/probe/         数值/像素探针（回归用，不参与发布）
CMakeLists.txt       自动为 examples/*.cpp 创建可执行目标，SSH 可选

日常修改运行 python tools/regress.py --only macos_gallery_probe 等相关探针， 已有最新产物可加 --no-build；完整检查使用 --full，性能单独运行 python tools/perf_gallery.py。

按调用方明确要求撤回远端实验性 Windows IME 修改，恢复至其确认 gallery 正常的 11f72ae7bc19e229551445b16306e22994018007：相关状态、定位、组字消息、组合窗处理和原 IME 探针均按基线原样恢复。后续系统 caret、消息拦截和组合窗策略没有得到实机确认，调用方已反馈失败，因此撤回实验新增的 IME 契约检查；保留鼠标生命周期、Linux 字体/图标修复及独立的原生模态帧重入保护。

X11/XWayland 协商 XIMPreeditPosition 并更新物理光标坐标，合并 XNFilterEvents，支持较长 UTF-8 提交和输入框焦点切换；不支持该样式时回退原有 XIMPreeditNothing。不改变应用现有字体或布局，不代表原生 Wayland 输入法协议支持。

这批恢复按调用方要求只做必要编译和代码审查，不执行探针、回归或 CI。远端回退独立提交并以普通推送保留历史，未发布；调用方确认的是基线 gallery，尚不能视作播放器恢复后的实机验证，新的播放器搜索框修复须等用户确认后再提交推送。

• 01 快速开始
• 02 样式与主题
• 03 布局
• 04 文本类组件
• 05 容器类组件
• 06 交互类组件
• 07 展示类组件
• 08 浮层类组件
• 09 图元与度量
• 10 逐组件性能实测（历史基准）
• 11 动画与变换
• 12 组件与示例索引
• 文档索引

Copyright © 2026 sudoevolve（[email protected]）

Apache License 2.0。可以商用、修改、再分发，保留版权与许可声明即可。