From 3f232add3401426d68234b99fcf8cf11684d830e Mon Sep 17 00:00:00 2001 From: evan188199-tech Date: Thu, 10 Sep 2026 23:41:41 +0800 Subject: [PATCH] docs(web): document v1.6.4/v1.6.5 screenshot status (#1306) Co-authored-by: XZH --- README.md | 2 + UI_SCREENSHOT_REFRESH.md | 82 ++++++++++++++++++++++++++++++++++++++ assets/README/README_AR.md | 2 + assets/README/README_CN.md | 2 + assets/README/README_ES.md | 2 + assets/README/README_FR.md | 2 + assets/README/README_HI.md | 2 + assets/README/README_JA.md | 2 + assets/README/README_PL.md | 2 + assets/README/README_PT.md | 2 + assets/README/README_RU.md | 2 + assets/README/README_TH.md | 2 + assets/README/README_TW.md | 2 + 13 files changed, 106 insertions(+) create mode 100644 UI_SCREENSHOT_REFRESH.md diff --git a/README.md b/README.md index 37bcf130..38f0ccfc 100644 --- a/README.md +++ b/README.md @@ -619,6 +619,8 @@ If an answer loses an earlier constraint, cites weak evidence, or disagrees with DeepTutor home — the Chat workspace with every surface in the sidebar +> **Screenshot status:** The overview is current for v1.6.5. The surface screenshots below remain v1.4.6 references while a versioned refresh is in progress; see the [screenshot inventory](./UI_SCREENSHOT_REFRESH.md). Use them to understand workflows, not as exact navigation. +
🏗️ System architecture diff --git a/UI_SCREENSHOT_REFRESH.md b/UI_SCREENSHOT_REFRESH.md new file mode 100644 index 00000000..3a987ea9 --- /dev/null +++ b/UI_SCREENSHOT_REFRESH.md @@ -0,0 +1,82 @@ +# UI Screenshot Refresh: v1.6.4/v1.6.5 + +This inventory tracks the product screenshots used by the root README and the +11 translated READMEs. It separates the one current v1.6.5 capture from the +historical v1.4.6 references that still document useful workflows but no longer +show the current navigation and controls. + +## Status + +| Status | Meaning | +| --- | --- | +| Current | The capture represents v1.6.5. | +| Historical | The capture remains useful as a workflow reference but shows the v1.4.6 layout. | +| Missing | There is no versioned capture for the v1.6.4/v1.6.5 surface. | + +The current overview is `assets/figs/web-1.6.5/OVERVIEW.png`. It was introduced +in [#1263](https://github.com/HKUDS/DeepTutor/pull/1263). + +## Existing Screenshot Inventory + +| Surface | Existing asset | Status | v1.6.5 replacement needed | +| --- | --- | --- | --- | +| Home and main navigation | `assets/figs/web-1.6.5/OVERVIEW.png` | Current | Capture content, capabilities, and navigation states if they cannot be shown in one overview. | +| Chat workspace | `assets/figs/web-1.4.6+/home/00-overview.png` | Historical | Capture the v1.6.5 chat workspace and unified Activity/turn trace. | +| Partners overview | `assets/figs/web-1.4.6+/partners/00-partners overview.png` | Historical | Capture the current partners list and status controls. | +| Partner IM configuration | `assets/figs/web-1.4.6+/partners/02-IM config for each partner.png` | Historical | Capture the current channel-configuration page. | +| My Agents overview | `assets/figs/web-1.4.6+/myagents/00-overview.png` | Historical | Capture connected and imported agent states. | +| Claude Code subagent consultation | `assets/figs/web-1.4.6+/home/08-subagent demo with claude code.png` | Historical | Capture the current Activity/turn trace while a subagent runs. | +| Co-Writer overview | `assets/figs/web-1.4.6+/co-writer/00-overview.png` | Historical | Capture the current split view. | +| Co-Writer selection edit | `assets/figs/web-1.4.6+/co-writer/01-edit panel.png` | Historical | Capture the current edit-panel state. | +| Book library | `assets/figs/web-1.4.6+/book/00-book_overview.png` | Historical | Capture the current library and source selection. | +| Book quiz block | `assets/figs/web-1.4.6+/book/01-book-demo-quiz card.png` | Historical | Capture the current quiz block. | +| Book Manim block | `assets/figs/web-1.4.6+/book/02-book-demo-manim video.png` | Historical | Capture the current animation block. | +| Book interactive block | `assets/figs/web-1.4.6+/book/03-book-demo interactive module.png` | Historical | Capture the current interactive block. | +| Knowledge Center overview | `assets/figs/web-1.4.6+/knowledge/00-overview.png` | Historical | Capture the current KB list and engine states. | +| Knowledge base creation | `assets/figs/web-1.4.6+/knowledge/01-create knowledge base.png` | Historical | Capture the current creation and linking flow. | +| Learning Space overview | `assets/figs/web-1.4.6+/learning-space/00-overview.png` | Historical | Capture the current personalization and materials groups. | +| EduHub skill import | `assets/figs/web-1.4.6+/learning-space/07- download skills from eduhub.png` | Historical | Capture the current import and security gate. | +| Memory overview | `assets/figs/web-1.4.6+/memory/00-overview.png` | Historical | Capture the current memory layers. | +| Memory graph | `assets/figs/web-1.4.6+/memory/01-3 layer memory graph.png` | Historical | Capture the current evidence graph. | +| Settings overview | `assets/figs/web-1.4.6+/settings/00-setting overview.png` | Historical | Capture the live status strip and Readiness matrix. | +| Appearance settings | `assets/figs/web-1.4.6+/settings/01-appearance settings.png` | Historical | Capture the current appearance section if its layout changed. | + +The encoded forms of spaces in the Markdown image URLs are intentional. The +table uses decoded names for readability. + +## Missing v1.6.4/v1.6.5 Surfaces + +Add versioned captures before documenting these surfaces with old screenshots: + +- `Settings -> Workspace`; +- the Settings Readiness matrix; +- Content Workspace outputs and `workspace_present` file presentation; +- unified Activity and turn traces; +- Mastery Path question, handoff, learning board, mode switch, and coverage UI; +- Book generation activity controls; +- per-model API format, capability controls, and model-list pickers; +- Reading and Watching surfaces changed by v1.6.4. + +Store captures under `assets/figs/web-1.6.5//`. Prefer 1440x900 PNG +captures, the default theme, and stable numbered file names. Use dark mode only +when the layout differs materially. + +## Capture Hygiene + +Run against a clean temporary runtime home and a fresh content workspace. +Before committing an image, review it for: + +- API keys, bearer tokens, account identifiers, or OAuth data; +- personal file names, emails, chat content, URLs, and upload names; +- private hostnames, ports, IP addresses, project paths, and organization data; +- temporary credentials or provider account balances; +- browser notifications, bookmarks, extensions, and system UI outside DeepTutor. + +## Verification + +1. Confirm every referenced image resolves from the README that references it. +2. Confirm the asset dimensions and capture theme before replacing a reference. +3. After a surface is refreshed, update its row in this inventory and replace + the equivalent reference in the root README and all translated READMEs. +4. When the refresh is complete, remove the v1.4.6 references from the current + product tour; do not present them as the current UI. diff --git a/assets/README/README_AR.md b/assets/README/README_AR.md index 075b7002..4724d3bc 100644 --- a/assets/README/README_AR.md +++ b/assets/README/README_AR.md @@ -390,6 +390,8 @@ deeptutor config show الصفحة الرئيسية لـ DeepTutor — مساحة عمل Chat مع كل الأسطح في الشريط الجانبي +> **حالة لقطات الشاشة:** الصورة العامة محدثة لـ v1.6.5. لقطات الواجهات أدناه لا تزال مراجع من v1.4.6 أثناء تحديثها؛ راجع [جرد لقطات الشاشة](../../UI_SCREENSHOT_REFRESH.md). استخدمها لفهم سير العمل، لا كملاحة دقيقة للواجهة الحالية. +
🏗️ معمارية النظام diff --git a/assets/README/README_CN.md b/assets/README/README_CN.md index d41e7327..39693b0a 100644 --- a/assets/README/README_CN.md +++ b/assets/README/README_CN.md @@ -390,6 +390,8 @@ DeepTutor 将已安装的代码、私有运行时主目录与可选的内容工 DeepTutor 主页 — 带有侧边栏所有入口的 Chat 工作区 +> **截图状态：** 总览图已更新到 v1.6.5。下方功能截图仍是 v1.4.6 参考图，正在分批替换；请查看[截图清单](../../UI_SCREENSHOT_REFRESH.md)。它们适合说明工作流，不代表当前精确导航。 +
🏗️ 系统架构 diff --git a/assets/README/README_ES.md b/assets/README/README_ES.md index c0248c7e..7931ad5e 100644 --- a/assets/README/README_ES.md +++ b/assets/README/README_ES.md @@ -399,6 +399,8 @@ Si una respuesta pierde una restricción anterior, cita evidencia débil o contr Inicio de DeepTutor — el espacio de trabajo Chat con todas las superficies en la barra lateral +> **Estado de las capturas:** la vista general está actualizada para v1.6.5. Las capturas de superficies siguientes siguen siendo referencias de v1.4.6 mientras se realiza la actualización; consulta el [inventario de capturas](../../UI_SCREENSHOT_REFRESH.md). Úsalas para entender los flujos, no como navegación exacta actual. +
🏗️ Arquitectura del sistema diff --git a/assets/README/README_FR.md b/assets/README/README_FR.md index d05bd469..df2c9ddd 100644 --- a/assets/README/README_FR.md +++ b/assets/README/README_FR.md @@ -400,6 +400,8 @@ Si une réponse perd une contrainte antérieure, cite des preuves faibles ou con Accueil DeepTutor — l'espace de travail Chat avec chaque surface dans la barre latérale +> **État des captures d'écran :** la vue d'ensemble est à jour pour v1.6.5. Les captures de surface ci-dessous restent des références v1.4.6 pendant la mise à jour ; voir l'[inventaire des captures](../../UI_SCREENSHOT_REFRESH.md). Utilisez-les pour comprendre les parcours, pas comme navigation exacte actuelle. +
🏗️ Architecture du système diff --git a/assets/README/README_HI.md b/assets/README/README_HI.md index d4cbd705..65a4fcc6 100644 --- a/assets/README/README_HI.md +++ b/assets/README/README_HI.md @@ -390,6 +390,8 @@ DeepTutor अपने installed code, private runtime home, और optional Con DeepTutor होम — sidebar में हर surface के साथ Chat workspace +> **Screenshot स्थिति:** overview v1.6.5 के लिए current है। नीचे दी गई surface screenshots अभी v1.4.6 references हैं और versioned refresh जारी है; [screenshot inventory](../../UI_SCREENSHOT_REFRESH.md) देखें। इन्हें workflows समझने के लिए उपयोग करें, current exact navigation के रूप में नहीं। +
🏗️ System architecture diff --git a/assets/README/README_JA.md b/assets/README/README_JA.md index 20c1ccf1..ac572cdd 100644 --- a/assets/README/README_JA.md +++ b/assets/README/README_JA.md @@ -390,6 +390,8 @@ DeepTutorは、インストールされたコード、プライベートなラ DeepTutorホーム — サイドバーにすべてのサーフェスを含むチャットワークスペース +> **スクリーンショットの状態:** 全体表示は v1.6.5 向けに更新済みです。以下の画面スクリーンショットは、刷新中のため引き続き v1.4.6 の参考画像です。[スクリーンショット一覧](../../UI_SCREENSHOT_REFRESH.md)を参照してください。操作の流れの理解には使えますが、現在の正確なナビゲーションとしては扱わないでください。 +
🏗️ システムアーキテクチャ diff --git a/assets/README/README_PL.md b/assets/README/README_PL.md index 2af663d9..8a18b1a6 100644 --- a/assets/README/README_PL.md +++ b/assets/README/README_PL.md @@ -390,6 +390,8 @@ Jeśli odpowiedź pomija wcześniejsze ograniczenie, przywołuje słabe dowody l Strona główna DeepTutor — obszar roboczy Chat z każdą powierzchnią w pasku bocznym +> **Stan zrzutów ekranu:** widok ogólny jest aktualny dla wersji v1.6.5. Poniższe zrzuty powierzchni pozostają odniesieniami z wersji v1.4.6 w trakcie aktualizacji; zobacz [inwentarz zrzutów](../../UI_SCREENSHOT_REFRESH.md). Służą do zrozumienia przepływów, a nie jako dokładna bieżąca nawigacja. +
🏗️ Architektura systemu diff --git a/assets/README/README_PT.md b/assets/README/README_PT.md index 1c4a9253..3d3bd397 100644 --- a/assets/README/README_PT.md +++ b/assets/README/README_PT.md @@ -390,6 +390,8 @@ Se uma resposta perder uma restrição anterior, citar evidências fracas ou dis Página inicial do DeepTutor — o espaço de trabalho Chat com todas as superfícies na barra lateral +> **Estado das capturas:** a visão geral está atualizada para a v1.6.5. As capturas de superfícies abaixo continuam referências da v1.4.6 durante a atualização; veja o [inventário de capturas](../../UI_SCREENSHOT_REFRESH.md). Use-as para entender os fluxos, não como navegação exata atual. +
🏗️ Arquitetura do sistema diff --git a/assets/README/README_RU.md b/assets/README/README_RU.md index cf15680d..8c967845 100644 --- a/assets/README/README_RU.md +++ b/assets/README/README_RU.md @@ -390,6 +390,8 @@ DeepTutor отделяет установленный код, приватное Главная страница DeepTutor — рабочее пространство чата со всеми поверхностями на боковой панели +> **Состояние скриншотов:** общий обзор обновлен для v1.6.5. Скриншоты поверхностей ниже остаются справочными изображениями v1.4.6 до завершения обновления; см. [перечень скриншотов](../../UI_SCREENSHOT_REFRESH.md). Используйте их для понимания рабочих процессов, а не как точную текущую навигацию. +
🏗️ Архитектура системы diff --git a/assets/README/README_TH.md b/assets/README/README_TH.md index b400ad17..e8c8ebb7 100644 --- a/assets/README/README_TH.md +++ b/assets/README/README_TH.md @@ -407,6 +407,8 @@ DeepTutor แยกโค้ดที่ติดตั้ง, runtime home ส หน้าแรก DeepTutor — workspace Chat พร้อมทุกส่วนในแถบด้านข้าง +> **สถานะภาพหน้าจอ:** ภาพภาพรวมเป็นเวอร์ชัน v1.6.5 ส่วนภาพหน้าจอรายการด้านล่างยังเป็นข้อมูลอ้างอิง v1.4.6 ระหว่างการอัปเดต ดู [รายการภาพหน้าจอ](../../UI_SCREENSHOT_REFRESH.md) ใช้เพื่อทำความเข้าใจขั้นตอนการใช้งาน ไม่ใช่การนำทางปัจจุบันแบบเป๊ะ +
🏗️ สถาปัตยกรรมระบบ diff --git a/assets/README/README_TW.md b/assets/README/README_TW.md index 56ed8477..d7c4139c 100644 --- a/assets/README/README_TW.md +++ b/assets/README/README_TW.md @@ -390,6 +390,8 @@ DeepTutor 會將已安裝的程式碼、私有執行環境目錄與選用的內 DeepTutor 首頁 — 側邊欄包含所有功能入口的 Chat 工作區 +> **截圖狀態：** 總覽圖已更新到 v1.6.5。下方功能截圖仍是 v1.4.6 參考圖，正在分批替換；請查看[截圖清單](../../UI_SCREENSHOT_REFRESH.md)。它們適合說明工作流，不代表目前精確導覽。 +
🏗️ 系統架構