DeepTutor v1.5.2 Release Notes

Release Date: 2026.07.19

A maintenance release on top of v1.5.1: chat attachment limits are now yours to tune, PageIndex retrieves by reasoning across your documents, and a broad sweep of provider, Book, and Knowledge Base reliability fixes lands underneath. Drop-in — no migrations.

What's New

Configurable chat attachment limits

Attachment size caps and extracted-text budgets are now editable in Settings → Chat → Attachments (admin-only): per-file and per-turn upload ceilings, plus per-document and per-turn character budgets, stored in system.json and overridable by CHAT_ATTACHMENT_* environment variables. This also fixes large uploads silently dropping the connection — the WebSocket frame ceiling is now derived from your total cap instead of a fixed default. Lowering a limit takes effect on the next message; raising the size cap past the current frame ceiling needs a restart.

PageIndex retrieves by reasoning over your documents

PageIndex knowledge bases are now queried through an internal MCP server, so chat retrieves by making agentic tool calls against the document tree rather than a single fixed lookup — sharper page-level citations on multi-step questions. Ingestion also accepts more formats now: PDF, Office (Word / PowerPoint / Excel), Markdown, plain text, and CSV.

Broader, steadier model support

• Newer Anthropic and OpenAI models work through their official SDKs, including OpenAI Codex native tool calls.
• Effort-based Claude models drive extended thinking adaptively instead of a fixed token budget, and the temperature-rejection model set is corrected so unsupported models no longer error out.
• Streamed token usage is counted once per completion, fixing inflated usage and cost accounting.

Steadier Book and Knowledge Base

• Book pages stuck in GENERATING or PLANNING are rescued and reset on failure, so a background compile error no longer strands a page.
• Knowledge Base status updates on upload and folder sync, linked-folder sync state persists, and all manager writes are atomic — no more half-written JSON after a crash.

Chat and channel polish

Full-width chat with a single, predictable scrollbar; aligned composer and message columns; Enter sends an edited message (Shift+Enter for a newline); and malformed Markdown links no longer crash the renderer. WeCom partners are aligned with SDK 1.0.8, and Mastery Path recency weighting is restored (#618).

Upgrade Notes

Drop-in from v1.5.1: pip install -U deeptutor; Docker users pull ghcr.io/hkuds/deeptutor:latest. No migrations — existing knowledge bases, partners, and mastery paths keep working. The new attachment defaults are generous (20 MB per file, 25 MB per turn; 200k / 150k character budgets), so nothing changes unless you tune them under Settings → Chat → Attachments; only raising the size cap past the current WebSocket frame ceiling requires a restart.

Full Changelog: https://github.com/HKUDS/DeepTutor/compare/v1.5.1...v1.5.2