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.
This commit is contained in:
Claude
263
docs/archive/QUICKSTART.md
Normal file
263
docs/archive/QUICKSTART.md
Normal file
@@ -0,0 +1,263 @@
|
||||
# クイックスタートガイド 🚀
|
||||
|
||||
## 今すぐ試す方法
|
||||
|
||||
### ステップ1: MCPサーバーを起動
|
||||
|
||||
```bash
|
||||
# API キー不要！完全にローカルで動作
|
||||
./target/debug/aigpt server
|
||||
```
|
||||
|
||||
### ステップ2: Claude Desktop/Codeに設定
|
||||
|
||||
#### Claude Codeの場合
|
||||
```bash
|
||||
# MCP設定に追加
|
||||
claude mcp add aigpt /home/user/aigpt/target/debug/aigpt server
|
||||
```
|
||||
|
||||
#### 手動設定の場合
|
||||
`~/.config/claude-code/config.json` に追加：
|
||||
|
||||
```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キーが未設定
|
||||
|
||||
**対処法:**
|
||||
```bash
|
||||
# 環境変数に設定
|
||||
export OPENAI_API_KEY=sk-...
|
||||
|
||||
# または起動時に指定
|
||||
OPENAI_API_KEY=sk-... ./target/debug/aigpt server
|
||||
```
|
||||
|
||||
**代替案:**
|
||||
```
|
||||
# 基本版のツールを使う（AI機能なし）
|
||||
create_memory ツールで「テスト」というメモリを作成
|
||||
|
||||
# スコアは固定で 0.5 になります
|
||||
```
|
||||
|
||||
### ❌ コンパニオンが保存されない
|
||||
|
||||
**現状:** セッション終了で消える
|
||||
|
||||
**対処法（今後実装予定）:**
|
||||
- JSON保存機能
|
||||
- 次回起動時に自動ロード
|
||||
|
||||
**今できること:**
|
||||
- 毎回 create_companion で再作成
|
||||
- プロフィールをスクリーンショット保存
|
||||
|
||||
---
|
||||
|
||||
## トラブルシューティング
|
||||
|
||||
### Q: MCPツールが見つからない
|
||||
```bash
|
||||
# Claude Codeを完全再起動
|
||||
# または設定ファイルを確認
|
||||
cat ~/.config/claude-code/config.json
|
||||
```
|
||||
|
||||
### Q: 記憶が保存されない
|
||||
```bash
|
||||
# データファイルを確認
|
||||
ls -la ~/.config/syui/ai/gpt/memory.json
|
||||
|
||||
# ない場合は自動作成されます
|
||||
```
|
||||
|
||||
### Q: ビルドエラーが出る
|
||||
```bash
|
||||
# 依存関係を更新
|
||||
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の特別な絆
|
||||
|
||||
---
|
||||
|
||||
## さあ、始めよう！ 🚀
|
||||
|
||||
```bash
|
||||
# MCPサーバー起動
|
||||
./target/debug/aigpt server
|
||||
|
||||
# Claude Codeで試す
|
||||
# → create_memory_with_ai
|
||||
# → create_companion
|
||||
# → companion_react
|
||||
# → 楽しむ！
|
||||
```
|
||||
Reference in New Issue
Block a user