v0.2.8

[0.2.8] - 2025-12-31

🚀 New Features

• NEW: Data Analyst Agent & Tools
  • Added built-in Data Analyst agent
  • Added DataSchema tool for retrieving schema from CSV/Excel files
  • Support for agent file type restrictions
• NEW: Thinking Mode Support
  • Added configuration support for Thinking mode
  • Added Thinking field to Summary configuration
• NEW: Enhanced File & Storage Management
  • Support listing MinIO buckets and permissions
  • Configurable file upload size limits
  • Full-text merge view mode
• NEW: Conversation Enhancements
  • Added option to disable automatic title generation
  • Enhanced KnowledgeQAStream parameters
  • Support for streaming response types and tool calls
• NEW: System & Configuration
  • Added WEKNORA_VERSION environment variable support
  • APK mirror configuration support in Docker
  • Enhanced chunking separator options
  • FAQ two-level priority tag filtering
  • Update index fields when batch updating tags

⚡ Improvements

• IMPROVED: Agent & Model Handling
  • Unified agent not ready message logic
  • Optimized built-in agent configuration synchronization
  • Removed model locking logic to allow free switching
  • Enhanced model selection and error handling
• IMPROVED: Refactoring
  • Simplified session creation request structure
  • Converted knowledgeRefs to References type
  • Refactored SSE stream setup
  • Refactored bucket policy parsing logic
  • Streamlined Docker package installation

🐛 Bug Fixes

• FIXED: Localization placeholder display issues
• FIXED: Duplicate tag creation and stream response parsing
• FIXED: Missing WebSearchStateService in parallel search
• FIXED: Model list refresh on settings popup close
• FIXED: Asynq Redis DB configuration
• FIXED: Menu deletion logic and count updates
• FIXED: OpenAI API compatibility (exclude ChatTemplateKwargs)
• FIXED: Handled Nginx 413 (Payload Too Large) requests
• FIXED: Added existence check for embeddings table in tag_id migration
  Full Changelog: v0.2.7...v0.2.8

v0.2.7

What's Changed

• fix(chat): exclude ChatTemplateKwargs for OpenAI API by @ysys143 in #496
• feat: Add DataAnalysis tool for analysis information from CSV and Excel files by @begoniezhao in #494
• fix(docker): streamline package installation in Dockerfile by removing upgrade step by @begoniezhao in #498
• fix(docker): remove default value for APK_MIRROR_ARG in Dockerfile by @begoniezhao in #499
• feat: 添加可配置的文件上传大小限制 by @lyingbug in #502
• feat: enhance chunking separator options by @begoniezhao in #505
• [Bug]: 小米模型厂商域名配置错误 #504 by @hylaz in #506
• 支持FAQ两级优先级标签过滤 by @lyingbug in #503

New Contributors

• @ysys143 made their first contribution in #496
• @hylaz made their first contribution in #506

Full Changelog: v0.2.6...v0.2.7

v0.2.6

[0.2.6] - 2025-12-29

🚀 New Features

• NEW: Custom Agent System

  • Support for creating, configuring, and selecting custom agents
  • Agent feature indicators display with MCP service capability support
  • Built-in agent sorting logic ensuring multi-turn conversation auto-enabled in agent mode
  • Agent knowledge base selection modes: all/specified/disabled

• NEW: Helm Chart for Kubernetes Deployment

  • Complete Helm chart for Kubernetes deployment
  • Neo4j template support for GraphRAG functionality
  • Versioned image tags and official images compatibility

• NEW: Enhanced FAQ Management

  • FAQ entry retrieval API supporting single entry query by ID
  • FAQ list sorting by update time (ascending/descending)
  • Enhanced FAQ search with field-specific search (standard question/similar questions/answer/all)
  • Batch update exclusion for FAQ entries in ByTag operations
  • Tag deletion with content_only mode to delete only tag contents

• NEW: Multi-Platform Model Adaptation

  • Support for multiple platform model configurations
  • Title generation model configuration
  • Knowledge base selection mode without mandatory rerank model check

• NEW: Korean Language Support

  • Added Korean (한국어) internationalization support

⚡ Improvements

• IMPROVED: Knowledge Base Operations

  • Async knowledge base deletion with background cleanup via ProcessKBDelete
  • Multi-knowledge base search support with specified file ID filtering
  • Optimized knowledge chunk pagination with type-specific search and sorting logic
  • Enhanced SearchKnowledgeRequest structure with backward compatibility

• IMPROVED: Prompt Template System

  • Restructured prompt template system with multi-scenario template configuration
  • Unified system prompts with optimized agent selector interface

• IMPROVED: Tag Management

  • Enhanced tag deletion with ID exclusion support
  • Async index deletion task for optimized deletion flow
  • Batch TagID update functionality
  • Optimized tag name batch queries for improved efficiency

• IMPROVED: API Documentation

  • Updated API documentation links to new paths
  • Added knowledge search API documentation
  • Enhanced FAQ and tag deletion interface documentation
  • Removed hardcoded host configuration from Swagger docs

🐛 Bug Fixes

• FIXED: Tag ID handling logic for empty strings and UntaggedTagID conditions
• FIXED: JSON query compatibility for different database types (MySQL/PostgreSQL)
• FIXED: GORM batch insert issue where zero-value fields (IsEnabled, Flags) were ignored
• FIXED: Helm chart versioned image tags and runAsNonRoot compatibility

🔧 Refactoring

• REFACTORED: Removed security validation and length limits, simplified input processing logic
• REFACTORED: Enhanced agent configuration with improved selection and state management

v0.2.5

[0.2.5] - 2025-12-22

🚀 New Features

• NEW: In-Input Knowledge Base and File Selection

  • Support selecting knowledge bases and files directly within the input box
  • Display @mentioned knowledge bases and files in message stream
  • Dynamic placeholder text based on knowledge base and web search status

• NEW: API Key Authentication Support

  • Added API Key authentication mechanism
  • Optimized Swagger documentation security configuration
  • Disabled Swagger documentation access in non-production environments by default

• NEW: User Registration Control

  • Added DISABLE_REGISTRATION environment variable to control user registration

• NEW: User Conversation Model Selection

  • Added user conversation model selection state management with store two-way binding

🔒 Security Enhancements

• ENHANCED: MCP stdio transport security validation to prevent command injection attacks
• ENHANCED: SQL security validation rebuilt using PostgreSQL official parser for enhanced query protection
• ENHANCED: Security policy updated with vulnerability reporting guidelines

⚡ Improvements

• IMPROVED: Streaming rendering mechanism optimized for token-by-token Markdown content parsing
• IMPROVED: FAQ import progress refactored to use Redis for task state storage
• IMPROVED: Enhanced knowledge base and search functionality logic

🐛 Bug Fixes

• FIXED: Corrected knowledge ID retrieval in FAQ import tasks
• FIXED: Force removal of legacy vlm_model_id field from knowledge_bases table
• FIXED: Disabled Ollama option for ReRank models in model management with tooltip

v0.2.4

[0.2.4] - 2025-12-17

🚀 New Features

• NEW: FAQ Entry Export

  • Support CSV format export for FAQ entries

• NEW: Asynchronous Knowledge Base Cloning

  • Progress tracking and incremental sync support
  • Automatic tenant context injection during cloning
  • Enhanced SourceID conversion logic and tag mapping for generated questions

• NEW: FAQ Index Type Separation

  • Added is_enabled field filtering
  • Batch update optimization

• NEW: Enhanced Swagger API Documentation Generation

🐛 Bug Fixes

• FIXED: Optimized tag mapping logic and FAQ cloning functionality during knowledge base copying
• FIXED: Adjusted Knowledge struct Metadata field type to json.RawMessage
• FIXED: Migration compatibility issues from older versions

v0.2.3

What's Changed

• Update Node Version, fix uvx find path by @lyingbug in #454
• 支持聊天消息中的图片预览功能，更新Agent提示以包含图文结果输出 by @lyingbug in #455
• fix: pin image versions by @begoniezhao in #457

Full Changelog: v0.2.2...v0.2.3

v0.2.2

[0.2.2] - 2025-12-15

🚀 New Features

• NEW: FAQ Answer Strategy Configuration

  • Added answer strategy field for FAQ entries, supporting all (return all answers) and random (randomly return one answer) modes
  • More flexible FAQ response control

• NEW: FAQ Recommendation Feature

  • Added recommendation field for FAQ entries to mark recommended Q&A
  • Support batch update of FAQ recommendation status by tag
  • Optimized tag deletion logic

• NEW: Document Summary Status Tracking

  • Added SummaryStatus field to Knowledge struct
  • Support tracking document summary generation status

⚡ Infrastructure Improvements

• IMPROVED: Docker Build Optimization

  • Fixed system package conflicts during pip dependency installation with --break-system-packages parameter
  • Adjusted uvx permission configuration
  • Upgraded Node version

• IMPROVED: Database Initialization

  • Optimized database initialization logic with conditional embeddings handling

🐛 Bug Fixes

• FIXED: Corrected MINIO_USE_SSL environment variable parsing logic

v0.2.1

[0.2.1] - 2025-12-08

🚀 New Features

• NEW: Qdrant Vector Database Support
  • Full integration with Qdrant as retriever engine
  • Support for both vector similarity search and full-text keyword search
  • Dynamic collection creation based on embedding dimensions (e.g., weknora_embeddings_768)
  • Professional Chinese word segmentation using jieba for keyword queries

⚡ Infrastructure Improvements

• IMPROVED: Docker Compose Profile Management
  • Added profiles for optional services: minio, qdrant, neo4j, jaeger, full
  • Enhanced dev.sh script with --minio, --qdrant, --neo4j, --jaeger, --full flags
  • Pinned Qdrant Docker image version to v1.16.2 for stability
• IMPROVED: Database Migration System
  • Added automatic dirty state recovery for failed migrations
  • Added Neo4j connection retry mechanism with exponential backoff
  • Improved migration error handling and logging
• IMPROVED: Retriever Engine Configuration
  • Retriever engines now auto-configured from RETRIEVE_DRIVER environment variable
  • No longer required to write retriever config during user registration
  • Added GetEffectiveEngines() method for dynamic engine resolution
  • Centralized engine mapping in types/tenant.go

🐛 Bug Fixes

• FIXED: Qdrant keyword search returning empty results for Chinese queries
• FIXED: Image URL validation logic simplified for better compatibility

v0.2.0

WeKnora v0.2.0 Release Notes

Release Date: 2025-12-05

This is a major feature update introducing ReACT Agent mode, Model Management System, FAQ Knowledge Base, and more.

---

🚀 Major Features

ReACT Agent Mode

• New ReACT Agent mode with built-in tools for knowledge base retrieval
• Support for user-configured MCP tools and web search tools to access external services
• Multiple iterations and reflection to provide comprehensive summary reports
• Cross-knowledge base retrieval support, allowing selection of multiple knowledge bases

Model Management System

• Centralized model configuration management
• Added model selection in knowledge base settings page
• Built-in model sharing functionality across multiple tenants
• Tenants can use shared models but are restricted from editing or viewing model details

Multi-Type Knowledge Base Support

• Support for creating FAQ and document knowledge base types
• Folder import functionality
• URL import functionality
• Tag management system
• Online knowledge entry capability

FAQ Knowledge Base

• New FAQ-type knowledge base
• Batch import and batch delete functionality
• Online FAQ entry
• Online FAQ testing capability

Conversation Strategy Configuration

• Support for configuring Agent models and normal mode models
• Configurable retrieval thresholds
• Online Prompt configuration
• Precise control over multi-turn conversation behavior and retrieval execution methods

Web Search Integration

• Support for extensible web search engines
• Built-in DuckDuckGo search engine

MCP Tool Integration

• Support for extending Agent capabilities through MCP
• Built-in uvx and npx MCP launcher tools
• Support for three transport methods: Stdio, HTTP Streamable, and SSE

---

🎨 UI/UX Improvements

• REDESIGNED: Conversation interface with Agent mode/normal mode switching
• REDESIGNED: Login page UI
• ENHANCED: Session list with time-ordered grouping
• NEW: Quick Actions area with unified UI visual effects
• IMPROVED: Knowledge base list cards displaying type, knowledge count, and build status
• NEW: Breadcrumb navigation in FAQ and document list pages
• REDESIGNED: Knowledge base settings page with separate configuration for type, models, chunking methods, and advanced settings
• NEW: Global settings page for permissions configuration
• ENHANCED: Conversation flow page with tool call execution process display

---

⚡ Infrastructure Upgrades

• NEW: MQ-based async task management ensuring task integrity after service restart
• NEW: Automatic database migration supporting schema and data migration during version upgrades
• NEW: Fast development mode with docker-compose.dev.yml for quick development environment startup
• IMPROVED: Log structure optimization
• NEW: Event subscription and publishing mechanism

Full Changelog: CHANGELOG.md

v0.1.6

WeKnora v0.1.6 Release Notes

Release Date: 2025-11-24

🚀 New Features

Document Parser Enhancements

• NEW: Added support for CSV, XLSX, and XLS file parsing
  • Enhanced document processing capabilities with spreadsheet support
  • Improved data extraction from tabular formats
• NEW: Web page parser implementation
  • Added dedicated web content parsing class
  • Optimized image encoding support for web content
  • Enhanced dependency management for web parsing

Document Processing Improvements

• NEW: Introduced MarkdownTableUtil for optimized table formatting
  • Reduced unnecessary whitespace in markdown tables
  • Improved table readability and consistency
• NEW: Document model class implementation
  • Added structured document models for better type safety
  • Optimized configuration and parsing logic
• UPGRADED: Enhanced document parser to Docx2Parser
  • Improved timeout handling
  • Better image processing logic
  • Optimized OCR backend management

🌍 Internationalization

• NEW: Multi-language support (English and Russian)
  • Added vue-i18n dependency for internationalization
  • Replaced hardcoded messages with translation functions
  • Updated error messages, console outputs, and UI text
  • Enhanced multilingual documentation with knowledge graph and MCP configuration guides

🐛 Bug Fixes

• FIXED: Menu component integration issues
• FIXED: Darwin (macOS) system memory check regex error
  • Resolved empty output issue when checking memory usage on macOS
• FIXED: Model availability check logic
  • Unified model checking logic across different interfaces
  • Added automatic ":latest" tag for models without specified versions
  • Prevented repeated model pull API calls due to false negatives
• FIXED: Security vulnerability in Docker Compose configuration
  • Addressed writable filesystem service security issue

🔧 Refactoring & Optimization

• REFACTORED: Parser logging and API check logic
  • Simplified exception handling
  • Improved error reporting and debugging
• REFACTORED: Chunk processing
  • Removed unnecessary header handling
  • Updated example usage for better clarity
• REFACTORED: Module organization
  • Reorganized docreader module files for better structure
  • Updated proto and client import paths
  • Adjusted Docker build configuration
  • Unified module import paths to absolute imports

📚 Documentation Updates

• UPDATED: API Key acquisition documentation
  • Changed to web registration and account page retrieval method
• UPDATED: Docker Compose startup configuration guide
  • Added comprehensive setup instructions
  • Adjusted docker-compose.yml configuration
• UPDATED: Multilingual documentation
  • Added knowledge graph configuration guide
  • Enhanced MCP configuration documentation
  • Updated directory structure documentation
• REMOVED: Deprecated hybrid search API documentation

🧹 Code Cleanup

• REMOVED: Redundant Docker build parameters
• UPDATED: .gitignore rules for better repository hygiene
• OPTIMIZED: Import statements and type hints
• CLEANED: Redundant logging and comments

🔄 CI/CD Improvements

• ADDED: New trigger branches for CI/CD pipeline
• ADDED: Concurrency control for build processes
• ADDED: Disk space cleanup automation

👥 Contributors

Special thanks to all contributors who made this release possible:

• @begoniezhao
• @fuyaozong
• @Aleksandr
• @suroy
• @Galaxy
• @orbisai-security