Skip to content

README_jp.md

Latest commit

 

History

History
410 lines (304 loc) · 17.8 KB

README_jp.md

File metadata and controls

410 lines (304 loc) · 17.8 KB
Raw

⚠️ このリポジトリはnekocode-rustに移動しました ⚠️

🚀 新しい16倍高速版はこちら 🚀

nekocode-rust: 9MBリポジトリ（ここは235MB）| 16倍高速 | Rust + Tree-sitter

🔴 重要: このリポジトリはアーカイブ済みです。すべての開発は**nekocode-rust**に移動しました

  • 96%小さいリポジトリ（9MB vs 235MB）
  • 16倍高速パフォーマンス（1.2秒 vs 19.5秒）
  • ビルド地獄なし（3秒 vs 5時間以上）
  • ビルド済みバイナリ付属ですぐ使える

🐱 NekoCode C++ - 超高速コード解析エンジン

⚠️ 非推奨 - 最新版はnekocode-rustを参照

🤖 Claude Codeユーザー: PROJECT_OVERVIEW.txt ← ここから開始！
📚 クイックガイド: CLAUDE_QUICKSTART.md ← 3ステップセットアップ
📖 完全ドキュメント: docs/claude-code/ ← Claude Code専用ドキュメント

注記: ビルドした実行ファイルはbin/配下に配置されます。./bin/nekocode_aiを使用するか、bin/をPATHに追加してください。

Build Status License: MIT C++17 Platform

English | 🇯🇵 日本語版

Pythonベースの代替ツールより10-100倍高速な革新的コード解析エンジン！

🤖 AI開発者向け（Claude Code） - セットアップ不要！

NekoCodeの魔法のような使い方：

あなた: 「github.com/moe-charm/nekocodeをローカルにクローンしたよ」
Claude: 「見つけました！ビルドして設定しますね...」
あなた: 「この散らかったプロジェクトを解析して」
Claude: 「🔥 なんと！これは今日リリースされたばかりですね！解析します...」
[0.726秒後]
Claude: 「JSONライブラリに複雑度4717を発見！リファクタリング計画をご提案します...」

たったこれだけ！ Claude Codeが自動的に：

  • ✅ ツールを自動検出
  • ✅ 最適にビルド
  • ✅ 解析セッション作成
  • ✅ 結果に興奮
  • ✅ 科学的な洞察を提供

手動セットアップ不要、設定ファイル不要、学習曲線なし！

🎯 注目の使用例: AI開発者が300以上のコンポーネントを持つ複雑なアーキテクチャを解析し、科学的精度でコード最適化を実現しています。

🐱 MCPサーバーインストール（新機能！） - ワンコマンドセットアップ！

もっと統合したい？ NekoCodeをMCPサーバーとしてインストールして、Claude Codeとシームレスに統合！

超簡単インストール

# 1. リポジトリをクローン
git clone https://github.com/moe-charm/nekocode.git
cd nekocode

# 2. ビルド（まだの場合）
mkdir build && cd build
cmake .. && make -j$(nproc)
cd ..

# 3. セットアップスクリプトを実行してコマンドを取得（nekocodeディレクトリ内で）
python3 bin/setup.py
# 絶対パスを含むコマンドが表示されます - コピーしてください！

# 4. 重要：あなたのプロジェクトディレクトリに移動
cd /path/to/your/project  # ← あなたのプロジェクト、nekocodeではない！
# 例: cd ~/my-awesome-project

# 5. ステップ3でコピーしたコマンドを貼り付け
# claude mcp add nekocode \
#   -e NEKOCODE_BINARY_PATH=/absolute/path/bin/nekocode_ai \
#   -- python3 /absolute/path/mcp-nekocode-server/mcp_server_real.py

# 6. Claude Codeを再起動 - 完了！ 🎉

⚠️ コマンドを実行する場所が重要です！

  • setup.pyはnekocodeディレクトリで実行（絶対パスを取得するため）
  • claude mcp addはあなたのプロジェクトディレクトリで実行（NekoCodeを使いたい場所）
  • MCPサーバーはそのプロジェクトディレクトリでのみ利用可能になります

Claude CodeでMCPサーバーを使用

# これらのMCPツールが直接使えるようになります！
await mcp__nekocode__analyze("/path/to/project", stats_only=True)
await mcp__nekocode__session_create("/path/to/project")  # 超高速セッション！
await mcp__nekocode__session_stats(session_id)          # 3ms応答！
await mcp__nekocode__include_cycles(session_id)         # C++依存関係解析
await mcp__nekocode__list_languages()                   # サポート言語確認

それだけ！ MCPサーバーが提供するもの：

  • ✅ ネイティブClaude Code統合
  • ✅ セッション管理（初回解析後は3ms操作）
  • ✅ 高度なC++依存関係解析ツール
  • ✅ すべてのNekoCode機能がMCPツールとして

📚 完全なMCPドキュメント: mcp-nekocode-server/README.md

🌟 主な機能

  • 🚀 超高速パフォーマンス: Python実装より10-100倍高速
  • ⚡ ストレージ最適化解析: --ssd（4-16倍高速）と--hdd（安全）モード（新機能！）
  • 📊 プログレス監視: 大型プロジェクト（30K+ファイル）リアルタイム進捗（新機能！）
  • 🌍 多言語サポート: JavaScript、TypeScript、C++、C、Python、C#（PEGTL駆動）
  • 🎮 インタラクティブモード: 即座に結果が出るセッション管理（180倍高速化）
  • 🔍 高度なC++解析: 複雑な依存関係の可視化、循環依存の検出
  • 🧬 テンプレート＆マクロ解析: C++テンプレート特殊化、可変長テンプレート、マクロ展開追跡
  • 🎯 ASCIIクオリティチェック: シンプルで実用的なコード品質チェック
  • 📊 包括的な統計: クラス、関数、複雑度解析
  • 🌳 Tree-sitter統合: 正規表現からAST解析への移行基盤

🚀 クイックスタート

前提条件

  • C++17対応コンパイラ（GCC 7+、Clang 5+、MSVC 2017+）
  • CMake 3.10+
  • Git

インストール

# リポジトリをクローン
git clone https://github.com/moe-charm/nekocode.git
cd nekocode

# ビルド
mkdir build && cd build
cmake ..
make -j$(nproc)

# （任意）PATHに追加（現在のシェルに一時反映）
cd ..
export PATH="$(pwd)/bin:$PATH"

# インストール確認（バイナリはbin/配下）
./bin/nekocode_ai --help

# ⚡ 新機能でクイックパフォーマンステスト
./bin/nekocode_ai analyze src/ --ssd --progress

パフォーマンス最適化使用法（新機能！）

# 🔥 最高速度（SSD/NVMe）
./bin/nekocode_ai analyze large-project/ --ssd --progress

# 🛡️ 安全モード（HDD/機械式ドライブ）
./bin/nekocode_ai analyze large-project/ --hdd --progress

# 📊 大型プロジェクトをリアルタイム監視
tail -f sessions/ai_session_*/progress.txt

📊 前例のないパフォーマンス - 実戦テスト済み結果

🏆 実プロジェクト解析（2025年7月）

プロジェクト 言語 ファイル/サイズ 検出関数数 複雑度 ステータス
TypeScript Compiler TypeScript 53,766行 2,362 19,425 🚀 革命的
lodash.js JavaScript 544KB 489 2,432 ⚡ 本格運用
nlohmann/json C++ 959KB 254（123クラス） 10,677 🎯 エンタープライズ
.NET Runtime C# エンタープライズ 38テスト関数 8 🏛️ 認定済み
Unity lanobeH2 Unity C# ゲームプロジェクト 25（Unity検出） 64 🎮 特化対応
requests Python ライブラリ 10関数 55 🐍 インテリジェント
NyaMesh-cpp C++ セルフテスト 2関数 329 🔍 自己認識

⚡ 革命的改善

以前のパフォーマンス: 関数検出制限、頻繁な失敗
現在の達成: エンタープライズ規模精度、590倍改善

具体的ブレークスルー:
- TypeScript: 4 → 2,362関数（590倍改善！）
- JavaScript: 基本 → 489関数（大量検出）
- C++: 920KB → 959KBエンタープライズファイル（無制限規模）
- Unity: 汎用 → 特化コンテンツ検出
- .NET: 不明 → 38関数エンタープライズ検証

🎉 AI開発者が歓喜していること

「な、なんだこれは！！TypeScriptで2,362関数検出って...これもう別次元の解析エンジンじゃないか！！」
— TypeScriptブレークスルーを目撃したClaude Code

「lodashで489関数...nlohmann/jsonで123クラス254関数...もはやPython版の概念を超越している！」
— エンタープライズ規模テスト中のAI開発者

「Unity content detectionまで完璧に動く...これでゲーム開発プロジェクトも科学的に解析できる！」
— 特化機能を発見したゲーム開発者

🌟 歴史的達成物語

  • TypeScript制覇: 53,766行コンパイラファイル → 2,362関数検出
  • エンタープライズ検証: .NET runtimeコア → 38テスト関数確認済み
  • ゲーム開発: Unityプロジェクト → コンテンツ検出完璧化
  • 自己認識: NyaMesh-cpp → 自己診断能力確認済み
  • 基盤の知恵: core.cpp → スマート正規表現例外実装
  • レガシー管理: 旧アナライザー → 安全な隔離アーキテクチャ
  • 勝利の展開を見る →

📦 ビルド手順

mkdir build
cd build
cmake ..
make -j
cd ..

# （任意）PATHに追加（現在のシェルに一時反映）
export PATH="$(pwd)/bin:$PATH"

🎯 使い方

基本的な解析

# 単一ファイルの解析
./bin/nekocode_ai src/main.cpp

# ディレクトリの解析
./bin/nekocode_ai src/

インタラクティブモード

# セッションを作成
./bin/nekocode_ai session-create /path/to/project
# 出力: session_id: ai_session_20250727_123456

# コマンドを実行
./bin/nekocode_ai session-command ai_session_20250727_123456 stats
./bin/nekocode_ai session-command ai_session_20250727_123456 complexity
./bin/nekocode_ai session-command ai_session_20250727_123456 "find manager"

# 新機能: テンプレート＆マクロ解析
./bin/nekocode_ai session-command ai_session_20250727_123456 template-analysis
./bin/nekocode_ai session-command ai_session_20250727_123456 macro-analysis

インクルード依存関係解析（C++専用）

# 依存関係グラフを表示
./bin/nekocode_ai session-command <session_id> include-graph

# 循環依存を検出
./bin/nekocode_ai session-command <session_id> include-cycles

# 不要なincludeを検出
./bin/nekocode_ai session-command <session_id> include-unused

# 最適化提案
./bin/nekocode_ai session-command <session_id> include-optimize

テンプレート＆マクロ解析（C++専用）

# テンプレート特殊化検出
./bin/nekocode_ai session-command <session_id> template-analysis

# マクロ展開追跡
./bin/nekocode_ai session-command <session_id> macro-analysis

# メタプログラミングパターン検出
./bin/nekocode_ai session-command <session_id> metaprogramming

# コンパイル時計算最適化提案
./bin/nekocode_ai session-command <session_id> compile-time-optimization

📋 利用可能なコマンド

コマンド 説明 出力例
stats プロジェクト統計の概要 ファイル数、行数、複雑度
complexity 複雑度ランキング ファイル別複雑度（高い順）
large-files 大きいファイル一覧 デフォルト500行以上
large-files --threshold 1000 カスタム閾値 1000行以上のファイル
duplicates 重複ファイル検出 _backup, _old等を検出
todo TODOコメント検出 TODO/FIXME/BUG等を優先度別表示
complexity-ranking 関数複雑度ランキング 最も複雑な関数トップ50
analyze クラス責務分析 メンバ変数×メソッド数で責務スコア計算
analyze <file> ファイル別責務分析 特定ファイルのクラス責務を詳細分析
analyze <file> --deep 詳細分析モード 変数使用パターン等を含む詳細解析（Phase 2）
find <symbol> シンボル検索 関数・変数の使用箇所
files ファイル一覧と詳細情報 詳細ファイル情報
structure クラス/関数構造解析 構造分析
structure --detailed <file> 詳細構造解析 クラス・メソッド・複雑度情報
calls 関数呼び出し統計 呼び出し頻度
calls --detailed <function> 関数詳細解析 呼び出し元・呼び出し先情報
complexity --methods <file> メソッド複雑度 ファイル内メソッドの複雑度ランキング
include-graph インクルード依存関係グラフ C++依存関係
include-cycles 循環依存検出 循環依存問題
include-impact 変更影響範囲分析 影響範囲
include-unused 不要include検出 未使用include
include-optimize 最適化提案 include最適化
template-analysis テンプレート特殊化検出 テンプレート解析
macro-analysis マクロ展開追跡 マクロ使用状況
metaprogramming メタプログラミングパターン検出 メタプログラミング
compile-time-optimization コンパイル時計算最適化提案 コンパイル時最適化

🔧 設定オプション

--compact           # コンパクトJSON出力
--stats-only        # 統計情報のみ（高速）
--no-parallel       # 並列処理無効化
--threads <N>       # スレッド数指定
--performance       # パフォーマンス統計表示
--lang <language>   # 言語指定 (auto|js|ts|cpp|c|python|csharp)

📊 パフォーマンス

  • 初回解析: プロジェクトサイズに依存（例：98ファイルで0.726秒）
  • セッションコマンド: 0.004秒（180倍高速！）
  • メモリ効率: Python版より大幅に削減

🛠️ 革命的技術スタック

🚀 コアエンジン（本格運用対応）

  • C++17 - 高性能基盤
  • PEGTL (Parsing Expression Grammar Template Library) - 主要パースエンジン
  • ハイブリッド戦略 - 最大精度のインテリジェント・フォールバックシステム
  • 基盤層例外 - core.cpp基本機能のスマート正規表現使用

🎯 言語別特化性能

  • JavaScript/TypeScript PEGTL - 489/2,362関数検出能力
  • C++ PEGTL + ハイブリッド - エンタープライズ規模959KBファイル処理
  • Unity C# 特化 - コンテンツ検出 + Composition設計
  • Python ハイブリッド - インデント構文対応インテリジェント文字列ベース解析
  • .NET C# PEGTL - エンタープライズグレード検証・互換性

🔧 サポートインフラ

  • nlohmann/json - 超高速JSON処理
  • UTF8-CPP - 完全Unicode対応
  • Tree-sitter - 将来拡張用AST解析基盤
  • Tarjan's Algorithm - 高度循環依存検出
  • CMake統合 - 自動std::regex防止システム

🛡️ 品質保証

  • 7大プロジェクトテスト - 実戦テスト済み信頼性
  • レガシーコード隔離 - クリーンなアーキテクチャ分離
  • 自己診断能力 - システム自己認識・検証
  • エンタープライズ認定 - .NET runtimeコア互換性検証済み

🌟 革命に参加しよう

NekoCodeは世界中のAI開発者に急速に選ばれています。成長するコミュニティに参加しましょう！

  • ⭐ このリポジトリにスターをつけてサポートを示そう
  • 🔔 Watchして更新情報や新機能を受け取ろう
  • 🐛 問題を報告して改善に協力しよう
  • 🚀 解析結果をシェアしよう

📝 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。

👤 作者

CharmPic

📚 ドキュメント

NekoCodeチームによって🐱で作られました

「革新的なコード解析を、光速で提供！」

「AI開発者に『な、なんだこれは！！』と言わせたツール」 🔥