第五部分,Skills、模板与 Packages

Themes 与终端显示

选择和创建 Pi Themes,理解颜色 Token、256 色兼容、Markdown 与 Diff 显示。

主题文件

Themes 是定义 TUI 颜色的 JSON 文件,可放在全局或项目主题目录。通过 /settings 选择主题并用 /reload 载入修改。

主题覆盖核心 UI、背景、Markdown、工具 Diff、语法高亮和思考级别边框。颜色必须在目标终端中实际检查。

  • 保证正文与背景对比度。
  • 成功、警告和错误不能只靠颜色区分。
  • Diff 添加与删除要明显。
  • 同时测试 true color 和 256 色终端。
  • HTML 导出颜色可单独配置。

终端差异

同一颜色在不同终端和远程 tmux 中可能不同。主题发布前至少检查浅色、深色和低色彩环境。

视觉定制不应破坏快捷键提示、焦点和工具结果可读性。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License