structured-memory-engine

分类: 工具与效率 | 上传者: Bryptobricks | 下载: 0 | 版本: v1.0（最新）

Structured memory system for AI workspaces. Indexes markdown memory files into SQLite FTS5 for fast, cited search. Extracts structured facts, maintains memory health, and provides an MCP server with live search + write-path for Claude Code integration. --- # Structured Memory Engine ## MCP Tools (v4) When running as an MCP server (`node lib/mcp-server.js`), exposes: - `sme_query` — Search memory. Supports `query`, `limit`, `since`, `type`, `minConfidence`, `includeStale`. - `sme_context` — Get relevant context for a message. Returns ranked, token-budgeted, formatted context for injection. Supports `message`, `maxTokens`. - `sme_remember` — Save a fact/decision/preference to today's memory log. Auto-indexed. - `sme_index` — Re-index workspace. Use `force: true` for full rebuild. - `sme_reflect` — Run maintenance: decay, reinforce, stale detection, contradictions, prune. Use `dryRun: true` to preview. - `sme_status` — Index statistics. ## CLI Commands ```bash # Index workspace memory files node lib/index.js index [--workspace PATH] [--force] [--include extra.md,other.md] # Search indexed memory node lib/index.js query "search terms" [--limit N] [--since 7d|2w|3m|2026-01-01] [--context N] [--type fact|confirmed|inferred|...] [--min-confidence 0.5] [--include-stale] # Show index status node lib/index.js status [--workspace PATH] # Memory maintenance node lib/index.js reflect [--workspace PATH] [--dry-run] node lib/index.js contradictions [--workspace PATH] [--unresolved] node lib/index.js archived [--workspace PATH] [--limit N] node lib/index.js restore <chunk-id> [--workspace PATH] ``` ## Configuration

更新日志: Source: GitHub https://github.com/Bryptobricks/Structured-Memory-Engine

目录结构

当前层级: 根目录

📁 benchmarks/
- 📄 run.js 16.1 KB
📁 bin/
- 📄 sme-hook.js 1.5 KB
📁 data/
- 📄 sme-init-spec.md 4.1 KB
- 📄 sme-v6.10.1-spec.md 7.7 KB
- 📄 sme-v6.9-spec.md 9.0 KB
📁 examples/
- 📄 aliases.json 295 B
- 📄 config.json 413 B
📁 extensions/
- 📁 memory-sme/
  - 📄 index.ts 12.8 KB
  - 📄 openclaw.plugin.json 1.3 KB
  - 📄 package.json 329 B
  - 📄 README.md 4.5 KB
📁 lib/
- 📁 ingest/
  - 📄 csv.js 6.0 KB
  - 📄 index.js 372 B
  - 📄 sync.js 3.6 KB
  - 📄 transcripts.js 6.6 KB
- 📄 api.js 7.7 KB
- 📄 config.js 9.0 KB
- 📄 context.js 20.1 KB
- 📄 dedup.js 5.9 KB
- 📄 embeddings.js 5.5 KB
- 📄 entities.js 4.8 KB
- 📄 index.js 22.9 KB
- 📄 indexer.js 12.8 KB
- 📄 mcp-server.js 32.0 KB
- 📄 quality-gate.js 2.4 KB
- 📄 query-features.js 3.3 KB
- 📄 query-strip.js 1.6 KB
- 📄 recall-logger.js 4.4 KB
- 📄 recall.js 6.4 KB
- 📄 reflect.js 24.1 KB
- 📄 remember.js 2.5 KB
- 📄 retain.js 4.8 KB
- 📄 retrieve.js 18.5 KB
- 📄 scoring.js 7.0 KB
- 📄 store.js 10.8 KB
- 📄 temporal-freshness.js 3.2 KB
- 📄 temporal.js 11.8 KB
- 📄 value-scoring.js 4.1 KB
📁 scripts/
- 📄 recall-test.js 4.9 KB
📁 skills/
- 📁 structured-memory-engine/
  - 📁 scripts/
    
    📄 sme-query.sh 296 B
    
    📄 sme-reflect.sh 291 B
    
    📄 sme-remember.js 972 B
    
    📄 sme-status.sh 292 B
  - 📄 SKILL.md 2.9 KB
📁 test/
- 📄 test-api.js 13.6 KB
- 📄 test-config.js 16.1 KB
- 📄 test-context.js 36.7 KB
- 📄 test-dedup.js 8.3 KB
- 📄 test-embeddings.js 10.9 KB
- 📄 test-entities.js 10.5 KB
- 📄 test-indexer.js 24.5 KB
- 📄 test-ingest.js 11.6 KB
- 📄 test-mcp.js 20.9 KB
- 📄 test-noise-penalty.js 4.5 KB
- 📄 test-plugin-hooks.js 8.9 KB
- 📄 test-quality-gate.js 4.0 KB
- 📄 test-query-strip.js 7.6 KB
- 📄 test-recall-entity.js 4.8 KB
- 📄 test-recall-logger.js 10.2 KB
- 📄 test-recall.js 32.3 KB
- 📄 test-reflect.js 33.7 KB
- 📄 test-remember.js 11.3 KB
- 📄 test-retain.js 6.1 KB
- 📄 test-retrieve.js 10.0 KB
- 📄 test-scoring.js 23.4 KB
- 📄 test-store.js 17.3 KB
- 📄 test-temporal-freshness.js 5.3 KB
- 📄 test-temporal.js 26.7 KB
- 📄 test-value-scoring.js 5.8 KB
📁 test-fixture/
- 📁 memory/
  - 📄 2026-02-23.md 115 B
- 📄 MEMORY.md 149 B
📄 .gitignore 50 B
📄 .npmignore 241 B
📄 CHANGELOG.md 1.4 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 54.8 KB
📄 package.json 2.2 KB
📄 README.md 25.8 KB
📄 ROADMAP.md 7.1 KB
📄 SKILL.md 3.2 KB

SKILL.md

---
name: structured-memory-engine
description: >
  Structured memory system for AI workspaces. Indexes markdown memory files into SQLite FTS5
  for fast, cited search. Extracts structured facts, maintains memory health, and provides
  an MCP server with live search + write-path for Claude Code integration.
---

# Structured Memory Engine

## MCP Tools (v4)

When running as an MCP server (`node lib/mcp-server.js`), exposes:

- `sme_query` — Search memory. Supports `query`, `limit`, `since`, `type`, `minConfidence`, `includeStale`.
- `sme_context` — Get relevant context for a message. Returns ranked, token-budgeted, formatted context for injection. Supports `message`, `maxTokens`.
- `sme_remember` — Save a fact/decision/preference to today's memory log. Auto-indexed.
- `sme_index` — Re-index workspace. Use `force: true` for full rebuild.
- `sme_reflect` — Run maintenance: decay, reinforce, stale detection, contradictions, prune. Use `dryRun: true` to preview.
- `sme_status` — Index statistics.

## CLI Commands

```bash
# Index workspace memory files
node lib/index.js index [--workspace PATH] [--force] [--include extra.md,other.md]

# Search indexed memory
node lib/index.js query "search terms" [--limit N] [--since 7d|2w|3m|2026-01-01]
                                        [--context N] [--type fact|confirmed|inferred|...]
                                        [--min-confidence 0.5] [--include-stale]

# Show index status
node lib/index.js status [--workspace PATH]

# Memory maintenance
node lib/index.js reflect [--workspace PATH] [--dry-run]
node lib/index.js contradictions [--workspace PATH] [--unresolved]
node lib/index.js archived [--workspace PATH] [--limit N]
node lib/index.js restore <chunk-id> [--workspace PATH]
```

## Configuration

Config file: `{workspace}/.memory/config.json`

```json
{
  "owner": "Alex",
  "include": ["CLAUDE.md", "TOOLS.md"],
  "includeGlobs": ["agents/*.md", "skills/*.md", "plans/*.md"],
  "fileTypeDefaults": {
    "MEMORY.md": "confirmed",
    "USER.md": "confirmed",
    "memory/*.md": "fact",
    "plans/*.md": "inferred"
  }
}
```

- `owner` — Personalizes MCP tool descriptions
- `include` — Explicit file paths to index beyond defaults
- `includeGlobs` — Glob patterns for additional files
- `fileTypeDefaults` — Map file patterns to chunk types (activates confidence system without inline tags)

## Fact Tagging

```markdown
[fact] Content here        → type: fact, confidence: 1.0
[decision] Content here    → type: decision, confidence: 1.0
[pref] Content here        → type: preference, confidence: 1.0
[confirmed] Content here   → type: confirmed, confidence: 1.0
[opinion] Content here     → type: opinion, confidence: 0.8
[inferred] Content here    → type: inferred, confidence: 0.7
[outdated?] Content here   → type: outdated, confidence: 0.3
```

Untagged bullets under `## Decisions`, `## Facts`, `## Preferences`, `## Learned`, `## Open Questions` headings are auto-classified (confidence: 0.9).

## Session Hooks

For auto-index on session start and reflect on session end:

```bash
# Index hook (session start)
node bin/sme-hook.js index

# Reflect hook (session end)
node bin/sme-hook.js reflect
```

Set `SME_WORKSPACE` env var to override the default workspace (`~/.claude`).

登录后下载/点赞/收藏 ❤ 7 | ★ 0

structured-memory-engine

目录结构

SKILL.md

举报内容

提示