Guía del complemento de Obsidian (Beta)

Al igual que la extensión de VS Code, nuestro complemento de Obsidian ofrece OCR consciente del contexto, lo que permite un rendimiento más preciso con una integración perfecta entre la aplicación WriteTex y Obsidian.

ADVERTENCIA: EL COMPLEMENTO ESTÁ BAJO DESARROLLO INTENSO Y NO OFRECE NINGUNA GARANTÍA. ÚSELO BAJO SU PROPIO RIESGO. CONSULTE LA LICENCIA. Actualmente, debe tener una configuración de API funcional de un proveedor externo (por ejemplo, OpenAI) para usar el complemento.

Características

• Compañero para la aplicación WriteTex: Conecta sin problemas la aplicación móvil WriteTex con su editor de Obsidian de escritorio.
• Conciencia del contexto: Envía automáticamente el texto que rodea su cursor a la IA, mejorando la precisión al comprender el estilo y las variables de su documento actual.
• Inserción directa: El código generado se inserta inmediatamente en su cursor.

Instalación

1. Descargue la última versión de nuestro repositorio de GitHub.
2. Coloque main.js y manifest.json en el directorio de complementos de su bóveda (vault): <VAULT>/.obsidian/plugins/writetex-obsidian/.
3. Abra la configuración de Obsidian -> Complementos de la comunidad (Community Plugins) y habilite WriteTex.

No necesita instalar la versión de escritorio de WriteTex para usar el complemento de Obsidian. Solo se requiere la aplicación móvil en su iPad/tableta.

Configuración

Esta parte es similar a la configuración de otras plataformas. A continuación se muestra un ejemplo sencillo:

Ajuste	Valor
Punto de conexión de la API	https://api.openai.com/v1
Modelo	gpt-5
Clave de API	sk-...

Instrucciones personalizadas (Custom Instructions)
Algunos avisos adicionales para guiar al modelo de IA. Por ejemplo, puede agregar "Use \mathbb{i} para la unidad imaginaria".

Uso

1. Iniciar el servidor:

   • El servidor se inicia automáticamente cuando se carga Obsidian.
   • Verifique la barra de estado en la parte inferior derecha: debería decir "WriteTex: On".
   • Si dice "Off", abra la paleta de comandos (Cmd/Ctrl + P) y ejecute "WriteTex: Start Server".

2. Conectar cliente (por ejemplo, aplicación iOS):

   • Abra la aplicación WriteTex en su teléfono.
   • Asegúrese de que su teléfono y su computadora estén en la misma red Wi-Fi.
   • La aplicación debería descubrir automáticamente "WriteTex Obsidian @ [SuNombreDeHost]".
   • Si el descubrimiento automático falla, ingrese manualmente la dirección IP de su computadora.

Para otras plataformas (Windows, Android, MacOS), siga la guía en VS Code.

3. Insertar fórmula manuscrita con WriteTex:
   • Coloque el cursor en una nota de Obsidian donde desee que aparezca el código.
   • Use la aplicación móvil para escribir una fórmula matemática.
   • El complemento recibirá la imagen, la analizará con el contexto de su nota actual e insertará el resultado LaTeX/Markdown directamente en su editor.

Solución de problemas

• El servidor no se inicia: Verifique si el puerto 50905 está siendo utilizado por otra aplicación. Si ha habilitado el servidor WriteTex en la extensión de VS Code, desactívelo antes de iniciar Obsidian.
• La aplicación móvil no puede conectarse:
  • Asegúrese de que ambos dispositivos estén en el mismo Wi-Fi.
  • Verifique la configuración del firewall de su computadora para permitir conexiones entrantes en el puerto 50905.
  • Algunas redes escolares o corporativas pueden bloquear las conexiones entre dispositivos. En este caso, puede intentar usar una VPN o un punto de acceso.
• Error "Unauthorized": Asegúrese de que la aplicación cliente envíe la clave de API writetex.