# システム概要 (System Overview)

## 1. 開発背景と目的

**TelosDB** は、プライバシーを重視したローカル専用の「意味検索（Vector Search）基盤」を提供するために開発されました。

現代の AI 活用において、外部クラウド（OpenAI 等）へのデータ送信はセキュリティ上の大きな懸念事項です。本システムは、数学的な文書解析（Latent Semantic Analysis）とベクトルエンジンをすべてユーザーのローカル環境（Windows Desktop）で動作させることにより、以下の価値を提供します。

- **絶対的なプライバシー**: 文章データやベクトルデータがネットワークを介して外部に送信されることはありません。
- **オフライン動作**: 重い推論モデルやインターネット接続環境に左右されず、常に高速な検索が可能です。
- **省リソース・ゼロコスト**: 推論はローカル CPU のみで行われるため、ハイスペックな GPU や API トークン費用は一切不要です。

## 2. 主要機能詳説

| 機能 | 解説 | 技術的実装 |
| :--- | :--- | :--- |
| **ローカル・セマンティック検索** | キーワードの一致だけでなく、LSA を用いた数学的な文脈解析に基づいた検索を実現。 | `sqlite-vec` + `LSA` (SVD) |
| **MCP (Model Context Protocol)** | AI エージェント（Cursor, Claude Desktop, IDE 等）が本ツールを「外部知識」として呼び出すための標準規格。 | SSE Transport (Port 3001) |
| **低レイテンシ・省リソース** | モデル推論の代わりに LSA を採用。超軽量かつ高速なインデックス更新・検索を実現。 | `ndarray` + `SVD` |
| **セルフヒーリング (Self-healing)** | DB 内のテキストとベクトルの不一致を検出し、バックグラウンドで自動同期。 | `db::sync_vectors` |
| **常駐・軽量 UI** | システムトレイに常駐し、SSE を使った非同期通信でバックグラウンドログをリアルタイム表示。 | Tauri 2 + Vanilla JS + Axum |

## 3. システム特性 (Technical Highlights)

- **Hermetic Design**: 必要な DLL 群をパッケージ内に封入し、ユーザー環境のインストール状況に依存せず「置いてすぐ動く」ことを重視しています。
- **LSA (Latent Semantic Analysis)**: 伝統的かつ強力な LSA 技術を採用。モデルファイルを必要とせず、数千ドキュメント以下であれば LLM を上回る応答速度と、プライバシーの完全な確保（ローカル推論も不要）を実現します。

## 4. 動作環境

- **OS**: Windows 10/11 (64-bit)
- **CPU**: 一般的な PC で動作可能
- **GPU**: 不要（CPU のみで高速動作）
- **モデル**: Latent Semantic Analysis (Dimensions configurable)
