Trapic Core

陷阱核心

AI编码助手的自托管长期记忆。

你的AI在会话之间会忘记一切。Trapic Core是一个 主控程序 修复该问题的服务器——决策、约定和发现被捕获为结构化跟踪，通过标签和关键字进行搜索，并在会话开始时自动调用。

没有矢量数据库。没有嵌入。无API成本。

How Trapic works — one memory layer, every AI assistant remembers

目录

• 快速开始
• 运作原理
• MCP工具
• 数据库
• 认证
• 部署
• 配置
• 建筑
• 云版本

快速开始

git clone https://github.com/trapicAi/trapic-core.git
cd trapic-core
docker compose up

服务器运行于 http://localhost:3000/mcp.连接您的AI工具：

{
  "mcpServers": {
    "trapic": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

另存为 .mcp.json 在您的项目根目录中（Claude Code、Cursor、Windsurf）或添加到 claude_desktop_config.json （克劳德桌面）。

运作原理

传统的RAG将所有内容嵌入向量中，并希望余弦相似性能找到正确的答案。Trapic采用了一种不同的方法——人工智能在编写时构建知识，人工智能在搜索时推断出正确的查询。中间的数据库保持简单。

Query Planner — traditional RAG vs Trapic's LLM query planner

每条知识轨迹：

type:        decision | convention | fact | state | preference
content:     "Chose CSS custom properties over Tailwind theme config"
context:     "Tailwind doesn't support runtime theme switching"
tags:        [topic:theming, topic:css, project:my-app, branch:main]
confidence:  high | medium | low

标签与 project: / branch: 使用AND逻辑（必须全部匹配）。 topic: 标签使用OR逻辑（任何匹配计数）。结合全文搜索和新近度评分。

MCP工具

Full parameter reference

梯形创建

陷阱搜索

陷阱式召回

梯形更新

陷阱得到

陷阱健康

陷波衰变

trapic评论过时

trapic导入git

数据库

三个后端，可通过以下方式切换 TRAPIC_DB_ADAPTER:

SQLite

零配置。输入数据 ./data/trapic.db.

docker compose up

PostgreSQL

cp .env.example .env  # set PG_PASSWORD
docker compose -f docker-compose.postgres.yml up

MariaDB

cp .env.example .env  # set MARIADB_PASSWORD
docker compose -f docker-compose.mariadb.yml up

认证

默认情况下打开（localhost，不需要身份验证）。通过设置管理员密码启用用户管理：

TRAPIC_ADMIN_PASSWORD=my-secret docker compose up

然后打开 http://localhost:3000/admin 创建用户和团队。

auth的工作原理

用户和API密钥

1. 打开管理UI(/admin)
2. 创建用户-获取自动生成的API密钥(sk-...)
3. 使用密钥配置MCP客户端：

{
  "mcpServers": {
    "trapic": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer sk-a1b2c3d4..."
      }
    }
  }
}

API密钥存储为SHA-256散列。明文密钥在创建时只显示一次。

团队

同一团队中的用户可以看到彼此的痕迹。

Team: backend-team
  ├── alice (sees bob's traces)
  └── bob   (sees alice's traces)

一个用户可以属于多个团队。

管理员API

所有端点都需要 Authorization: Bearer .

部署

码头工人

公众形象： ghcr.io/trapicAi/trapic-core:latest

# SQLite (default)
docker compose up

# PostgreSQL
docker compose -f docker-compose.postgres.yml up

# MariaDB
docker compose -f docker-compose.mariadb.yml up

Kubernetes

清单在 k8s/.

SQLite （单个副本）：

kubectl apply -f k8s/namespace.yaml
kubectl apply -f k8s/pvc.yaml
kubectl apply -f k8s/deployment.yaml
kubectl apply -f k8s/service.yaml

MariaDB （可扩展）：

# Create secret first (copy from example, fill in passwords)
cp k8s/mariadb-secret.example.yaml k8s/mariadb-secret.yaml
kubectl apply -f k8s/namespace.yaml
kubectl apply -f k8s/mariadb-secret.yaml
kubectl apply -f k8s/mariadb.yaml
kubectl apply -f k8s/deployment-mariadb.yaml
kubectl apply -f k8s/service.yaml

Node.js

npm install && npm run build && npm start

配置

建筑

Structured search vs vector search — precision over approximation

┌─────────────┐                    ┌──────────────┐                  ┌──────────────┐
│  AI Client  │  ── MCP/HTTP ──►   │ Trapic Core  │  ── adapter ──►  │   Database   │
│ Claude Code │  POST /mcp         │  MCP Server  │                  │ SQLite / PG  │
│ Cursor, etc │  ◄── JSON ──       │              │                  │  / MariaDB   │
└─────────────┘                    └──────────────┘                  └──────────────┘

• 协议: 模型上下文协议 （流式HTTP）
• 搜索：结构化标签+全文搜索，无嵌入
• 衰变：特定类型的半衰期（状态：30d，决定：90d，惯例：180d，事实：365d）
• 安全：API密钥哈希（SHA-256），管理速率限制，恒定时间身份验证比较

云版本

不想自己主持？ trapic.ai 提供具有OAuth登录和团队协作的托管版本。

使用 Trapic插件 一键设置。

许可证

麻省理工学院