local-rag-wiki

AIエージェント向けのリポジトリローカルRAG wiki: リポジトリごとのMCPナレッジサービス（Markdown wikiノートの管理された検索/読み取り/書き込み）と、それをエージェントツールに組み込むインストーラーを提供します。サービスを実行するにはDockerが必要です。

クイックスタート（推奨）

初回のエージェントセッション前にサービスイメージを事前プルして、コールドスタートの遅延を回避してください:

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

インストール

リポジトリのルートで実行してください:

npx github:ihorleleka/Local-Rag-Wiki install .

これにより、管理された .agents/ ランナー、AGENTS.md ポリシーセクション、DeepSeek Harness（.dsh/mcp.servers.yml）、Claude Code、Codex、VS Code、OpenCode 用のMCP設定、および wiki/ フォルダがスキャフォールドされます。これらの統合は追加的なものです: DSHサポートをインストールしても、他のハーネス設定は削除または置換されません。MCPサービスは、エージェントクライアントが接続するとリポジトリごとに自動的に起動します。新しい環境でエージェントを実行する前に、（上記の）イメージの事前プルを推奨します。

DeepSeek Harness

使用するプロファイル（通常は web）にネイティブDSHバンドルを一度インストールしてください:

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

そのDSHプロファイルを再起動し、インストール済みのリポジトリをワークスペースとして開いて、セッションを開始してください。agent/created では、バンドルはエージェントの実際のワークスペース（カスタムの --agents-dir を含む）を使用して、DSH公式の @deepseek-ai/dsh-mcp-client をマウントし、管理されたMCPランナーを起動して再接続し、そのツールを検出して、予測可能な mcp__wiki-manager__* ツールを登録します。名前空間は安定していますが、クライアントはエージェントスコープのままです。ランナーは、他のハーネスとまったく同様に、そのリポジトリのDockerサービスを起動またはアタッチします。

また、そのワークスペース用にマーカーゲート式のCordisリコールコーディネーターをマウントします: agent/session-start は繰り返し発生するトピックのヒントをシードし、agent/pre-step はローカル状態を使用してから、重要なプロンプトに対してのみ制限付きのwiki取得を実行します—最初に wiki_search depth="abstract"（L0）、次に一致する depth="packet" コンテキスト（L1）です。証拠にラベルを付け、完全なL2 wiki_read の判断はモデルに委ねます。session/event はアシスタントの要約を記録し、agent/turn-stopping と session/flush は状態をトリミングして永続化します。リコールはワークスペースごとにキャッシュされ、実行中の重複は排除されます。L1パケットはレート制限され、コールドスタートには90秒の制限付き許容時間があり、状態更新はアトミック置換でキューイングされます。wiki-kitインストールマーカーのあるリポジトリの外部では、状態やwikiプロセスは使用されません。

生成された .dsh/mcp.servers.yml はワークスペース設定の代替手段として残ります。両方のブリッジを実行すると同じリポジトリサービスへのMCP接続が2つ作成されるため、プロファイルバンドルを優先してください。AGENTS.md はポータブルなポリシーレイヤーとして残ります。

.agents/hooks/ と .claude/settings.local.json のフックはClaude Code固有です。DSHライフサイクルインターセプトは、プロジェクトローカルのフックマニフェストではなく、信頼されたHost/Profile Cordisプラグインに属します。ワークスペース設定の境界については .dsh/README.md を参照してください。

アップデート

インストール後、リポジトリ内から管理ファイルを更新してください—npxは不要です:

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

ライフサイクル

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start .、stop .、pull . も同様に利用できます。リポジトリコンテナは個々のエージェントクライアントとは独立して永続化されます。

仕組み

• このパッケージはインストーラーです: コンシューマーリポジトリ内に .agents/ ランナーとMCP設定をスキャフォールドして維持します。

• kb-service/ は、ランナーがリポジトリごとに起動するDocker化されたMCPナレッジサービスです。POST /mcp/（デフォルトではループバック）経由で wiki_search、wiki_read、wiki_list、wiki_tree、wiki_schema_report、wiki_write、wiki_capture、wiki_delete、wiki_rename を提供し、書き込みはハッシュで保護されています。wiki_search は階層化された取得（depth=abstract|packet）と path_prefix によるディレクトリスコープをサポートしています。

バージョニング

インストーラーとkb-serviceは同じGitタグ（X.Y.Z または vX.Y.Z）を使用します。リリース自動化:

• tag-version-verify.yml

• docker-release.yml

ライセンス

MIT（kb-service/LICENSE を参照）。