subcog

概述

Subcog 是一个为 AI 编程助手设计的复杂记忆系统，用 Rust 构建，采用三层存储架构，包括 SQLite 持久化、FTS5 索引用和 usearch HNSW 向量。系统提供 MCP 服务器集成，支持约 22 个合并的 MCP 工具，用于内存 CRUD、搜索、知识图谱操作和提示管理。它结合 BM25 文本搜索与向量相似性评分的混合搜索功能，提供直观的相关性理解。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• subcog_capture

  Capture a new memory with optional namespace and context

  试试:Capture decision to use PostgreSQL for storage试试:Log a learning about database optimization
• subcog_recall

  Search memories using hybrid semantic + BM25 search

  试试:Find memories about database decisions试试:Search for previous solutions to authentication problems
• subcog_status

  Check the status of the memory system

  试试:Show memory system status试试:Check memory statistics
• subcog_consolidate

  Consolidate memories to reduce redundancy

  试试:Consolidate similar memories试试:Optimize memory storage
• subcog_get

  Retrieve a specific memory by ID

  试试:Get memory with ID 123试试:Retrieve specific memory entry
• subcog_update

  Update an existing memory

  试试:Update memory about API design decisions试试:Modify a previous learning
• subcog_delete

  Delete a specific memory

  试试:Delete outdated memory about deprecated method试试:Remove irrelevant memory entry
• subcog_list

  List memories with optional filtering

  试试:List all memories in decisions namespace试试:Show memories for current project
• subcog_graph

  Query the knowledge graph for relationships

  试试:Show connections between authentication and authorization试试:Find related concepts
• subcog_entities

  Extract entities from memories

  试试:Extract entities from database-related memories试试:Identify key concepts in codebase
• subcog_prompts

  Manage prompt templates

  试试:Show available prompt templates试试:List stored prompts
• subcog_init

  Initialize a new session with Subcog

  试试:Start new coding session with Subcog试试:Initialize Subcog for this project

可对比工具

安装

# Cargo (推荐 Rust 开发者使用)
cargo install subcog

# Homebrew (macOS/Linux)
brew install zircote/tap/subcog

# Docker
docker run --rm ghcr.io/zircote/subcog --help

# 二进制文件下载
curl -LO https://github.com/zircote/subcog/releases/latest/download/subcog-VERSION-TARGET.tar.gz

# npm/npx (备用方案)
npx @zircote/subcog --help

{
  "mcpServers": {
    "subcog": {
      "command": "subcog",
      "args": ["serve"]
    }
  }
}

FAQ

Subcog 支持哪些存储后端？

Subcog 默认支持 SQLite 后端，并有可选的 PostgreSQL 支持。对于向量存储，它使用 usearch HNSW，pgvector 和 Redis Vector 作为替代方案。

Subcog 如何保护敏感信息？

Subcog 内置 API 密钥和密码的检测功能，可选的 PII 过滤器，默认启用的静态加密，以及全面的审计日志以满足合规要求。

subcog 对比