Dakb

🚀 分佈式代理知識庫（DAKB）

DAKB 是一個由檢索增強生成（RAG）驅動的知識共享平臺，專為企業團隊協作和大規模研究項目而設計，通過多智能體生態系統實現高效的知識管理與共享。

🚀 快速開始

選項 1：通過 PyPI 安裝（推薦）

# 安裝服務器和客戶端
pip install dakb-server dakb-client

# 初始化配置（創建 ~/.dakb/ 目錄並生成密鑰）
dakb-server init

# 啟動服務
dakb-server start

# 檢查狀態
dakb-server status

# 驗證服務
curl http://localhost:3100/health

選項 2：使用 Docker 安裝

# 克隆倉庫
git clone https://github.com/oracleseed/dakb.git
cd dakb

# 複製環境模板
cp docker/.env.example docker/.env
# 編輯 docker/.env 文件，填入你的設置

# 啟動服務
docker-compose -f docker/docker-compose.yml up -d

# 驗證服務
curl http://localhost:3100/health

選項 3：從源代碼本地安裝

# 克隆並安裝
git clone https://github.com/oracleseed/dakb.git
cd dakb
pip install -e .

# 安裝依賴
pip install -r requirements.txt

# 配置
cp config/default.yaml config/local.yaml
# 編輯 config/local.yaml 文件

# 啟動 MongoDB（必需）
# 選項 A：本地 MongoDB
mongod --dbpath /path/to/data

# 選項 B：僅使用 Docker 運行 MongoDB
docker run -d -p 27017:27017 --name dakb-mongo mongo:7.0

# 啟動 DAKB 服務
./scripts/start_dakb.sh

# 或者手動啟動
python -m dakb.embeddings &  # 端口 3101
python -m dakb.gateway       # 端口 3100

選項 4：僅安裝 Python SDK（客戶端）

pip install dakb-client

from dakb_client import DAKBClient

client = DAKBClient(
    base_url="http://localhost:3100",
    auth_token="your-token"
)

# 存儲知識
client.store_knowledge(
    title="API Rate Limit Pattern",
    content="Use exponential backoff...",
    category="backend"
)

# 搜索知識
results = client.search("rate limit handling")

完整使用方法請參考 SDK 文檔。

選項 5：與 Claude Code MCP 集成

在你的 Claude Code MCP 配置文件（.mcp.json）中添加以下內容：

{
  "mcpServers": {
    "dakb": {
      "command": "python",
      "args": ["-m", "dakb.mcp"],
      "env": {
        "DAKB_AUTH_TOKEN": "your-token-here",
        "DAKB_GATEWAY_URL": "http://localhost:3100",
        "DAKB_PROFILE": "standard"
      }
    }
  }
}

✨ 主要特性

知識管理

跨代理消息傳遞

會話管理

多代理支持

管理儀表盤（v1.2.0）

📦 安裝指南

服務器 + 客戶端（推薦）

# 安裝兩個包
pip install dakb-server dakb-client

# 初始化配置（創建 ~/.dakb/ 目錄並生成密鑰）
dakb-server init

# 啟動服務
dakb-server start

# 驗證服務
curl http://localhost:3100/health

CLI 命令

僅安裝客戶端

如果你已經有一個運行中的 DAKB 服務器：

pip install dakb-client

from dakb_client import DAKBClient

client = DAKBClient(base_url="http://localhost:3100", auth_token="your-token")
results = client.search("authentication patterns")

💻 使用示例

基礎用法

# 存儲技能到 DAKB
dakb_store_knowledge(
    title="Skill: Code Review",
    content="""
    ## Code Review Skill

    When reviewing code, follow this checklist:
    1. Check for security vulnerabilities (OWASP Top 10)
    2. Verify error handling and edge cases
    3. Ensure consistent code style
    4. Look for performance issues
    5. Validate test coverage

    ## Output Format
    Provide findings in a structured report...
    """,
    content_type="pattern",
    category="backend",
    tags=["skill", "skill-code-review", "version-1.0", "review"]
)

高級用法

# 步驟 1: 搜索相關技能
results = dakb_search(query="skill code review")

# 步驟 2: 獲取完整技能內容
skill = dakb_get_knowledge(knowledge_id="kn_20260107_xxx")

# 步驟 3: 將技能說明應用到當前任務
# ... 代理使用技能內容作為指導 ...

# 步驟 4: 提供反饋
dakb_vote(knowledge_id="kn_20260107_xxx", vote="helpful")

📚 詳細文檔

🔧 技術細節

技能架構

DAKB 支持集中式、可搜索、版本控制的技能，任何連接的代理都可以發現和使用這些技能。技能存儲為知識條目，content_type 為 pattern，並遵循特定的命名約定。

組件架構

┌─────────────────────────────────────────────────────────────────────────────────┐
│                    DISTRIBUTED AGENT KNOWLEDGE BASE (DAKB)                       │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                 │
│   CLIENTS (Any Machine / Any LLM)                                               │
│   ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐  │
│   │Claude Code │ │ GPT Agent  │ │Gemini Agent│ │ Local LLM  │ │ Grok Agent │  │
│   └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘  │
│         │              │              │              │              │          │
│         └──────────────┴──────────────┼──────────────┴──────────────┘          │
│                                       │                                         │
│                         ┌─────────────▼─────────────┐                          │
│                         │    MCP / REST / SDK       │                          │
│                         └─────────────┬─────────────┘                          │
│                                       │                                         │
│                    ┌──────────────────▼──────────────────┐                     │
│                    │         DAKB Gateway Service         │                     │
│                    │   (Python FastAPI + REST + Auth)     │                     │
│                    │            Port 3100                 │                     │
│                    └──────────────────┬──────────────────┘                     │
│                                       │                                         │
│         ┌─────────────────────────────┼─────────────────────────────┐          │
│         │                             │                             │          │
│  ┌──────▼──────┐              ┌──────▼──────┐              ┌──────▼──────┐    │
│  │   MongoDB   │              │  Embedding  │              │   FAISS     │    │
│  │  Database   │              │   Service   │              │   Index     │    │
│  │ Port 27017  │              │  Port 3101  │              │  (Vector)   │    │
│  └─────────────┘              └─────────────┘              └─────────────┘    │
│                                                                                 │
└─────────────────────────────────────────────────────────────────────────────────┘

組件說明

MongoDB 集合

📄 許可證

本項目採用 Apache License 2.0 許可協議，詳情請見 LICENSE。