DeepTutor v1.6.3 Release Notes

Release Date: 2026.09.02

v1.6.3 includes a breaking front- and back-end refactor that replaces compatibility routes and stream entry points with strict canonical contracts, alongside learner and guardian accounts, grounded Reading actions, broader knowledge and parsing, and Python 3.14. Workspace data migrates in place, but bookmarks and external clients using retired URLs must update.

What's New

Breaking front- and back-end refactor

Home now runs on the server-authoritative turn protocol and typed frontend contracts. Web resources have canonical, bookmarkable URLs; Chat, Mastery Path, and Reading reject extra session segments instead of silently accepting them; login return paths preserve query and hash without permitting external redirects. Every WebSocket is now under /ws/..., and the old frontend compatibility entrances have been removed.

Learner accounts with a guardian loop

Admins can create Standard, Learner, or Custom accounts. Learner profiles carry age, grade, curriculum, language, reading level, and explanation preferences into the tutor; server-enforced policies constrain capabilities and approved materials. Authorized guardians can assign or remove materials, read progress reports, and reset revocable device credentials with expiry and daily limits.

Reading becomes an active study surface

Immersive Reading adds verified clickable citations, saved citations and notes, source-grounded read-aloud, study guidance, vocabulary, quizzes, translation, and notebook capture. Home can turn a reply into an inline Markdown note, while Immersive Watching saves timestamped transcript notes and retries unavailable Invidious captions.

Long-running work now stops and resumes cleanly

Book generation has a persistent pause that cancels queued and in-flight work without losing completed pages, resumes only on request, and automatically pauses repeated model failures. Chat, Book, Knowledge, and Memory streams use monotonic cursors, replay, deduplication, and terminal-state recovery; quiz judging and subagent consultations can be stopped and are bounded by timeouts.

More knowledge engines, faster local retrieval, broader parsing

Connect a self-hosted WeKnora knowledge base without copying its documents or building a local index. LlamaIndex gains optional cross-encoder reranking and exact-flat or HNSW FAISS indexes; LightRAG can use a dedicated model. Document parsing now follows each engine's current format catalog, including broad Docling, Tika, PyMuPDF4LLM, LiteParse, and markitdown coverage.

More provider and authoring choices

DashScope joins text-to-speech, speech-to-text, image, and video generation. OpenAI-compatible profiles can explicitly select Responses or Chat Completions, with reasoning state preserved across turns. Co-Writer imports .docx drafts and exports Word, and Settings adds searchable tools.

Safer reports, sandboxes, and launchers

Deep Research retries incomplete report sections without leaking duplicate partial prose. Local execution enforces output and process limits. The launcher adds a macOS startup command, browser-safe Windows behavior, detached/no-browser operation, and deeptutor stop; interrupted chat streams also recover more reliably.

Upgrade Notes

Run pip install -U deeptutor; Docker users pull ghcr.io/hkuds/deeptutor:latest. Existing settings, accounts, knowledge indexes, books, Reading state, and sessions need no manual migration or re-index; startup migrates legacy chat and workspace-preference data in place.

• Update bookmarks and custom frontends. Canonical session routes are /chat/{sessionId}, /mastery/{pathId}/sessions/{sessionId}, and /reading/{workspaceId}/sessions/{sessionId}. Resource routes are /books/{bookId}/pages/{pageId}, /notebooks/{notebookId}, and /knowledge-bases/{kbName}. Retired /space/learning/*, /partners/groups, and /settings/about entrances no longer redirect; use /mastery, the Partner workspace, and /settings#about.

• Update WebSocket clients. The canonical namespace is /ws, /ws/books, /ws/questions/*, /ws/knowledge-bases/{kbName}/progress, /ws/mastery-paths, /ws/partners/{partnerId}, and /ws/partner-groups/{groupId}. Legacy API-prefixed sockets are removed.

• Python 3.14 is supported by the core app and CLI. GraphRAG remains on Python 3.11–3.13. On 3.14, LlamaIndex falls back to vector retrieval when the optional BM25 dependency is unavailable.

• Refresh optional parser extras. The supported floors are markitdown 0.1.7, Docling 2.123.1, PyMuPDF4LLM 1.28.2, LiteParse 2.14.2, MinerU 3.4.5, and Apache Tika 4. Older engines report that they need an update instead of running against an incompatible API.

• The English and Chinese guides have been updated together at deeptutor.info.

Full Changelog: v1.6.2...v1.6.3