SuperAPI AI 工具集

pi-customization

智能体与模型

查看项目

更新于 10-16 01:09

技能介绍

Pi Customization 是一套面向 Pi 编码智能体的定制方法,用于调整其主题外观、快捷键、提示模板、系统提示词与整体设置。

用途:当需要配置或修改 Pi 的视觉样式、交互按键、可复用提示片段或系统提示词时使用本技能。

主要能力:

  1. 主题:主题 JSON 定义 name(必填且唯一)、可选 vars 作为可复用颜色别名,以及全部 51 个颜色 token,所有内容放在 colors 键下。主题从 ~/.pi/agent/themes/.json(全局)和 .pi/themes/.json(项目)加载,支持热重载,可通过 /settings 或 pi --theme <name> 选择。
  2. 快捷键:写在 ~/.pi/agent/keybindings.json(不是 settings.json),动作 ID 带命名空间,如 tui.input.submit、tui.editor.cursorUp、app.interrupt,键值格式为修饰键+键。运行 /reload 可在不重启的情况下生效。
  3. 提示模板:Markdown 片段放在 ~/.pi/agent/prompts/.md 或 .pi/prompts/.md,文件名(去掉 .md)即 /name 命令;使用 $1、$2、$@、${@:N} 位置参数,不用 {variable} 或 include 语法;支持带可选 description 的 YAML frontmatter。
  4. 系统提示词覆盖:用 .pi/SYSTEM.md(项目)或 ~/.pi/agent/SYSTEM.md(全局)替换默认系统提示词;用 APPEND_SYSTEM.md 追加而非替换;覆盖后上下文文件与技能仍会追加。
  5. 设置:settings.json 负责把上述内容整合起来。

使用方式示例:从 packages/coding-agent/src/modes/interactive/theme/ 复制 dark.json,修改 colors 下的颜色值,放到 ~/.pi/agent/themes/ 后选择;编辑 keybindings.json 映射动作 ID 到按键数组(如 "tui.input.submit": ["ctrl+enter"]),再运行 /reload;在 prompts 目录写 .md 模板并以 /文件名 调用。

限制与注意:不要把快捷键硬编码进智能体组件源码,也不要放在 settings.json;提示模板不支持 {variable} 或 <include> 语法。资料未提供主题之外的其他配置细节或价格、平台信息。