GitBucket
システム概要 (System Overview)
1. 目的と位置づけ
TelosDB は、プライバシーを重視したローカル専用の意味検索（セマンティック検索）基盤です。データは一切クラウドに送らず、Windows 上で完結します。
- プライバシー: 文書・ベクトルはローカルのみ。外部 API 不要。
- 2 エディション: Community 版（LSA・モデル不要）と Pro 版（日本語埋め込みモデル・高精度検索）を同一リポジトリからビルドで切り替え。
- MCP 対応: Model Context Protocol に準拠し、Cursor や Claude Desktop 等から「ツール」として利用可能。
2. エディション
| 項目 | Community 版 | Pro 版 |
|---|---|---|
| ベクトル化 | LSA（50 次元、SVD）。モデルファイル不要。 | 埋め込みモデル（768 次元、ONNX）。sentence-BERT 系日本語モデル。 |
| 検索 | キーワード＋意味検索。短い語句・自然文どちらも可。 | 同上。言い回しの違いに強い。 |
| 起動 | npm run dev / インストーラ TelosDB-Community_* |
npm run dev:pro / インストーラ TelosDB-Pro_*（要 embedding_model/） |
| 依存 | 軽量（LSA のみ）。GPU 不要。 | ONNX 実行系（tract または ort）。GPU 不要。 |
3. 主要機能
- セマンティック検索: クエリをベクトル化し、類似度でランキング。結果は文書単位で結合して返すオプションあり。
- MCP サーバー: ポート 3001 で SSE。
search_text・add_item_text・update_item・delete_item・get_item_by_id・list_documents・list_categories・get_document_count・get_document・delete_document・lsa_retrain（RE-INDEX）等。 - セルフヒーリング: テキストと FTS/ベクトルの不整合を検出し、起動時・手動 heal で同期。
- 常駐 UI: システムトレイ常駐。検索・文書管理・設定。エディション表示（Community / Pro）。
4. 動作環境
- OS: Windows 10/11 (64-bit)
- CPU: 一般的な PC。GPU 不要。
- Pro 版:
embedding_model/にmodel_quantized.onnxとvocab.txtを配置（sentence-BERT 系）。
5. 関連仕様
- アーキテクチャ・プロセス構成: 02_architecture_design.md
- データベース・検索アルゴリズム: 03_database_specification.md
- MCP・API 詳細: 04_mcp_api_specification.md
- ビルド・開発: 05_development_guide.md
- Pro 埋め込みの技術詳細: 07_embedding_tract.md