opensource/WeKnora
3
0
Fork 0
mirror of https://github.com/Tencent/WeKnora.git synced 2026-09-21 05:43:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
ec2b44494fbf67d40a4e24b6aff55be851eb7db3
WeKnora/README_JA.md
T

416 lines
34 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<p align="center">
<picture>
<img src="./docs/images/logo.png" alt="WeKnora Logo" height="120"/>
</picture>
</p>
<p align="center">
<picture>
<a href="https://trendshift.io/repositories/15289" target="_blank">
<img src="https://trendshift.io/api/badge/repositories/15289" alt="Tencent%2FWeKnora | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>
</picture>
</p>
<p align="center">
<a href="https://weknora.weixin.qq.com" target="_blank">
<img alt="公式サイト" src="https://img.shields.io/badge/公式サイト-WeKnora-4e6b99">
</a>
<a href="https://chatbot.weixin.qq.com" target="_blank">
<img alt="WeChat対話オープンプラットフォーム" src="https://img.shields.io/badge/WeChat対話オープンプラットフォーム-5ac725">
</a>
<a href="https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd" target="_blank">
<img alt="Chrome 拡張機能" src="https://img.shields.io/badge/Chrome 拡張機能-WeKnora-4285F4">
</a>
<a href="https://clawhub.ai/lyingbug/weknora" target="_blank">
<img alt="ClawHub Skill" src="https://img.shields.io/badge/ClawHub Skill-WeKnora-ff6b35">
</a>
<a href="https://github.com/Tencent/WeKnora/blob/main/LICENSE">
<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.5.1-2e6cc4?labelColor=d4eaf7">
</a>
</p>
<p align="center">
| <a href="./README.md"><b>English</b></a> | <a href="./README_CN.md"><b>简体中文</b></a> | <b>日本語</b> | <a href="./README_KO.md"><b>한국어</b></a> |
</p>
<p align="center">
<h4 align="center">
[プロジェクト紹介](#-プロジェクト紹介) • [アーキテクチャ設計](#️-アーキテクチャ設計) • [コア機能](#-コア機能) • [クイックスタート](#-クイックスタート) • [ドキュメント](#-ドキュメント) • [開発ガイド](#-開発ガイド)
</h4>
</p>
# 💡 WeKnora — ドキュメントを「生きたナレッジ」へ：RAG・Agent 推論・自動 Wiki を統合した LLM ナレッジフレームワーク
## 📌 プロジェクト紹介
[**WeKnora（ウィーノラ）**](https://weknora.weixin.qq.com) は、大規模言語モデル（LLM）をベースとしたオープンソースのナレッジフレームワークで、エンタープライズ級の文書理解、セマンティック検索、自律推論シナリオ向けに設計されています。
本フレームワークは **3 つのコア能力** を中心に構築されています：日常的な検索に最適な **RAG ベースのクイック Q&A**、ナレッジ検索・MCP ツール・Web 検索を自律的にオーケストレーションし複雑なマルチステップタスクを処理する **ReAct Agent 推論**、そして Agent が生のドキュメントから相互リンクされた Markdown ナレッジベースとインタラクティブなナレッジグラフを自律生成・維持する全く新しい **Wiki モード**。さらに、多様なデータソース連携（Feishu / Notion / Yuque、随時拡充中）、20 以上の LLM プロバイダー統合、Langfuse による全体可観測性、完全セルフホスト可能なモジュラーアーキテクチャと組み合わせることで、WeKnora は散在する文書を「検索可能・推論可能・継続的に進化する」専用ナレッジ資産へと昇華させます。
Feishu、Notion、Yuqueなどの外部プラットフォームからのナレッジ自動同期（他のデータソースも順次対応中）に対応し、PDF、Word、画像、Excelなど10以上の文書フォーマットをサポート。WeChat Work、Feishu、Slack、TelegramなどのIMチャネルから直接Q&Aサービスを提供できます。モデル層ではOpenAI、DeepSeek、Qwen（Alibaba Cloud）、Zhipu、Hunyuan、Gemini、MiniMax、NVIDIA、Ollamaなど主要プロバイダーに対応。全プロセスをモジュラー設計し、大規模モデル、ベクトルデータベース、ストレージなどのコンポーネントを柔軟に差し替え可能。ローカルおよびプライベートクラウドデプロイに対応し、データは完全に自己管理可能です。さらにWeKnoraは **Langfuse** とシームレスに統合され、Agentの推論、トークン消費、パイプラインに対する包括的な可観測性（オブザーバビリティ）を提供します。
## ✨ 最新アップデート
**v0.5.1 バージョンのハイライト:**
- **Wiki モード**：Agent 主導の Wiki ナレッジシステム。生のドキュメントから相互リンクされた Markdown ページを自動的に整理・生成し、専用の Wiki ブラウザとページ間の参照・関連を可視化するインタラクティブなナレッジグラフを備え、構造化され継続的に進化するチーム専用ナレッジベースを構築できます。
- **可観測性**：Langfuse を統合し、Agent の ReAct ループ、LLM トークントラッキング、ツール呼び出し、asynq パイプラインを詳細に追跡。Agent の推論とシステムパフォーマンスを包括的に把握できます。
- **カスタマイズ可能なインデックス戦略**：ナレッジベースごとに、ベクトル検索、キーワード検索（ハイブリッド）、Wiki、およびナレッジグラフのインデックス付けを個別に有効化／無効化できます。
- **ベクトルデータベース UI と KB バインド**：接続テストを含む Vector Store 管理用フロントエンド UI を追加し、特定のナレッジベースに専用のベクトルデータベースをバインドできます。
- **Yuque コネクタ**：API クライアントを通じた Yuque データソース統合。フルおよび増分同期をサポートし、Yuque ドキュメントのシームレスな取り込みを実現。
- **WeChat ミニプログラム**：軽量なモバイル向けクライアント（`miniprogram/`）を新たに同梱。WeChat 上から API 設定、ナレッジベース選択、URL 取り込み、ナレッジチャットが可能。
- **ナレッジベース・リストビューと一括操作**：カードビューと並ぶリストビューを追加し、複数選択・フローティング一括アクションバー・一括削除に対応。大規模 KB の整理を効率化。
- **会話と IM のワークフロー強化**：ユーザーメニュー配下にテナント全体の IM チャネル概観、会話一覧へのキーワード検索とユーザー単位の会話ピン留め、IM チャネル発の会話には明確な出所表示を追加。
- **バグ修正**：ストリーミング応答中に LaTeX 数式が一瞬表示されて消える問題 (#1056)、DOCX パースのデフォルト 100 ページ制限、IM パイプラインレベルのタイムアウトによる多段 Agent 推論の中断、Agent 単位の IM セッション分離、Wiki インジェストの不正 JSON によるサイレントなデータ欠損、暗号化フィールド復号失敗時のサイレントエラーなどを修正。
<details>
<summary><b>過去のリリース</b></summary>
**v0.4.0 バージョンのハイライト:**
- **[知識アシスタント](https://weknora.weixin.qq.com/platform)**：クラウドホスティング型知識アシスタントサービス、ローカルデプロイ不要で即座に利用可能
- **WeKnora Cloud**：WeKnora Cloud プロバイダー統合、LLM モデルとドキュメント解析サービス、クレデンシャル管理とステータスチェック
- **[Chrome 拡張機能](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)**：ブラウザ拡張機能でWebページからのナレッジ取り込み
- **[ClawHub Skill](https://clawhub.ai/lyingbug/weknora)**：ClawHub Skill マーケットプレイス統合でワンクリックスキルインストール
- **WeChat IM 統合**：WeChat チャネルアダプター。QR コードログインとロングポーリングメッセージをサポート
- **添付ファイル処理**：チャットパイプラインでのファイル添付サポート、コンテンツフォーマットと画像/添付ファイルメタデータの注入
- **Azure OpenAI プロバイダー**：Azure OpenAI の Chat、VLM、Embedding モデルを完全サポート。デプロイメント名の保持と dimensions パラメータの設定に対応
- **Alibaba Cloud OSS ストレージ**：S3互換モードによる阿里雲 OSS オブジェクトストレージをサポート。設定 UI、接続テスト、多言語 i18n を提供
- **Notion コネクタ**：Notion データソース統合。API クライアント、Markdown レンダラー、Connector インターフェースの実装
- **Baidu & Ollama Web 検索**：Baidu と Ollama を Web 検索プロバイダーとして追加
- **VectorStore 管理**：完全な VectorStore CRUD 機能。エンティティ、リポジトリ、サービスレイヤー、接続テスト、API エンドポイント
- **重要なバグ修正**：Azure OpenAI エンドポイント処理、Embedding 切り詰め、IM 引用タグのストリップ、neo4j Go 1.24 Windows 互換性、OSS 署名問題を修正
**v0.3.6 バージョンのハイライト:**
- **ASR（自動音声認識）**：ASRモデルを統合し、音声ファイルのアップロード、ドキュメント内音声プレビュー、音声文字起こし機能をサポート
- **データソース自動同期（Feishu）**：完全なデータソース管理機能、Feishu Wiki/ドライブの自動同期（増分/全量）、同期ログ、テナント分離
- **OIDC認証**：OpenID Connectログインをサポート、自動ディスカバリ、カスタムエンドポイント設定、ユーザー情報マッピング
- **IM引用返信コンテキスト**：IMチャネルで引用メッセージを抽出してLLMプロンプトに注入し、文脈に基づく回答を実現。非テキスト引用の幻覚防止処理
- **IMスレッドベースセッション**：IMチャネル（Slack、Mattermost、Feishu、Telegram）でスレッド単位のセッションモードをサポート、スレッド内でのマルチユーザーコラボレーション
- **ドキュメント自動要約**：AI生成のドキュメント要約、入力サイズの設定が可能、ドキュメント詳細画面に専用の要約セクション
- **Tavily Web検索**：Tavilyを新しいWeb検索プロバイダーとして追加、Web検索プロバイダーアーキテクチャを拡張性向上のためリファクタリング
- **MCP自動再接続**：サーバー接続断絶時のMCPツール呼び出しの自動再接続ロジック
- **並列ツール呼び出し**：Agentモードでerrgroupを使用して複数のツール呼び出しを並行実行、複雑なタスク処理を高速化
- **Agent @メンション範囲制限**：ユーザーの@メンションをAgentが許可されたナレッジベースの範囲内に制限、不正アクセスを防止
- **ログインページパフォーマンス**：backdrop-filter blurをすべて削除、アニメーション要素を削減、GPUコンポジティングヒントを追加
**v0.3.5 バージョンのハイライト:**
- **Telegram、DingTalk & Mattermost IM統合**：Telegramボット（webhook/ロングポーリング、editMessageTextストリーミング）、DingTalkボット（webhook/Streamモード、AIカードストリーミング）、Mattermost アダプターを新規追加。IMチャネルはWeChat Work、Feishu、Slack、Telegram、DingTalk、Mattermost の6プラットフォームをカバー
- **IMスラッシュコマンドとQAキュー**：プラグイン式スラッシュコマンドフレームワーク（/help、/info、/search、/stop、/clear）、有界QAワーカープール、ユーザー単位レート制限、RedisベースのマルチインスタンスDistributed Coordination
- **推奨質問**：Agentが関連ナレッジベースに基づいてコンテキスト対応の推奨質問を自動生成し、チャットインターフェースに表示。画像ナレッジは質問生成タスクを自動キュー登録
- **VLMによるMCPツール画像自動説明**：MCPツールが画像を返した場合、設定されたVLMモデルを使用してテキスト説明を自動生成し、テキストのみのLLMでも画像内容を利用可能に
- **Novita AIプロバイダー**：OpenAI互換APIでchat、embedding、VLLMモデルタイプをサポートする新しいLLMプロバイダー
- **MCPツール名の安定性**：ツール名をUUIDではなくservice.Nameから生成（再接続後も安定）。衝突防止制約を追加。フロントエンドでsnake_caseを人間が読みやすい形式に整形
- **チャネルトラッキング**：ナレッジエントリとメッセージにchannelフィールド追加（web/api/im/browser_extension）
- **重要バグ修正**：ナレッジベース未設定時のAgent空レスポンス、中国語/絵文字ドキュメントのUTF-8切り詰め、テナント設定更新時のAPIキー暗号化消失、vLLMストリーミング推論コンテンツ欠落、Rerankの空パッセージエラーを修正
**v0.3.4 バージョンのハイライト:**
- **IMボット統合**：企業WeChat、Feishu、SlackのIMチャネルをサポート、WebSocket/Webhookモード、ストリーミング対応、ナレッジベース統合
- **マルチモーダル画像サポート**：画像アップロードとマルチモーダル画像処理、セッション管理の強化
- **手動ナレッジダウンロード**：手動ナレッジコンテンツのファイルダウンロード、ファイル名サニタイズ対応
- **NVIDIA モデルAPI**：NVIDIAチャットモデルAPIをサポート、カスタムエンドポイントとVLMモデル設定
- **Weaviateベクトルデータベース**：ナレッジ検索用にWeaviateベクトルデータベースバックエンドを追加
- **AWS S3ストレージ**：AWS S3ストレージアダプターを統合、設定UIとデータベースマイグレーション
- **AES-256-GCM暗号化**：APIキーをAES-256-GCMで静的暗号化、セキュリティ強化
- **組み込みMCPサービス**：組み込みMCPサービスサポートでAgent機能を拡張
- **ハイブリッド検索最適化**：ターゲットのグループ化とクエリ埋め込みの再利用で検索性能を向上
- **Final Answerツール**：新しいfinal_answerツールとAgentの所要時間追跡でワークフローを改善
**v0.3.3 バージョンのハイライト:**
- **親子チャンキング**：階層型の親子チャンキング戦略により、コンテキスト管理と検索精度を強化
- **ナレッジベースのピン留め**：よく使うナレッジベースをピン留めして素早くアクセス
- **フォールバックレスポンス**：関連する結果がない場合のフォールバックレスポンス処理とUIインジケーター
- **Rerankパッセージクリーニング**：Rerankモデルのパッセージクリーニング機能で関連性スコアの精度を向上
- **バケット自動作成**：ストレージエンジン接続チェックの強化、バケットの自動作成をサポート
- **Milvusベクトルデータベース**：ナレッジ検索用にMilvusベクトルデータベースバックエンドを追加
**v0.3.2 バージョンのハイライト:**
- 🔍 **ナレッジ検索**：新しい「ナレッジ検索」エントリポイント、セマンティック検索をサポートし、検索結果を直接会話ウィンドウに持ち込み可能
- ⚙️ **パーサーとストレージエンジンの設定**：設定画面でソースごとのドキュメントパーサーとストレージエンジンを設定可能、ナレッジベースでファイルタイプ別のパーサー選択をサポート
- 🖼️ **ローカルストレージ画像レンダリング**：ローカルストレージモードで会話中の画像レンダリングをサポート、ストリーミング中の画像プレースホルダーを最適化
- 📄 **ドキュメントプレビュー**：ユーザーがアップロードした元のファイルをプレビューする組み込みドキュメントプレビューコンポーネント
- 🎨 **UI最適化**：ナレッジベース、エージェント、共有スペースリストページのインタラクションを再設計
- 🗄️ **Milvusサポート**：ナレッジ検索用にMilvusベクトルデータベースバックエンドを追加
- 🌋 **Volcengine TOS**：Volcengine TOSオブジェクトストレージサポートを追加
- 📊 **Mermaidレンダリング**：チャットでMermaidダイアグラムのレンダリングをサポート、フルスクリーンビューアー、ズーム、パン、ツールバー、エクスポート機能付き
- 💬 **バッチ会話管理**：バッチ管理と全セッション一括削除機能
- 🔗 **リモートURLナレッジ**：リモートファイルURLからナレッジエントリの作成をサポート
- 🧠 **メモリグラフプレビュー**：ユーザーレベルのメモリグラフ可視化プレビュー
- 🔄 **非同期再解析**：既存のナレッジドキュメントの非同期再処理API
**v0.3.0 バージョンのハイライト:**
- 🏢 **共有スペース**：共有スペース管理、メンバー招待、メンバー間でのナレッジベースとAgentの共有、テナント分離検索
- 🧩 **Agentスキル**：Agentスキルシステム、スマート推論向けプリロードスキル、サンドボックスベースのセキュリティ分離実行環境
- 🤖 **カスタムAgent**：カスタムAgentの作成・設定・選択をサポート、ナレッジベース選択モード（全部/指定/無効）
- 📊 **データアナリストAgent**：組み込みデータアナリストAgent、CSV/Excel分析用DataSchemaツール
- 🧠 **思考モード**：LLMとAgentの思考モードをサポート、思考コンテンツのインテリジェントフィルタリング
- 🔍 **検索エンジン拡張**：DuckDuckGoに加えてBingとGoogleの検索プロバイダーを追加
- 📋 **FAQ強化**：バッチインポートドライラン、類似質問、検索結果のマッチ質問フィールド、大量インポートのオブジェクトストレージオフロード
- 🔑 **API Key認証**：API Key認証メカニズム、Swaggerドキュメントセキュリティ設定
- 📎 **入力内選択**：入力ボックスでナレッジベースとファイルを直接選択、@メンション表示
- ☸️ **Helm Chart**：Kubernetesデプロイメント用の完全なHelm Chart、Neo4j GraphRAGサポート
- 🌍 **国際化**：韓国語（한국어）サポートを追加
- 🔒 **セキュリティ強化**：SSRF安全HTTPクライアント、強化されたSQLバリデーション、MCP stdio転送セキュリティ、サンドボックスベース実行
- ⚡ **インフラストラクチャ**：Qdrantベクトルデータベースサポート、Redis ACL、設定可能なログレベル、Ollama埋め込み最適化、`DISABLE_REGISTRATION`制御
**v0.2.0 バージョンのハイライト：**
- 🤖 **Agentモード**：新規ReACT Agentモードを追加、組み込みツール、MCPツール、Web検索を呼び出し、複数回の反復とリフレクションを通じて包括的なサマリーレポートを提供
- 📚 **複数タイプのナレッジベース**：FAQとドキュメントの2種類のナレッジベースをサポート、フォルダーインポート、URLインポート、タグ管理、オンライン入力機能を新規追加
- ⚙️ **対話戦略**：Agentモデル、通常モードモデル、検索閾値、Promptの設定をサポート、マルチターン対話の動作を精密に制御
- 🌐 **Web検索**：拡張可能なWeb検索エンジンをサポート、DuckDuckGo検索エンジンを組み込み
- 🔌 **MCPツール統合**：MCPを通じてAgent機能を拡張、uvx、npx起動ツールを組み込み、複数の転送方式をサポート
- 🎨 **新UI**：対話インターフェースを最適化、Agentモード/通常モードの切り替え、ツール呼び出しプロセスの表示、ナレッジベース管理インターフェースの全面的なアップグレード
- ⚡ **インフラストラクチャのアップグレード**：MQ非同期タスク管理を導入、データベース自動マイグレーションをサポート、高速開発モードを提供
</details>
## 📱 機能デモ
<table>
<tr>
<td colspan="2" align="center"><b>💬 インテリジェント Q&A 対話</b><br/><img src="./docs/images/qa.png" alt="インテリジェント Q&A 対話" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>📖 Wiki ブラウザ</b><br/><img src="./docs/images/wiki-browser.png" alt="Wiki ブラウザ" width="100%"></td>
<td width="50%" align="center"><b>🕸️ Wiki ナレッジグラフ</b><br/><img src="./docs/images/wiki-graph.png" alt="Wiki ナレッジグラフ" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>🤖 Agent モード · ツール呼び出しプロセス</b><br/><img src="./docs/images/agent-qa.png" alt="Agent モードツール呼び出しプロセス" width="100%"></td>
<td width="50%" align="center"><b>⚙️ 対話設定</b><br/><img src="./docs/images/settings.png" alt="対話設定" width="100%"></td>
</tr>
<tr>
<td colspan="2" align="center"><b>🔭 可観測性 · Langfuse Tracing</b><br/><img src="./docs/images/langfuse.png" alt="Langfuse Tracing" width="100%"></td>
</tr>
</table>
## 🏗️ アーキテクチャ設計
![weknora-architecture.png](./docs/images/architecture.png)
文書解析・ベクトル化・検索から大規模モデル推論まで、全パイプラインをモジュラー分離。各コンポーネントは柔軟に差し替え・拡張可能。ローカル / プライベートクラウドデプロイに対応し、データ完全自己管理、ゼロバリアの Web UI で即座に利用開始。
## 🧩 機能概要
**インテリジェント対話**
| 機能 | 詳細 |
|------|------|
| インテリジェント推論 | ReACT プログレッシブ・マルチステップ推論、ナレッジ検索・MCP ツール・Web 検索を自律的にオーケストレーション、カスタムエージェント対応 |
| クイック Q&A | ナレッジベースベースの RAG Q&A、迅速かつ正確な回答 |
| Wiki モード | Agent主導で生のドキュメントから構造化された相互リンク済みMarkdown Wikiページを自動生成・保守 |
| ツール呼び出し | 組み込みツール、MCP ツール、Web 検索 |
| 対話戦略 | オンライン Prompt 編集、検索閾値チューニング、マルチターン文脈認識 |
| 推奨質問 | ナレッジベースの内容に基づく質問の自動生成 |
**ナレッジ管理**
| 機能 | 詳細 |
|------|------|
| ナレッジベースタイプ | FAQ / ドキュメント / Wiki、フォルダーインポート・URL インポート・タグ管理・オンライン入力 |
| データソースインポート | Feishu / Notion / Yuque ナレッジベースの自動同期（他のデータソースも開発中）、増分・全量同期対応 |
| 文書フォーマット | PDF / Word / Txt / Markdown / HTML / 画像 / CSV / Excel / PPT / JSON |
| 検索戦略 | BM25 疎検索 / Dense 密検索 / GraphRAG グラフ強化 / 親子チャンキング / 多次元インデックス |
| E2E テスト | 検索+生成の全パイプライン可視化、リコール的中率・BLEU / ROUGE 指標評価 |
**連携と拡張**
| 機能 | 詳細 |
|------|------|
| 大規模モデル | OpenAI / Azure OpenAI / DeepSeek / Qwen (Alibaba Cloud) / Zhipu / Hunyuan / Doubao (Volcengine) / Gemini / MiniMax / NVIDIA / Novita AI / SiliconFlow / OpenRouter / Ollama |
| Embedding | Ollama / BGE / GTE / OpenAI 互換 API |
| ベクトル DB | PostgreSQL (pgvector) / Elasticsearch / Milvus / Weaviate / Qdrant |
| オブジェクトストレージ | ローカル / MinIO / AWS S3 / 火山引擎 TOS / Alibaba Cloud OSS |
| IM 統合 | WeChat Work / Feishu / Slack / Telegram / DingTalk / Mattermost / WeChat |
| Web 検索 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama |
**プラットフォーム**
| 機能 | 詳細 |
|------|------|
| デプロイ | ローカル / Docker / Kubernetes (Helm)、プライベート化・オフラインデプロイ対応 |
| UI | Web UI / RESTful API / Chrome Extension |
| 可観測性 | ReActループ、トークン消費、ツール呼び出し、パイプライン追跡のためのLangfuse統合 |
| タスク管理 | MQ 非同期タスク、バージョンアップ時の DB 自動マイグレーション |
| モデル管理 | 集中設定、ナレッジベース単位のモデル選択、マルチテナント組み込みモデル共有、WeKnora Cloud ホスティングモデルとドキュメント解析 |
## 🧩 Chrome 拡張機能
[**WeKnora Chrome 拡張機能**](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)を使えば、ブラウザからWebコンテンツをWeKnoraナレッジベースに直接取り込めます。テキスト、画像、ページ全体を選択してワンクリックでナレッジエントリとして保存——コピペやファイルアップロード不要です。
## 🦞 ClawHub Skill
[**WeKnora ClawHub Skill**](https://clawhub.ai/lyingbug/weknora)はClawHubプラットフォームで公開されたWeKnoraスキルです。インストール後、WeKnora REST APIを通じてドキュメントのアップロード（ファイル / URL / Markdown）、ハイブリッド検索（ベクトル + キーワード）、ナレッジエントリの管理が可能になります。
- **ドキュメントインポート** — エージェント経由でファイルアップロード、Webページインポート、Markdownナレッジの作成
- **ハイブリッド検索** — 単一または複数のナレッジベースをベクトル + キーワードで横断検索
- **ナレッジ管理** — プログラムによるナレッジエントリの閲覧、編集、削除
## 🚀 クイックスタート
### 🛠 環境要件
- [Docker](https://www.docker.com/) & [Docker Compose](https://docs.docker.com/compose/)
- [Git](https://git-scm.com/)
### 📦 インストール・起動
```bash
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env # 必要に応じて .env を編集（詳細はファイル内のコメント参照）
docker compose up -d # コアサービスを起動
```
起動後、**http://localhost** にアクセスして利用開始。
> ローカル Ollama モデルを使用する場合は、先に `ollama serve > /dev/null 2>&1 &` を実行してください。
### 🔧 オプションサービス（Docker Compose Profile）
`--profile` フラグで追加コンポーネントを有効化。複数の profile を組み合わせ可能：
| Profile | 説明 | コマンド |
|---------|------|---------|
| _(デフォルト)_ | コアサービス | `docker compose up -d` |
| `full` | 全機能 | `docker compose --profile full up -d` |
| `neo4j` | ナレッジグラフ (Neo4j) | `docker compose --profile neo4j up -d` |
| `minio` | オブジェクトストレージ (MinIO) | `docker compose --profile minio up -d` |
| `langfuse` | トレーシング (Langfuse) | `docker compose --profile langfuse up -d` |
組み合わせ例：`docker compose --profile neo4j --profile minio up -d`
サービス停止：`docker compose down`
### 🌐 サービスアドレス
| サービス | URL |
|---------|-----|
| Web UI | `http://localhost` |
| バックエンド API | `http://localhost:8080` |
| Langfuse トレーシング | `http://localhost:3000` |
## 文書ナレッジグラフ
WeKnoraは文書をナレッジグラフに変換し、文書内の異なる段落間の関連関係を表示することをサポートします。ナレッジグラフ機能を有効にすると、システムは文書内部の意味関連ネットワークを分析・構築し、ユーザーが文書内容を理解するのを助けるだけでなく、インデックスと検索に構造化サポートを提供し、検索結果の関連性と幅を向上させます。
詳細な設定については、[ナレッジグラフ設定ガイド](./docs/KnowledgeGraph.md)をご参照ください。
## 対応するMCPサーバー
[MCP設定ガイド](./mcp-server/MCP_CONFIG.md) をご参照のうえ、必要な設定を行ってください。
## 🔌 WeChat対話オープンプラットフォームの使用
WeKnoraは[WeChat対話オープンプラットフォーム](https://chatbot.weixin.qq.com)のコア技術フレームワークとして、より簡単な使用方法を提供します：
- **ノーコードデプロイメント**：知識をアップロードするだけで、WeChatエコシステムで迅速にインテリジェントQ&Aサービスをデプロイし、「即座に質問して即座に回答」の体験を実現
- **効率的な問題管理**：高頻度の問題の独立した分類管理をサポートし、豊富なデータツールを提供して、正確で信頼性が高く、メンテナンスが容易な回答を保証
- **WeChatエコシステムカバレッジ**：WeChat対話オープンプラットフォームを通じて、WeKnoraのインテリジェントQ&A能力を公式アカウント、ミニプログラムなどのWeChatシナリオにシームレスに統合し、ユーザーインタラクション体験を向上
## 📘 ドキュメント
よくある問題の解決：[よくある問題](./docs/QA.md)
詳細なAPIドキュメントは：[APIドキュメント](./docs/api/README.md)を参照してください
製品計画と今後の機能：[Roadmap](./docs/ROADMAP.md)
## 🧭 開発ガイド
### ⚡ 高速開発モード（推奨）
コードを頻繁に変更する必要がある場合、**Dockerイメージを毎回再構築する必要はありません**！高速開発モードを使用してください：
```bash
# インフラストラクチャを起動
make dev-start
# バックエンドを起動（新しいターミナル）
make dev-app
# フロントエンドを起動（新しいターミナル）
make dev-frontend
```
**開発の利点：**
- ✅ フロントエンドの変更は自動ホットリロード（再起動不要）
- ✅ バックエンドの変更は高速再起動（5-10秒、Airホットリロードをサポート）
- ✅ Dockerイメージを再構築する必要がない
- ✅ IDEブレークポイントデバッグをサポート
**詳細ドキュメント：** [開発環境クイックスタート](./docs/开发指南.md)
### 📁 プロジェクトディレクトリ構造
```
WeKnora/
├── client/ # Goクライアント
├── cmd/ # アプリケーションエントリ
├── config/ # 設定ファイル
├── docker/ # Dockerイメージファイル
├── docreader/ # 文書解析プロジェクト
├── docs/ # プロジェクトドキュメント
├── frontend/ # フロントエンドプロジェクト
├── internal/ # コアビジネスロジック
├── mcp-server/ # MCPサーバー
├── migrations/ # データベースマイグレーションスクリプト
└── scripts/ # 起動およびツールスクリプト
```
## 🤝 貢献ガイド
[Issue](https://github.com/Tencent/WeKnora/issues) や Pull Request の提出を歓迎します。
**フロー：** Fork → ブランチ作成 → 変更をコミット → PR を作成
**規約：** `gofmt` でコードをフォーマット、[Conventional Commits](https://www.conventionalcommits.org/) に従う（`feat:` / `fix:` / `docs:` / `test:` / `refactor:`）
## 🔒 セキュリティ通知
**重要：** v0.1.3バージョンより、WeKnoraにはシステムセキュリティを強化するためのログイン認証機能が含まれています。v0.2.0では、さらに多くの機能強化と改善が追加されました。本番環境でのデプロイメントにおいて、以下を強く推奨します：
- WeKnoraサービスはパブリックインターネットではなく、内部/プライベートネットワーク環境にデプロイしてください
- 重要な情報漏洩を防ぐため、サービスを直接パブリックネットワークに公開することは避けてください
- デプロイメント環境に適切なファイアウォールルールとアクセス制御を設定してください
- セキュリティパッチと改善のため、定期的に最新バージョンに更新してください
## 👥 コントリビューター
素晴らしいコントリビューターに感謝します：
[![Contributors](https://contrib.rocks/image?repo=Tencent/WeKnora)](https://github.com/Tencent/WeKnora/graphs/contributors)
## 📄 ライセンス
このプロジェクトは[MIT](./LICENSE)ライセンスの下で公開されています。
このプロジェクトのコードを自由に使用、変更、配布できますが、元の著作権表示を保持する必要があります。
## 📈 プロジェクト統計
<a href="https://www.star-history.com/#Tencent/WeKnora&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Tencent/WeKnora&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Tencent/WeKnora&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Tencent/WeKnora&type=date&legend=top-left" />
</picture>
</a>
Reference in New Issue View Git Blame Copy Permalink