Nexus Agent Framework

🎯 Nexus Agent Framework v2.0

安全優先的通用 Agent 工作框架

提供自動化知識管理、智能建議系統和關聯分析，讓您的 Agent 工作區更智能、更高效。

✨ 核心功能

🔮 自動知識索引系統

自動掃描並索引所有工作區檔案，建立知識網絡：

• 自動掃描: 掃描所有 .md 檔案
• 關鍵詞提取: 提取標題、標籤、實體
• 時標記錄: 自動識別日期
• JSON 索引: 生成 memory/index.json

使用:

./scripts/auto-index.sh

輸出示例:

{
  "version": "1.2",
  "files": [
    {
      "path": "memory/2026-03-24.md",
      "date": "2026-03-24",
      "keywords": ["日誌", "任務", "優化"],
      "entities": ["Jazz", "Nexus"],
      "word_count": 153
    }
  ],
  "statistics": {
    "total_files": 18,
    "total_words": 3388
  }
}

💡 主動創意建議系統

分析日誌模式，自動提供可執行的優化建議：

• 模式識別: 實作/修復/優化/學習/設計
• 智能建議: 基於使用習慣的具體建議
• 定期報告: 每日/每週/每月報告
• Cron 支援: 自動排程執行

使用:

./scripts/idea-generator.sh

輸出:

📊 日誌分析統計
• 實作任務：5 次
• 修復問題：3 次
• 優化改進：3 次

💡 建議
1️⃣ 實作模式分析
   💡 建議：建立可重用組件庫

🔗 智能關聯分析系統

計算檔案之間的關聯關係，建立知識網絡：

• 6 種關係類型: 強/中/弱/層次/版本/學習
• 關聯計算: 基於關鍵詞共現、時間、主題
• 關聯網圖: 生成 memory/relations.json

使用:

./scripts/relations-analyzer.sh

🗂️ 目錄結構

workspace/
├── SKILL.md              # 本文件
├── AGENTS.md             # Agent 行為規則
├── SOUL.md               # 身份與原則
├── MEMORY.md             # 長期記憶
├── NEXUS.md              # 記憶網絡樞紐
├── HEARTBEAT.md          # 自我檢查清單
├── TOOLS.md              # 工具配置
├── USER.md               # 用戶設定
├── WAL.md                # 操作日誌
├── EMOJI-JOURNAL.md      # 情緒溫度計
│
├── scripts/
│   ├── auto-index.sh     # 知識索引腳本
│   ├── idea-generator.sh # 創意建議腳本
│   └── relations-analyzer.sh  # 關聯分析腳本
│
├── docs/
│   ├── KNOWLEDGE-INDEX-ARCHITECTURE.md
│   ├── IDEA-SYSTEM-USAGE.md
│   ├── NEXUS-RELATIONS.md
│   └── IMPLEMENTATION-NOTES.md
│
└── memory/
    ├── index.json        # 知識索引
    ├── relations.json    # 關聯圖譜
    ├── heartbeat-state.json
    ├── daily/            # 每日記錄
    ├── lessons/          # 經驗教訓
    └── ideas/            # 創意想法

🚀 快速開始

1. 基礎設置

# 初始化目錄結構
mkdir -p memory/daily memory/lessons memory/ideas

# 建立每日日誌
echo "# $(date +%Y-%m-%d)" > memory/$(date +%Y-%m-%d).md

2. 執行系統

# 建立知識索引
./scripts/auto-index.sh

# 獲取創意建議
./scripts/idea-generator.sh

# (可選) 計算關聯
./scripts/relations-analyzer.sh

3. 自動排程

每日 Heartbeat:

# 添加到你的 Heartbeat 系統
./scripts/auto-index.sh > /dev/null 2>&1

每週報告:

# Crontab: 每週日早上 9 點
0 9 * * 0 cd /path/to/workspace && ./scripts/idea-generator.sh

📚 文檔

架構文件

• KNOWLEDGE-INDEX-ARCHITECTURE.md - 知識索引系統設計
• IDEA-SYSTEM-USAGE.md - 創意建議系統使用指南
• NEXUS-RELATIONS.md - 關聯分析系統規格 (6 種關係)
• IMPLEMENTATION-NOTES.md - 實作記錄

核心文件

• AGENTS.md - Agent 行為規則與路由
• NEXUS.md - 記憶網絡樞紐
• MEMORY.md - 長期記憶管理
• HEARTBEAT.md - 主動巡檢機制

🔄 工作流程

1. 每日寫日誌
   └─> memory/YYYY-MM-DD.md

2. 自動索引更新
   └─> ./scripts/auto-index.sh
   └─> memory/index.json

3. 創意建議生成
   └─> ./scripts/idea-generator.sh
   └─> idea-suggestions.txt

4. 關聯分析
   └─> ./scripts/relations-analyzer.sh
   └─> memory/relations.json

5. 定期回顧
   └─> 每週/每月彙整到 MEMORY.md

🔧 進階使用

自訂關鍵詞

編輯 scripts/idea-generator.sh:

# 添加你的關鍵詞
your_keyword=$(grep -rc '你的關鍵詞' "$LOG_DIR")

Cron 自動執行

# 每日 9 點生成建議
0 9 * * * cd ~/workspace && ./scripts/idea-generator.sh >> weekly.log

# 每週日全量索引
0 8 * * 0 cd ~/workspace && ./scripts/auto-index.sh

Git 集成

# 提交前生成報告
./scripts/idea-generator.sh > .commit-report.md
git add . && git commit -F .commit-report.md

🎯 使用場景

場景 1: 個人知識管理

• 每日記錄 → 自動索引 → 每週回顧
• 自動識別知識盲點

場景 2: 專案管理

• 追蹤實作/修復/優化比例
• 自動建議改進方向

場景 3: Agent 協作

• 路由決策 → 執行 → 記錄
• 自動總結經驗教訓

📊 統計數據

本框架特性:

🌟 最佳實踐

1. 每日記錄: 在 memory/YYYY-MM-DD.md 寫日誌
2. 每週回顧: 執行建議系統，整理教訓
3. 每月沉澧: 將重要決策寫到 MEMORY.md
4. ** Git 提交**: 記錄架構變更和決策

📄 許可證

MIT-0 - 免費使用，修改，重新分發。無需署名。

🙏 致敬

感謝所有 OpenClaw 社區成員與貢獻者。

版本: 2.0.0
最後更新: 2026-03-25
作者: @lalawgwg99