【免费下载链接】ghostty-blackholeGhostty Blackhole puts a real, ray-traced black hole inside your terminal. It grows as Claude Codes context window fills up, live. A fresh session is a quiet hole in the corner. A full one swallows half your screen. Youll always see /compact coming.项目地址https://gitcode.com/gh_mirrors/gh/ghostty-blackhole点击查看免费下载Ghostty Blackhole 是一个把实时光线追踪黑洞塞进 Ghostty 终端的开源项目新会话时它只是角落里的一个小坑而随着Claude Code 上下文窗口逐渐填满黑洞会不断长大直到吞掉半屏——你永远能提前看见/compact的到来。本文是它的实战踩坑录记录开发过程中最折磨人的三大陷阱iDate 恒为零、pgrep 找不到进程、/dev/tty 不存在并给出每个坑的验证过的解法。项目速览终端里的物理级黑洞黑洞不是贴图而是每帧对 Schwarzschild 时空做光线积分算出来的事件视界阴影、引力透镜、吸积盘、光子环全部由光线追踪涌现终端文字就是被透镜扭曲的背景天空。黑洞的尺寸模式在 blackhole.glsl 顶部切换MODE_TOKENS默认追踪 Claude Code 上下文占用实时驱动黑洞生长MODE_POMODORO内置番茄钟按墙钟时间 55 分钟生长 5 分钟休息MODE_DEMO42 秒自运行的演示循环专为录屏设计安装只需两步在 Ghostty 配置~/.config/ghostty/config中指向着色器custom-shader /path/to/blackhole_ghostty/blackhole.glsl custom-shader-animation trueToken 模式还需把 claude-token.py 以statusLineSessionStart/SessionEnd钩子的形式写进~/.claude/settings.json具体 JSON 见 README.md 的 Install token mode 一节。陷阱一iDate 恒为零番茄钟模式直接停摆⚠️ 这是最容易踩的坑。着色器是无状态的帧与帧之间不保留任何缓冲番茄钟没有别的锚点只能靠iDate提供的墙钟时间来排班。但官方 README 明确警告Caveat:stock Ghostty (through 1.3) declaresiDatebut never populates it — it is always zero也就是说截至 Ghostty 1.3iDate只声明、从不赋值永远是 0。后果是番茄钟调度永远停在周期地板上黑洞只维持在最小尺寸不动只有打字检测器基于iTimeCursorChange见 README.md还在工作。解法用TIME_SCALE走iTime快进。iTime每帧必然推进不依赖iDate把TIME_SCALE设为例如 100一个完整的生长→坍缩→休息周期约 36 秒就能跑完调完记得改回 1。核心逻辑就在 blackhole.glsl// schedule rides the wall clock; for testing, TIME_SCALE adds extra // progress via iTime (which always advances per frame) float wall iDate.w iTime * (TIME_SCALE - 1.0);这个技巧让调试完全不依赖 Ghostty 何时把iDate接上也意味着想等真·墙钟番茄钟生效先等 Ghostty 官方接线期间用TIME_SCALE预览完整周期即可说明详见 README.md。Token 模式不受此坑影响。陷阱二pgrep ghostty 返回空——祖先进程被静默排除想让脚本热重载 GhosttySIGUSR2触发配置重载第一步是拿到 Ghostty 的 PID。直觉写法pgrep ghostty结果什么都找不到。原因很隐蔽——pgrep/pkill会静默排除自己的祖先进程而你在 Ghostty 里打开的终端 shellGhostty 正是它的祖先。于是 pgrep 从 Ghostty 内部看自己永远是空的README.md 专门列了这个坑。解法用ps枚举而不是按名字抓。macOS 端 Tuner 的实现是个很好的范本——遍历ps -axco pid,comm的输出按进程名匹配收集全部 Ghostty PIDtuner/Sources/BlackHoleTuner/ShaderStore.swift/// PIDs come from ps, not pgrep: pgrep silently excludes its own /// ancestors, which bites when a tool runs inside Ghostty itself.ps不做祖先过滤所以无论在 Ghostty 内部还是外部执行都能稳定命中。如果你要写自动重载脚本记住这条发信号用 SIGUSR2找 PID 用 ps。陷阱三/dev/tty 不存在——Claude Code 没有控制终端Token 模式的数据通道很巧妙Ghostty 着色器不接受自定义 uniform但光标颜色iCurrentCursorColor是现成的通道。于是 claude-token.py 把上下文占用率编码进琥珀色光标OSC 12 转义着色器每帧解码回来。而要把转义序列写进终端第一反应是open(/dev/tty)——然后在 Claude Code 里直接失败。原因Claude Code 启动 statusLine/钩子命令时不带控制终端/dev/tty打开报 ENXIOREADME.md。解法向上遍历祖先进程找到真正的 pty。脚本先尝试/dev/tty失败后用ps -o ppid,tty沿祖先链向上爬最多 10 层取第一个 tty 不是??的进程——那就是坐在 Ghostty pty 上的claude本体claude-token.pypid os.getppid() for _ in range(10): out subprocess.run([ps, -o, ppid,tty, -p, str(pid)], ...) if out[1] ! ??: return /dev/ out[1] pid int(out[0])写回时同样做了双路兜底优先/dev/tty退回祖先 pty两者都失败就静默放弃claude-token.py——因为 statusLine 崩溃会弄花 Claude 的状态栏钩子崩溃会刷 stderr所以整条链路必须永不抛错。三大陷阱速查表陷阱症状根因解法iDate 恒为零番茄钟黑洞永远最小Ghostty ≤1.3 声明iDate但不赋值TIME_SCALE借iTime快进pgrep 失效脚本找不到 Ghostty PIDpgrep/pkill 静默排除自身祖先ps -axco pid,comm按名匹配/dev/tty 不存在转义序列写不进终端Claude Code 钩子无控制终端ps -o ppid,tty爬祖先找 pty附赠调风格与 Tuner 调参面板黑洞有 9 种预设风格Gargantua、Quasar、M87* donut、Blazar、Inferno、Zen……macOS 用户可以用仓库里自带的 SwiftUI 调参面板tuner/滑杆实时双向同步 blackhole.glsl 顶部常量每次微调都通过SIGUSR2即时热重载 Ghostty打包用 tuner/make-app.sh。性能提示N_STEPS是每个像素的测地线积分预算也是最主要的性能旋钮——黑洞越大、屏幕 DPI 越高帧率压力越大。高上下文占用时卡了就调低N_STEPS和TOKEN_AREA_MAXREADME.md。总结Ghostty Blackhole 把上下文占用变成了看得见摸得着的引力事件️ 角落小坑起步满屏黑洞收尾。三个坑本质上是同一个主题——别相信理所当然的环境假设iDate以为有值其实恒零pgrep以为能找到其实被祖先规则过滤/dev/tty以为能打开其实根本没有控制终端。对照上面的速查表你可以绕开它们安心盯着你的黑洞长大。赞分享【免费下载链接】ghostty-blackholeGhostty Blackhole puts a real, ray-traced black hole inside your terminal. It grows as Claude Codes context window fills up, live. A fresh session is a quiet hole in the corner. A full one swallows half your screen. Youll always see /compact coming.项目地址https://gitcode.com/gh_mirrors/gh/ghostty-blackhole点击查看免费下载相关推荐PGLite表名大小写陷阱从踩坑到彻底解决PGLite表名大小写陷阱从踩坑到彻底解决 你是否曾在PGLite中遇到过这样的困惑明明创建了名为User的表查询时却提示表不存在或者用小写use数据库嵌入式数据库WebAssembly如何永久保存微信聊天记录WeChatMsg免费工具完整指南如何永久保存微信聊天记录WeChatMsg免费工具完整指南 你是否曾经因为手机故障、误删记录或更换设备而丢失了珍贵的微信对话那些与家人的温馨时刻、朋友间的美彻底解决InfluxDB表名大小写陷阱从踩坑到避坑指南彻底解决InfluxDB表名大小写陷阱从踩坑到避坑指南 你是否遇到过InfluxDB中表明明存在却查询不到的情况或者创建表时提示已存在但找不到对应表名90数据库时序数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考