opcode-pg-memory 2.2.0

package/.env.example

@@ -0,0 +1,42 @@
+# ============================================================
+# opcode-pg-memory 环境配置
+# 复制此文件为 .env 并修改
+# ============================================================
+
+# === PostgreSQL 连接 ===
+PG_HOST=localhost
+PG_PORT=5432
+PG_DATABASE=PGOMO
+PG_USER=opencode
+PG_PASSWORD=your_password_here
+PG_SSL=false
+
+# === 嵌入模型（三选一）===
+# 方案 A: 本地 Ollama（推荐，免费）
+EMBEDDING_PROVIDER=ollama
+EMBEDDING_MODEL=qwen3-embedding:0.6b
+EMBEDDING_DIMENSIONS=1024
+
+# 方案 B: DeepSeek API
+# EMBEDDING_PROVIDER=deepseek
+# EMBEDDING_MODEL=text-embedding-v2
+# EMBEDDING_DIMENSIONS=1536
+# DEEPSEEK_API_KEY=sk-...
+# DEEPSEEK_BASE_URL=https://api.deepseek.com
+
+# 方案 C: OpenAI API
+# EMBEDDING_PROVIDER=openai
+# EMBEDDING_MODEL=text-embedding-3-small
+# EMBEDDING_DIMENSIONS=1536
+# OPENAI_API_KEY=sk-...
+
+# === 嵌入批处理 ===
+EMBEDDING_BATCH_SIZE=10
+
+# === OmO 多 Agent 集成（可选）===
+# OMO_ENABLED=true
+# OMO_INTEGRATION=enabled
+
+# === DeepSeek API（仅在使用 DeepSeek 嵌入时）===
+# DEEPSEEK_API_KEY=sk-...
+# DEEPSEEK_BASE_URL=https://api.deepseek.com

package/README.md

@@ -0,0 +1,132 @@
+# opcode-pg-memory
+
+**OpenCode 长期记忆插件** — PostgreSQL + pgvector 四层记忆架构，话题隔离 · Agent 自主调用 · OmO 多 Agent 协调
+
+[![npm](https://img.shields.io/npm/v/opcode-pg-memory)](https://www.npmjs.com/package/opcode-pg-memory)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+## 特性
+
+- **四层记忆** — Retain · Recall · Reflect · Semantic Cache
+- **话题段隔离** — 滑动窗口检测会话内话题切换，防止跨话题实体污染
+- **语义向量检索** — HNSW + BM25 + Graph + Keyword 四策略并行
+- **Agent 自主调用** — `caller_context` 上下文融合，关键词自动触发
+- **隐私过滤** — `<private>` 标签自动 [REDACTED]
+- **MCP 工具** — `recall_memory` / `hindsight_reflect`
+
+## 安装
+
+```bash
+# npm 安装（推荐）
+bunx opcode-pg-memory install
+
+# 或从 GitHub
+git clone https://github.com/Vbs313/opcode-pg-memory.git && cd opcode-pg-memory
+.\scripts\setup.ps1
+```
+
+`bunx install` 会自动注册插件到 `opencode.jsonc` 并创建 `/pg-memory-init` 命令。
+
+## 注册
+
+在 `~/.config/opencode/opencode.jsonc` 中确认 MCP 配置：
+
+```jsonc
+{
+  "mcp": {
+    "pg-memory": {
+      "type": "local",
+      "command": ["bun", "path/to/opcode-pg-memory/dist/mcp-server.js"],
+      "enabled": true,
+      "environment": {
+        "PG_HOST": "localhost", "PG_PORT": "5432",
+        "PG_DATABASE": "PGOMO",  "PG_USER": "opencode",
+        "PG_PASSWORD": "你的密码",
+        "EMBEDDING_PROVIDER": "ollama",
+        "EMBEDDING_MODEL": "qwen3-embedding:0.6b",
+        "EMBEDDING_DIMENSIONS": "1024"
+      }
+    }
+  }
+}
+```
+
+验证：`opencode --print-logs --log-level INFO | findstr "PG Memory"` → 看到 `Plugin initialized successfully`
+
+## 配置
+
+三重优先级：**MCP environment > ~/.config/opencode/pg-memory.jsonc > 默认值**
+
+```jsonc
+// ~/.config/opencode/pg-memory.jsonc（可选）
+{
+  "similarityThreshold": 0.7,
+  "maxMemories": 15,
+  "logLevel": "info",
+  "compactionThreshold": 0.85
+}
+```
+
+| Provider | 模型 | 维度 |
+|----------|------|------|
+| `ollama` | `qwen3-embedding:0.6b` | 1024 |
+| `deepseek` | `text-embedding-v2` | 1536 |
+| `openai` | `text-embedding-3-small` | 1536 |
+
+## MCP 工具
+
+### recall_memory
+
+```json
+// Agent 自主调用
+recall_memory({
+  "query": "数据库连接池配置",
+  "caller_context": { "type": "omo_agent", "current_goal": "性能调优" },
+  "retrieval_strategies": ["semantic", "graph"],
+  "filters": { "tier": "project" }
+})
+```
+
+### hindsight_reflect
+
+```json
+// 跨会话反思
+hindsight_reflect({ "omo_task_id": "task_123", "aggregate": true })
+```
+
+## 架构
+
+```
+session_map → topic_segments → entities / observations / relations / reflections
+                              → semantic_cache (HNSW 动态阈值)
+                              → token_usage_log
+```
+
+## 项目结构
+
+```
+src/
+├── index.ts        # 插件入口（chat.message + event hook）
+├── config.ts       # 集中配置（文件+环境+默认值）
+├── cli.ts          # CLI（install 命令）
+├── types.ts        # 类型定义
+├── db/init-db.ts   # 数据库初始化 + 迁移
+├── hooks/          # 生命周期钩子
+├── mcp/            # MCP 工具实现
+├── topic/          # 话题段管理器
+├── services/       # 日志 · 关键词 · 隐私过滤
+├── cache/          # 语义缓存
+└── omo/            # OmO 适配器
+mcp-server.ts       # MCP 服务入口
+```
+
+## 文档
+
+| 文档 | 内容 |
+|------|------|
+| [USAGE_GUIDE.md](./USAGE_GUIDE.md) | 完整使用指南 — 配置 · 工具 · 运维 |
+| [PLUGIN_DOCUMENTATION.md](./PLUGIN_DOCUMENTATION.md) | 架构详解 — 钩子系统 · 数据库设计 |
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+var OPENCODE_CONFIG_DIR = join(homedir(), ".config", "opencode");
+var OPENCODE_COMMAND_DIR = join(OPENCODE_CONFIG_DIR, "command");
+var PLUGIN_NAME = "opcode-pg-memory";
+var REPO_URL = "https://github.com/Vbs313/opcode-pg-memory";
+var PG_MEMORY_INIT_COMMAND = `---
+description: Initialize pg-memory with codebase knowledge
+---
+
+# Initializing PG Memory
+
+You are bootstrapping the pg-memory plugin for this project. This plugin provides:
+
+- **Semantic memory search** via recall_memory MCP tool
+- **Automatic observation recording** from tool executions
+- **Topic segmentation** within sessions
+- **Cross-session reflection** via hindsight_reflect
+
+## Steps
+
+1. Run \`recall_memory\` with a test query to verify connectivity
+2. The plugin will automatically start recording observations as you work
+3. After significant work, run \`hindsight_reflect\` to generate reflections
+
+## Setup Verification
+\`\`\`bash
+opencode --print-logs --log-level INFO | findstr "PG Memory"
+\`\`\`
+`;
+function stripJsoncComments(content) {
+  return content.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+}
+function findOpencodeConfig() {
+  const candidates = [
+    join(OPENCODE_CONFIG_DIR, "opencode.jsonc"),
+    join(OPENCODE_CONFIG_DIR, "opencode.json")
+  ];
+  for (const path of candidates) {
+    if (existsSync(path))
+      return path;
+  }
+  return null;
+}
+function addPluginToConfig(configPath) {
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    if (content.includes(PLUGIN_NAME)) {
+      console.log("Plugin already registered");
+      return true;
+    }
+    const jsonContent = stripJsoncComments(content);
+    let config;
+    try {
+      config = JSON.parse(jsonContent);
+    } catch {
+      console.error("Failed to parse config");
+      return false;
+    }
+    const plugins = config.plugin || [];
+    plugins.push(PLUGIN_NAME);
+    config.plugin = plugins;
+    if (configPath.endsWith(".jsonc")) {
+      if (content.includes('"plugin"')) {
+        const newContent = content.replace(/("plugin"\s*:\s*\[)([^\]]*?)(\])/, (_match, start, middle, end) => {
+          const trimmed = middle.trim();
+          return trimmed === "" ? `${start}
+    "${PLUGIN_NAME}"
+  ${end}` : `${start}${middle.trimEnd()},
+    "${PLUGIN_NAME}"
+  ${end}`;
+        });
+        writeFileSync(configPath, newContent);
+      } else {
+        const newContent = content.replace(/^(\s*\{)/, `$1
+  "plugin": ["${PLUGIN_NAME}"],`);
+        writeFileSync(configPath, newContent);
+      }
+    } else {
+      writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    console.log(`Added plugin to ${configPath}`);
+    return true;
+  } catch (err) {
+    console.error("Failed to update config:", err);
+    return false;
+  }
+}
+function createNewConfig() {
+  const configPath = join(OPENCODE_CONFIG_DIR, "opencode.jsonc");
+  mkdirSync(OPENCODE_CONFIG_DIR, { recursive: true });
+  const config = `{
+  "plugin": ["${PLUGIN_NAME}"]
+}
+`;
+  writeFileSync(configPath, config);
+  console.log(`Created ${configPath}`);
+  return true;
+}
+function createInitCommand() {
+  mkdirSync(OPENCODE_COMMAND_DIR, { recursive: true });
+  const initPath = join(OPENCODE_COMMAND_DIR, "pg-memory-init.md");
+  writeFileSync(initPath, PG_MEMORY_INIT_COMMAND);
+  console.log("Created /pg-memory-init command");
+  return true;
+}
+function printHelp() {
+  console.log(`
+pg-memory - PostgreSQL-backed long-term memory for OpenCode
+
+Commands:
+  install    Register plugin and create /pg-memory-init command
+
+Examples:
+  bunx opcode-pg-memory install
+  git clone ${REPO_URL} && cd opcode-pg-memory && bun run build
+
+After installation, configure the MCP server in opencode.jsonc:
+  "mcp": {
+    "pg-memory": {
+      "type": "local",
+      "command": ["bun", "path/to/dist/mcp-server.js"],
+      "enabled": true,
+      "environment": { ... }
+    }
+  }
+`);
+}
+var args = process.argv.slice(2);
+var cmd = args[0];
+if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+  printHelp();
+  process.exit(0);
+}
+if (cmd === "install") {
+  console.log(`
+OpenCode PG Memory installer
+`);
+  const configPath = findOpencodeConfig();
+  if (configPath) {
+    console.log(`Found config: ${configPath}`);
+    addPluginToConfig(configPath);
+  } else {
+    console.log("No config found, creating...");
+    createNewConfig();
+  }
+  createInitCommand();
+  console.log(`
+Setup complete!`);
+  console.log(`
+Next steps:`);
+  console.log(`  1. cd ${process.cwd()}`);
+  console.log("  2. cp .env.example .env && edit .env");
+  console.log("  3. bun install && bun run build");
+  console.log(`  4. Restart OpenCode
+`);
+  process.exit(0);
+}
+console.error(`Unknown command: ${cmd}`);
+printHelp();
+process.exit(1);

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plugin entry point — re-exports from src/index.ts
+ *
+ * OpenCode loads plugins from `dist/index.js`.
+ * The actual plugin logic lives in `src/index.ts`.
+ */
+export * from './src/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,aAAa,CAAC"}