fix(docs): locale markdown issues

This commit is contained in:
Adam
2026-02-09 13:55:55 -06:00
parent d9b4535d64
commit 274bb948e7
213 changed files with 1776 additions and 1789 deletions

View File

@@ -5,7 +5,7 @@ description: Utilice OpenCode en cualquier editor compatible con ACP.
OpenCode admite el [Protocolo de cliente de agente](https://agentclientprotocol.com) o (ACP), lo que le permite usarlo directamente en editores e IDE compatibles.
:::consejo
:::tip
Para obtener una lista de editores y herramientas compatibles con ACP, consulte el [informe de progreso de ACP](https://zed.dev/blog/acp-progress-report#available-now).
:::
@@ -144,7 +144,7 @@ Si necesita pasar variables de entorno (como `OPENCODE_API_KEY`), consulte [Conf
OpenCode funciona igual a través de ACP que en la terminal. Todas las funciones son compatibles:
:::nota
:::note
Algunos comandos de barra integrados como `/undo` y `/redo` no son compatibles actualmente.
:::

View File

@@ -5,7 +5,7 @@ description: Configurar y utilizar agentes especializados.
Los agentes son asistentes de IA especializados que se pueden configurar para tareas y flujos de trabajo específicos. Le permiten crear herramientas enfocadas con indicaciones, modelos y acceso a herramientas personalizados.
:::consejo
:::tip
Utilice el agente del plan para analizar el código y revisar sugerencias sin realizar ningún cambio en el código.
:::
@@ -23,7 +23,7 @@ Hay dos tipos de agentes en OpenCode; agentes primarios y subagentes.
Los agentes primarios son los asistentes principales con los que interactúas directamente. Puede recorrerlos usando la tecla **Tab** o la combinación de teclas `switch_agent` configurada. Estos agentes manejan su conversación principal. El acceso a las herramientas se configura mediante permisos; por ejemplo, Build tiene todas las herramientas habilitadas mientras que Plan está restringido.
:::consejo
:::tip
Puede utilizar la tecla **Tab** para cambiar entre agentes principales durante una sesión.
:::
@@ -301,7 +301,7 @@ Si no se establece esto, el agente continuará iterando hasta que el modelo deci
Cuando se alcanza el límite, el agente recibe un mensaje especial del sistema que le indica que responda con un resumen de su trabajo y las tareas restantes recomendadas.
:::precaución
:::caution
El campo heredado `maxSteps` está en desuso. Utilice `steps` en su lugar.
:::
@@ -345,7 +345,7 @@ Esta ruta es relativa a donde se encuentra el archivo de configuración. Entonce
Utilice la configuración `model` para anular el modelo de este agente. Útil para utilizar diferentes modelos optimizados para diferentes tareas. Por ejemplo, un modelo más rápido de planificación, un modelo más capaz de implementación.
:::consejo
:::tip
Si no especifica un modelo, los agentes primarios usarán el [modelo configurado globalmente](/docs/config#models), mientras que los subagentes usarán el modelo del agente primario que invocó al subagente.
:::
@@ -385,7 +385,7 @@ Controle qué herramientas están disponibles en este agente con la configuraci
}
```
:::nota
:::note
La configuración específica del agente anula la configuración global.
:::
@@ -557,7 +557,7 @@ Oculte un subagente del menú de autocompletar `@` con `hidden: true`. Útil par
Esto sólo afecta la visibilidad del usuario en el menú de autocompletar. El modelo aún puede invocar agentes ocultos a través de la herramienta Tarea si los permisos lo permiten.
:::nota
:::note
Sólo aplica para agentes `mode: subagent`.
:::
@@ -586,11 +586,11 @@ Controle qué subagentes puede invocar un agente a través de la herramienta Tar
Cuando se establece en `deny`, el subagente se elimina por completo de la descripción de la herramienta Tarea, por lo que el modelo no intentará invocarlo.
:::consejo
:::tip
Las reglas se evalúan en orden y la **última regla coincidente gana**. En el ejemplo anterior, `orchestrator-planner` coincide con `*` (denegar) y `orchestrator-*` (permitir), pero como `orchestrator-*` viene después de `*`, el resultado es `allow`.
:::
:::consejo
:::tip
Los usuarios siempre pueden invocar cualquier subagente directamente a través del menú de autocompletar `@`, incluso si los permisos de tarea del agente lo niegan.
:::
@@ -656,7 +656,7 @@ Por ejemplo, con los modelos de razonamiento de OpenAI, puedes controlar el esfu
Estas opciones adicionales son específicas del modelo y del proveedor. Consulte la documentación de su proveedor para conocer los parámetros disponibles.
:::consejo
:::tip
Ejecute `opencode models` para ver una lista de los modelos disponibles.
:::
@@ -696,7 +696,7 @@ A continuación se muestran algunos casos de uso comunes para diferentes agentes
A continuación se muestran algunos agentes de ejemplo que pueden resultarle útiles.
:::consejo
:::tip
¿Tiene un agente que le gustaría compartir? [Enviar un PR](https://github.com/anomalyco/opencode).
:::

View File

@@ -33,6 +33,7 @@ opencode [project]
| ------------ | ----- | ---------------------------------------------- |
| `--continue` | `-c` | Continuar la última sesión |
| `--session` | `-s` | ID de sesión para continuar |
| `--fork` | | Bifurcar la sesión al continuar (usar con `--continue` o `--session`) |
| `--prompt` | | Aviso de uso |
| `--model` | `-m` | Modelo a utilizar en forma de proveedor/modelo |
| `--agent` | | Agente a utilizar |
@@ -339,6 +340,7 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
| `--command` | | El comando a ejecutar, use mensaje para args |
| `--continue` | `-c` | Continuar la última sesión |
| `--session` | `-s` | ID de sesión para continuar |
| `--fork` | | Bifurcar la sesión al continuar (usar con `--continue` o `--session`) |
| `--share` | | Comparte la sesión |
| `--model` | `-m` | Modelo a utilizar en forma de proveedor/modelo |
| `--agent` | | Agente a utilizar |

View File

@@ -316,7 +316,7 @@ Esta es una opción de configuración **opcional**.
opencode incluye varios comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`; [más información](/docs/tui#commands).
:::nota
:::note
Los comandos personalizados pueden anular los comandos integrados.
:::

View File

@@ -28,7 +28,7 @@ OpenCode admite los formatos **JSON** y **JSONC** (JSON con comentarios).
Puedes colocar tu configuración en un par de ubicaciones diferentes y tienen un
diferente orden de precedencia.
:::nota
:::note
Los archivos de configuración se **fusionan**, no se reemplazan.
:::
@@ -51,7 +51,7 @@ Las fuentes de configuración se cargan en este orden (las fuentes posteriores a
Esto significa que las configuraciones del proyecto pueden anular los valores predeterminados globales y las configuraciones globales pueden anular los valores predeterminados de la organización remota.
:::nota
:::note
Los directorios `.opencode` y `~/.config/opencode` usan **nombres en plural** para los subdirectorios: `agents/`, `commands/`, `modes/`, `plugins/`, `skills/`, `tools/` y `themes/`. También se admiten nombres singulares (por ejemplo, `agent/`) para compatibilidad con versiones anteriores.
:::
@@ -105,7 +105,7 @@ La configuración global anula los valores predeterminados de la organización r
Agregue `opencode.json` en la raíz de su proyecto. La configuración del proyecto tiene la mayor prioridad entre los archivos de configuración estándar: anula las configuraciones globales y remotas.
:::consejo
:::tip
Coloque la configuración específica del proyecto en la raíz de su proyecto.
:::
@@ -291,7 +291,7 @@ Amazon Bedrock admite la configuración específica de AWS:
- `profile` - AWS perfil con nombre de `~/.aws/credentials` (el valor predeterminado es `AWS_PROFILE` var env)
- `endpoint`: URL de punto de enlace personalizada para puntos de enlace de VPC. Este es un alias para la opción genérica `baseURL` que utiliza terminología específica de AWS. Si se especifican ambos, `endpoint` tiene prioridad.
:::nota
:::note
Los tokens de portador (`AWS_BEARER_TOKEN_BEDROCK` o `/connect`) tienen prioridad sobre la autenticación basada en perfil. Consulte [precedencia de autenticación](/docs/providers#authentication-precedence) para obtener más detalles.
:::
@@ -576,7 +576,7 @@ Puede deshabilitar proveedores que se cargan automáticamente a través de la op
}
```
:::nota
:::note
El `disabled_providers` tiene prioridad sobre `enabled_providers`.
:::
@@ -601,7 +601,7 @@ Puede especificar una lista de proveedores permitidos a través de la opción `e
Esto es útil cuando desea restringir OpenCode para que utilice únicamente proveedores específicos en lugar de deshabilitarlos uno por uno.
:::nota
:::note
El `disabled_providers` tiene prioridad sobre `enabled_providers`.
:::
@@ -620,7 +620,7 @@ La clave `experimental` contiene opciones que se encuentran en desarrollo activo
}
```
:::precaución
:::caution
Las opciones experimentales no son estables. Pueden cambiar o eliminarse sin previo aviso.
:::

View File

@@ -3,7 +3,7 @@ title: Herramientas personalizadas
description: Cree herramientas que LLM pueda llamar en opencode.
---
Las herramientas personalizadas son funciones que usted crea y que el LLM puede llamar durante las conversaciones. Trabajan junto con las [herramientas integradas] (./tools) de opencode como `read`, `write` y `bash`.
Las herramientas personalizadas son funciones que usted crea y que el LLM puede llamar durante las conversaciones. Trabajan junto con las [herramientas integradas](/docs/tools) de opencode como `read`, `write` y `bash`.
---
@@ -81,7 +81,7 @@ Esto crea dos herramientas: `math_add` y `math_multiply`.
### Argumentos
Puedes usar `tool.schema`, que es simplemente [Zod](/docs/tools), para definir tipos de argumentos.
Puedes usar `tool.schema`, que es simplemente [Zod](https://zod.dev), para definir tipos de argumentos.
```ts "tool.schema"
args: {
@@ -167,4 +167,4 @@ export default tool({
})
```
Aquí estamos usando la utilidad [`Bun.$`](https://zod.dev) para ejecutar el script Python.
Aquí estamos usando la utilidad [`Bun.$`](https://bun.com/docs/runtime/shell) para ejecutar el script Python.

View File

@@ -5,7 +5,7 @@ description: Proyectos e integraciones construidas con OpenCode.
Una colección de proyectos comunitarios construidos en OpenCode.
:::nota
:::note
¿Quieres agregar tu proyecto relacionado con OpenCode a esta lista? Envíe un PR.
:::

View File

@@ -8,7 +8,7 @@ export const email = `mailto:${config.email}`
OpenCode Enterprise es para organizaciones que desean garantizar que su código y sus datos nunca abandonen su infraestructura. Puede hacerlo mediante el uso de una configuración centralizada que se integra con su SSO y su puerta de enlace AI interna.
:::nota
:::note
OpenCode no almacena ningún código ni datos de contexto.
:::
@@ -154,7 +154,7 @@ npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
Esto crea `~/.npmrc` con detalles de autenticación. OpenCode automáticamente
recoge esto.
:::precaución
:::caution
Debe iniciar sesión en el registro privado antes de ejecutar OpenCode.
:::

View File

@@ -64,7 +64,7 @@ Mencione `@opencode` en un comentario y OpenCode ejecutará tareas dentro de su
OpenCode se ejecuta en su canalización de CI/CD GitLab. Esto es lo que necesitará para configurarlo:
:::consejo
:::tip
Consulte los [**GitLab documentos**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) para obtener instrucciones actualizadas.
:::
@@ -160,7 +160,7 @@ Puede consultar los [GitLab CLI documentos de los agentes](https://docs.gitlab.c
A continuación se muestran algunos ejemplos de cómo puede utilizar OpenCode en GitLab.
:::consejo
:::tip
Puede configurarlo para utilizar una frase de activación diferente a `@opencode`.
:::

View File

@@ -182,7 +182,7 @@ A continuación, inicialice OpenCode para el proyecto ejecutando el siguiente co
Esto hará que OpenCode analice su proyecto y cree un archivo `AGENTS.md` en
la raíz del proyecto.
:::consejo
:::tip
Debes enviar el archivo `AGENTS.md` de tu proyecto a Git.
:::
@@ -205,7 +205,7 @@ ayuda.
Puede pedirle a OpenCode que le explique el código base.
:::consejo
:::tip
Utilice la tecla `@` para realizar una búsqueda aproximada de archivos en el proyecto.
:::
@@ -321,7 +321,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
Desde aquí puedes modificar el mensaje y pedirle a OpenCode que vuelva a intentarlo.
:::consejo
:::tip
Puede ejecutar `/undo` varias veces para deshacer varios cambios.
:::
@@ -336,7 +336,7 @@ O **puedes rehacer** los cambios usando el comando `/redo`.
## Compartir
Las conversaciones que tengas con OpenCode pueden ser [compartidas con tu
equipo](/docs/compartir).
equipo](/docs/share).
```bash frame="none"
/share
@@ -344,7 +344,7 @@ equipo](/docs/compartir).
Esto creará un enlace a la conversación actual y lo copiará en su portapapeles.
:::nota
:::note
Las conversaciones no se comparten de forma predeterminada.
:::

View File

@@ -48,7 +48,7 @@ OpenCode viene con varios servidores LSP integrados para idiomas populares:
Los servidores LSP se habilitan automáticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
:::nota
:::note
Puede deshabilitar las descargas automáticas del servidor LSP configurando la variable de entorno `OPENCODE_DISABLE_LSP_DOWNLOAD` en `true`.
:::
@@ -126,7 +126,7 @@ Utilice la propiedad `initialization` para pasar opciones de inicialización al
}
```
:::nota
:::note
Las opciones de inicialización varían según el servidor LSP. Consulte la documentación de su servidor LSP para conocer las opciones disponibles.
:::

View File

@@ -13,7 +13,7 @@ Una vez agregadas, las herramientas MCP están disponibles automáticamente para
Cuando utiliza un servidor MCP, se suma al contexto. Esto puede acumularse rápidamente si tiene muchas herramientas. Por lo que recomendamos tener cuidado con qué servidores MCP utiliza.
:::consejo
:::tip
Los servidores MCP se agregan a su contexto, por lo que debe tener cuidado con cuáles habilita.
:::
@@ -383,7 +383,7 @@ El patrón global utiliza patrones globales simples de expresiones regulares:
- `?` coincide exactamente con un carácter
- Todos los demás caracteres coinciden literalmente
:::nota
:::note
Las herramientas del servidor MCP están registradas con el nombre del servidor como prefijo, por lo que para deshabilitar todas las herramientas para un servidor simplemente use:
```

View File

@@ -29,7 +29,7 @@ Una vez que hayas configurado tu proveedor podrás seleccionar el modelo que des
Hay muchos modelos disponibles y cada semana salen nuevos modelos.
:::consejo
:::tip
Considere utilizar uno de los modelos que recomendamos.
:::
@@ -165,7 +165,7 @@ Varía según el modelo, pero aproximadamente:
- `low` - Menor esfuerzo/presupuesto simbólico
- `high` - Mayor esfuerzo/presupuesto simbólico
:::consejo
:::tip
Esta lista no es exhaustiva. Muchos otros proveedores también tienen valores predeterminados integrados.
:::

View File

@@ -3,7 +3,7 @@ title: Modos
description: Diferentes modos para diferentes casos de uso.
---
:::precaución
:::caution
Los modos ahora se configuran a través de la opción `agent` en la configuración opencode. El
La opción `mode` ahora está en desuso. [Más información](/docs/agents).
:::

View File

@@ -22,7 +22,7 @@ export HTTP_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
```
:::precaución
:::caution
El TUI se comunica con un servidor HTTP local. Debe omitir el proxy para esta conexión para evitar bucles de enrutamiento.
:::
@@ -38,7 +38,7 @@ Si su proxy requiere autenticación básica, incluya las credenciales en la URL.
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
```
:::precaución
:::caution
Evite codificar contraseñas. Utilice variables de entorno o almacenamiento seguro de credenciales.
:::

View File

@@ -185,7 +185,7 @@ La herramienta proporciona el conjunto de patrones que `always` aprobaría (por
Puede anular los permisos por agente. Los permisos del agente se combinan con la configuración global y las reglas del agente tienen prioridad. [Más información](/docs/agents#permissions) sobre los permisos de los agentes.
:::nota
:::note
Consulte la sección [Reglas granulares (sintaxis de objeto)](#granular-rules-object-syntax) anterior para obtener ejemplos de coincidencia de patrones más detallados.
:::
@@ -232,6 +232,6 @@ permission:
Only analyze code and suggest changes.
```
:::consejo
:::tip
Utilice la coincidencia de patrones para comandos con argumentos. `"grep *"` permite `grep pattern file.txt`, mientras que `"grep"` solo lo bloquearía. Los comandos como `git status` funcionan para el comportamiento predeterminado pero requieren permiso explícito (como `"git status *"`) cuando se pasan argumentos.
:::

View File

@@ -234,7 +234,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
Estamos usando `osascript` para ejecutar AppleScript en macOS. Aquí lo estamos usando para enviar notificaciones.
:::nota
:::note
Si está utilizando la aplicación de escritorio OpenCode, puede enviar notificaciones del sistema automáticamente cuando una respuesta esté lista o cuando se produzca un error en una sesión.
:::

View File

@@ -53,7 +53,7 @@ Puede personalizar la URL base para cualquier proveedor configurando la opción
OpenCode Zen es una lista de modelos proporcionados por el equipo OpenCode que han sido
probado y verificado para funcionar bien con OpenCode. [Más información](/docs/zen).
:::consejo
:::tip
Si eres nuevo, te recomendamos comenzar con OpenCode Zen.
:::
@@ -89,7 +89,7 @@ Funciona como cualquier otro proveedor en OpenCode y su uso es completamente opc
Veamos algunos de los proveedores en detalle. Si desea agregar un proveedor a la
lista, no dude en abrir un PR.
:::nota
:::note
¿No ves un proveedor aquí? Envíe un PR.
:::
@@ -229,7 +229,7 @@ Para usar Amazon Bedrock con OpenCode:
/models
```
:::nota
:::note
Para perfiles de inferencia personalizados, utilice el modelo y el nombre del proveedor en la clave y establezca la propiedad `id` en arn. Esto garantiza un almacenamiento en caché correcto:
```json title="opencode.json"
@@ -278,7 +278,7 @@ Para perfiles de inferencia personalizados, utilice el modelo y el nombre del pr
/models
```
:::información
:::info
El uso de su suscripción Claude Pro/Max en OpenCode no está oficialmente respaldado por [Anthropic](https://anthropic.com).
:::
@@ -292,7 +292,7 @@ O si ya tienes una clave API, puedes seleccionar **Ingresar manualmente la clave
### Azul OpenAI
:::nota
:::note
Si encuentra errores del tipo "Lo siento, pero no puedo ayudar con esa solicitud", intente cambiar el filtro de contenido de **DefaultV2** a **Default** en su recurso de Azure.
:::
@@ -556,7 +556,7 @@ Cloudflare AI Gateway le permite acceder a modelos de OpenAI, Anthropic, Workers
### Infraestructura profunda
1. Dirígete al [panel de Deep Infra] (https://deepinfra.com/dash), crea una cuenta y genera una clave API.
1. Dirígete al [panel de Deep Infra](https://deepinfra.com/dash), crea una cuenta y genera una clave API.
2. Ejecute el comando `/connect` y busque **Deep Infra**.
@@ -677,7 +677,7 @@ GitLab Duo proporciona chat agente basado en IA con capacidades de llamada de he
- **duo-chat-sonnet-4-5** - Rendimiento equilibrado para la mayoría de los flujos de trabajo
- **duo-chat-opus-4-5** - Más capaz para análisis complejos
:::nota
:::note
También puede especificar la variable de entorno 'GITLAB_TOKEN' si no desea
para almacenar el token en el almacenamiento de autenticación opencode.
:::
@@ -721,7 +721,7 @@ export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
export GITLAB_TOKEN=glpat-...
```
:::nota
:::note
Su administrador GitLab debe habilitar lo siguiente:
1. [Plataforma de agente Duo](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) para el usuario, grupo o instancia
@@ -788,7 +788,7 @@ Este complemento proporciona capacidades integrales de administración del repos
Para utilizar su suscripción GitHub Copilot con opencode:
:::nota
:::note
Algunos modelos pueden necesitar un [Pro+
suscripción](https://github.com/features/copilot/plans) para usar.
@@ -853,7 +853,7 @@ Para utilizar Google Vertex AI con OpenCode:
export VERTEX_LOCATION=global
```
:::consejo
:::tip
La región `global` mejora la disponibilidad y reduce los errores sin costo adicional. Utilice puntos finales regionales (por ejemplo, `us-central1`) para los requisitos de residencia de datos. [Más información](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints)
:::
@@ -1222,7 +1222,7 @@ Para usar Kimi K2 de Moonshot AI:
Puedes configurar opencode para usar modelos locales a través de Ollama.
:::consejo
:::tip
Ollama puede configurarse automáticamente para OpenCode. Consulte los [documentos de integración de Ollama](https://docs.ollama.com/integrations/opencode) para obtener más detalles.
:::
@@ -1254,7 +1254,7 @@ En este ejemplo:
- `options.baseURL` es el punto final del servidor local.
- `models` es un mapa de ID de modelo para sus configuraciones. El nombre del modelo se mostrará en la lista de selección de modelos.
:::consejo
:::tip
Si las llamadas a herramientas no funcionan, intente aumentar `num_ctx` en Ollama. Comience alrededor de 16k - 32k.
:::
@@ -1748,7 +1748,7 @@ Algunas opciones de enrutamiento útiles:
Para agregar cualquier proveedor **compatible con OpenAI** que no aparezca en el comando `/connect`:
:::consejo
:::tip
Puede utilizar cualquier proveedor compatible con OpenAI con opencode. La mayoría de los proveedores de IA modernos ofrecen API compatibles con OpenAI.
:::

View File

@@ -11,7 +11,7 @@ Puede proporcionar instrucciones personalizadas a opencode creando un archivo `A
Para crear un nuevo archivo `AGENTS.md`, puede ejecutar el comando `/init` en opencode.
:::consejo
:::tip
Debes enviar el archivo `AGENTS.md` de tu proyecto a Git.
:::
@@ -175,6 +175,6 @@ Este enfoque le permite:
- Mantenga AGENTS.md conciso mientras hace referencia a pautas detalladas
- Asegúrese de que opencode cargue archivos solo cuando sea necesario para la tarea específica
:::consejo
:::tip
Para monorepos o proyectos con estándares compartidos, usar `opencode.json` con patrones globales (como `packages/*/AGENTS.md`) es más fácil de mantener que las instrucciones manuales.
:::

View File

@@ -145,7 +145,7 @@ console.log(health.data.version)
| Método | Descripción | Respuesta |
| -------------- | ------------------------------------ | -------------------------------------------- |
| `app.log()` | Escribe una entrada de registro | `boolean` |
| `app.agents()` | Listar todos los agentes disponibles | <a href={typesUrl}><code>Agente[]</code></a> |
| `app.agents()` | Listar todos los agentes disponibles | <a href={typesUrl}><code>Agent[]</code></a> |
---
@@ -171,8 +171,8 @@ const agents = await client.app.agents()
| Método | Descripción | Respuesta |
| ------------------- | -------------------------- | ---------------------------------------------- |
| `project.list()` | Listar todos los proyectos | <a href={typesUrl}><code>Proyecto[]</code></a> |
| `project.current()` | Obtener proyecto actual | <a href={typesUrl}><code>Proyecto</code></a> |
| `project.list()` | Listar todos los proyectos | <a href={typesUrl}><code>Project[]</code></a> |
| `project.current()` | Obtener proyecto actual | <a href={typesUrl}><code>Project</code></a> |
---
@@ -192,7 +192,7 @@ const currentProject = await client.project.current()
| Método | Descripción | Respuesta |
| ------------ | ------------------- | ---------------------------------------- |
| `path.get()` | Obtener ruta actual | <a href={typesUrl}><code>Ruta</code></a> |
| `path.get()` | Obtener ruta actual | <a href={typesUrl}><code>Path</code></a> |
---
@@ -209,8 +209,8 @@ const pathInfo = await client.path.get()
| Método | Descripción | Respuesta |
| -------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `config.get()` | Obtener información de configuración | <a href={typesUrl}><code>Configuración</code></a> |
| `config.providers()` | Lista de proveedores y modelos predeterminados | `{ providers: `<a href={typesUrl}><code>Proveedor[]</code></a>`, default: { [key: string]: string } }` |
| `config.get()` | Obtener información de configuración | <a href={typesUrl}><code>Config</code></a> |
| `config.providers()` | Lista de proveedores y modelos predeterminados | `{ providers: `<a href={typesUrl}><code>Provider[]</code></a>`, default: { [key: string]: string } }` |
---
@@ -228,24 +228,24 @@ const { providers, default: defaults } = await client.config.providers()
| Método | Descripción | Notas |
| ---------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `session.list()` | Listar sesiones | Devuelve <a href={typesUrl}><code>Sesn[]</code></a> |
| `session.get({ path })` | Obtener sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.children({ path })` | Listar sesiones infantiles | Devuelve <a href={typesUrl}><code>Sesn[]</code></a> |
| `session.create({ body })` | Crear sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.list()` | Listar sesiones | Devuelve <a href={typesUrl}><code>Session[]</code></a> |
| `session.get({ path })` | Obtener sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.children({ path })` | Listar sesiones infantiles | Devuelve <a href={typesUrl}><code>Session[]</code></a> |
| `session.create({ body })` | Crear sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.delete({ path })` | Eliminar sesión | Devuelve `boolean` |
| `session.update({ path, body })` | Actualizar propiedades de sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.update({ path, body })` | Actualizar propiedades de sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.init({ path, body })` | Analizar aplicación y crear `AGENTS.md` | Devuelve `boolean` |
| `session.abort({ path })` | Cancelar una sesión en ejecución | Devuelve `boolean` |
| `session.share({ path })` | Compartir sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.unshare({ path })` | Dejar de compartir sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.share({ path })` | Compartir sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.unshare({ path })` | Dejar de compartir sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.summarize({ path, body })` | Resumir sesión | Devuelve `boolean` |
| `session.messages({ path })` | Listar mensajes en una sesión | Devuelve `{ info: `<a href={typesUrl}><code>Mensaje</code></a>`, parts: `<a href={typesUrl}><code>Parte[]</code></a>`}[]` |
| `session.message({ path })` | Obtener detalles del mensaje | Devuelve `{ info: `<a href={typesUrl}><code>Mensaje</code></a>`, parts: `<a href={typesUrl}><code>Parte[]</code></a>`}` |
| `session.messages({ path })` | Listar mensajes en una sesión | Devuelve `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}[]` |
| `session.message({ path })` | Obtener detalles del mensaje | Devuelve `{ info: `<a href={typesUrl}><code>Message</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.prompt({ path, body })` | Enviar mensaje rápido | `body.noReply: true` devuelve UserMessage (solo contexto). El valor predeterminado devuelve <a href={typesUrl}><code>AssistantMessage</code></a> con respuesta de IA |
| `session.command({ path, body })` | Enviar comando a la sesión | Devuelve `{ info: `<a href={typesUrl}><code>AssistantMessage</code></a>`, parts: `<a href={typesUrl}><code>Parte[]</code></a>`}` |
| `session.command({ path, body })` | Enviar comando a la sesión | Devuelve `{ info: `<a href={typesUrl}><code>AssistantMessage</code></a>`, parts: `<a href={typesUrl}><code>Part[]</code></a>`}` |
| `session.shell({ path, body })` | Ejecute un comando de shell | Devuelve <a href={typesUrl}><code>AssistantMessage</code></a> |
| `session.revert({ path, body })` | Revertir un mensaje | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.unrevert({ path })` | Restaurar mensajes revertidos | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `session.revert({ path, body })` | Revertir un mensaje | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `session.unrevert({ path })` | Restaurar mensajes revertidos | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `postSessionByIdPermissionsByPermissionId({ path, body })` | Responder a una solicitud de permiso | Devuelve `boolean` |
---
@@ -287,9 +287,9 @@ await client.session.prompt({
| ------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `find.text({ query })` | Buscar texto en archivos | Matriz de objetos coincidentes con `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
| `find.files({ query })` | Buscar archivos y directorios por nombre | `string[]` (rutas) |
| `find.symbols({ query })` | Buscar símbolos del espacio de trabajo | <a href={typesUrl}><code>Símbolo[]</code></a> |
| `find.symbols({ query })` | Buscar símbolos del espacio de trabajo | <a href={typesUrl}><code>Symbol[]</code></a> |
| `file.read({ query })` | Leer un archivo | `{ type: "raw" \| "patch", content: string }` |
| `file.status({ query? })` | Obtener el estado de los archivos rastreados | <a href={typesUrl}><code>Archivo[]</code></a> |
| `file.status({ query? })` | Obtener el estado de los archivos rastreados | <a href={typesUrl}><code>File[]</code></a> |
`find.files` admite algunos campos de consulta opcionales:

View File

@@ -50,7 +50,7 @@ Cuando ejecuta `opencode`, inicia un TUI y un servidor. Donde el TUI es el
Cliente que habla con el servidor. El servidor expone una especificación OpenAPI 3.1
punto final. Este punto final también se utiliza para generar un [SDK](/docs/sdk).
:::consejo
:::tip
Utilice el servidor opencode para interactuar con opencode mediante programación.
:::
@@ -100,8 +100,8 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------ | ------------------ | -------------------------- | ---------------------------------------------- |
| `GET` | `/project` | Listar todos los proyectos | <a href={typesUrl}><code>Proyecto[]</code></a> |
| `GET` | `/project/current` | Obtener el proyecto actual | <a href={typesUrl}><code>Proyecto</code></a> |
| `GET` | `/project` | Listar todos los proyectos | <a href={typesUrl}><code>Project[]</code></a> |
| `GET` | `/project/current` | Obtener el proyecto actual | <a href={typesUrl}><code>Project</code></a> |
---
@@ -109,7 +109,7 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------ | ------- | -------------------------------------------------- | ------------------------------------------- |
| `GET` | `/path` | Obtener la ruta actual | <a href={typesUrl}><code>Ruta</code></a> |
| `GET` | `/path` | Obtener la ruta actual | <a href={typesUrl}><code>Path</code></a> |
| `GET` | `/vcs` | Obtenga información de VCS para el proyecto actual | <a href={typesUrl}><code>VcsInfo</code></a> |
---
@@ -126,8 +126,8 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------- | ------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `GET` | `/config` | Obtener información de configuración | <a href={typesUrl}><code>Configuración</code></a> |
| `PATCH` | `/config` | Actualizar configuración | <a href={typesUrl}><code>Configuración</code></a> |
| `GET` | `/config` | Obtener información de configuración | <a href={typesUrl}><code>Config</code></a> |
| `PATCH` | `/config` | Actualizar configuración | <a href={typesUrl}><code>Config</code></a> |
| `GET` | `/config/providers` | Lista de proveedores y modelos predeterminados | `{ providers: `<a href={typesUrl}>Proveedor[]</a>`, default: { [key: string]: string } }` |
---
@@ -147,19 +147,19 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Notas |
| -------- | ---------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| `GET` | `/session` | Listar todas las sesiones | Devuelve <a href={typesUrl}><code>Sesn[]</code></a> |
| `POST` | `/session` | Crear una nueva sesión | cuerpo: `{ parentID?, title? }`, devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `GET` | `/session/status` | Obtener el estado de la sesión para todas las sesiones | Devuelve `{ [sessionID: string]: `<a href={typesUrl}>Estado de sesión</a>` }` |
| `GET` | `/session/:id` | Obtener detalles de la sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `GET` | `/session` | Listar todas las sesiones | Devuelve <a href={typesUrl}><code>Session[]</code></a> |
| `POST` | `/session` | Crear una nueva sesión | cuerpo: `{ parentID?, title? }`, devuelve <a href={typesUrl}><code>Session</code></a> |
| `GET` | `/session/status` | Obtener el estado de la sesión para todas las sesiones | Devuelve `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }` |
| `GET` | `/session/:id` | Obtener detalles de la sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `DELETE` | `/session/:id` | Eliminar una sesión y todos sus datos | Devuelve `boolean` |
| `PATCH` | `/session/:id` | Actualizar propiedades de sesión | cuerpo: `{ title? }`, devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `GET` | `/session/:id/children` | Obtener las sesiones secundarias de una sesión | Devuelve <a href={typesUrl}><code>Sesn[]</code></a> |
| `PATCH` | `/session/:id` | Actualizar propiedades de sesión | cuerpo: `{ title? }`, devuelve <a href={typesUrl}><code>Session</code></a> |
| `GET` | `/session/:id/children` | Obtener las sesiones secundarias de una sesión | Devuelve <a href={typesUrl}><code>Session[]</code></a> |
| `GET` | `/session/:id/todo` | Obtener la lista de tareas pendientes para una sesión | Devuelve <a href={typesUrl}><code>Todo[]</code></a> |
| `POST` | `/session/:id/init` | Analizar aplicación y crear `AGENTS.md` | cuerpo: `{ messageID, providerID, modelID }`, devuelve `boolean` |
| `POST` | `/session/:id/fork` | Bifurca una sesión existente en un mensaje | cuerpo: `{ messageID? }`, devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `POST` | `/session/:id/fork` | Bifurca una sesión existente en un mensaje | cuerpo: `{ messageID? }`, devuelve <a href={typesUrl}><code>Session</code></a> |
| `POST` | `/session/:id/abort` | Cancelar una sesión en ejecución | Devuelve `boolean` |
| `POST` | `/session/:id/share` | Compartir una sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `DELETE` | `/session/:id/share` | Dejar de compartir una sesión | Devuelve <a href={typesUrl}><code>Sesn</code></a> |
| `POST` | `/session/:id/share` | Compartir una sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `DELETE` | `/session/:id/share` | Dejar de compartir una sesión | Devuelve <a href={typesUrl}><code>Session</code></a> |
| `GET` | `/session/:id/diff` | Obtenga la diferencia para esta sesión | consulta: `messageID?`, devuelve <a href={typesUrl}><code>FileDiff[]</code></a> |
| `POST` | `/session/:id/summarize` | Resumir la sesión | cuerpo: `{ providerID, modelID }`, devuelve `boolean` |
| `POST` | `/session/:id/revert` | Revertir un mensaje | cuerpo: `{ messageID, partID? }`, devuelve `boolean` |
@@ -185,7 +185,7 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------ | ---------- | ------------------------- | --------------------------------------------- |
| `GET` | `/command` | Listar todos los comandos | <a href={typesUrl}><code>Comando[]</code></a> |
| `GET` | `/command` | Listar todos los comandos | <a href={typesUrl}><code>Command[]</code></a> |
---
@@ -195,10 +195,10 @@ El servidor opencode expone las siguientes API.
| ------ | ------------------------ | -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `GET` | `/find?pattern=<pat>` | Buscar texto en archivos | Matriz de objetos coincidentes con `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
| `GET` | `/find/file?query=<q>` | Buscar archivos y directorios por nombre | `string[]` (caminos) |
| `GET` | `/find/symbol?query=<q>` | Buscar símbolos del espacio de trabajo | <a href={typesUrl}><code>Símbolo[]</code></a> |
| `GET` | `/find/symbol?query=<q>` | Buscar símbolos del espacio de trabajo | <a href={typesUrl}><code>Symbol[]</code></a> |
| `GET` | `/file?path=<path>` | Listar archivos y directorios | <a href={typesUrl}><code>FileNode[]</code></a> |
| `GET` | `/file/content?path=<p>` | Leer un archivo | <a href={typesUrl}><code>Contenido del archivo</code></a> |
| `GET` | `/file/status` | Obtener el estado de los archivos rastreados | <a href={typesUrl}><code>Archivo[]</code></a> |
| `GET` | `/file/content?path=<p>` | Leer un archivo | <a href={typesUrl}><code>FileContent</code></a> |
| `GET` | `/file/status` | Obtener el estado de los archivos rastreados | <a href={typesUrl}><code>File[]</code></a> |
#### `/find/file` parámetros de consulta
@@ -214,8 +214,8 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------ | ------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------- |
| `GET` | `/experimental/tool/ids` | Listar todos los ID de herramientas | <a href={typesUrl}><code>ID de herramientas</code></a> |
| `GET` | `/experimental/tool?provider=<p>&model=<m>` | Listar herramientas con esquemas JSON para un modelo | <a href={typesUrl}><code>Lista de herramientas</code></a> |
| `GET` | `/experimental/tool/ids` | Listar todos los ID de herramientas | <a href={typesUrl}><code>ToolIDs</code></a> |
| `GET` | `/experimental/tool?provider=<p>&model=<m>` | Listar herramientas con esquemas JSON para un modelo | <a href={typesUrl}><code>ToolList</code></a> |
---
@@ -234,7 +234,7 @@ El servidor opencode expone las siguientes API.
| Método | Camino | Descripción | Respuesta |
| ------ | -------- | ------------------------------------ | -------------------------------------------- |
| `GET` | `/agent` | Listar todos los agentes disponibles | <a href={typesUrl}><code>Agente[]</code></a> |
| `GET` | `/agent` | Listar todos los agentes disponibles | <a href={typesUrl}><code>Agent[]</code></a> |
---

View File

@@ -5,7 +5,7 @@ description: Comparte tus conversaciones OpenCode.
La función para compartir de OpenCode te permite crear enlaces públicos a tus conversaciones de OpenCode, para que puedas colaborar con compañeros de equipo u obtener ayuda de otros.
:::nota
:::note
Las conversaciones compartidas son de acceso público para cualquier persona que tenga el enlace.
:::

View File

@@ -94,7 +94,7 @@ Cree nuevos archivos o sobrescriba los existentes.
Utilice esto para permitir que LLM cree nuevos archivos. Sobrescribirá los archivos existentes si ya existen.
:::nota
:::note
La herramienta `write` está controlada por el permiso `edit`, que cubre todas las modificaciones de archivos (`edit`, `write`, `patch`, `multiedit`).
:::
@@ -172,7 +172,7 @@ Esta herramienta enumera el contenido del directorio. Acepta patrones globales p
Interactúe con sus servidores LSP configurados para obtener funciones de inteligencia de código como definiciones, referencias, información de desplazamiento y jerarquía de llamadas.
:::nota
:::note
Esta herramienta solo está disponible cuando `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (o `OPENCODE_EXPERIMENTAL=true`).
:::
@@ -206,7 +206,7 @@ Aplicar parches a los archivos.
Esta herramienta aplica archivos de parche a su código base. Útil para aplicar diferencias y parches de diversas fuentes.
:::nota
:::note
La herramienta `patch` está controlada por el permiso `edit`, que cubre todas las modificaciones de archivos (`edit`, `write`, `patch`, `multiedit`).
:::
@@ -242,7 +242,7 @@ Administre listas de tareas pendientes durante las sesiones de codificación.
Crea y actualiza listas de tareas para realizar un seguimiento del progreso durante operaciones complejas. El LLM usa esto para organizar tareas de varios pasos.
:::nota
:::note
Esta herramienta está deshabilitada para los subagentes de forma predeterminada, pero puede habilitarla manualmente. [Más información](/docs/agents/#permissions)
:::
@@ -263,7 +263,7 @@ Leer listas de tareas pendientes existentes.
Lee el estado actual de la lista de tareas pendientes. Utilizado por LLM para rastrear qué tareas están pendientes o completadas.
:::nota
:::note
Esta herramienta está deshabilitada para los subagentes de forma predeterminada, pero puede habilitarla manualmente. [Más información](/docs/agents/#permissions)
:::
@@ -290,7 +290,7 @@ Permite que LLM busque y lea páginas web. Útil para buscar documentación o in
Busque información en la web.
:::nota
:::note
Esta herramienta solo está disponible cuando se utiliza el proveedor OpenCode o cuando la variable de entorno `OPENCODE_ENABLE_EXA` está configurada en cualquier valor verdadero (por ejemplo, `true` o `1`).
Para habilitar al iniciar OpenCode:
@@ -314,7 +314,7 @@ Realiza búsquedas web utilizando Exa AI para encontrar información relevante e
No se requiere ninguna clave API: la herramienta se conecta directamente al servicio MCP alojado de Exa AI sin autenticación.
:::consejo
:::tip
Utilice `websearch` cuando necesite encontrar información (descubrimiento) y `webfetch` cuando necesite recuperar contenido de una URL específica (recuperación).
:::

View File

@@ -31,7 +31,7 @@ Give me a quick summary of the codebase.
Puede hacer referencia a archivos en sus mensajes usando `@`. Esto realiza una búsqueda difusa de archivos en el directorio de trabajo actual.
:::consejo
:::tip
También puede utilizar `@` para hacer referencia a archivos en sus mensajes.
:::
@@ -191,7 +191,7 @@ Iniciar una nueva sesión. _Alias_: `/clear`
Rehacer un mensaje previamente deshecho. Solo disponible después de usar `/undo`.
:::consejo
:::tip
También se restaurarán todos los cambios en el archivo.
:::
@@ -246,7 +246,7 @@ Listar temas disponibles.
Alterna la visibilidad de los bloques de pensamiento/razonamiento en la conversación. Cuando está habilitado, puede ver el proceso de razonamiento del modelo para los modelos que admiten el pensamiento extendido.
:::nota
:::note
Este comando solo controla si se **muestran** los bloques de pensamiento; no habilita ni deshabilita las capacidades de razonamiento del modelo. Para alternar las capacidades de razonamiento reales, use `ctrl+t` para recorrer las variantes del modelo.
:::
@@ -260,7 +260,7 @@ Este comando solo controla si se **muestran** los bloques de pensamiento; no hab
Deshacer el último mensaje de la conversación. Elimina el mensaje de usuario más reciente, todas las respuestas posteriores y cualquier cambio de archivo.
:::consejo
:::tip
Cualquier cambio de archivo realizado también se revertirá.
:::
@@ -345,7 +345,7 @@ Las opciones de editor populares incluyen:
- `notepad` - Windows Bloc de notas
- `subl` - Texto sublime
:::nota
:::note
Algunos editores como VS Code deben iniciarse con el indicador `--wait`.
:::

View File

@@ -17,7 +17,7 @@ opencode web
Esto inicia un servidor local en `127.0.0.1` con un puerto disponible aleatorio y abre automáticamente OpenCode en su navegador predeterminado.
:::precaución
:::caution
Si no se establece `OPENCODE_SERVER_PASSWORD`, el servidor no será seguro. Esto está bien para uso local, pero debe configurarse para acceso a la red.
:::

View File

@@ -9,7 +9,7 @@ export const email = `mailto:${config.email}`
OpenCode Zen es una lista de modelos probados y verificados proporcionada por el equipo OpenCode.
:::nota
:::note
OpenCode Zen se encuentra actualmente en versión beta.
:::
@@ -25,7 +25,7 @@ Hay una gran cantidad de modelos, pero solo unos pocos.
Estos modelos funcionan bien como agentes codificadores. Además, la mayoría de los proveedores son
configurado de manera muy diferente; por lo que obtienes un rendimiento y una calidad muy diferentes.
:::consejo
:::tip
Probamos un grupo selecto de modelos y proveedores que funcionan bien con OpenCode.
:::
@@ -152,7 +152,7 @@ Apoyamos un modelo de pago por uso. A continuación se muestran los precios **po
Es posible que notes _Claude Haiku 3.5_ en tu historial de uso. Este es un [modelo de bajo costo](/docs/config/#models) que se utiliza para generar los títulos de tus sesiones.
:::nota
:::note
Las tarifas de las tarjetas de crédito se trasladan al costo (4,4% + 0,30 dólares por transacción); No cobramos nada más allá de eso.
:::
@@ -204,7 +204,7 @@ Todos nuestros modelos están alojados en los EE. UU. Nuestros proveedores sigue
Zen también funciona muy bien para equipos. Puedes invitar a compañeros de equipo, asignar roles, seleccionar
los modelos que utiliza su equipo y más.
:::nota
:::note
Actualmente, los espacios de trabajo son gratuitos para los equipos como parte de la versión beta.
:::