docs: portable update warning — CUDA 13.0 / cu130 + cu126 legacy (EN + i18n)

es/installation/update_comfyui.mdx

@@ -1,13 +1,13 @@
 ---
 title: "Cómo actualizar ComfyUI"
 description: "Actualiza ComfyUI en cualquier instalación: scripts de Portable, Desktop y git pull, además de soluciones a problemas habituales."
 icon: "circle-up"
 sidebarTitle: "Actualizar ComfyUI"
-translationSourceHash: 73922310
+translationSourceHash: 1d95d67d
 translationFrom: installation/update_comfyui.mdx
 translationBlockHashes:
   "_intro": ea3fba01
-  "How to Update ComfyUI?": 7328cb96
+  "How to Update ComfyUI?": 7302fc02
   "ComfyUI Version Types": 0f19bbda
   "What Needs to Be Updated When Updating ComfyUI?": b2d99699
   "Common Update Issues": ff82d6b7
@@ -16,16 +16,16 @@
 import InstallLink from "/snippets/es/install/install-link.mdx"
 import UpdateRequirement from "/snippets/es/install/update-requirement.mdx"
 
 Aunque las actualizaciones de ComfyUI ya aparecen en varias guías de instalación, aquí reunimos todos los procedimientos en un solo sitio para que quede claro cómo actualizar.
 
 ## ¿Cómo actualizar ComfyUI?
 
 <Tabs>
 <Tab title="Portable">
  ComfyUI Portable incluye scripts `.bat` prácticos para actualizar con facilidad.
 
  ### Ubicación de los scripts de actualización
  En la carpeta `update` de tu instalación Portable encontrarás estos scripts:
 
  ```
  ComfyUI_windows_portable
@@ -40,47 +40,51 @@
 <Warning>
 **⚠️ PELIGRO: ¡Usa `update_comfyui_and_python_dependencies.bat` con muchísima precaución!**
 
 Este script es más exhaustivo que las actualizaciones normales y hará lo siguiente:
 - ✅ Actualizar el propio código de ComfyUI
-- ✅ Actualizar PyTorch (para NVIDIA GPU CUDA 12.9)
+- ✅ Actualizar PyTorch para el **portable estándar de Nvidia** (actualmente **CUDA 13.0 / cu130**, Python 3.13)
 - ✅ Reinstalar TODAS las dependencias de Python
 
+**Portable legado de Nvidia (CUDA 12.6 / cu126):** Si instalaste el paquete portable aparte para GPUs Nvidia de la **serie 10 y anteriores**, esa compilación usa **CUDA 12.6** y Python 3.12. No tomes cu130 como el destino correcto para ese paquete: reinstala o actualiza PyTorch con el índice de wheels cu126 que corresponda a ese portable, o vuelve a descargar el paquete cu126 desde la [guía de instalación Portable](/es/installation/comfyui_portable_windows).
+
 **Riesgos:**
 - Puede causar conflictos de dependencias con tu configuración actual
 - Puede romper nodos personalizados que dependen de versiones específicas de paquetes
 - Puede sobrescribir paquetes configurados manualmente
+- En un portable cu126 (u otro que no sea cu130), forzar un wheel cu130 puede romper el arranque de la GPU
 
 **⚠️ Usa este script solo cuando:**
 - Necesites solucionar problemas de dependencias
 - Vayas a realizar actualizaciones de versión mayor
 - Para actualizaciones diarias, usa `update_comfyui.bat` en su lugar
 
 **Antes de ejecutar este script:**
 1. **Haz una copia de seguridad de toda tu instalación de ComfyUI**
 2. Documenta las versiones de paquetes personalizados que hayas instalado
-3. Prepárate para reinstalar los nodos personalizados si es necesario
+3. Confirma qué paquete portable tienes (cu130 estándar vs cu126 legado) — consulta [ComfyUI Portable para Windows](/es/installation/comfyui_portable_windows)
+4. Prepárate para reinstalar los nodos personalizados si es necesario
 </Warning>
 </Tab>
 <Tab title="Desktop">
 Para actualizar ComfyUI, abre el [panel Administrar](/es/installation/desktop/usage/manage#pestaña-actualizar) y usa la pestaña Actualizar. Puedes elegir entre los canales de actualización **Stable** (predeterminado) y **Latest on GitHub**.
 
 La aplicación de escritorio se actualiza automáticamente y es independiente de las actualizaciones de la instancia de ComfyUI.
 </Tab>
 <Tab title="Instalación manual">
 ComfyUI instalado manualmente requiere comandos de Git para completar las actualizaciones.
 
 ### Requisitos previos a la actualización
 Asegúrate de que tu sistema tenga [Git](https://git-scm.com/downloads) instalado y de que ComfyUI se haya instalado mediante Git clone.
 
 ### Pasos de actualización
 <Steps>
 <Step title="Activar el entorno virtual">
 Primero, activa el entorno virtual de Python de ComfyUI (si estás usando uno):
 ```bash
 # Para entorno conda
 conda activate comfyui
 
 # Para entorno venv
 # Windows
 venv\Scripts\activate
 # macOS/Linux  
@@ -94,25 +98,25 @@
 git pull
 ```
 </Step>
 <Step title="Actualizar las dependencias">
 Instala o actualiza los paquetes de dependencias de ComfyUI:
 ```bash
 pip install -r requirements.txt
 ```
 <Warning>
 Asegúrate de estar en el entorno virtual de ComfyUI para evitar contaminar el entorno de Python a nivel del sistema
 </Warning>
 </Step>
 <Step title="Reiniciar ComfyUI">
 Después de actualizar, reinicia ComfyUI:
 ```bash
 python main.py
 ```
 </Step>
 </Steps>
 
 ### Cambiar de versión (opcional)
 Para cambiar a una versión específica, usa estos comandos:
 ```bash
 # Ver el historial de commits
 git log --oneline
@@ -127,20 +131,20 @@
 </Tab>
 </Tabs>
 
 ## Tipos de versión de ComfyUI
 
 Según tu método de instalación, ComfyUI ofrece varias versiones de instalación. Los enlaces a continuación contienen las instrucciones de actualización para cada versión.
 
 <InstallLink/>
 
 ## ¿Qué se debe actualizar al actualizar ComfyUI?
 
 Las actualizaciones de ComfyUI consisten principalmente en dos componentes:
 1. Actualizar el código principal de ComfyUI
 2. Actualizar las dependencias principales de ComfyUI, incluidas las dependencias necesarias de Python y los paquetes de dependencias funcionales de ComfyUI
 
 **Código principal**: Nuevos nodos, soporte para nuevos modelos, nuevas funciones, etc.
 **Dependencias principales**: Incluye principalmente la funcionalidad del frontend de ComfyUI, las plantillas de flujo de trabajo, la documentación de ayuda de nodos, etc.
 
 ```
 comfyui-frontend-package   # Funcionalidad del frontend de ComfyUI
@@ -150,37 +154,37 @@
 comfy-aimdo                # Utilidades principales de ComfyUI
 ```
 
 Estas dependencias principales se mantienen en repositorios separados:
 - [ComfyUI_frontend](https://github.com/Comfy-Org/ComfyUI_frontend/) - Interfaz del frontend y funciones interactivas
 - [workflow_templates](https://github.com/Comfy-Org/workflow_templates) - Plantillas de flujo de trabajo prediseñadas
 - [comfyui-embedded-docs](https://github.com/Comfy-Org/embedded-docs) - Documentación de ayuda de nodos
 - [comfy-kitchen](https://github.com/Comfy-Org/comfy-kitchen) - Biblioteca de kernels rápida para inferencia de Diffusion con múltiples backends de cómputo
 - [comfy-aimdo](https://github.com/Comfy-Org/comfy-aimdo) - Asignador de descarga bajo demanda de modelos de IA
 
 Es importante entender la diferencia entre las versiones de desarrollo (nightly) y las estables (release):
 - **Versión de desarrollo (nightly)**: Código del último commit, que te da acceso a las funciones más recientes, pero puede contener posibles problemas
 - **Versión estable (release)**: Basada en lanzamientos estables, normalmente va por detrás de las versiones de desarrollo, pero ofrece mayor estabilidad. Damos soporte a las versiones estables después de que las funciones se prueban y estabilizan
 
 Muchos usuarios suelen encontrarse en versiones estables (release) o en el canal **Stable** predeterminado de Desktop durante las actualizaciones, pero descubren que las funciones que necesitan solo están disponibles en las compilaciones de desarrollo o nightly. En **Desktop**, cambia a **Latest on GitHub** en [Administrar → Actualizar](/es/installation/desktop/usage/manage#pestaña-actualizar). Para instalaciones portables o manuales, verifica si tu archivo local `ComfyUI/requirements.txt` coincide con las [dependencias de la versión nightly](https://github.com/Comfy-Org/ComfyUI/blob/master/requirements.txt) para determinar si todas las dependencias admiten las funciones más recientes.
 
 ## Problemas comunes al actualizar
 
 ### Interfaz, plantillas de flujos de trabajo y nodos faltantes o desactualizados después de actualizar
 
 
 <Tabs>
   <Tab title="Dependencias no actualizadas correctamente">
     Muchos usuarios solo usan el comando `git pull` para actualizar el código de ComfyUI, pero **descuidan la actualización de las dependencias principales**, lo que provoca los siguientes problemas:
 
   - Funcionalidad del frontend faltante o anómala
   - No se encuentran las plantillas de flujos de trabajo recién añadidas
   - Documentación de ayuda de nodos desactualizada o faltante
   - Las nuevas funciones carecen del soporte correspondiente en el frontend
 
   Después de usar el comando `git pull`, usa el entorno de ComfyUI correspondiente para ejecutar `pip install -r requirements.txt` y actualizar las dependencias.
   </Tab>
   <Tab title="Fallos en la actualización de dependencias">
     Si las actualizaciones de dependencias fallan, normalmente se debe a problemas de red o de permisos del equipo. Cuando ocurren fallos en las dependencias principales durante las actualizaciones, el sistema recurre a versiones anteriores. Por lo general verás registros como este al iniciar:
     ```
     Falling back to the default frontend.
     ComfyUI frontend version: xxx
@@ -188,29 +192,29 @@
 
     Sigue estos pasos para solucionar problemas:
     1. Usa `pip list` en el entorno adecuado para ver los paquetes de dependencias instalados actualmente. Si encuentras inconsistencias de versión, usa `pip install -r requirements.txt` en el entorno de ComfyUI para intentar actualizar las dependencias de nuevo.
     2. Si los problemas persisten después de actualizar, revisa tu conexión de red. Los usuarios de China continental pueden necesitar configurar un proxy para acceder de forma confiable a los repositorios de GitHub.
     3. Si los problemas continúan, revisa los permisos del equipo. Si se requieren privilegios de administrador, ejecuta la línea de comandos con permisos de administrador.
   </Tab>
 </Tabs>
 
 ### Cómo actualizar correctamente las dependencias principales
 
 <UpdateRequirement/>
 
 ### Solución de problemas de actualización de dependencias principales
 
 Si las actualizaciones de las dependencias principales fallan, sigue estos pasos para solucionar problemas:
 
 <Steps>
   <Step title="Revisa la conexión de red">
     Si te encuentras en China continental, asegúrate de poder acceder a PyPI o configura un espejo nacional:
     ```bash
     # Usando el espejo de la Universidad de Tsinghua
     pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
     ```
   </Step>
   <Step title="Instala los paquetes principales individualmente">
     Si la instalación por lotes falla, intenta instalar los paquetes individualmente. **Primero revisa los requisitos de versión en `ComfyUI/requirements.txt`**:
 
     **Luego instala según las versiones especificadas (usa los números de versión de tu requirements.txt):**
     ```bash
@@ -226,38 +230,38 @@
   </Step>
 </Steps>
 
 ### ¿Por qué no encuentro las funciones nuevas después de actualizar?
 
 Este es uno de los problemas más comunes:
 - Si usas **Desktop** en el canal de actualización **Stable**, las funciones pueden ir por detrás de los commits más recientes de GitHub. Cambia el canal a **Latest on GitHub** en la pestaña [Administrar → Actualizar](/es/installation/desktop/usage/manage#pestaña-actualizar) cuando necesites funciones más recientes (Latest puede ser menos estable).
 - Para instalaciones Portable o manuales, asegúrate de estar en la **versión de desarrollo (nightly)** y no en la **versión estable (release)** cuando necesites los commits más recientes.
 
 Además, asegúrate de que las dependencias correspondientes se hayan actualizado correctamente durante el proceso de actualización. Si los problemas persisten después de actualizar, consulta la sección [Solución de problemas de actualización de dependencias](#solución-de-problemas-de-actualización-de-dependencias-principales) para diagnosticar el problema.
 
 ### ¿Cómo cambiar entre las versiones de desarrollo (Nightly) y estable (Release)?
 
 Diferencias entre versiones:
 
 <Tabs>
   <Tab title="Versión de desarrollo (Nightly)">
     - **Características**: Contiene el código del commit más reciente
     - **Ventajas**: Prueba primero las funciones y mejoras más recientes
     - **Riesgos**: Puede contener errores no descubiertos o factores de inestabilidad
     - **Adecuada para**: Desarrolladores, testers y usuarios que quieren probar las funciones más recientes
   </Tab>
   <Tab title="Versión estable (Release)">
     - **Características**: Código estable probado y verificado
     - **Ventajas**: Alta estabilidad, adecuada para entornos de producción
     - **Desventajas**: Las actualizaciones de funciones tienen retrasos, pueden ir por detrás de las versiones de desarrollo por semanas o meses
     - **Adecuada para**: Usuarios que requieren estabilidad, usuarios de entornos de producción
   </Tab>
 </Tabs>
 
 <Tabs>
   <Tab title="Portable">
     Usa `update_comfyui.bat` en lugar de `update_comfyui_stable.bat`:
     ```
     # Versión de desarrollo (funciones más recientes)
     double-click: update_comfyui.bat
 
     # Versión estable
@@ -266,7 +270,7 @@
   </Tab>
   <Tab title="Instalación manual">
     ```bash
     # Cambiar a la versión de desarrollo
     git checkout master
     git pull
 
@@ -276,28 +280,28 @@
     ```
   </Tab>
   <Tab title="Desktop">
     Abre el [panel Administrar](/es/installation/desktop/usage/manage#pestaña-actualizar) y usa la pestaña Actualizar para cambiar de canal:
     - **Stable** (predeterminado): versiones probadas, pueden ir por detrás de los commits más recientes de GitHub
     - **Latest on GitHub**: sigue los commits más recientes de GitHub; puede ser menos estable
 
     Usa **Switch Channel**, **Update Now** o **Copy & Update** según si el canal seleccionado tiene una compilación más reciente. Encontrarás los detalles en la página [pestaña Actualizar del panel Administrar](/es/installation/desktop/usage/manage#pestaña-actualizar).
   </Tab>
 </Tabs>
 
 ### ¿Qué hacer cuando aparecen errores después de actualizar?
 
 1. **Revisa las dependencias**: Ejecuta `pip install -r requirements.txt` para asegurarte de que todas las dependencias estén actualizadas
 2. **Revisa los nodos personalizados**: Algunos nodos personalizados pueden ser incompatibles con las versiones nuevas
 3. **Revierte la versión**: Si los problemas son graves, puedes volver a una versión estable anterior
 
 Si se presentan problemas, consulta nuestra página de solución de problemas para encontrar soluciones.
 
 <Card title="Solución de problemas" icon="bug" href="/es/troubleshooting/overview">
   Aprende a solucionar problemas de ComfyUI
 </Card>
 
 ### ¿Cómo te mantienes al día con las funciones nuevas?
 
 - **GitHub Releases**: Consulta [ComfyUI Releases](https://github.com/Comfy-Org/ComfyUI/releases) para ver las actualizaciones de la versión estable
 - **GitHub Commits**: Revisa los [commits más recientes](https://github.com/Comfy-Org/ComfyUI/commits/master) para conocer el avance del desarrollo
 - **Discusión en la comunidad**: Sigue nuestro [blog](https://blog.comfy.org) y [Twitter](https://x.com/comfyui) para ver las novedades más recientes

installation/update_comfyui.mdx

@@ -34,13 +34,16 @@
 
 This script is more thorough than regular updates and will:
 - ✅ Update ComfyUI code itself
-- ✅ Update PyTorch (for NVIDIA GPU CUDA 12.9)
+- ✅ Update PyTorch for the **standard Nvidia portable** (currently **CUDA 13.0 / cu130**, Python 3.13)
 - ✅ Reinstall ALL Python dependencies
 
+**Legacy Nvidia portable (CUDA 12.6 / cu126):** If you installed the separate portable package for Nvidia **10-series and older GPUs**, that build uses **CUDA 12.6** and Python 3.12. Do not treat cu130 as the right target for that package — reinstall or update PyTorch with the cu126 wheel index that matches that portable, or re-download the cu126 package from the [Portable install guide](/installation/comfyui_portable_windows).
+
 **Risks:**
 - May cause dependency conflicts with your existing setup
 - Can break custom nodes that rely on specific package versions
 - May overwrite manually configured packages
+- On a cu126 (or other non-cu130) portable, blindly forcing a cu130 wheel can break GPU startup
 
 **⚠️ Only use this script when:**
 - You need to fix dependency issues
@@ -50,7 +53,8 @@
 **Before running this script:**
 1. **Back up your entire ComfyUI installation**
 2. Document any custom package versions you've installed
-3. Be prepared to reinstall custom nodes if needed
+3. Confirm which portable package you have (cu130 standard vs cu126 legacy) — see [ComfyUI Portable for Windows](/installation/comfyui_portable_windows)
+4. Be prepared to reinstall custom nodes if needed
 </Warning>
 </Tab>
 <Tab title="Desktop">
@@ -69,10 +73,10 @@
 <Step title="Activate Virtual Environment">
 First, activate ComfyUI's Python virtual environment (if using one):
 ```bash
 # For conda environment
 conda activate comfyui
 
 # For venv environment
 # Windows
 venv\Scripts\activate
 # macOS/Linux  
@@ -198,7 +202,7 @@
   <Step title="Check Network Connection">
     If located in mainland China, ensure you can access PyPI or configure a domestic mirror:
     ```bash
     # Using Tsinghua University mirror
     pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
     ```
   </Step>

ja/installation/update_comfyui.mdx

@@ -3,11 +3,11 @@
 description: "あらゆるインストール形式で ComfyUI を更新：ポータブル版の更新スクリプト、Desktop の更新、手動インストールの git pull、よくある更新問題の修正。"
 icon: "circle-up"
 sidebarTitle: "ComfyUI を更新"
-translationSourceHash: 73922310
+translationSourceHash: 1d95d67d
 translationFrom: installation/update_comfyui.mdx
 translationBlockHashes:
   "_intro": ea3fba01
-  "How to Update ComfyUI?": 7328cb96
+  "How to Update ComfyUI?": 7302fc02
   "ComfyUI Version Types": 0f19bbda
   "What Needs to Be Updated When Updating ComfyUI?": b2d99699
   "Common Update Issues": ff82d6b7
@@ -42,13 +42,16 @@
 
 このスクリプトは通常の更新よりも包括的で、以下を実行します：
 - ✅ ComfyUI コード自体を更新
-- ✅ PyTorch を更新（NVIDIA GPU CUDA 12.9 用）
+- ✅ **標準の Nvidia ポータブル版**向けに PyTorch を更新（現在は **CUDA 13.0 / cu130**、Python 3.13）
 - ✅ すべての Python 依存関係を再インストール
 
+**レガシー Nvidia ポータブル版（CUDA 12.6 / cu126）：** Nvidia **10 シリーズ以前の GPU** 向けの別パッケージを入れている場合、そのビルドは **CUDA 12.6** と Python 3.12 を使います。cu130 をそのパッケージの正しいターゲットと見なさないでください。そのポータブル版に合う cu126 の wheel インデックスで PyTorch を再インストール／更新するか、[Portable インストールガイド](/ja/installation/comfyui_portable_windows) から cu126 パッケージを再ダウンロードしてください。
+
 **リスク：**
 - 既存の設定と依存関係の競合を引き起こす可能性
 - 特定のパッケージバージョンに依存するカスタムノードを破損する可能性
 - 手動で設定したパッケージを上書きする可能性
+- cu126（またはその他の非 cu130）ポータブル上でむやみに cu130 wheel を入れると、GPU 起動が壊れる可能性
 
 **⚠️ このスクリプトを使用するのは以下の場合のみ：**
 - 依存関係の問題を修正する必要がある場合
@@ -58,7 +61,8 @@
 **このスクリプトを実行する前に：**
 1. **ComfyUI インストール全体をバックアップ**
 2. インストールしたカスタムパッケージのバージョンを文書化
-3. 必要に応じてカスタムノードを再インストールする準備をする
+3. 使用中のポータブル版を確認（cu130 標準 vs cu126 レガシー）— [Windows 向け ComfyUI Portable](/ja/installation/comfyui_portable_windows) を参照
+4. 必要に応じてカスタムノードを再インストールする準備をする
 </Warning>
 </Tab>
 <Tab title="デスクトップ">
@@ -77,8 +81,8 @@
 <Step title="仮想環境をアクティブ化">
 まず、ComfyUI の Python 仮想環境をアクティブ化します（使用している場合）：
 ```bash
 # conda 環境の場合
 conda activate comfyui
 
 # venv 環境の場合
 # Windows の場合

ko/installation/update_comfyui.mdx

@@ -3,11 +3,11 @@
 description: "모든 설치 유형에서 ComfyUI 업데이트: 휴대용 버전 업데이트 스크립트, Desktop 업데이트, 수동 설치의 git pull, 일반적인 업데이트 문제 해결."
 icon: "circle-up"
 sidebarTitle: "ComfyUI 업데이트"
-translationSourceHash: 73922310
+translationSourceHash: 1d95d67d
 translationFrom: installation/update_comfyui.mdx
 translationBlockHashes:
   "_intro": ea3fba01
-  "How to Update ComfyUI?": 7328cb96
+  "How to Update ComfyUI?": 7302fc02
   "ComfyUI Version Types": 0f19bbda
   "What Needs to Be Updated When Updating ComfyUI?": b2d99699
   "Common Update Issues": ff82d6b7
@@ -43,13 +43,16 @@
 
 이 스크립트는 일반 업데이트보다 더 철저하며 다음을 수행합니다:
 - ✅ ComfyUI 코드 자체 업데이트
-- ✅ PyTorch 업데이트 (NVIDIA GPU CUDA 12.9용)
+- ✅ **표준 Nvidia 포터블**용 PyTorch 업데이트(현재 **CUDA 13.0 / cu130**, Python 3.13)
 - ✅ 모든 파이썬 의존성 재설치
 
+**레거시 Nvidia 포터블(CUDA 12.6 / cu126):** Nvidia **10시리즈 및 이전 GPU**용으로 따로 제공되는 포터블 패키지를 설치했다면, 해당 빌드는 **CUDA 12.6**과 Python 3.12를 사용합니다. cu130을 그 패키지의 올바른 대상으로 보지 마세요. 해당 포터블에 맞는 cu126 wheel 인덱스로 PyTorch를 다시 설치·업데이트하거나, [Portable 설치 가이드](/ko/installation/comfyui_portable_windows)에서 cu126 패키지를 다시 받으세요.
+
 **위험:**
 - 기존 설정과의 의존성 충돌을 일으킬 수 있음
 - 특정 패키지 버전에 의존하는 커스텀 노드를 깨뜨릴 수 있음
 - 수동으로 구성한 패키지를 덮어쓸 수 있음
+- cu126(또는 기타 비-cu130) 포터블에서 무작정 cu130 wheel을 넣으면 GPU 시작이 깨질 수 있음
 
 **⚠️ 이 스크립트는 다음 경우에만 사용하세요:**
 - 의존성 문제를 해결해야 할 때
@@ -59,7 +62,8 @@
 **이 스크립트를 실행하기 전에:**
 1. ComfyUI 전체 설치본 백업하기
 2. 설치한 맞춤형 패키지 버전 기록하기
-3. 필요하다면 커스텀 노드를 다시 설치할 준비 갖추기
+3. 사용 중인 포터블 패키지 확인하기(cu130 표준 vs cu126 레거시) — [Windows용 ComfyUI Portable](/ko/installation/comfyui_portable_windows) 참고
+4. 필요하다면 커스텀 노드를 다시 설치할 준비 갖추기
 </Warning>
 </Tab>
 <Tab title="데스크탑">
@@ -78,8 +82,8 @@
 <Step title="가상 환경 활성화">
 먼저 ComfyUI의 파이썬 가상 환경을 활성화하세요(사용 중인 경우):
 ```bash
 # conda 환경용
 conda activate comfyui
 
 # venv 환경용
 # Windows

zh/installation/update_comfyui.mdx

@@ -3,11 +3,11 @@
 description: "更新任意安装类型的 ComfyUI：便携版更新脚本、Desktop 更新、手动安装的 git pull，以及常见更新问题的修复。"
 icon: "circle-up"
 sidebarTitle: "更新 ComfyUI"
-translationSourceHash: 73922310
+translationSourceHash: 1d95d67d
 translationFrom: installation/update_comfyui.mdx
 translationBlockHashes:
   "_intro": ea3fba01
-  "How to Update ComfyUI?": 7328cb96
+  "How to Update ComfyUI?": 7302fc02
   "ComfyUI Version Types": 0f19bbda
   "What Needs to Be Updated When Updating ComfyUI?": b2d99699
   "Common Update Issues": ff82d6b7
@@ -42,13 +42,16 @@
 
 这个脚本比普通更新更彻底，它会：
 - ✅ 更新 ComfyUI 代码本身
-- ✅ 更新 PyTorch（针对 NVIDIA GPU CUDA 12.9）
+- ✅ 为**标准 Nvidia 便携包**更新 PyTorch（当前为 **CUDA 13.0 / cu130**，Python 3.13）
 - ✅ 重新安装所有 Python 依赖包
 
+**旧版 Nvidia 便携包（CUDA 12.6 / cu126）：** 若你安装的是面向 Nvidia **10 系及更早 GPU** 的单独便携包，该版本使用 **CUDA 12.6** 与 Python 3.12。请勿把 cu130 当作该包的正确目标——请用与该便携包匹配的 cu126 wheel 源重装或更新 PyTorch，或从 [Portable 安装指南](/zh/installation/comfyui_portable_windows) 重新下载 cu126 包。
+
 **风险提示：**
 - 可能与现有配置产生依赖冲突
 - 可能破坏依赖特定包版本的自定义节点
 - 可能覆盖手动配置的包版本
+- 在 cu126（或其他非 cu130）便携包上强行安装 cu130 wheel 可能导致 GPU 无法启动
 
 **⚠️ 仅在以下情况使用此脚本：**
 - 需要修复依赖问题时
@@ -58,7 +61,8 @@
 **运行此脚本前必须：**
 1. **备份整个 ComfyUI 安装目录**
 2. 记录已安装的自定义包版本
-3. 做好重新安装自定义节点的准备
+3. 确认你使用的是哪种便携包（cu130 标准版 vs cu126 旧版）——参见 [Windows 版 ComfyUI Portable](/zh/installation/comfyui_portable_windows)
+4. 做好重新安装自定义节点的准备
 </Warning>
 </Tab>
 <Tab title="桌面版">
@@ -77,10 +81,10 @@
 <Step title="激活虚拟环境">
 首先激活 ComfyUI 的 Python 虚拟环境（如果使用了虚拟环境）：
 ```bash
 # 对于 conda 环境
 conda activate comfyui
 
 # 对于 venv 环境
 # Windows
 venv\Scripts\activate
 # macOS/Linux