v1.6.0

DeepTutor v1.6.0 Release Notes

Release Date: 2026.08.27

v1.5.17 made Partners personal and let knowledge bases track GitHub. v1.6.0 connects the rest of the learning workspace: source-faithful reading, Courses and Little Tutor threads, an Ask Questions mode, bounded web-source sync, and Books shared without sharing a reader's learning state. Existing data stays in place; multi-user admins only need to grant Book access where wanted.

What's New

Immersive Reading becomes a full reader

EPUB joins PDF in a source-faithful view, with format-aware outlines and saved reading position. W3C text selectors keep highlights attached through reflow, Recogito renders annotations, extracted-text views gain persistent typography and colour controls, and installed Reading extensions receive only verified visible text or selections through a bounded protocol.

Courses, Little Tutor, and Ask Questions

Learning Space now organizes conversations into Courses, with pin, archive, move, filter, and nested tutor-thread controls. Select text in a conversation to open an independent, source-grounded Little Tutor thread that stays under its parent and inherits the course. Ask Questions starts with a context-aware clarification card, then completes the original request from the answers.

Knowledge bases track documentation sites

Alongside GitHub repositories, a KB can register a documentation URL with explicit crawl-depth and page-count bounds. On-demand sync hash-diffs added, changed, and removed pages before re-indexing. Serply adds web, news, and scholar search modes, while compatible OpenAI Responses models can use their native server-side web search.

Shared Books keep learning private

Admins can share canonical Books per user as none, read, or collaborative edit, separately control personal Book creation, and keep deletion admin-only. Progress, bookmarks, quiz attempts, Page Chat links, and the reviewable Learning Capture inbox stay private per reader. Shared edits use revision checks so a stale editor refreshes instead of overwriting a collaborator.

Reading, tutoring, and long-session reliability

Reader outlines and sequential navigation keep their place, malformed or timed-out Reading extensions stay isolated, and annotation anchors survive headings and reflow. Selection Tutor grounding and quiz follow-ups remain durable; Mastery rejects plain-text quiz fallbacks and distinguishes clarification from an answer; conversation compaction stays within bounded budgets and decoded invisible Unicode controls no longer leak into display.

Provider and platform hardening

llama.cpp reports its real context window, Kimi coding models receive compatible parameters, LightRAG preserves asymmetric embedding context, and Codex TLS failures remain fail-closed. Windows runner, tool, path, and test compatibility received a broad cleanup. Release workflows now reject misleading or non-version tags before they can displace the latest stable release.

Upgrade Notes

pip install -U deeptutor; Docker users pull ghcr.io/hkuds/deeptutor:latest. No manual migration or re-index is required.

• Shared admin Books default to no access. Existing personal Books remain private and unchanged. In a multi-user deployment, open /admin/users, expand a user, and configure Book access only for the admin Books they should read or edit.
• Shared edits are optimistic. If another editor advances a Book revision first, refresh the Book and apply the change again; DeepTutor will not silently overwrite the newer revision.
• Web and GitHub sources remain opt-in. Existing knowledge bases are unchanged until you register a source and run sync.
• Search remains optional. Select Serply during deeptutor init or configure it later under Settings → Models → Search; existing search settings continue to work.
• The English and Chinese guides have been updated together at deeptutor.info.

Full Changelog: v1.5.17...v1.6.0