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。