# TelosDB Community 版 v0.3.3.1 — 商品紹介

## そのまま使える、ローカル完結の意味検索

**TelosDB Community 版**は、追加のモデルや設定なしで、すぐに意味検索を始められるデスクトップアプリです。データはすべてお使いの PC 内に留まり、クラウドへ一切送信しません。

---

## こんな方におすすめ

- まずは手軽に意味検索を試したい
- モデルのダウンロードや GPU 環境を用意したくない
- 個人のメモやドキュメントを「意味で」探したい
- Cursor や Claude Desktop など AI ツールと MCP で連携したい

---

## Community 版の特長

### モデル不要で動く

LSA（潜在意味解析）により、**50 次元のベクトル**で文書を表現します。大きな AI モデルは不要。インストール後、そのまま検索できます。

### キーワードも自然な文も、そのまま検索

「春の歌」でも「桜の季節に聴きたい曲」のような文でも検索可能。結果は**文書単位**でまとめて返すため、どのドキュメントがヒットしたかが分かりやすくなっています。検索結果 0 件や空クエリでもエラーにならず、統一された形式で返します。

### MCP で AI とつながる

Model Context Protocol（MCP）に対応。Cursor や Claude Desktop から「検索」「一覧取得」「カテゴリ一覧」「RE-INDEX」などのツールとして TelosDB を呼び出せます。AI エージェントの「記憶」として利用するのに最適です。

### 文書一覧のページング

文書一覧は **1 ページ 20 件**で区切り、前へ・次へでページ移動できます。大量登録時も UI が重くなりにくい設計です。

### 自動でインデックスを整える

ドキュメントの増減に応じて、バックグラウンドで LSA を再学習。画面上では「LSA学習中…」「ベクトル同期中…」の表示で進行状況を確認できます。必要に応じて RE-INDEX で手動再構築も可能です。

### ログイン時に自動起動（オプション）

設定で「OSにログインしたときに自動で起動する」をオンにすると、Windows にサインインしたタイミングで TelosDB が起動し、トレイで待機。いつでも MCP 経由で検索できます。

### フォルダ監視で自動取り込み

指定したフォルダを常時監視し、ファイルの追加・更新・削除を自動検知してインデックスに反映します。テキストやマークダウンを保存するだけで、検索対象に自動登録。フォルダごとにカテゴリ名を付けられ、MCP の `list_categories` で取得して検索時の絞り込みに利用できます。

---

## v0.3.3.1 の主な変更点

### 新機能

- **フォルダ監視時のカテゴリ名称割り当て（Issue #10）**: モニター先フォルダごとにカテゴリ名を設定可能。UI の設定パネルで任意のタイミングで変更でき、MCP の `list_categories` で一覧取得・`search_text` の `category` パラメータで絞り込み検索が可能。
- **list_categories**: MCP で登録済みカテゴリ名の一覧を取得。`search_text` の `category` パラメータと組み合わせて絞り込み検索が可能。
- **文書一覧のページング（UI）**: 文書管理パネルで「前へ」「次へ」によるページ切り替え。1 ページあたり 20 件表示。

### 改善

- **list_documents のページング**: MCP の `list_documents` が `limit`・`page` に対応。戻り値に `items`・`total_count`・`total_pages`・`page` を含み、全件取得による負荷を回避。
- **検索エラー時の対応（Issue #11）**: 空クエリやマッチ 0 件のときもエラーにせず、`items: []` と `vector_search_used` を含む統一 JSON 形式で返す。クライアントは常に配列として扱える。

### 修正

- **初回インストール時の起動失敗（Issue #12）**: インストール履歴のないマシンで初めてインストールした際、インストールは成功するが起動しない不具合を修正。新規 DB で `documents` テーブル作成前にマイグレーションが実行されていた問題を解消し、起動時に app_data ディレクトリを確実に作成するように変更。

---

## 含まれる機能（v0.3.3.1）

- 意味検索（LSA 50 次元）＋ 全文検索（FTS5）のハイブリッド検索
- 検索結果の文書単位表示（`group_by_document`）。0 件・空クエリ時も統一形式で応答
- **フォルダ監視**: 指定フォルダの自動取り込み・カテゴリ指定・拡張子フィルタ
- MCP ツール: `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）
- ドキュメント件数の表示（ヘッダー「X docs」・`get_document_count`）
- **文書一覧 UI のページング**（前へ・次へ、20 件/ページ）
- インデックス状態の表示（LSA学習中・ベクトル同期中）
- ログイン時の自動起動（オプション）
- トレイ常駐・バージョン表示

---

## ご利用方法

**インストーラ**: `TelosDB-Community_0.3.3.1_x64-setup.exe` を実行してインストールしてください。

**ソースからビルドする場合**:

```bash
npm install
npm run build:community
```

- 出力: `target/release/bundle/nsis/TelosDB-Community_0.3.3.1_x64-setup.exe`
- 初回起動時に vec0.dll がアプリデータフォルダへコピーされます。不具合時は `%APPDATA%\com.telosdb.app\logs\telos.log` をご確認ください。

---

より高精度な意味検索をご希望の方は **Pro 版**をご検討ください。
→ [TelosDB Pro 版 商品紹介](RELEASE_v0.3.3.1_Pro.md)