Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

pre-releas

Bingxi Zhao (Frank)d02fb9850bfa
diff --git a/README.md b/README.md
index 482b33841..c9e5976e0 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="assets/figs/logo/logo.png" alt="DeepTutor logo" height="56" style="vertical-align: middle;">&nbsp;<img src="assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: Lifelong Personalized Tutoring
@@ -677,21 +677,21 @@ uninstalling DeepTutor.
## 📖 Explore DeepTutor
-Start with the main surfaces you will use day to day: Chat, Partners, My Agents, Co-Writer, Book, Knowledge Center, Learning Space, Memory, and Settings. The tour then covers Multi-User deployments for shared, isolated workspaces.
+Start with a **workspace** for a subject or project. Its **Home**, **Learning**, and **Resources** hold your conversations, learning activities, and materials. **Partners** and **Personalization** stay with your account across workspaces. The tour below shows how these surfaces connect, followed by settings and multi-user deployment.
If an answer loses an earlier constraint, cites weak evidence, or disagrees with selected material, collect the diagnostics in [`REASONING_SAFETY_CHECKLIST.md`](./docs-for-user/REASONING_SAFETY_CHECKLIST.md) before opening an issue.
<div align="center">
-<img src="assets/figs/web-1.6.5/OVERVIEW.png" alt="DeepTutor home — the Chat workspace with every surface in the sidebar" width="900">
+<img src="assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **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. Use them to understand workflows, not as exact navigation.
+> Screenshots show the current dev interface with fictional demonstration materials, except the Memory Graph supplied by the project maintainer.
<details>
<summary><b>🏗️ System architecture</b></summary>
<div align="center">
-<img src="assets/figs/system/system%20architecture.png" alt="DeepTutor system architecture" width="900">
+<img src="assets/figs/system/system-architecture.svg" alt="DeepTutor system architecture" width="900">
</div>
</details>
@@ -702,13 +702,13 @@ If an answer loses an earlier constraint, cites weak evidence, or disagrees with
Chat is the default capability and where most work begins. A single thread can talk normally, call tools, ground itself in selected knowledge bases, read attachments, generate images, consult subagents, write notebook records, and continue with the same context across turns.
<div align="center">
-<img src="assets/figs/web-1.4.6+/home/00-overview.png" alt="DeepTutor chat workspace" width="900">
+<img src="assets/figs/web-dev/chat.png" alt="DeepTutor chat workspace" width="900">
</div>
The tutor calls tools as needed and can pause to ask clarifying questions. **Customize page**, at the upper right, chooses the visible modes and Skills, MCP, Partners, Preferences, and voice-input controls. Under **Starting prompts**, add, edit, or remove the titles and prompts in Explain, Solve, Practice, Plan, and Research. Save applies your account preferences; Cancel discards edits, and Restore defaults brings back the original choices.
<div align="center">
-<img src="assets/figs/system/chat-agent-loop.png" alt="DeepTutor chat agent loop" width="900">
+<img src="assets/figs/system/chat-agent-loop.svg" alt="DeepTutor chat agent loop" width="900">
</div>
User-toggleable tools are `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason`, and `geogebra_analysis` — plus `imagegen` and `videogen` once you configure the matching generation model. Contextual tools such as `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present`, and `workspace_export` mount automatically when the turn has the right context.
@@ -723,7 +723,7 @@ With the full profile, Home keeps **Chat**, **Ask Questions**, **Quiz**, **Visua
<summary><b>🤝 Partner — Persistent Companions on the Same Brain</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="DeepTutor partners workspace" width="900">
+<img src="assets/figs/web-dev/partners.png" alt="DeepTutor partners workspace" width="900">
</div>
Partners are persistent companions with their own soul, model policy, library, memory, and channels. They are not a separate bot engine: every inbound web or IM message becomes a normal `ChatOrchestrator` turn inside a partner-scoped workspace. A partner is "a chat that has a personality and a phone number."
@@ -735,7 +735,7 @@ Partners are persistent companions with their own soul, model policy, library, m
Each partner has a `SOUL.md`, model selection, channels, tool policy, and assigned library. Its library either copies knowledge bases, skills, and notebooks into `data/partners/<id>/workspace/`, or stays linked to an existing workspace's files and resources; soul, conversations, and Partner memory remain separate. Authenticated non-admin users keep private partner sessions and relationship memory while the partner reads their personal memory read-only; admin, group, and unbound traffic use the shared partner scope.
<div align="center">
-<img src="assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Per-partner IM channel configuration" width="900">
+<img src="assets/figs/web-dev/partners-channels.png" alt="Per-partner IM channel configuration" width="900">
</div>
The channel layer is schema-driven and can connect to IM platforms such as Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat, and Microsoft Teams depending on installed extras and configured credentials. A partner can also be connected as a subagent and consulted from a normal chat turn — see **My Agents** below.
@@ -748,7 +748,7 @@ For faster setup, the Partner channel page can create a Feishu/Lark app or WeCom
<summary><b>🧑‍🚀 My Agents — Consult & Import Other Agents</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/myagents/00-overview.png" alt="DeepTutor My Agents workspace" width="900">
+<img src="assets/figs/web-dev/agents.png" alt="DeepTutor My Agents workspace" width="900">
</div>
My Agents turns other agents into context for DeepTutor, and does two distinct things. **Connect a live agent** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw, or DeepSeek Harness on your machine, a remote Hermes gateway, or one of your Partners — and consult it from inside a chat turn: DeepTutor actually *runs* the other agent and streams its work into the Activity panel via the `consult_subagent` tool. Select it and its round limit with the Agent chip, or filter the same connected-agent list with `@`; the choice stays attached to the session.
@@ -779,7 +779,7 @@ Grok conversations. In Docker, install and authenticate Grok inside the backend
container; a CLI installed only on the browser's computer is not reachable.
<div align="center">
-<img src="assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Consulting a Claude Code subagent live" width="900">
+<img src="assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Import past conversations** — bring in your existing ChatGPT, Claude Code, and Codex history as searchable, resumable conversations. Select `conversations.json` from an official ChatGPT data export for a safe, idempotent snapshot import, choose Claude history by project / working directory, or choose Codex history by calendar date. Folder-based agents remain refreshable so their selected scope can pull in new conversations. Reference one from a Chat turn via `+` → My Agents, and DeepTutor reads it as a third-party transcript — it stays *their* conversation, not DeepTutor's own voice.
@@ -787,19 +787,19 @@ container; a CLI installed only on the browser's computer is not reachable.
</details>
<details>
-<summary><b>✍️ Co-Writer — Selection-Aware Markdown Drafting</b></summary>
+<summary><b>✍️ Learning Notebook — Pages, Sources, and Dito</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="DeepTutor Co-Writer workspace" width="900">
+<img src="assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
-Co-Writer is a split-view Markdown workspace for reports, tutorials, notes, and long-form learning artifacts. Documents autosave and render a live preview (KaTeX math, diagram fences), and can be saved back into notebooks when a draft becomes reusable context. Import a `.docx` to start a new draft, and export the current editor as Markdown or Word.
+The Learning notebook, formerly Co-Writer, organizes your own writing into pages, subpages, and blocks within the active workspace. Import Word documents, arrange a page tree, and insert original records from Favorites as evidence. Pages keep their save status visible and export as Markdown or Word; interactive content becomes static in Word.
<div align="center">
-<img src="assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Co-Writer editor with live preview" width="900">
+<img src="assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
-Its defining idea is **surgical editing**: select a span and ask DeepTutor to rewrite, expand, or shorten it. Choose the edit model; it can use a knowledge base or web evidence and keeps a trace of its tool calls. If the draft has not changed while it works, the result replaces the selected text directly and remains reversible with **Undo**.
+Discuss a passage or block with **Dito**: ask for an explanation, example, rewrite, or practice question. Conversations remain attached to the relevant page and line. Review proposed changes before accepting them, or insert an answer below the line and keep working. Favorites preserve source records; the notebook is where you build your own understanding.
</details>
@@ -807,17 +807,17 @@ Its defining idea is **surgical editing**: select a span and ask DeepTutor to re
<summary><b>📖 Book — Living Books from Your Materials</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/book/00-book_overview.png" alt="DeepTutor book library" width="900">
+<img src="assets/figs/web-dev/books.png" alt="DeepTutor book library" width="900">
</div>
Book turns selected sources into an interactive **living book** — not a static PDF, but a reading environment built from typed blocks. A book can start from knowledge bases, notebooks, question banks, or chat history; the creation flow proposes a chapter outline before content is generated, so you review the shape instead of accepting a blind one-shot output.
<p align="center">
-<img src="assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Book quiz block" width="31%">
+<img src="assets/figs/web-dev/book-quiz.png" alt="Book quiz block" width="31%">
&nbsp;
-<img src="assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Book Manim animation block" width="31%">
+<img src="assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Book interactive widget block" width="31%">
+<img src="assets/figs/web-dev/book-widget.png" alt="Book interactive widget block" width="31%">
</p>
Each chapter compiles into editable typed blocks — text, callouts, quizzes, flash cards, timelines, code, figures, interactive HTML, animations, concept graphs, deep dives, and user notes — with its own Page Chat. Insert, move, regenerate, rewrite, or switch a block type; selected passages enter a reviewable learning-capture inbox. Progress, bookmarks, quiz attempts, captures, and Page Chat stay private per reader even when an admin book is shared read-only or for collaborative editing; shared deletion stays admin-only. Any book exports to Markdown, long compiles pause and resume, and `deeptutor book health` / `refresh-fingerprints` flag source drift.
@@ -828,13 +828,13 @@ Each chapter compiles into editable typed blocks — text, callouts, quizzes, fl
<summary><b>📚 Knowledge Center — Multi-Engine RAG Libraries</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor Knowledge Center" width="900">
+<img src="assets/figs/web-dev/knowledge.png" alt="DeepTutor Knowledge Center" width="900">
</div>
Knowledge bases are the document collections behind RAG — they ground Chat turns, Co-Writer edits, Book generation, and Partner conversations. What's distinctive is a **choice of retrieval engines**: **LlamaIndex** (the default, hybrid vector + BM25 with optional cross-encoder reranking and exact-flat or HNSW FAISS indexes), **PageIndex** (reasoning retrieval with page-level citations, hosted or self-hosted OSS), **GraphRAG** and **LightRAG** (knowledge-graph retrieval), **LightRAG Server** (retrieval offloaded to an external LightRAG instance you connect over HTTP), **WeKnora** (retrieval from a knowledge base in your self-hosted deployment, without a local index or document copy), **Tencent IMA** (a library you curate in IMA — searched, browsed, and written back to over its OpenAPI), **MarginNote 4** (your MN4 study data — documents, excerpts, mind-map cards and the links between them — pushed in by the app's Add-on and navigated with dedicated tools), **Kiwix** (a searchable ZIM archive served over HTTP without local indexing), or a linked **Obsidian** vault the tutor reads and writes in place. Each KB is bound to one engine.
<div align="center">
-<img src="assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Create a knowledge base" width="900">
+<img src="assets/figs/web-dev/knowledge-create.png" alt="Create a knowledge base" width="900">
</div>
Migrating an existing Obsidian, Hermes, or Markdown library? See [Knowledge migration guide](./docs-for-user/KNOWLEDGE_MIGRATION.md) for connected-vault and indexed-copy paths.
@@ -854,16 +854,16 @@ Native LightRAG queries and incremental indexing require the embedding configura
</details>
<details>
-<summary><b>🌐 Learning Space — Skills, Personas, and Reusable Context</b></summary>
+<summary><b>🌐 Resources & Personalization — Materials and Reusable Assistance</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="DeepTutor Learning Space hub" width="900">
+<img src="assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
**Resources** groups Chat History, **Favorites** with movable records and Markdown export, the **Learning journal**, Knowledge Center, and a question bank with answers and explanations. Start **Practice** from a question-bank selection or **Learning → Practice** for review sessions, mistake tracking, and scheduled repetition. The separate **Personalization** page holds personas, skills (`SKILL.md` playbooks), one-click **MCP Services**, and **CLI Apps** from the [CLI-Anything](https://github.com/HKUDS/CLI-Anything) catalog, each with an on-demand usage guide. **Learning** groups books, mastery paths, reading collections, and their tutor conversations; each asset is offered only in the workflows that support it.
<div align="center">
-<img src="assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Import skills from EduHub" width="900">
+<img src="assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
You don't have to write every skill yourself — **Import from EduHub** browses the community catalog and downloads a skill straight into your library through a security gate (see [Ecosystem](#-ecosystem--eduhub--the-skills-community)).
@@ -874,13 +874,13 @@ You don't have to write every skill yourself — **Import from EduHub** browses
<summary><b>🧠 Memory — Inspectable Personalization</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/memory/00-overview.png" alt="DeepTutor memory overview" width="900">
+<img src="assets/figs/web-dev/memory.png" alt="DeepTutor memory overview" width="900">
</div>
Memory is a file-backed, three-layer system you can read, curate, and audit — deliberately *not* a hidden vector store. **L1** is the workspace mirror plus an append-only event trace (`trace/<surface>/<date>.jsonl`); **L2** is per-surface curated facts (`L2/<surface>.md`) with references to L1 entities; **L3** is cross-surface synthesis (`L3/<profile|recent|scope|preferences>.md`) that records its contributing L2 surfaces.
<div align="center">
-<img src="assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="DeepTutor memory graph" width="900">
+<img src="assets/figs/web-dev/memory-graph.png" alt="DeepTutor memory graph" width="900">
</div>
The Memory Graph shows the whole pyramid — L3 synthesis at the centre, L2 in the middle ring, L1 traces on the outside — with exact L2 → L1 evidence edges and L3 → contributing-surface links. Memory is tracked across `chat`, `notebook`, `quiz`, `kb`, `book`, partner, and `cowriter` surfaces; the consolidator's Update / Audit / Dedup budgets are tuned in **Settings → Memory**.
@@ -891,7 +891,7 @@ The Memory Graph shows the whole pyramid — L3 synthesis at the centre, L2 in t
<summary><b>⚙️ Settings — One Control Plane</b></summary>
<div align="center">
-<img src="assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="DeepTutor settings hub" width="900">
+<img src="assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings is the operational control plane, opening on **General** for interface and model output language. Its searchable navigator links to independent pages: **Personal** covers Workspaces, Data migration, Appearance, and Usage statistics; **Learning & conversation** covers starting points, attachments, Video Learning, learner and guardian controls, Learning progress, and Memory; **Models & services** covers Providers, Language models, Task models, Embedding, Search, Voice, and Multimodal generation; **Features & integrations** covers tools, capability parameters, Partners & agents, and Knowledge & documents. **System** holds Network, Runtime status, and About; **Archived chats** lets you search, restore, or permanently delete archived conversations. Runtime status contains backend health, resident memory, and the **Readiness** matrix grading capability blockers, warnings, and suggestions. Workspaces keeps topic files and learning state separate, with verified migration and export under Data migration. A **provider** holds a vendor's address and credential for reuse by its service models; the model pages choose saved providers and configure model names and capabilities. **Task models** pin a small, fast model for background work — naming conversations and writing starting points — and resolve to the active default when empty. Voice groups speech synthesis and transcription; Multimodal generation groups image and video models. Partners & agents configures local harnesses and a remote Hermes gateway.
@@ -904,7 +904,7 @@ Settings is the operational control plane, opening on **General** for interface
**Video Learning** under Settings → Learning & conversation configures YouTube captions and Invidious access for Reading. To use Invidious, set its administrator-managed backend API origin (for example `http://127.0.0.1:3000`) and browser-accessible public origin, test the connection, select Invidious, and save. **Browse Invidious** in Reading's add-material dialog searches videos and accesses connected subscriptions and playlists. YouTube playback uses the official privacy-enhanced player; missing captions remain visible and limit the tutor's evidence without blocking native playback. In a source checkout, run `python scripts/install_extras.py video-learning` for the default YouTube caption loader. Existing Watching links migrate into Reading with conversation history, compatible transcripts, notes, and progress preserved; new timestamp notes are Reading annotations. Bilibili uses its own playback and caption path.
<div align="center">
-<img src="assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="DeepTutor appearance settings and themes" width="900">
+<img src="assets/figs/web-dev/appearance.png" alt="DeepTutor appearance settings and themes" width="900">
</div>
Most sections use a draft-and-apply flow, so you can test a provider before committing it. You can also just ask in Chat: the assistant reads the current configuration, applies a change, and says whether it needs a restart or a re-index — probing a new model before it commits, so it cannot switch itself onto something unreachable. API keys never pass through the model, which opens the matching form for you instead. Four themes ship in the box — Default, Cream, Dark, and Glass. Project-root `.env` files are intentionally ignored; runtime configuration lives under `data/user/settings/*.json` unless `DEEPTUTOR_HOME` or `deeptutor start --home` points the app elsewhere.
diff --git a/assets/README/README_AR.md b/assets/README/README_AR.md
index 9d70577a6..df06918b2 100644
--- a/assets/README/README_AR.md
+++ b/assets/README/README_AR.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="شعار DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: تدريس شخصي مدى الحياة
@@ -422,16 +422,15 @@ deeptutor config show
إذا فقدت إجابة قيداً سابقاً، أو استشهدت بدليل ضعيف، أو خالفت المادة المحددة، فاجمع بيانات التشخيص في [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) قبل فتح مشكلة.
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="الصفحة الرئيسية لـ DeepTutor — مساحة عمل Chat مع كل الأسطح في الشريط الجانبي" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **حالة لقطات الشاشة:** الصورة العامة محدثة لـ v1.6.5. لقطات الواجهات أدناه لا تزال مراجع من v1.4.6 أثناء تحديثها. استخدمها لفهم سير العمل، لا كملاحة دقيقة للواجهة الحالية.
<details>
<summary><b>🏗️ معمارية النظام</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="معمارية نظام DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="معمارية نظام DeepTutor" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ deeptutor config show
Chat هي القدرة الافتراضية والمكان الذي يبدأ فيه معظم العمل. يمكن لخيط واحد أن يتحدث عادياً، ويستدعي الأدوات، ويرتكز على قواعد المعرفة المحددة، ويقرأ المرفقات، ويولّد الصور، ويستشير الوكلاء الفرعيين، ويكتب سجلات دفتر الملاحظات، ويستمر بنفس السياق عبر الأدوار.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="مساحة عمل محادثة DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="مساحة عمل محادثة DeepTutor" width="900">
</div>
الحلقة بسيطة عمداً: يفكر النموذج في جولات، ويستدعي الأدوات عند الحاجة، ويلاحظ النتائج، وينتهي برسالة خالية من الأدوات. `ask_user` خاص — بدلاً من التخمين، يمكن للوكيل إيقاف الدور مؤقتاً، وطرح سؤال توضيحي منظَّم، والاستئناف بمجرد إجابتك.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="حلقة وكيل محادثة DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="حلقة وكيل محادثة DeepTutor" width="900">
</div>
الأدوات القابلة للتبديل من قِبَل المستخدم هي `brainstorm` و`web_search` و`paper_search` و`zotero_search` و`reason` و`geogebra_analysis` — بالإضافة إلى `imagegen` و`videogen` بمجرد تهيئة نموذج التوليد المطابق. الأدوات السياقية مثل `rag` و`kb_files` و`knowledge_frontier` و`read_source` و`read_memory` و`write_memory` و`read_skill` و`load_tools` و`exec` و`web_fetch` و`ask_user` و`list_notebook` و`write_note` و`question_bank` و`github` و`consult_subagent` و`workspace_list` و`workspace_read` و`workspace_search` و`workspace_present` و`workspace_export` تُثبَّت تلقائياً عندما يكون للدور السياق الصحيح.
@@ -463,7 +462,7 @@ Chat هي القدرة الافتراضية والمكان الذي يبدأ ف
<summary><b>🤝 Partner — رفاق دائمون على نفس الدماغ</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="مساحة عمل شركاء DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="مساحة عمل شركاء DeepTutor" width="900">
</div>
الشركاء هم رفاق دائمون بروحهم الخاصة وسياسة النموذج ومكتبتهم وذاكرتهم وقنواتهم. إنهم ليسوا محرك بوت منفصلاً: كل رسالة ويب أو IM واردة تصبح دوراً عادياً لـ `ChatOrchestrator` داخل مساحة عمل محدودة بنطاق الشريك. الشريك هو "محادثة لها شخصية ورقم هاتف".
@@ -475,7 +474,7 @@ Chat هي القدرة الافتراضية والمكان الذي يبدأ ف
لكل شريك `SOUL.md` واختيار نموذج وقنوات وسياسة أدوات ومكتبة مخصصة. تنسخ مكتبته قواعد المعرفة والمهارات ودفاتر الملاحظات إلى `data/partners/<id>/workspace/`، أو تبقى مرتبطة بملفات مساحة عمل موجودة ومواردها؛ وتظل هوية الشريك ومحادثاته وذاكرة Partner منفصلة. يحتفظ المستخدمون غير المشرفين الذين تمت مصادقتهم بجلسات Partner وذاكرة علاقة خاصة، بينما يقرأ Partner ذاكرتهم الشخصية للقراءة فقط؛ وتستخدم حركة مرور المشرفين والمجموعات وغير المرتبطة نطاق Partner المشترك.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="إعداد قناة IM لكل شريك" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="إعداد قناة IM لكل شريك" width="900">
</div>
طبقة القناة مدفوعة بالمخطط ويمكنها الاتصال بمنصات IM مثل Feishu وTelegram وSlack وDiscord وDingTalk وQQ/NapCat وWeCom وWhatsApp وZulip وMattermost وMatrix وMochat وMicrosoft Teams بناءً على الإضافات المثبتة والبيانات الاعتمادية المهيأة. يمكن أيضاً توصيل الشريك كوكيل فرعي واستشارته من دور محادثة عادي — راجع **My Agents** أدناه.
@@ -488,7 +487,7 @@ Chat هي القدرة الافتراضية والمكان الذي يبدأ ف
<summary><b>🧑‍🚀 My Agents — استشارة واستيراد الوكلاء الآخرين</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="مساحة عمل My Agents في DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="مساحة عمل My Agents في DeepTutor" width="900">
</div>
يحوّل My Agents الوكلاء الآخرين إلى سياق لـ DeepTutor، ويقوم بشيئين متمايزين. **توصيل وكيل مباشر** — Claude Code أو Codex أو Grok CLI أو Antigravity أو Kimi أو opencode أو MiMo Code أو Hermes Agent أو OpenClaw أو DeepSeek Harness على جهازك، أو بوابة Hermes بعيدة، أو أحد Partners لديك — واستشارته من داخل دور محادثة: DeepTutor *يشغّل* الوكيل الآخر فعلاً ويبث عمله إلى لوحة Activity عبر أداة `consult_subagent`. اختره وحدّد له الحد الأقصى للجولات باستخدام شريحة Agent، أو صفِّ قائمة الوكلاء المتصلين نفسها باستخدام `@`؛ ويبقى اختيارك مرتبطاً بالجلسة.
@@ -500,7 +499,7 @@ Chat هي القدرة الافتراضية والمكان الذي يبدأ ف
يستخدم Grok مصادقته وتخزين جلسته الخاصين؛ ولا ينسخ DeepTutor بيانات اعتماده. تستأنف الاستشارات اللاحقة جلسة الاتصال نفسها في دليل العمل نفسه. يُبث النص ونشاط الأدوات مباشرة؛ وتُحذَف حمولات التفكير الخاصة. تُعطَّل ذاكرة Grok عبر الجلسات افتراضياً. يدعم هذا الموصِّل الأسئلة النصية وأدوات CLI، لا إعادة توجيه الصور أو استيراد محادثات Grok السابقة. في Docker، ثبّت Grok وصادِق عليه داخل حاوية الخلفية؛ فـ CLI المثبَّت فقط على جهاز المتصفح لا يمكن الوصول إليه.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="استشارة وكيل Claude Code الفرعي مباشرةً" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**استيراد المحادثات السابقة** — أحضر تاريخ ChatGPT وClaude Code وCodex الموجود لديك كمحادثات قابلة للبحث والاستئناف. اختر ملف `conversations.json` من تصدير بيانات ChatGPT رسمي لاستيراد لقطة آمنة ومتكافئة القوة (idempotent)، أو اختر تاريخ Claude حسب المشروع / دليل العمل، أو اختر تاريخ Codex حسب تاريخ التقويم. يبقى الوكلاء المستندون إلى مجلد قابلين للتحديث بحيث يمكن للنطاق المحدد أن يسحب محادثات جديدة. ارجع إلى إحداها من دور Chat عبر `+` ← My Agents، وسيقرأها DeepTutor كنصوص محادثة لطرف ثالث — تبقى *محادثتهم*، وليس صوت DeepTutor الخاص.
@@ -511,13 +510,13 @@ Chat هي القدرة الافتراضية والمكان الذي يبدأ ف
<summary><b>✍️ Co-Writer — صياغة Markdown واعية بالتحديد</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="مساحة عمل Co-Writer في DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقارير والدروس التعليمية والملاحظات والقطع التعليمية الطويلة. تحفظ المستندات تلقائياً وتُظهر معاينة مباشرة (رياضيات KaTeX وأسوار الرسم البياني)، ويمكن حفظها مرة أخرى في دفاتر الملاحظات عندما تصبح المسودة سياقاً قابلاً لإعادة الاستخدام. استورد ملف `.docx` لبدء مسودة جديدة، وصَدِّر المحرر الحالي كـ Markdown أو Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="محرر Co-Writer مع معاينة مباشرة" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
الفكرة المحورية هي **التحرير الجراحي**: حدد نطاقاً واطلب من DeepTutor إعادة كتابته أو توسيعه أو تقصيره. اختر نموذج التحرير؛ ويمكنه استخدام قاعدة معرفة أو أدلة من الويب، ويحتفظ بأثر استدعاءات أدواته. وإذا لم تتغير المسودة أثناء عمله، تستبدل النتيجة النص المحدد مباشرةً وتظل قابلة للعكس باستخدام **Undo**.
@@ -528,17 +527,17 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
<summary><b>📖 Book — كتب حية من موادك</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="مكتبة كتب DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="مكتبة كتب DeepTutor" width="900">
</div>
يحوّل Book المصادر المحددة إلى **كتاب حي** تفاعلي — ليس PDF ثابتاً، بل بيئة قراءة مبنية من كتل مكتوبة. يمكن أن يبدأ الكتاب من قواعد المعرفة أو دفاتر الملاحظات أو بنوك الأسئلة أو تاريخ المحادثة؛ يقترح تدفق الإنشاء هيكل فصل قبل توليد المحتوى، لذا تراجع الشكل بدلاً من قبول مخرجات عشوائية.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="كتلة اختبار في الكتاب" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="كتلة اختبار في الكتاب" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="كتلة رسوم متحركة Manim في الكتاب" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="كتلة ودجت تفاعلية في الكتاب" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="كتلة ودجت تفاعلية في الكتاب" width="31%">
</p>
يُجمِّع كل فصل إلى كتل ذات أنواع محددة وقابلة للتحرير — نصوص وتنبيهات واختبارات وبطاقات فلاش وجداول زمنية ورمز وأشكال وHTML تفاعلية ورسوم متحركة وأشكال مفاهيم وغوص عميق وملاحظات مستخدم — وله Page Chat الخاصة به. أدرج كتلة أو حرّكها أو أعد توليدها أو كتابتها أو غيّر نوعها؛ وتدخل المقاطع المحددة إلى صندوق وارد لمقتطفات التعلّم يمكن مراجعته. يبقى التقدّم والإشارات المرجعية ومحاولات الاختبار ومقتطفات التعلّم وPage Chat خاصاً بكل قارئ، حتى عندما يشارك المشرف كتاباً للقراءة فقط أو للتحرير التعاوني؛ ويظل حذف الكتب المشتركة مقصوراً على المشرف. يمكن تصدير أي كتاب إلى Markdown، وتتوقف عمليات التجميع الطويلة مؤقتاً وتُستأنف، ويكشف `deeptutor book health` / `refresh-fingerprints` عن انجراف المصادر.
@@ -549,13 +548,13 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
<summary><b>📚 مركز المعرفة — مكتبات RAG متعددة المحركات</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="مركز المعرفة في DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="مركز المعرفة في DeepTutor" width="900">
</div>
قواعد المعرفة هي مجموعات المستندات وراء RAG — إنها ترسّخ أدوار Chat وتحرير Co-Writer وتوليد Book ومحادثات Partner. ما يميزها هو **اختيار محرك الاسترجاع**: **LlamaIndex** (الافتراضي، مزيج من المتجهات + BM25 مع إعادة ترتيب اختيارية بمرمّز متقاطع وفهارس FAISS من نوع exact-flat أو HNSW)، **PageIndex** (استرجاع تفكيري مع استشهادات على مستوى الصفحة، مستضاف أو مفتوح المصدر ذاتي الاستضافة)، **GraphRAG** و**LightRAG** (استرجاع قائم على الرسم البياني المعرفي)، **LightRAG Server** (استرجاع مُحال إلى نسخة LightRAG خارجية تتصل بها عبر HTTP)، **WeKnora** (استرجاع من قاعدة معرفة في نشرك ذاتي الاستضافة، بلا فهرس محلي أو نسخة من المستند)، **Tencent IMA** (مكتبة تنظّمها ضمن IMA — يُبحث فيها ويُتصفَّح ويُكتَب إليها عبر OpenAPI الخاصة بها)، **MarginNote 4** (بيانات دراستك في MN4 — المستندات والمقتطفات وبطاقات الخريطة الذهنية والروابط بينها — التي تدفعها إضافة (Add-on) التطبيق ويتم التنقل فيها بأدوات مخصصة)، **Kiwix** (أرشيف ZIM قابل للبحث يُقدَّم عبر HTTP دون فهرسة محلية)، أو مخزن **Obsidian** مرتبط يقرأ المدرس ويكتب فيه في مكانه. كل قاعدة معرفة مرتبطة بمحرك واحد.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="إنشاء قاعدة معرفة" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="إنشاء قاعدة معرفة" width="900">
</div>
هل تنقل مكتبة Obsidian أو Hermes أو Markdown موجودة؟ راجع [دليل نقل المعرفة](../../docs-for-user/KNOWLEDGE_MIGRATION.md) لمساري المخزن المتصل والنسخة المفهرسة.
@@ -578,13 +577,13 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
<summary><b>🌐 فضاء التعلم — المهارات والشخصيات والسياق القابل لإعادة الاستخدام</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="مركز فضاء التعلم في DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
فضاء التعلم هو طبقة المكتبة والتنظيم والتخصيص. تضم **المحادثات والمواد** سجل Chat ودفاتر الملاحظات بسجلات قابلة للنقل وتصدير إلى Markdown، وبنك أسئلة مع الإجابات والشروح. ابدأ **التدريب** من مجموعة أسئلة محددة في بنك الأسئلة أو من التعلم المخصص لجلسات المراجعة وتتبع الأخطاء والتكرار المجدول. أما **التخصيص** فيضم الشخصيات والمهارات (أدلة `SKILL.md`) و**خدمات MCP** التي تُثبَّت بنقرة واحدة و**تطبيقات CLI** من كتالوج [CLI-Anything](https://github.com/HKUDS/CLI-Anything)، ولكل تطبيق دليل استخدام يُحمَّل عند الطلب. وتجمع مساحة **دوراتي** المنفصلة محادثات المواد ومحادثات المدرّسين؛ ولا يُتاح كل أصل إلا في سير العمل التي تدعمه.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="استيراد مهارات من EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
لا يجب عليك كتابة كل مهارة بنفسك — **الاستيراد من EduHub** يتصفح الكتالوج المجتمعي ويُنزّل المهارة مباشرةً إلى مكتبتك من خلال بوابة أمان (راجع [النظام البيئي](#-النظام-البيئي--eduhub-ومجتمع-المهارات)).
@@ -595,13 +594,13 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
<summary><b>🧠 Memory — تخصيص قابل للتدقيق</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="نظرة عامة على ذاكرة DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="نظرة عامة على ذاكرة DeepTutor" width="900">
</div>
الذاكرة نظام ثلاثي الطبقات مدعوم بالملفات يمكنك قراءته وتنظيمه ومراجعته — وهو عمداً *ليس* مخزناً مخفياً للمتجهات. **L1** هو مرآة مساحة العمل بالإضافة إلى آثار أحداث تراكمية فقط (`trace/<surface>/<date>.jsonl`)؛ **L2** هو حقائق منظَّمة لكل سطح (`L2/<surface>.md`) مع مراجع إلى كيانات L1؛ و**L3** هو تركيب عبر الأسطح (`L3/<profile|recent|scope|preferences>.md`) يسجل أسطح L2 المساهمة فيه.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="رسم بياني لذاكرة DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="رسم بياني لذاكرة DeepTutor" width="900">
</div>
يُظهر Memory Graph الهرم بأكمله — تركيب L3 في المركز وL2 في الحلقة الوسطى وآثار L1 في الخارج — مع حواف أدلة دقيقة تربط حقائق L2 بأدلة L1، وروابط تصل تركيب L3 بالأسطح المساهمة. تُتتبع الذاكرة عبر أسطح `chat` و`notebook` و`quiz` و`kb` و`book` والشريك و`cowriter`؛ وتُضبط ميزانيات تحديث الموحّد / تدقيقه / إلغاء تكراره في **الإعدادات ← الذاكرة**.
@@ -612,7 +611,7 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
<summary><b>⚙️ الإعدادات — لوحة تحكم واحدة</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="مركز إعدادات DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
الإعدادات هي لوحة التحكم التشغيلية، وتُفتح على صفحة **عام** لضبط لغة الواجهة ومخرجات النموذج. يربط شريط التنقل القابل للبحث صفحات مستقلة: تضم **شخصي** مساحات العمل ونقل البيانات والمظهر وإحصاءات الاستخدام؛ وتضم **التعلم والمحادثة** نقاط الانطلاق والمرفقات وVideo Learning وعناصر تحكم المتعلم وولي الأمر وتقدّم التعلّم والذاكرة؛ وتضم **النماذج والخدمات** المزودين ونماذج اللغة ونماذج المهام والتضمين والبحث والصوت والتوليد متعدد الوسائط؛ وتضم **الميزات والتكاملات** الأدوات ومعاملات القدرات والشركاء والوكلاء والمعرفة والمستندات. يضم **النظام** الشبكة وحالة التشغيل وحول؛ وتتيح **المحادثات المؤرشفة** البحث في المحادثات المؤرشفة واستعادتها أو حذفها نهائياً. تحتوي حالة التشغيل على سلامة الخلفية والذاكرة المقيمة ومصفوفة **جاهزية** (Readiness) التي تقيّم عوائق القدرات وتحذيراتها واقتراحاتها. تفصل مساحات العمل ملفات المواضيع وحالة التعلم، مع نقل موثَّق وتصدير ضمن نقل البيانات. يحتفظ **المزود** بعنوان مقدم الخدمة وبيانات اعتماده لتعيد نماذج خدماته استخدامها؛ وتختار صفحات النماذج مزودين محفوظين وتضبط أسماء النماذج وقدراتها. تُثبّت **نماذج المهام** نموذجاً صغيراً وسريعاً للأعمال الخلفية — تسمية المحادثات وكتابة نقاط الانطلاق — وتستخدم النموذج الافتراضي النشط عند تركها فارغة. يجمع الصوت توليد الكلام وتفريغه؛ ويجمع التوليد متعدد الوسائط نماذج الصور والفيديو. تضبط صفحة الشركاء والوكلاء المُشغِّلات المحلية وبوابة Hermes بعيدة.
@@ -625,7 +624,7 @@ Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقا
**Video Learning** ضمن الإعدادات ← التعلم والمحادثة يهيّئ ترجمات YouTube والوصول إلى Invidious لاستخدامهما في Reading. لاستخدام Invidious، اضبط أصل API الخلفية الذي يديره المشرف (مثلاً `http://127.0.0.1:3000`) والأصل العام الذي يمكن للمتصفح الوصول إليه، واختبر الاتصال، واختر Invidious، ثم احفظ. يبحث **تصفّح Invidious** في مربع حوار إضافة المواد في Reading عن مقاطع الفيديو ويتيح الوصول إلى الاشتراكات وقوائم التشغيل المتصلة. يستخدم تشغيل YouTube المشغّل الرسمي المعزَّز للخصوصية؛ ويظل غياب الترجمات ظاهراً ويحدّ من الأدلة المتاحة للمدرّس دون تعطيل التشغيل الأصلي. ثبّت `.[video-learning]` لاستخدام مُحمِّل ترجمات YouTube الافتراضي. تنتقل روابط Watching الموجودة إلى Reading مع الحفاظ على سجل المحادثة والنصوص المفرّغة المتوافقة والملاحظات والتقدّم؛ وتصبح الملاحظات الزمنية الجديدة تعليقات Reading التوضيحية. يستخدم Bilibili مساره الخاص للتشغيل والترجمات.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="إعدادات المظهر والثيمات في DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="إعدادات المظهر والثيمات في DeepTutor" width="900">
</div>
تستخدم معظم الأقسام تدفق صياغة-وتطبيق، لذا يمكنك اختبار مزود قبل الالتزام به. يمكنك أيضاً أن تطلب ذلك ببساطة في Chat: يقرأ المساعد التهيئة الحالية، ويطبّق التغيير، ويخبرك إن كان يحتاج إلى إعادة تشغيل أو إعادة فهرسة — مع اختبار النموذج الجديد قبل الالتزام به، بحيث لا يمكنه تبديل نفسه إلى شيء يتعذّر الوصول إليه. مفاتيح API لا تمرّ أبداً عبر النموذج، الذي يفتح لك بدلاً من ذلك الاستمارة المطابقة. تشحن أربع ثيمات في الصندوق — Default وCream وDark وGlass. ملفات `.env` في جذر المشروع تُتجاهل عمداً؛ تعيش تهيئة وقت التشغيل تحت `data/user/settings/*.json` إلا إذا وجّه `DEEPTUTOR_HOME` أو `deeptutor start --home` التطبيق في مكان آخر.
diff --git a/assets/README/README_CN.md b/assets/README/README_CN.md
index a823a87c1..2156aecc4 100644
--- a/assets/README/README_CN.md
+++ b/assets/README/README_CN.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="DeepTutor 标志" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor:终身个性化辅导
@@ -422,16 +422,15 @@ DeepTutor 将已安装的代码、私有运行时主目录与可选的内容工
如果回答遗漏了先前的约束、引用了薄弱证据,或与选定素材不一致,请先按照 [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) 收集诊断信息,再提交 Issue。
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="DeepTutor 主页 — 带有侧边栏所有入口的 Chat 工作区" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **截图状态:** 总览图已更新到 v1.6.5。下方功能截图仍是 v1.4.6 参考图,正在分批替换。它们适合说明工作流,不代表当前精确导航。
<details>
<summary><b>🏗️ 系统架构</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="DeepTutor 系统架构" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="DeepTutor 系统架构" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ DeepTutor 将已安装的代码、私有运行时主目录与可选的内容工
Chat 是默认能力,也是大多数工作的起点。单个对话线程可以正常交流、调用工具、基于选定知识库进行检索、读取附件、生成图像、调用子智能体、写入笔记本记录,并在多轮对话中保持相同的上下文。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="DeepTutor 聊天工作区" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="DeepTutor 聊天工作区" width="900">
</div>
循环设计刻意保持简单:模型按轮次思考,在有用时调用工具,观察结果,最终以不调用工具的消息结束。`ask_user` 是特殊工具 — 智能体不是凭空猜测,而是可以暂停当前轮次,提出结构化的澄清问题,在你回答后恢复。
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="DeepTutor 聊天智能体循环" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="DeepTutor 聊天智能体循环" width="900">
</div>
用户可切换的工具有 `brainstorm`、`web_search`、`paper_search`、`zotero_search`、`reason` 和 `geogebra_analysis` — 配置了对应生成模型后还有 `imagegen` 和 `videogen`。上下文工具如 `rag`、`kb_files`、`knowledge_frontier`、`read_source`、`read_memory`、`write_memory`、`read_skill`、`load_tools`、`exec`、`web_fetch`、`ask_user`、`list_notebook`、`write_note`、`question_bank`、`github`、`consult_subagent`、`workspace_list`、`workspace_read`、`workspace_search`、`workspace_present` 和 `workspace_export` 会在当前轮次具备相应上下文时自动挂载。
@@ -463,7 +462,7 @@ Chat 是默认能力,也是大多数工作的起点。单个对话线程可以
<summary><b>🤝 Partner — 运行在同一大脑上的持久伴侣</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="DeepTutor Partners 工作区" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="DeepTutor Partners 工作区" width="900">
</div>
Partners 是拥有独立灵魂、模型策略、知识库、记忆和渠道的持久伴侣。它们不是独立的机器人引擎:每条入站的 Web 或 IM 消息都会成为在 Partner 作用域工作区内的一次普通 `ChatOrchestrator` 对话轮次。Partner 就是"一个有个性和电话号码的聊天"。
@@ -475,7 +474,7 @@ Partners 是拥有独立灵魂、模型策略、知识库、记忆和渠道的
每个 Partner 拥有 `SOUL.md`、模型选择、渠道、工具策略和分配的知识库。其资源库可以将知识库、技能和笔记本复制到 `data/partners/<id>/workspace/`,也可以保持与已有工作区的文件和资源链接;灵魂、对话和 Partner 记忆仍保持独立。经过认证的非管理员用户拥有私有的 Partner 会话和关系记忆,而 Partner 只读访问其个人记忆;管理员、群组和未绑定流量则使用共享的 Partner 作用域。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="每个 Partner 的 IM 渠道配置" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="每个 Partner 的 IM 渠道配置" width="900">
</div>
渠道层基于 Schema 驱动,根据已安装的额外依赖和配置的凭证,可连接飞书、Telegram、Slack、Discord、钉钉、QQ/NapCat、企业微信、WhatsApp、Zulip、Mattermost、Matrix、Mochat 和 Microsoft Teams 等 IM 平台。Partner 也可以作为子智能体连接,并从普通聊天轮次中调用 — 详见下方的**我的智能体**。
@@ -488,7 +487,7 @@ Partners 是拥有独立灵魂、模型策略、知识库、记忆和渠道的
<summary><b>🧑‍🚀 我的智能体 — 调用与导入其他智能体</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="DeepTutor 我的智能体工作区" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="DeepTutor 我的智能体工作区" width="900">
</div>
"我的智能体"将其他智能体转化为 DeepTutor 的上下文,具备两种不同的功能。**连接实时智能体** — 连接你机器上的 Claude Code、Codex、Grok CLI、Antigravity、Kimi、opencode、MiMo Code、Hermes Agent、OpenClaw 或 DeepSeek Harness、远程 Hermes 网关,或你的某个 Partner,在聊天轮次中调用它:DeepTutor 实际上会*运行*另一个智能体,并通过 `consult_subagent` 工具将其工作流式传输到 Activity 面板。使用 Agent 芯片选择智能体及其轮数上限,或通过 `@` 筛选同一份已连接智能体列表;所选配置会随会话保留。
@@ -500,7 +499,7 @@ Partners 是拥有独立灵魂、模型策略、知识库、记忆和渠道的
Grok 使用自己的认证和会话存储;DeepTutor 不会复制其凭证。后续调用会在同一工作目录中恢复该连接的会话。文本与工具活动会实时流式呈现;私密思考内容会被省略。跨会话的 Grok 记忆默认关闭。此连接器支持文本问答和 CLI 工具,不支持转发图片或导入 Grok 过往对话。在 Docker 中,请在后端容器内安装并完成 Grok 的登录认证;只安装在浏览器所在机器上的 CLI 是无法访问的。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="实时调用 Claude Code 子智能体" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**导入历史对话** — 将已有的 ChatGPT、Claude Code 和 Codex 历史记录作为可搜索、可续聊的对话导入。选择官方 ChatGPT 数据导出中的 `conversations.json`,即可完成一次安全、幂等的快照式导入;Claude 历史按项目 / 工作目录选择,Codex 历史按日历日期选择。基于文件夹的智能体仍可刷新,让其所选范围拉取新对话。在 Chat 轮次中通过 `+` → 我的智能体引用其中一段对话,DeepTutor 会将其作为第三方对话记录读取 — 它始终是*对方的*对话,而不是 DeepTutor 自己的口吻。
@@ -511,13 +510,13 @@ Grok 使用自己的认证和会话存储;DeepTutor 不会复制其凭证。
<summary><b>✍️ Co-Writer — 感知选区的 Markdown 写作台</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="DeepTutor Co-Writer 工作区" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer 是一个分屏 Markdown 工作区,适用于报告、教程、笔记和长篇学习素材的创作。文档自动保存并实时渲染预览(KaTeX 数学公式、图表围栏),草稿完成后可保存回笔记本成为可复用的上下文。可导入 `.docx` 新建草稿,也可将当前编辑器导出为 Markdown 或 Word。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Co-Writer 编辑器与实时预览" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
其核心理念是**精准编辑**:选中一段文字,让 DeepTutor 对其进行改写、扩展或缩短。你可以选择编辑模型;它可以使用知识库或网络证据,并保留工具调用追踪。如果模型工作期间草稿未发生变化,结果会直接替换所选文本,并且仍可通过 **Undo** 撤销。
@@ -528,17 +527,17 @@ Co-Writer 是一个分屏 Markdown 工作区,适用于报告、教程、笔记
<summary><b>📖 Book — 从你的素材生成活书</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="DeepTutor 书籍库" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="DeepTutor 书籍库" width="900">
</div>
Book 将选定的来源转化为交互式**活书** — 不是静态 PDF,而是由类型化块构建的阅读环境。书籍可以从知识库、笔记本、题库或聊天历史开始创建;创建流程会在内容生成前提出章节大纲,让你审查结构,而不是被动接受一次性的盲目输出。
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Book 测验块" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Book 测验块" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Book Manim 动画块" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Book 交互式组件块" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Book 交互式组件块" width="31%">
</p>
每章会编译为可编辑的类型化块 — 文本、标注、测验、闪卡、时间轴、代码、图形、交互式 HTML、动画、概念图、深度解析和用户笔记 — 并拥有自己的 Page Chat。你可以插入、移动、重新生成、改写或切换块类型;选中的段落会进入可审核的学习摘录收件箱。即使管理员将书籍共享为只读或协作编辑,每位读者的学习进度、书签、测验作答、学习摘录和 Page Chat 仍保持私有;共享书籍只能由管理员删除。任何书籍都可导出为 Markdown,长时间编译可暂停并恢复,`deeptutor book health` / `refresh-fingerprints` 会标记来源漂移。
@@ -549,13 +548,13 @@ Book 将选定的来源转化为交互式**活书** — 不是静态 PDF,而
<summary><b>📚 知识中心 — 多引擎 RAG 知识库</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor 知识中心" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="DeepTutor 知识中心" width="900">
</div>
知识库是 RAG 背后的文档集合 — 为 Chat 对话、Co-Writer 编辑、Book 生成和 Partner 对话提供依据。其独特之处在于**检索引擎的选择**:**LlamaIndex**(默认,混合向量 + BM25,可选交叉编码器重排序及 exact-flat 或 HNSW FAISS 索引)、**PageIndex**(支持页面级引用的推理检索,托管或自托管 OSS)、**GraphRAG** 和 **LightRAG**(知识图谱检索)、**LightRAG Server**(将检索卸载至你通过 HTTP 连接的外部 LightRAG 实例)、**WeKnora**(从你的自托管部署中的知识库检索,无需本地索引或复制文档)、**Tencent IMA**(在 IMA 中维护的知识库 — 通过其 OpenAPI 进行检索、浏览并写回),**MarginNote 4**(你的 MN4 学习数据 — 文档、摘录、脑图卡片及其相互链接 — 由该应用的插件推送进来,并通过专用工具进行导航)、**Kiwix**(通过 HTTP 提供的可搜索 ZIM 归档,无需本地索引),或直接在原位读写的链接 **Obsidian** vault。每个 KB 绑定到单一引擎。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="创建知识库" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="创建知识库" width="900">
</div>
要迁移现有的 Obsidian、Hermes 或 Markdown 资料库?请参阅[知识迁移指南](../../docs-for-user/KNOWLEDGE_MIGRATION.md),了解连接 vault 与索引副本两种路径。
@@ -578,13 +577,13 @@ Book 将选定的来源转化为交互式**活书** — 不是静态 PDF,而
<summary><b>🌐 学习空间 — 技能、人格预设与可复用上下文</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="DeepTutor 学习空间中心" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
学习空间是内容库、组织与个性化层。**对话与素材**包含聊天历史、支持移动记录和 Markdown 导出的笔记本,以及保存答案与解析的题库。可以从题库选区或个性化学习启动**练习**,进行复习会话、错题追踪和定期复习。**个性化**包含人格预设、技能(`SKILL.md` 剧本)、一键安装的 **MCP 服务**,以及来自 [CLI-Anything](https://github.com/HKUDS/CLI-Anything) 目录的 **CLI 应用**,每个应用的使用指南按需加载。独立的**我的课程**工作区按学科归拢对话与导师线程;每项素材只会出现在支持它的工作流中。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="从 EduHub 导入技能" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
你不必自己编写每个技能 — **从 EduHub 导入**可浏览社区目录,通过安全门将技能直接下载到你的库中(详见[生态系统](#-生态系统--eduhub-与技能社区))。
@@ -595,13 +594,13 @@ Book 将选定的来源转化为交互式**活书** — 不是静态 PDF,而
<summary><b>🧠 Memory — 可审计的个性化记忆</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="DeepTutor 记忆概览" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="DeepTutor 记忆概览" width="900">
</div>
Memory 是一个基于文件、三层结构的系统,你可以读取、整理和审计它 — 刻意设计为*非*隐藏的向量库。**L1** 是工作区镜像加仅追加的事件追踪(`trace/<surface>/<date>.jsonl`);**L2** 是按表面整理的事实(`L2/<surface>.md`),包含对 L1 实体的引用;**L3** 是跨表面的综合(`L3/<profile|recent|scope|preferences>.md`),记录参与综合的 L2 表面层。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="DeepTutor 记忆图谱" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="DeepTutor 记忆图谱" width="900">
</div>
Memory Graph 展示整个金字塔 — L3 综合位于中心,L2 在中间圆环,L1 追踪在外圈 — 并显示精确的 L2 → L1 证据边和 L3 → 参与表面层链接。Memory 在 `chat`、`notebook`、`quiz`、`kb`、`book`、partner 和 `cowriter` 表面进行追踪;整合器的更新 / 审计 / 去重预算可在 **Settings → Memory** 中调整。
@@ -612,7 +611,7 @@ Memory Graph 展示整个金字塔 — L3 综合位于中心,L2 在中间圆
<summary><b>⚙️ Settings — 统一的控制面板</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="DeepTutor 设置中心" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings 是操作控制面板,首页**通用**用于设置界面与模型输出语言。可搜索的导航栏链接到各个独立页面:**个人**包括工作区、数据迁移、外观和用量统计;**学习与对话**包括起始建议、附件、Video Learning、学习者与监护人控制、学习进度,以及 Memory;**模型与服务**包括提供商、语言模型、任务模型、嵌入、搜索、语音和多模态生成;**功能与集成**包括工具、能力参数、Partners 与智能体以及知识与文档。**系统**包括网络、运行状态和关于;**已归档对话**支持搜索、恢复或永久删除归档的对话。运行状态展示后端健康状况、常驻内存占用,以及评估能力阻断项、警告和建议的**就绪度**(Readiness)矩阵。工作区将主题文件和学习状态分开,数据迁移提供经过验证的迁移和导出。**提供商**保存厂商地址和凭证,供其服务模型复用;模型页面选择已保存的提供商,并配置模型名称和能力。**任务模型**为后台工作(如给会话命名、撰写起始建议)指定一个小而快的模型,留空时则回退到当前默认模型。语音汇集语音合成与转录;多模态生成汇集图像与视频模型。Partners 与智能体用于配置本地智能体运行框架和远程 Hermes 网关。
@@ -624,7 +623,7 @@ Settings 是操作控制面板,首页**通用**用于设置界面与模型输
Settings → Learning & conversation 下的 **Video Learning** 为 Reading 配置 YouTube 字幕和 Invidious 访问。使用 Invidious 时,请设置由管理员管理的后端 API 来源(例如 `http://127.0.0.1:3000`)和浏览器可访问的公开来源,测试连接后选择 Invidious 并保存。Reading 添加素材对话框中的 **Browse Invidious** 可搜索视频,并访问已连接的订阅和播放列表。YouTube 播放使用官方隐私增强型播放器;字幕缺失时会明确显示,并限制导师可用的证据,但不会阻止原生播放。安装 `.[video-learning]` 可使用默认的 YouTube 字幕加载器。已有 Watching 链接会迁移到 Reading,保留对话历史、兼容的转录、笔记和进度;新的时间戳笔记会保存为 Reading 批注。Bilibili 使用独立的播放和字幕路径。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="DeepTutor 外观设置与主题" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="DeepTutor 外观设置与主题" width="900">
</div>
大多数部分采用草稿-应用流程,因此你可以在提交前测试提供商配置。你也可以直接在 Chat 中开口:助手会读取当前配置、应用变更,并告知是否需要重启或重新索引 — 在提交前先探测新模型,因此它不会把自己切换到不可达的配置上。API Key 永远不会经过模型 — 它会为你打开对应的表单来输入。开箱即提供四种主题 — Default、Cream、Dark 和 Glass。项目根目录的 `.env` 文件被刻意忽略;运行时配置存储在 `data/user/settings/*.json` 下,除非 `DEEPTUTOR_HOME` 或 `deeptutor start --home` 将应用指向其他位置。
diff --git a/assets/README/README_ES.md b/assets/README/README_ES.md
index a9f9e483e..6c5157e83 100644
--- a/assets/README/README_ES.md
+++ b/assets/README/README_ES.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="Logotipo de DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: Tutoría Personalizada de Por Vida
@@ -431,16 +431,15 @@ Comienza con las superficies principales que usarás día a día: Chat, Partners
Si una respuesta pierde una restricción anterior, cita evidencia débil o contradice el material seleccionado, recopila los diagnósticos de [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) antes de abrir un issue.
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="Inicio de DeepTutor — el espacio de trabajo Chat con todas las superficies en la barra lateral" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **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. Úsalas para entender los flujos, no como navegación exacta actual.
<details>
<summary><b>🏗️ Arquitectura del sistema</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="Arquitectura del sistema DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="Arquitectura del sistema DeepTutor" width="900">
</div>
</details>
@@ -451,13 +450,13 @@ Si una respuesta pierde una restricción anterior, cita evidencia débil o contr
Chat es la capacidad predeterminada y el lugar donde comienza la mayor parte del trabajo. Un único hilo puede conversar normalmente, llamar herramientas, fundamentarse en bases de conocimiento seleccionadas, leer adjuntos, generar imágenes, consultar subagentes, escribir registros de notebook y continuar con el mismo contexto entre turnos.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="Espacio de trabajo de chat DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="Espacio de trabajo de chat DeepTutor" width="900">
</div>
El bucle es deliberadamente simple: el modelo piensa en rondas, llama herramientas cuando es útil, observa los resultados y termina con un mensaje sin herramientas. `ask_user` es especial — en lugar de adivinar, el agente puede pausar el turno, hacer una pregunta de aclaración estructurada y reanudar una vez que respondes.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="Bucle de agente de chat DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="Bucle de agente de chat DeepTutor" width="900">
</div>
Las herramientas activables por el usuario son `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason` y `geogebra_analysis` — más `imagegen` y `videogen` una vez que configures el modelo de generación correspondiente. Las herramientas contextuales como `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` y `workspace_export` se montan automáticamente cuando el turno tiene el contexto adecuado.
@@ -472,7 +471,7 @@ Inicio mantiene **Chat**, **Ask Questions**, **Quiz** y **Visualize** a un clic;
<summary><b>🤝 Partner — Compañeros Persistentes con el Mismo Cerebro</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="Espacio de trabajo de partners DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="Espacio de trabajo de partners DeepTutor" width="900">
</div>
Los Partners son compañeros persistentes con su propio alma, política de modelo, biblioteca, memoria y canales. No son un motor de bot separado: cada mensaje web o IM entrante se convierte en un turno normal de `ChatOrchestrator` dentro de un espacio de trabajo con alcance de partner. Un partner es "un chat que tiene personalidad y número de teléfono."
@@ -484,7 +483,7 @@ Los Partners son compañeros persistentes con su propio alma, política de model
Cada partner tiene un `SOUL.md`, selección de modelo, canales, política de herramientas y biblioteca asignada. Su biblioteca puede copiar bases de conocimiento, skills y notebooks en `data/partners/<id>/workspace/`, o permanecer vinculada a los archivos y recursos de un espacio de trabajo existente; la identidad, las conversaciones y la memoria del Partner siguen separadas. Los usuarios autenticados que no son administradores conservan sesiones privadas de Partner y memoria de relación, mientras el Partner lee su memoria personal en modo de solo lectura; el tráfico de administradores, grupos y usuarios no vinculados utiliza el ámbito compartido del Partner.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Configuración de canales IM por partner" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Configuración de canales IM por partner" width="900">
</div>
La capa de canales está impulsada por esquema y puede conectarse a plataformas IM como Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat y Microsoft Teams dependiendo de los extras instalados y las credenciales configuradas. Un partner también puede conectarse como subagente y ser consultado desde un turno de chat normal — consulta **Mis Agentes** a continuación.
@@ -497,7 +496,7 @@ Para una configuración más rápida, la página de canales de Partner puede cre
<summary><b>🧑‍🚀 Mis Agentes — Consultar e Importar Otros Agentes</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="Espacio de trabajo de Mis Agentes DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="Espacio de trabajo de Mis Agentes DeepTutor" width="900">
</div>
Mis Agentes convierte a otros agentes en contexto para DeepTutor y hace dos cosas distintas. **Conectar un agente en vivo** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw o DeepSeek Harness en tu máquina, una pasarela remota de Hermes o uno de tus Partners — y consultarlo desde dentro de un turno de chat: DeepTutor realmente *ejecuta* el otro agente y transmite su trabajo al panel de Activity a través de la herramienta `consult_subagent`. Selecciónalo y establece su límite de rondas con el chip Agent, o filtra la misma lista de agentes conectados con `@`; la selección permanece vinculada a la sesión.
@@ -509,7 +508,7 @@ En **Settings → Partners y agentes → Grok CLI**, deja el modelo y el esfuerz
Grok usa su propia autenticación y almacenamiento de sesión; DeepTutor no copia sus credenciales. Las consultas de seguimiento reanudan la sesión de la conexión en el mismo directorio de trabajo. El texto y la actividad de herramientas se transmiten en vivo; las cargas de pensamiento privado se omiten. La memoria de Grok entre sesiones está desactivada por defecto. Este conector admite preguntas de texto y herramientas de CLI, no el envío de imágenes ni la importación de conversaciones pasadas de Grok. En Docker, instala y autentica Grok dentro del contenedor del backend; una CLI instalada solo en la máquina del navegador no es accesible.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Consultando un subagente Claude Code en vivo" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Importar conversaciones pasadas** — trae tu historial existente de ChatGPT, Claude Code y Codex como conversaciones buscables y reanudables. Selecciona `conversations.json` de una exportación de datos oficial de ChatGPT para una importación de instantánea segura e idempotente, elige el historial de Claude por proyecto / directorio de trabajo, o elige el historial de Codex por fecha del calendario. Los agentes basados en carpetas siguen siendo actualizables, de modo que su ámbito seleccionado puede recuperar conversaciones nuevas. Referencia una desde un turno de Chat a través de `+` → Mis Agentes, y DeepTutor la lee como una transcripción de terceros — sigue siendo *su* conversación, no la voz propia de DeepTutor.
@@ -520,13 +519,13 @@ Grok usa su propia autenticación y almacenamiento de sesión; DeepTutor no copi
<summary><b>✍️ Co-Writer — Redacción Markdown con Conciencia de Selección</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="Espacio de trabajo Co-Writer DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer es un espacio de trabajo Markdown de vista dividida para informes, tutoriales, notas y artefactos de aprendizaje de formato largo. Los documentos se guardan automáticamente y renderizan una vista previa en vivo (matemáticas KaTeX, cercas de diagramas), y se pueden guardar de vuelta en cuadernos cuando un borrador se convierte en contexto reutilizable. Importa un `.docx` para empezar un borrador, y exporta el editor actual como Markdown o Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Editor Co-Writer con vista previa en vivo" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
Su idea definitoria es la **edición quirúrgica**: selecciona un fragmento y pide a DeepTutor que lo reescriba, expanda o acorte. Elige el modelo de edición; puede usar una base de conocimiento o evidencia web y conserva un rastro de sus llamadas a herramientas. Si el borrador no ha cambiado mientras trabaja, el resultado sustituye directamente el texto seleccionado y sigue siendo reversible con **Undo**.
@@ -537,17 +536,17 @@ Su idea definitoria es la **edición quirúrgica**: selecciona un fragmento y pi
<summary><b>📖 Book — Libros Vivos de tus Materiales</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="Biblioteca de libros DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="Biblioteca de libros DeepTutor" width="900">
</div>
Book convierte las fuentes seleccionadas en un **libro vivo** interactivo — no un PDF estático, sino un entorno de lectura construido a partir de bloques tipados. Un libro puede comenzar desde bases de conocimiento, cuadernos, bancos de preguntas o historial de chat; el flujo de creación propone un esquema de capítulos antes de que se genere el contenido, así revisas la estructura en lugar de aceptar una salida de un solo intento sin verla antes.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Bloque de quiz en Book" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Bloque de quiz en Book" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Bloque de animación Manim en Book" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Bloque de widget interactivo en Book" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Bloque de widget interactivo en Book" width="31%">
</p>
Cada capítulo se compila en bloques tipados editables — texto, callouts, quizzes, tarjetas flash, líneas de tiempo, código, figuras, HTML interactivo, animaciones, gráficos de conceptos, profundizaciones y notas de usuario — con su propio Page Chat. Inserta, mueve, regenera, reescribe o cambia el tipo de un bloque; los pasajes seleccionados entran en una bandeja revisable de capturas de aprendizaje. El progreso, los marcadores, los intentos de quiz, las capturas y Page Chat se mantienen privados para cada lector incluso cuando un libro del administrador se comparte en modo de solo lectura o edición colaborativa; la eliminación de libros compartidos sigue siendo exclusiva del administrador. Cualquier libro se exporta a Markdown, las compilaciones largas se pausan y reanudan, y `deeptutor book health` / `refresh-fingerprints` señalan divergencias en las fuentes.
@@ -558,13 +557,13 @@ Cada capítulo se compila en bloques tipados editables — texto, callouts, quiz
<summary><b>📚 Centro de Conocimiento — Bibliotecas RAG Multi-Motor</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="Centro de Conocimiento DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="Centro de Conocimiento DeepTutor" width="900">
</div>
Las bases de conocimiento son las colecciones de documentos detrás del RAG — fundamentan los turnos de Chat, las ediciones de Co-Writer, la generación de Book y las conversaciones de Partner. Lo que las distingue es la **elección de motores de recuperación**: **LlamaIndex** (el predeterminado, vector híbrido + BM25 con reranking opcional mediante cross-encoder e índices FAISS exact-flat o HNSW), **PageIndex** (recuperación por razonamiento con citas a nivel de página, hospedado o autoalojado OSS), **GraphRAG** y **LightRAG** (recuperación por grafo de conocimiento), **LightRAG Server** (recuperación delegada a una instancia externa de LightRAG a la que te conectas por HTTP), **WeKnora** (recuperación desde una base de conocimiento de tu despliegue autoalojado, sin índice local ni copia de documentos), **Tencent IMA** (una biblioteca que curas en IMA — consultada, explorada y con escritura de vuelta a través de su OpenAPI), **MarginNote 4** (tus datos de estudio de MN4 — documentos, extractos, tarjetas de mapa mental y los enlaces entre ellos — enviados por el Add-on de la app y navegados con herramientas dedicadas), **Kiwix** (un archivo ZIM consultable servido por HTTP sin indexación local), o un vault **Obsidian** vinculado que el tutor lee y escribe en el lugar. Cada KB está vinculada a un motor.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Crear una base de conocimiento" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="Crear una base de conocimiento" width="900">
</div>
¿Estás migrando una biblioteca existente de Obsidian, Hermes o Markdown? Consulta la [guía de migración de conocimiento](../../docs-for-user/KNOWLEDGE_MIGRATION.md) para conocer las rutas de vault conectado y copia indexada.
@@ -587,13 +586,13 @@ Las consultas nativas de LightRAG y la indexación incremental requieren la conf
<summary><b>🌐 Espacio de Aprendizaje — Skills, Personas y Contexto Reutilizable</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="Hub del Espacio de Aprendizaje DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
El Espacio de Aprendizaje es la capa de biblioteca, organización y personalización. **Conversaciones y Materiales** guarda el historial de Chat, cuadernos con registros transferibles y exportación a Markdown, y un banco de preguntas con respuestas y explicaciones. Inicia **Práctica** desde una selección del banco de preguntas o desde Aprendizaje personalizado para sesiones de repaso, seguimiento de errores y repetición programada. **Personalización** guarda personas, skills (guías `SKILL.md`), **Servicios MCP** con instalación en un clic y **Aplicaciones CLI** del catálogo [CLI-Anything](https://github.com/HKUDS/CLI-Anything), cada una con una guía de uso cargada bajo demanda. El espacio de trabajo independiente **Mis cursos** agrupa las conversaciones por materia y los hilos del tutor; cada recurso solo se ofrece en los flujos de trabajo que lo admiten.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Importar skills desde EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
No tienes que escribir cada skill tú mismo — **Importar desde EduHub** navega el catálogo comunitario y descarga una skill directamente en tu biblioteca a través de una puerta de seguridad (consulta [Ecosistema](#-ecosistema--eduhub-y-la-comunidad-de-skills)).
@@ -604,13 +603,13 @@ No tienes que escribir cada skill tú mismo — **Importar desde EduHub** navega
<summary><b>🧠 Memory — Personalización Inspectable</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="Vista general de Memory DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="Vista general de Memory DeepTutor" width="900">
</div>
Memory es un sistema de tres capas respaldado por archivos que puedes leer, curar y auditar — deliberadamente *no* un almacén de vectores oculto. **L1** es el espejo del espacio de trabajo más un rastro de eventos de solo adición (`trace/<surface>/<date>.jsonl`); **L2** son hechos curados por superficie (`L2/<surface>.md`) con referencias a entidades L1; **L3** es síntesis entre superficies (`L3/<profile|recent|scope|preferences>.md`) que registra las superficies L2 que contribuyeron a ella.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="Gráfico de memoria DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="Gráfico de memoria DeepTutor" width="900">
</div>
El Memory Graph muestra toda la pirámide — síntesis L3 en el centro, L2 en el anillo intermedio, trazas L1 en el exterior — con aristas de evidencia L2 → L1 exactas y enlaces de L3 → superficies contribuyentes. La memoria se rastrea en las superficies `chat`, `notebook`, `quiz`, `kb`, `book`, partner y `cowriter`; los presupuestos de Actualización / Auditoría / Deduplicación del consolidador se ajustan en **Settings → Memory**.
@@ -621,7 +620,7 @@ El Memory Graph muestra toda la pirámide — síntesis L3 en el centro, L2 en e
<summary><b>⚙️ Settings — Un Panel de Control</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="Hub de configuración DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings es el panel de control operativo y se abre en **General**, donde se configuran el idioma de la interfaz y el de salida del modelo. Su navegador con búsqueda enlaza páginas independientes: **Personal** incluye Espacios de trabajo, Migración de datos, Apariencia y Estadísticas de uso; **Aprendizaje y conversación** incluye sugerencias iniciales, adjuntos, Video Learning, controles de alumnos y tutores, Progreso de aprendizaje y Memory; **Modelos y servicios** incluye Proveedores, Modelos de lenguaje, Modelos de tarea, Embedding, Search, Voz y Generación multimodal; **Funciones e integraciones** incluye herramientas, parámetros de capacidades, Partners y agentes, y Conocimiento y documentos. **Sistema** reúne Red, Estado de ejecución y Acerca de; **Chats archivados** permite buscar, restaurar o eliminar permanentemente conversaciones archivadas. Estado de ejecución contiene la salud del backend, la memoria residente y la matriz de **Preparación** (Readiness), que clasifica bloqueos, advertencias y sugerencias de las capacidades. Espacios de trabajo mantiene separados los archivos de cada tema y el estado de aprendizaje, con migración y exportación verificadas en Migración de datos. Un **proveedor** guarda la dirección y credencial de un servicio para reutilizarlas con sus modelos; las páginas de modelos seleccionan proveedores guardados y configuran nombres y capacidades. Los **modelos de tarea** fijan un modelo pequeño y rápido para el trabajo en segundo plano — nombrar conversaciones y escribir sugerencias iniciales — y recurren al predeterminado activo cuando se dejan vacíos. Voz agrupa síntesis y transcripción de voz; Generación multimodal reúne modelos de imagen y vídeo. Partners y agentes configura entornos de agentes locales y una pasarela remota de Hermes.
@@ -633,7 +632,7 @@ Settings es el panel de control operativo y se abre en **General**, donde se con
**Video Learning** en Settings → Aprendizaje y conversación configura los subtítulos de YouTube y el acceso a Invidious para Reading. Para usar Invidious, establece el origen de su API de backend gestionado por el administrador (por ejemplo `http://127.0.0.1:3000`) y su origen público accesible desde el navegador, prueba la conexión, selecciona Invidious y guarda. **Browse Invidious** en el diálogo de Reading para añadir material permite buscar vídeos y acceder a las suscripciones y listas de reproducción conectadas. La reproducción de YouTube usa el reproductor oficial con privacidad mejorada; la falta de subtítulos se indica y limita la evidencia disponible para el tutor, sin bloquear la reproducción nativa. Instala `.[video-learning]` para el cargador predeterminado de subtítulos de YouTube. Los enlaces existentes de Watching se migran a Reading conservando el historial de conversaciones, las transcripciones compatibles, las notas y el progreso; las nuevas notas con marcas de tiempo son anotaciones de Reading. Bilibili usa su propia ruta de reproducción y subtítulos.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="Configuración de apariencia de DeepTutor y temas" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="Configuración de apariencia de DeepTutor y temas" width="900">
</div>
La mayoría de las secciones usan un flujo de borrador y aplicación, de modo que puedes probar un proveedor antes de confirmarlo. También puedes simplemente pedirlo en Chat: el asistente lee la configuración actual, aplica un cambio y te dice si necesita un reinicio o una reindexación — probando un modelo nuevo antes de confirmarlo, de modo que no puede cambiarse a sí mismo hacia algo inalcanzable. Las claves API nunca pasan por el modelo, que en su lugar abre el formulario correspondiente para ti. Cuatro temas se incluyen por defecto — Default, Cream, Dark y Glass. Los archivos `.env` de la raíz del proyecto se ignoran intencionalmente; la configuración de runtime vive bajo `data/user/settings/*.json` a menos que `DEEPTUTOR_HOME` o `deeptutor start --home` apunten la app en otro lugar.
diff --git a/assets/README/README_FR.md b/assets/README/README_FR.md
index d62a74961..e5922e551 100644
--- a/assets/README/README_FR.md
+++ b/assets/README/README_FR.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="Logo DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor : Tutorat Personnalisé à Vie
@@ -432,16 +432,15 @@ Commencez par les surfaces principales que vous utiliserez au quotidien : Chat,
Si une réponse perd une contrainte antérieure, cite des preuves faibles ou contredit les supports sélectionnés, rassemblez les diagnostics dans [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) avant d'ouvrir une issue.
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="Accueil DeepTutor — l'espace de travail Chat avec chaque surface dans la barre latérale" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **É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. Utilisez-les pour comprendre les parcours, pas comme navigation exacte actuelle.
<details>
<summary><b>🏗️ Architecture du système</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="Architecture du système DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="Architecture du système DeepTutor" width="900">
</div>
</details>
@@ -452,13 +451,13 @@ Si une réponse perd une contrainte antérieure, cite des preuves faibles ou con
Chat est la capacité par défaut et là où commence la plupart du travail. Un seul fil peut discuter normalement, appeler des outils, s'ancrer dans des bases de connaissances sélectionnées, lire des pièces jointes, générer des images, consulter des sous-agents, écrire des enregistrements dans le carnet et continuer avec le même contexte à travers les tours.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="Espace de travail Chat de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="Espace de travail Chat de DeepTutor" width="900">
</div>
La boucle est délibérément simple : le modèle réfléchit en rounds, appelle des outils quand c'est utile, observe les résultats et termine avec un message sans outil. `ask_user` est spécial — plutôt que de deviner, l'agent peut mettre le tour en pause, poser une question de clarification structurée, et reprendre une fois que vous répondez.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="Boucle d'agent Chat de DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="Boucle d'agent Chat de DeepTutor" width="900">
</div>
Les outils basculables par l'utilisateur sont `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason` et `geogebra_analysis` — plus `imagegen` et `videogen` une fois que vous avez configuré le modèle de génération correspondant. Les outils contextuels tels que `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` et `workspace_export` se montent automatiquement quand le tour dispose du bon contexte.
@@ -473,7 +472,7 @@ L'accueil garde **Chat**, **Ask Questions**, **Quiz** et **Visualize** accessibl
<summary><b>🤝 Partner — Compagnons Persistants sur le Même Cerveau</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="Espace de travail Partners de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="Espace de travail Partners de DeepTutor" width="900">
</div>
Les Partners sont des compagnons persistants avec leur propre âme, politique de modèle, bibliothèque, mémoire et canaux. Ce ne sont pas un moteur de bot séparé : chaque message web ou IM entrant devient un tour normal de `ChatOrchestrator` dans un espace de travail à portée partner. Un partner est « un chat qui a une personnalité et un numéro de téléphone. »
@@ -485,7 +484,7 @@ Les Partners sont des compagnons persistants avec leur propre âme, politique de
Chaque partner a un `SOUL.md`, une sélection de modèle, des canaux, une politique d'outils et une bibliothèque assignée. Sa bibliothèque copie les bases de connaissances, les compétences et les carnets dans `data/partners/<id>/workspace/`, ou reste liée aux fichiers et aux ressources d'un espace de travail existant ; l'identité soul, les conversations et la mémoire Partner restent séparées. Les utilisateurs authentifiés non administrateurs conservent des sessions Partner et une mémoire relationnelle privées, tandis que le Partner consulte leur mémoire personnelle en lecture seule ; le trafic administrateur, de groupe et non lié utilise la portée Partner partagée.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Configuration du canal IM par partner" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Configuration du canal IM par partner" width="900">
</div>
La couche de canaux est pilotée par schéma et peut se connecter à des plateformes IM telles que Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat et Microsoft Teams selon les extras installés et les identifiants configurés. Un partner peut également être connecté comme sous-agent et consulté depuis un tour de chat normal — voir **My Agents** ci-dessous.
@@ -498,7 +497,7 @@ Pour une configuration plus rapide, la page de canal Partner peut créer une app
<summary><b>🧑‍🚀 My Agents — Consulter et Importer d'Autres Agents</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="Espace de travail My Agents de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="Espace de travail My Agents de DeepTutor" width="900">
</div>
My Agents transforme d'autres agents en contexte pour DeepTutor, et fait deux choses distinctes. **Connectez un agent en direct** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw ou DeepSeek Harness sur votre machine, une passerelle Hermes distante, ou l'un de vos Partners — et consultez-le depuis l'intérieur d'un tour de chat : DeepTutor *exécute* réellement l'autre agent et diffuse son travail dans le panneau d'Activité via l'outil `consult_subagent`. Sélectionnez-le, ainsi que sa limite de rounds, avec la puce Agent, ou filtrez cette même liste d'agents connectés avec `@` ; le choix reste associé à la session.
@@ -510,7 +509,7 @@ Dans **Settings → Partners & agents → Grok CLI**, laissez le modèle et l'ef
Grok utilise sa propre authentification et son propre stockage de session ; DeepTutor ne copie pas ses identifiants. Les consultations suivantes reprennent la session de la connexion dans le même répertoire de travail. Le texte et l'activité des outils sont diffusés en direct ; les charges utiles de pensée privées sont omises. La mémoire Grok inter-sessions est désactivée par défaut. Ce connecteur prend en charge les questions textuelles et les outils CLI, pas le transfert d'images ni l'import de conversations Grok passées. Sous Docker, installez et authentifiez Grok à l'intérieur du conteneur backend ; un CLI installé uniquement sur l'ordinateur du navigateur n'est pas accessible.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Consultation d'un sous-agent Claude Code en direct" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Importez des conversations passées** — apportez votre historique ChatGPT, Claude Code et Codex existant comme des conversations consultables et reprenables. Sélectionnez `conversations.json` depuis un export officiel de données ChatGPT pour un import d'instantané sûr et idempotent, choisissez l'historique Claude par projet / répertoire de travail, ou choisissez l'historique Codex par date du calendrier. Les agents basés sur un dossier restent actualisables afin que leur portée sélectionnée puisse récupérer de nouvelles conversations. Référencez-en une depuis un tour Chat via `+` → My Agents, et DeepTutor la lit comme une transcription tierce — elle reste *leur* conversation, pas la voix propre de DeepTutor.
@@ -521,13 +520,13 @@ Grok utilise sa propre authentification et son propre stockage de session ; Deep
<summary><b>✍️ Co-Writer — Rédaction Markdown Sensible à la Sélection</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="Espace de travail Co-Writer de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer est un espace de travail Markdown à vue divisée pour les rapports, tutoriels, notes et artefacts d'apprentissage longs. Les documents se sauvegardent automatiquement et affichent un aperçu en direct (math KaTeX, clôtures de diagrammes), et peuvent être enregistrés dans des carnets quand un brouillon devient un contexte réutilisable. Importez un `.docx` pour démarrer un brouillon, et exportez l'éditeur actuel en Markdown ou Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Éditeur Co-Writer avec aperçu en direct" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
Son idée directrice est l'**édition chirurgicale** : sélectionnez une plage et demandez à DeepTutor de la réécrire, l'étendre ou la raccourcir. Choisissez le modèle d'édition ; il peut utiliser une base de connaissances ou des preuves web et conserve une trace de ses appels d'outils. Si le brouillon n'a pas changé pendant son travail, le résultat remplace directement le texte sélectionné et reste réversible avec **Undo**.
@@ -538,17 +537,17 @@ Son idée directrice est l'**édition chirurgicale** : sélectionnez une plage e
<summary><b>📖 Book — Livres Vivants depuis Vos Matériaux</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="Bibliothèque de livres DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="Bibliothèque de livres DeepTutor" width="900">
</div>
Book transforme des sources sélectionnées en un **livre vivant** interactif — pas un PDF statique, mais un environnement de lecture construit à partir de blocs typés. Un livre peut démarrer depuis des bases de connaissances, des carnets, des banques de questions ou l'historique de chat ; le flux de création propose un plan de chapitre avant que le contenu soit généré, vous pouvez donc revoir la forme au lieu d'accepter une sortie en un seul coup aveugle.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Bloc quiz du livre" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Bloc quiz du livre" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Bloc animation Manim du livre" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Bloc widget interactif du livre" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Bloc widget interactif du livre" width="31%">
</p>
Chaque chapitre se compile en blocs typés modifiables — texte, encadrés, quiz, fiches, chronologies, code, figures, HTML interactif, animations, graphes de concepts, approfondissements et notes utilisateur — et chaque page dispose de son propre Chat de Page. Insérez, déplacez, régénérez, réécrivez ou changez le type d'un bloc ; les passages sélectionnés alimentent une boîte de réception de captures d'apprentissage à valider. La progression, les signets, les tentatives de quiz, les captures et le Chat de Page restent privés pour chaque lecteur, même lorsqu'un livre administrateur est partagé en lecture seule ou en édition collaborative ; la suppression d'un livre partagé reste réservée à l'administrateur. Tout livre s'exporte en Markdown, les compilations longues se mettent en pause et reprennent, et `deeptutor book health` / `refresh-fingerprints` signalent les sources qui ont divergé.
@@ -559,13 +558,13 @@ Chaque chapitre se compile en blocs typés modifiables — texte, encadrés, qui
<summary><b>📚 Knowledge Center — Bibliothèques RAG Multi-Moteur</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="Knowledge Center de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="Knowledge Center de DeepTutor" width="900">
</div>
Les bases de connaissances sont les collections de documents derrière le RAG — elles ancrent les tours de Chat, les éditions Co-Writer, la génération de Book et les conversations Partner. Ce qui est distinctif est un **choix de moteurs de récupération** : **LlamaIndex** (par défaut, vecteur hybride + BM25 avec reranking optionnel par cross-encoder et index FAISS exact-flat ou HNSW), **PageIndex** (récupération par raisonnement avec citations au niveau de la page, hébergé ou OSS auto-hébergé), **GraphRAG** et **LightRAG** (récupération par graphe de connaissances), **LightRAG Server** (récupération déléguée à une instance LightRAG externe connectée via HTTP), **WeKnora** (récupération depuis une base de connaissances de votre déploiement auto-hébergé, sans index local ni copie des documents), **Tencent IMA** (une bibliothèque que vous constituez dans IMA — interrogée, parcourue et mise à jour via son OpenAPI), **MarginNote 4** (vos données d'étude MN4 — documents, extraits, fiches de carte mentale et les liens entre eux — poussées par l'Add-on de l'application et parcourues avec des outils dédiés), **Kiwix** (une archive ZIM interrogeable servie par HTTP sans indexation locale), ou un vault **Obsidian** lié que le tuteur lit et écrit en place. Chaque KB est liée à un moteur.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Créer une base de connaissances" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="Créer une base de connaissances" width="900">
</div>
Vous migrez une bibliothèque Obsidian, Hermes ou Markdown existante ? Consultez le [guide de migration des connaissances](../../docs-for-user/KNOWLEDGE_MIGRATION.md) pour les parcours de vault connecté et de copie indexée.
@@ -588,13 +587,13 @@ Les requêtes LightRAG natives et l'indexation incrémentielle nécessitent la c
<summary><b>🌐 Learning Space — Compétences, Personas et Contexte Réutilisable</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="Hub Learning Space de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Space est la couche de bibliothèque, d'organisation et de personnalisation. **Conversations & Matériaux** contient Chat History, les carnets avec des enregistrements déplaçables et un export Markdown, ainsi qu'une banque de questions avec réponses et explications. Lancez **Practice** depuis une sélection dans la banque de questions ou depuis Apprentissage personnalisé pour des séances de révision, le suivi des erreurs et des répétitions programmées. **Personnalisation** contient les personas, les compétences (livrets de jeu `SKILL.md`), les **Services MCP** connectables en un clic et les **Applications CLI** du catalogue [CLI-Anything](https://github.com/HKUDS/CLI-Anything), chacune avec un guide d'utilisation chargé à la demande. L'espace de travail distinct **My Courses** regroupe les conversations par matière et les fils du tuteur ; chaque ressource n'est proposée que dans les flux de travail qui la prennent en charge.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Importer des compétences depuis EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
Vous n'avez pas à écrire chaque compétence vous-même — **Importer depuis EduHub** parcourt le catalogue communautaire et télécharge une compétence directement dans votre bibliothèque via une porte de sécurité (voir [Écosystème](#-écosystème--eduhub--la-communauté-de-compétences)).
@@ -605,13 +604,13 @@ Vous n'avez pas à écrire chaque compétence vous-même — **Importer depuis E
<summary><b>🧠 Memory — Personnalisation Inspectable</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="Aperçu de la mémoire DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="Aperçu de la mémoire DeepTutor" width="900">
</div>
Memory est un système en trois couches sauvegardé sur fichier que vous pouvez lire, organiser et auditer — délibérément *pas* un store vectoriel caché. **L1** est le miroir de l'espace de travail plus une trace d'événements en ajout seul (`trace/<surface>/<date>.jsonl`) ; **L2** contient des faits organisés par surface (`L2/<surface>.md`) avec des références aux entités L1 ; **L3** est la synthèse inter-surfaces (`L3/<profile|recent|scope|preferences>.md`) qui consigne les surfaces L2 contributrices.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="Graphe de mémoire DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="Graphe de mémoire DeepTutor" width="900">
</div>
Le Memory Graph montre toute la pyramide — la synthèse L3 au centre, L2 dans l'anneau du milieu, les traces L1 à l'extérieur — avec des arêtes de preuve L2 → L1 exactes et des liens L3 → surfaces contributrices. La Memory est suivie sur les surfaces `chat`, `notebook`, `quiz`, `kb`, `book`, partner et `cowriter` ; les budgets Mise à jour / Audit / Déduplication du consolidateur sont réglés dans **Paramètres → Memory**.
@@ -622,7 +621,7 @@ Le Memory Graph montre toute la pyramide — la synthèse L3 au centre, L2 dans
<summary><b>⚙️ Settings — Un Seul Plan de Contrôle</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="Hub Settings de DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings est le plan de contrôle opérationnel et s'ouvre sur **Général**, pour la langue de l'interface et de sortie du modèle. Sa navigation avec recherche mène à des pages indépendantes : **Personnel** couvre les espaces de travail, la migration des données, l'apparence et les statistiques d'utilisation ; **Apprentissage & conversation** couvre les suggestions de démarrage, les pièces jointes, Video Learning, les contrôles des apprenants et des responsables, Progression d'apprentissage, ainsi que Memory ; **Modèles & services** couvre les fournisseurs, les modèles de langage, les modèles de tâche, Embedding, la recherche, la voix et la génération multimodale ; **Fonctionnalités & intégrations** couvre les outils, les paramètres des capacités, Partners & agents et Connaissances & documents. **Système** contient Réseau, État d'exécution et À propos ; **Conversations archivées** permet de rechercher, restaurer ou supprimer définitivement les conversations archivées. État d'exécution contient la santé du backend, la mémoire résidente et la matrice **Readiness**, qui évalue les blocages, avertissements et suggestions pour les capacités. Les espaces de travail séparent les fichiers thématiques et l'état d'apprentissage ; Migration des données propose une migration vérifiée et un export. Un **fournisseur** conserve l'adresse et les identifiants d'un prestataire pour ses modèles de service ; les pages des modèles sélectionnent des fournisseurs enregistrés et configurent les noms et capacités des modèles. Les **modèles de tâche** réservent un petit modèle rapide au travail en arrière-plan — nommer les conversations et rédiger les suggestions de démarrage — et utilisent le modèle actif par défaut si le champ est vide. Voix regroupe la synthèse vocale et la transcription ; Génération multimodale regroupe les modèles d'image et de vidéo. Partners & agents configure les harnesses locaux et une passerelle Hermes distante.
@@ -635,7 +634,7 @@ Settings est le plan de contrôle opérationnel et s'ouvre sur **Général**, po
**Video Learning** sous Paramètres → Apprentissage & conversation configure les sous-titres YouTube et l’accès à Invidious pour Reading. Pour utiliser Invidious, définissez son origine d’API backend gérée par l’administrateur (par exemple `http://127.0.0.1:3000`) et son origine publique accessible au navigateur, testez la connexion, sélectionnez Invidious, puis enregistrez. **Parcourir Invidious**, dans la boîte de dialogue d’ajout de supports de Reading, permet de rechercher des vidéos et d’accéder aux abonnements et listes de lecture connectés. La lecture YouTube utilise le lecteur officiel avec protection renforcée de la confidentialité ; l’absence de sous-titres reste visible et limite les éléments dont dispose le tuteur sans bloquer la lecture native. Installez `.[video-learning]` pour le chargeur de sous-titres YouTube par défaut. Les liens Watching existants migrent vers Reading en conservant l’historique des conversations, les transcriptions compatibles, les notes et la progression ; les nouvelles notes horodatées sont des annotations Reading. Bilibili utilise son propre parcours de lecture et de sous-titres.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="Paramètres d'apparence et thèmes DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="Paramètres d'apparence et thèmes DeepTutor" width="900">
</div>
La plupart des sections utilisent un flux brouillon-et-application, vous pouvez donc tester un fournisseur avant de vous y engager. Vous pouvez aussi simplement demander dans Chat : l'assistant lit la configuration actuelle, applique un changement, et indique s'il nécessite un redémarrage ou une réindexation — sondant un nouveau modèle avant de s'y engager, afin qu'il ne puisse jamais se basculer lui-même vers quelque chose d'inaccessible. Les clés API ne transitent jamais par le modèle, qui ouvre à la place le formulaire correspondant pour vous. Quatre thèmes sont livrés dans la boîte — Default, Cream, Dark et Glass. Les fichiers `.env` à la racine du projet sont intentionnellement ignorés ; la configuration d'exécution vit sous `data/user/settings/*.json` sauf si `DEEPTUTOR_HOME` ou `deeptutor start --home` pointe l'application ailleurs.
diff --git a/assets/README/README_HI.md b/assets/README/README_HI.md
index d027dda70..d837d8e8d 100644
--- a/assets/README/README_HI.md
+++ b/assets/README/README_HI.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="DeepTutor लोगो" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: लाइफलॉन्ग व्यक्तिगत ट्यूटरिंग
@@ -422,16 +422,15 @@ DeepTutor अपने installed code, private runtime home, और optional Con
अगर कोई answer पहले का constraint खो दे, weak evidence cite करे, या selected material से disagree करे, तो issue खोलने से पहले [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) में diagnostics collect करें।
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="DeepTutor होम — sidebar में हर surface के साथ Chat workspace" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **Screenshot स्थिति:** overview v1.6.5 के लिए current है। नीचे दी गई surface screenshots अभी v1.4.6 references हैं और versioned refresh जारी है। इन्हें workflows समझने के लिए उपयोग करें, current exact navigation के रूप में नहीं।
<details>
<summary><b>🏗️ सिस्टम आर्किटेक्चर</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="DeepTutor सिस्टम आर्किटेक्चर" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="DeepTutor सिस्टम आर्किटेक्चर" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ DeepTutor अपने installed code, private runtime home, और optional Con
Chat default capability है और जहां से अधिकांश काम शुरू होता है। एक single thread normally बात कर सकता है, tools call कर सकता है, selected knowledge bases में खुद को ground कर सकता है, attachments पढ़ सकता है, images generate कर सकता है, subagents से consult कर सकता है, notebook records लिख सकता है, और turns के पार same context के साथ जारी रह सकता है।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="DeepTutor Chat workspace" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="DeepTutor Chat workspace" width="900">
</div>
Loop जानबूझकर simple है: model rounds में सोचता है, जब उपयोगी हो tools call करता है, results observe करता है, और tool-free message के साथ finish करता है। `ask_user` special है — guess करने की बजाय, agent turn pause कर सकता है, एक structured clarifying question पूछ सकता है, और आपके जवाब देने के बाद resume कर सकता है।
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="DeepTutor Chat agent loop" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="DeepTutor Chat agent loop" width="900">
</div>
User-toggleable tools हैं `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason`, और `geogebra_analysis` — साथ ही `imagegen` और `videogen` जब आप matching generation model configure करें। Contextual tools जैसे `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present`, और `workspace_export` तब automatically mount होते हैं जब turn के पास सही context हो।
@@ -463,7 +462,7 @@ Home **Chat**, **Ask Questions**, **Quiz**, और **Visualize** को एक
<summary><b>🤝 Partner — एक ही बुद्धि पर चलने वाले स्थायी साथी</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="DeepTutor Partners workspace" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="DeepTutor Partners workspace" width="900">
</div>
Partners अपनी soul, model policy, library, memory, और channels वाले persistent companions हैं। वे एक अलग bot engine नहीं हैं: हर inbound web या IM message partner-scoped workspace के अंदर एक normal `ChatOrchestrator` turn बन जाता है। एक partner "एक chat है जिसकी personality और phone number है।"
@@ -475,7 +474,7 @@ Partners अपनी soul, model policy, library, memory, और channels व
हर partner के पास एक `SOUL.md`, model selection, channels, tool policy, और assigned library है। इसकी library knowledge bases, skills और notebooks को `data/partners/<id>/workspace/` में copy कर सकती है, या किसी existing workspace की files और resources से linked रह सकती है; soul, conversations और Partner memory अलग रहते हैं। Authenticated non-admin users private Partner sessions और relationship memory रखते हैं, जबकि Partner उनकी personal memory को read-only पढ़ता है; admin, group, और unbound traffic shared Partner scope उपयोग करते हैं।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="प्रत्येक partner के लिए per-partner IM channel configuration" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="प्रत्येक partner के लिए per-partner IM channel configuration" width="900">
</div>
Channel layer schema-driven है और installed extras और configured credentials के आधार पर Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat, और Microsoft Teams जैसे IM platforms से connect हो सकती है। एक partner को subagent के रूप में भी connect किया जा सकता है और normal chat turn से consult किया जा सकता है — नीचे **My Agents** देखें।
@@ -488,7 +487,7 @@ Channel layer schema-driven है और installed extras और configured cre
<summary><b>🧑‍🚀 My Agents — दूसरे एजेंट से सलाह लें और उन्हें इम्पोर्ट करें</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="DeepTutor My Agents workspace" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="DeepTutor My Agents workspace" width="900">
</div>
My Agents दूसरे agents को DeepTutor के लिए context बनाता है, और दो अलग काम करता है। **लाइव एजेंट connect करें** — आपकी machine पर Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw, या DeepSeek Harness, कोई remote Hermes gateway, या आपके Partners में से एक — और इसे chat turn के अंदर से consult करें: DeepTutor actually दूसरे agent को *run* करता है और इसके काम को `consult_subagent` tool के जरिए Activity panel में stream करता है। Agent chip से इसे और इसकी round limit select करें, या `@` से connected agents की उसी list को filter करें; यह selection session से जुड़ा रहता है।
@@ -500,7 +499,7 @@ My Agents दूसरे agents को DeepTutor के लिए context ब
Grok अपनी खुद की authentication और session storage उपयोग करता है; DeepTutor इसके credentials copy नहीं करता। Follow-up consults same working directory में connection के session को resume करते हैं। Text और tool activity live stream होती है; private thought payloads omit किए जाते हैं। Cross-session Grok memory default रूप से disabled है। यह connector text questions और CLI tools support करता है, image forwarding या past Grok conversations import करना नहीं। Docker में, Grok को backend container के अंदर install और authenticate करें; केवल browser की machine पर installed CLI reachable नहीं है।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Claude Code subagent को live consult करना" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**पिछली conversations import करें** — अपनी existing ChatGPT, Claude Code, और Codex history को searchable, resumable conversations के रूप में bring in करें। एक safe, idempotent snapshot import के लिए किसी official ChatGPT data export से `conversations.json` select करें, Claude history को project / working directory के अनुसार चुनें, या Codex history को calendar date के अनुसार चुनें। Folder-based agents refreshable बने रहते हैं इसलिए उनका selected scope नई conversations खींच सकता है। Chat turn से किसी एक को `+` → My Agents के जरिए reference करें, और DeepTutor इसे एक third-party transcript के रूप में पढ़ता है — यह उनकी conversation रहती है, DeepTutor की अपनी आवाज नहीं।
@@ -511,13 +510,13 @@ Grok अपनी खुद की authentication और session storage उप
<summary><b>✍️ Co-Writer — चुने हुए पाठ के अनुसार Markdown लेखन</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="DeepTutor Co-Writer workspace" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer reports, tutorials, notes, और long-form learning artifacts के लिए एक split-view Markdown workspace है। Documents autosave होते हैं और live preview render करते हैं (KaTeX math, diagram fences), और जब draft reusable context बन जाए तो notebooks में save किए जा सकते हैं। नया draft शुरू करने के लिए `.docx` import करें, और वर्तमान editor को Markdown या Word के रूप में export करें।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="live preview वाला Co-Writer editor" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
इसका defining idea **surgical editing** है: एक span select करें और DeepTutor से rewrite, expand, या shorten करने के लिए कहें। Edit model चुनें; वह knowledge base या web evidence उपयोग कर सकता है और अपने tool calls का trace रखता है। अगर उसके काम के दौरान draft नहीं बदला है, तो result selected text को directly replace करता है और **Undo** से reversible रहता है।
@@ -528,17 +527,17 @@ Co-Writer reports, tutorials, notes, और long-form learning artifacts के
<summary><b>📖 Book — आपकी सामग्री से जीवंत पुस्तकें</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="DeepTutor पुस्तक लाइब्रेरी" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="DeepTutor पुस्तक लाइब्रेरी" width="900">
</div>
Book selected sources को एक interactive **living book** में बदलता है — एक static PDF नहीं, बल्कि typed blocks से बना एक reading environment। एक book knowledge bases, notebooks, question banks, या chat history से शुरू हो सकती है; creation flow content generate होने से पहले एक chapter outline propose करता है, इसलिए आप blind one-shot output accept करने की बजाय shape review करते हैं।
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="पुस्तक quiz block" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="पुस्तक quiz block" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="पुस्तक Manim animation block" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="पुस्तक interactive widget block" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="पुस्तक interactive widget block" width="31%">
</p>
हर chapter editable typed blocks में compile होता है — text, callouts, quizzes, flash cards, timelines, code, figures, interactive HTML, animations, concept graphs, deep dives, और user notes — और उसका अपना Page Chat होता है। किसी block को insert, move, regenerate, rewrite, या उसका type switch करें; selected passages review की जा सकने वाली learning-capture inbox में जाते हैं। Progress, bookmarks, quiz attempts, captures, और Page Chat हर reader के लिए private रहते हैं, भले admin की book read-only या collaborative editing के लिए share की गई हो; shared book delete करना admin-only रहता है। कोई भी book Markdown में export हो सकती है, लंबी compiles pause और resume होती हैं, और `deeptutor book health` / `refresh-fingerprints` source drift को flag करते हैं।
@@ -549,13 +548,13 @@ Book selected sources को एक interactive **living book** में बद
<summary><b>📚 Knowledge Center — कई इंजन वाली RAG लाइब्रेरी</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor ज्ञान केंद्र" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="DeepTutor ज्ञान केंद्र" width="900">
</div>
Knowledge bases RAG के पीछे document collections हैं — वे Chat turns, Co-Writer edits, Book generation, और Partner conversations को ground करते हैं। जो distinctive है वह है **retrieval engines का choice**: **LlamaIndex** (default, hybrid vector + BM25 के साथ optional cross-encoder reranking और exact-flat या HNSW FAISS indexes), **PageIndex** (reasoning retrieval with page-level citations, hosted या self-hosted OSS), **GraphRAG** और **LightRAG** (knowledge-graph retrieval), **LightRAG Server** (retrieval एक external LightRAG instance पर offload किया जाता है जिसे आप HTTP पर connect करते हैं), **WeKnora** (आपके self-hosted deployment की knowledge base से retrieval, बिना local index या document copy के), **Tencent IMA** (एक library जिसे आप IMA में curate करते हैं — इसके OpenAPI पर search, browse, और write back किया जाता है), **MarginNote 4** (आपका MN4 study data — documents, excerpts, mind-map cards और उनके बीच के links — जिन्हें app का Add-on push करता है और dedicated tools से navigate किया जाता है), **Kiwix** (बिना local indexing के HTTP पर serve किया गया searchable ZIM archive), या एक linked **Obsidian** vault जिसे tutor in-place पढ़ता और लिखता है। हर KB एक engine से bound होती है।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="एक knowledge base बनाएं" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="एक knowledge base बनाएं" width="900">
</div>
Existing Obsidian, Hermes, या Markdown library migrate कर रहे हैं? Connected-vault और indexed-copy paths के लिए [Knowledge migration guide](../../docs-for-user/KNOWLEDGE_MIGRATION.md) देखें।
@@ -578,13 +577,13 @@ Native LightRAG queries और incremental indexing को उस embedding conf
<summary><b>🌐 Learning Space — Skills, Personas और दोबारा उपयोग योग्य संदर्भ</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="DeepTutor Learning Space केंद्र" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Space library, organization, और personalization layer है। **Conversations & Materials** में Chat History, movable records और Markdown export वाले notebooks, तथा answers और explanations वाला question bank है। Review sessions, mistake tracking और scheduled repetition के लिए question bank में चुने गए प्रश्नों या Personalized Learning से **Practice** शुरू करें। **Personalization** में personas, skills (`SKILL.md` playbooks), one-click **MCP Services**, और [CLI-Anything](https://github.com/HKUDS/CLI-Anything) catalog के **CLI Apps** हैं, जिनकी usage guide on-demand load होती है। अलग **My Courses** workspace subject conversations और tutor threads को group करता है; हर asset केवल उन workflows में उपलब्ध होता है जो उसे support करते हैं।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="EduHub से skills import करें" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
आपको हर skill खुद नहीं लिखनी है — **Import from EduHub** community catalog browse करता है और एक security gate के जरिए directly आपकी library में skill download करता है (देखें [Ecosystem](#-इकोसिस्टम--eduhub-और-skills-community))।
@@ -595,13 +594,13 @@ Learning Space library, organization, और personalization layer है। **C
<summary><b>🧠 Memory — जांचा जा सकने वाला वैयक्तिकरण</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="DeepTutor memory अवलोकन" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="DeepTutor memory अवलोकन" width="900">
</div>
Memory एक file-backed, three-layer system है जिसे आप पढ़, curate, और audit कर सकते हैं — जानबूझकर एक hidden vector store नहीं। **L1** workspace mirror plus एक append-only event trace (`trace/<surface>/<date>.jsonl`) है; **L2** per-surface curated facts (`L2/<surface>.md`) है, जिसमें L1 entities के references होते हैं; **L3** cross-surface synthesis (`L3/<profile|recent|scope|preferences>.md`) है, जो अपनी contributing L2 surfaces record करता है।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="DeepTutor memory graph" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="DeepTutor memory graph" width="900">
</div>
Memory Graph पूरा pyramid दिखाता है — L3 synthesis centre में, L2 middle ring में, L1 traces outside में — exact L2 → L1 evidence edges और L3 → contributing-surface links के साथ। Memory `chat`, `notebook`, `quiz`, `kb`, `book`, partner, और `cowriter` surfaces पर track किया जाता है; consolidator के Update / Audit / Dedup budgets **Settings → Memory** में tune किए जाते हैं।
@@ -612,7 +611,7 @@ Memory Graph पूरा pyramid दिखाता है — L3 synthesis cen
<summary><b>⚙️ Settings — नियंत्रण का एक केंद्र</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="DeepTutor Settings केंद्र" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings operational control plane है, जो interface और model output language के लिए **General** पर खुलता है। इसका searchable navigator independent pages से जोड़ता है: **Personal** में Workspaces, Data migration, Appearance और Usage statistics हैं; **Learning & conversation** में starting points, attachments, Video Learning, learner और guardian controls, Learning progress, तथा Memory हैं; **Models & services** में Providers, Language models, Task models, Embedding, Search, Voice और Multimodal generation हैं; **Features & integrations** में tools, capability parameters, Partners & agents और Knowledge & documents हैं। **System** में Network, Runtime status और About हैं; **Archived chats** archived conversations खोजने, restore करने या permanently delete करने देता है। Runtime status में backend health, resident memory और capability blockers, warnings तथा suggestions बताने वाला **Readiness** matrix है। Workspaces topic files और learning state अलग रखता है, जबकि Data migration में verified migration और export उपलब्ध हैं। एक **provider** vendor का address और credential रखता है ताकि उसके service models उन्हें reuse कर सकें; model pages saved providers चुनते हैं और model names तथा capabilities configure करते हैं। **Task models** background work — conversations को नाम देना और starting points लिखना — के लिए छोटा, तेज़ model pin करते हैं, और खाली होने पर active default उपयोग करते हैं। Voice में speech synthesis और transcription एक साथ हैं; Multimodal generation में image और video models हैं। Partners & agents local harnesses और remote Hermes gateway configure करता है।
@@ -624,7 +623,7 @@ Settings operational control plane है, जो interface और model output
Settings → Learning & conversation के तहत **Video Learning**, Reading के लिए YouTube captions और Invidious access configure करता है। Invidious उपयोग करने के लिए administrator द्वारा managed backend API origin (उदाहरण के लिए `http://127.0.0.1:3000`) और browser से accessible public origin set करें, connection test करें, Invidious select करें, और save करें। Reading के add-material dialog में **Browse Invidious** से videos खोजे जा सकते हैं और connected subscriptions तथा playlists खोली जा सकती हैं। YouTube playback official privacy-enhanced player उपयोग करता है; captions न होने की स्थिति दिखाई जाती है और tutor के evidence को सीमित करती है, लेकिन native playback को नहीं रोकती। Default YouTube caption loader के लिए `.[video-learning]` install करें। Existing Watching links conversation history, compatible transcripts, notes और progress को बनाए रखते हुए Reading में migrate होते हैं; नए timestamp notes Reading annotations होते हैं। Bilibili अपनी playback और caption प्रक्रिया उपयोग करता है।
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="DeepTutor appearance settings और themes" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="DeepTutor appearance settings और themes" width="900">
</div>
अधिकांश sections एक draft-and-apply flow उपयोग करते हैं, इसलिए आप provider को commit करने से पहले test कर सकते हैं। आप बस Chat में भी पूछ सकते हैं: assistant current configuration पढ़ता है, एक change apply करता है, और बताता है कि उसे restart या re-index चाहिए या नहीं — एक नए model को commit करने से पहले probe करते हुए, इसलिए यह खुद को किसी unreachable चीज़ पर switch नहीं कर सकता। API keys कभी model से नहीं गुजरतीं, जो इसकी बजाय आपके लिए matching form खोल देता है। चार themes box में आते हैं — Default, Cream, Dark, और Glass। Project-root `.env` files जानबूझकर ignored हैं; runtime configuration `data/user/settings/*.json` के नीचे रहती है जब तक कि `DEEPTUTOR_HOME` या `deeptutor start --home` app को कहीं और point न करे।
diff --git a/assets/README/README_JA.md b/assets/README/README_JA.md
index 4aa631005..202084a4f 100644
--- a/assets/README/README_JA.md
+++ b/assets/README/README_JA.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="DeepTutor ロゴ" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor:生涯にわたるパーソナライズド個別指導
@@ -422,16 +422,15 @@ DeepTutorは、インストールされたコード、プライベートなラ
回答が以前の制約を失ったり、弱い根拠を引用したり、選択した資料と矛盾したりする場合は、Issueを開く前に[`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md)に診断情報をまとめてください。
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="DeepTutorホーム — サイドバーにすべてのサーフェスを含むチャットワークスペース" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **スクリーンショットの状態:** 全体表示は v1.6.5 向けに更新済みです。以下の画面スクリーンショットは、刷新中のため引き続き v1.4.6 の参考画像です。操作の流れの理解には使えますが、現在の正確なナビゲーションとしては扱わないでください。
<details>
<summary><b>🏗️ システムアーキテクチャ</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="DeepTutorシステムアーキテクチャ" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="DeepTutorシステムアーキテクチャ" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ DeepTutorは、インストールされたコード、プライベートなラ
Chatはデフォルト機能であり、ほとんどの作業が始まる場所です。1つのスレッドで通常の会話、ツールの呼び出し、選択した知識ベースへのグラウンディング、添付ファイルの読み取り、画像生成、サブエージェントとの相談、ノートブックレコードの書き込みが可能で、ターンをまたいで同じコンテキストを維持します。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="DeepTutorチャットワークスペース" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="DeepTutorチャットワークスペース" width="900">
</div>
ループは意図的にシンプルです。モデルはラウンドで考え、役に立つときにツールを呼び出し、結果を観察し、ツールなしのメッセージで終了します。`ask_user`は特別で、推測する代わりに、エージェントはターンを一時停止し、構造化された明確化の質問をして、あなたが答えた後に再開できます。
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="DeepTutorチャットエージェントループ" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="DeepTutorチャットエージェントループ" width="900">
</div>
ユーザーが切り替えられるツールは`brainstorm`、`web_search`、`paper_search`、`zotero_search`、`reason`、`geogebra_analysis` — 加えて、対応する生成モデルを設定すれば`imagegen`と`videogen`も利用できます。`rag`、`kb_files`、`knowledge_frontier`、`read_source`、`read_memory`、`write_memory`、`read_skill`、`load_tools`、`exec`、`web_fetch`、`ask_user`、`list_notebook`、`write_note`、`question_bank`、`github`、`consult_subagent`、`workspace_list`、`workspace_read`、`workspace_search`、`workspace_present`、`workspace_export`などのコンテキスト依存ツールは、ターンに適切なコンテキストがある場合に自動的にマウントされます。
@@ -463,7 +462,7 @@ Homeでは**Chat**、**Ask Questions**、**Quiz**、**Visualize**にワンクリ
<summary><b>🤝 Partner — 同じブレインで動く永続コンパニオン</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="DeepTutor Partnersワークスペース" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="DeepTutor Partnersワークスペース" width="900">
</div>
Partnersは独自のソウル、モデルポリシー、ライブラリ、メモリ、チャンネルを持つ永続コンパニオンです。別個のボットエンジンではありません。ウェブまたはIMからの受信メッセージは、パートナースコープのワークスペース内の通常の`ChatOrchestrator`ターンになります。Partnerは「個性を持ったチャットであり、電話番号を持っている」存在です。
@@ -475,7 +474,7 @@ Partnersは独自のソウル、モデルポリシー、ライブラリ、メモ
各Partnerには`SOUL.md`、モデル選択、チャンネル、ツールポリシー、割り当てられたライブラリがあります。ライブラリは知識ベース、スキル、ノートブックを`data/partners/<id>/workspace/`にコピーするか、既存のワークスペースのファイルとリソースにリンクしたまま利用できます。ソウル、会話、Partnerのメモリは独立したままです。認証済みの非管理者ユーザーは、非公開のPartnerセッションと関係メモリを維持し、Partnerはそのユーザーの個人メモリを読み取り専用で参照します。管理者、グループ、未バインドのトラフィックは共有Partnerスコープを使用します。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Partner ごとのIMチャンネル設定" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Partner ごとのIMチャンネル設定" width="900">
</div>
チャンネル層はスキーマ駆動で、インストール済みエクストラと設定された認証情報に応じて、Feishu、Telegram、Slack、Discord、DingTalk、QQ/NapCat、WeCom、WhatsApp、Zulip、Mattermost、Matrix、Mochat、Microsoft Teamsなどのプラットフォームに接続できます。PartnerはサブエージェントとしてMy Agentsに接続でき、通常のチャットターンから相談できます。詳細は以下の**My Agents**を参照してください。
@@ -488,7 +487,7 @@ Partnersは独自のソウル、モデルポリシー、ライブラリ、メモ
<summary><b>🧑‍🚀 My Agents — 他のエージェントと相談・インポート</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="DeepTutor My Agentsワークスペース" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="DeepTutor My Agentsワークスペース" width="900">
</div>
My Agentsは他のエージェントをDeepTutorのコンテキストにし、2つの異なることを行います。**ライブエージェントを接続** — マシン上のClaude Code、Codex、Grok CLI、Antigravity、Kimi、opencode、MiMo Code、Hermes Agent、OpenClaw、DeepSeek Harness、リモートのHermesゲートウェイ、または自分のPartnersのいずれか — してチャットターン内から相談できます。DeepTutorは実際に他のエージェントを*実行*し、`consult_subagent`ツールを介してその作業をActivityパネルにストリーミングします。Agentチップでエージェントとラウンド上限を選択するか、`@`で同じ接続済みエージェント一覧を絞り込め、選択内容はセッションに紐づいたまま保持されます。
@@ -500,7 +499,7 @@ My Agentsは他のエージェントをDeepTutorのコンテキストにし、2
Grokは自身の認証とセッションストレージを使用し、DeepTutorはその認証情報をコピーしません。追加の相談は同じ作業ディレクトリでその接続のセッションを再開します。テキストとツールのアクティビティはライブでストリーミングされますが、非公開の思考ペイロードは省略されます。クロスセッションのGrokメモリはデフォルトで無効です。このコネクタはテキストによる質問とCLIツールをサポートしますが、画像の転送や過去のGrok会話のインポートはサポートしません。Dockerでは、Grokはバックエンドコンテナ内にインストールして認証してください — ブラウザ側のマシンにのみインストールされたCLIには到達できません。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Claude Codeサブエージェントをライブで相談" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**過去の会話をインポート** — 既存のChatGPT、Claude Code、Codexの履歴を検索可能、再開可能な会話として取り込みます。安全でべき等なスナップショットインポートを行うには、公式のChatGPTデータエクスポートから`conversations.json`を選択します。Claudeの履歴はプロジェクト / 作業ディレクトリ単位、Codexの履歴はカレンダーの日付単位で選択します。フォルダベースのエージェントは引き続き更新可能で、選択したスコープに新しい会話を取り込めます。Chatターンから`+` → My Agentsで会話を参照でき、DeepTutorはそれをサードパーティのトランスクリプトとして読み取ります — それはDeepTutor自身の声ではなく、*相手の*会話として保持されます。
@@ -511,13 +510,13 @@ Grokは自身の認証とセッションストレージを使用し、DeepTutor
<summary><b>✍️ Co-Writer — 選択対応Markdownドラフトツール</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="DeepTutor Co-Writerワークスペース" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writerはレポート、チュートリアル、メモ、長文学習コンテンツのための分割表示Markdownワークスペースです。ドキュメントは自動保存され、ライブプレビュー(KaTeXの数式、図表フェンス)を表示し、下書きが再利用可能なコンテキストになったときにノートブックに保存できます。`.docx` を取り込んで新しい下書きを始め、現在のエディタを Markdown または Word として書き出せます。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Co-Writerエディターとライブプレビュー" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
その定義的なアイデアは**外科的編集**です。テキストの範囲を選択し、DeepTutorに書き直し、拡張、または短縮を依頼します。編集モデルを選択でき、知識ベースやウェブの証拠を利用しながら、ツール呼び出しのトレースを保持します。処理中に下書きが変更されていなければ、結果は選択したテキストを直接置き換え、**Undo**で元に戻せます。
@@ -528,17 +527,17 @@ Co-Writerはレポート、チュートリアル、メモ、長文学習コン
<summary><b>📖 Book — 素材から生きている本を作成</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="DeepTutor Bookライブラリ" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="DeepTutor Bookライブラリ" width="900">
</div>
Bookは選択したソースをインタラクティブな**生きている本**に変換します。静的なPDFではなく、タイプ指定されたブロックから構築された読書環境です。知識ベース、ノートブック、問題バンク、チャット履歴から本を開始できます。作成フローではコンテンツが生成される前に章のアウトラインを提案するため、盲目的な一発生成を受け入れるのではなく、構造を確認できます。
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Bookクイズブロック" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Bookクイズブロック" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Book Manimアニメーションブロック" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Bookインタラクティブウィジェットブロック" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Bookインタラクティブウィジェットブロック" width="31%">
</p>
各章は編集可能なタイプ指定ブロックにコンパイルされます — テキスト、コールアウト、クイズ、フラッシュカード、タイムライン、コード、図、インタラクティブHTML、アニメーション、概念グラフ、詳細解説、ユーザーノート — それぞれにPage Chatがあります。ブロックの挿入、移動、再生成、書き直し、種類の変更ができ、選択した箇所は確認可能な学習キャプチャの受信トレイに入ります。管理者の本が読み取り専用または共同編集用に共有されていても、進捗、ブックマーク、クイズの受験結果、学習キャプチャ、Page Chatは読者ごとに非公開のままで、共有された本を削除できるのは管理者だけです。どの本もMarkdownにエクスポートでき、長時間のコンパイルは一時停止と再開が可能です。`deeptutor book health` / `refresh-fingerprints`はソースのドリフトにフラグを立てます。
@@ -549,13 +548,13 @@ Bookは選択したソースをインタラクティブな**生きている本**
<summary><b>📚 Knowledge Center — マルチエンジンRAGライブラリ</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor Knowledge Center" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="DeepTutor Knowledge Center" width="900">
</div>
知識ベースはRAGの背後にあるドキュメントコレクションです — Chatターン、Co-Writerの編集、Book生成、Partnerの会話をグラウンドします。特徴的なのは**検索エンジンの選択**です:**LlamaIndex**(デフォルト、ハイブリッドなベクター + BM25。オプションでクロスエンコーダー再ランキングとexact-flatまたはHNSW FAISSインデックスを利用可能)、**PageIndex**(ページレベル引用付き推論検索、ホスト型またはセルフホストOSS)、**GraphRAG**と**LightRAG**(知識グラフ検索)、**LightRAG Server**(HTTP経由で接続する外部LightRAGインスタンスに検索をオフロード)、**WeKnora**(ローカルインデックスやドキュメントコピーを作らず、セルフホスト環境の知識ベースから検索)、**Tencent IMA**(IMAでキュレートするライブラリで、そのOpenAPI経由で検索・閲覧・書き戻しが可能)、**MarginNote 4**(あなたのMN4学習データ — ドキュメント、抜粋、マインドマップカード、およびそれらの間のリンク — がアプリのアドオンによって取り込まれ、専用ツールでナビゲートできます)、**Kiwix**(HTTP経由で提供される検索可能なZIMアーカイブ。ローカルでのインデックス作成は不要)、またはチューターがその場で読み書きするリンクされた**Obsidian**ボールト。各KBは1つのエンジンにバインドされます。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="知識ベースの作成" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="知識ベースの作成" width="900">
</div>
既存のObsidian、Hermes、Markdownライブラリを移行する場合は、接続ボールトとインデックス付きコピーの手順を[Knowledge migration guide](../../docs-for-user/KNOWLEDGE_MIGRATION.md)で確認してください。
@@ -578,13 +577,13 @@ KBを作成する際は、**新規作成**(ドキュメントをアップロ
<summary><b>🌐 Learning Space — スキル、ペルソナ、再利用可能なコンテキスト</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="DeepTutor Learning Spaceハブ" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Spaceはライブラリ、整理、パーソナライゼーションの層です。**会話と素材**にはChat History、レコードの移動とMarkdownへのエクスポートに対応したノートブック、回答と解説を保存する問題バンクがあります。問題バンクで選択した項目、または個別学習から**練習**を開始して、復習セッション、間違いの記録、定期的な反復学習を行えます。**パーソナライゼーション**にはペルソナ、スキル(`SKILL.md`プレイブック)、ワンクリックで導入できる**MCPサービス**、[CLI-Anything](https://github.com/HKUDS/CLI-Anything)カタログの**CLIアプリ**があり、各アプリの使用ガイドはオンデマンドで読み込まれます。独立した**My Courses**ワークスペースは科目ごとの会話とチュータースレッドをまとめ、各アセットはそれをサポートするワークフローでのみ提供されます。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="EduHubからスキルをインポート" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
すべてのスキルを自分で書く必要はありません。**EduHubからインポート**でコミュニティカタログを参照し、セキュリティゲートを通じてスキルをライブラリに直接ダウンロードできます([エコシステム](#-エコシステム--eduhubとスキルコミュニティ)参照)。
@@ -595,13 +594,13 @@ Learning Spaceはライブラリ、整理、パーソナライゼーションの
<summary><b>🧠 Memory — 検査可能なパーソナライゼーション</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="DeepTutor Memoryの概要" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="DeepTutor Memoryの概要" width="900">
</div>
Memoryはファイルバックの3層システムで、読み取り、キュレーション、監査が可能です — 意図的に隠されたベクターストアではありません。**L1**はワークスペースミラーに加えた追記のみのイベントトレース(`trace/<surface>/<date>.jsonl`)、**L2**はL1エンティティへの参照を持つサーフェスごとのキュレートされた事実(`L2/<surface>.md`)、**L3**は寄与したL2サーフェスを記録するクロスサーフェス合成(`L3/<profile|recent|scope|preferences>.md`)です。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="DeepTutor Memoryグラフ" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="DeepTutor Memoryグラフ" width="900">
</div>
Memory Graphはピラミッド全体を表示します — L3合成が中心、L2が中間リング、L1トレースが外側 — 正確なL2 → L1の証拠エッジと、L3 → 寄与サーフェスのリンクを確認できます。Memoryは`chat`、`notebook`、`quiz`、`kb`、`book`、partner、`cowriter`サーフェスで追跡されます。コンソリデーターのUpdate / Audit / Dedupバジェットは**Settings → Memory**で調整します。
@@ -612,7 +611,7 @@ Memory Graphはピラミッド全体を表示します — L3合成が中心、L
<summary><b>⚙️ Settings — ワンコントロールプレーン</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="DeepTutor Settingsハブ" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settingsはオペレーションコントロールプレーンで、最初に表示される**一般**でインターフェースとモデル出力の言語を設定します。検索可能なナビゲーターから独立した各ページにアクセスできます。**個人**にはワークスペース、データ移行、外観、使用量統計、**学習と会話**にはスターティングポイント、添付ファイル、Video Learning、学習者と保護者の管理、Learning progress、Memory、**モデルとサービス**にはプロバイダー、言語モデル、タスクモデル、埋め込み、検索、音声、マルチモーダル生成、**機能と連携**にはツール、機能パラメーター、Partners & agents、Knowledge & documentsがあります。**システム**にはネットワーク、実行状態、Aboutがあり、**アーカイブ済みチャット**ではアーカイブした会話の検索、復元、完全削除ができます。実行状態にはバックエンドの健全性、常駐メモリ、機能の阻害要因・警告・提案を評価する**Readiness**マトリクスが表示されます。ワークスペースはトピックのファイルと学習状態を分離し、データ移行では検証付きの移行とエクスポートができます。**プロバイダー**はベンダーのアドレスと認証情報を保持し、そのサービスモデルで再利用します。モデルページでは保存済みプロバイダーを選び、モデル名と機能を設定します。**タスクモデル**は会話への命名やスターティングポイントの生成などのバックグラウンド作業に小さく高速なモデルを固定し、空欄の場合はアクティブなデフォルトを使用します。音声には音声合成と文字起こし、マルチモーダル生成には画像と動画のモデルがまとまっています。Partners & agentsではローカルハーネスとリモートのHermesゲートウェイを設定します。
@@ -624,7 +623,7 @@ Settingsはオペレーションコントロールプレーンで、最初に表
Settings → Learning & conversationの**Video Learning**では、Reading用のYouTube字幕とInvidiousへのアクセスを設定します。Invidiousを使用するには、管理者が管理するバックエンドAPIオリジン(例:`http://127.0.0.1:3000`)とブラウザからアクセスできる公開オリジンを設定し、接続をテストして、Invidiousを選択して保存します。Readingの教材追加ダイアログにある**Browse Invidious**から動画を検索し、接続済みの登録チャンネルやプレイリストにアクセスできます。YouTubeの再生には公式のプライバシー強化プレーヤーを使用します。字幕がない場合もその状態が表示され、チューターが参照できる根拠は制限されますが、ネイティブ再生は妨げられません。デフォルトのYouTube字幕ローダーを使用するには`.[video-learning]`をインストールしてください。既存のWatchingリンクは、会話履歴、互換性のある文字起こし、ノート、進捗を保持してReadingに移行されます。新しいタイムスタンプ付きノートはReadingの注釈として保存されます。Bilibiliは独自の再生と字幕取得の経路を使用します。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="DeepTutor外観設定とテーマ" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="DeepTutor外観設定とテーマ" width="900">
</div>
ほとんどのセクションはドラフトと適用フローを使用するため、コミットする前にプロバイダーをテストできます。Chatで直接依頼するだけでも構いません:アシスタントが現在の設定を読み取り、変更を適用し、再起動または再インデックスが必要かどうかを教えてくれます — コミットする前に新しいモデルをプローブするため、到達不能な設定に自分自身を切り替えてしまうことはありません。APIキーがモデルを経由することは決してなく、代わりに該当するフォームを開いてくれます。4つのテーマが箱に入っています:Default、Cream、Dark、Glass。プロジェクトルートの`.env`ファイルは意図的に無視されます。ランタイム設定は`DEEPTUTOR_HOME`または`deeptutor start --home`でアプリを別の場所に向けない限り、`data/user/settings/*.json`に保存されます。
diff --git a/assets/README/README_PL.md b/assets/README/README_PL.md
index fbfd26d67..931bdd6fb 100644
--- a/assets/README/README_PL.md
+++ b/assets/README/README_PL.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="Logo DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: Spersonalizowane korepetycje przez całe życie
@@ -422,16 +422,15 @@ Zacznij od głównych powierzchni, których będziesz używać na co dzień: Cha
Jeśli odpowiedź pomija wcześniejsze ograniczenie, przywołuje słabe dowody lub jest sprzeczna z wybranym materiałem, przed otwarciem issue zbierz dane diagnostyczne zgodnie z [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md).
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="Strona główna DeepTutor — obszar roboczy Chat z każdą powierzchnią w pasku bocznym" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **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. Służą do zrozumienia przepływów, a nie jako dokładna bieżąca nawigacja.
<details>
<summary><b>🏗️ Architektura systemu</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="Architektura systemu DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="Architektura systemu DeepTutor" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ Jeśli odpowiedź pomija wcześniejsze ograniczenie, przywołuje słabe dowody l
Chat to domyślna możliwość i miejsce, gdzie zaczyna się większość pracy. Jeden wątek może rozmawiać normalnie, wywoływać narzędzia, opierać się na wybranych bazach wiedzy, czytać załączniki, generować obrazy, konsultować subagentów, pisać rekordy notatnika i kontynuować z tym samym kontekstem przez tury.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="Obszar roboczy czatu DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="Obszar roboczy czatu DeepTutor" width="900">
</div>
Pętla jest celowo prosta: model myśli w rundach, wywołuje narzędzia gdy są przydatne, obserwuje wyniki i kończy wiadomością bez narzędzi. `ask_user` jest wyjątkowy — zamiast zgadywać, agent może wstrzymać turę, zadać ustrukturyzowane pytanie wyjaśniające i wznowić po odpowiedzi.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="Pętla agenta czatu DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="Pętla agenta czatu DeepTutor" width="900">
</div>
Narzędzia przełączalne przez użytkownika to `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason` i `geogebra_analysis` — plus `imagegen` i `videogen` po skonfigurowaniu odpowiedniego modelu generowania. Narzędzia kontekstowe takie jak `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` i `workspace_export` montują się automatycznie gdy tura ma odpowiedni kontekst.
@@ -463,7 +462,7 @@ Home daje dostęp jednym kliknięciem do **Chat**, **Ask Questions**, **Quiz** i
<summary><b>🤝 Partner — Stali towarzysze na tym samym mózgu</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="Obszar roboczy Partners DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="Obszar roboczy Partners DeepTutor" width="900">
</div>
Partners to stali towarzysze z własną duszą, polityką modelu, biblioteką, pamięcią i kanałami. Nie są osobnym silnikiem bota: każda przychodząca wiadomość webowa lub IM staje się normalną turą `ChatOrchestrator` wewnątrz obszaru roboczego z zakresem partnera. Partner to „czat który ma osobowość i numer telefonu."
@@ -475,7 +474,7 @@ Partners to stali towarzysze z własną duszą, polityką modelu, biblioteką, p
Każdy partner ma `SOUL.md`, wybór modelu, kanały, politykę narzędzi i przypisaną bibliotekę. Jego biblioteka może kopiować bazy wiedzy, umiejętności i notatniki do `data/partners/<id>/workspace/` lub pozostać połączona z plikami i zasobami istniejącego obszaru roboczego; dusza, rozmowy i pamięć Partner pozostają oddzielne. Uwierzytelnieni użytkownicy bez uprawnień administratora zachowują prywatne sesje Partner i pamięć relacji, a Partner odczytuje ich pamięć osobistą tylko do odczytu; ruch administratorów, grup i użytkowników niepowiązanych korzysta ze wspólnego zakresu Partner.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Konfiguracja kanału IM per partner" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Konfiguracja kanału IM per partner" width="900">
</div>
Warstwa kanałów jest sterowana schematem i może łączyć się z platformami IM takimi jak Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat i Microsoft Teams w zależności od zainstalowanych dodatków i skonfigurowanych danych uwierzytelniających. Partner może być również podłączony jako subagent i konsultowany z normalnej tury czatu — patrz **My Agents** poniżej.
@@ -488,7 +487,7 @@ Dla szybszej konfiguracji strona kanału Partner może utworzyć aplikację Feis
<summary><b>🧑‍🚀 My Agents — Konsultuj i importuj innych agentów</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="Obszar roboczy My Agents DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="Obszar roboczy My Agents DeepTutor" width="900">
</div>
My Agents zamienia innych agentów w kontekst dla DeepTutor i wykonuje dwie odrębne rzeczy. **Połącz żywego agenta** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw lub DeepSeek Harness na twoim komputerze, zdalną bramę Hermes lub jednego z twoich Partners — i konsultuj go z wnętrza tury czatu: DeepTutor faktycznie *uruchamia* drugiego agenta i strumieniuje jego pracę do panelu Activity przez narzędzie `consult_subagent`. Wybierz go i jego limit rund za pomocą chipa Agent lub przefiltruj tę samą listę połączonych agentów za pomocą `@`; wybór pozostaje powiązany z sesją.
@@ -500,7 +499,7 @@ W **Settings → Partners & Agents → Grok CLI** pozostaw model i poziom wysił
Grok używa własnego uwierzytelniania i przechowywania sesji; DeepTutor nie kopiuje jego danych uwierzytelniających. Kolejne konsultacje wznawiają sesję połączenia w tym samym katalogu roboczym. Tekst i aktywność narzędzi strumieniują na żywo; prywatne treści myśli są pomijane. Pamięć Grok między sesjami jest domyślnie wyłączona. Ten łącznik obsługuje pytania tekstowe i narzędzia CLI, a nie przekazywanie obrazów ani importowanie wcześniejszych konwersacji Grok. W Dockerze zainstaluj i uwierzytelnij Grok wewnątrz kontenera backendu; CLI zainstalowane tylko na komputerze przeglądarki nie jest osiągalne.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Konsultowanie subagenta Claude Code na żywo" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Importuj poprzednie konwersacje** — przynieś swoją istniejącą historię ChatGPT, Claude Code i Codex jako przeszukiwalne, wznawialne konwersacje. Wybierz `conversations.json` z oficjalnego eksportu danych ChatGPT, aby bezpiecznie i idempotentnie zaimportować migawkę, wybierz historię Claude według projektu / katalogu roboczego albo historię Codex według daty kalendarzowej. Agenty oparte na folderach pozostają odświeżalne, więc ich wybrany zakres może pobierać nowe konwersacje. Odwołaj się do jednej z nich z tury Chat przez `+` → My Agents, a DeepTutor czyta ją jako transkrypt osoby trzeciej — pozostaje *ich* konwersacją, nie własnym głosem DeepTutor.
@@ -511,13 +510,13 @@ Grok używa własnego uwierzytelniania i przechowywania sesji; DeepTutor nie kop
<summary><b>✍️ Co-Writer — Edycja Markdown z uwzględnieniem zaznaczenia</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="Obszar roboczy Co-Writer DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer to obszar roboczy Markdown z podzielonym widokiem dla raportów, samouczków, notatek i długich artefaktów uczenia się. Dokumenty są automatycznie zapisywane, renderują podgląd na żywo (matematyka KaTeX, schematy), i mogą być zapisane z powrotem do notatników gdy szkic staje się kontekstem wielokrotnego użytku. Zaimportuj `.docx`, aby rozpocząć szkic, i eksportuj bieżący edytor jako Markdown lub Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Edytor Co-Writer z podglądem na żywo" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
Jego wyróżniającym pomysłem jest **precyzyjna edycja**: zaznacz fragment i poproś DeepTutor o przepisanie, rozszerzenie lub skrócenie. Wybierz model edycji; może on korzystać z bazy wiedzy lub dowodów z sieci i zachowuje ślad swoich wywołań narzędzi. Jeśli szkic nie zmienił się podczas jego pracy, wynik bezpośrednio zastępuje zaznaczony tekst i nadal można go cofnąć za pomocą **Undo**.
@@ -528,17 +527,17 @@ Jego wyróżniającym pomysłem jest **precyzyjna edycja**: zaznacz fragment i p
<summary><b>📖 Book — Żywe książki z twoich materiałów</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="Biblioteka książek DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="Biblioteka książek DeepTutor" width="900">
</div>
Book zamienia wybrane źródła w interaktywną **żywą książkę** — nie statyczny PDF, ale środowisko czytelnicze zbudowane z typowanych bloków. Książka może zaczynać się od baz wiedzy, notatników, banków pytań lub historii czatu; przepływ tworzenia proponuje konspekt rozdziałów przed wygenerowaniem treści, więc przeglądasz kształt zamiast akceptować ślepe jednorazowe wyjście.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Blok quizu w książce" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Blok quizu w książce" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Blok animacji Manim w książce" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Blok interaktywnego widżetu w książce" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Blok interaktywnego widżetu w książce" width="31%">
</p>
Każdy rozdział kompiluje się do edytowalnych, typowanych bloków — tekstu, callouts, quizów, fiszek, osi czasu, kodu, figur, interaktywnego HTML, animacji, grafów konceptów, dogłębnych analiz i notatek użytkownika — i ma własny Page Chat. Wstawiaj, przenoś, regeneruj i przepisuj bloki lub zmieniaj ich typ; zaznaczone fragmenty trafiają do skrzynki materiałów do nauki, gdzie można je przejrzeć. Postępy, zakładki, próby quizów, materiały do nauki i Page Chat pozostają prywatne dla każdego czytelnika, nawet gdy książka administratora jest udostępniona tylko do odczytu lub do wspólnej edycji; współdzieloną książkę nadal może usunąć tylko administrator. Każdą książkę można wyeksportować do Markdown, długa kompilacja może być wstrzymywana i wznawiana, a `deeptutor book health` / `refresh-fingerprints` sygnalizują dryf źródeł.
@@ -549,13 +548,13 @@ Każdy rozdział kompiluje się do edytowalnych, typowanych bloków — tekstu,
<summary><b>📚 Knowledge Center — Wielosilnikowe biblioteki RAG</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="Knowledge Center DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="Knowledge Center DeepTutor" width="900">
</div>
Bazy wiedzy to kolekcje dokumentów za RAG — ugruntowują tury Chat, edycje Co-Writer, generowanie Book i konwersacje Partner. Wyróżnikiem jest **wybór silnika wyszukiwania**: **LlamaIndex** (domyślny, hybrydowy wektor + BM25 z opcjonalnym ponownym rankingiem cross-encoder i indeksami FAISS exact-flat lub HNSW), **PageIndex** (wyszukiwanie z rozumowaniem z cytowaniami na poziomie strony, hostowany lub samodzielnie hostowany open source), **GraphRAG** i **LightRAG** (wyszukiwanie oparte na grafach wiedzy), **LightRAG Server** (wyszukiwanie odciążone do zewnętrznej instancji LightRAG którą łączysz przez HTTP), **WeKnora** (wyszukiwanie z bazy wiedzy w samodzielnie hostowanym wdrożeniu, bez lokalnego indeksu ani kopii dokumentów), **Tencent IMA** (biblioteka którą kurujesz w IMA — przeszukiwana, przeglądana i zapisywana z powrotem przez jego OpenAPI), **MarginNote 4** (Twoje dane MN4 — dokumenty, wyciągi, karty mapy myśli i połączenia między nimi — przesyłane przez Add-on aplikacji i przeglądane za pomocą dedykowanych narzędzi), **Kiwix** (przeszukiwalne archiwum ZIM udostępniane przez HTTP bez lokalnego indeksowania), lub podłączony vault **Obsidian** który tutor czyta i zapisuje w miejscu. Każda KB jest powiązana z jednym silnikiem.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Tworzenie bazy wiedzy" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="Tworzenie bazy wiedzy" width="900">
</div>
Przenosisz istniejącą bibliotekę Obsidian, Hermes lub Markdown? Zobacz [przewodnik po migracji wiedzy](../../docs-for-user/KNOWLEDGE_MIGRATION.md), aby poznać ścieżki podłączonego vault i indeksowanej kopii.
@@ -578,13 +577,13 @@ Natywne zapytania LightRAG i indeksowanie przyrostowe wymagają konfiguracji emb
<summary><b>🌐 Learning Space — Umiejętności, persony i kontekst wielokrotnego użytku</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="Centrum Learning Space DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Space to warstwa biblioteki, organizacji i personalizacji. **Conversations & Materials** obejmuje Chat History, notatniki z możliwością przenoszenia rekordów i eksportu do Markdown oraz bank pytań z odpowiedziami i wyjaśnieniami. Rozpocznij **Ćwiczenia** od zaznaczenia w banku pytań lub ze Spersonalizowanej nauki, aby prowadzić sesje powtórkowe, śledzić błędy i powtarzać materiał według harmonogramu. **Personalization** obejmuje persony, umiejętności (podręczniki `SKILL.md`), instalowane jednym kliknięciem **Usługi MCP** oraz **Aplikacje CLI** z katalogu [CLI-Anything](https://github.com/HKUDS/CLI-Anything), każdą z przewodnikiem użycia wczytywanym na żądanie. Oddzielny obszar roboczy **My Courses** grupuje rozmowy według przedmiotów i wątki tutorów; każdy zasób jest oferowany tylko w przepływach pracy, które go obsługują.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Importowanie umiejętności z EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
Nie musisz pisać każdej umiejętności samodzielnie — **Import from EduHub** przegląda katalog społecznościowy i pobiera umiejętność bezpośrednio do twojej biblioteki przez bramę bezpieczeństwa (patrz [Ekosystem](#-ekosystem--eduhub-i-społeczność-umiejętności)).
@@ -595,13 +594,13 @@ Nie musisz pisać każdej umiejętności samodzielnie — **Import from EduHub**
<summary><b>🧠 Memory — Inspektowalna personalizacja</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="Przegląd Memory DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="Przegląd Memory DeepTutor" width="900">
</div>
Memory to system trzywarstwowy oparty na plikach, który możesz czytać, selekcjonować i audytować — celowo *nie* ukryty magazyn wektorowy. **L1** to lustro obszaru roboczego plus dołączany ślad zdarzeń (`trace/<surface>/<date>.jsonl`); **L2** to wyselekcjonowane fakty per-powierzchnia (`L2/<surface>.md`) z odwołaniami do encji L1; **L3** to synteza między-powierzchniowa (`L3/<profile|recent|scope|preferences>.md`), która zapisuje uczestniczące powierzchnie L2.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="Graf pamięci DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="Graf pamięci DeepTutor" width="900">
</div>
Memory Graph pokazuje całą piramidę — synteza L3 w centrum, L2 w środkowym pierścieniu, ślady L1 na zewnątrz — z dokładnymi krawędziami dowodów L2 → L1 i połączeniami L3 → powierzchnie uczestniczące. Memory jest śledzone przez powierzchnie `chat`, `notebook`, `quiz`, `kb`, `book`, partner i `cowriter`; budżety Update / Audit / Dedup konsolidatora są dostosowywane w **Settings → Memory**.
@@ -612,7 +611,7 @@ Memory Graph pokazuje całą piramidę — synteza L3 w centrum, L2 w środkowym
<summary><b>⚙️ Settings — Jedna płaszczyzna kontroli</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="Centrum ustawień DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings to panel sterowania aplikacją, który otwiera się na stronie **General**, służącej do wyboru języka interfejsu i odpowiedzi modelu. Nawigator z wyszukiwaniem prowadzi do niezależnych stron: **Personal** obejmuje Workspaces, migrację danych, wygląd i statystyki użycia; **Learning & conversation** — punkty startowe, załączniki, Video Learning, ustawienia uczniów i opiekunów, Learning progress oraz Memory; **Models & services** — dostawców, modele językowe, modele zadań, osadzanie, wyszukiwanie, głos i generowanie multimodalne; **Features & integrations** — narzędzia, parametry możliwości, Partners & agents oraz Knowledge & documents. **System** obejmuje sieć, stan środowiska uruchomieniowego i informacje o aplikacji; **Archived chats** pozwala wyszukiwać, przywracać lub trwale usuwać zarchiwizowane rozmowy. Stan środowiska uruchomieniowego zawiera stan backendu, pamięć rezydentną i macierz **Readiness**, która ocenia blokady, ostrzeżenia i sugestie dotyczące możliwości. Workspaces rozdziela pliki tematów i stan nauki, a migracja danych oferuje zweryfikowany transfer i eksport. **Dostawca** przechowuje adres i poświadczenia firmy do ponownego użycia przez jej modele usług; strony modeli pozwalają wybierać zapisanych dostawców oraz konfigurować nazwy i możliwości modeli. **Modele zadań** przypinają mały, szybki model do pracy w tle — nazywania rozmów i pisania punktów startowych — a gdy są puste, korzystają z aktywnego modelu domyślnego. Głos grupuje syntezę mowy i transkrypcję; generowanie multimodalne grupuje modele obrazów i wideo. Partners & agents służy do konfiguracji lokalnych środowisk agentów i zdalnej bramy Hermes.
@@ -624,7 +623,7 @@ Settings to panel sterowania aplikacją, który otwiera się na stronie **Genera
**Video Learning** w Settings → Learning & conversation konfiguruje napisy YouTube i dostęp do Invidious dla Reading. Aby użyć Invidious, ustaw zarządzany przez administratora adres bazowy API backendu (na przykład `http://127.0.0.1:3000`) oraz publiczny adres dostępny z przeglądarki, przetestuj połączenie, wybierz Invidious i zapisz. **Browse Invidious** w oknie dodawania materiałów Reading pozwala wyszukiwać filmy oraz otwierać połączone subskrypcje i playlisty. Odtwarzanie YouTube korzysta z oficjalnego odtwarzacza o podwyższonej ochronie prywatności; brak napisów jest widoczny i ogranicza materiał źródłowy tutora, ale nie blokuje natywnego odtwarzania. Zainstaluj `.[video-learning]`, aby korzystać z domyślnego mechanizmu pobierania napisów YouTube. Istniejące linki Watching są przenoszone do Reading z zachowaniem historii rozmów, zgodnych transkrypcji, notatek i postępów; nowe notatki ze znacznikami czasu są adnotacjami Reading. Bilibili korzysta z własnej ścieżki odtwarzania i napisów.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="Ustawienia wyglądu DeepTutor i motywy" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="Ustawienia wyglądu DeepTutor i motywy" width="900">
</div>
Większość sekcji używa przepływu szkic-i-zastosuj, więc możesz testować dostawcę przed jego zatwierdzeniem. Możesz też po prostu zapytać w Chat: asystent odczytuje bieżącą konfigurację, stosuje zmianę i mówi, czy potrzebny jest restart lub ponowne indeksowanie — sprawdzając nowy model zanim go zatwierdzi, więc nie może sam przełączyć się na coś nieosiągalnego. Klucze API nigdy nie przechodzą przez model, który zamiast tego otwiera odpowiedni formularz. Cztery motywy dostarczane w zestawie — Default, Cream, Dark i Glass. Pliki `.env` katalogu głównego projektu są celowo ignorowane; konfiguracja środowiska uruchomieniowego żyje pod `data/user/settings/*.json` chyba że `DEEPTUTOR_HOME` lub `deeptutor start --home` wskaże aplikację gdzie indziej.
diff --git a/assets/README/README_PT.md b/assets/README/README_PT.md
index eadb308a8..383410006 100644
--- a/assets/README/README_PT.md
+++ b/assets/README/README_PT.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="Logótipo do DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: Tutoria Personalizada Vitalícia
@@ -422,16 +422,15 @@ Comece pelas superfícies principais que usará no dia a dia: Chat, Partners, Me
Se uma resposta perder uma restrição anterior, citar evidências fracas ou discordar do material selecionado, recolha os diagnósticos em [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) antes de abrir uma issue.
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="Página inicial do DeepTutor — o espaço de trabalho Chat com todas as superfícies na barra lateral" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **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. Use-as para entender os fluxos, não como navegação exata atual.
<details>
<summary><b>🏗️ Arquitetura do sistema</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="Arquitetura do sistema DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="Arquitetura do sistema DeepTutor" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ Se uma resposta perder uma restrição anterior, citar evidências fracas ou dis
Chat é a capacidade predefinida e o lugar onde a maior parte do trabalho começa. Um único thread pode conversar normalmente, chamar ferramentas, fundamentar-se em bases de conhecimento selecionadas, ler anexos, gerar imagens, consultar subagentes, escrever registos de notebook e continuar com o mesmo contexto entre turnos.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="Espaço de trabalho de chat DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="Espaço de trabalho de chat DeepTutor" width="900">
</div>
O loop é deliberadamente simples: o modelo pensa em rondas, chama ferramentas quando útil, observa os resultados e termina com uma mensagem sem ferramentas. `ask_user` é especial — em vez de adivinhar, o agente pode pausar o turno, fazer uma pergunta de esclarecimento estruturada e retomar assim que responder.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="Loop de agente de chat DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="Loop de agente de chat DeepTutor" width="900">
</div>
As ferramentas ativáveis pelo utilizador são `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason` e `geogebra_analysis` — mais `imagegen` e `videogen` depois de configurar o modelo de geração correspondente. Ferramentas contextuais como `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` e `workspace_export` montam automaticamente quando o turno tem o contexto certo.
@@ -463,7 +462,7 @@ A página inicial mantém **Chat**, **Ask Questions**, **Quiz** e **Visualize**
<summary><b>🤝 Partner — Companheiros Persistentes no Mesmo Cérebro</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="Espaço de trabalho de partners DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="Espaço de trabalho de partners DeepTutor" width="900">
</div>
Os Partners são companheiros persistentes com a sua própria alma, política de modelo, biblioteca, memória e canais. Não são um motor de bot separado: cada mensagem web ou IM recebida torna-se um turno normal do `ChatOrchestrator` dentro de um espaço de trabalho com âmbito de partner. Um partner é "um chat que tem personalidade e número de telefone."
@@ -475,7 +474,7 @@ Os Partners são companheiros persistentes com a sua própria alma, política de
Cada partner tem um `SOUL.md`, seleção de modelo, canais, política de ferramentas e biblioteca atribuída. A sua biblioteca pode copiar bases de conhecimento, skills e notebooks para `data/partners/<id>/workspace/`, ou permanecer ligada aos ficheiros e recursos de um workspace existente; a identidade, as conversas e a memória do Partner continuam separadas. Os utilizadores autenticados que não sejam administradores mantêm sessões Partner e memória de relacionamento privadas, enquanto o Partner lê a sua memória pessoal em modo somente leitura; o tráfego de administrador, de grupo e não vinculado usa o âmbito Partner partilhado.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Configuração de canal IM por partner" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Configuração de canal IM por partner" width="900">
</div>
A camada de canais é orientada por esquema e pode ligar-se a plataformas IM como Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat e Microsoft Teams dependendo dos extras instalados e das credenciais configuradas. Um partner também pode ser conectado como subagente e consultado a partir de um turno de chat normal — veja **Meus Agentes** abaixo.
@@ -488,7 +487,7 @@ Para uma configuração mais rápida, a página de canal do Partner pode criar u
<summary><b>🧑‍🚀 Meus Agentes — Consultar e Importar Outros Agentes</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="Espaço de trabalho Meus Agentes DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="Espaço de trabalho Meus Agentes DeepTutor" width="900">
</div>
Meus Agentes transforma outros agentes em contexto para o DeepTutor, e faz duas coisas distintas. **Conectar um agente ao vivo** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw ou DeepSeek Harness na sua máquina, um gateway Hermes remoto ou um dos seus Partners — e consultá-lo a partir de dentro de um turno de chat: o DeepTutor *executa* mesmo o outro agente e transmite o seu trabalho para o painel de Atividade via a ferramenta `consult_subagent`. Selecione-o e o respetivo limite de rondas com o chip de Agente, ou filtre a mesma lista de agentes conectados com `@`; a escolha permanece associada à sessão.
@@ -500,7 +499,7 @@ Em **Settings → Partners & Agents → Grok CLI**, deixe o modelo e o esforço
O Grok usa a sua própria autenticação e armazenamento de sessão; o DeepTutor não copia as suas credenciais. Consultas de seguimento retomam a sessão da ligação no mesmo diretório de trabalho. O texto e a atividade de ferramentas são transmitidos em direto; as cargas de pensamento privado são omitidas. A memória do Grok entre sessões está desativada por predefinição. Este conector suporta perguntas de texto e ferramentas da CLI, não o envio de imagens nem a importação de conversas anteriores do Grok. No Docker, instale e autentique o Grok dentro do contentor do backend; uma CLI instalada apenas na máquina do navegador não é alcançável.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Consultar um subagente Claude Code ao vivo" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Importar conversas anteriores** — traga o seu histórico existente do ChatGPT, Claude Code e Codex como conversas pesquisáveis e retomáveis. Selecione `conversations.json` de uma exportação de dados oficial do ChatGPT para uma importação de instantâneo segura e idempotente, escolha o histórico do Claude por projeto / diretório de trabalho, ou escolha o histórico do Codex por data do calendário. Os agentes baseados em pastas continuam atualizáveis, de modo que o seu âmbito selecionado pode obter novas conversas. Referencie uma a partir de um turno do Chat via `+` → Meus Agentes, e o DeepTutor lê-a como uma transcrição de terceiros — permanece *a conversa deles*, não a voz própria do DeepTutor.
@@ -511,13 +510,13 @@ O Grok usa a sua própria autenticação e armazenamento de sessão; o DeepTutor
<summary><b>✍️ Co-Writer — Rascunho Markdown com Consciência de Seleção</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="Espaço de trabalho Co-Writer DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer é um espaço de trabalho Markdown de vista dividida para relatórios, tutoriais, notas e artefactos de aprendizagem de formato longo. Os documentos guardam automaticamente, renderizam uma pré-visualização em tempo real (matemática KaTeX, cercas de diagramas) e podem ser guardados de volta em notebooks quando um rascunho se torna contexto reutilizável. Importe um `.docx` para começar um rascunho e exporte o editor atual como Markdown ou Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Editor Co-Writer com pré-visualização em tempo real" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
A sua ideia central é a **edição cirúrgica**: selecione um trecho e peça ao DeepTutor para reescrever, expandir ou encurtar. Escolha o modelo de edição; este pode usar uma base de conhecimento ou evidências da web e mantém um rasto das suas chamadas de ferramentas. Se o rascunho não tiver mudado durante o trabalho, o resultado substitui diretamente o texto selecionado e continua reversível com **Undo**.
@@ -528,17 +527,17 @@ A sua ideia central é a **edição cirúrgica**: selecione um trecho e peça ao
<summary><b>📖 Book (Livro) — Livros Vivos dos Seus Materiais</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="Biblioteca de livros DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="Biblioteca de livros DeepTutor" width="900">
</div>
Book converte fontes selecionadas num **livro vivo** interativo — não um PDF estático, mas um ambiente de leitura construído a partir de blocos tipados. Um livro pode começar a partir de bases de conhecimento, notebooks, bancos de perguntas ou histórico de chat; o fluxo de criação propõe uma estrutura de capítulos antes de o conteúdo ser gerado, para que os utilizadores possam rever a forma em vez de aceitar uma saída cega de disparo único.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Bloco de quiz do Book" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Bloco de quiz do Book" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Bloco de animação Manim do Book" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Bloco de widget interativo do Book" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Bloco de widget interativo do Book" width="31%">
</p>
Cada capítulo compila em blocos tipados editáveis — texto, callouts, quizzes, cartões flash, linhas do tempo, código, figuras, HTML interativo, animações, gráficos de conceitos, mergulhos profundos e notas de utilizador — e cada página dispõe do seu próprio Page Chat. Insira, mova, regenere, reescreva ou mude o tipo de um bloco; os trechos selecionados entram numa caixa de entrada de capturas de aprendizagem sujeita a revisão. O progresso, os marcadores, as tentativas de quiz, as capturas e o Page Chat permanecem privados por leitor, mesmo quando um livro do administrador é partilhado em modo só de leitura ou para edição colaborativa; a eliminação de livros partilhados continua reservada ao administrador. Qualquer livro exporta para Markdown, as compilações longas pausam e retomam, e `deeptutor book health` / `refresh-fingerprints` assinalam divergências nas fontes.
@@ -549,13 +548,13 @@ Cada capítulo compila em blocos tipados editáveis — texto, callouts, quizzes
<summary><b>📚 Centro de Conhecimento — Bibliotecas RAG Multi-Motor</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="Centro de Conhecimento DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="Centro de Conhecimento DeepTutor" width="900">
</div>
As bases de conhecimento são as coleções de documentos por trás do RAG — fundamentam os turnos do Chat, edições do Co-Writer, geração do Book e conversas do Partner. O que é distintivo é uma **escolha de motores de recuperação**: **LlamaIndex** (o padrão, vetor híbrido + BM25 com reranking opcional por cross-encoder e índices FAISS exact-flat ou HNSW), **PageIndex** (recuperação de raciocínio com citações ao nível da página, alojado ou OSS auto-hospedado), **GraphRAG** e **LightRAG** (recuperação de grafo de conhecimento), **LightRAG Server** (recuperação delegada a uma instância externa de LightRAG conectada via HTTP), **WeKnora** (recuperação a partir de uma base de conhecimento na sua implementação auto-hospedada, sem índice local nem cópia de documentos), **Tencent IMA** (uma biblioteca que cura no IMA — pesquisada, navegada e escrita de volta através da sua OpenAPI), **MarginNote 4** (os seus dados de estudo MN4 — documentos, excertos, cartões de mapa mental e as ligações entre eles — enviados pelo Add-on da aplicação e navegados com ferramentas dedicadas), **Kiwix** (um arquivo ZIM pesquisável servido por HTTP sem indexação local), ou um vault **Obsidian** vinculado que o tutor lê e escreve no lugar. Cada KB está vinculada a um motor.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Criar uma base de conhecimento" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="Criar uma base de conhecimento" width="900">
</div>
Vai migrar uma biblioteca Obsidian, Hermes ou Markdown existente? Consulte o [guia de migração de Knowledge](../../docs-for-user/KNOWLEDGE_MIGRATION.md) para os caminhos de vault ligado e cópia indexada.
@@ -578,13 +577,13 @@ As consultas nativas do LightRAG e a indexação incremental exigem a configura
<summary><b>🌐 Espaço de Aprendizado — Skills, Personas e Contexto Reutilizável</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="Hub do Espaço de Aprendizado DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
O Espaço de Aprendizado é a camada de biblioteca, organização e personalização. **Conversas e Materiais** contém o Chat History, notebooks com registos transferíveis e exportação em Markdown, e um banco de questões com respostas e explicações. Inicie **Prática** a partir de uma seleção do banco de questões ou de Aprendizagem personalizada para sessões de revisão, acompanhamento de erros e repetição programada. **Personalização** contém personas, skills (playbooks `SKILL.md`), **Serviços MCP** de um clique e **Aplicações CLI** do catálogo [CLI-Anything](https://github.com/HKUDS/CLI-Anything), cada uma com um guia de utilização carregado a pedido. O espaço de trabalho separado **My Courses** agrupa conversas por disciplina e threads de tutoria; cada recurso é oferecido apenas nos fluxos de trabalho que o suportam.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Importar skills do EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
Não tem de escrever cada skill você mesmo — **Importar do EduHub** navega no catálogo da comunidade e descarrega uma skill diretamente para a sua biblioteca através de uma porta de segurança (veja [Ecossistema](#-ecossistema--eduhub-e-a-comunidade-de-skills)).
@@ -595,13 +594,13 @@ Não tem de escrever cada skill você mesmo — **Importar do EduHub** navega no
<summary><b>🧠 Memória — Personalização Inspecionável</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="Visão geral da memória DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="Visão geral da memória DeepTutor" width="900">
</div>
A Memória é um sistema de três camadas suportado por ficheiros que pode ler, curar e auditar — deliberadamente *não* um armazém de vetores oculto. **L1** é o espelho do espaço de trabalho mais um rasto de eventos append-only (`trace/<surface>/<date>.jsonl`); **L2** são factos curados por superfície (`L2/<surface>.md`) com referências a entidades L1; **L3** é a síntese entre superfícies (`L3/<profile|recent|scope|preferences>.md`) que regista as superfícies L2 contribuintes.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="Gráfico de memória de três camadas DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="Gráfico de memória de três camadas DeepTutor" width="900">
</div>
O Memory Graph mostra toda a pirâmide — síntese L3 no centro, L2 no anel do meio, rastreamentos L1 no exterior — com arestas de evidência L2 → L1 exatas e ligações L3 → superfícies contribuintes. A memória é rastreada nas superfícies `chat`, `notebook`, `quiz`, `kb`, `book`, partner e `cowriter`; os orçamentos de Atualização / Auditoria / Deduplicação do consolidador são ajustados em **Settings → Memory**.
@@ -612,7 +611,7 @@ O Memory Graph mostra toda a pirâmide — síntese L3 no centro, L2 no anel do
<summary><b>⚙️ Configurações — Um Plano de Controlo</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="Hub de configurações DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Configurações é o plano de controlo operacional e abre em **Geral**, com o idioma da interface e o de saída do modelo. O navegador pesquisável liga a páginas independentes: **Pessoal** inclui Workspaces, Migração de dados, Aparência e Estatísticas de utilização; **Aprendizagem e conversa** inclui pontos de partida, anexos, Video Learning, controlos de alunos e responsáveis, Progresso de aprendizagem e Memory; **Modelos e serviços** inclui Provedores, Modelos de linguagem, Modelos de tarefa, Embedding, Search, Voz e Geração multimodal; **Funcionalidades e integrações** inclui ferramentas, parâmetros de capacidades, Partners e agentes e Conhecimento e documentos. **Sistema** reúne Rede, Estado de execução e Sobre; **Conversas arquivadas** permite pesquisar, restaurar ou eliminar permanentemente conversas arquivadas. Estado de execução contém a saúde do backend, memória residente e a matriz de **Prontidão**, que classifica bloqueios, avisos e sugestões das capacidades. Workspaces mantém os ficheiros dos temas e o estado de aprendizagem separados, com migração e exportação verificadas em Migração de dados. Um **provedor** guarda o endereço e a credencial de um fornecedor para reutilização pelos seus modelos de serviço; as páginas de modelos selecionam provedores guardados e configuram nomes e capacidades dos modelos. Os **modelos de tarefa** fixam um modelo pequeno e rápido para trabalho em segundo plano — nomear conversas e escrever pontos de partida — e usam a predefinição ativa quando deixados em branco. Voz agrupa síntese e transcrição de voz; Geração multimodal agrupa modelos de imagem e vídeo. Partners e agentes configura harnesses locais e um gateway Hermes remoto.
@@ -625,7 +624,7 @@ Configurações é o plano de controlo operacional e abre em **Geral**, com o id
**Video Learning** em Settings → Aprendizagem e conversa configura as legendas do YouTube e o acesso ao Invidious para Reading. Para usar o Invidious, defina a origem da API do backend gerida pelo administrador (por exemplo, `http://127.0.0.1:3000`) e a origem pública acessível pelo navegador, teste a ligação, selecione Invidious e guarde. **Browse Invidious** no diálogo para adicionar materiais do Reading pesquisa vídeos e acede às subscrições e listas de reprodução conectadas. A reprodução do YouTube usa o leitor oficial com privacidade melhorada; a ausência de legendas permanece visível e limita as evidências do tutor sem bloquear a reprodução nativa. Instale `.[video-learning]` para o carregador predefinido de legendas do YouTube. Os links existentes de Watching migram para Reading, preservando o histórico de conversas, transcrições compatíveis, notas e progresso; as novas notas com marcas temporais são anotações do Reading. O Bilibili usa o seu próprio caminho de reprodução e legendas.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="Configurações de aparência e temas DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="Configurações de aparência e temas DeepTutor" width="900">
</div>
A maioria das secções usa um fluxo de rascunho e aplicação, para que possa testar um provedor antes de o confirmar. Também pode simplesmente pedir no Chat: o assistente lê a configuração atual, aplica uma alteração e diz se é necessário reiniciar ou reindexar — testando um novo modelo antes de o confirmar, para que nunca possa mudar-se sozinho para algo inacessível. As chaves API nunca passam pelo modelo, que em vez disso abre o formulário correspondente para si. Quatro temas incluídos — Default, Cream, Dark e Glass. Os ficheiros `.env` da raiz do projeto são intencionalmente ignorados; a configuração de runtime vive sob `data/user/settings/*.json` a menos que `DEEPTUTOR_HOME` ou `deeptutor start --home` aponte a aplicação para outro lugar.
diff --git a/assets/README/README_RU.md b/assets/README/README_RU.md
index 78155824e..9bf3dbf34 100644
--- a/assets/README/README_RU.md
+++ b/assets/README/README_RU.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="Логотип DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: Пожизненное Персонализированное Обучение
@@ -422,16 +422,15 @@ DeepTutor отделяет установленный код, приватное
Если ответ теряет ранее заданное ограничение, ссылается на слабые доказательства или противоречит выбранному материалу, соберите диагностические данные по [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md), прежде чем открывать issue.
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="Главная страница DeepTutor — рабочее пространство чата со всеми поверхностями на боковой панели" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **Состояние скриншотов:** общий обзор обновлен для v1.6.5. Скриншоты поверхностей ниже остаются справочными изображениями v1.4.6 до завершения обновления. Используйте их для понимания рабочих процессов, а не как точную текущую навигацию.
<details>
<summary><b>🏗️ Архитектура системы</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="Архитектура системы DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="Архитектура системы DeepTutor" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ DeepTutor отделяет установленный код, приватное
Чат — это возможность по умолчанию и место, где начинается большинство работ. Один поток может нормально общаться, вызывать инструменты, опираться на выбранные базы знаний, читать вложения, генерировать изображения, обращаться к субагентам, записывать в блокнот и продолжать с тем же контекстом в последующих ходах.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="Рабочее пространство чата DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="Рабочее пространство чата DeepTutor" width="900">
</div>
Цикл намеренно прост: модель думает раундами, вызывает инструменты при необходимости, наблюдает результаты и завершает сообщением без инструментов. `ask_user` особенный — вместо угадывания агент может приостановить ход, задать структурированный уточняющий вопрос и возобновить работу, когда вы ответите.
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="Цикл агента чата DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="Цикл агента чата DeepTutor" width="900">
</div>
Переключаемые пользователем инструменты: `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason` и `geogebra_analysis` — плюс `imagegen` и `videogen` после настройки соответствующей генеративной модели. Контекстные инструменты, такие как `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` и `workspace_export`, монтируются автоматически, когда ход имеет подходящий контекст.
@@ -463,7 +462,7 @@ DeepTutor отделяет установленный код, приватное
<summary><b>🤝 Partner — Постоянные Компаньоны на Том Же Мозге</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="Рабочее пространство партнёров DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="Рабочее пространство партнёров DeepTutor" width="900">
</div>
Партнёры — это постоянные компаньоны со своей душой, политикой модели, библиотекой, памятью и каналами. Они не являются отдельным движком бота: каждое входящее веб- или IM-сообщение становится обычным ходом `ChatOrchestrator` внутри рабочего пространства, ограниченного партнёром. Партнёр — это «чат с личностью и номером телефона».
@@ -475,7 +474,7 @@ DeepTutor отделяет установленный код, приватное
Каждый партнёр имеет `SOUL.md`, выбор модели, каналы, политику инструментов и назначенную библиотеку. Его библиотека либо копирует базы знаний, навыки и блокноты в `data/partners/<id>/workspace/`, либо остаётся связанной с файлами и ресурсами существующего рабочего пространства; душа, разговоры и память Partner остаются отдельными. Аутентифицированные пользователи без прав администратора сохраняют приватные сессии Partner и память отношений, а Partner читает их личную память только для чтения; трафик администраторов, групп и непривязанных пользователей использует общую область Partner.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="Конфигурация IM-канала для каждого партнёра" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="Конфигурация IM-канала для каждого партнёра" width="900">
</div>
Слой каналов управляется схемой и может подключаться к IM-платформам, таким как Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat и Microsoft Teams, в зависимости от установленных дополнений и настроенных учётных данных. Партнёр также может быть подключён как субагент и использован из обычного хода чата — см. **Мои Агенты** ниже.
@@ -488,7 +487,7 @@ DeepTutor отделяет установленный код, приватное
<summary><b>🧑‍🚀 Мои Агенты — Консультация и Импорт Других Агентов</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="Рабочее пространство «Мои Агенты» DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="Рабочее пространство «Мои Агенты» DeepTutor" width="900">
</div>
Мои Агенты превращают других агентов в контекст для DeepTutor и делают две разные вещи. **Подключите живого агента** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw или DeepSeek Harness на вашей машине, удалённый шлюз Hermes либо одного из ваших Партнёров — и обращайтесь к нему изнутри хода чата: DeepTutor фактически *запускает* другого агента и транслирует его работу в панель Activity через инструмент `consult_subagent`. Выберите его и лимит раундов с помощью чипа Agent или отфильтруйте тот же список подключённых агентов через `@`; выбор остаётся привязанным к сессии.
@@ -500,7 +499,7 @@ DeepTutor отделяет установленный код, приватное
Grok использует собственную аутентификацию и хранение сессий; DeepTutor не копирует его учётные данные. Последующие консультации возобновляют сессию соединения в той же рабочей директории. Текст и активность инструментов транслируются в реальном времени; приватные данные размышлений не передаются. Память Grok между сессиями отключена по умолчанию. Этот коннектор поддерживает текстовые вопросы и инструменты CLI, но не передачу изображений и не импорт прошлых разговоров Grok. В Docker установите и авторизуйте Grok внутри контейнера бэкенда; CLI, установленный только на компьютере браузера, недоступен.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="Обращение к субагенту Claude Code в реальном времени" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**Импортируйте прошлые разговоры** — загрузите существующую историю ChatGPT, Claude Code и Codex как доступные для поиска, возобновляемые разговоры. Выберите `conversations.json` из официального экспорта данных ChatGPT для безопасного, идемпотентного импорта снимка, выбирайте историю Claude по проекту / рабочей директории или историю Codex по календарной дате. Агенты на основе папок остаются обновляемыми, поэтому их выбранная область может подхватывать новые разговоры. Ссылайтесь на один из них из хода Chat через `+` → Мои Агенты, и DeepTutor читает его как транскрипт третьей стороны — это *их* разговор, а не собственный голос DeepTutor.
@@ -511,13 +510,13 @@ Grok использует собственную аутентификацию и
<summary><b>✍️ Co-Writer — Редактирование Markdown с Учётом Выделения</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="Рабочее пространство Co-Writer DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer — это разделённое рабочее пространство Markdown для отчётов, руководств, заметок и долгосрочных учебных артефактов. Документы автосохраняются и отображают живой предварительный просмотр (математика KaTeX, ограждения диаграмм), и могут быть сохранены обратно в блокноты, когда черновик становится повторно используемым контекстом. Импортируйте `.docx`, чтобы начать черновик, и экспортируйте текущий редактор как Markdown или Word.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Редактор Co-Writer с живым предварительным просмотром" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
Его определяющая идея — **хирургическое редактирование**: выберите фрагмент и попросите DeepTutor переписать, расширить или сократить его. Выберите модель редактирования; она может использовать базу знаний или веб-данные и ведёт журнал вызовов инструментов. Если черновик не изменился за время его работы, результат напрямую заменяет выделенный текст и остаётся обратимым с помощью **Undo**.
@@ -528,17 +527,17 @@ Co-Writer — это разделённое рабочее пространст
<summary><b>📖 Книга — Живые Книги из Ваших Материалов</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="Библиотека книг DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="Библиотека книг DeepTutor" width="900">
</div>
Книга превращает выбранные источники в интерактивную **живую книгу** — не статический PDF, а среда чтения, построенная из типизированных блоков. Книга может начинаться с баз знаний, блокнотов, банков вопросов или истории чата; процесс создания предлагает план глав перед генерацией содержания, поэтому вы рассматриваете структуру вместо того, чтобы принимать слепой одноразовый вывод.
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Блок викторины книги" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Блок викторины книги" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Блок анимации Manim книги" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Блок интерактивного виджета книги" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Блок интерактивного виджета книги" width="31%">
</p>
Каждая глава компилируется в редактируемые типизированные блоки — текст, выноски, викторины, флэш-карточки, временные шкалы, код, рисунки, интерактивный HTML, анимации, концептуальные графы, углублённые рассуждения и пользовательские заметки — и имеет собственный Page Chat. Вставляйте, перемещайте, регенерируйте и переписывайте блоки или меняйте их тип; выделенные фрагменты попадают в раздел входящих учебных выдержек, где их можно проверить. Прогресс, закладки, попытки прохождения викторин, учебные выдержки и Page Chat остаются личными для каждого читателя, даже если администратор поделился книгой в режиме только для чтения или совместного редактирования; удалять общие книги по-прежнему может только администратор. Любую книгу можно экспортировать в Markdown, длительную компиляцию можно приостанавливать и возобновлять, а `deeptutor book health` / `refresh-fingerprints` отмечают расхождения с источниками.
@@ -549,13 +548,13 @@ Co-Writer — это разделённое рабочее пространст
<summary><b>📚 Центр Знаний — Многодвигательные RAG-Библиотеки</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="Центр Знаний DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="Центр Знаний DeepTutor" width="900">
</div>
Базы знаний — это коллекции документов для RAG, которые обосновывают ходы Chat, редакции Co-Writer, генерацию Book и разговоры с Партнёрами. Отличительной чертой является **выбор движков поиска**: **LlamaIndex** (по умолчанию, гибридный векторный поиск + BM25 с необязательным переранжированием cross-encoder и индексами FAISS exact-flat или HNSW), **PageIndex** (поиск с рассуждением с цитатами на уровне страницы, размещённый или самостоятельно развёрнутый (OSS)), **GraphRAG** и **LightRAG** (поиск на основе графа знаний), **LightRAG Server** (поиск, делегированный внешнему экземпляру LightRAG, подключаемому по HTTP), **WeKnora** (поиск в базе знаний вашего самостоятельно размещённого развёртывания без локального индекса или копии документов), **Tencent IMA** (библиотека, которую вы курируете в IMA — доступная для поиска, просмотра и записи через её OpenAPI), **MarginNote 4** (ваши учебные данные MN4 — документы, выдержки, карточки интеллект-карт и связи между ними — передаются дополнением (Add-on) приложения и используются с помощью специальных инструментов навигации), **Kiwix** (доступный для поиска ZIM-архив, предоставляемый по HTTP без локального индексирования), или связанное хранилище **Obsidian**, которое репетитор читает и записывает на месте. Каждая KB привязана к одному движку.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="Создание базы знаний" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="Создание базы знаний" width="900">
</div>
Переносите существующую библиотеку Obsidian, Hermes или Markdown? В [руководстве по миграции знаний](../../docs-for-user/KNOWLEDGE_MIGRATION.md) описаны варианты с подключённым хранилищем и индексированной копией.
@@ -578,13 +577,13 @@ Co-Writer — это разделённое рабочее пространст
<summary><b>🌐 Пространство Обучения — Навыки, Персоны и Многоразовый Контекст</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="Хаб Пространства Обучения DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Пространство Обучения — это уровень библиотеки, организации и персонализации. **Разговоры и материалы** содержат Chat History, блокноты с перемещаемыми записями и экспортом в Markdown, а также банк вопросов с ответами и объяснениями. Запускайте **Практику** из выбранных вопросов банка вопросов или из Персонализированного обучения для сеансов повторения, отслеживания ошибок и повторения по расписанию. **Персонализация** содержит персонажей, навыки (сценарии `SKILL.md`), устанавливаемые одним кликом **MCP-сервисы** и **CLI-приложения** из каталога [CLI-Anything](https://github.com/HKUDS/CLI-Anything), причём руководство по использованию каждого приложения загружается по требованию. Отдельное рабочее пространство **My Courses** группирует разговоры по предметам и ветки репетиторов; каждый ресурс предлагается только в поддерживающих его рабочих процессах.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="Импорт навыков из EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
Вам не нужно писать каждый навык самостоятельно — **Импорт из EduHub** просматривает каталог сообщества и загружает навык прямо в вашу библиотеку через шлюз безопасности (см. [Экосистема](#-экосистема--eduhub-и-сообщество-навыков)).
@@ -595,13 +594,13 @@ Co-Writer — это разделённое рабочее пространст
<summary><b>🧠 Память — Проверяемая Персонализация</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="Обзор Памяти DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="Обзор Памяти DeepTutor" width="900">
</div>
Память — это трёхуровневая система на основе файлов, которую можно читать, курировать и проверять — намеренно *не* скрытое векторное хранилище. **L1** — зеркало рабочего пространства плюс трассировка событий только для добавления (`trace/<surface>/<date>.jsonl`); **L2** — курированные факты на уровне поверхности (`L2/<surface>.md`) со ссылками на сущности L1; **L3** — межповерхностный синтез (`L3/<profile|recent|scope|preferences>.md`), фиксирующий участвующие поверхности L2.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="Граф Памяти DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="Граф Памяти DeepTutor" width="900">
</div>
Граф памяти показывает всю пирамиду — синтез L3 в центре, L2 в среднем кольце, трассировки L1 снаружи — с точными рёбрами доказательств L2 → L1 и связями L3 → участвующие поверхности. Память отслеживается по поверхностям `chat`, `notebook`, `quiz`, `kb`, `book`, partner и `cowriter`; бюджеты обновления / аудита / дедупликации консолидатора настраиваются в **Настройки → Память**.
@@ -612,7 +611,7 @@ Co-Writer — это разделённое рабочее пространст
<summary><b>⚙️ Настройки — Единая Панель Управления</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="Хаб настроек DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Настройки — это операционная панель управления, которая открывается страницей **Общие** для выбора языка интерфейса и вывода модели. Навигатор с поиском ведёт на независимые страницы: **Личное** включает рабочие пространства, миграцию данных, внешний вид и статистику использования; **Обучение и разговоры** — стартовые подсказки, вложения, Video Learning, управление учащимися и опекунами, Прогресс обучения и Memory; **Модели и сервисы** — провайдеров, языковые модели, Task-модели, встраивание, поиск, речь и мультимодальную генерацию; **Возможности и интеграции** — инструменты, параметры возможностей, партнёров и агентов, знания и документы. **Система** включает сеть, состояние среды выполнения и сведения о проекте; **Архивные чаты** позволяют искать, восстанавливать или навсегда удалять архивные разговоры. Состояние среды выполнения показывает состояние бэкенда, резидентную память и матрицу **Готовности**, оценивающую блокирующие проблемы, предупреждения и рекомендации для возможностей. Рабочие пространства разделяют файлы тем и состояние обучения, а миграция данных обеспечивает проверяемый перенос и экспорт. **Провайдер** хранит адрес и учётные данные поставщика для повторного использования его сервисными моделями; на страницах моделей выбираются сохранённые провайдеры и задаются имена и возможности моделей. **Task-модели** закрепляют небольшую быструю модель за фоновой работой — названием разговоров и написанием стартовых подсказок — и при пустом значении используют активную модель по умолчанию. Речь объединяет синтез и распознавание речи; мультимодальная генерация объединяет модели изображений и видео. В разделе Партнёры и агенты настраиваются локальные агентные среды и удалённый шлюз Hermes.
@@ -625,7 +624,7 @@ Co-Writer — это разделённое рабочее пространст
**Video Learning** в разделе Настройки → Обучение и разговоры настраивает субтитры YouTube и доступ к Invidious для Reading. Чтобы использовать Invidious, задайте управляемый администратором адрес его серверного API (например, `http://127.0.0.1:3000`) и публичный адрес, доступный из браузера, проверьте подключение, выберите Invidious и сохраните настройки. Кнопка **Просмотр Invidious** в диалоге добавления материалов Reading позволяет искать видео и открывать подключённые подписки и плейлисты. YouTube воспроизводится через официальный плеер с повышенной конфиденциальностью; отсутствие субтитров явно отображается и ограничивает доказательную базу репетитора, но не мешает нативному воспроизведению. Установите `.[video-learning]` для загрузчика субтитров YouTube по умолчанию. Существующие ссылки Watching переносятся в Reading с сохранением истории разговоров, совместимых транскриптов, заметок и прогресса; новые заметки с временными метками становятся аннотациями Reading. Bilibili использует собственный способ воспроизведения и получения субтитров.
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="Настройки внешнего вида и темы DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="Настройки внешнего вида и темы DeepTutor" width="900">
</div>
Большинство разделов используют поток черновика и применения, поэтому вы можете протестировать провайдера перед подтверждением. Вы также можете просто попросить об этом в Chat: ассистент читает текущую конфигурацию, применяет изменение и сообщает, требуется ли перезапуск или переиндексация — предварительно проверяя новую модель перед её применением, поэтому он не может переключить себя на что-то недостижимое. API-ключи никогда не проходят через модель — вместо этого она открывает для вас соответствующую форму. В комплект входят четыре темы — Default, Cream, Dark и Glass. Корневые файлы `.env` проекта намеренно игнорируются; конфигурация среды выполнения хранится в `data/user/settings/*.json`, если только `DEEPTUTOR_HOME` или `deeptutor start --home` не указывает приложению другое место.
diff --git a/assets/README/README_TH.md b/assets/README/README_TH.md
index 5e9fba1d6..5a9f45e09 100644
--- a/assets/README/README_TH.md
+++ b/assets/README/README_TH.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="โลโก้ DeepTutor" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor: การสอนพิเศษส่วนตัวตลอดชีวิต
@@ -430,16 +430,15 @@ DeepTutor แยกโค้ดที่ติดตั้ง, runtime home ส
หากคำตอบทำข้อกำหนดก่อนหน้าหลุดหาย, อ้างหลักฐานที่อ่อน หรือไม่สอดคล้องกับสื่อที่เลือก ให้รวบรวมข้อมูลวินิจฉัยตาม [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md) ก่อนเปิด issue
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="หน้าแรก DeepTutor — workspace Chat พร้อมทุกส่วนในแถบด้านข้าง" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **สถานะภาพหน้าจอ:** ภาพภาพรวมเป็นเวอร์ชัน v1.6.5 ส่วนภาพหน้าจอรายการด้านล่างยังเป็นข้อมูลอ้างอิง v1.4.6 ระหว่างการอัปเดต ใช้เพื่อทำความเข้าใจขั้นตอนการใช้งาน ไม่ใช่การนำทางปัจจุบันแบบเป๊ะ
<details>
<summary><b>🏗️ สถาปัตยกรรมระบบ</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="สถาปัตยกรรมระบบ DeepTutor" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="สถาปัตยกรรมระบบ DeepTutor" width="900">
</div>
</details>
@@ -450,13 +449,13 @@ DeepTutor แยกโค้ดที่ติดตั้ง, runtime home ส
Chat คือความสามารถเริ่มต้นและสถานที่ที่งานส่วนใหญ่เริ่มต้น thread เดียวสามารถพูดคุยตามปกติ, เรียกเครื่องมือ, อ้างอิงใน knowledge bases ที่เลือก, อ่านไฟล์แนบ, สร้างรูปภาพ, ปรึกษา subagents, เขียน notebook records และดำเนินการต่อด้วยบริบทเดียวกันตลอด turns
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="workspace Chat ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="workspace Chat ของ DeepTutor" width="900">
</div>
ลูปนั้นเรียบง่ายโดยเจตนา: model คิดในรอบ ๆ, เรียกเครื่องมือเมื่อมีประโยชน์, สังเกตผลลัพธ์ และจบด้วยข้อความที่ไม่มีเครื่องมือ `ask_user` เป็นพิเศษ — แทนที่จะเดา agent สามารถหยุด turn, ถามคำถามชี้แจงที่มีโครงสร้าง และดำเนินการต่อเมื่อคุณตอบ
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="ลูป agent ของ Chat ใน DeepTutor" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="ลูป agent ของ Chat ใน DeepTutor" width="900">
</div>
เครื่องมือที่ผู้ใช้สลับได้ ได้แก่ `brainstorm`, `web_search`, `paper_search`, `zotero_search`, `reason`, และ `geogebra_analysis` — รวมถึง `imagegen` และ `videogen` เมื่อคุณกำหนดค่าโมเดลสร้างที่ตรงกัน เครื่องมือตามบริบทเช่น `rag`, `kb_files`, `knowledge_frontier`, `read_source`, `read_memory`, `write_memory`, `read_skill`, `load_tools`, `exec`, `web_fetch`, `ask_user`, `list_notebook`, `write_note`, `question_bank`, `github`, `consult_subagent`, `workspace_list`, `workspace_read`, `workspace_search`, `workspace_present` และ `workspace_export` จะ mount อัตโนมัติเมื่อ turn มีบริบทที่ถูกต้อง
@@ -471,7 +470,7 @@ Home ทำให้ **Chat**, **Ask Questions**, **Quiz** และ **Visualize
<summary><b>🤝 Partner — เพื่อนถาวรบนสมองเดียวกัน</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="workspace Partners ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="workspace Partners ของ DeepTutor" width="900">
</div>
Partners คือเพื่อนถาวรที่มี soul, นโยบาย model, ห้องสมุด, memory และช่องทางของตัวเอง พวกเขาไม่ใช่เอ็นจิน bot แยกต่างหาก: ทุกข้อความ web หรือ IM ที่เข้ามาจะกลายเป็น turn ปกติของ `ChatOrchestrator` ภายใน workspace ที่มีขอบเขต partner partner คือ "chat ที่มีบุคลิกภาพและหมายเลขโทรศัพท์"
@@ -483,7 +482,7 @@ Partners คือเพื่อนถาวรที่มี soul, นโย
แต่ละ partner มี `SOUL.md`, การเลือก model, ช่องทาง, นโยบายเครื่องมือ และไลบรารีที่กำหนด ไลบรารีสามารถคัดลอก knowledge bases, skills และ notebooks ไปยัง `data/partners/<id>/workspace/` หรือคงการเชื่อมโยงกับไฟล์และทรัพยากรของ workspace ที่มีอยู่ โดย soul, บทสนทนา และ Partner memory ยังคงแยกจากกัน ผู้ใช้ที่ผ่านการยืนยันตัวตนและไม่ใช่ admin จะมี Partner sessions และ relationship memory แบบส่วนตัว ขณะที่ Partner อ่าน personal memory ของพวกเขาแบบ read-only; traffic ของ admin, group และที่ไม่ผูกบัญชีจะใช้ shared Partner scope
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="การกำหนดค่าช่องทาง IM ต่อ partner" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="การกำหนดค่าช่องทาง IM ต่อ partner" width="900">
</div>
ชั้น channel ที่ขับเคลื่อนด้วย schema สามารถเชื่อมต่อกับแพลตฟอร์ม IM ได้แก่ Feishu, Telegram, Slack, Discord, DingTalk, QQ/NapCat, WeCom, WhatsApp, Zulip, Mattermost, Matrix, Mochat และ Microsoft Teams ขึ้นอยู่กับ extras ที่ติดตั้งและ credentials ที่กำหนดค่า partner ยังสามารถเชื่อมต่อเป็น subagent และปรึกษาได้จาก chat turn ปกติ — ดู **My Agents** ด้านล่าง
@@ -496,7 +495,7 @@ Partners คือเพื่อนถาวรที่มี soul, นโย
<summary><b>🧑‍🚀 My Agents — ปรึกษาและนำเข้า Agents อื่น ๆ</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="workspace My Agents ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="workspace My Agents ของ DeepTutor" width="900">
</div>
My Agents เปลี่ยน agent อื่น ๆ ให้กลายเป็นบริบทสำหรับ DeepTutor และทำสองสิ่งที่แตกต่างกัน **เชื่อมต่อ agent แบบสด** — Claude Code, Codex, Grok CLI, Antigravity, Kimi, opencode, MiMo Code, Hermes Agent, OpenClaw หรือ DeepSeek Harness บนเครื่องของคุณ, Hermes gateway ระยะไกล หรือหนึ่งใน Partners ของคุณ — และปรึกษามันจากภายใน chat turn: DeepTutor จริง ๆ *รัน* agent อื่นและ stream งานเข้าสู่แผง Activity ผ่านเครื่องมือ `consult_subagent` เลือก agent และขีดจำกัดจำนวนรอบด้วย Agent chip หรือใช้ `@` กรองรายการ agent ที่เชื่อมต่อชุดเดียวกัน; การเลือกนี้จะผูกติดกับ session
@@ -528,7 +527,7 @@ private thought payloads จะถูกละเว้น Cross-session memory
ของเบราว์เซอร์จะเข้าไม่ถึง
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="การปรึกษา subagent Claude Code แบบสด" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**นำเข้าบทสนทนาในอดีต** — นำประวัติ ChatGPT, Claude Code และ Codex ที่มีอยู่ของคุณมาเป็นบทสนทนาที่ค้นหาได้และสามารถดำเนินการต่อได้ เลือก `conversations.json` จาก official ChatGPT data export เพื่อทำ snapshot import ที่ปลอดภัยและ idempotent, เลือกประวัติ Claude ตาม project / working directory หรือเลือกประวัติ Codex ตามวันที่ในปฏิทิน agent แบบโฟลเดอร์ยังคงรีเฟรชได้ ทำให้ขอบเขตที่เลือกไว้ดึงบทสนทนาใหม่เข้ามาได้ อ้างอิงรายการหนึ่งจาก Chat turn ผ่าน `+` → My Agents และ DeepTutor จะอ่านมันเป็น transcript ของบุคคลที่สาม — มันยังคงเป็นบทสนทนา *ของพวกเขา* ไม่ใช่เสียงของ DeepTutor เอง
@@ -539,13 +538,13 @@ private thought payloads จะถูกละเว้น Cross-session memory
<summary><b>✍️ Co-Writer — การร่าง Markdown ที่รับรู้การเลือก</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="workspace Co-Writer ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer คือ workspace Markdown แบบ split-view สำหรับรายงาน, บทเรียน, บันทึก และ artifacts การเรียนรู้แบบยาว เอกสารบันทึกอัตโนมัติและแสดงตัวอย่างสด (คณิตศาสตร์ KaTeX, diagram fences) และสามารถบันทึกกลับเข้า notebooks เมื่อร่างกลายเป็นบริบทที่นำมาใช้ซ้ำได้ นำเข้า `.docx` เพื่อเริ่มร่างใหม่ และส่งออกตัวแก้ไขปัจจุบันเป็น Markdown หรือ Word
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="ตัวแก้ไข Co-Writer พร้อมตัวอย่างแบบสด" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
แนวคิดหลักคือ **การแก้ไขเฉพาะจุด**: เลือกช่วงและขอให้ DeepTutor เขียนใหม่, ขยาย หรือย่อ เลือกโมเดลสำหรับการแก้ไขได้; โมเดลสามารถใช้ knowledge base หรือหลักฐานเว็บ และเก็บ trace ของ tool calls หาก draft ไม่เปลี่ยนระหว่างทำงาน ผลลัพธ์จะแทนที่ข้อความที่เลือกโดยตรงและยังย้อนกลับได้ด้วย **Undo**
@@ -556,17 +555,17 @@ Co-Writer คือ workspace Markdown แบบ split-view สำหรับ
<summary><b>📖 Book — หนังสือมีชีวิตจากเนื้อหาของคุณ</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="คลังหนังสือของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="คลังหนังสือของ DeepTutor" width="900">
</div>
Book แปลงแหล่งที่มาที่เลือกให้เป็น **หนังสือมีชีวิต** แบบโต้ตอบ — ไม่ใช่ PDF แบบคงที่ แต่เป็นสภาพแวดล้อมการอ่านที่สร้างจาก typed blocks หนังสือสามารถเริ่มจาก knowledge bases, notebooks, question banks หรือประวัติ chat; ขั้นตอนการสร้างจะเสนอ outline บทก่อนที่จะสร้างเนื้อหา ดังนั้นคุณจะตรวจสอบรูปร่างแทนที่จะยอมรับ output แบบ one-shot ที่มองไม่เห็น
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="บล็อก quiz ใน Book" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="บล็อก quiz ใน Book" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="บล็อกแอนิเมชัน Manim ใน Book" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="บล็อกวิดเจ็ตแบบโต้ตอบใน Book" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="บล็อกวิดเจ็ตแบบโต้ตอบใน Book" width="31%">
</p>
แต่ละบทคอมไพล์เป็น typed blocks ที่แก้ไขได้ — text, callouts, quizzes, flash cards, timelines, code, figures, interactive HTML, animations, concept graphs, deep dives และ user notes — พร้อม Page Chat ของบทนั้นเอง คุณสามารถแทรก, ย้าย, สร้างใหม่, เขียนใหม่ หรือสลับประเภท block ได้; ข้อความบางช่วงที่เลือกไว้จะเข้าสู่กล่องรายการ learning capture สำหรับตรวจทาน ความคืบหน้า, bookmarks, ครั้งที่ทำ quiz, captures และ Page Chat ยังคงเป็นส่วนตัวสำหรับผู้อ่านแต่ละคน แม้หนังสือจาก admin จะถูกแชร์แบบอ่านอย่างเดียวหรือเปิดให้แก้ไขร่วมกัน; การลบหนังสือที่แชร์ยังคงทำได้เฉพาะ admin หนังสือทุกเล่ม export เป็น Markdown ได้, การคอมไพล์ที่ใช้เวลานานหยุดพักและทำต่อได้ และ `deeptutor book health` / `refresh-fingerprints` จะตรวจจับความเปลี่ยนแปลงของแหล่งข้อมูล
@@ -577,13 +576,13 @@ Book แปลงแหล่งที่มาที่เลือกให้
<summary><b>📚 Knowledge Center — ไลบรารี RAG หลายเอ็นจิน</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor Knowledge Center" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="DeepTutor Knowledge Center" width="900">
</div>
Knowledge bases คือคอลเลกชันเอกสารที่อยู่เบื้องหลัง RAG — รองรับ Chat turns, Co-Writer edits, Book generation และบทสนทนา Partner สิ่งที่โดดเด่นคือ **การเลือกเอ็นจิน retrieval**: **LlamaIndex** (ค่าเริ่มต้น, hybrid vector + BM25 พร้อม cross-encoder reranking แบบเสริม และ FAISS indexes แบบ exact-flat หรือ HNSW), **PageIndex** (reasoning retrieval พร้อม page-level citations, hosted หรือ self-hosted OSS), **GraphRAG** และ **LightRAG** (knowledge-graph retrieval), **LightRAG Server** (retrieval ที่ offload ไปยัง LightRAG instance ภายนอกที่คุณเชื่อมต่อผ่าน HTTP), **WeKnora** (retrieval จาก knowledge base ใน deployment แบบ self-hosted ของคุณ โดยไม่มี local index หรือสำเนาเอกสาร), **Tencent IMA** (ไลบรารีที่คุณคัดสรรใน IMA — ค้นหา เรียกดู และเขียนกลับผ่าน OpenAPI ของมัน), **MarginNote 4** (ข้อมูลการเรียนใน MN4 ของคุณ — เอกสาร ข้อความที่คัดไว้ การ์ด mind-map และความเชื่อมโยงระหว่างสิ่งเหล่านั้น — ที่ถูกส่งเข้ามาโดย Add-on ของแอปและนำทางได้ด้วยเครื่องมือเฉพาะ), **Kiwix** (ZIM archive ที่ค้นหาได้ซึ่งให้บริการผ่าน HTTP โดยไม่ต้องทำ local indexing) หรือ **Obsidian** vault ที่เชื่อมโยง tutor อ่านและเขียนในที่ KB แต่ละอันถูกผูกกับเอ็นจินหนึ่ง
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="สร้าง knowledge base" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="สร้าง knowledge base" width="900">
</div>
กำลังย้ายไลบรารี Obsidian, Hermes หรือ Markdown ที่มีอยู่ใช่ไหม ดู [คู่มือการย้ายข้อมูล Knowledge](../../docs-for-user/KNOWLEDGE_MIGRATION.md) สำหรับเส้นทางแบบ connected-vault และ indexed-copy
@@ -606,13 +605,13 @@ Knowledge bases คือคอลเลกชันเอกสารที่
<summary><b>🌐 Learning Space — Skills, Personas และบริบทที่นำมาใช้ซ้ำได้</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="ศูนย์กลาง Learning Space ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Space คือชั้น library, organization และ personalization **Conversations & Materials** เก็บ Chat History, notebooks ที่ย้าย records และ export เป็น Markdown ได้ และ question bank พร้อมคำตอบและคำอธิบาย เริ่ม **Practice** จากคำถามที่เลือกใน question bank หรือจาก Personalized Learning เพื่อทบทวน ติดตามข้อผิดพลาด และทบทวนซ้ำตามกำหนด **Personalization** เก็บ personas, skills (`SKILL.md` playbooks), **MCP Services** แบบคลิกเดียว และ **CLI Apps** จาก catalog [CLI-Anything](https://github.com/HKUDS/CLI-Anything) โดยแต่ละรายการมีคู่มือการใช้งานที่โหลดตามต้องการ workspace **My Courses** ที่แยกออกมาจะจัดกลุ่มบทสนทนาตามวิชาและ tutor threads; asset แต่ละรายการจะแสดงเฉพาะในเวิร์กโฟลว์ที่รองรับเท่านั้น
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="นำเข้า skills จาก EduHub" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
คุณไม่จำเป็นต้องเขียน skill ทุกอันเอง — **นำเข้าจาก EduHub** จะเรียกดู catalog ชุมชนและดาวน์โหลด skill ตรงเข้า library ผ่านประตูความปลอดภัย (ดู [ระบบนิเวศ](#-ระบบนิเวศ--eduhub-และชุมชน-skills))
@@ -623,13 +622,13 @@ Learning Space คือชั้น library, organization และ personaliza
<summary><b>🧠 Memory — การปรับแต่งส่วนบุคคลที่ตรวจสอบได้</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="ภาพรวม Memory ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="ภาพรวม Memory ของ DeepTutor" width="900">
</div>
Memory คือระบบไฟล์สามชั้นที่คุณอ่าน, จัดการ และตรวจสอบได้ — โดยเจตนาไม่ใช่ vector store ที่ซ่อนอยู่ **L1** คือ workspace mirror พร้อม append-only event trace (`trace/<surface>/<date>.jsonl`); **L2** คือข้อเท็จจริงที่จัดการต่อพื้นผิว (`L2/<surface>.md`) พร้อมการอ้างอิงถึงเอนทิตี L1; **L3** คือการสังเคราะห์ข้ามพื้นผิว (`L3/<profile|recent|scope|preferences>.md`) ที่บันทึกพื้นผิว L2 ซึ่งมีส่วนร่วม
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="กราฟ Memory ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="กราฟ Memory ของ DeepTutor" width="900">
</div>
Memory Graph แสดงพีระมิดทั้งหมด — การสังเคราะห์ L3 ที่ศูนย์กลาง, L2 ในวงกลาง, L1 traces ด้านนอก — พร้อมเส้นเชื่อมหลักฐาน L2 → L1 ที่ตรงตัว และลิงก์ L3 → พื้นผิวที่มีส่วนร่วม Memory ถูกติดตามใน surfaces: `chat`, `notebook`, `quiz`, `kb`, `book`, partner และ `cowriter`; งบประมาณ Update / Audit / Dedup ของ consolidator ปรับได้ใน **Settings → Memory**
@@ -640,7 +639,7 @@ Memory Graph แสดงพีระมิดทั้งหมด — กา
<summary><b>⚙️ Settings — Control Plane เดียว</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="ศูนย์กลาง Settings ของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings คือศูนย์ควบคุมการทำงาน โดยเปิดที่หน้า **General** สำหรับภาษา UI และภาษา output ของ model ตัวนำทางที่ค้นหาได้เชื่อมไปยังหน้าแยกกัน: **Personal** ครอบคลุม Workspaces, Data migration, Appearance และ Usage statistics; **Learning & conversation** ครอบคลุมจุดเริ่มต้น ไฟล์แนบ Video Learning การควบคุมผู้เรียนและผู้ปกครอง Learning progress และ Memory; **Models & services** ครอบคลุม Providers, Language models, Task models, Embedding, Search, Voice และ Multimodal generation; **Features & integrations** ครอบคลุมเครื่องมือ พารามิเตอร์ความสามารถ Partners & agents และ Knowledge & documents **System** มี Network, Runtime status และ About; **Archived chats** ใช้ค้นหา กู้คืน หรือลบบทสนทนาที่เก็บถาวรอย่างถาวร Runtime status แสดงสถานะ backend, resident memory และเมทริกซ์ **Readiness** ที่ประเมินปัญหาที่ขัดขวาง คำเตือน และข้อเสนอแนะของความสามารถ Workspaces แยกไฟล์แต่ละหัวข้อและสถานะการเรียน โดยมีการย้ายข้อมูลที่ตรวจสอบแล้วและการส่งออกใน Data migration **provider** เก็บที่อยู่และ credential ของผู้ให้บริการเพื่อให้ model ของบริการนั้นใช้ซ้ำได้ หน้า model เลือก provider ที่บันทึกไว้และกำหนดชื่อและความสามารถของ model **Task models** กำหนด model ขนาดเล็กที่รวดเร็วสำหรับงานเบื้องหลัง เช่น การตั้งชื่อบทสนทนาและเขียนจุดเริ่มต้น และใช้ model เริ่มต้นที่ใช้งานอยู่เมื่อปล่อยว่าง Voice รวมการสังเคราะห์เสียงพูดและการถอดเสียง ส่วน Multimodal generation รวม model ภาพและวิดีโอ Partners & agents กำหนดค่า harness ในเครื่องและ Hermes gateway ระยะไกล
@@ -653,7 +652,7 @@ Settings คือศูนย์ควบคุมการทำงาน โ
**Video Learning** ภายใต้ Settings → Learning & conversation กำหนดค่าคำบรรยาย YouTube และการเข้าถึง Invidious สำหรับ Reading หากต้องการใช้ Invidious ให้ตั้งค่า backend API origin ที่ผู้ดูแลระบบจัดการ (ตัวอย่างเช่น `http://127.0.0.1:3000`) และ public origin ที่เบราว์เซอร์เข้าถึงได้ ทดสอบการเชื่อมต่อ เลือก Invidious แล้วบันทึก **Browse Invidious** ในกล่องเพิ่มสื่อของ Reading ใช้ค้นหาวิดีโอและเข้าถึง subscriptions และ playlists ที่เชื่อมต่อไว้ การเล่น YouTube ใช้ player อย่างเป็นทางการที่เพิ่มความเป็นส่วนตัว; หากไม่มีคำบรรยาย ระบบจะแสดงสถานะนี้และจำกัดหลักฐานที่ tutor ใช้ โดยไม่ปิดกั้นการเล่นแบบ native ติดตั้ง `.[video-learning]` สำหรับตัวโหลดคำบรรยาย YouTube เริ่มต้น ลิงก์ Watching ที่มีอยู่จะย้ายเข้า Reading โดยรักษาประวัติการสนทนา transcript ที่เข้ากันได้ notes และความคืบหน้าไว้; notes ที่อ้างอิง timestamp รายการใหม่จะเป็น annotations ของ Reading ส่วน Bilibili ใช้เส้นทางการเล่นและคำบรรยายของตัวเอง
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="การตั้งค่ารูปลักษณ์และธีมของ DeepTutor" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="การตั้งค่ารูปลักษณ์และธีมของ DeepTutor" width="900">
</div>
ส่วนส่วนใหญ่ใช้ draft-and-apply flow เพื่อให้คุณทดสอบ provider ก่อนยืนยัน คุณยังสามารถแค่ถามใน Chat ได้เช่นกัน: ผู้ช่วยจะอ่านการกำหนดค่าปัจจุบัน, ใช้การเปลี่ยนแปลง และบอกว่าจำเป็นต้องรีสตาร์ทหรือ re-index หรือไม่ — โดยทดสอบ model ใหม่ก่อนที่จะยืนยัน จึงไม่สามารถเปลี่ยนตัวเองไปยังสิ่งที่เข้าถึงไม่ได้ API keys จะไม่ผ่านเข้าไปใน model เลย ซึ่งจะเปิดฟอร์มที่ตรงกันให้คุณแทน ธีมสี่แบบมาในกล่อง — Default, Cream, Dark และ Glass ไฟล์ `.env` ที่ root ของโปรเจกต์ถูกเพิกเฉยโดยเจตนา; การกำหนดค่า runtime อยู่ใน `data/user/settings/*.json` เว้นแต่ `DEEPTUTOR_HOME` หรือ `deeptutor start --home` จะชี้แอปไปที่อื่น
diff --git a/assets/README/README_TW.md b/assets/README/README_TW.md
index cb2f2f886..884c1ef64 100644
--- a/assets/README/README_TW.md
+++ b/assets/README/README_TW.md
@@ -1,6 +1,6 @@
<div align="center">
-<p align="center"><img src="../../assets/figs/logo/logo.png" alt="DeepTutor 標誌" height="56" style="vertical-align: middle;">&nbsp;<img src="../../assets/figs/logo/banner.png" alt="DeepTutor" height="48" style="vertical-align: middle;"></p>
+<p align="center"><img src="../../assets/figs/logo/color-full.png" alt="DeepTutor" width="480"></p>
# DeepTutor:終身個人化學習導師
@@ -422,16 +422,15 @@ DeepTutor 會將已安裝的程式碼、私有執行環境目錄與選用的內
如果回答遺漏先前限制、引用薄弱證據,或與所選素材不一致,請先將診斷資料收集到 [`REASONING_SAFETY_CHECKLIST.md`](../../docs-for-user/REASONING_SAFETY_CHECKLIST.md),再建立 issue。
<div align="center">
-<img src="../../assets/figs/web-1.6.5/OVERVIEW.png" alt="DeepTutor 首頁 — 側邊欄包含所有功能入口的 Chat 工作區" width="900">
+<img src="../../assets/figs/web-dev/overview.png" alt="DeepTutor Home and workspace navigation" width="900">
</div>
-> **截圖狀態:** 總覽圖已更新到 v1.6.5。下方功能截圖仍是 v1.4.6 參考圖,正在分批替換。它們適合說明工作流,不代表目前精確導覽。
<details>
<summary><b>🏗️ 系統架構</b></summary>
<div align="center">
-<img src="../../assets/figs/system/system%20architecture.png" alt="DeepTutor 系統架構" width="900">
+<img src="../../assets/figs/system/system-architecture.svg" alt="DeepTutor 系統架構" width="900">
</div>
</details>
@@ -442,13 +441,13 @@ DeepTutor 會將已安裝的程式碼、私有執行環境目錄與選用的內
Chat 是預設能力,也是大多數工作的起點。單一對話可以進行一般交談、呼叫工具、根據選定的知識庫建立回答依據、讀取附件、生成影像、諮詢子代理程式、寫入筆記本紀錄,並在各回合之間沿用相同情境。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/00-overview.png" alt="DeepTutor Chat 工作區" width="900">
+<img src="../../assets/figs/web-dev/chat.png" alt="DeepTutor Chat 工作區" width="900">
</div>
這個迴圈刻意保持簡單:模型分輪思考、在有幫助時呼叫工具、觀察結果,最後以不含工具呼叫的訊息完成回合。`ask_user` 比較特殊;代理程式不必猜測,而是可以暫停回合、提出結構化的釐清問題,並在你回答後繼續。
<div align="center">
-<img src="../../assets/figs/system/chat-agent-loop.png" alt="DeepTutor Chat 代理程式迴圈" width="900">
+<img src="../../assets/figs/system/chat-agent-loop.svg" alt="DeepTutor Chat 代理程式迴圈" width="900">
</div>
使用者可切換的工具包括 `brainstorm`、`web_search`、`paper_search`、`zotero_search`、`reason` 與 `geogebra_analysis`;設定對應的生成模型後,還會有 `imagegen` 與 `videogen`。`rag`、`kb_files`、`knowledge_frontier`、`read_source`、`read_memory`、`write_memory`、`read_skill`、`load_tools`、`exec`、`web_fetch`、`ask_user`、`list_notebook`、`write_note`、`question_bank`、`github`、`consult_subagent`、`workspace_list`、`workspace_read`、`workspace_search`、`workspace_present` 與 `workspace_export` 等情境式工具,會在回合具有相符情境時自動掛載。
@@ -463,7 +462,7 @@ Home 讓 **Chat**、**Ask Questions**、**Quiz** 與 **Visualize** 一鍵可達
<summary><b>🤝 Partner — 共用同一套核心的持續型夥伴</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/00-partners%20overview.png" alt="DeepTutor Partners 工作區" width="900">
+<img src="../../assets/figs/web-dev/partners.png" alt="DeepTutor Partners 工作區" width="900">
</div>
Partners 是持續運作的夥伴,各自擁有 soul、模型政策、知識庫、記憶與頻道。它們不是另一套 bot 引擎;每一則從 Web 或 IM 收到的訊息,都會在限定於該 partner 的工作區內成為一般的 `ChatOrchestrator` 回合。Partner 就像是「擁有個性與電話號碼的聊天」。
@@ -475,7 +474,7 @@ Partners 是持續運作的夥伴,各自擁有 soul、模型政策、知識庫
每個 partner 都有 `SOUL.md`、模型選擇、頻道、工具政策與指派的資源庫。其資源庫可將知識庫、技能與筆記本複製到 `data/partners/<id>/workspace/`,或保持與既有工作區的檔案和資源連結;soul、對話與 Partner 記憶仍各自獨立。已驗證的非管理員使用者擁有私有的 Partner 工作階段與關係記憶,而 Partner 只能以唯讀方式讀取其個人記憶;管理員、群組與未繫結流量則使用共享的 Partner 範圍。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/partners/02-IM%20config%20for%20each%20partner.png" alt="各 Partner 的 IM 頻道設定" width="900">
+<img src="../../assets/figs/web-dev/partners-channels.png" alt="各 Partner 的 IM 頻道設定" width="900">
</div>
頻道層由結構描述驅動;依已安裝的額外套件與設定的憑證,可連接飛書、Telegram、Slack、Discord、釘釘、QQ/NapCat、企業微信、WhatsApp、Zulip、Mattermost、Matrix、Mochat 與 Microsoft Teams 等 IM 平台。Partner 也可以連接成子代理程式,並從一般聊天回合中接受諮詢;請參閱下方的 **My Agents**。
@@ -488,7 +487,7 @@ Partners 是持續運作的夥伴,各自擁有 soul、模型政策、知識庫
<summary><b>🧑‍🚀 My Agents — 諮詢與匯入其他代理程式</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/myagents/00-overview.png" alt="DeepTutor My Agents 工作區" width="900">
+<img src="../../assets/figs/web-dev/agents.png" alt="DeepTutor My Agents 工作區" width="900">
</div>
My Agents 會將其他代理程式變成 DeepTutor 的情境,並提供兩項不同功能。**連接即時代理程式** — 連接你電腦上的 Claude Code、Codex、Grok CLI、Antigravity、Kimi、opencode、MiMo Code、Hermes Agent、OpenClaw 或 DeepSeek Harness、遠端 Hermes gateway,或你的一位 Partner,並從聊天回合內諮詢它。DeepTutor 會實際*執行*其他代理程式,再透過 `consult_subagent` 工具將其工作即時串流至 Activity 面板。使用 Agent chip 選取代理程式及其回合上限,或透過 `@` 篩選同一份已連接代理程式清單;這項選擇會保留在工作階段中。
@@ -500,7 +499,7 @@ My Agents 會將其他代理程式變成 DeepTutor 的情境,並提供兩項
Grok 使用自己的驗證與工作階段儲存機制,DeepTutor 不會複製其憑證。後續諮詢會在同一個工作目錄中續接該連線的工作階段。文字與工具活動會即時串流;私密的思考內容則會被省略。跨工作階段的 Grok 記憶預設為停用。此連接器支援文字問答與 CLI 工具,不支援影像轉發或匯入過往的 Grok 對話。在 Docker 中,請於後端容器內安裝並驗證 Grok;只安裝在瀏覽器所在電腦上的 CLI 無法被存取。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/home/08-subagent%20demo%20with%20claude%20code.png" alt="即時諮詢 Claude Code 子代理程式" width="900">
+<img src="../../assets/figs/web-dev/personalization.png" alt="Account personalization: agents, personas, skills, and connections" width="900">
</div>
**匯入過往對話** — 將現有的 ChatGPT、Claude Code 與 Codex 記錄匯入為可搜尋、可繼續的對話。選取官方 ChatGPT 資料匯出中的 `conversations.json`,即可進行安全且具冪等性的快照匯入;Claude 記錄依專案/工作目錄選取,Codex 記錄則依日曆日期選取。以資料夾為基礎的代理程式仍可重新整理,讓其選定範圍拉取新對話。你可以在 Chat 回合中透過 `+` → My Agents 參照其中一段對話;DeepTutor 會將其讀作第三方逐字稿,保留為*對方*的對話,而不是 DeepTutor 自己的口吻。
@@ -511,13 +510,13 @@ Grok 使用自己的驗證與工作階段儲存機制,DeepTutor 不會複製
<summary><b>✍️ Co-Writer — 能感知選取範圍的 Markdown 寫作</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/00-overview.png" alt="DeepTutor Co-Writer 工作區" width="900">
+<img src="../../assets/figs/web-dev/co-writer.png" alt="Learning notebook pages" width="900">
</div>
Co-Writer 是用於報告、教學文章、筆記與長篇學習作品的分割檢視 Markdown 工作區。文件會自動儲存並呈現即時預覽(KaTeX 數學式、圖解 fences);草稿成為可重複使用的情境後,也能存回筆記本。可匯入 `.docx` 開新草稿,也可將目前編輯器匯出為 Markdown 或 Word。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/co-writer/01-edit%20panel.png" alt="Co-Writer 編輯器與即時預覽" width="900">
+<img src="../../assets/figs/web-dev/notebook-detail.png" alt="Learning notebook block editor and Dito" width="900">
</div>
它的核心概念是**精準編輯**:選取一段內容,請 DeepTutor 改寫、擴寫或縮短。你可以選擇編輯模型;它可以知識庫或 Web 證據作為修改依據,並保留工具呼叫軌跡。若模型工作期間草稿未發生變更,結果會直接取代所選文字,且仍可使用 **Undo** 復原。
@@ -528,17 +527,17 @@ Co-Writer 是用於報告、教學文章、筆記與長篇學習作品的分割
<summary><b>📖 Book — 從你的素材建立活書</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/book/00-book_overview.png" alt="DeepTutor 書籍庫" width="900">
+<img src="../../assets/figs/web-dev/books.png" alt="DeepTutor 書籍庫" width="900">
</div>
Book 會將選定來源轉換成互動式**活書**;它不是靜態 PDF,而是由具型別區塊組成的閱讀環境。書籍可從知識庫、筆記本、題庫或聊天記錄建立;生成內容前,建立流程會先提出章節大綱,讓你審視整體架構,而非直接接受無從確認的單次輸出。
<p align="center">
-<img src="../../assets/figs/web-1.4.6+/book/01-book-demo-quiz%20card.png" alt="Book 測驗區塊" width="31%">
+<img src="../../assets/figs/web-dev/book-quiz.png" alt="Book 測驗區塊" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/02-book-demo-manim%20video.png" alt="Book Manim 動畫區塊" width="31%">
+<img src="../../assets/figs/web-dev/book-detail.png" alt="Book outline and chapters" width="31%">
&nbsp;
-<img src="../../assets/figs/web-1.4.6+/book/03-book-demo%20interactive%20module.png" alt="Book 互動式元件區塊" width="31%">
+<img src="../../assets/figs/web-dev/book-widget.png" alt="Book 互動式元件區塊" width="31%">
</p>
每章都會編譯成可編輯的具型別區塊:文字、提示框、測驗、單字卡、時間軸、程式碼、圖表、互動式 HTML、動畫、概念圖、深入探討與使用者筆記,並有自己的 Page Chat。你可以插入、移動、重新生成、重寫區塊或切換其型別;選取的段落會進入可供檢視的學習摘錄收件匣。即使管理員將書籍以唯讀或共同編輯方式共享,每位讀者的進度、書籤、測驗嘗試、學習摘錄與 Page Chat 仍為私有;共享書籍仍只能由管理員刪除。任何書籍皆可匯出為 Markdown,長時間的編譯可暫停並續行,`deeptutor book health`/`refresh-fingerprints` 會標記來源漂移。
@@ -549,13 +548,13 @@ Book 會將選定來源轉換成互動式**活書**;它不是靜態 PDF,而
<summary><b>📚 Knowledge Center — 多引擎 RAG 知識庫</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/00-overview.png" alt="DeepTutor Knowledge Center" width="900">
+<img src="../../assets/figs/web-dev/knowledge.png" alt="DeepTutor Knowledge Center" width="900">
</div>
知識庫是 RAG 背後的文件集合,可為 Chat 回合、Co-Writer 編輯、Book 生成與 Partner 對話提供依據。其特色在於可**選擇檢索引擎**:**LlamaIndex**(預設,混合 vector+BM25,並可選用 cross-encoder reranking 與 exact-flat 或 HNSW FAISS 索引)、**PageIndex**(可推理的檢索並附頁面層級引用,支援託管式或自架 OSS)、**GraphRAG** 與 **LightRAG**(知識圖譜檢索)、**LightRAG Server**(透過 HTTP 連接的外部 LightRAG 執行個體負責檢索)、**WeKnora**(從自架部署中的知識庫檢索,無須建立本機索引或複製文件)、**Tencent IMA**(在 IMA 中整理的知識庫 — 透過其 OpenAPI 進行搜尋、瀏覽與寫回)、**MarginNote 4**(你的 MN4 學習資料 — 文件、摘錄、思維導圖卡片及彼此之間的連結 — 由該應用程式的 Add-on 推送匯入,並透過專用工具進行導覽)、**Kiwix**(透過 HTTP 提供的可搜尋 ZIM 封存檔,無須建立本機索引),或讓導師就地讀寫的已連結 **Obsidian** vault。每個知識庫都會繫結至單一引擎。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/knowledge/01-create%20knowledge%20base.png" alt="建立知識庫" width="900">
+<img src="../../assets/figs/web-dev/knowledge-create.png" alt="建立知識庫" width="900">
</div>
要遷移現有的 Obsidian、Hermes 或 Markdown 知識庫嗎?請參閱 [Knowledge 遷移指南](../../docs-for-user/KNOWLEDGE_MIGRATION.md),了解連結 vault 與索引副本兩種方式。
@@ -578,13 +577,13 @@ Book 會將選定來源轉換成互動式**活書**;它不是靜態 PDF,而
<summary><b>🌐 Learning Space — 技能、角色設定與可重複使用的情境</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/00-overview.png" alt="DeepTutor Learning Space 中心" width="900">
+<img src="../../assets/figs/web-dev/resources.png" alt="Resources in the active workspace" width="900">
</div>
Learning Space 是資源庫、組織與個人化層。**Conversations & Materials** 包含 Chat History、支援搬移紀錄與匯出 Markdown 的筆記本,以及含答案與解說的題庫。從選定的題庫題目或 Personalized Learning 啟動 **Practice**,即可進行複習工作階段、錯題追蹤與定期複習。**Personalization** 包含角色設定、技能(`SKILL.md` 操作手冊)、一鍵安裝的 **MCP Services**,以及來自 [CLI-Anything](https://github.com/HKUDS/CLI-Anything) 型錄的 **CLI Apps**,每個應用程式的使用指南會按需載入。獨立的 **My Courses** 工作區會依科目歸納對話與導師討論串;每項資產只會出現在支援它的工作流程中。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/learning-space/07-%20download%20skills%20from%20eduhub.png" alt="從 EduHub 匯入技能" width="900">
+<img src="../../assets/figs/web-dev/skills.png" alt="Personalization skill library" width="900">
</div>
你不必自行撰寫每一項技能;**Import from EduHub** 可瀏覽社群型錄,並透過安全閘道將技能直接下載至技能庫(參閱[生態系](#-生態系--eduhub-與技能社群))。
@@ -595,13 +594,13 @@ Learning Space 是資源庫、組織與個人化層。**Conversations & Material
<summary><b>🧠 Memory — 可檢視的個人化</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/00-overview.png" alt="DeepTutor Memory 總覽" width="900">
+<img src="../../assets/figs/web-dev/memory.png" alt="DeepTutor Memory 總覽" width="900">
</div>
Memory 是以檔案為基礎、可讀取、整理及稽核的三層系統;它刻意*不使用*隱藏的向量儲存區。**L1** 是工作區鏡像與僅附加的事件軌跡(`trace/<surface>/<date>.jsonl`);**L2** 是各介面整理後的事實(`L2/<surface>.md`),並附有對 L1 實體的參照;**L3** 是跨介面的綜整(`L3/<profile|recent|scope|preferences>.md`),會記錄其貢獻來源 L2 介面。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/memory/01-3%20layer%20memory%20graph.png" alt="DeepTutor Memory Graph" width="900">
+<img src="../../assets/figs/web-dev/memory-graph.png" alt="DeepTutor Memory Graph" width="900">
</div>
Memory Graph 會呈現完整金字塔:L3 綜整位於中央、L2 位於中圈、L1 軌跡則在外圈,並提供精確的 L2 → L1 證據邊與 L3 → 貢獻來源介面連結。Memory 會追蹤 `chat`、`notebook`、`quiz`、`kb`、`book`、partner 與 `cowriter` 等介面;綜整器的 Update/Audit/Dedup 預算可在 **Settings → Memory** 調整。
@@ -612,7 +611,7 @@ Memory Graph 會呈現完整金字塔:L3 綜整位於中央、L2 位於中圈
<summary><b>⚙️ Settings — 統一控制中心</b></summary>
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/00-setting%20overview.png" alt="DeepTutor Settings 中心" width="900">
+<img src="../../assets/figs/web-dev/settings.png" alt="Settings navigator" width="900">
</div>
Settings 是操作控制中心,開啟時會顯示用於設定介面與模型輸出語言的 **General** 頁面。可搜尋的導覽選單連結至各個獨立頁面:**Personal** 包含 Workspaces、Data migration、Appearance 與 Usage statistics;**Learning & conversation** 包含起始提示、附件、Video Learning、學習者與監護人控制、Learning progress,以及 Memory;**Models & services** 包含 Providers、Language models、Task models、Embedding、Search、Voice 與 Multimodal generation;**Features & integrations** 包含工具、能力參數、Partners & agents,以及 Knowledge & documents。**System** 包含 Network、Runtime status 與 About;**Archived chats** 可搜尋、還原或永久刪除已封存的對話。Runtime status 包含後端健康狀況、常駐記憶體,以及評估各項能力阻礙、警告與建議的 **Readiness** 矩陣。Workspaces 讓不同主題的檔案與學習狀態保持獨立,Data migration 則提供經驗證的遷移與匯出功能。**供應商(provider)**保存廠商位址與憑證,供其服務模型重複使用;模型頁面可選擇已儲存的供應商,並設定模型名稱與能力。**任務模型**可為命名對話、撰寫起始提示等背景工作指定小型快速模型;留空時則使用目前的預設模型。Voice 集合語音合成與轉錄;Multimodal generation 集合影像與影片模型。Partners & agents 可設定本機代理程式執行框架與遠端 Hermes gateway。
@@ -625,7 +624,7 @@ Settings 是操作控制中心,開啟時會顯示用於設定介面與模型
**Video Learning** 位於 Settings → Learning & conversation,可設定 Reading 使用的 YouTube 字幕與 Invidious 存取。若要使用 Invidious,請設定由管理員管理的後端 API 來源(例如 `http://127.0.0.1:3000`)與瀏覽器可存取的公開來源、測試連線、選擇 Invidious 並儲存。Reading 新增素材對話框中的 **Browse Invidious** 可搜尋影片,並存取已連接的訂閱與播放清單。YouTube 播放使用官方隱私強化版播放器;缺少字幕的狀態會明確顯示,並限制導師可用的證據,但不會阻擋原生播放。安裝 `.[video-learning]` 可使用預設的 YouTube 字幕載入器。既有的 Watching 連結會遷移至 Reading,保留對話記錄、相容的逐字稿、筆記與進度;新的時間戳筆記則是 Reading 註解。Bilibili 使用自己的播放與字幕路徑。
<div align="center">
-<img src="../../assets/figs/web-1.4.6+/settings/01-appearance%20settings.png" alt="DeepTutor 外觀設定與主題" width="900">
+<img src="../../assets/figs/web-dev/appearance.png" alt="DeepTutor 外觀設定與主題" width="900">
</div>
大多數區段採用草稿後套用的流程,因此可先測試供應商再確認變更。你也可以直接在 Chat 中提出要求:助理會讀取目前設定、套用變更,並告知是否需要重新啟動或重新建立索引 — 在正式套用新模型前先行探測,因此不會把自己切換到無法連線的設定上。API key 絕不會經過模型,助理會改為替你開啟對應的表單。內建四種主題:Default、Cream、Dark 與 Glass。系統會刻意忽略專案根目錄的 `.env` 檔案;除非 `DEEPTUTOR_HOME` 或 `deeptutor start --home` 將應用程式指向其他位置,否則執行階段設定位於 `data/user/settings/*.json`。
diff --git a/assets/figs/logo/README.md b/assets/figs/logo/README.md
new file mode 100644
index 000000000..463637b06
--- /dev/null
+++ b/assets/figs/logo/README.md
@@ -0,0 +1,18 @@
+# DeepTutor logo assets
+
+The six `color-*` / `black-*` PNGs are the approved source artwork: `logo` is
+the standalone symbol, `word` is the wordmark, and `full` is the combined banner.
+The root README and translated READMEs use `color-full.png`.
+
+After changing these sources, run:
+
+```sh
+npm --prefix web run sync:logo
+```
+
+This crops excess transparent padding without changing the artwork, creates
+web-sized copies in `web/public/brand`, and regenerates square 16/32 px favicons
+and the 180 px Apple touch icon. The application uses `/brand/*` URLs. Legacy
+`/logo.png`, `/logo_black.png`, `/banner.png`, and `/logo-ver2.png` URLs also serve
+the new artwork so existing saved documents keep working. Commit the generated
+public files with any source changes; packaged builds use these public files.
diff --git a/assets/figs/logo/banner.png b/assets/figs/logo/banner.png
deleted file mode 100644
index 4c3380d32..000000000
Binary files a/assets/figs/logo/banner.png and /dev/null differ
diff --git a/assets/figs/logo/black-full.png b/assets/figs/logo/black-full.png
new file mode 100644
index 000000000..5348e16f9
Binary files /dev/null and b/assets/figs/logo/black-full.png differ
diff --git a/assets/figs/logo/black-logo.png b/assets/figs/logo/black-logo.png
new file mode 100644
index 000000000..e5397ef7f
Binary files /dev/null and b/assets/figs/logo/black-logo.png differ
diff --git a/assets/figs/logo/black-word.png b/assets/figs/logo/black-word.png
new file mode 100644
index 000000000..8e3b79324
Binary files /dev/null and b/assets/figs/logo/black-word.png differ
diff --git a/assets/figs/logo/color-full.png b/assets/figs/logo/color-full.png
new file mode 100644
index 000000000..f6a06851f
Binary files /dev/null and b/assets/figs/logo/color-full.png differ
diff --git a/assets/figs/logo/color-logo.png b/assets/figs/logo/color-logo.png
new file mode 100644
index 000000000..b53c37bf9
Binary files /dev/null and b/assets/figs/logo/color-logo.png differ
diff --git a/assets/figs/logo/color-word.png b/assets/figs/logo/color-word.png
new file mode 100644
index 000000000..719700666
Binary files /dev/null and b/assets/figs/logo/color-word.png differ
diff --git a/assets/figs/logo/logo.png b/assets/figs/logo/logo.png
deleted file mode 100644
index fc1a2abd1..000000000
Binary files a/assets/figs/logo/logo.png and /dev/null differ
diff --git a/assets/figs/logo/logo_black.png b/assets/figs/logo/logo_black.png
deleted file mode 100644
index e3f061d55..000000000
Binary files a/assets/figs/logo/logo_black.png and /dev/null differ
diff --git a/assets/figs/system/chat-agent-loop.svg b/assets/figs/system/chat-agent-loop.svg
new file mode 100644
index 000000000..ef36f8ceb
--- /dev/null
+++ b/assets/figs/system/chat-agent-loop.svg
@@ -0,0 +1,59 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="960" viewBox="0 0 1280 960" role="img" aria-labelledby="title desc"><title id="title">DeepTutor · chat capability loop</title><desc id="desc">The chat loop runs inside the durable turn application and streams typed events.</desc><defs><marker id="arrow" markerWidth="9" markerHeight="9" refX="8" refY="4.5" orient="auto"><path d="M0 0 L9 4.5 L0 9 Z" fill="#64748b"/></marker></defs><style>text{font-family:Arial,Helvetica,sans-serif;fill:#1e293b}.title{font-size:29px;font-weight:700}.label{font-size:21px;font-weight:600}.body{font-size:18px;fill:#475569}.note{font-size:17px;fill:#64748b}.arrow{fill:none;stroke:#64748b;stroke-width:2;marker-end:url(#arrow)}</style><rect width="1280" height="960" fill="#fff"/>
+<text x="40" y="44" class="title">DeepTutor · chat capability loop</text>
+<text x="40" y="76" class="body">The chat loop runs inside the durable turn application and streams typed events.</text>
+<rect x="360" y="112" width="560" height="85" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="380" y="144" class="label">TurnApplicationService → TurnEngine</text>
+<text x="380" y="174" class="body">ChatOrchestrator selects the chat capability</text>
+<path d="M640 197 V240" class="arrow"/>
+<rect x="40" y="240" width="270" height="245" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="60" y="272" class="label">Assembled context</text>
+<text x="60" y="302" class="body">User message and history</text>
+<text x="60" y="329" class="body">Workspace and resources</text>
+<text x="60" y="356" class="body">Memory and persona</text>
+<text x="60" y="383" class="body">Skills and model policy</text>
+<text x="60" y="410" class="body">Mounted tool definitions</text>
+<rect x="365" y="240" width="500" height="90" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="385" y="272" class="label">1 LLM round</text>
+<text x="385" y="302" class="body">Generate text and choose tools or finish</text>
+<path d="M310 300 H365" class="arrow"/>
+<rect x="365" y="400" width="500" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="385" y="432" class="label">2 Invoke selected tools</text>
+<text x="385" y="462" class="body">ToolRegistry → execute → tool results</text>
+<text x="385" y="489" class="body">Tools may request user input.</text>
+<path d="M615 330 V400" class="arrow"/>
+<text x="635" y="375" class="note">tool calls</text>
+<rect x="365" y="560" width="500" height="80" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="385" y="592" class="label">3 Observe results</text>
+<text x="385" y="622" class="body">Append observations to the conversation</text>
+<path d="M615 500 V560" class="arrow"/>
+<path d="M365 600 H335 V285 H365" class="arrow"/>
+<text x="225" y="535" class="note">next round</text>
+<rect x="365" y="710" width="500" height="150" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="385" y="742" class="label">Finish · capability result</text>
+<text x="385" y="772" class="body">emit_capability_result() emits result</text>
+<text x="385" y="799" class="body">payload.response + metadata</text>
+<text x="385" y="826" class="body">cost_summary / usage_summary when available</text>
+<path d="M865 285 H900 V765 H865" class="arrow"/>
+<text x="745" y="690" class="note">final answer</text>
+<rect x="960" y="240" width="280" height="400" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="980" y="272" class="label">Per-turn StreamBus</text>
+<text x="980" y="302" class="body">thinking · content</text>
+<text x="980" y="329" class="body">tool_call · tool_result</text>
+<text x="980" y="356" class="body">observation</text>
+<text x="980" y="383" class="body">wait_for_input</text>
+<text x="980" y="410" class="body">result · done</text>
+<text x="980" y="437" class="body"></text>
+<text x="980" y="464" class="body">Other protocol events:</text>
+<text x="980" y="491" class="body">stages, progress, sources,</text>
+<text x="980" y="518" class="body">session metadata, errors</text>
+<path d="M865 445 H960" class="arrow"/>
+<path d="M865 805 H925 V610 H960" class="arrow"/>
+<rect x="960" y="710" width="280" height="150" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="980" y="742" class="label">Persist and replay</text>
+<text x="980" y="772" class="body">Turn event journal</text>
+<text x="980" y="799" class="body">Consumer cursor / sequence</text>
+<text x="980" y="826" class="body">Web UI · CLI · SDK</text>
+<path d="M1100 640 V710" class="arrow"/>
+<text x="40" y="915" class="note">Result data such as response and cost_summary are payload fields, not StreamEventType values.</text>
+<text x="40" y="942" class="note">The diagram groups event families; core/stream.py is the authoritative protocol enumeration.</text>
+</svg>
diff --git a/assets/figs/system/generate_diagrams.py b/assets/figs/system/generate_diagrams.py
new file mode 100644
index 000000000..8164afc6f
--- /dev/null
+++ b/assets/figs/system/generate_diagrams.py
@@ -0,0 +1,81 @@
+"""Generate the README's current-dev engineering diagrams (stdlib only).
+
+Run: python assets/figs/system/generate_diagrams.py
+Sources: app/container.py, app/service.py, runtime/turn_engine.py,
+runtime/orchestrator.py, core/stream.py, agents/_shared/capability_result.py.
+The SVGs are editable text; no raster assets are modified.
+"""
+from pathlib import Path
+from html import escape
+
+ROOT = Path(__file__).parent
+
+class Diagram:
+ def __init__(self, title, description, height):
+ self.height = height
+ self.parts = [f'''<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="{height}" viewBox="0 0 1280 {height}" role="img" aria-labelledby="title desc"><title id="title">{escape(title)}</title><desc id="desc">{escape(description)}</desc><defs><marker id="arrow" markerWidth="9" markerHeight="9" refX="8" refY="4.5" orient="auto"><path d="M0 0 L9 4.5 L0 9 Z" fill="#64748b"/></marker></defs><style>text{{font-family:Arial,Helvetica,sans-serif;fill:#1e293b}}.title{{font-size:29px;font-weight:700}}.label{{font-size:21px;font-weight:600}}.body{{font-size:18px;fill:#475569}}.note{{font-size:17px;fill:#64748b}}.arrow{{fill:none;stroke:#64748b;stroke-width:2;marker-end:url(#arrow)}}</style><rect width="1280" height="{height}" fill="#fff"/>''']
+ self.text(40,44,title,'title')
+ self.text(40,76,description,'body')
+ def text(self,x,y,value,kind='body',anchor=None):
+ a=f' text-anchor="{anchor}"' if anchor else ''
+ self.parts.append(f'<text x="{x}" y="{y}" class="{kind}"{a}>{escape(value)}</text>')
+ def box(self,x,y,w,h,title,lines=(),accent=False):
+ fill,stroke=('#eff6ff','#93c5fd') if accent else ('#f8fafc','#cbd5e1')
+ self.parts.append(f'<rect x="{x}" y="{y}" width="{w}" height="{h}" rx="13" fill="{fill}" stroke="{stroke}" stroke-width="1.5"/>')
+ self.text(x+20,y+32,title,'label')
+ for i,line in enumerate(lines): self.text(x+20,y+62+i*27,line)
+ def arrow(self,path,label=None,x=0,y=0):
+ self.parts.append(f'<path d="{path}" class="arrow"/>')
+ if label:self.text(x,y,label,'note')
+ def save(self,name):
+ (ROOT/name).write_text('\n'.join(self.parts)+"\n</svg>\n")
+
+s=Diagram('DeepTutor · turn architecture','Current dev: durable application boundary, shared execution engine, two plugin levels.',1000)
+s.box(40,110,370,70,'CLI',('Typer entry point',))
+s.box(455,110,370,70,'WebSocket API',('/ws commands and event replay',))
+s.box(870,110,370,70,'Python SDK',('DeepTutorApp facade',))
+for x in [225,640,1055]: s.arrow(f'M{x} 180 V205 H640 V228')
+s.box(350,230,580,100,'TurnApplicationService',('Start, cancel, regenerate and replay turns', 'Coordinates the per-turn durable runtime'),True)
+s.box(40,230,260,100,'Session store',('Turn state and events','SQLite / PocketBase'))
+s.box(980,230,260,100,'Runtime coordinator',('Worker ownership','Local / Redis'))
+s.arrow('M350 280 H300');s.arrow('M930 280 H980')
+s.box(460,380,360,70,'TurnEngine',('Execute the assembled context',),True)
+s.arrow('M640 330 V380')
+s.box(460,500,360,80,'ChatOrchestrator',('Select capability; default: chat',),True)
+s.arrow('M640 450 V500')
+s.box(40,495,330,100,'UnifiedContext',('Message, history, resources,','model policy and turn scope'))
+s.arrow('M370 540 H460')
+s.box(920,495,320,90,'CapabilityRegistry',('Built-ins and installed plugins',))
+s.arrow('M920 540 H820')
+s.box(40,640,780,165,'Level 2 · selected capability',('chat · ask_questions · deep_solve · deep_question', 'deep_research · visualize · math_animator', 'mastery_path · immersive_reading · video_lesson'),True)
+s.arrow('M640 580 V610 H430 V640')
+s.box(920,640,320,165,'Level 1 · ToolRegistry',('Single-shot tool definitions','Context / capability gates','LLM-selected invocations'))
+s.arrow('M820 720 H920')
+s.box(40,865,780,100,'Per-turn StreamBus',('Capabilities emit typed events and the final result envelope.',))
+s.arrow('M430 805 V865')
+s.box(920,865,320,100,'Durable consumers',('Runtime persists events;','adapters subscribe / replay.'))
+s.arrow('M820 910 H920')
+s.text(40,985,'Runtime configuration: JSON settings under data/user/settings; workspace resources are scoped.','note')
+s.save('system-architecture.svg')
+
+c=Diagram('DeepTutor · chat capability loop','The chat loop runs inside the durable turn application and streams typed events.',960)
+c.box(360,112,560,85,'TurnApplicationService → TurnEngine',('ChatOrchestrator selects the chat capability',),True)
+c.arrow('M640 197 V240')
+c.box(40,240,270,245,'Assembled context',('User message and history','Workspace and resources','Memory and persona','Skills and model policy','Mounted tool definitions'))
+c.box(365,240,500,90,'1 LLM round',('Generate text and choose tools or finish',),True)
+c.arrow('M310 300 H365')
+c.box(365,400,500,100,'2 Invoke selected tools',('ToolRegistry → execute → tool results','Tools may request user input.'))
+c.arrow('M615 330 V400','tool calls',635,375)
+c.box(365,560,500,80,'3 Observe results',('Append observations to the conversation',))
+c.arrow('M615 500 V560')
+c.arrow('M365 600 H335 V285 H365','next round',225,535)
+c.box(365,710,500,150,'Finish · capability result',('emit_capability_result() emits result','payload.response + metadata','cost_summary / usage_summary when available'),True)
+c.arrow('M865 285 H900 V765 H865','final answer',745,690)
+c.box(960,240,280,400,'Per-turn StreamBus',('thinking · content','tool_call · tool_result','observation','wait_for_input','result · done','','Other protocol events:','stages, progress, sources,','session metadata, errors'))
+c.arrow('M865 445 H960')
+c.arrow('M865 805 H925 V610 H960')
+c.box(960,710,280,150,'Persist and replay',('Turn event journal','Consumer cursor / sequence','Web UI · CLI · SDK'))
+c.arrow('M1100 640 V710')
+c.text(40,915,'Result data such as response and cost_summary are payload fields, not StreamEventType values.','note')
+c.text(40,942,'The diagram groups event families; core/stream.py is the authoritative protocol enumeration.','note')
+c.save('chat-agent-loop.svg')
diff --git a/assets/figs/system/system-architecture.svg b/assets/figs/system/system-architecture.svg
new file mode 100644
index 000000000..cf9dfe7cb
--- /dev/null
+++ b/assets/figs/system/system-architecture.svg
@@ -0,0 +1,69 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="1000" viewBox="0 0 1280 1000" role="img" aria-labelledby="title desc"><title id="title">DeepTutor · turn architecture</title><desc id="desc">Current dev: durable application boundary, shared execution engine, two plugin levels.</desc><defs><marker id="arrow" markerWidth="9" markerHeight="9" refX="8" refY="4.5" orient="auto"><path d="M0 0 L9 4.5 L0 9 Z" fill="#64748b"/></marker></defs><style>text{font-family:Arial,Helvetica,sans-serif;fill:#1e293b}.title{font-size:29px;font-weight:700}.label{font-size:21px;font-weight:600}.body{font-size:18px;fill:#475569}.note{font-size:17px;fill:#64748b}.arrow{fill:none;stroke:#64748b;stroke-width:2;marker-end:url(#arrow)}</style><rect width="1280" height="1000" fill="#fff"/>
+<text x="40" y="44" class="title">DeepTutor · turn architecture</text>
+<text x="40" y="76" class="body">Current dev: durable application boundary, shared execution engine, two plugin levels.</text>
+<rect x="40" y="110" width="370" height="70" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="60" y="142" class="label">CLI</text>
+<text x="60" y="172" class="body">Typer entry point</text>
+<rect x="455" y="110" width="370" height="70" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="475" y="142" class="label">WebSocket API</text>
+<text x="475" y="172" class="body">/ws commands and event replay</text>
+<rect x="870" y="110" width="370" height="70" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="890" y="142" class="label">Python SDK</text>
+<text x="890" y="172" class="body">DeepTutorApp facade</text>
+<path d="M225 180 V205 H640 V228" class="arrow"/>
+<path d="M640 180 V205 H640 V228" class="arrow"/>
+<path d="M1055 180 V205 H640 V228" class="arrow"/>
+<rect x="350" y="230" width="580" height="100" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="370" y="262" class="label">TurnApplicationService</text>
+<text x="370" y="292" class="body">Start, cancel, regenerate and replay turns</text>
+<text x="370" y="319" class="body">Coordinates the per-turn durable runtime</text>
+<rect x="40" y="230" width="260" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="60" y="262" class="label">Session store</text>
+<text x="60" y="292" class="body">Turn state and events</text>
+<text x="60" y="319" class="body">SQLite / PocketBase</text>
+<rect x="980" y="230" width="260" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="1000" y="262" class="label">Runtime coordinator</text>
+<text x="1000" y="292" class="body">Worker ownership</text>
+<text x="1000" y="319" class="body">Local / Redis</text>
+<path d="M350 280 H300" class="arrow"/>
+<path d="M930 280 H980" class="arrow"/>
+<rect x="460" y="380" width="360" height="70" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="480" y="412" class="label">TurnEngine</text>
+<text x="480" y="442" class="body">Execute the assembled context</text>
+<path d="M640 330 V380" class="arrow"/>
+<rect x="460" y="500" width="360" height="80" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="480" y="532" class="label">ChatOrchestrator</text>
+<text x="480" y="562" class="body">Select capability; default: chat</text>
+<path d="M640 450 V500" class="arrow"/>
+<rect x="40" y="495" width="330" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="60" y="527" class="label">UnifiedContext</text>
+<text x="60" y="557" class="body">Message, history, resources,</text>
+<text x="60" y="584" class="body">model policy and turn scope</text>
+<path d="M370 540 H460" class="arrow"/>
+<rect x="920" y="495" width="320" height="90" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="940" y="527" class="label">CapabilityRegistry</text>
+<text x="940" y="557" class="body">Built-ins and installed plugins</text>
+<path d="M920 540 H820" class="arrow"/>
+<rect x="40" y="640" width="780" height="165" rx="13" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.5"/>
+<text x="60" y="672" class="label">Level 2 · selected capability</text>
+<text x="60" y="702" class="body">chat · ask_questions · deep_solve · deep_question</text>
+<text x="60" y="729" class="body">deep_research · visualize · math_animator</text>
+<text x="60" y="756" class="body">mastery_path · immersive_reading · video_lesson</text>
+<path d="M640 580 V610 H430 V640" class="arrow"/>
+<rect x="920" y="640" width="320" height="165" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="940" y="672" class="label">Level 1 · ToolRegistry</text>
+<text x="940" y="702" class="body">Single-shot tool definitions</text>
+<text x="940" y="729" class="body">Context / capability gates</text>
+<text x="940" y="756" class="body">LLM-selected invocations</text>
+<path d="M820 720 H920" class="arrow"/>
+<rect x="40" y="865" width="780" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="60" y="897" class="label">Per-turn StreamBus</text>
+<text x="60" y="927" class="body">Capabilities emit typed events and the final result envelope.</text>
+<path d="M430 805 V865" class="arrow"/>
+<rect x="920" y="865" width="320" height="100" rx="13" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.5"/>
+<text x="940" y="897" class="label">Durable consumers</text>
+<text x="940" y="927" class="body">Runtime persists events;</text>
+<text x="940" y="954" class="body">adapters subscribe / replay.</text>
+<path d="M820 910 H920" class="arrow"/>
+<text x="40" y="985" class="note">Runtime configuration: JSON settings under data/user/settings; workspace resources are scoped.</text>
+</svg>
diff --git a/assets/figs/web-dev/README.md b/assets/figs/web-dev/README.md
new file mode 100644
index 000000000..80b0173c4
--- /dev/null
+++ b/assets/figs/web-dev/README.md
@@ -0,0 +1,7 @@
+# Current dev application screenshots
+
+Captured 2026-10-28 from commit `a6389d7ee`, using the real current dev frontend and backend in an isolated demo home. 59 PNGs are final captures at 2940 × 1800 pixels (1470 × 900 CSS viewport at 2×), English/light theme. The 60th image, `memory-graph.png`, is the original 2506 × 1606 screenshot supplied by the user on 2026-10-28 and copied without alteration; its source is independent of the demo capture commit.
+
+For the 59 isolated demo captures, study text, chat transcript, Book content and widget, reading primer, notebook, journal, partner and workspace are explicitly synthetic documentation demo fixtures stored in the application. They demonstrate the real UI; they are not live model generation results. No private history or credentials were imported, and no paid generation or external messaging was performed. Channel configuration forms contain no credentials. Only Next.js development chrome was hidden.
+
+`manifest.json` records the route, state, dimensions and SHA-256 for each image. Master PNGs and both public-site copies are byte-identical. All finals were checked for rendered content and visually reviewed; no loading/error screenshots are included. Multi-user admin was omitted because the isolated instance has auth disabled; workspace settings was omitted to avoid filesystem paths.
diff --git a/assets/figs/web-dev/agents.png b/assets/figs/web-dev/agents.png
new file mode 100644
index 000000000..1a35455eb
Binary files /dev/null and b/assets/figs/web-dev/agents.png differ
diff --git a/assets/figs/web-dev/appearance.png b/assets/figs/web-dev/appearance.png
new file mode 100644
index 000000000..fbd4e228a
Binary files /dev/null and b/assets/figs/web-dev/appearance.png differ
diff --git a/assets/figs/web-dev/book-detail.png b/assets/figs/web-dev/book-detail.png
new file mode 100644
index 000000000..4c9529879
Binary files /dev/null and b/assets/figs/web-dev/book-detail.png differ
diff --git a/assets/figs/web-dev/book-quiz.png b/assets/figs/web-dev/book-quiz.png
new file mode 100644
index 000000000..82fd75d06
Binary files /dev/null and b/assets/figs/web-dev/book-quiz.png differ
diff --git a/assets/figs/web-dev/book-widget.png b/assets/figs/web-dev/book-widget.png
new file mode 100644
index 000000000..37cc4ff11
Binary files /dev/null and b/assets/figs/web-dev/book-widget.png differ
diff --git a/assets/figs/web-dev/books.png b/assets/figs/web-dev/books.png
new file mode 100644
index 000000000..f874afd66
Binary files /dev/null and b/assets/figs/web-dev/books.png differ
diff --git a/assets/figs/web-dev/calendar.png b/assets/figs/web-dev/calendar.png
new file mode 100644
index 000000000..c592ee030
Binary files /dev/null and b/assets/figs/web-dev/calendar.png differ
diff --git a/assets/figs/web-dev/chat.png b/assets/figs/web-dev/chat.png
new file mode 100644
index 000000000..e28ec5dfd
Binary files /dev/null and b/assets/figs/web-dev/chat.png differ
diff --git a/assets/figs/web-dev/cli-apps.png b/assets/figs/web-dev/cli-apps.png
new file mode 100644
index 000000000..038fcf2cb
Binary files /dev/null and b/assets/figs/web-dev/cli-apps.png differ
diff --git a/assets/figs/web-dev/co-writer.png b/assets/figs/web-dev/co-writer.png
new file mode 100644
index 000000000..ea2b9b829
Binary files /dev/null and b/assets/figs/web-dev/co-writer.png differ
diff --git a/assets/figs/web-dev/favorites.png b/assets/figs/web-dev/favorites.png
new file mode 100644
index 000000000..d7106e8fb
Binary files /dev/null and b/assets/figs/web-dev/favorites.png differ
diff --git a/assets/figs/web-dev/journal.png b/assets/figs/web-dev/journal.png
new file mode 100644
index 000000000..d8be3d76b
Binary files /dev/null and b/assets/figs/web-dev/journal.png differ
diff --git a/assets/figs/web-dev/knowledge-create.png b/assets/figs/web-dev/knowledge-create.png
new file mode 100644
index 000000000..ad9d7fb76
Binary files /dev/null and b/assets/figs/web-dev/knowledge-create.png differ
diff --git a/assets/figs/web-dev/knowledge.png b/assets/figs/web-dev/knowledge.png
new file mode 100644
index 000000000..eeaee14b8
Binary files /dev/null and b/assets/figs/web-dev/knowledge.png differ
diff --git a/assets/figs/web-dev/learning-new.png b/assets/figs/web-dev/learning-new.png
new file mode 100644
index 000000000..66b1947f0
Binary files /dev/null and b/assets/figs/web-dev/learning-new.png differ
diff --git a/assets/figs/web-dev/learning.png b/assets/figs/web-dev/learning.png
new file mode 100644
index 000000000..fcce4cdd0
Binary files /dev/null and b/assets/figs/web-dev/learning.png differ
diff --git a/assets/figs/web-dev/manifest.json b/assets/figs/web-dev/manifest.json
new file mode 100644
index 000000000..91b690b94
--- /dev/null
+++ b/assets/figs/web-dev/manifest.json
@@ -0,0 +1,627 @@
+{
+ "capture_complete": true,
+ "captured_date": "2026-10-28",
+ "source_commit": "a6389d7ee",
+ "application_version_label": "1.6.15 (current dev checkout version file)",
+ "viewport_css": {
+ "width": 1470,
+ "height": 900
+ },
+ "device_scale_factor": 2,
+ "browser": "Google Chrome 156 via repository Playwright",
+ "theme": "light",
+ "language": "en",
+ "provenance": "Disposable DEEPTUTOR_HOME. All study content, chat messages, Book blocks, reading material, notebook, journal mission and records, partner Sage and workspace are synthetic documentation demonstration fixtures persisted through actual application APIs/stores; they are not claims of live model output. No developer history, credentials or personal learning data was imported. No paid-provider generation or external messaging was performed. Forms show empty credentials. Only Next.js development indicator was hidden with capture CSS; product DOM and screenshot pixels were not fabricated or replaced. Exception: memory-graph.png is the original image supplied and approved by the user on 2026-10-28, copied without alteration; it is not from the isolated demo capture. Per-file metadata overrides the capture defaults.",
+ "omitted": [
+ "multi-user admin: auth disabled in isolated demo; route redirected to chat",
+ "profile: redirected to chat",
+ "settings-workspace: omitted to avoid showing machine filesystem paths"
+ ],
+ "files": [
+ {
+ "file": "agents.png",
+ "route": "/agents",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "b8e3fb7ecef0fa3a526165b41939db696ad47debcf3660c910b836d5300c89cc",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "appearance.png",
+ "route": "/settings/appearance",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ad34d81a5885e2afae5a7c6583dd32394b11d62b997dff9443d42429bfc0e4ba",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "book-detail.png",
+ "route": "/learning/books/docs_fourier",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "035ce1cc3bd083789b63c2e15f6dc1a3fb47a2d98937165f3472f528ce533cc7",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "book-quiz.png",
+ "route": "/learning/books/docs_fourier/pages/pg_foundations",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "6ba99595a4fa1c8ddee3a991aea5993a4834702f33cc986bde700283e0b81058",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "book-widget.png",
+ "route": "/learning/books/docs_fourier/pages/pg_interactive",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "727e87ca9a4d1ca213eda3e4e0dd873846b624d840cb99a83f051f2b79ff7fbb",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "books.png",
+ "route": "/learning/books",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "addae30050e1e066a937fe8e9474ca92feb5e861de20e4eccdf7f5c57268c668",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "calendar.png",
+ "route": "/calendar",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "bfd3c7974c4c8a7aa61175bc5a9dd7ac3d2b0ed97b85b1cb29f07e4db879563a",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "chat.png",
+ "route": "/chat/docs-demo-chat",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "625e7688a7d8e5c19e51e768ba9fc96cc1a98d62271da80394a7260ef2ced9d1",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "cli-apps.png",
+ "route": "/space/cli-apps",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ea8807d85930dfdb3c4fb20a1b28f437d6023a545f0cc914e4ec261f0435a49d",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "co-writer.png",
+ "route": "/co-writer",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "24764379c5cbf134444716d5f2316c3acac75cc3ed89573423a1c84f6f07d81e",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "favorites.png",
+ "route": "/notebooks",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "727f863216d449cc18b1176523a7f902d9cf63852152cd9ca0f11f1347f7bbed",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "journal.png",
+ "route": "/space/journal",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "f6a5bdfff58d8242a357d1271e3c182119cf21d7f294365f770427a413d3c67d",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "knowledge-create.png",
+ "route": "/knowledge-bases",
+ "state": "create modal open",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "5bc2fe745bea9b4f9eaa073e05f7af601d03130b7fb07eeda13e14022e12095d",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "knowledge.png",
+ "route": "/knowledge-bases",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "8b60ac48d50ef01a6bbd1ab3c64908d5e719de98052d0faeaf5f881428a6faf0",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "learning-new.png",
+ "route": "/learning/new",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "7d783bbe83239fcdd5f1992d623da02ea6f70ee79dd1cf1d78b13a16f0ffefd9",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "learning.png",
+ "route": "/learning",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ea081a3ca3d2dde2a0c9f2f04c86f10c6e52bc7be8962f03c1a064337e79297f",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "mastery-detail.png",
+ "route": "/learning/mastery/topic_089c811e574748f3a566bd0bf6ba9262",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ef668e2eaa8c4a8ba5bba22c517019dedb5c9b5ea1e5afc20926179529492e2b",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "mastery.png",
+ "route": "/learning/mastery",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "0186135ce1af4c4d0bfa6bbda3bf75b57c145450ce10fbdedeb1a85277342f27",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "mcp.png",
+ "route": "/space/mcp",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "493b1077636ee3b40662dbcbe36f7cb5a3c0b9eab2b71abf5a04c8b223a47a60",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "memory-graph.png",
+ "route": "/memory/graph",
+ "state": "User-provided populated three-layer memory graph",
+ "width": 2506,
+ "height": 1606,
+ "sha256": "bb639f75889f6c2eb0d06e3d194dc682782d7bb1d174e466e1c4a9c814e54f42",
+ "status": "final",
+ "ui": "Original user-supplied screenshot, unmodified",
+ "source": "User attachment, 2026-10-28",
+ "source_commit": null,
+ "viewport_css": null,
+ "device_scale_factor": null,
+ "browser": null
+ },
+ {
+ "file": "memory.png",
+ "route": "/memory",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "67f259f1903551f7d419ba131eec979a1484ed5df5d945f49ee3bd2a59d4916a",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "modules.png",
+ "route": "/settings/status",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "6f2258f28441cf5d902f2652804706b872e16f5a27acec5ecc539413a1524271",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "notebook-detail.png",
+ "route": "/co-writer/e793037de012",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "c0b5477efdcf232443a0a4de6a2fd6106e1ae4ddae4cd09897ffcb6adbe67e35",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "notebook-dito.png",
+ "route": "/co-writer/e793037de012",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "48af2f71564d8182c4da2e6802fea8b25d2a525d685720b7d49a7bfeb08a9791",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "overview.png",
+ "route": "/chat",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "5f9e5af8b948316b12651f4ee205f384c7dfd6cd78619046dde0505f734bd5bb",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-dingtalk.png",
+ "route": "/partners/sage",
+ "state": "channel form: dingtalk",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "e47cd10536c0ce36f2bdb2947b4e44b7af3d0128ea63268577cd0408ba861f24",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-discord.png",
+ "route": "/partners/sage",
+ "state": "channel form: discord",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "4538232d368f1a26f220a27723f7c923cdaea2cdbc68d31d62395da25a33b7ba",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-email.png",
+ "route": "/partners/sage",
+ "state": "channel form: email",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "49a1141425f581e04fe5775ea40a29c0b2308c96fb5bcce9757a40597e71ab7e",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-feishu.png",
+ "route": "/partners/sage",
+ "state": "channel form: feishu",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "89c545dfea9c8d0d5a65ead40e101efc04145956bf67a03bd32fdb13e61a8d7d",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-matrix.png",
+ "route": "/partners/sage",
+ "state": "channel form: matrix",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "df1e3fdf5eedcb3d85d29e5c095d581efe85708db684252128ae63a271c829b0",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-mattermost.png",
+ "route": "/partners/sage",
+ "state": "channel form: mattermost",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "0f467d3cb3b021b54013075c8ca66de41f5605b99f356d512108e4fa9bcaabf0",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-mochat.png",
+ "route": "/partners/sage",
+ "state": "channel form: mochat",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ac6b95dd844433823e506255973a2d449b2bfe7d319193a05ade8f9037dbc935",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-msteams.png",
+ "route": "/partners/sage",
+ "state": "channel form: msteams",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "a277a64f7b5986f822a550a4023267f85a102af77544275fdeed56c16938cced",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-napcat.png",
+ "route": "/partners/sage",
+ "state": "channel form: napcat",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "1dc2ac27f209c57d3b963fc09b907f6257f27df0ee31d3b79a9970648fd3b917",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-qq.png",
+ "route": "/partners/sage",
+ "state": "channel form: qq",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "8ab2cd808db82cc754dad7141798410efc7f4869a13226ee3d099891a6f5509d",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-slack.png",
+ "route": "/partners/sage",
+ "state": "channel form: slack",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "97746392be3f681add2fbebb6cb3c4c8f46b757266076191f18447e58bd65587",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-telegram.png",
+ "route": "/partners/sage",
+ "state": "channel form: telegram",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "c2de927a5f16ce93da72e21bd750fa9bba7bcda7b757ced13ce89d9e225db707",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-wecom.png",
+ "route": "/partners/sage",
+ "state": "channel form: wecom",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "92ad0dde30830fd40ef337c0e4f08685e81dc90e8ad87eab26d90caa226ed2b3",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-weixin.png",
+ "route": "/partners/sage",
+ "state": "channel form: weixin",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "430a19efbdb5742e31f6c4a8952f403b471e7ac658efd2af45ae615451c8d030",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-whatsapp.png",
+ "route": "/partners/sage",
+ "state": "channel form: whatsapp",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "f4ed65bb10bbd2adb1bf160fac372f5db5edc931035a344dfb669f462326145a",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channel-zulip.png",
+ "route": "/partners/sage",
+ "state": "channel form: zulip",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "f6f9722abbc0f90cf34a629969eca6f45bc264a4e5516a426c95128814131df9",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-channels.png",
+ "route": "/partners/sage",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "e47cd10536c0ce36f2bdb2947b4e44b7af3d0128ea63268577cd0408ba861f24",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-configure.png",
+ "route": "/partners/sage",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "7ae442765356f6a7fec3b2c094bca0f60104c018d0fc5713269cbabbe502d1a5",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners-new.png",
+ "route": "/partners/new",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "28987bbac481c97b3c31585bfbd8d0dc6f8ae551cddb9a8ccce0d3c32e2f0f51",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "partners.png",
+ "route": "/partners",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ba240324ecff6fe600612c0806dde1c57574da749773796253e7f74a63af8920",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "personalization.png",
+ "route": "/personalization",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "e97847907859b54fba77d12ea0e847562ac033e0d836351d1622995f3fdc9495",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "personas.png",
+ "route": "/space/personas",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "280dc9b41ea34f3e6ab3311727da8153b17057f4fc7e87ac33ea2f658cbe17f8",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "practice.png",
+ "route": "/learning/practice",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "395dacebdc8b3699fc28fc87446daba8db3cc82e859b06b56ac3867fc7461591",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "providers.png",
+ "route": "/settings/connections",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "ee6a871428fb77ffcbf78eece86ada59ce140357770866ab7d3630e72e78aafa",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "reading-detail.png",
+ "route": "/learning/reading/rw_c748d65bfd3a4d6ea8114e65d1f1fbd8",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "a04a0caa3c6c6f376d0f437f8cb5ad7352ef49dbe7bd53569d96995dc97a76b5",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "reading.png",
+ "route": "/learning/reading",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "709597af3ea059c77f8f3b112f17ce3c44d176ef54f2faba7182b5e1bb4d18e5",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "resources.png",
+ "route": "/space",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "12c1fdcafed6b2b39d0605b1438b0dd2a15974855f6f974541aae1690432194a",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "settings-about.png",
+ "route": "/settings/about",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "18a673713338e5cbc93b57bb7a5c994991637175d7fb0b3c36647a3239d62531",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "settings-agents.png",
+ "route": "/settings/agent-claude-code",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "1dd94f446716b4d6d1d7a869704e82fab3817fbefea36a02aaa0c16f3ff95a6f",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "settings-parsing.png",
+ "route": "/settings/knowledge",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "37b43165e9b7667c4c511cf0d95f0d8e63ef28d3fd99589a4295ad71e3cbb617",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "settings-video.png",
+ "route": "/settings/video-learning",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "93f4be64de463b63b61b3cc953f8d22e8b51d9bac465e89a98d2597f51fa5e11",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "settings.png",
+ "route": "/settings/general",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "0965c5ca268457adaca7ab0c52fc1887726c12ee72a733837b0ceb743d99e730",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "skills.png",
+ "route": "/space/skills",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "018600940eaaa5a572b517622dbf87cdeb96f12a3747a3945db47ea21158f7ae",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "task-board.png",
+ "route": "/kanban",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "133b86539c29301fb87adb49afa038cd2e5b4dfa68fffa44c63b930d471738d5",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ },
+ {
+ "file": "workspace-switcher.png",
+ "route": "/chat",
+ "state": "rendered route",
+ "width": 2940,
+ "height": 1800,
+ "sha256": "cf345906779ad4686ffb769b5ee7aef63e2ead94d0c7b19089e1845ff09bcb7e",
+ "status": "final",
+ "ui": "real current-dev application rendered in Chrome; persisted synthetic demo content"
+ }
+ ]
+}
diff --git a/assets/figs/web-dev/mastery-detail.png b/assets/figs/web-dev/mastery-detail.png
new file mode 100644
index 000000000..1c2637b28
Binary files /dev/null and b/assets/figs/web-dev/mastery-detail.png differ
diff --git a/assets/figs/web-dev/mastery.png b/assets/figs/web-dev/mastery.png
new file mode 100644
index 000000000..735220932
Binary files /dev/null and b/assets/figs/web-dev/mastery.png differ
diff --git a/assets/figs/web-dev/mcp.png b/assets/figs/web-dev/mcp.png
new file mode 100644
index 000000000..f090c148e
Binary files /dev/null and b/assets/figs/web-dev/mcp.png differ
diff --git a/assets/figs/web-dev/memory-graph.png b/assets/figs/web-dev/memory-graph.png
new file mode 100644
index 000000000..7bcf8fe57
Binary files /dev/null and b/assets/figs/web-dev/memory-graph.png differ
diff --git a/assets/figs/web-dev/memory.png b/assets/figs/web-dev/memory.png
new file mode 100644
index 000000000..3e8efd30e
Binary files /dev/null and b/assets/figs/web-dev/memory.png differ
diff --git a/assets/figs/web-dev/modules.png b/assets/figs/web-dev/modules.png
new file mode 100644
index 000000000..808e7d6fe
Binary files /dev/null and b/assets/figs/web-dev/modules.png differ
diff --git a/assets/figs/web-dev/notebook-detail.png b/assets/figs/web-dev/notebook-detail.png
new file mode 100644
index 000000000..ad1fc6dcb
Binary files /dev/null and b/assets/figs/web-dev/notebook-detail.png differ
diff --git a/assets/figs/web-dev/notebook-dito.png b/assets/figs/web-dev/notebook-dito.png
new file mode 100644
index 000000000..0446c9434
Binary files /dev/null and b/assets/figs/web-dev/notebook-dito.png differ
diff --git a/assets/figs/web-dev/overview.png b/assets/figs/web-dev/overview.png
new file mode 100644
index 000000000..8da59e92e
Binary files /dev/null and b/assets/figs/web-dev/overview.png differ
diff --git a/assets/figs/web-dev/partners-channel-dingtalk.png b/assets/figs/web-dev/partners-channel-dingtalk.png
new file mode 100644
index 000000000..c4bf042f8
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-dingtalk.png differ
diff --git a/assets/figs/web-dev/partners-channel-discord.png b/assets/figs/web-dev/partners-channel-discord.png
new file mode 100644
index 000000000..8b38ff6cf
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-discord.png differ
diff --git a/assets/figs/web-dev/partners-channel-email.png b/assets/figs/web-dev/partners-channel-email.png
new file mode 100644
index 000000000..7fb0598ea
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-email.png differ
diff --git a/assets/figs/web-dev/partners-channel-feishu.png b/assets/figs/web-dev/partners-channel-feishu.png
new file mode 100644
index 000000000..40060d036
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-feishu.png differ
diff --git a/assets/figs/web-dev/partners-channel-matrix.png b/assets/figs/web-dev/partners-channel-matrix.png
new file mode 100644
index 000000000..d7d96c1ac
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-matrix.png differ
diff --git a/assets/figs/web-dev/partners-channel-mattermost.png b/assets/figs/web-dev/partners-channel-mattermost.png
new file mode 100644
index 000000000..04c1e0ff6
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-mattermost.png differ
diff --git a/assets/figs/web-dev/partners-channel-mochat.png b/assets/figs/web-dev/partners-channel-mochat.png
new file mode 100644
index 000000000..c240e8177
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-mochat.png differ
diff --git a/assets/figs/web-dev/partners-channel-msteams.png b/assets/figs/web-dev/partners-channel-msteams.png
new file mode 100644
index 000000000..c3225a7c0
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-msteams.png differ
diff --git a/assets/figs/web-dev/partners-channel-napcat.png b/assets/figs/web-dev/partners-channel-napcat.png
new file mode 100644
index 000000000..984d70f83
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-napcat.png differ
diff --git a/assets/figs/web-dev/partners-channel-qq.png b/assets/figs/web-dev/partners-channel-qq.png
new file mode 100644
index 000000000..3c863d3d4
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-qq.png differ
diff --git a/assets/figs/web-dev/partners-channel-slack.png b/assets/figs/web-dev/partners-channel-slack.png
new file mode 100644
index 000000000..eabb19c94
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-slack.png differ
diff --git a/assets/figs/web-dev/partners-channel-telegram.png b/assets/figs/web-dev/partners-channel-telegram.png
new file mode 100644
index 000000000..4f267000a
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-telegram.png differ
diff --git a/assets/figs/web-dev/partners-channel-wecom.png b/assets/figs/web-dev/partners-channel-wecom.png
new file mode 100644
index 000000000..c360528d4
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-wecom.png differ
diff --git a/assets/figs/web-dev/partners-channel-weixin.png b/assets/figs/web-dev/partners-channel-weixin.png
new file mode 100644
index 000000000..c168afe1a
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-weixin.png differ
diff --git a/assets/figs/web-dev/partners-channel-whatsapp.png b/assets/figs/web-dev/partners-channel-whatsapp.png
new file mode 100644
index 000000000..86f0c317c
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-whatsapp.png differ
diff --git a/assets/figs/web-dev/partners-channel-zulip.png b/assets/figs/web-dev/partners-channel-zulip.png
new file mode 100644
index 000000000..a9dd30dc0
Binary files /dev/null and b/assets/figs/web-dev/partners-channel-zulip.png differ
diff --git a/assets/figs/web-dev/partners-channels.png b/assets/figs/web-dev/partners-channels.png
new file mode 100644
index 000000000..c4bf042f8
Binary files /dev/null and b/assets/figs/web-dev/partners-channels.png differ
diff --git a/assets/figs/web-dev/partners-configure.png b/assets/figs/web-dev/partners-configure.png
new file mode 100644
index 000000000..9f8df3afd
Binary files /dev/null and b/assets/figs/web-dev/partners-configure.png differ
diff --git a/assets/figs/web-dev/partners-new.png b/assets/figs/web-dev/partners-new.png
new file mode 100644
index 000000000..4e7b7ea25
Binary files /dev/null and b/assets/figs/web-dev/partners-new.png differ
diff --git a/assets/figs/web-dev/partners.png b/assets/figs/web-dev/partners.png
new file mode 100644
index 000000000..1ae5524ee
Binary files /dev/null and b/assets/figs/web-dev/partners.png differ
diff --git a/assets/figs/web-dev/personalization.png b/assets/figs/web-dev/personalization.png
new file mode 100644
index 000000000..3249ded57
Binary files /dev/null and b/assets/figs/web-dev/personalization.png differ
diff --git a/assets/figs/web-dev/personas.png b/assets/figs/web-dev/personas.png
new file mode 100644
index 000000000..9aa508247
Binary files /dev/null and b/assets/figs/web-dev/personas.png differ
diff --git a/assets/figs/web-dev/practice.png b/assets/figs/web-dev/practice.png
new file mode 100644
index 000000000..acf4b6cad
Binary files /dev/null and b/assets/figs/web-dev/practice.png differ
diff --git a/assets/figs/web-dev/providers.png b/assets/figs/web-dev/providers.png
new file mode 100644
index 000000000..0611640da
Binary files /dev/null and b/assets/figs/web-dev/providers.png differ
diff --git a/assets/figs/web-dev/reading-detail.png b/assets/figs/web-dev/reading-detail.png
new file mode 100644
index 000000000..bdb8dcd12
Binary files /dev/null and b/assets/figs/web-dev/reading-detail.png differ
diff --git a/assets/figs/web-dev/reading.png b/assets/figs/web-dev/reading.png
new file mode 100644
index 000000000..b72369bf2
Binary files /dev/null and b/assets/figs/web-dev/reading.png differ
diff --git a/assets/figs/web-dev/resources.png b/assets/figs/web-dev/resources.png
new file mode 100644
index 000000000..18a357aa1
Binary files /dev/null and b/assets/figs/web-dev/resources.png differ
diff --git a/assets/figs/web-dev/settings-about.png b/assets/figs/web-dev/settings-about.png
new file mode 100644
index 000000000..f5256e9e5
Binary files /dev/null and b/assets/figs/web-dev/settings-about.png differ
diff --git a/assets/figs/web-dev/settings-agents.png b/assets/figs/web-dev/settings-agents.png
new file mode 100644
index 000000000..4b37155a0
Binary files /dev/null and b/assets/figs/web-dev/settings-agents.png differ
diff --git a/assets/figs/web-dev/settings-parsing.png b/assets/figs/web-dev/settings-parsing.png
new file mode 100644
index 000000000..b7d3be05c
Binary files /dev/null and b/assets/figs/web-dev/settings-parsing.png differ
diff --git a/assets/figs/web-dev/settings-video.png b/assets/figs/web-dev/settings-video.png
new file mode 100644
index 000000000..b821cd752
Binary files /dev/null and b/assets/figs/web-dev/settings-video.png differ
diff --git a/assets/figs/web-dev/settings.png b/assets/figs/web-dev/settings.png
new file mode 100644
index 000000000..8e15f045a
Binary files /dev/null and b/assets/figs/web-dev/settings.png differ
diff --git a/assets/figs/web-dev/skills.png b/assets/figs/web-dev/skills.png
new file mode 100644
index 000000000..0cac52d49
Binary files /dev/null and b/assets/figs/web-dev/skills.png differ
diff --git a/assets/figs/web-dev/task-board.png b/assets/figs/web-dev/task-board.png
new file mode 100644
index 000000000..d62860d32
Binary files /dev/null and b/assets/figs/web-dev/task-board.png differ
diff --git a/assets/figs/web-dev/workspace-switcher.png b/assets/figs/web-dev/workspace-switcher.png
new file mode 100644
index 000000000..a285e2d36
Binary files /dev/null and b/assets/figs/web-dev/workspace-switcher.png differ
diff --git a/web/app/(workspace)/co-writer/sampleTemplate.ts b/web/app/(workspace)/co-writer/sampleTemplate.ts
index 27dbb0a67..76ffd94eb 100644
--- a/web/app/(workspace)/co-writer/sampleTemplate.ts
+++ b/web/app/(workspace)/co-writer/sampleTemplate.ts
@@ -106,7 +106,7 @@ ${FENCE}
### Images
-![](/logo-ver2.png)
+![](/brand/color-logo.png)
> DeepTutor brand mark used inside the co-writer template.
diff --git a/web/app/layout.tsx b/web/app/layout.tsx
index 80d0eef37..c266a68c9 100644
--- a/web/app/layout.tsx
+++ b/web/app/layout.tsx
@@ -32,10 +32,10 @@ export const metadata: Metadata = {
description: "Agent-native intelligent learning companion",
icons: {
icon: [
- { url: "/favicon-16x16.png", sizes: "16x16", type: "image/png" },
- { url: "/favicon-32x32.png", sizes: "32x32", type: "image/png" },
+ { url: "/brand/favicon-16x16.png", sizes: "16x16", type: "image/png" },
+ { url: "/brand/favicon-32x32.png", sizes: "32x32", type: "image/png" },
],
- apple: "/apple-touch-icon.png",
+ apple: "/brand/apple-touch-icon.png",
},
};
diff --git a/web/components/chat/home/SessionLoadingView.tsx b/web/components/chat/home/SessionLoadingView.tsx
index f2feb8c44..e23b8231c 100644
--- a/web/components/chat/home/SessionLoadingView.tsx
+++ b/web/components/chat/home/SessionLoadingView.tsx
@@ -59,11 +59,11 @@ export default function SessionLoadingView({
{/* Logo + spinner (or the failure mark) */}
<div className="flex items-center gap-3">
<img
- src="/logo_black.png"
+ src="/brand/black-logo.png"
alt="DeepTutor"
width={32}
height={32}
- className="h-8 w-8 select-none"
+ className="h-8 w-8 select-none dark:invert"
draggable={false}
/>
{failed ? (
diff --git a/web/components/layout/AppShell.tsx b/web/components/layout/AppShell.tsx
index 1318d8e0a..14f860fa2 100644
--- a/web/components/layout/AppShell.tsx
+++ b/web/components/layout/AppShell.tsx
@@ -117,17 +117,17 @@ export default function AppShell({ sidebar, pageBar, children, homeHref = "/" }:
</button>
<Link href={homeHref} className="flex items-center gap-1.5">
<Image
- src="/logo.png"
+ src="/brand/color-logo.png"
alt="DeepTutor"
width={20}
height={20}
className="h-5 w-5"
/>
<Image
- src="/banner.png"
+ src="/brand/color-word.png"
alt="DeepTutor"
- width={897}
- height={236}
+ width={1200}
+ height={310}
className="h-[18px] w-auto"
/>
</Link>
diff --git a/web/components/sidebar/SidebarShell.tsx b/web/components/sidebar/SidebarShell.tsx
index 30e692c65..bfc64bf4f 100644
--- a/web/components/sidebar/SidebarShell.tsx
+++ b/web/components/sidebar/SidebarShell.tsx
@@ -305,7 +305,7 @@ export function SidebarShell({
menu of settings and account), the way back out, then search. */}
{bodySlot ? (
<Link href={brandHref} prefetch={false} aria-label="DeepTutor" className="dt-rail-brand">
- <Image src="/logo.png" alt="DeepTutor" width={22} height={22} className="h-[22px] w-[22px] rounded-md" />
+ <Image src="/brand/color-logo.png" alt="DeepTutor" width={22} height={22} className="h-[22px] w-[22px] rounded-md" />
</Link>
) : (
<WorkspaceMenu compact accountSlot={renderedFooter} onNavigate={() => drawer?.close()} />
@@ -364,17 +364,17 @@ export function SidebarShell({
<div className="flex h-[52px] shrink-0 items-center justify-between px-4">
<Link href={brandHref} prefetch={false} className="group flex items-center gap-1.5">
<Image
- src="/logo.png"
+ src="/brand/color-logo.png"
alt="DeepTutor"
width={22}
height={22}
className="h-[22px] w-[22px] transition-transform duration-200 group-hover:scale-105"
/>
<Image
- src="/banner.png"
+ src="/brand/color-word.png"
alt="DeepTutor"
- width={897}
- height={236}
+ width={1200}
+ height={310}
priority
className="h-[22px] w-auto transition-transform duration-200 group-hover:scale-105"
/>
diff --git a/web/components/sidebar/WorkspaceMenu.tsx b/web/components/sidebar/WorkspaceMenu.tsx
index 04a6369a6..db0f64915 100644
--- a/web/components/sidebar/WorkspaceMenu.tsx
+++ b/web/components/sidebar/WorkspaceMenu.tsx
@@ -17,7 +17,7 @@ export function WorkspaceGlyph({ name, general, size = 22 }: { name: string; gen
if (general)
return (
<span aria-hidden className="dt-workspace-glyph is-general" style={{ width: size, height: size }}>
- <Image src="/logo.png" alt="" width={size} height={size} className="h-full w-full object-contain" />
+ <Image src="/brand/color-logo.png" alt="" width={size} height={size} className="h-full w-full object-contain" />
</span>
)
let hash = 0
diff --git a/web/features/chat/components/ChatWorkspace.tsx b/web/features/chat/components/ChatWorkspace.tsx
index 9f324bb87..35dbc0b8b 100644
--- a/web/features/chat/components/ChatWorkspace.tsx
+++ b/web/features/chat/components/ChatWorkspace.tsx
@@ -2608,11 +2608,11 @@ export default function ChatWorkspace() {
<div className="flex w-full flex-1 min-h-0 items-end justify-center overflow-hidden pb-14 animate-fade-in px-6">
<div className="w-full max-w-[960px] flex items-center justify-center gap-4">
<img
- src="/logo_black.png"
+ src="/brand/black-logo.png"
alt="DeepTutor"
width={40}
height={40}
- className="h-10 w-10 select-none"
+ className="h-10 w-10 select-none dark:invert"
draggable={false}
/>
<h1 className="font-serif text-[40px] font-medium leading-[1.1] tracking-[-0.015em] text-[var(--foreground)]">
diff --git a/web/features/notes/components/NoteBlockPreview.tsx b/web/features/notes/components/NoteBlockPreview.tsx
index 1879204f7..1ed9f8936 100644
--- a/web/features/notes/components/NoteBlockPreview.tsx
+++ b/web/features/notes/components/NoteBlockPreview.tsx
@@ -71,7 +71,7 @@ export default function NoteBlockPreview({
)
const image = (
<div className="dt-note-preview-image">
- <Image src="/banner.png" alt="" width={440} height={180} unoptimized />
+ <Image src="/brand/color-full.png" alt="" width={1600} height={313} unoptimized />
<small>{t('Image caption')}</small>
</div>
)
diff --git a/web/features/preview/PreviewWorkspace.tsx b/web/features/preview/PreviewWorkspace.tsx
index 8bdba47f9..65264e1d2 100644
--- a/web/features/preview/PreviewWorkspace.tsx
+++ b/web/features/preview/PreviewWorkspace.tsx
@@ -1042,7 +1042,7 @@ function Conversation({
<div className="preview-conversation">
{!messages.length && (
<div className="preview-conversation-empty">
- <Image src="/logo.png" alt="" width={38} height={38} />
+ <Image src="/brand/color-logo.png" alt="" width={38} height={38} />
<h2>{context === 'chat' ? '想从哪里开始?' : '我就在这里'}</h2>
<p>
{context === 'chat'
diff --git a/web/features/ui-layout/classic/ClassicSidebarShell.tsx b/web/features/ui-layout/classic/ClassicSidebarShell.tsx
index b56f9850f..027c019fb 100644
--- a/web/features/ui-layout/classic/ClassicSidebarShell.tsx
+++ b/web/features/ui-layout/classic/ClassicSidebarShell.tsx
@@ -193,7 +193,7 @@ export function ClassicSidebarShell({
className="flex items-center justify-center transition-opacity duration-150 group-hover/sb:opacity-0"
>
<Image
- src="/logo.png"
+ src="/brand/color-logo.png"
alt="DeepTutor"
width={22}
height={22}
@@ -257,17 +257,17 @@ export function ClassicSidebarShell({
<div className="flex h-[52px] shrink-0 items-center justify-between px-4">
<Link href="/" prefetch={false} className="group flex items-center gap-1.5">
<Image
- src="/logo.png"
+ src="/brand/color-logo.png"
alt="DeepTutor"
width={22}
height={22}
className="h-[22px] w-[22px] transition-transform duration-200 group-hover:scale-105"
/>
<Image
- src="/banner.png"
+ src="/brand/color-word.png"
alt="DeepTutor"
- width={897}
- height={236}
+ width={1200}
+ height={310}
priority
className="h-[22px] w-auto transition-transform duration-200 group-hover:scale-105"
/>
diff --git a/web/package.json b/web/package.json
index 5de025992..36d412d6d 100644
--- a/web/package.json
+++ b/web/package.json
@@ -30,7 +30,8 @@
"audit:report": "playwright show-report",
"test:e2e:critical": "playwright test --project=critical-turns",
"test:e2e:multi-worker": "playwright test --project=multi-worker-turns-desktop --project=multi-worker-turns-mobile",
- "build:brand-icons": "tsx ./scripts/build-brand-icons.mts"
+ "build:brand-icons": "tsx ./scripts/build-brand-icons.mts",
+ "sync:logo": "node ./scripts/sync-logo-assets.mjs"
},
"dependencies": {
"@blocknote/core": "0.56.0",
diff --git a/web/public/apple-touch-icon.png b/web/public/apple-touch-icon.png
index bf8e76ca2..33e52db64 100644
Binary files a/web/public/apple-touch-icon.png and b/web/public/apple-touch-icon.png differ
diff --git a/web/public/banner.png b/web/public/banner.png
index 3a1d22d44..1010d8f65 100644
Binary files a/web/public/banner.png and b/web/public/banner.png differ
diff --git a/web/public/brand/apple-touch-icon.png b/web/public/brand/apple-touch-icon.png
new file mode 100644
index 000000000..33e52db64
Binary files /dev/null and b/web/public/brand/apple-touch-icon.png differ
diff --git a/web/public/brand/black-full.png b/web/public/brand/black-full.png
new file mode 100644
index 000000000..9db66559b
Binary files /dev/null and b/web/public/brand/black-full.png differ
diff --git a/web/public/brand/black-logo.png b/web/public/brand/black-logo.png
new file mode 100644
index 000000000..2bde136a7
Binary files /dev/null and b/web/public/brand/black-logo.png differ
diff --git a/web/public/brand/black-word.png b/web/public/brand/black-word.png
new file mode 100644
index 000000000..0d239b3fc
Binary files /dev/null and b/web/public/brand/black-word.png differ
diff --git a/web/public/brand/color-full.png b/web/public/brand/color-full.png
new file mode 100644
index 000000000..3f8b98ece
Binary files /dev/null and b/web/public/brand/color-full.png differ
diff --git a/web/public/brand/color-logo.png b/web/public/brand/color-logo.png
new file mode 100644
index 000000000..53d92a746
Binary files /dev/null and b/web/public/brand/color-logo.png differ
diff --git a/web/public/brand/color-word.png b/web/public/brand/color-word.png
new file mode 100644
index 000000000..1010d8f65
Binary files /dev/null and b/web/public/brand/color-word.png differ
diff --git a/web/public/brand/favicon-16x16.png b/web/public/brand/favicon-16x16.png
new file mode 100644
index 000000000..487d9e280
Binary files /dev/null and b/web/public/brand/favicon-16x16.png differ
diff --git a/web/public/brand/favicon-32x32.png b/web/public/brand/favicon-32x32.png
new file mode 100644
index 000000000..c05f488cf
Binary files /dev/null and b/web/public/brand/favicon-32x32.png differ
diff --git a/web/public/favicon-16x16.png b/web/public/favicon-16x16.png
index 217765a3e..487d9e280 100644
Binary files a/web/public/favicon-16x16.png and b/web/public/favicon-16x16.png differ
diff --git a/web/public/favicon-32x32.png b/web/public/favicon-32x32.png
index b668519a0..c05f488cf 100644
Binary files a/web/public/favicon-32x32.png and b/web/public/favicon-32x32.png differ
diff --git a/web/public/logo-ver2.png b/web/public/logo-ver2.png
index 856aee98b..53d92a746 100644
Binary files a/web/public/logo-ver2.png and b/web/public/logo-ver2.png differ
diff --git a/web/public/logo.png b/web/public/logo.png
index 8aa1c50fb..53d92a746 100644
Binary files a/web/public/logo.png and b/web/public/logo.png differ
diff --git a/web/public/logo_black.png b/web/public/logo_black.png
index 67af9ff48..2bde136a7 100644
Binary files a/web/public/logo_black.png and b/web/public/logo_black.png differ
diff --git a/web/scripts/sync-logo-assets.mjs b/web/scripts/sync-logo-assets.mjs
new file mode 100644
index 000000000..6f4f32012
--- /dev/null
+++ b/web/scripts/sync-logo-assets.mjs
@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+// Run from the source checkout: npm --prefix web run sync:logo
+// sharp is installed with Next.js. Keep the approved source images untouched.
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import sharp from "sharp";
+
+const webRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const sourceRoot = path.resolve(webRoot, "../assets/figs/logo");
+const publicRoot = path.join(webRoot, "public");
+const targetRoot = path.join(publicRoot, "brand");
+await mkdir(targetRoot, { recursive: true });
+
+// Imagegen exports contain large transparent margins and a few nearly invisible
+// pixels. Bound the visible artwork, but retain its original alpha and colors.
+async function artwork(source) {
+ const { data, info } = await sharp(source).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+ let left = info.width, top = info.height, right = -1, bottom = -1;
+ for (let y = 0; y < info.height; y++) {
+ for (let x = 0; x < info.width; x++) {
+ if (data[(y * info.width + x) * info.channels + info.channels - 1] <= 32) continue;
+ left = Math.min(left, x);
+ top = Math.min(top, y);
+ right = Math.max(right, x);
+ bottom = Math.max(bottom, y);
+ }
+ }
+ if (right < left) throw new Error(`No visible logo in ${source}`);
+ left = Math.max(0, left - 4);
+ top = Math.max(0, top - 4);
+ right = Math.min(info.width - 1, right + 4);
+ bottom = Math.min(info.height - 1, bottom + 4);
+ return sharp(source).extract({ left, top, width: right - left + 1, height: bottom - top + 1 });
+}
+
+for (const color of ["color", "black"]) {
+ for (const kind of ["logo", "word", "full"]) {
+ const name = `${color}-${kind}.png`;
+ const pipeline = await artwork(path.join(sourceRoot, name));
+ if (kind === "logo") {
+ pipeline.resize(512, 512, { fit: "contain", background: { r: 0, g: 0, b: 0, alpha: 0 } });
+ } else {
+ pipeline.resize({ width: kind === "word" ? 1200 : 1600, withoutEnlargement: true });
+ }
+ const info = await pipeline.png().toFile(path.join(targetRoot, name));
+ console.log(`${name}: ${info.width} × ${info.height}`);
+ }
+}
+
+// Keep old URLs useful for images embedded in already-saved notes/documents.
+for (const [alias, source] of Object.entries({
+ "logo.png": "color-logo.png",
+ "logo_black.png": "black-logo.png",
+ "banner.png": "color-word.png",
+ "logo-ver2.png": "color-logo.png",
+})) {
+ await copyFile(path.join(targetRoot, source), path.join(publicRoot, alias));
+}
+
+for (const [name, size] of [["favicon-16x16.png", 16], ["favicon-32x32.png", 32], ["apple-touch-icon.png", 180]]) {
+ await sharp(path.join(targetRoot, "color-logo.png")).resize(size, size).png().toFile(path.join(targetRoot, name));
+ await copyFile(path.join(targetRoot, name), path.join(publicRoot, name));
+}
diff --git a/web/tests/proxy-policy.test.ts b/web/tests/proxy-policy.test.ts
index b5f1f46df..b8af63abe 100644
--- a/web/tests/proxy-policy.test.ts
+++ b/web/tests/proxy-policy.test.ts
@@ -107,6 +107,10 @@ test("isAuthExempt allows public static assets through the auth gate (issue #599
assert.equal(isAuthExempt("/logo.png"), true);
assert.equal(isAuthExempt("/banner.png"), true);
assert.equal(isAuthExempt("/logo_black.png"), true);
+ assert.equal(isAuthExempt("/brand/color-logo.png"), true);
+ assert.equal(isAuthExempt("/brand/color-word.png"), true);
+ assert.equal(isAuthExempt("/brand/black-logo.png"), true);
+ assert.equal(isAuthExempt("/brand/favicon-32x32.png"), true);
assert.equal(isAuthExempt("/apple-touch-icon.png"), true);
assert.equal(isAuthExempt("/provider-icons/openai.svg"), true);
assert.equal(isAuthExempt("/pdfjs/wasm/openjpeg.wasm"), true);