Files
gpt/docs/archive/QUICKSTART.md
Claude f2a02abf3e Organize repository structure: clean up root directory
Major reorganization to improve clarity and maintainability:

## Documentation
- Created new simple README.md focused on Layer 1
- Added docs/ARCHITECTURE.md explaining multi-layer design
- Moved LAYER1_REBUILD.md -> docs/LAYER1.md
- Archived old documentation to docs/archive/:
  - CHANGELOG.md, QUICKSTART.md, STATUS.md, USAGE.md
  - DESIGN.md, README_CONFIG.md, ROADMAP.md, TECHNICAL_REVIEW.md
  - claude.md, test-mcp.sh

## Source Code
- Moved unused .rs files to src/tmp/:
  - ai_interpreter.rs (Layer 2 - future)
  - companion.rs (Layer 4b - future)
  - game_formatter.rs (Layer 4a - future)
  - memory.rs (old implementation)
  - extended.rs (old MCP server)

## Result
Clean root directory with only essential files:
- README.md (simple, Layer 1 focused)
- Cargo.toml
- .gitignore
- docs/ (organized documentation)
- src/ (active code only)

All Layer 1 functionality remains intact and tested.
2025-11-05 18:24:38 +00:00

6.2 KiB
Raw Blame History

クイックスタートガイド 🚀

今すぐ試す方法

ステップ1: MCPサーバーを起動

# API キー不要!完全にローカルで動作
./target/debug/aigpt server

ステップ2: Claude Desktop/Codeに設定

Claude Codeの場合

# MCP設定に追加
claude mcp add aigpt /home/user/aigpt/target/debug/aigpt server

手動設定の場合

~/.config/claude-code/config.json に追加:

{
  "mcpServers": {
    "aigpt": {
      "command": "/home/user/aigpt/target/debug/aigpt",
      "args": ["server"]
    }
  }
}

ステップ3: Claude Codeを再起動

MCPサーバーを認識させるため、Claude Codeを再起動してください。


使い方の流れ

🎮 1. 心理テスト風にメモリ作成

Claude Codeで:

create_memory_with_ai ツールを使って
「今日、新しいAIシステムのアイデアを思いついた」
というメモリを作成してください。

結果:

╔══════════════════════════════════════╗
║    🎲 メモリースコア判定          ║
╚══════════════════════════════════════╝

🟣 EPIC 85点
💡 【革新者】

💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍
💎 XP獲得: +850 XP

📤 シェア用テキストも生成されます!

💕 2. 恋愛コンパニオンを作成

Claude Codeで:

create_companion ツールで、
名前「エミリー」、性格「energetic」の
コンパニオンを作成してください。

結果:

╔══════════════════════════════════════╗
║  💕 エミリー のプロフィール      ║
╚══════════════════════════════════════╝

⚡ 性格: 元気で冒険好き

🏆 関係レベル: Lv.1
💕 好感度: 🤍🤍🤍🤍🤍🤍🤍🤍🤍🤍 0%

💬 今日のひとこと:
「おはよう!今日は何か面白いことある?」

🎊 3. コンパニオンに反応してもらう

Claude Codeで:

companion_react ツールで、
先ほど作成した記憶IDを渡してください。

結果:

╔══════════════════════════════════════╗
║     💕 エミリー の反応            ║
╚══════════════════════════════════════╝

⚡ エミリー:
「すごい新しいAIシステムのアイデア
って本当に素晴らしいね!
一緒に実現させよう!」

💕 好感度: ❤️❤️🤍🤍🤍🤍🤍🤍🤍🤍 15%
💎 XP獲得: +850 XP

🏆 4. ランキング確認

Claude Codeで:

list_memories_by_priority ツールで
TOP 10を表示してください。

結果:

╔══════════════════════════════════════╗
║   🏆 メモリーランキング TOP 10    ║
╚══════════════════════════════════════╝

🥇 1位 🟣 EPIC 85点 - 新しいAIシステム...

現在の制限事項と対処法

AI機能が使えない場合

原因: OpenAI APIキーが未設定

対処法:

# 環境変数に設定
export OPENAI_API_KEY=sk-...

# または起動時に指定
OPENAI_API_KEY=sk-... ./target/debug/aigpt server

代替案:

# 基本版のツールを使うAI機能なし
create_memory ツールで「テスト」というメモリを作成

# スコアは固定で 0.5 になります

コンパニオンが保存されない

現状: セッション終了で消える

対処法(今後実装予定):

  • JSON保存機能
  • 次回起動時に自動ロード

今できること:

  • 毎回 create_companion で再作成
  • プロフィールをスクリーンショット保存

トラブルシューティング

Q: MCPツールが見つからない

# Claude Codeを完全再起動
# または設定ファイルを確認
cat ~/.config/claude-code/config.json

Q: 記憶が保存されない

# データファイルを確認
ls -la ~/.config/syui/ai/gpt/memory.json

# ない場合は自動作成されます

Q: ビルドエラーが出る

# 依存関係を更新
cargo clean
cargo build --release

# AI機能付き
cargo build --release --features ai-analysis

おすすめの使い方

💡 アイデア記録として

  1. 思いついたアイデアを create_memory_with_ai で記録
  2. スコアで重要度を客観的に判定
  3. 高スコアのアイデアに集中

💕 恋愛ゲームとして

  1. コンパニオンを作成
  2. 日々の出来事や考えを記録
  3. コンパニオンに反応してもらう
  4. 好感度MAXを目指す

📊 自己分析として

  1. 定期的に思考を記録
  2. 診断タイプの傾向を確認
  3. ランキングで振り返り

次にやること

すぐできる改善

  • コンパニオンの永続化実装
  • 複数コンパニオン対応
  • デイリーチャレンジ完了チェック

中期的な目標

  • Bluesky連携シェア機能
  • Webダッシュボード
  • もっと多様なイベント

楽しみ方のコツ

  1. 毎日使う

    • daily_challenge で習慣化
    • コンパニオンの「今日のひとこと」
  2. 高スコアを狙う

    • LEGENDARY (90%+) を目指す
    • XP 1000獲得の快感
  3. 相性を楽しむ

    • 自分のタイプを確認
    • 相性の良いコンパニオン選択
  4. イベントを楽しむ

    • 好感度100%の告白イベント
    • レベル10の特別な絆

さあ、始めよう! 🚀

# MCPサーバー起動
./target/debug/aigpt server

# Claude Codeで試す
# → create_memory_with_ai
# → create_companion
# → companion_react
# → 楽しむ!