长记忆使用Hooks对接Qoder

前置要求

• Qoder IDE或Qoder CLI已安装并可正常使用。

• Python >= 3.10。

• 已获取AnalyticDB for PostgreSQL长记忆服务的API地址和Token。

• 已获取adbpgmem_mcp_selfhosted项目源码adbpgmem-mcp-server-0.2.0.tar.gz。

  请将压缩包解压到指定目录 adbpgmem_mcp_selfhosted，后续步骤中的路径均指向该解压目录。

安装步骤

通过pip install安装Python包，将Hook CLI入口注册到当前Python环境：

pip install -e /path/to/adbpgmem_mcp_selfhosted

安装完成后，以下Qoder专用的CLI命令将可用：

验证安装：

which adbpgmem-qoder-stop
# 应输出安装路径，如 /usr/local/bin/adbpgmem-qoder-stop

需要配置的参数

方式一：环境变量

在启动Qoder前导出环境变量，Hooks会继承父进程的环境变量：

export ADBPGMEM_API_URL="https://api-longmemory-cn-chengdu.opentrust.net"
export ADBPGMEM_API_TOKEN="sk-your-token-here"
export ADBPGMEM_USER_ID="your.username"

方式二：配置文件（推荐）

写入后无需再次操作，ADBPGMEM_USER_ID可省略（默认取系统用户名）。

全局配置（推荐，对所有项目生效）：

mkdir -p ~/.qoder
cat > ~/.qoder/adbpgmem.conf << 'EOF'
ADBPGMEM_API_URL="https://api-longmemory-cn-chengdu.opentrust.net"
ADBPGMEM_API_TOKEN="sk-your-token-here"
ADBPGMEM_USER_ID="your.username"
EOF

项目级配置（仅对当前项目生效）：

mkdir -p .qoder
cat > .qoder/adbpgmem.conf << 'EOF'
ADBPGMEM_API_URL="https://api-longmemory-cn-chengdu.opentrust.net"
ADBPGMEM_API_TOKEN="sk-your-token-here"
ADBPGMEM_USER_ID="your.username"
EOF

全局安装（推荐）

写入~/.qoder/settings.json，对所有项目生效：

# （可选）备份现有配置
cp ~/.qoder/settings.json ~/.qoder/settings.json.bak 2>/dev/null

# 全局注册（自动检测平台）
adbpgmem-install-hooks --global

# 或手动指定Qoder平台
adbpgmem-install-hooks --platform qoder --global

项目级安装

写入<项目>/.qoder/settings.json，仅对当前项目生效：

# （可选）备份现有配置
cp .qoder/settings.json .qoder/settings.json.bak 2>/dev/null

# 项目级注册
adbpgmem-install-hooks
# 或手动指定
adbpgmem-install-hooks --platform qoder

按类型选择性安装

安装器支持按Hook职责分组选择性安装：

# 仅安装记录类Hook（stop + pretooluse）
adbpgmem-install-hooks --global --type write

# 仅安装注入类Hook（userpromptsubmit）
adbpgmem-install-hooks --global --type read

# 安装全部（默认）
adbpgmem-install-hooks --global --type all

注册后，settings.json中会写入以下Hook配置：

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-userpromptsubmit", "timeout": 10}
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-stop", "timeout": 30}
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-pretooluse", "timeout": 2}
        ]
      }
    ]
  }
}

卸载Hooks

# 自动检测平台（推荐）
adbpgmem-uninstall-hooks --global   # 全局卸载
adbpgmem-uninstall-hooks            # 项目级卸载

# 手动指定平台
adbpgmem-uninstall-hooks --platform qoder --global

# 同时清理会话注入标记目录
adbpgmem-uninstall-hooks --global --remove-sessions

验证注册

# 检查Hooks是否注册成功
cat ~/.qoder/settings.json
# 应包含 adbpgmem-qoder-stop 等条目

功能测试：在Qoder中发送一条消息，观察AI回答是否包含了历史记忆上下文。

查看日志

Hook运行日志写入~/.qoder/adbpgmem-hooks.log，排障时查看最新日志：

tail -50 ~/.qoder/adbpgmem-hooks.log

调用方式

Hooks全自动运行，无需任何手动操作。Qoder在以下时机自动触发：

各Hook详细工作原理

# adbpgmem 跨会话记忆

1. 项目使用 Go 1.22 + Gin 框架，ORM 使用 GORM v2
2. 数据库选择 PostgreSQL 15，连接池用 PgBouncer，最大连接数 50
3. API 统一使用 RESTful 风格，错误码遵循 RFC 7807

场景一：新会话自动继承历史决策

您在项目中确定了技术栈选型，下次开启新会话时希望Qoder AI自动知晓。

会话1（通过MCP工具或其他方式保存了记忆）：

你: 记住：项目使用 Python 3.11 + FastAPI，数据库 PostgreSQL 15，缓存 Redis 7

会话2（几天后启动新会话）：

你: 帮我添加一个新的 API 端点

← adbpgmem-qoder-userpromptsubmit 自动触发（首条 prompt）
← 双查询搜索用户 prompt 和 "项目名 项目架构 技术栈"
← 将匹配的记忆注入 additionalContext
← 创建会话标记文件，后续消息不再重复触发

Qoder AI: 基于项目的 FastAPI + PostgreSQL 15 技术栈，我来创建新的端点...
         [自动使用正确的框架和数据库版本]

用户无需手动告知Qoder AI技术栈，历史记忆已在首条消息时自动注入。

场景二：防止记忆分散到本地文件

Qoder AI在对话中尝试将记忆写入本地MEMORY.md文件。

Qoder AI: [尝试调用 Write 工具写入 MEMORY.md]
          "让我把这次的架构决策记录到 MEMORY.md..."

← adbpgmem-qoder-pretooluse 自动触发
← 检测到目标路径匹配 "MEMORY.md" 守护模式
← 返回 decision: "block" + permissionDecision: "deny"
← reason: "记忆应通过 add_memory MCP 工具存储到 adbpgmem"

Qoder AI: [收到阻止信号，改为使用 add_memory MCP 工具]
          已将架构决策保存到 adbpgmem 记忆库。

所有记忆集中存储到 adbpgmem，避免分散在本地文件中导致跨会话无法检索。

场景三：MCP + Hooks组合使用（最完整方案）

您希望获得最完整的记忆能力，同时使用MCP工具和Hooks。

配置步骤：

# 1. 安装Python包（Hooks需要）
pip install -e /path/to/adbpgmem_mcp_selfhosted

# 2. 注册MCP Server（编辑 ~/.qoder/settings.json，添加 mcpServers 配置）

# 3. 注册Hooks
adbpgmem-install-hooks --platform qoder --global

# 4. 配置AGENTS.md（引导Qoder AI主动使用MCP工具）
cat >> AGENTS.md << 'EOF'

# MCP Servers
- **adbpgmem**: 持久记忆服务。每次会话开始时先 search_memories 搜索相关上下文，
  发现架构决策、调试经验、编码模式时用 add_memory 保存。宁可多记，不可漏记。
EOF

完整的~/.qoder/settings.json示例（MCP + Hooks共存）：

{
  "mcpServers": {
    "adbpgmem": {
      "command": "uvx",
      "args": ["--from", "/path/to/adbpgmem_mcp_selfhosted", "adbpgmem-mcp-server"],
      "env": {
        "ADBPGMEM_API_URL": "https://api-longmemory-cn-chengdu.opentrust.net",
        "ADBPGMEM_API_TOKEN": "sk-your-token-here",
        "ADBPGMEM_USER_ID": "your.username"
      }
    }
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-userpromptsubmit", "timeout": 10}
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-stop", "timeout": 30}
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {"type": "command", "command": "adbpgmem-qoder-pretooluse", "timeout": 2}
        ]
      }
    ]
  }
}

组合使用效果：