wilburli/onlyMemory-plugin1

only-memory

DeepSeek Harness 记忆插件 - 零外部依赖的 LLM 长期记忆系统

包名
only-memory
版本
0.1.0
最近更新
2026年8月25日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:wilburli/onlyMemory-plugin

查看配置树,确认 only-memory 在 bundle 列表中

dsh --profile web --dump-config


在输出中搜索 `only_memory`,应该能看到 MCP 客户端配置。

### 卸载

```bash
dsh plugin --profile web remove only-memory

快速开始

安装到 Harness


# 方式二:--patch(临时使用)
dsh web --patch ./path/to/onlyMemory-plugin/cordis-patch.yml

### 独立使用(不依赖 Harness)

```typescript
import { MemoryEngine } from './dist/engine.js';

const engine = new MemoryEngine({ projectId: 'my-app' });
await engine.init();

// 存储
await engine.remember('用户名叫张三,在北京工作', 0.9);

// 检索
const results = await engine.search('用户在哪里工作?');

// 对话集成
const context = await engine.onUserMessage('你好,还记得我吗?');
await engine.onAssistantMessage('当然记得,你是张三,在北京工作。');

// 会话结束触发自动维护(衰减、去重、清理)
await engine.endSession('session-001');

engine.close();

src/config.ts — 配置管理

interface MemoryPluginConfig {
  projectId: string;              // 项目标识,默认 'default'
  dataDir: string;                // 数据根目录,默认 ~/.deepseek_mem
  dbName: string;                 // 数据库文件名,默认 'memory.db'
  topK: number;                   // 检索返回条数,默认 5
  importanceThreshold: number;    // 重要性过滤阈值,默认 0.3
  halfLifeDays: number;           // 衰减半衰期(天),默认 30
  embeddingBackend: 'none' | 'openai' | 'dashscope' | 'local';
  embeddingModel: string;         // Embedding 模型名
  embeddingDim: number;           // 向量维度,默认 1536
  summarizerBackend: 'none' | 'openai' | 'dashscope' | 'deepseek';
}

辅助函数:resolveConfig() / getProjectDir() / getDbPath() / getSessionDir() / ensureDirs()

配置参考

环境变量

变量默认值说明
ONLYMEM_PROJECTdefault项目标识
ONLYMEM_DATA_DIR~/.onlymem数据存储目录
SQL_JS_WASM_PATH自动探测sql.js WASM 文件路径

Harness patch 配置

通过 profile 的 cordis.patch.yml 覆盖:

- set:
    id: memory-onlymemory
    config:
      serverName: only_memory
      env:
        ONLYMEM_PROJECT: my-project
        ONLYMEM_DATA_DIR: /custom/data/path

Harness patch 配置

通过 profile 的 cordis.patch.yml 覆盖:

- set:
    id: memory-onlymemory
    config:
      serverName: only_memory
      env:
        ONLYMEM_PROJECT: my-project
        ONLYMEM_DATA_DIR: /custom/data/path