v1.6.12

DeepTutor v1.6.12 Release Notes

Release Date: 2026.09.27

Building on v1.6.11, v1.6.12 lets each workspace place and move its knowledge bases, connects searchable Kiwix archives, and carries source figures into grounded answers. A Task Board, German interface, and recovery fixes round out the release. Existing data needs no migration; systemd installs now update outside the app.

What's New

Knowledge bases follow the workspace

Choose the storage workspace when creating a knowledge base. Move one existing base from its Settings panel after reviewing destination blockers and affected assignments; DeepTutor verifies the copied data and index before switching references. Saved knowledge-base IDs and workspace assignments continue to resolve. Moves are blocked while processing or when shared grants, destination collisions, or unsupported MarginNote data make them unsafe.

Connect Kiwix archives

Connect one searchable ZIM archive served by kiwix-serve as a knowledge base from the Knowledge Center or deeptutor kb connect-kiwix. Search reads the archive on demand without uploading or indexing a copy. You can also bring an article into Immersive Reading. Removing the connection leaves the archive untouched.

Source figures in grounded answers

The LlamaIndex knowledge pipeline can retain parser-extracted PDF and EPUB images alongside their captions and source locations. When retrieval finds one, a vision-capable answer model sees the verified pixels; text-only models receive the caption and context with an explicit limit. Immersive Reading can inspect a stored figure on demand. This depends on a parser that emits images and reindexing older content; see Upgrade Notes.

Task Board and learning controls

A workspace-local Task Board tracks To do, In progress, and Done cards with notes, accessible move controls, and a restorable archive. Guided Learning now respects an explicit teach-first preference and gives a localized next step. Teacher and student join the accepted non-admin role values without gaining admin privileges.

Languages and providers

German joins the interface languages, and Malay becomes a reply-language option. Cheaper Inference joins LLM providers; local Lemonade embeddings work without an API key. DashScope image, video, and speech requests use supported endpoints, sizes, and model IDs; saved DashScope paraformer-v2 speech profiles migrate to paraformer-realtime-v2 automatically.

Reliability and accessibility

Failed chat submissions remain recoverable across retries and storage races, and unanswered turns can recover from a lost worker. LightRAG reuses only compatible indexing caches, retrieved figures stay within bounded model context, and partial Deep Research and Manim failures report their cause. Shared tooltips replace inaccessible native title hints across learning and workspace controls, including touch interactions.

Upgrade Notes

Run pip install -U deeptutor; Docker users pull ghcr.io/hkuds/deeptutor:latest. Existing data needs no manual migration.

• Kiwix: run a reachable kiwix-serve instance with full-text search for the chosen ZIM, then connect its server URL and archive name. Disconnecting only removes the DeepTutor pointer.
• Older knowledge-base figures: reindex existing LlamaIndex source files to create visual records. MinerU and PyMuPDF4LLM can emit supported images; the default text-only parser and current Docling adapter do not. Other RAG engines do not index the visual records yet.
• systemd installs: in-app update handoff is disabled for a running service. Stop the service, upgrade DeepTutor in that service's Python environment, and start it again with systemctl.
• Windows microphone transcription: native DashScope and Volcengine speech adapters need ffmpeg on the service PATH to convert browser WebM/Opus audio; restart DeepTutor after installing it. OpenAI-compatible STT does not need local conversion.

Full Changelog: v1.6.11...v1.6.12