structured-memory-engine

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

AI 工作空间的结构化内存系统。将 Markdown 内存文件索引到 SQLite FTS5 中，以进行快速引用搜索。提取结构化事实，维护内存健康状况，并为 MCP 服务器提供用于 Claude Code 集成的实时搜索 + 写入路径。 --- # 结构化内存引擎 ## MCP 工具 (v4) 当作为 MCP 服务器运行时 (`node lib/mcp-server.js`)，公开： - `sme_query` — 搜索内存。支持`query`、`limit`、`since`、`type`、`minConfidence`、`includeStale`。 - `sme_context` — 获取消息的相关上下文。返回排序的、令牌预算的、格式化的上下文以进行注入。支持 `message`、`maxTokens`。 - `sme_remember` — 将事实/决定/偏好保存到今天的内存日志中。自动索引。 - `sme_index` — 重新索引工作区。使用“force: true”进行完全重建。 - `sme_reflect` — 运行维护：衰减、强化、陈旧检测、矛盾、修剪。使用 `dryRun: true` 进行预览。 - `sme_status` — 索引统计信息。 ## CLI 命令 ```bash # 索引工作区内存文件节点 lib/index.js index [--workspace PATH] [--force] [--include extra.md,other.md] # 搜索索引内存节点 lib/index.js 查询“search terms” [--limit N] [--since 7d|2w|3m|2026-01-01] [--context N] [--type fact|confirmed|inferred|...] [--min-confidence 0.5] [--include-stale] # 显示索引状态 node lib/index.js status [--workspace PATH] # 内存维护节点 lib/index.js 反映 [--workspace PATH] [--dry-run] node lib/index.js 矛盾 [--workspace PATH] [--unresolved] node lib/index.js archived [--workspace PATH] [--limit N] node lib/index.js Restore <chunk-id> [--workspace PATH] ``` ## 配置

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

目录结构

当前层级: tree/main/

📁 assets/
- 📄 banner.jpg 62.1 KB
📁 benchmarks/
- 📄 run.js 16.1 KB
📁 bin/
- 📄 sme-hook.js 1.5 KB
📁 examples/
- 📄 aliases.json 295 B
- 📄 config.json 413 B
📁 extensions/
- 📁 memory-sme/
  - 📄 index.ts 13.9 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
- 📄 benchmark.js 2.3 KB
- 📄 config.js 9.4 KB
- 📄 context.js 20.8 KB
- 📄 dedup.js 5.9 KB
- 📄 diversity.js 1.9 KB
- 📄 embeddings.js 5.5 KB
- 📄 entities.js 4.8 KB
- 📄 index.js 24.1 KB
- 📄 indexer.js 17.2 KB
- 📄 mcp-server.js 36.2 KB
- 📄 promote.js 3.2 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 7.0 KB
- 📄 reflect.js 29.6 KB
- 📄 remember.js 2.5 KB
- 📄 retain.js 4.8 KB
- 📄 retrieve.js 22.0 KB
- 📄 scoring.js 9.9 KB
- 📄 store.js 13.1 KB
- 📄 synonym-expansion.js 3.1 KB
- 📄 temporal-freshness.js 3.2 KB
- 📄 temporal.js 19.4 KB
- 📄 value-scoring.js 5.6 KB
📁 scripts/
- 📄 recall-test.js 5.0 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/
- 📄 benchmark-suite.json 1.8 KB
- 📄 test-api.js 13.6 KB
- 📄 test-benchmark.js 4.1 KB
- 📄 test-chunk-similarity.js 3.2 KB
- 📄 test-config.js 16.1 KB
- 📄 test-context.js 37.2 KB
- 📄 test-dedup.js 8.3 KB
- 📄 test-diversity.js 5.7 KB
- 📄 test-embeddings.js 11.4 KB
- 📄 test-entities.js 11.1 KB
- 📄 test-freshness-index.js 7.1 KB
- 📄 test-indexer.js 29.6 KB
- 📄 test-ingest.js 11.6 KB
- 📄 test-mcp.js 22.4 KB
- 📄 test-noise-penalty.js 4.5 KB
- 📄 test-plugin-hooks.js 9.5 KB
- 📄 test-priority-classification.js 4.3 KB
- 📄 test-priority-scoring.js 4.1 KB
- 📄 test-promote.js 7.1 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.8 KB
- 📄 test-recall.js 32.9 KB
- 📄 test-reflect.js 36.7 KB
- 📄 test-remember.js 11.8 KB
- 📄 test-restructure-integration.js 5.4 KB
- 📄 test-retain.js 6.1 KB
- 📄 test-retrieve.js 15.9 KB
- 📄 test-scoring.js 26.4 KB
- 📄 test-store.js 22.0 KB
- 📄 test-supersession.js 6.8 KB
- 📄 test-synonym-expansion.js 4.8 KB
- 📄 test-temporal-extraction.js 5.6 KB
- 📄 test-temporal-freshness.js 5.3 KB
- 📄 test-temporal-scoring.js 4.8 KB
- 📄 test-temporal.js 32.5 KB
- 📄 test-value-scoring.js 5.8 KB
📁 test-fixture/
- 📁 memory/
  - 📄 2026-02-23.md 115 B
- 📄 MEMORY.md 149 B
📄 .gitignore 78 B
📄 .npmignore 241 B
📄 CHANGELOG.md 1.4 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 54.8 KB
📄 package.json 2.7 KB
📄 README.md 27.6 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`).

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

structured-memory-engine

目录结构

SKILL.md

举报内容

提示