powerlevel10k 主题配置需四步：安装 meslolgs nf 字体、克隆主题到 custom/themes/、修改 .zshrc 中 zsh_theme 为 "powerlevel10k/powerlevel10k"、运行 p10k configure 完成交互式定制。
直接换 powerlevel10k 主题不难，但有四个关键环节缺一不可：字体、主题文件、配置启用、向导定制。跳过任意一步都可能出现方块、卡顿或提示符不显示。
必须先装 Nerd Fonts 字体
Powerlevel10k 依赖特殊符号（比如 Git 分支图标、箭头、锁形状态标识），系统默认字体无法渲染。推荐用专为它优化的 MesloLGS NF：
- 去 官方页面 点 “Download the font”，下载 Regular / Bold / Italic / Bold Italic 四个 .ttf 文件
- 双击每个文件，点“安装字体”（会进 macOS 字体册）
- 打开终端（iTerm2 或 Terminal），进入偏好设置 → Profiles → Text → Font，把字体设为 MesloLGS NF，字号调到 12–14
克隆主题到正确路径
Powerlevel10k 不在 Oh My Zsh 默认主题列表里，得手动放进自定义目录：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 运行命令：
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k - 如果提示
ZSH_CUSTOM未定义，改用完整路径：
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/.oh-my-zsh/custom/themes/powerlevel10k - 执行
ls ~/.oh-my-zsh/custom/themes/powerlevel10k，看到config/p10k.zsh等文件就说明成功了
修改 .zshrc 并重载
告诉 zsh 使用这个新主题：
- 编辑配置文件：
vi ~/.zshrc - 找到
ZSH_THEME=这一行，替换成：
ZSH_THEME="powerlevel10k/powerlevel10k" - 保存退出后执行：
source ~/.zshrc - 首次加载会自动弹出
p10k configure向导；如果没出现，手动运行一次
运行 p10k configure 完成定制
这个交互式向导是核心步骤，它会问你风格、颜色、图标、是否显示时间/Git 状态等。全程用方向键和回车选择即可：
- 选 Lean 或 Classic 风格起步更清爽
- 建议开启 显示当前 Git 分支 和 命令执行耗时，实用性强
- 如果中途提示 “Font not found”，说明字体没装对或终端没设对——回到上一步检查字体设置
- 完成之后会生成
~/.p10k.zsh，下次启动自动生效
