sting8k/pi-vcc

何を解決するか

pi-vccは、Pi AIコーディングエージェントのためのアルゴリズムによる会話コンパクターです。これは、コンテキストウィンドウのオーバーフローや、標準的なLLMベースの要約中に発生する情報の損失（履歴が破棄されたり、ハルシネーションが発生したりすることがよくあります）という問題を解決します。コンパクション（圧縮）プロセス自体にLLM呼び出しに依存することなく、トークン使用量を35-99%削減します。

仕組み

会話を書き換えるためにLLMを使用する代わりに、pi-vccは純粋にアルゴリズム的なアプローチを使用して、簡潔なトランスクリプトを抽出してフォーマットします。トークン見積もりを調整し、ノイズをフィルタリングし、正規表現とパターンマッチングを使用して主要なセマンティックセクション（セッションの目標、変更されたファイル、git commitsなど）を抽出するパイプラインを通じて会話を処理します。

対象ユーザー

重要な技術的詳細を失うことなく、検索可能で決定論的、かつコスト効率の高い方法で長い会話履歴を管理したいPi AIコーディングエージェントのユーザー。

ハイライト

• Zero LLM Cost: コンパクションをアルゴリズム的に実行するため、要約呼び出しに関連するAPIコストとレイテンシを排除します。
• Lossless Recall: 生のセッションJSONLファイルを直接読み取ることで標準的なコンパクションをバイパスし、正規表現やキーワード検索を通じて履歴全体を検索可能な状態に保ちます。
• Semantic Structuring: 圧縮された履歴を、Session Goal、Files & Changes、Commits、Outstanding Context、User Preferencesの5つの特定のセクションに整理します。
• Deterministic Output: 同じ入力に対して常に同じ出力を生成することを保証し、履歴圧縮中のLLMのハルシネーションのリスクを排除します。
• Customizable Compaction: /pi-vccによる手動トリガーと、最近のやり取りをいくつ保持するかを最適化する「smart keep」ロジックをサポートしています。