Kaku终端Lua配置完全指南WezTerm兼容的主题、字体与快捷键自定义【免费下载链接】Kaku A fast, out-of-the-box terminal built for AI coding.项目地址: https://gitcode.com/gh_mirrors/kaku5/KakuKaku 是一款为 AI 编程打造的快速开箱即用终端它沿用了WezTerm 兼容的 Lua 配置体系。本指南面向新手带你用一份kaku.lua文件轻松完成 Kaku 终端的主题、字体、透明度和快捷键自定义无需深入了解底层代码。1. 配置在哪里打开方式两步到位首次启动 Kaku 时系统会自动在~/.config/kaku/kaku.lua生成一份带注释的模板。这个文件会先加载内置的 Kaku 默认配置再叠加你自己的覆盖项因此你只需要写想改的几行其余保持不变。两种打开方式命令行执行kaku init可生成包含全部注释示例的完整模板应用内按Cmd ,或执行kaku config直接打开图形化设置面板 大多数用户只需要取消注释想修改的那一行保持覆盖内容尽量精简。2. 主题切换Kaku Dark 与 Kaku Light 自动跟随Kaku 默认跟随 macOS 外观在Kaku Dark和Kaku Light两套配色之间自动切换。想固定一种主题只需一行config.color_scheme Kaku Dark -- 始终深色 config.color_scheme Kaku Light -- 始终浅色想恢复自动切换删除这行覆盖即可。Kaku 还会对特定十六进制色做重映射保证第三方应用输出颜色时主题依然协调config.color_overrides { [#6E6E6E] #3A3942 }3. 字体自定义JetBrains Mono 之外的选择Kaku 默认使用JetBrains Mono并以苹方PingFang SC作为中文回退字体字体文件内置在 assets/fonts/ 目录中。常用字体相关配置config.font wezterm.font(Fira Code) -- 换字体 config.font_size 16 -- 固定字号默认按屏幕自动选 15 或 17 config.line_height 1.28 -- 行高二维码等图形偏扁可调至 1.0~1.1 config.harfbuzz_features {} -- 重新启用连字默认关闭4. 窗口美化透明度、模糊与内边距想让终端更通透两个参数即可实现毛玻璃效果config.window_background_opacity 0.92 config.macos_window_background_blur 20 -- 可选模糊强度0~100其他常用外观项配置项作用示例值window_padding窗口内边距支持 px/pt/cell/%{ left 24px, top 40px }window_decorationsmacOS 红绿灯按钮控制RESIZE保留拖拽与缩放enable_scroll_bar显示滚动条默认关闭trueinactive_pane_hsb弱化非聚焦分屏突出当前区域见下方说明inactive_pane_hsb通过色相、饱和度、亮度三个乘数调整非聚焦分屏的颜色1.0表示该分量不变小幅调整效果最好。5. 快捷键自定义追加而不覆盖Kaku 内置了完整的 macOS 原生风格快捷键新建标签Cmd T、垂直分屏Cmd D、AI 聊天面板Cmd L等完整清单见 docs/keybindings.md。自定义时有一条黄金法则永远追加不要整体替换config.keys否则会抹掉所有默认绑定-- 水平分屏绑定到 Cmd Opt Enter table.insert(config.keys, { key Enter, mods CMD|OPT, action wezterm.action.SplitHorizontal({ domain CurrentPaneDomain }), })由于 Kaku 基于 WezTerm 配置系统任何 WezTerm 的 Lua 配置项都能在kaku.lua中直接使用包括完整的 KeyAssignment 动作列表。6. 实用进阶技巧恢复上次会话默认开启重启后自动还原上次的标签与分屏config.restore_previous_session false可关闭选区滚轮行为config.selection_wheel_scroll_behavior Extend默认可在拖选文本时用滚轮跨屏扩大选区扩展命令面板通过wezterm.on(augment-command-palette, ...)钩子给Cmd Shift P面板添加自定义命令例如在 Finder 中显示当前目录配置校验调试设置环境变量KAKU_STRICT_CONFIG1可开启严格校验模式恢复出厂配置改乱了执行kaku reset清理受管配置块你的手写 Lua 会被保留7. 遇到问题官方文档与排查入口完整配置项说明docs/configuration.md常见问题透明窗口、恢复默认等docs/faq.md配置版本与迁移说明docs/config-versions.md配置加载核心实现config/src/lua.rsKaku 的 Lua 配置与 WezTerm 生态完全兼容这意味着你在 WezTerm 社区找到的主题方案、字体配置和快捷键技巧几乎可以原样搬进kaku.lua。从上面几节挑出你需要的片段开始动手吧几分钟就能得到一个专属于你的 AI 编程终端环境 【免费下载链接】Kaku A fast, out-of-the-box terminal built for AI coding.项目地址: https://gitcode.com/gh_mirrors/kaku5/Kaku创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Kaku终端Lua配置完全指南：WezTerm兼容的主题、字体与快捷键自定义
Kaku终端Lua配置完全指南WezTerm兼容的主题、字体与快捷键自定义【免费下载链接】Kaku A fast, out-of-the-box terminal built for AI coding.项目地址: https://gitcode.com/gh_mirrors/kaku5/KakuKaku 是一款为 AI 编程打造的快速开箱即用终端它沿用了WezTerm 兼容的 Lua 配置体系。本指南面向新手带你用一份kaku.lua文件轻松完成 Kaku 终端的主题、字体、透明度和快捷键自定义无需深入了解底层代码。1. 配置在哪里打开方式两步到位首次启动 Kaku 时系统会自动在~/.config/kaku/kaku.lua生成一份带注释的模板。这个文件会先加载内置的 Kaku 默认配置再叠加你自己的覆盖项因此你只需要写想改的几行其余保持不变。两种打开方式命令行执行kaku init可生成包含全部注释示例的完整模板应用内按Cmd ,或执行kaku config直接打开图形化设置面板 大多数用户只需要取消注释想修改的那一行保持覆盖内容尽量精简。2. 主题切换Kaku Dark 与 Kaku Light 自动跟随Kaku 默认跟随 macOS 外观在Kaku Dark和Kaku Light两套配色之间自动切换。想固定一种主题只需一行config.color_scheme Kaku Dark -- 始终深色 config.color_scheme Kaku Light -- 始终浅色想恢复自动切换删除这行覆盖即可。Kaku 还会对特定十六进制色做重映射保证第三方应用输出颜色时主题依然协调config.color_overrides { [#6E6E6E] #3A3942 }3. 字体自定义JetBrains Mono 之外的选择Kaku 默认使用JetBrains Mono并以苹方PingFang SC作为中文回退字体字体文件内置在 assets/fonts/ 目录中。常用字体相关配置config.font wezterm.font(Fira Code) -- 换字体 config.font_size 16 -- 固定字号默认按屏幕自动选 15 或 17 config.line_height 1.28 -- 行高二维码等图形偏扁可调至 1.0~1.1 config.harfbuzz_features {} -- 重新启用连字默认关闭4. 窗口美化透明度、模糊与内边距想让终端更通透两个参数即可实现毛玻璃效果config.window_background_opacity 0.92 config.macos_window_background_blur 20 -- 可选模糊强度0~100其他常用外观项配置项作用示例值window_padding窗口内边距支持 px/pt/cell/%{ left 24px, top 40px }window_decorationsmacOS 红绿灯按钮控制RESIZE保留拖拽与缩放enable_scroll_bar显示滚动条默认关闭trueinactive_pane_hsb弱化非聚焦分屏突出当前区域见下方说明inactive_pane_hsb通过色相、饱和度、亮度三个乘数调整非聚焦分屏的颜色1.0表示该分量不变小幅调整效果最好。5. 快捷键自定义追加而不覆盖Kaku 内置了完整的 macOS 原生风格快捷键新建标签Cmd T、垂直分屏Cmd D、AI 聊天面板Cmd L等完整清单见 docs/keybindings.md。自定义时有一条黄金法则永远追加不要整体替换config.keys否则会抹掉所有默认绑定-- 水平分屏绑定到 Cmd Opt Enter table.insert(config.keys, { key Enter, mods CMD|OPT, action wezterm.action.SplitHorizontal({ domain CurrentPaneDomain }), })由于 Kaku 基于 WezTerm 配置系统任何 WezTerm 的 Lua 配置项都能在kaku.lua中直接使用包括完整的 KeyAssignment 动作列表。6. 实用进阶技巧恢复上次会话默认开启重启后自动还原上次的标签与分屏config.restore_previous_session false可关闭选区滚轮行为config.selection_wheel_scroll_behavior Extend默认可在拖选文本时用滚轮跨屏扩大选区扩展命令面板通过wezterm.on(augment-command-palette, ...)钩子给Cmd Shift P面板添加自定义命令例如在 Finder 中显示当前目录配置校验调试设置环境变量KAKU_STRICT_CONFIG1可开启严格校验模式恢复出厂配置改乱了执行kaku reset清理受管配置块你的手写 Lua 会被保留7. 遇到问题官方文档与排查入口完整配置项说明docs/configuration.md常见问题透明窗口、恢复默认等docs/faq.md配置版本与迁移说明docs/config-versions.md配置加载核心实现config/src/lua.rsKaku 的 Lua 配置与 WezTerm 生态完全兼容这意味着你在 WezTerm 社区找到的主题方案、字体配置和快捷键技巧几乎可以原样搬进kaku.lua。从上面几节挑出你需要的片段开始动手吧几分钟就能得到一个专属于你的 AI 编程终端环境 【免费下载链接】Kaku A fast, out-of-the-box terminal built for AI coding.项目地址: https://gitcode.com/gh_mirrors/kaku5/Kaku创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
