SuperAPI AI 工具集

ghostling-libghostty-terminal

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:Ghostling 演示如何用 libghostty-vt(从 Ghostty 提取的可嵌入 C 库)配合 Raylib 构建极简终端模拟器,核心代码集中在 main.c。

主要能力:libghostty-vt 提供 VT 序列解析(SIMD 优化)、终端状态(光标、样式、文本回流、回滚缓冲)、渲染状态管理(标记发生变化的单元格及绘制方式)、Unicode 多码点字素处理、Kitty 键盘协议、鼠标跟踪与焦点上报;零依赖(甚至不依赖 libc),兼容 WASM。它不提供窗口、渲染、PTY 管理、标签页、分屏或配置。

使用方式:需 CMake 3.19+、Ninja、C 编译器(clang/gcc)、在 PATH 中的 Zig 0.15.x,macOS 需 Xcode CLT。获取与构建:

git clone https://github.com/ghostty-org/ghostling.git cd ghostling cmake -B build -G Ninja cmake --build build ./build/ghostling

Release 构建: cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

首次配置后只需执行 cmake --build build。API 用法包括 ghostty_terminal_new、ghostty_terminal_write、ghostty_terminal_key、ghostty_terminal_mouse、ghostty_terminal_resize、ghostty_terminal_render_state 与 ghostty_render_state_begin/next_cell/end、ghostty_terminal_scroll、ghostty_terminal_cursor、ghostty_terminal_free 等。PTY 需自行用 openpty/fork 管理,并自行加载字体、绘制字形与处理剪贴板(OSC 52 字节由库给出,处理归你)。

限制:Debug 构建因安全断言非常慢,应以 Release 做基准测试;Kitty 键盘协议在 Raylib/GLFW 上有上游限制;渲染前须调用 ghostty_render_state_begin,迭代后调用 end,否则画面异常;调整大小后需 ioctl(TIOCSWINSZ) 并向子进程发送 SIGWINCH。其余未提及的内容暂未提供。