feat: Release v0.2.0 with major enhancements and new features

2026-06-04 13:30:32 +08:00 · 2025-11-26 11:57:24 +08:00
parent b5890b3169
commit 991cffb14c
6 changed files with 200 additions and 13 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,86 @@

 All notable changes to this project will be documented in this file.

+## [0.2.0] - 2025-11-26
+
+### 🚀 Major Features
+- **NEW**: ReACT Agent Mode
+  - Added ReACT Agent mode that can use built-in tools to retrieve knowledge bases
+  - Support for calling 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
+- **NEW**: Model Management System
+  - Centralized model configuration
+  - 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
+- **NEW**: 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
+- **NEW**: FAQ Knowledge Base
+  - New FAQ-type knowledge base
+  - Batch import and batch delete functionality
+  - Online FAQ entry
+  - Online FAQ testing capability
+- **NEW**: 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
+- **NEW**: Web Search Integration
+  - Support for extensible web search engines
+  - Built-in DuckDuckGo search engine
+- **NEW**: 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
+  - Added Agent mode/normal mode toggle in conversation input box
+  - Support for enabling/disabling web search
+  - Support for selecting conversation models
+- **REDESIGNED**: Login page UI adjustments
+- **ENHANCED**: Session list with time-ordered grouping
+- **NEW**: Quick Actions area for unified UI visual effects
+- **IMPROVED**: Knowledge base list cards
+  - Display knowledge base type, knowledge count, build status
+  - Show advanced settings capabilities
+- **NEW**: Breadcrumb navigation in FAQ and document list pages
+  - Quick navigation and knowledge base switching
+- **ENHANCED**: Knowledge base settings in document list page
+- **REDESIGNED**: Knowledge base settings page
+  - Separate configuration for knowledge base type, models, chunking methods, and advanced settings
+- **NEW**: Global settings page for permissions
+  - Configure models, web search, MCP services, and Agent mode
+- **IMPROVED**: Chunk details page display
+- **NEW**: Knowledge classification and tagging support
+- **ENHANCED**: Conversation flow page with tool call execution process display
+
+### ⚡ Infrastructure Upgrades
+- **NEW**: MQ-based async task management
+  - Introduced MQ for async task state maintenance
+  - Ensures task integrity even after service abnormal restart
+- **NEW**: Automatic database migration
+  - Support for automatic database schema and data migration during version upgrades
+- **NEW**: Fast development mode
+  - Added docker-compose.dev.yml file for quick development environment startup
+  - Improved development workflow efficiency
+- **IMPROVED**: Log structure optimization
+- **NEW**: Event subscription and publishing mechanism
+  - Support for event handling at various steps in user query processing flow
+
+### 🐛 Bug Fixes
+- Various bug fixes and stability improvements
+
+### 📚 Documentation Updates
+- Updated README files with v0.2.0 highlights (English, Chinese, Japanese)
+- Added latest updates section in all README files
+- Updated architecture diagrams and feature matrices
+
 ## [0.1.4] - 2025-09-17

 ### 🚀 Major Features
@@ -97,6 +177,7 @@ All notable changes to this project will be documented in this file.
 - Docker Compose for quick startup and service orchestration.
 - MCP server support for integrating with MCP-compatible clients.

+[0.2.0]: https://github.com/Tencent/WeKnora/tree/v0.2.0
 [0.1.4]: https://github.com/Tencent/WeKnora/tree/v0.1.4
 [0.1.3]: https://github.com/Tencent/WeKnora/tree/v0.1.3
 [0.1.2]: https://github.com/Tencent/WeKnora/tree/v0.1.2
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@
        <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
    </a>
    <a href="./CHANGELOG.md">
-        <img alt="Version" src="https://img.shields.io/badge/version-0.1.3-2e6cc4?labelColor=d4eaf7">
+        <img alt="Version" src="https://img.shields.io/badge/version-0.2.0-2e6cc4?labelColor=d4eaf7">
    </a>
 </p>

@@ -41,6 +41,18 @@ It adopts a modular architecture that combines multimodal preprocessing, semanti

 **Website:** https://weknora.weixin.qq.com

+## ✨ Latest Updates
+
+**v0.2.0 Highlights:**
+
+- 🤖 **Agent Mode**: New ReACT Agent mode that can call built-in tools, MCP tools, and web search, providing comprehensive summary reports through multiple iterations and reflection
+- 📚 **Multi-Type Knowledge Bases**: Support for FAQ and document knowledge base types, with new features including folder import, URL import, tag management, and online entry
+- ⚙️ **Conversation Strategy**: Support for configuring Agent models, normal mode models, retrieval thresholds, and Prompts, with precise control over multi-turn conversation behavior
+- 🌐 **Web Search**: Support for extensible web search engines with built-in DuckDuckGo search engine
+- 🔌 **MCP Tool Integration**: Support for extending Agent capabilities through MCP, with built-in uvx and npx launchers, supporting multiple transport methods
+- 🎨 **New UI**: Optimized conversation interface with Agent mode/normal mode switching, tool call process display, and comprehensive knowledge base management interface upgrade
+- ⚡ **Infrastructure Upgrade**: Introduced MQ async task management, support for automatic database migration, and fast development mode
+
 ## 🔒 Security Notice

 **Important:** Starting from v0.1.3, WeKnora includes login authentication functionality to enhance system security. For production deployments, we strongly recommend:
@@ -52,7 +64,7 @@ It adopts a modular architecture that combines multimodal preprocessing, semanti

 ## 🏗️ Architecture

-![weknora-pipeline.png](./docs/images/pipeline.jpg)
+![weknora-architecture.png](./docs/images/architecture.png)

 WeKnora employs a modern modular design to build a complete document understanding and retrieval pipeline. The system primarily includes document parsing, vector processing, retrieval engine, and large model inference as core modules, with each component being flexibly configurable and extendable.

@@ -308,6 +320,33 @@ Detailed API documentation is available at: [API Docs](./docs/API.md)

 ## 🧭 Developer Guide

+### ⚡ Fast Development Mode (Recommended)
+
+If you need to frequently modify code, **you don't need to rebuild Docker images every time**! Use fast development mode:
+
+```bash
+# Method 1: Using Make commands (Recommended)
+make dev-start      # Start infrastructure
+make dev-app        # Start backend (new terminal)
+make dev-frontend   # Start frontend (new terminal)
+
+# Method 2: One-click start
+./scripts/quick-dev.sh
+
+# Method 3: Using scripts
+./scripts/dev.sh start     # Start infrastructure
+./scripts/dev.sh app       # Start backend (new terminal)
+./scripts/dev.sh frontend  # Start frontend (new terminal)
+```
+
+**Development Advantages:**
+- ✅ Frontend modifications auto hot-reload (no restart needed)
+- ✅ Backend modifications quick restart (5-10 seconds, supports Air hot-reload)
+- ✅ No need to rebuild Docker images
+- ✅ Support IDE breakpoint debugging
+
+**Detailed Documentation:** [Development Environment Quick Start](./docs/开发指南.md)
+
 ### 📁 Directory Structure

 ```
--- a/README_CN.md
+++ b/README_CN.md
@@ -15,7 +15,7 @@
        <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
    </a>
    <a href="./CHANGELOG.md">
-        <img alt="版本" src="https://img.shields.io/badge/version-0.1.3-2e6cc4?labelColor=d4eaf7">
+        <img alt="版本" src="https://img.shields.io/badge/version-0.2.0-2e6cc4?labelColor=d4eaf7">
    </a>
 </p>

@@ -41,6 +41,18 @@

 **官网：** https://weknora.weixin.qq.com

+## ✨ 最新更新
+
+**v0.2.0 版本亮点：**
+
+- 🤖 **Agent模式**：新增ReACT Agent模式，支持调用内置工具、MCP工具和网络搜索，通过多次迭代和反思提供全面总结报告
+- 📚 **多类型知识库**：支持FAQ和文档两种类型知识库，新增文件夹导入、URL导入、标签管理和在线录入功能
+- ⚙️ **对话策略**：支持配置Agent模型、普通模式模型、检索阈值和Prompt，精确控制多轮对话行为
+- 🌐 **网络搜索**：支持可扩展的网络搜索引擎，内置DuckDuckGo搜索引擎
+- 🔌 **MCP工具集成**：支持通过MCP扩展Agent能力，内置uvx、npx启动工具，支持多种传输方式
+- 🎨 **全新UI**：优化对话界面，支持Agent模式/普通模式切换，展示工具调用过程，知识库管理界面全面升级
+- ⚡ **底层升级**：引入MQ异步任务管理，支持数据库自动迁移，提供快速开发模式
+
 ## 🔒 安全声明

 **重要提示：** 从 v0.1.3 版本开始，WeKnora 提供了登录鉴权功能，以增强系统安全性。在生产环境部署时，我们强烈建议：
@@ -52,7 +64,7 @@

 ## 🏗️ 架构设计

-![weknora-pipelone.png](./docs/images/pipeline.jpg)
+![weknora-pipelone.png](./docs/images/architecture.png)

 WeKnora 采用现代化模块化设计，构建了一条完整的文档理解与检索流水线。系统主要包括文档解析、向量化处理、检索引擎和大模型推理等核心模块，每个组件均可灵活配置与扩展。

@@ -335,7 +347,7 @@ make dev-frontend   # 启动前端（新终端）
 - ✅ 无需重新构建 Docker 镜像
 - ✅ 支持 IDE 断点调试

-**详细文档：** [开发环境快速入门](./DEVELOPMENT.md) | [完整开发指南](./docs/开发指南.md)
+**详细文档：** [开发环境快速入门](./docs/开发指南.md)

 ### 📁 项目目录结构

--- a/README_JA.md
+++ b/README_JA.md
@@ -15,7 +15,7 @@
        <img src="https://img.shields.io/badge/License-MIT-ffffff?labelColor=d4eaf7&color=2e6cc4" alt="License">
    </a>
    <a href="./CHANGELOG.md">
-        <img alt="バージョン" src="https://img.shields.io/badge/version-0.1.3-2e6cc4?labelColor=d4eaf7">
+        <img alt="バージョン" src="https://img.shields.io/badge/version-0.2.0-2e6cc4?labelColor=d4eaf7">
    </a>
 </p>

@@ -41,9 +41,21 @@

 **公式サイト：** https://weknora.weixin.qq.com

+## ✨ 最新アップデート
+
+**v0.2.0 バージョンのハイライト：**
+
+- 🤖 **Agentモード**：新規ReACT Agentモードを追加、組み込みツール、MCPツール、Web検索を呼び出し、複数回の反復とリフレクションを通じて包括的なサマリーレポートを提供
+- 📚 **複数タイプのナレッジベース**：FAQとドキュメントの2種類のナレッジベースをサポート、フォルダーインポート、URLインポート、タグ管理、オンライン入力機能を新規追加
+- ⚙️ **対話戦略**：Agentモデル、通常モードモデル、検索閾値、Promptの設定をサポート、マルチターン対話の動作を精密に制御
+- 🌐 **Web検索**：拡張可能なWeb検索エンジンをサポート、DuckDuckGo検索エンジンを組み込み
+- 🔌 **MCPツール統合**：MCPを通じてAgent機能を拡張、uvx、npx起動ツールを組み込み、複数の転送方式をサポート
+- 🎨 **新UI**：対話インターフェースを最適化、Agentモード/通常モードの切り替え、ツール呼び出しプロセスの表示、ナレッジベース管理インターフェースの全面的なアップグレード
+- ⚡ **インフラストラクチャのアップグレード**：MQ非同期タスク管理を導入、データベース自動マイグレーションをサポート、高速開発モードを提供
+
 ## 🔒 セキュリティ通知

-**重要：** v0.1.3バージョンより、WeKnoraにはシステムセキュリティを強化するためのログイン認証機能が含まれています。本番環境でのデプロイメントにおいて、以下を強く推奨します：
+**重要：** v0.1.3バージョンより、WeKnoraにはシステムセキュリティを強化するためのログイン認証機能が含まれています。v0.2.0では、さらに多くの機能強化と改善が追加されました。本番環境でのデプロイメントにおいて、以下を強く推奨します：

 - WeKnoraサービスはパブリックインターネットではなく、内部/プライベートネットワーク環境にデプロイしてください
 - 重要な情報漏洩を防ぐため、サービスを直接パブリックネットワークに公開することは避けてください
@@ -52,16 +64,21 @@

 ## 🏗️ アーキテクチャ設計

-![weknora-pipelone.png](./docs/images/pipeline.jpg)
+![weknora-pipelone.png](./docs/images/architecture.png)

 WeKnoraは現代的なモジュラー設計を採用し、完全な文書理解と検索パイプラインを構築しています。システムには主に文書解析、ベクトル化処理、検索エンジン、大規模モデル推論などのコアモジュールが含まれ、各コンポーネントは柔軟に設定および拡張できます。

 ## 🎯 コア機能

+- **🤖 Agentモード**：ReACT Agentモードをサポート、組み込みツールでナレッジベースを検索、MCPツールとWeb検索を呼び出し、複数回の反復とリフレクションを通じて包括的なサマリーレポートを提供
 - **🔍 正確な理解**：PDF、Word、画像などの文書の構造化コンテンツ抽出をサポートし、統一された意味ビューを構築
 - **🧠 インテリジェント推論**：大規模言語モデルを活用して文書コンテキストとユーザーの意図を理解し、正確なQ&Aとマルチターン対話をサポート
+- **📚 複数タイプのナレッジベース**：FAQとドキュメントの2種類のナレッジベースをサポート、フォルダーインポート、URLインポート、タグ管理、オンライン入力機能
 - **🔧 柔軟な拡張**：解析、埋め込み、検索から生成までの全プロセスを分離し、柔軟な統合とカスタマイズ拡張を容易に
- **⚡ 効率的な検索**：複数の検索戦略のハイブリッド：キーワード、ベクトル、ナレッジグラフ
+- **⚡ 効率的な検索**：複数の検索戦略のハイブリッド：キーワード、ベクトル、ナレッジグラフ、クロスナレッジベース検索をサポート
+- **🌐 Web検索**：拡張可能なWeb検索エンジンをサポート、DuckDuckGo検索エンジンを組み込み
+- **🔌 MCPツール統合**：MCPを通じてAgent機能を拡張、uvx、npx起動ツールを組み込み、複数の転送方式をサポート
+- **⚙️ 対話戦略**：Agentモデル、通常モードモデル、検索閾値、Promptの設定をサポート、マルチターン対話の動作を精密に制御
 - **🎯 使いやすさ**：直感的なWebインターフェースと標準API、技術的な障壁なしで素早く開始可能
 - **🔒 セキュアで制御可能**：ローカルおよびプライベートクラウドデプロイメントをサポート、データは完全に自己管理可能

@@ -79,15 +96,22 @@ WeKnoraは現代的なモジュラー設計を採用し、完全な文書理解

 | 機能モジュール | サポート状況 | 説明 |
 |---------|---------|------|
+| Agentモード | ✅ ReACT Agentモード | 組み込みツールでナレッジベースを検索、MCPツールとWeb検索を使用、クロスナレッジベース検索、複数回の反復とリフレクションをサポート |
+| ナレッジベースタイプ | ✅ FAQ / ドキュメント | FAQとドキュメントの2種類のナレッジベースの作成をサポート、フォルダーインポート、URLインポート、タグ管理、オンライン入力機能 |
 | 文書フォーマットサポート | ✅ PDF / Word / Txt / Markdown / 画像（OCR / Caption含む） | 様々な構造化・非構造化文書コンテンツの解析をサポート、図文混在と画像文字抽出をサポート |
+| モデル管理 | ✅ 集中設定、組み込みモデル共有 | モデルの集中設定、ナレッジベース設定ページにモデル選択を追加、マルチテナント間での組み込みモデル共有をサポート |
 | 埋め込みモデルサポート | ✅ ローカルモデル、BGE / GTE API等 | カスタムembeddingモデルをサポート、ローカルデプロイとクラウドベクトル生成インターフェースに対応 |
 | ベクトルデータベース接続 | ✅ PostgreSQL（pgvector）、Elasticsearch | 主流のベクトルインデックスバックエンドをサポート、柔軟な切り替えと拡張が可能、異なる検索シナリオに適応 |
 | 検索メカニズム | ✅ BM25 / Dense Retrieve / GraphRAG | 密・疎検索、ナレッジグラフ強化検索など複数の戦略をサポート、検索-再ランキング-生成プロセスを自由に組み合わせ可能 |
 | 大規模モデル統合 | ✅ Qwen、DeepSeek等をサポート、思考/非思考モード切り替え | ローカル大規模モデル（Ollama起動など）に接続可能、または外部APIサービスを呼び出し、推論モードの柔軟な設定をサポート |
+| 対話戦略 | ✅ Agentモデル、通常モードモデル、検索閾値、Prompt設定 | Agentモデル、通常モードに必要なモデル、検索閾値の設定をサポート、オンラインPrompt設定、マルチターン対話の動作を精密に制御 |
+| Web検索 | ✅ 拡張可能な検索エンジン、DuckDuckGo | 拡張可能なWeb検索エンジンをサポート、DuckDuckGo検索エンジンを組み込み |
+| MCPツール | ✅ uvx、npx起動ツール、Stdio/HTTP Streamable/SSE | MCPを通じてAgent機能を拡張、uvx、npxの2種類のMCP起動ツールを組み込み、3種類の転送方式をサポート |
 | Q&A能力 | ✅ コンテキスト認識、マルチターン対話、プロンプトテンプレート | 複雑な意味モデリング、指示制御、チェーンQ&Aをサポート、プロンプトとコンテキストウィンドウを設定可能 |
 | エンドツーエンドテストサポート | ✅ 検索+生成プロセスの可視化と指標評価 | 一体化されたリンクテストツールを提供、リコール的中率、回答カバレッジ、BLEU / ROUGE等の主流指標の評価をサポート |
-| デプロイメントモード | ✅ ローカルデプロイメント / Dockerイメージをサポート | プライベート化、オフラインデプロイメント、柔軟な運用保守のニーズに対応 |
-| ユーザーインターフェース | ✅ Web UI + RESTful API | インタラクティブインターフェースと標準APIインターフェースを提供、開発者とビジネスユーザーの使用習慣に適応 |
+| デプロイメントモード | ✅ ローカルデプロイメント / Dockerイメージ | プライベート化、オフラインデプロイメント、柔軟な運用保守のニーズに対応、高速開発モードをサポート |
+| ユーザーインターフェース | ✅ Web UI + RESTful API | インタラクティブインターフェースと標準APIインターフェースを提供、Agentモード/通常モードの切り替え、ツール呼び出しプロセスの表示をサポート |
+| タスク管理 | ✅ MQ非同期タスク、データベース自動マイグレーション | MQによる非同期タスクの状態維持を導入、バージョンアップ時のデータベーステーブル構造とデータの自動マイグレーションをサポート |

 ## 🚀 クイックスタート

@@ -273,7 +297,11 @@ http://localhost
  </tr>
 </table>

-**ナレッジベース管理：** 各種文書のドラッグ＆ドロップアップロードをサポートし、文書構造を自動認識してコア知識を抽出し、インデックスを構築します。システムは処理の進行状況と文書のステータスを明確に表示し、効率的なナレッジベース管理を実現します。
+**ナレッジベース管理：** FAQとドキュメントの2種類のナレッジベースの作成をサポート、ドラッグ＆ドロップアップロード、フォルダーインポート、URLインポートなど複数の方法をサポート、文書構造を自動認識してコア知識を抽出し、インデックスを構築します。タグ管理とオンライン入力をサポート、システムは処理の進行状況と文書のステータスを明確に表示し、効率的なナレッジベース管理を実現します。
+
+**Agentモード：** ReACT Agentモードの有効化をサポート、組み込みツールでナレッジベースを検索、ユーザーが設定したMCPツールとWeb検索ツールを呼び出して外部サービスにアクセス、複数回の反復とリフレクションを通じて、最終的に包括的なサマリーレポートを提供します。クロスナレッジベース検索をサポート、複数のナレッジベースを同時に検索できます。
+
+**対話戦略：** Agentモデル、通常モードに必要なモデル、検索閾値の設定をサポート、オンラインPrompt設定をサポート、マルチターン対話の動作と検索リコールの実行方法を精密に制御します。対話入力ボックスはAgentモード/通常モードの切り替えをサポート、Web検索の有効化/無効化をサポート、対話モデルの選択をサポートします。

 ### 文書ナレッジグラフ

@@ -294,6 +322,33 @@ WeKnoraは文書をナレッジグラフに変換し、文書内の異なる段

 ## 🧭 開発ガイド

+### ⚡ 高速開発モード（推奨）
+
+コードを頻繁に変更する必要がある場合、**Dockerイメージを毎回再構築する必要はありません**！高速開発モードを使用してください：
+
+```bash
+# 方法1：Makeコマンドを使用（推奨）
+make dev-start      # インフラストラクチャを起動
+make dev-app        # バックエンドを起動（新しいターミナル）
+make dev-frontend   # フロントエンドを起動（新しいターミナル）
+
+# 方法2：ワンクリック起動
+./scripts/quick-dev.sh
+
+# 方法3：スクリプトを使用
+./scripts/dev.sh start     # インフラストラクチャを起動
+./scripts/dev.sh app       # バックエンドを起動（新しいターミナル）
+./scripts/dev.sh frontend  # フロントエンドを起動（新しいターミナル）
+```
+
+**開発の利点：**
+- ✅ フロントエンドの変更は自動ホットリロード（再起動不要）
+- ✅ バックエンドの変更は高速再起動（5-10秒、Airホットリロードをサポート）
+- ✅ Dockerイメージを再構築する必要がない
+- ✅ IDEブレークポイントデバッグをサポート
+
+**詳細ドキュメント：** [開発環境クイックスタート](./docs/开发指南.md)
+
 ### 📁 プロジェクトディレクトリ構造

 ```
--- a/2
+++ b/2
@@ -1 +1 @@
-0.1.4
+0.2.0
--- a/docs/images/architecture.png
+++ b/docs/images/architecture.png
@@ -1 +1 @@
 .1.4
 .2.0