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íaValorEjemplo
Letrasa-zctrl+b、alt+d
Números0-9alt+1
Teclas de funciónf1-f12f2
Teclas de direcciónup、down、left、rightalt+left
Teclas especialesescape、enter、tab、space、backspace、delete、home、end、pageUp、pageDownshift+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ónAtajo predeterminadoDescripciónModo en el que se aplica
Mover cursor hacia arribaupMueve 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 abajodownMueve 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 izquierdaleft, ctrl+bMueve un carácter a la izquierda.Área de edición
Mover cursor a la derecharight, ctrl+fMueve un carácter a la derecha.Área de edición
Mover a la izquierda por palabraalt+left, ctrl+left, alt+bMueve una palabra a la izquierda.Área de edición
Mover a la derecha por palabraalt+right, ctrl+right, alt+fMueve una palabra a la derecha.Área de edición
Inicio de líneahome, ctrl+home, ctrl+aSalta al inicio de la línea.Área de edición
Fin de líneaend, ctrl+end, ctrl+eSalta al final de la línea.Área de edición
Eliminar carácter anteriorbackspaceElimina el carácter antes del cursor.Área de edición
Eliminar carácter siguientedelete, ctrl+dElimina el carácter después del cursor (es una acción de edición).Área de edición
Eliminar palabra anteriorctrl+w, alt+backspaceElimina una palabra antes del cursor.Área de edición
Eliminar palabra siguientealt+d, alt+deleteElimina una palabra después del cursor.Área de edición
Eliminar hasta el inicio de líneactrl+uElimina el contenido desde el cursor hasta el inicio de la línea.Área de edición
Eliminar hasta el fin de líneactrl+kElimina 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ónAtajo predeterminadoDescripciónModo en el que se aplica
Salto de líneashift+enter, ctrl+jInserta un carácter de nueva línea.Área de edición
EnviarenterEnvía el contenido ingresado.Área de edición
Tab / AutocompletadotabActiva el autocompletado de rutas.Área de edición
Deshacerctrl+-Deshace la última edición.Área de edición
Pegar texto eliminadoctrl+yPega 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ónAtajo predeterminadoDescripciónModo en el que se aplica
Interrumpir / CancelarescapeCancelar la operación actual de la IA.Global
Vaciar área de ediciónctrl+cVacía el contenido del área de edición; si se pulsa de nuevo, sale del programa.Área de edición
Salirctrl+dSale 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 externoctrl+gEdita la entrada actual en un editor externo.Área de edición
Pegar imagenctrl+vPega una imagen desde el portapapeles (Windows: alt+v).Área de edición
Copiar respuesta de IActrl+xCopia el último mensaje de IA.Área de edición
Enviar mensaje de seguimientoalt+enterColoca el mensaje en la cola de seguimiento.Área de edición
Recuperar mensaje en colaalt+upTrae 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ónAtajo predeterminadoDescripciónModo en el que se aplica
Selector de modeloctrl+lAbre el selector de modelo.Global
Cambiar al siguiente modeloctrl+pCambia al siguiente modelo.Global
Cambiar al modelo anteriorshift+ctrl+pCambia al modelo anterior.Global
Cambiar nivel de razonamientoshift+tabCicla a través de los niveles de razonamiento.Área de edición
Alternar visualización de razonamientoctrl+tExpande/colapsa el proceso de razonamiento de la IA.Global
Alternar salida de herramientasctrl+oExpande/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.

TeclasModo normalModo de pantalla completa
home、endEditorDesplazar registro de conversación
ctrl+home、ctrl+endEditorEditor
pageUp、pageDownEditorDesplazar registro de conversación
ctrl+pageUp、ctrl+pageDownEditorEditor
ctrl+shift+f (ctrl+f en Windows/WSL)No tiene efectoBuscar en el registro de conversación
ctrl+up、ctrl+downNo tiene efectoSaltar al mensaje marcado anterior/siguiente
Otras extensiones