第三部分,上下文与 Sessions
键位、编辑器与 Shell Aliases
自定义 keybindings.json、外部编辑器与非交互 Bash 环境,解决快捷键和 alias 不生效。
键位配置
所有快捷键可在 ~/.pi/agent/keybindings.json 中修改。动作使用命名空间标识,旧标识会在启动时迁移。
先通过 /hotkeys 查看当前绑定,再处理终端自身占用。外部编辑器通过 Ctrl+G 打开,Pi 会按 externalEditor、VISUAL、EDITOR 和平台默认顺序选择。
{
"app.newSession": ["ctrl+n"],
"app.modelSelector": ["ctrl+l"]
}Shell Alias 为什么失效
Pi 的 bash 工具使用非交互 bash -c,默认不会展开交互 shell aliases。需要 alias 时应通过 shell 配置显式启用,或更稳妥地把常用操作做成 PATH 中的脚本。
团队自动化不要依赖个人 alias,使用完整命令或仓库脚本才能复现。
官方资料
本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。
Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License。