DeepTutor v1.6.9 Release Notes

Release Date: 2026.09.21

Building on v1.6.8, v1.6.9 brings folder-based learning workspaces, a daily practice loop, redesigned Settings, and clearer streaming conversations. Learning surfaces move under /learning/ with redirects for old links; conversation deletion now means permanent deletion, with archiving available for conversations you want to keep.

What's New

Workspaces for your learning data

Choose a workspace when starting a conversation, book, mastery path, reading or watching session. Custom workspaces keep learning data in .deeptutor/data/ and generated files in outputs/; settings, credentials and Memory remain shared across your account. Manage workspaces and their Skills, MCP services and knowledge bases in Settings → Workspaces. Partners can keep private resources or stay linked to a workspace. See workspaces.

Data migration with previews and recovery

Settings → Data Migration previews the files, sessions and dependencies involved before moving data between workspaces. Transfers verify copied data before clearing the source, refuse conflicting destination data, and retain recovery snapshots after completion. An interrupted operation can be resumed or rolled back from Recent operations.

Practice over your existing question bank

Personalized Learning → Practice adds daily review, mistake tracking and statistics to the questions already available at /space/questions. Choice and true/false questions are graded server-side; fill-in and short answers use self-assessment. Import .xlsx, .csv, .tsv or .json files, up to 500 questions per import. Mastered questions pause review scheduling; a later incorrect answer resumes it.

Settings with dedicated pages

Settings now has grouped navigation and separate pages for Providers, Language models, Task models, Voice, Multimodal generation, Usage, Data migration and Archived chats. Reusable provider credentials sit above their models, with discovery and connection probes. Model edits remain staged until applied. OpenAI Codex sign-in is under Providers; runtime diagnostics are under Runtime status.

Conversations that show the order of work

Streaming text stays alongside the tool calls it introduces. Once an answer arrives, the working-out folds into a reopenable activity header. Question cards remain part of the exchange, and skipped questions show their skipped state. The composer exposes mode, agent, model and resources, with one-click reuse of a previous turn's resources.

Mastery and review improvements

Mastery grading now distinguishes quiz accuracy from concept and design assessment gates, avoiding repeated quizzes that could never advance an objective. The study map refreshes when a turn ends, and drafts bind before their opening turn. Focus-Check attempts from Mastery, Book and Reading share persistent review records; retries use the current attempt's result. Incorrect answers recorded by Partners also reach the question bank.

More reliable maths rendering

Math normalization handles alternative delimiters and formulas embedded in code spans while preserving actual code and ordinary currency amounts. Ambiguous dollar signs stay visible instead of swallowing prose.

Usage, speech and model choices

Answer footers show turn or session tokens, cache usage and duration. A durable per-account usage ledger remains available after a conversation is deleted, without retaining prompts, responses or credentials. Voice adds Doubao Speech through Volcengine for synthesis and transcription. Knowledge bases can bind their own embedding model, and connected agents support a remote Hermes gateway.

Reliability fixes

Reading extensions use their own event loop and support retry after a cancellable timeout. Empty LlamaIndex knowledge bases accept their first upload. Telegram thread routing survives restarts, embedding requests honor date-form Retry-After headers, and documentation crawls respect robots rules and per-host pacing. Chat duration covers submission through completion, and stored session modes survive reloads. Initial JavaScript is smaller through deduplicated English translations and deferred animation features.

Upgrade Notes

Run pip install -U deeptutor; Docker users pull ghcr.io/hkuds/deeptutor:latest.

• Review deletion behavior. Delete permanently removes a conversation, its tutor threads and associated attachments. Use Archive to hide a conversation while keeping it recoverable. Legacy recycle-bin conversations are converted to archived conversations during the session metadata upgrade; restore them through Settings → Archived chats.
• Custom workspaces are opt-in. Existing learning data keeps its historical storage locations until you explicitly move it. Workspace metadata and legacy archived-state records are upgraded automatically. Settings, credentials and Memory remain shared at the account level.
• Learning URLs moved. /books/…, /mastery/…, /reading/… and /watching/… redirect to their /learning/… equivalents. /settings remains available.
• Migration snapshots use disk space. Read the preview before moving data, allow space for copies and recovery snapshots, and pause external writes to affected directories. Existing target data or conflicting IDs block a transfer.
• Archived or unavailable workspaces refuse new writes. Restore or reconnect the workspace before continuing. A Partner with an unavailable bound workspace reports the error instead of silently switching elsewhere.

Full Changelog: v1.6.8...v1.6.9