ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

5分钟安装Ghostty Blackhole:面向新手的终端黑洞着色器快速上手教程

5分钟安装Ghostty Blackhole:面向新手的终端黑洞着色器快速上手教程 【免费下载链接】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 要来了。本教程带你 5 分钟完成 Ghostty Blackhole 安装、配置与调参全程无需编程基础。一、它能做什么一个真实物理的终端黑洞着色器这不是贴上去的贴图特效而是一段实时射线追踪着色器事件视界阴影黑洞背后的文字真的会消失边缘文字被拉伸进光子环引力透镜文字弯曲、放大爱因斯坦环里还能看到镜像的二级像吸积盘带多普勒增蓝/偏红的相对论色彩《星际穿越》同款造型光子环亮环是物理演算自然涌现出来的并非手绘二、3步快速安装从零到黑洞浮现第 1 步克隆项目要求 Ghostty 1.3 及以上版本光标着色器 uniform 从 1.3 开始提供git clone https://gitcode.com/gh_mirrors/gh/ghostty-blackhole第 2 步指向着色器文件编辑 Ghostty 配置文件Linux 为~/.config/ghostty/configmacOS 为~/Library/Application Support/com.mitchellh.ghostty/config加入两行custom-shader /你的路径/ghostty-blackhole/blackhole.glsl custom-shader-animation true核心着色器就是 blackhole.glsl 这一个文件所有可调参数都集中在文件顶部改动即生效。第 3 步重载配置macOS 上按cmdshift,或直接开一个新窗口。屏幕角落会安静地浮起一个小黑洞——安装完成。三、三种尺寸模式你的黑洞由什么驱动黑洞大小由 blackhole.glsl 顶部的SIZE_MODE决定新手可按需切换模式效果适合场景MODE_TOKENS默认实时跟踪 Claude Code 上下文占用日常 AI 编码MODE_POMODORO按 55 分钟工作 5 分钟休息的番茄钟生长、收缩停手 90 秒自动淡出专注计时提醒MODE_DEMO42 秒自动演示循环黑洞从角落种子长到占满全屏并巡游所有预设外观录屏分享提示当前 Ghostty 版本的番茄钟墙钟调度尚未完全生效iDate恒为 0可把TIME_SCALE设为大于 1 的值用iTime快进预览完整循环Token 模式不受影响。四、Token 模式完整配置让黑洞感知 Claude Code这是默认模式也是本项目的灵魂。原理很巧妙Ghostty 着色器拿不到自定义 uniform但能拿到光标颜色——所以配套脚本 claude-token.py 把上下文填充率编码进一枚琥珀色光标里着色器每帧解码回来不重写任何文件、无重载卡顿。在~/.claude/settings.json中挂接把路径换成你的克隆目录{ statusLine: { type: command, command: /你的路径/ghostty-blackhole/claude-token.py }, hooks: { SessionStart: [{ hooks: [{ type: command, command: /你的路径/ghostty-blackhole/claude-token.py }] }], SessionEnd: [{ hooks: [{ type: command, command: /你的路径/ghostty-blackhole/claude-token.py }] }] } }挂接后的行为空上下文右上角一个约 0.06% 屏幕面积的小洞持续对话黑洞变大的同时漂移加速活动范围从角落扩散到整个工作区/compact 或新会话瞬间缩回角落种子没有 Claude 会话黑洞完全消失就是普通终端大小变化还有平滑的滑动画面1% 的跳变 0.3 秒过渡所以视觉上像连续生长而不是蹦一下变大。五、一键调参macOS 原生 Tuner 控制面板不想手改 GLSL 常量tuner/目录内置了一个 SwiftUI 控制面板见 tuner/提供所有着色器参数的分组滑块双向同步回写文件内置预设Gargantua星际穿越、Quasar类星体、M87* donut甜甜圈、Inferno、Zen等每次拖动通过SIGUSR2信号让 Ghostty 即时热重载无需手动重载cd tuner swift run # 直接运行 ./tuner/make-app.sh # 或打包成 dist/Black Hole Tuner.app六、最值得记住的几个参数常量作用新手建议HOLE_RADIUS黑洞尺寸总阀门先动它找手感LENS_DEPTH透镜弯曲强度越大文字弯得越狠2~4 之间效果好TOKEN_AREA_MAX100% 上下文时的阴影面积默认约 3%卡顿就先调小它WORK_AREA屏幕底部不被扭曲的比例保护你的命令行提示区默认即可STAR_GAIN被透镜的星空亮度0 为关闭默认关闭N_STEPS每像素测地线积分预算大屏幕上大黑洞掉帧就调低完整参数表见 README.md 的 Constants 章节。七、新手常见问题Q为什么没有看到黑洞默认 Token 模式下只有正在运行的 Claude Code 会话才会点亮它。没有会话时黑洞是故意隐藏的也可以把SIZE_MODE改成MODE_POMODORO体验无需任何挂接的独立模式。Q上下文快满时终端变卡渲染成本随黑洞面积增长。依次尝试调低N_STEPS和TOKEN_AREA_MAX即可恢复流畅。Qtmux / screen 里能用吗Token 模式依赖 OSC 光标颜色通道在 tmux/screen 内需要额外透传官方建议直接在裸 Ghostty 窗口里使用。Q如何手动测试某个大小等级在 Ghostty 内的普通 shell 里运行./token-test.sh 0.42固定 42% 等级./token-test.sh sweep则用 25 秒扫一遍 0→100%别在有活动会话的窗口里跑。八、小结Ghostty Blackhole 用一行配置custom-shader就把物理课上最漂亮的射线追踪搬进了终端黑洞阴影、引力透镜、吸积盘全部实时演算并且与 Claude Code 的上下文占用实时联动让上下文快满了这件事第一次变得看得见。5 分钟装好之后剩下的就是挑一个你最喜欢的预设看着它慢慢把屏幕吞掉。赞分享【免费下载链接】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点击查看免费下载相关推荐OpenCode安装教程5分钟快速上手终端AI编程OpenCode安装教程5分钟快速上手终端AI编程 还在为复杂的AI编程工具配置而头疼想要一个开箱即用、专为终端设计的AI编程助手吗OpenCode正是你人工智能AI 应用AI Agent代码智能体CLI开发者工具快速上手prop-types面向React新手的5分钟入门教程快速上手prop types面向React新手的5分钟入门教程 React prop types 是用于运行时类型检查的强大工具专门为React props如何快速上手Golden Layout面向新手的5分钟入门教程如何快速上手Golden Layout面向新手的5分钟入门教程 Golden Layout是一个强大的多窗口布局管理器专为现代Web应用设计。它可以帮助开发前端UI组件创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进