AIVectorMemory

AIコーディングアシスタントに記憶を — セッション間永続記憶MCPサーバー

---

まだ CLAUDE.md / MEMORY.md を記憶として使っていますか？ この Markdown ファイル記憶方式には致命的な欠陥があります：ファイルは膨らみ続け、毎回のセッションで全量注入して大量のトークンを消費；内容はキーワード検索しかできず、「データベースタイムアウト」で検索しても「MySQL コネクションプールの落とし穴」は見つからない；複数プロジェクトで1つのファイルを共有すると相互汚染；タスク追跡がなく、開発進捗は頭の中だけ；200行での切り捨て、手動メンテナンス、重複排除や統合ができないという日常的な問題も。

AIVectorMemory はまったく異なるアプローチです。 ローカルベクトルデータベースに保存し、セマンティック検索で的確に呼び出し（言葉が違っても一致）、オンデマンド検索で関連する記憶だけを読み込み（トークン消費を50%+削減）、マルチプロジェクトを自動隔離して干渉ゼロ、内蔵の問題追跡 + タスク管理で AI が開発フロー全体を自動管理。すべてのデータはあなたのマシンに永久保存 — クラウド依存ゼロ、セッションや IDE を切り替えても失われません。

✨ 主な機能

機能	説明
🧠 クロスセッション記憶	踏んだ地雷、下した決定、決めた規約、セッションが変わっても忘れない、AIがついに記憶喪失を克服
🔍 ハイブリッドスマート検索	FTS5全文 + ベクトルセマンティック二重検索、RRF融合ランキング + 複合スコアリング（新しさ×頻度×重要度）、純ベクトル検索より数倍正確
🐛 問題追跡	内蔵Issue Tracker — 発見→調査→修正→アーカイブの完全クローズドループ。AIがバグのライフサイクルを自動管理
📋 タスク管理	Spec → タスク分割 → サブタスクのネスト → ステータス同期 → 連動アーカイブ。AIが完全な開発フローを駆動
🚦 セッション状態	ブロッキング管理 + ブレークポイント再開 + 進捗追跡、セッション切り替え / コンテキスト圧縮後もシームレスに接続
🪝 Hooks + Steering	ワークフロールールの自動注入 + 行動ガードフック、一貫したAI動作を保証 — 毎回の指示繰り返し不要
🧬 メモリ進化	矛盾検出で古い知識を自動置換 + 短期→長期の自動昇格 + 90日未使用で自動アーカイブ、自己進化する記憶
📊 デスクトップアプリ + Webダッシュボード	ネイティブデスクトップアプリ（macOS/Windows/Linux）+ Webダッシュボード、3Dベクトルネットワークで知識の繋がりが一目瞭然
💰 50%+トークン節約	セマンティック検索でオンデマンド呼び出し、毎回プロジェクト背景をコピペする必要なし
🏠 完全ローカル	クラウド依存ゼロ。ONNXローカル推論、APIキー不要、データはマシンから出ない
🔌 11 IDE完全対応	Cursor / Kiro / Claude Code / Windsurf / VSCode / Copilot / OpenCode / Trae / Codex / Antigravity / OpenClaw — ワンクリックインストール＆アンインストール
📁 マルチプロジェクト分離	1つのDBで全プロジェクト管理、自動分離で干渉なし、プロジェクト切り替えもシームレス
🔄 スマート重複排除	類似度 > 0.95 で自動マージ更新、記憶ストアは常にクリーン — 使い続けても散らからない
🌐 7言語対応	简体中文 / 繁體中文 / English / Español / Deutsch / Français / 日本語、ダッシュボード + Steeringルールのフルスタック国際化

QQ群：1085682431 | 微信：changhuibiz
共同参与项目开发加QQ群或微信交流

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────┐
│                   AI IDE                         │
│  OpenCode / Codex / Claude Code / Cursor / ...  │
└──────────────────────┬──────────────────────────┘
                       │ MCP Protocol (stdio)
┌──────────────────────▼──────────────────────────┐
│              AIVectorMemory Server               │
│                                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│  │ remember │ │  recall   │ │   auto_save      │ │
│  │ forget   │ │  task     │ │   status/track   │ │
│  └────┬─────┘ └────┬─────┘ └───────┬──────────┘ │
│       │            │               │             │
│  ┌────▼────────────▼───────────────▼──────────┐  │
│  │         Embedding Engine (ONNX)            │  │
│  │      intfloat/multilingual-e5-small        │  │
│  └────────────────────┬───────────────────────┘  │
│                       │                          │
│  ┌────────────────────▼───────────────────────┐  │
│  │     SQLite + sqlite-vec（ベクトルインデックス）│  │
│  │     ~/.aivectormemory/memory.db            │  │
│  └────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

🚀 クイックスタート

方法1：pip インストール（推奨）

# インストール
pip install aivectormemory

# 最新版にアップグレード
pip install --upgrade aivectormemory

# プロジェクトディレクトリに移動し、ワンクリックで IDE を設定
cd /path/to/your/project
run install

run install は対話式で IDE を選択し、MCP 設定・Steering ルール・Hooks を自動生成します。手動設定は不要です。

macOS ユーザーへの注意：
externally-managed-environment エラーが出た場合は --break-system-packages を追加してください
enable_load_extension エラーが出た場合、現在の Python が SQLite 拡張読み込みに対応していません（macOS 標準 Python および python.org 公式インストーラは非対応）。Homebrew Python をご利用ください：
brew install python
/opt/homebrew/bin/python3 -m pip install aivectormemory

方法2：uvx 実行（インストール不要）

pip install 不要、直接実行できます：

cd /path/to/your/project
uvx aivectormemory install

事前に uv のインストールが必要です。uvx が自動的にダウンロード・実行するため、手動でのパッケージインストールは不要です。

方法3：手動設定

{
  "mcpServers": {
    "aivectormemory": {
      "command": "run",
      "args": ["--project-dir", "/path/to/your/project"]
    }
  }
}

📍 各IDE設定ファイルの場所

IDE	設定ファイルパス
Kiro	`.kiro/settings/mcp.json`
Cursor	`.cursor/mcp.json`
Claude Code	`.mcp.json`
Windsurf	`.windsurf/mcp.json`
VSCode	`.vscode/mcp.json`
Trae	`.trae/mcp.json`
OpenCode	`opencode.json`
Codex	`.codex/config.toml`

Codex では JSON ではなく、プロジェクト単位の TOML 設定を使用します:

[mcp_servers.aivectormemory]
command = "run"
args = ["--project-dir", "/path/to/your/project"]

Codex がプロジェクト単位の .codex/config.toml を読み込むのは、リポジトリを trusted project としてマークした後です。

🛠️ 9つのMCPツール

`remember` — 記憶を保存

content (string, 必須)   記憶内容、Markdown形式
tags    (string[], 必須)  タグ、例 ["つまずき", "python"]
scope   (string)          "project"（デフォルト）/ "user"（プロジェクト横断）

類似度 > 0.95 で既存の記憶を自動更新、重複保存なし。

`recall` — セマンティック検索

query   (string)     セマンティック検索キーワード
tags    (string[])   タグ精密フィルター
scope   (string)     "project" / "user" / "all"
top_k   (integer)    返却数、デフォルト 5

ベクトル類似度マッチング — 異なる言葉でも関連する記憶を発見。

`forget` — 記憶を削除

memory_id  (string)     単一ID
memory_ids (string[])   一括ID

`status` — セッション状態

state (object, 任意)   省略=読み取り、指定=更新
  is_blocked, block_reason, current_task,
  next_step, progress[], recent_changes[], pending[]

セッション間で作業進捗を維持、新セッションで自動的にコンテキストを復元。

`track` — 問題追跡

action   (string)   "create" / "update" / "archive" / "list"
title    (string)   問題タイトル
issue_id (integer)  問題ID
status   (string)   "pending" / "in_progress" / "completed"
content  (string)   調査内容

`task` — タスク管理

action     (string, 必須)  "batch_create" / "update" / "list" / "delete" / "archive"
feature_id (string)        関連機能識別子（list 時必須）
tasks      (array)         タスクリスト（batch_create、サブタスク対応）
task_id    (integer)       タスクID（update）
status     (string)        "pending" / "in_progress" / "completed" / "skipped"

feature_id で spec ドキュメントと連携。update で tasks.md チェックボックスと関連イシューステータスを自動同期。

`readme` — README生成

action   (string)    "generate"（デフォルト）/ "diff"（差分比較）
lang     (string)    言語：en / zh-TW / ja / de / fr / es
sections (string[])  指定セクション：header / tools / deps

TOOL_DEFINITIONS / pyproject.toml から README コンテンツを自動生成、多言語対応。

`auto_save` — プリファレンス自動保存

preferences  (string[])  ユーザーが表明した技術的プリファレンス（固定 scope=user、プロジェクト横断）
extra_tags   (string[])  追加タグ

各会話の終了時にユーザープリファレンスを自動抽出・保存、スマート重複排除。

`graph` — コード知識グラフ

action       (string, 必須)  "query" / "trace" / "batch" / "add_node" / "add_edge" / "remove" / "refresh"
name         (string)        エンティティ名（add_node/query）
entity_type  (string)        エンティティ型：function/class/module/api/table/config（add_node/query）
file_path    (string)        ファイルパス、自動で相対パスに変換（add_node/query/refresh）
source       (string)        起点ノード名またはID（add_edge）
target       (string)        終点ノード名またはID（add_edge）
relation     (string)        関係タイプ：calls/imports/inherits/uses/depends_on/contains（add_edge/trace）
start        (string)        開始ノード名またはID（trace）
direction    (string)        走査方向："up" / "down" / "both"（trace）
max_depth    (integer)       最大走査深度、デフォルト3（trace）

関数呼び出しチェーン、データフロー、依存関係などの構造化コード知識を管理。コード変更前に上下流の影響範囲をtraceで確認。

📊 Webダッシュボード

run web --port 9080
run web --port 9080 --quiet          # リクエストログを非表示
run web --port 9080 --quiet --daemon  # バックグラウンド実行（macOS/Linux）

ブラウザで http://localhost:9080 にアクセス。デフォルトユーザー名 admin、パスワード admin123（初回ログイン後に設定で変更可能）。

マルチプロジェクト切り替え、記憶の閲覧/検索/編集/削除/エクスポート/インポート
セマンティック検索（ベクトル類似度マッチング）
プロジェクトデータのワンクリック削除
セッション状態、問題追跡
タグ管理（名前変更、統合、一括削除）
Token認証保護
3Dベクトル記憶ネットワーク可視化
🌐 多言語対応（简体中文 / 繁體中文 / English / Español / Deutsch / Français / 日本語）

ログイン画面

プロジェクト選択

統計概要 & ベクトルネットワーク可視化

WeChatグループに参加 | QQグループに参加

⚡ Steeringルールとの組み合わせ

AIVectorMemoryはストレージ層です。Steeringルールを使ってAIにいつ、どのようにツールを呼び出すかを指示します。

run install を実行すると、Steeringルールとフック設定が自動生成されます。手動設定は不要です。

IDE	Steeringの場所	Hooks
Kiro	`.kiro/steering/aivectormemory.md`	`.kiro/hooks/*.hook`
Cursor	`.cursor/rules/aivectormemory.md`	`.cursor/hooks.json`
Claude Code	`CLAUDE.md`（追記）	`.claude/settings.json`
Windsurf	`.windsurf/rules/aivectormemory.md`	`.windsurf/hooks.json`
VSCode	`.github/copilot-instructions.md`（追記）	`.claude/settings.json`
Trae	`.trae/rules/aivectormemory.md`	—
OpenCode	`AGENTS.md`（追記）	`.opencode/plugins/*.js`
Codex	`AGENTS.md`（追記）	—

📋 Steeringルール例（自動生成）

# AIVectorMemory - ワークフロールール

## 1. 新セッション起動（順番に実行必須）

1. `recall`（tags: ["プロジェクト知識"], scope: "project", top_k: 100）プロジェクト知識を読み込み
2. `recall`（tags: ["preference"], scope: "user", top_k: 20）ユーザー設定を読み込み
3. `status`（stateなし）セッション状態を読み取り
4. ブロック中 → 報告して待機；ブロックなし → 処理フローへ

## 2. メッセージ処理フロー

- ステップA：`status` で状態読み取り、ブロック中なら待機
- ステップB：メッセージ種別判定（雑談/修正/設定/コード問題）
- ステップC：`track create` で問題記録
- ステップD：調査（`recall` でつまずき検索 + コード確認 + 根本原因特定）
- ステップE：ユーザーに方針説明、ブロック設定して確認待ち
- ステップF：コード修正（修正前に `recall` でつまずき確認）
- ステップG：テスト実行で検証
- ステップH：ブロック設定してユーザー検証待ち
- ステップI：ユーザー確認 → `track archive` + ブロック解除

## 3. ブロッキングルール

方針提案時・修正完了検証待ち時は必ず `status({ is_blocked: true })`。
ユーザーの明確な確認後のみブロック解除可能。自己解除禁止。

## 4-9. 問題追跡 / コードチェック / Specタスク管理 / 記憶品質 / ツール一覧 / 開発規範

（完全なルールは `run install` で自動生成）

🔗 フック設定例（Kiro専用、自動生成）

セッション終了時の自動保存は削除済み、開発ワークフローチェック（.kiro/hooks/dev-workflow-check.kiro.hook）：

{
  "enabled": true,
  "name": "開発ワークフローチェック",
  "version": "1",
  "when": { "type": "promptSubmit" },
  "then": {
    "type": "askAgent",
    "prompt": "核心原則：行動前に検証、盲目的なテスト禁止、テスト合格後のみ完了とマーク"
  }
}

🇨🇳 中国本土のユーザー

初回実行時にEmbeddingモデル（約200MB）が自動ダウンロードされます。遅い場合：

export HF_ENDPOINT=https://hf-mirror.com

またはMCP設定にenvを追加：

{
  "env": { "HF_ENDPOINT": "https://hf-mirror.com" }
}

📦 技術スタック

コンポーネント	技術
ランタイム	Python >= 3.10
ベクトルDB	SQLite + sqlite-vec
Embedding	ONNX Runtime + intfloat/multilingual-e5-small
トークナイザー	HuggingFace Tokenizers
プロトコル	Model Context Protocol (MCP)
Web	ネイティブHTTPServer + Vanilla JS

📋 更新履歴

v2.4.5

パッチ：Opus 4.7 デフォルト傾向への強制制約

🚫 §1 に 確認的反問禁止 追加：命令文に対し「段階的 or 一括推進 / 全量 or 部分 / X やる？ / A 先 or B 先」の再確認を禁止、曖昧な場合は最大範囲で実行
🚫 §1 に 防御的報告禁止 追加：「指示により保留」「pending マーク」「非クリティカルパス」「不要なサブテスト」「後続イテレーション」等の未実行項目への言い訳表現を禁止
📋 §1 に 報告形式 追加：Phase A/B/C/D リスト + 「最終状態」 + 「未完了（指示により保留）」の三段式を禁止、ユーザー指示「全量完了」時は「未完了/保留」セクション列挙禁止
🎯 根因：Opus 4.7 モデルが 4.6 に比べて持つデフォルトの「防御的報告」「確認的反問」「構造化リスト」傾向への対抗
🔄 7 言語ルールファイル（STEERING_CONTENT + DEV_WORKFLOW_PROMPT）を CLAUDE.md v2.4.5 更新と完全同期

v2.4.4

パッチ：メッセージ処理フロー完全 A-I 整合

🧩 CLAUDE.md §4 メッセージ処理 B 部分のルート展開：4 つのすべての分岐（雑談/訂正/好み/その他）を I(ユーザー確認・アーカイブ) 終点に統一、「F で止まる」不完全フローを解消
⚙️ inject-workflow-rules.sh メッセージタイプ判断セクションを §4 B に完全整合：4 ルートの粒度一致
🔧 3 つの競合を修正：ルート粒度不一致（2 対 4）/ B と E の責務混在（「方針+ブロック」の誤配置）/ G/H/I フロー欠落
📝 違反条項の文言統一：「判断結果を出力せずに C/D/E/F ステップに進む = 違反」
🔄 7 言語ルールファイル（STEERING_CONTENT + DEV_WORKFLOW_PROMPT）を CLAUDE.md v2.4.4 更新と完全同期

v2.4.3

パッチ：ルール実行強化 & グラフ可視化

🧠 §4.B：2ステップ必須構造（メッセージ理解 → タイプ判定）、スキップは違反
📋 §8：各 Spec ステップにレビュー + ブロックを埋め込み、スキップは違反
🧬 DEV_WORKFLOW_PROMPT：調査・コード修正フェーズに graph trace/batch/add_node ルールを追加
📊 グラフダッシュボード：動的フォースレイアウトスケーリング、エッジラベルをデフォルト非表示（ホバーで表示）、ノードラベル衝突検出
🔧 DEV_WORKFLOW_PROMPT から冗長な「頻出違反リマインダー」セクションを削除
📝 7言語で §1 アイデンティティ & トーンを統一（翻訳なし）

v2.4.1

パッチ：i18n ルール同期

🔄 7言語のルールファイル（STEERING_CONTENT + DEV_WORKFLOW_PROMPT）を CLAUDE.md v2.4.0 の更新に同期
🧬 すべての steering ルールに graph ツール参照を追加（trace/batch/add_node/add_edge/remove）
✏️ すべての言語で権限ロールを「リードアーキテクト」から「プロジェクト責任者」に更新
📝 すべての言語に新しい違反ルール3件 + 禁止事項2件を追加

v2.4.0

新機能：コード知識グラフ

🧬 graph ツール — 関数呼び出しチェーン、データフロー、依存関係などの構造化コード知識グラフを管理
🔍 trace アクション — 任意のエンティティから上下流の呼び出しチェーンを追跡、コード変更前に影響範囲を評価
📊 Webダッシュボードグラフ可視化ページ — 知識グラフのノード、エッジ、呼び出し関係を閲覧
🗃️ DBマイグレーション v15 — グラフストレージ用に graph_nodes と graph_edges テーブルを追加
🌐 全7言語のREADMEを同期更新

v2.3.1

強化：ルール体系の全面改訂 + OpenClaw サポート

🧠 AIルールの記憶システム呼び出し5箇所の漏れを修正：調査前の recall 落とし穴（ステップD）、危険操作前の recall（§7）、Spec 執筆前の recall（§8）、サブタスク実行前の recall（§8）、修正後の remember 落とし穴（ステップI）
🦞 OpenClaw IDE サポート追加 — 11 IDE 対応（MCP設定は ~/.openclaw/openclaw.json にマージ、ルールは AGENTS.md に追記）
🎭 Playwright 自己テストルール強化 — ToolSearch deferred tools ロード要件追加、open コマンド代替を禁止
🔧 v2.2.0–v2.2.6 機能統合：Hooks システム（bash_guard + stop_guard + check_track）、スコアリングエンジン改善、recall 最適化、Web ダッシュボード一括削除、デスクトップ版記憶削除 Modal
⚠️ DEV_WORKFLOW_PROMPT：違反リマインダー2件追加（コード変更前の落とし穴確認、修正後の落とし穴保存）
🌐 7言語ルールファイル全同期

v2.1.1

改善：AI ルールシステムのアップグレード

📋 CLAUDE.md 補完：アイデンティティとトーン（§1）、核心原則 7 条（§3）、メッセージタイプ判断例、IDE 安全とセルフテストの詳細展開を追加
⚠️ Hook によくある違反リマインダーを追加：❌ 負の例でセルフテスト、recall、track create、IDE 安全の 4 つの最頻出違反を強化
🌐 7 言語ルールファイルを全量同期更新（zh-CN/zh-TW/en/ja/es/de/fr）
🔢 CLAUDE.md セクションを §1–§11 に再番号付け、相互参照を同期更新

v2.1.0

新機能：スマートメモリエンジン + アンインストール

🧠 FTS5 全文検索、中国語トークナイズ（jieba）対応 — CJK コンテンツのキーワード検索が正確に動作
🔀 ハイブリッド検索：ベクトル + FTS5 デュアルパス、RRF（逆順位融合）でマージ
📊 複合スコアリング：類似度×0.5 + 時間減衰×0.3 + アクセス頻度×0.2、重要度で重み付け
⚡ 矛盾検出：類似メモリ（0.85–0.95）を自動的に置換済みとしてマーク、古い情報は自動的にフェードアウト
📦 メモリ階層：頻繁にアクセスされるメモリは long_term に自動昇格、優先検索
🗑️ 自動アーカイブ：期限切れの短期メモリ（90日間未アクセス + 低重要度）を自動クリーンアップ
🔗 関係拡張：タグ重複 ≥ 2 で関連リンクを自動構築、1ホップ拡張で関連メモリを発見
📝 自動要約：長いメモリ（>500文字）に要約を生成、brief モードで要約を返しトークン節約
🧹 コードクリーンアップ：15件のデッドコード削除、7件の重複パターンを共通ユーティリティにリファクタリング
❌ run uninstall — すべての IDE 設定（MCP、ステアリング、フック、権限）をクリーンに削除、メモリデータは保持

v2.0.9

強化：セキュリティ + ルール最適化

🔒 SQL インジェクション、コマンドインジェクション、ディレクトリトラバーサルの脆弱性を修正
🛡️ データ整合性のためのトランザクション保護を追加（アーカイブ、挿入、更新操作）
🧠 すべての検索パスで類似度計算式を統一
📏 AI ワークフロールールを 38% 圧縮（219→136 行）、プロセス削除なし
🧹 v12 マイグレーションで過去のゴミメモリを自動クリーンアップ
🌐 7 言語同期更新

v2.0.8

新機能：Playwright ブラウザテスト内蔵

🎭 run install で Playwright ブラウザテストを自動設定 — AI が実際のブラウザを開いてフロントエンドの変更を検証可能に
🎭 専用テストブラウザ（Chrome for Testing）を使用、個人のブラウザタブに影響なし
🔑 権限設定を簡素化 — よく使うツールの権限確認ポップアップを削減
📏 7 言語の AI ルールを更新、ブラウザテスト動作を強制規範化

v2.0.7

強化：より多くの IDE サポート

🖥️ Antigravity と GitHub Copilot IDE のサポートを追加
🔑 run install でツール権限を自動設定、手動設定を削減
📏 AI セルフテストルールを簡素化

v2.0.6

強化：より高速な起動

⚡ セッション開始時のメモリ読み込みを最適化 — より高速に起動、コンテキスト使用量を削減
🔑 インストール時に Claude Code の権限を自動設定
🌐 7 言語同期

v2.0.5

強化：ルール簡素化

📏 AI ワークフロールールを再構築、明確さを向上し token 使用量を削減
💾 AI がセッション終了時に自動的にユーザーの好みを保存
🌐 7 言語同期

v2.0.4

修正：ツールの信頼性

🔧 全 MCP ツールパラメータを包括的に監査・修正 — 全 IDE での信頼性を向上

v2.0.3

強化：より正確な検索と安全保護

🔍 メモリ検索がセマンティックとキーワードマッチングを組み合わせ、より正確な呼び出しを実現
🛡️ クロスプロジェクト操作保護を追加 — AI が他のプロジェクトのファイルを誤って変更することを防止

v2.0.2

強化：ルール汎用化 & デスクトップ版バージョン表示修正

📏 「ユーザーに質問する前に recall」ルールを追加 — AI はプロジェクト情報（サーバーアドレス、パスワード、デプロイ設定など）についてユーザーに質問する前にメモリシステムを照会する必要あり
📏 操作前チェックルールを汎用化 — 具体例を削除し、すべての操作シナリオに適用
🖥️ デスクトップアプリ設定ページでバージョンが "1.0.0" にハードコードされていた問題を修正、実際のバージョンを動的に取得
🌐 7言語の i18n ステアリングルールとワークフロープロンプトを同期更新

v2.0.1

修正：Hook のクロスプロジェクト互換性

🔧 check_track.sh がスクリプト自身の位置からプロジェクトパスを導出するように変更、Claude Code がルート以外のディレクトリから hook を実行した際の track 検出失敗を修正
🔧 compact-recovery.sh がハードコードされた絶対パスの代わりに相対パス導出を使用するように変更
🔧 compact-recovery から冗長な CLAUDE.md の再注入を削除（Claude Code が自動的にロード済み）
🔧 install.py テンプレートをすべての hook 修正と同期
🌐 7言語の i18n compact-recovery ヒントテキストを更新

v2.0

パフォーマンス：ONNX INT8 量子化

⚡ Embeddingモデルを初回ロード時にFP32からINT8へ自動量子化、モデルファイルが448MBから113MBに縮小
⚡ MCP Serverのメモリ使用量が約1.6GBから約768MBに削減（50%以上の削減）
⚡ 量子化はユーザーに透過的 — 初回使用時に自動実行、以降はキャッシュを使用、失敗時はFP32にフォールバック

新機能：パスワードを記憶

🔐 デスクトップ版とWebダッシュボードのログインページに「パスワードを記憶」チェックボックスを追加
🔐 チェック時は認証情報をlocalStorageに保存し次回ログイン時に自動入力、チェック解除時は保存済み認証情報を削除
🔐 登録モードではチェックボックスを非表示

強化：Steeringルール

📝 IDENTITY & TONEセクションにより具体的な制約を追加（お世辞禁止、ユーザーメッセージの翻訳禁止など）
📝 セルフテスト要件をバックエンド専用、MCP Server、フロントエンド可視変更の3種類に細分化（フロントエンド変更はPlaywright必須）
📝 開発ルールに「開発完了後は必ずセルフテスト」を追加
📝 全7言語バージョンを同期更新

v1.0.11

🐛 デスクトップ版のバージョン比較をセマンティックバージョニングに変更、ローカルバージョンが高い場合の誤ったアップグレード通知を修正
🐛 ヘルスチェックページのフィールド名をバックエンドと統一、一貫性ステータスが常に Mismatch と表示される問題を修正
🔧 check_track.sh hook に Python フォールバックを追加、システム sqlite3 がない場合の hook サイレント失敗を解決（#4）

v1.0.10

🖥️ デスクトップ版ワンクリックインストール + アップグレード検出機能
🖥️ 起動時に Python と aivectormemory のインストール状態を自動検出
🖥️ 未インストール時はワンクリックインストールボタンを表示、インストール済みの場合は PyPI とデスクトップの新バージョンを検出
🐛 インストール検出を importlib.metadata.version() に変更し、正確なパッケージバージョンを取得

v1.0.3

recall 検索最適化

🔍 recall に tags_mode パラメータ追加：any（OR マッチ）/ all（AND マッチ）
🔍 query + tags 時はデフォルトで OR マッチ（いずれかのタグ一致で候補入り）、複数タグ検索の漏れを解決
🔍 tags のみの場合は AND マッチ維持（正確なカテゴリ閲覧）、後方互換
📝 Steering ルールに検索ガイドラインを追加

v0.2.8

Web ダッシュボード

📋 アーカイブ問題詳細モーダル：アーカイブカードをクリックすると読み取り専用の詳細を表示（全構造化フィールド：調査過程/根本原因/解決策/テスト結果/変更ファイル）、下部の赤い削除ボタンでアーカイブ記録を完全削除

Steering ルール強化

📝 track create で content フィールドが必須に（問題の現象と背景を簡潔に記述）、タイトルのみの登録を禁止
📝 調査後の track update で investigation（調査過程）と root_cause（根本原因）の記入を必須化
📝 修正後の track update で solution（解決策）、files_changed（変更ファイル）、test_result（テスト結果）の記入を必須化
📝 第4節に「フィールド記入規範」サブセクションを追加、各段階の必須フィールドを明確化
📝 第5節を「コード修正チェック」から「操作前チェック」に拡張、ダッシュボード起動/PyPI公開/サービス再起動前のrecall踩坑記録ルールを追加
📝 install.py STEERING_CONTENT を全変更と同期

ツール最適化

🔧 track ツールの content フィールド説明を「調査内容」から「問題説明（create時必須、問題の現象と背景を簡潔に記述）」に変更

v0.2.7

自動キーワード抽出

🔑 remember/auto_save がコンテンツからキーワードを自動抽出してタグに追加 — AIが完全なタグを手動で渡す必要がなくなりました
🔑 jieba中国語分詞 + 英語正規表現抽出を採用、中英混合コンテンツでも高品質なキーワードを正確に抽出
🔑 新しい依存関係 jieba>=0.42

v0.2.6

Steeringルール再構築

📝 Steeringルールドキュメントを旧3セクション構造から9セクション構造に書き換え（セッション開始/メッセージ処理/ブロッキングルール/問題追跡/コードレビュー/Specタスク管理/メモリ品質/ツールリファレンス/開発規範）
📝 install.py STEERING_CONTENTテンプレート同期更新、新プロジェクトはインストール時に更新されたルールを取得
📝 タグを固定リストから動的抽出に変更（コンテンツからキーワードを抽出）、メモリ検索精度を向上

バグ修正

🐛 readmeツール handle_readme() に **_ が不足、MCP呼び出しエラー unexpected keyword argument 'engine' を修正
🐛 Webダッシュボードメモリ検索ページネーション修正（検索クエリ時にページネーション前に全量フィルタリング、不完全な検索結果を修正）

ドキュメント更新

📖 READMEツール数 7→8、アーキテクチャ図 digest→task、task/readmeツール説明追加
📖 auto_saveパラメータを旧 decisions[]/modifications[]/pitfalls[]/todos[] から preferences[]/extra_tags[] に更新
📖 Steeringルール例を3セクション形式から9セクション構造サマリーに更新
📖 6言語バージョンに同期更新

v0.2.5

タスク駆動開発モード

🔗 イシュー追跡（track）とタスク管理（task）を feature_id で完全なワークフローに統合：問題発見 → タスク作成 → タスク実行 → ステータス自動同期 → 連動アーカイブ
🔄 task update でタスクステータス更新時に関連イシューのステータスを自動同期（全完了→completed、進行中あり→in_progress）
📦 track archive でイシューアーカイブ時に関連タスクを自動アーカイブ（最後のアクティブイシューアーカイブ時に連動）
📦 task ツールに archive アクション追加、機能グループの全タスクを tasks_archive テーブルに移動
📊 イシューカードに関連タスク進捗を表示（例：5/10）、タスクページでアーカイブフィルタリング対応

新規ツール

🆕 task ツール — タスク管理（batch_create/update/list/delete/archive）、ツリー構造サブタスク対応、feature_id で spec ドキュメントと連携
🆕 readme ツール — TOOL_DEFINITIONS/pyproject.toml から README コンテンツを自動生成、多言語・差分比較対応

ツール強化

🔧 track に delete アクション追加、9 つの構造化フィールド（description/investigation/root_cause/solution/test_result/notes/files_changed/feature_id/parent_id）、list で issue_id 単一検索
🔧 recall に source パラメータフィルタリング（manual/auto_save）と brief 簡潔モード（content+tags のみ返却、コンテキスト節約）を追加
🔧 auto_save がメモリに source="auto_save" を付与、手動メモリと自動保存を区別

ナレッジベーステーブル分割リファクタリング

🗃️ project_memories + user_memories を独立テーブル化、scope/filter_dir 混合クエリを解消、クエリ性能向上
📊 DB Schema v4→v6：issues に 9 つの構造化フィールド追加 + tasks/tasks_archive テーブル + memories.source フィールド