Skip to content

Commit f6ba93e

Browse files
committed
docs: update READMEs
1 parent 8cc6c97 commit f6ba93e

File tree

12 files changed

+102
-38
lines changed

12 files changed

+102
-38
lines changed

README.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ A continuous, real-time runtime diagnostics suite for ComfyUI featuring **LLM-po
77
## Latest Updates (Jan 2026)
88

99
<details>
10-
<summary><strong>Update (v1.4.0, Jan 2026)</strong> - Click to expand</summary>
10+
<summary><strong>Update (v1.4.1, Jan 2026)</strong> - Click to expand</summary>
1111

12-
- A7 Preact migration completed across Phases 5A–5C (Chat/Stats islands, fallbacks, registry, shared rendering).
13-
- Integration hardening: improved lifecycle handling and expanded E2E coverage.
12+
- A7 Preact migration completed across Phases 5A–5C (Chat/Stats islands, registry, shared rendering, robust fallbacks).
13+
- F15 Resolution Marking UI: mark the latest error as Resolved/Unresolved/Ignored from Statistics; status persists and reflects on load.
14+
- Integration hardening: fixed resolution_status plumbing and strengthened Playwright E2E coverage.
1415
- UI fixes: Locate Node button persistence and sidebar tooltip timing.
1516

1617
</details>
@@ -459,13 +460,19 @@ The **Statistics Dashboard** provides real-time insights into your ComfyUI error
459460
- **🔥 Top Error Patterns**: Top 5 most frequent error types with occurrence counts
460461
- **📈 Category Breakdown**: Visual breakdown by error category (Memory, Workflow, Model Loading, Framework, Generic)
461462
- **✅ Resolution Tracking**: Track resolved, unresolved, and ignored errors
463+
- **🧭 Status Controls**: Mark the latest error as Resolved / Unresolved / Ignored from the Stats tab
462464

463465
**How to Use**:
464466

465467
1. Open the Doctor sidebar (click 🏥 icon on left)
466468
2. Find the **📊 Error Statistics** collapsible section
467469
3. Click to expand and view your error analytics
468-
4. Mark errors as resolved/ignored directly from error cards to update resolution tracking
470+
4. Use **Mark as** buttons to set the latest error status (Resolved / Unresolved / Ignored)
471+
472+
**Resolution Status Controls**:
473+
474+
- Buttons are enabled only when a latest error timestamp is available
475+
- Status updates persist in history and refresh the resolution rate automatically
469476

470477
**Understanding the Data**:
471478

ROADMAP.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -262,13 +262,14 @@ graph TD
262262
- **Stats**: Top intents and intent-to-error correlation
263263
- **APIs**: `/doctor/health_check`, `/doctor/health_report`, `/doctor/health_history`, `/doctor/health_ack`
264264
- **Plan**: `.planning/260108-PROACTIVE_DIAGNOSTICS_PLAN.md`
265-
- [ ] **F15**: Resolution Marking UI (Resolved / Unresolved / Ignored) - 🟡 Medium
265+
- [x] **F15**: Resolution Marking UI (Resolved / Unresolved / Ignored) - 🟡 Medium*Completed (2026-01-09)*
266266
- **Goal**: Let users update resolution status directly from UI
267267
- **Scope**: Statistics tab first; optional Chat tab parity
268268
- **Flow**: `POST /doctor/mark_resolved` → refresh stats
269269
- **i18n**: Status labels and "Mark as" strings
270270
- **Tests**: Playwright mock API + UI state assertions
271271
- **Plan**: `.planning/260108-F15_RESOLUTION_MARKING_UI_PLAN.md`
272+
- **Implementation Record**: `.planning/260108-F15_IMPLEMENTATION_RECORD.md`
272273
- [ ] **F16**: Quick Community Feedback (GitHub PR) - 🔴 High
273274
- **Goal**: One-click PR with sanitized pattern + verified suggestion + optional stats snapshot
274275
- **Repo**: `rookiestar28/ComfyUI-Doctor`

assets/statistics_panel.png

-2.84 KB
Loading

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[project]
22
name = "comfyui-doctor"
33
description = "A real-time runtime diagnostics suite for ComfyUI, featuring interactive debugging chat, and 50+ fix patterns. Automatically intercepts terminal output from startup, and delivers prioritized fix suggestions with node-level context extraction. Now supports JSON-based pattern management with hot-reload and full i18n support for 9 languages."
4-
version = "1.3.8"
4+
version = "1.4.1"
55
license = {text = "MIT"}
66
readme = "README.md"
77
requires-python = ">=3.10"

readme/README.de.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ Eine kontinuierliche Echtzeit-Laufzeitdiagnose-Suite für ComfyUI mit **KI-gest
77
## Neueste Updates (Jan 2026)
88

99
<details>
10-
<summary><strong>Update (v1.4.0, Jan 2026)</strong> - Zum Erweitern klicken</summary>
10+
<summary><strong>Update (v1.4.1, Jan 2026)</strong> - Zum Erweitern klicken</summary>
1111

12-
- A7 Preact-Migration über die Phasen 5A–5C abgeschlossen (Chat/Stats Islands, Fallbacks, Registry, Shared Rendering).
13-
- Integrationshärtung: verbessertes Lifecycle-Handling und erweiterte E2E-Abdeckung.
12+
- A7 Preact-Migration über die Phasen 5A–5C abgeschlossen (Chat/Stats Islands, Registry, Shared Rendering, robuste Fallbacks).
13+
- F15 Status-Markierung: Den neuesten Fehler im Statistik-Tab als Gelöst/Ungelöst/Ignoriert markieren; Status bleibt erhalten und wird beim Laden angezeigt.
14+
- Integrationshärtung: resolution_status-Datenfluss ergänzt und Playwright-E2E-Abdeckung gestärkt.
1415
- UI-Korrekturen: Locate Node-Button bleibt erhalten und Sidebar-Tooltip-Timing korrigiert.
1516

1617
</details>
@@ -461,13 +462,19 @@ Das **Statistik-Dashboard** bietet Echtzeit-Einblicke in Ihre ComfyUI-Fehlermust
461462
- **🔥 Top-Fehlermuster**: Top 5 der häufigsten Fehlertypen mit Vorkommensanzahl
462463
- **📈 Kategorie-Aufschlüsselung**: Visuelle Aufschlüsselung nach Fehlerkategorie (Speicher, Workflow, Modellladen, Framework, Generisch)
463464
- **✅ Lösungsverfolgung**: Verfolgen Sie gelöste, ungelöste und ignorierte Fehler
465+
- **🧭 Status-Steuerung**: Den neuesten Fehler im Statistik-Tab als Gelöst / Ungelöst / Ignoriert markieren
464466

465467
**Verwendung**:
466468

467469
1. Doctor-Seitenleiste öffnen (🏥-Symbol links klicken)
468470
2. Den einklappbaren Abschnitt **📊 Fehlerstatistik** finden
469471
3. Klicken zum Erweitern und Anzeigen Ihrer Fehleranalysen
470-
4. Fehler direkt von Fehlerkarten aus als gelöst/ignoriert markieren, um die Lösungsverfolgung zu aktualisieren
472+
4. Mit den **Mark as**-Schaltflächen den Status des neuesten Fehlers setzen (Gelöst / Ungelöst / Ignoriert)
473+
474+
**Steuerung des Lösungsstatus**:
475+
476+
- Schaltflächen sind nur aktiv, wenn ein Zeitstempel für den neuesten Fehler verfügbar ist
477+
- Status-Updates werden in der Historie gespeichert und aktualisieren die Lösungsquote automatisch
471478

472479
**Verständnis der Daten**:
473480

readme/README.es.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ Un conjunto de diagnósticos continuos en tiempo de ejecución y en tiempo real
77
## Últimas actualizaciones (Ene 2026)
88

99
<details>
10-
<summary><strong>Actualización (v1.4.0, Ene 2026)</strong> - Clic para expandir</summary>
10+
<summary><strong>Actualización (v1.4.1, Ene 2026)</strong> - Clic para expandir</summary>
1111

12-
- Migración A7 Preact completada en las fases 5A–5C (islas de Chat/Estadísticas, respaldos, registro, renderizado compartido).
13-
- Refuerzo de integración: manejo mejorado del ciclo de vida y cobertura E2E extendida.
12+
- Migración A7 Preact completada en las fases 5A–5C (islas de Chat/Estadísticas, registro, renderizado compartido, respaldos robustos).
13+
- F15 Marcado de estado: marque el último error como Resuelto/No resuelto/Ignorado desde Estadísticas; estado persistente y reflejado al cargar.
14+
- Refuerzo de integración: corregido el flujo de resolution_status y reforzada la cobertura Playwright E2E.
1415
- Correcciones de UI: persistencia del botón Locate Node y corrección de la sincronización de la información sobre herramientas de la barra lateral.
1516

1617
</details>
@@ -461,13 +462,19 @@ El **Panel de Estadísticas** proporciona información en tiempo real sobre sus
461462
- **🔥 Patrones de Error Principales**: Los 5 tipos de error más frecuentes con recuentos de ocurrencia
462463
- **📈 Desglose por Categoría**: Desglose visual por categoría de error (Memoria, Flujo de trabajo, Carga de modelos, Marco, Genérico)
463464
- **✅ Seguimiento de Resolución**: Rastree errores resueltos, no resueltos e ignorados
465+
- **🧭 Controles de estado**: Marca el último error como Resuelto / No resuelto / Ignorado desde la pestaña Estadísticas
464466

465467
**Cómo Usar**:
466468

467469
1. Abra la barra lateral Doctor (clic en icono 🏥 a la izquierda)
468470
2. Encuentre la sección plegable **📊 Estadísticas de Errores**
469471
3. Haga clic para expandir y ver sus análisis de errores
470-
4. Marque los errores como resueltos/ignorados directamente desde las tarjetas de error para actualizar el seguimiento de resolución
472+
4. Usa los botones **Marcar como** para establecer el estado del último error (Resuelto / No resuelto / Ignorado)
473+
474+
**Controles de estado**:
475+
476+
- Los botones solo se habilitan cuando hay un timestamp del último error disponible
477+
- Las actualizaciones de estado se guardan en el historial y actualizan automáticamente la tasa de resolución
471478

472479
**Entendiendo los Datos**:
473480

readme/README.fr.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ Une suite de diagnostics d'exécution continue et en temps réel pour ComfyUI co
77
## Dernières mises à jour (Jan 2026)
88

99
<details>
10-
<summary><strong>Mise à jour (v1.4.0, Jan 2026)</strong> - Cliquer pour développer</summary>
10+
<summary><strong>Mise à jour (v1.4.1, Jan 2026)</strong> - Cliquer pour développer</summary>
1111

12-
- Migration A7 Preact terminée sur les phases 5A–5C (îlots Chat/Stats, solutions de repli, registre, rendu partagé).
13-
- Renforcement de l'intégration : amélioration de la gestion du cycle de vie et extension de la couverture E2E.
12+
- Migration A7 Preact terminée sur les phases 5A–5C (îlots Chat/Stats, registre, rendu partagé, solutions de repli robustes).
13+
- F15 Marquage de statut : marquer la dernière erreur comme Résolu/Non résolu/Ignoré depuis l’onglet Statistiques ; statut persistant et reflété au chargement.
14+
- Renforcement de l'intégration : correction du flux resolution_status et couverture Playwright E2E renforcée.
1415
- Correctifs UI : persistance du bouton "Locate Node" et correction du timing de l'info-bulle de la barre latérale.
1516

1617
</details>
@@ -461,13 +462,19 @@ Le **Tableau de bord statistiques** fournit des informations en temps réel sur
461462
- **🔥 Principaux motifs d'erreur** : Les 5 types d'erreurs les plus fréquents avec le nombre d'occurrences
462463
- **📈 Répartition par catégorie** : Répartition visuelle par catégorie d'erreur (Mémoire, Flux de travail, Chargement de modèle, Cadre, Générique)
463464
- **✅ Suivi de résolution** : Suivez les erreurs résolues, non résolues et ignorées
465+
- **🧭 Contrôles de statut** : Marquer la dernière erreur comme Résolu / Non résolu / Ignoré depuis l’onglet Statistiques
464466

465467
**Comment utiliser** :
466468

467469
1. Ouvrez la barre latérale Doctor (cliquez sur l'icône 🏥 à gauche)
468470
2. Trouvez la section pliable **📊 Statistiques d'erreurs**
469471
3. Cliquez pour développer et afficher vos analyses d'erreurs
470-
4. Marquez les erreurs comme résolues/ignorées directement depuis les cartes d'erreur pour mettre à jour le suivi de résolution
472+
4. Utilisez les boutons **Marquer comme** pour définir l’état de la dernière erreur (Résolu / Non résolu / Ignoré)
473+
474+
**Contrôles du statut** :
475+
476+
- Les boutons ne sont activés que lorsqu’un horodatage de la dernière erreur est disponible
477+
- Les mises à jour de statut sont conservées dans l’historique et actualisent automatiquement le taux de résolution
471478

472479
**Comprendre les données** :
473480

readme/README.it.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ Una suite di diagnostica runtime continua e in tempo reale per ComfyUI con **ana
77
## Ultimi aggiornamenti (Gen 2026)
88

99
<details>
10-
<summary><strong>Aggiornamento (v1.4.0, Gen 2026)</strong> - Clicca per espandere</summary>
10+
<summary><strong>Aggiornamento (v1.4.1, Gen 2026)</strong> - Clicca per espandere</summary>
1111

12-
- Migrazione A7 Preact completata nelle fasi 5A–5C (isole Chat/Stats, fallback, registro, rendering condiviso).
13-
- Rafforzamento dell'integrazione: gestione migliorata del ciclo di vita e copertura E2E estesa.
12+
- Migrazione A7 Preact completata nelle fasi 5A–5C (isole Chat/Stats, registro, rendering condiviso, fallback robusti).
13+
- F15 Marcatura stato: imposta l’ultimo errore come Risolto/Irrisolto/Ignorato dalla scheda Statistiche; stato persistente e riflesso al caricamento.
14+
- Rafforzamento dell'integrazione: sistemato il flusso resolution_status e rafforzata la copertura Playwright E2E.
1415
- Correzioni UI: persistenza del pulsante Locate Node e correzione della tempistica del tooltip della barra laterale.
1516

1617
</details>
@@ -461,13 +462,19 @@ La **Dashboard Statistiche** fornisce approfondimenti in tempo reale sui pattern
461462
- **🔥 Pattern Errore Top**: I 5 tipi di errore più frequenti con conteggi delle occorrenze
462463
- **📈 Ripartizione Categorie**: Ripartizione visiva per categoria di errore (Memoria, Workflow, Caricamento Modelli, Framework, Generico)
463464
- **✅ Tracciamento Risoluzione**: Traccia errori risolti, irrisolti e ignorati
465+
- **🧭 Controlli stato**: Marca l’ultimo errore come Risolto / Irrisolto / Ignorato dalla scheda Statistiche
464466

465467
**Come Usare**:
466468

467469
1. Apri la barra laterale Doctor (clicca icona 🏥 a sinistra)
468470
2. Trova la sezione comprimibile **📊 Statistiche Errori**
469471
3. Clicca per espandere e visualizzare le tue analisi degli errori
470-
4. Contrassegna gli errori come risolti/ignorati direttamente dalle schede errore per aggiornare il tracciamento della risoluzione
472+
4. Usa i pulsanti **Segna come** per impostare lo stato dell’ultimo errore (Risolto / Irrisolto / Ignorato)
473+
474+
**Controlli dello stato di risoluzione**:
475+
476+
- I pulsanti sono abilitati solo quando è disponibile il timestamp dell’ultimo errore
477+
- Gli aggiornamenti di stato vengono salvati nella cronologia e aggiornano automaticamente il tasso di risoluzione
471478

472479
**Comprendere i Dati**:
473480

readme/README.ja.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ ComfyUIのための継続的かつリアルタイムなランタイム診断ス
77
## 最新のアップデート(2026年1月)
88

99
<details>
10-
<summary><strong>アップデート (v1.4.0, 2026年1月)</strong> - クリックして展開</summary>
10+
<summary><strong>アップデート (v1.4.1, 2026年1月)</strong> - クリックして展開</summary>
1111

12-
- A7 Preact移行完了(フェーズ5A–5C:Chat/Stats islands、フォールバック、レジストリ、共有レンダリング)。
13-
- 統合強化:ライフサイクル処理の改善とE2Eカバレッジの拡大。
12+
- A7 Preact移行完了(フェーズ5A–5C:Chat/Stats islands、レジストリ、共有レンダリング、堅牢なフォールバック)。
13+
- F15 解決ステータスのマーキング:統計タブから最新エラーを 解決済み/未解決/無視 に設定。状態は永続化され、読み込み時に反映。
14+
- 統合強化:resolution_status のバックエンド連携を補完し、Playwright E2E を強化。
1415
- UI修正:Locate Nodeボタンの維持とサイドバーツールチップのタイミング修正。
1516

1617
</details>
@@ -461,13 +462,19 @@ ComfyUI-Doctorには、エラーメッセージをクラウドAIサービスに
461462
- **🔥 トップエラーパターン**: 発生頻度の高い上位5つのエラータイプ
462463
- **📈 カテゴリ内訳**: エラーカテゴリ(メモリ、ワークフロー、モデルロード、フレームワーク、一般)による視覚的な内訳
463464
- **✅ 解決追跡**: 解決済み、未解決、無視されたエラーを追跡
465+
- **🧭 ステータス操作**: 統計タブから最新エラーを解決済み / 未解決 / 無視 に設定
464466

465467
**使用方法**:
466468

467469
1. Doctorサイドバーを開く(左側の 🏥 アイコンをクリック)
468470
2. **📊 Error Statistics** の折りたたみセクションを見つける
469471
3. クリックして展開し、エラー分析を表示
470-
4. エラーカードから直接エラーを解決済み/無視としてマークし、解決追跡を更新
472+
4. **Mark as** ボタンで最新エラーの状態を設定(解決済み / 未解決 / 無視)
473+
474+
**解決ステータス操作**:
475+
476+
- 最新のエラーにタイムスタンプがある場合のみボタンが有効
477+
- ステータス更新は履歴に保存され、解決率が自動で更新
471478

472479
**データの理解**:
473480

readme/README.ko.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ ComfyUI를 위한 지속적이고 실시간 런타임 진단 제품군으로, **
77
## 최신 업데이트 (2026년 1월)
88

99
<details>
10-
<summary><strong>업데이트 (v1.4.0, 2026년 1월)</strong> - 클릭하여 펼치기</summary>
10+
<summary><strong>업데이트 (v1.4.1, 2026년 1월)</strong> - 클릭하여 펼치기</summary>
1111

12-
- A7 Preact 마이그레이션 완료 (5A–5C 단계: Chat/Stats 아일랜드, 폴백, 레지스트리, 공유 렌더링).
13-
- 통합 강화: 수명 주기 처리 개선 및 E2E 커버리지 확대.
12+
- A7 Preact 마이그레이션 완료 (5A–5C 단계: Chat/Stats 아일랜드, 레지스트리, 공유 렌더링, 견고한 폴백).
13+
- F15 해결 상태 표시: 통계 탭에서 최신 오류를 해결됨/미해결/무시로 표시; 상태가 저장되고 로드 시 반영됩니다.
14+
- 통합 강화: resolution_status 백엔드 데이터 흐름 보강 및 Playwright E2E 커버리지 강화.
1415
- UI 수정: Locate Node 버튼 지속성 및 사이드바 툴팁 타이밍 수정.
1516

1617
</details>
@@ -461,13 +462,19 @@ ComfyUI-Doctor에는 클라우드 AI 서비스로 오류 메시지를 보낼 때
461462
- **🔥 최상위 오류 패턴**: 발생 횟수가 가장 많은 상위 5개 오류 유형
462463
- **📈 카테고리별 분석**: 오류 카테고리(메모리, 워크플로, 모델 로딩, 프레임워크, 일반)별 시각적 분석
463464
- **✅ 해결 추적**: 해결됨, 미해결, 무시된 오류 추적
465+
- **🧭 상태 제어**: 통계 탭에서 최신 오류를 해결됨 / 미해결 / 무시로 표시
464466

465467
**사용 방법**:
466468

467469
1. Doctor 사이드바 열기 (왼쪽의 🏥 아이콘 클릭)
468470
2. **📊 Error Statistics** 접을 수 있는 섹션 찾기
469471
3. 클릭하여 펼치고 오류 분석 보기
470-
4. 해결 추적을 업데이트하기 위해 오류 카드에서 직접 오류를 해결됨/무시함으로 표시
472+
4. **표시** 버튼으로 최신 오류 상태를 설정(해결됨 / 미해결 / 무시)
473+
474+
**해결 상태 제어**:
475+
476+
- 최신 오류 타임스탬프가 있을 때만 버튼이 활성화됨
477+
- 상태 업데이트는 히스토리에 저장되며 해결률을 자동으로 갱신함
471478

472479
**데이터 이해**:
473480

0 commit comments

Comments
 (0)