Personalización de atajos de teclado de Pi Agent
Los atajos de teclado de Pi Agent son completamente personalizables. Este capítulo presenta la configuración predeterminada de atajos y cómo crear tu propio esquema de atajos.
Archivo de configuración
El archivo de configuración de atajos se encuentra en~/.pi/agent/keybindings.json。
Después de modificar, ejecuta/reloadpara que surta efecto, sin necesidad de reiniciar.
Formato de atajos de teclado
El formato de atajos estecla modificadora + teclaLos modificadores incluyen ctrl, shift, alt, super, y se pueden combinar.
Entre ellos, super requiere que la terminal pueda informar esa tecla modificadora de forma independiente (generalmente depende del protocolo de teclado de Kitty) para que funcione; puede no funcionar en terminales no compatibles.
Las teclas soportadas se clasifican en las siguientes categorías:
| Categoría | Valor | Ejemplo |
|---|---|---|
| Letras | a-z | ctrl+b、alt+d |
| Números | 0-9 | alt+1 |
| Teclas de función | f1-f12 | f2 |
| Teclas de dirección | up、down、left、right | alt+left |
| Teclas especiales | escape、enter、tab、space、backspace、delete、home、end、pageUp、pageDown | shift+enter |
| Símbolos | ` - = [ ] ; ' , . / etc. | ctrl+]、ctrl+- |
En el archivo de configuración, los modificadores se escriben en minúsculas (por ejemplo, ctrl+shift+p); en las tablas del texto se suele escribir Shift+Ctrl+P. Ambos son equivalentes.
Referencia rápida de atajos predeterminados
Las siguientes cuatro tablas enumeran los enlaces predeterminados de fábrica por área funcional, como base de referencia para la personalización.
Este capítulo solo enumera los enlaces comunes; ctrl+], ctrl+alt+], pageUp/pageDown, alt+y, ctrl+z y las teclas del selector de sesiones no están incluidas. La lista completa se puede ver con /hotkeys en el modo interactivo.
Operaciones del editor
Este grupo solo tiene efecto en el área de edición y se encarga del movimiento del cursor y la eliminación de texto.
| Operación | Atajo predeterminado | Descripción | Modo en el que se aplica |
|---|---|---|---|
| Mover cursor hacia arriba | up | Mueve el cursor hacia arriba en el editor; si ya está en la parte superior, cambia a revisar el historial más antiguo. | Área de edición |
| Mover cursor hacia abajo | down | Mueve el cursor hacia abajo en el editor; si ya está en la parte inferior, cambia a revisar el historial más reciente. | Área de edición |
| Mover cursor a la izquierda | left, ctrl+b | Mueve un carácter a la izquierda. | Área de edición |
| Mover cursor a la derecha | right, ctrl+f | Mueve un carácter a la derecha. | Área de edición |
| Mover a la izquierda por palabra | alt+left, ctrl+left, alt+b | Mueve una palabra a la izquierda. | Área de edición |
| Mover a la derecha por palabra | alt+right, ctrl+right, alt+f | Mueve una palabra a la derecha. | Área de edición |
| Inicio de línea | home, ctrl+home, ctrl+a | Salta al inicio de la línea. | Área de edición |
| Fin de línea | end, ctrl+end, ctrl+e | Salta al final de la línea. | Área de edición |
| Eliminar carácter anterior | backspace | Elimina el carácter antes del cursor. | Área de edición |
| Eliminar carácter siguiente | delete, ctrl+d | Elimina el carácter después del cursor (es una acción de edición). | Área de edición |
| Eliminar palabra anterior | ctrl+w, alt+backspace | Elimina una palabra antes del cursor. | Área de edición |
| Eliminar palabra siguiente | alt+d, alt+delete | Elimina una palabra después del cursor. | Área de edición |
| Eliminar hasta el inicio de línea | ctrl+u | Elimina el contenido desde el cursor hasta el inicio de la línea. | Área de edición |
| Eliminar hasta el fin de línea | ctrl+k | Elimina el contenido desde el cursor hasta el final de la línea. | Área de edición |
Entrada y envío
Este grupo controla cómo se hacen saltos de línea, autocompletado y envío del contenido; también se aplica al área de edición.
| Operación | Atajo predeterminado | Descripción | Modo en el que se aplica |
|---|---|---|---|
| Salto de línea | shift+enter, ctrl+j | Inserta un carácter de nueva línea. | Área de edición |
| Enviar | enter | Envía el contenido ingresado. | Área de edición |
| Tab / Autocompletado | tab | Activa el autocompletado de rutas. | Área de edición |
| Deshacer | ctrl+- | Deshace la última edición. | Área de edición |
| Pegar texto eliminado | ctrl+y | Pega el texto eliminado recientemente. | Área de edición |
Aplicación y mensajes
Este grupo se encarga de interrumpir la IA, gestionar el contenido del área de edición y la cola de mensajes; la mayoría no depende del foco en el área de edición.
| Operación | Atajo predeterminado | Descripción | Modo en el que se aplica |
|---|---|---|---|
| Interrumpir / Cancelar | escape | Cancelar la operación actual de la IA. | Global |
| Vaciar área de edición | ctrl+c | Vacía el contenido del área de edición; si se pulsa de nuevo, sale del programa. | Área de edición |
| Salir | ctrl+d | Sale del programa cuando el área de edición está vacía (es una acción app.exit, separada de las acciones de eliminación de la tabla anterior). | Área de edición |
| Editor externo | ctrl+g | Edita la entrada actual en un editor externo. | Área de edición |
| Pegar imagen | ctrl+v | Pega una imagen desde el portapapeles (Windows: alt+v). | Área de edición |
| Copiar respuesta de IA | ctrl+x | Copia el último mensaje de IA. | Área de edición |
| Enviar mensaje de seguimiento | alt+enter | Coloca el mensaje en la cola de seguimiento. | Área de edición |
| Recuperar mensaje en cola | alt+up | Trae de vuelta el mensaje en cola al editor. | Área de edición |
Modelo y razonamiento
Este grupo se usa para cambiar de modelo y ajustar el comportamiento de razonamiento; se puede usar en cualquier momento durante la conversación.
| Operación | Atajo predeterminado | Descripción | Modo en el que se aplica |
|---|---|---|---|
| Selector de modelo | ctrl+l | Abre el selector de modelo. | Global |
| Cambiar al siguiente modelo | ctrl+p | Cambia al siguiente modelo. | Global |
| Cambiar al modelo anterior | shift+ctrl+p | Cambia al modelo anterior. | Global |
| Cambiar nivel de razonamiento | shift+tab | Cicla a través de los niveles de razonamiento. | Área de edición |
| Alternar visualización de razonamiento | ctrl+t | Expande/colapsa el proceso de razonamiento de la IA. | Global |
| Alternar salida de herramientas | ctrl+o | Expande/colapsa la salida de las llamadas a herramientas. | Global (dentro del navegador /tree, alterna el modo de filtrado). |
Configuración personalizada de atajos
Solo tienes que enumerar en keybindings.json las operaciones que deseas sobrescribir; las operaciones no enumeradas mantienen su valor predeterminado.
Escribe el valor de un enlace como un array vacío, por ejemplo"tui.altScreen.pageUp": [], para deshabilitar completamente ese atajo.
Estilo Emacs
Si estás acostumbrado a los atajos de Emacs, puedes usar la siguiente configuración en~/.pi/agent/keybindings.jsonusar la siguiente configuración:
Ejemplo
"tui.editor.historyPrevious": "ctrl+p",
"tui.editor.historyNext": "ctrl+n",
"tui.editor.cursorUp": ["up"],
"tui.editor.cursorDown": ["down"],
"tui.editor.cursorLeft": ["left", "ctrl+b"],
"tui.editor.cursorRight": ["right", "ctrl+f"],
"tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
"tui.editor.cursorWordRight": ["alt+right", "alt+f"],
"tui.editor.deleteCharForward": ["delete", "ctrl+d"],
"tui.editor.deleteCharBackward": ["backspace", "ctrl+h"],
"tui.input.newLine": ["shift+enter", "ctrl+j"]
}
Las acciones de historial historyPrevious e historyNext no tienen enlace predeterminado; están pensadas para navegar por el historial de envíos y también cambian de entrada histórica en entradas multilínea.
Después de enlazar ctrl+p a la entrada histórica anterior, cuando el área de edición tiene el foco, Ctrl+P será capturado por este enlace de historial; el cambio al modelo siguiente deja de funcionar temporalmente en ese escenario.
Ctrl+P en listas de selección como el selector de modelo no se ve afectado y sigue ejecutando la acción propia del selector.
Estilo Vim
Si estás acostumbrado a las teclas de dirección de Vim, puedes usar la siguiente configuración:
Ejemplo
"tui.editor.cursorUp": ["up", "alt+k"],
"tui.editor.cursorDown": ["down", "alt+j"],
"tui.editor.cursorLeft": ["left", "alt+h"],
"tui.editor.cursorRight": ["right", "alt+l"],
"tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
"tui.editor.cursorWordRight": ["alt+right", "alt+w"]
}
Aquí se eligen alt+h/j/k/l para evitar enlaces integrados como Ctrl+H/Ctrl+D, por eso se usa la familia Alt.
La configuración de atajos de Pi Agent sobrescribe los valores predeterminados.
Cada operación puede estar enlazada a uno o más atajos.
Las operaciones no enumeradas en el archivo de configuración mantienen sus atajos predeterminados.
Ver todos los atajos
En el modo interactivo, usa el siguiente comando para mostrar todos los atajos y sus enlaces actuales:
/hotkeys
Fragmento de salida:
编辑器 tui.editor.cursorUp up tui.editor.cursorDown down tui.editor.cursorWordLeft alt+left, ctrl+left, alt+b tui.input.submit enter 模型与推理 app.model.select ctrl+l app.model.cycleForward ctrl+p app.model.cycleBackward shift+ctrl+p
Las operaciones de atajos usan IDs con espacio de nombres, con el formato «módulo.acción».
Los ids sin espacio de nombres (como cursorUp, expandTools) en archivos de configuración de versiones antiguas se migrarán automáticamente a ids con espacio de nombres al iniciar, sin necesidad de modificación manual.
Este comando lista todas las acciones de atajos de teclado disponibles, los enlaces actuales y el área funcional a la que pertenecen; es la mejor forma de solucionar conflictos de atajos o encontrar el atajo de una función específica.
Teclas en modo de pantalla completa
usar--tui-mode fullscreenAl iniciar, el registro de conversación (transcript) se desplaza dentro de la ventana del terminal, mientras que el área de edición y la barra de estado inferior permanecen fijas.
En este momento, home, end, pageUp y pageDown sin teclas modificadoras se usan para desplazar el registro de conversación, mientras que sus variantes con ctrl siguen perteneciendo al editor.
En el modo normal, ambos grupos de teclas actúan sobre el editor.
El modo de pantalla completa también tiene búsqueda y navegación exclusivas: ctrl+shift+f busca en el registro de conversación, ctrl+up y ctrl+down saltan entre el mensaje marcado anterior y el siguiente.
La prioridad de los enlaces de desplazamiento en pantalla completa es mayor que la de los enlaces del editor, y aún se pueden ajustar mediante enlaces de acciones normales.
| Teclas | Modo normal | Modo de pantalla completa |
|---|---|---|
| home、end | Editor | Desplazar registro de conversación |
| ctrl+home、ctrl+end | Editor | Editor |
| pageUp、pageDown | Editor | Desplazar registro de conversación |
| ctrl+pageUp、ctrl+pageDown | Editor | Editor |
| ctrl+shift+f (ctrl+f en Windows/WSL) | No tiene efecto | Buscar en el registro de conversación |
| ctrl+up、ctrl+down | No tiene efecto | Saltar al mensaje marcado anterior/siguiente |