01. 背景与目标

1.1 问题陈述 (Problem Statement)

1.1.1 终端模拟器的选择困境

在现代开发工作流中，终端模拟器是开发者使用频率最高的工具之一。然而，选择合适的终端工具面临着多重挑战：

痛点一：速度与功能的权衡

• Alacritty：以速度著称（号称”世界上最快的终端”），但不支持多 Tab 和分屏功能，对于需要同时运行多个 CLI 工具（如 Claude Code + Codex Review + git diff）的 AI 编程场景不够友好。
• iTerm2：功能丰富且稳定，但体积庞大、启动较慢，且部分高级功能需要付费。
• Warp：新兴的 AI 终端，但需要强制登录，引起部分用户反感。
• Kitty：功能强大，但窗口管理存在 Bug 且修复缓慢。
• Ghostty：新兴选择，但字体渲染效果不符合部分用户期望。

痛点二：配置复杂度

• WezTerm：功能最强大且高度可定制，但需要大量手动配置才能达到理想状态。根据作者 tw93 的观察，WezTerm 上一个正式版本已是两年前，且包含大量兼容性模块导致体积较大。
• 新用户需要手动配置主题、Shell 工具（Starship、zsh 插件）、键绑定等，学习曲线陡峭。

痛点三：AI 编程工作流的特殊需求

• AI 辅助编程成为主流，开发者需要在终端内同时运行多个 AI 工具（Claude Code、Codex、Copilot CLI 等）
• 需要更好的 Tab 和分屏管理，以便同时查看代码、运行命令和 git diff
• 需要快速启动和低延迟，保持流畅的编程体验

1.1.2 用户反馈与实际需求

根据 V2EX 社区的用户反馈和 GitHub 项目数据（2.7k Stars），开发者对终端的核心需求可归纳为：

1. 开箱即用：无需复杂配置即可获得良好体验
2. 速度与轻量：启动时间 < 200ms，二进制体积 < 50MB
3. 多任务支持：Tab、分屏、工作区管理
4. AI 友好：与 AI 工具链无缝集成
5. 可定制性：保留深度定制的可能性

1.2 设计目标 (Design Goals)

Kaku 项目的设计目标可总结为以下几点：

1.2.1 核心目标

1.2.2 性能优化目标

根据官方数据，Kaku 相比 WezTerm 的性能提升：

性能指标对比：

| 指标              | WezTerm  | Kaku    | 优化幅度 |
|-------------------|----------|---------|----------|
| 可执行文件体积     | ~67 MB   | ~40 MB  | -40%     |
| 资源占用           | ~100 MB  | ~80 MB  | -20%     |
| 启动延迟           | 标准      | 瞬时     | 显著改善  |
| Shell 引导时间     | ~200ms   | ~100ms  | -50%     |

优化方法：
- 激进地剥离未使用符号
- 懒加载配色方案
- Shell 环境优化

1.2.3 用户体验目标

1. macOS 原生体验：

   • 使用 macOS 原生快捷键（Cmd+T 新建 Tab、Cmd+W 关闭等）
   • 支持 Finder 集成（右键菜单、拖拽文件到 Dock 图标）
   • 通过 Apple 公证（Notarized），无安全警告

2. 内置工具链：

   • 预装 zsh 插件（z、zsh-completions、Syntax Highlighting、Autosuggestions）
   • 可选 CLI 工具（Starship、Delta、Lazygit、Yazi）
   • 首次启动自动配置 Shell 环境

3. AI 集成：

   • Kaku Assistant：自动分析失败命令并提供修复建议
   • AI 工具配置页面：统一管理 Claude Code、Codex 等工具配置
   • 快捷键快速应用 AI 建议（Cmd+Shift+E）

1.3 约束条件 (Constraints)

1.3.1 技术约束

1. 平台限制：目前仅支持 macOS（Windows/Linux 版本可能在成熟后推出）
2. WezTerm 兼容性：必须保持与 WezTerm Lua API 的完全兼容
3. Rust 工具链：依赖特定 Rust 版本（通过 rust-toolchain.toml 固定）
4. 代码签名：macOS 应用需要通过 Apple 公证才能无警告运行

1.3.2 业务约束

1. 个人项目：主要由作者 tw93 一人维护，资源有限
2. 开源许可：采用 MIT License，需要平衡开放性与可持续性
3. 用户期望管理：避免过度承诺功能，专注核心体验

1.4 成功标准 (Success Metrics)

1.4.1 技术指标

• 启动时间 < 150ms（冷启动）
• 二进制体积 < 45MB（DMG 分发）
• 内存占用 < 100MB（空闲状态）
• 配置加载时间 < 50ms

1.4.2 用户指标

• GitHub Stars > 5000（当前 2.7k）
• 月活跃用户 > 10000
• 用户满意度 > 4.5/5.0
• 社区贡献者 > 50 人（当前 405 人）

1.4.3 功能指标

• 100% WezTerm 配置 API 兼容
• 内置 AI Assistant 响应时间 < 3s
• 支持所有主流 AI CLI 工具配置
• 零配置首次使用体验

1.5 研究范围与边界

1.5.1 本报告覆盖内容

• Kaku 的产品特点与架构设计
• 基于 WezTerm 的改造方式与模块系统
• 配置选项与定制能力（特别是字体配置）
• 与竞品的对比分析
• 使用建议与风险评估

1.5.2 不覆盖内容

• 详细的代码实现分析（超出产品研究范围）
• 性能基准测试（需要专门的性能研究报告）
• 用户手册或配置指南（参考官方文档）

1.6 本章小结

Kaku 的产生源于作者 tw93 对现有终端工具的不满和对理想工作流的追求。通过深度定制 WezTerm，Kaku 在保持强大功能的同时，实现了更快的速度、更小的体积和更好的开箱即用体验。

关键洞察：

1. Kaku 不是简单的 WezTerm 主题包，而是源码级的深度定制
2. 性能优化是核心目标，通过裁剪和懒加载实现 40% 体积减小
3. AI 编程场景是主要设计目标，内置 AI Assistant 和工具链集成
4. 完全兼容 WezTerm 配置生态，降低用户迁移成本

下一章将深入分析 Kaku 的技术架构，包括目录结构、模块系统和配置文件加载机制。