forge-memory

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/forge-memory — FORGE Vector Memory

Outil de diagnostic pour l'index vectoriel de la mémoire FORGE. Les commandes FORGE utilisent automatiquement la recherche vectorielle ; ce skill est pour le diagnostic et la maintenance.

FORGE内存向量索引的诊断工具。 FORGE的各类命令会自动使用向量搜索；本Skill用于诊断和维护操作。

French Language Rule

法语语言规则

All content generated in French MUST use proper accents (é, è, ê, à, ù, ç, ô, î, etc.), follow French grammar rules (agreements, conjugations), and use correct spelling.

所有生成的法语内容必须使用正确的重音符号（é, è, ê, à, ù, ç, ô, î等），遵循法语语法规则（性数配合、动词变位等），并使用正确拼写。

Prérequis

前提条件

Le système doit être installé :

bash

bash ~/.claude/scripts/forge-memory/setup.sh

需先安装系统：

bash

bash ~/.claude/scripts/forge-memory/setup.sh

Commandes

命令

Synchroniser l'index

同步索引

Synchronise les fichiers Markdown vers la base SQLite :

bash

~/.claude/scripts/forge-memory/forge-memory sync [--force] [--verbose]

Sans
```
--force
```
: réindexe uniquement les fichiers modifiés (basé sur le hash SHA-256)
Avec
```
--force
```
: réindexe tous les fichiers
Avec
```
--verbose
```
: affiche le détail de chaque fichier traité

将Markdown文件同步至SQLite数据库：

bash

~/.claude/scripts/forge-memory/forge-memory sync [--force] [--verbose]

不带
```
--force
```
：仅重新索引已修改的文件（基于SHA-256哈希值）
带
```
--force
```
：重新索引所有文件
带
```
--verbose
```
：显示每个文件的处理详情

Rechercher

搜索

Recherche hybride (vectorielle + texte) dans la mémoire :

bash

~/.claude/scripts/forge-memory/forge-memory search "query" [--namespace all|project|session|agent] [--agent NAME] [--limit 5] [--threshold 0.3] [--pretty]

```
--namespace
```
: filtrer par type (project = MEMORY.md, session = logs, agent = mémoires d'agent)
```
--agent
```
: filtrer par nom d'agent (pm, architect, dev, qa)
```
--limit
```
: nombre max de résultats (défaut: 5)
```
--threshold
```
: score minimum (défaut: 0.3)
```
--pretty
```
: affichage formaté (sinon JSON)

在内存中执行混合搜索（向量+文本）：

bash

~/.claude/scripts/forge-memory/forge-memory search "query" [--namespace all|project|session|agent] [--agent NAME] [--limit 5] [--threshold 0.3] [--pretty]

```
--namespace
```
：按类型过滤（project = MEMORY.md，session = 日志，agent = Agent内存）
```
--agent
```
：按Agent名称过滤（pm、architect、dev、qa）
```
--limit
```
：最大结果数量（默认：5）
```
--threshold
```
：最低匹配分数（默认：0.3）
```
--pretty
```
：格式化显示（否则为JSON格式）

Statut

状态查询

Affiche les statistiques de l'index :

bash

~/.claude/scripts/forge-memory/forge-memory status [--json]

显示索引的统计信息：

bash

~/.claude/scripts/forge-memory/forge-memory status [--json]

Réinitialiser

重置

Supprime et recrée la base de données :

bash

~/.claude/scripts/forge-memory/forge-memory reset --confirm

删除并重新创建数据库：

bash

~/.claude/scripts/forge-memory/forge-memory reset --confirm

Architecture

架构

.forge/memory/
  MEMORY.md              <- source de vérité (écrit par les agents)
  sessions/YYYY-MM-DD.md <- source de vérité (écrit par les agents)
  agents/{agent}.md      <- source de vérité (écrit par les agents)
  index.sqlite           <- index dérivé (synchronisé depuis les .md)

Synchronisation unidirectionnelle : Markdown -> SQLite
Auto-sync avant chaque recherche (vérifie les changements)
Recherche hybride : similarité vectorielle (70%) + FTS5 BM25 (30%)
Embeddings locaux : sentence-transformers all-MiniLM-L6-v2 (384 dimensions)
Chunking markdown-aware : ~400 tokens/chunk, 80 tokens overlap

.forge/memory/
  MEMORY.md              <- 可信数据源（由Agents编写）
  sessions/YYYY-MM-DD.md <- 可信数据源（由Agents编写）
  agents/{agent}.md      <- 可信数据源（由Agents编写）
  index.sqlite           <- 派生索引（从.md文件同步而来）

单向同步：Markdown -> SQLite
每次搜索前自动同步（检测变更）
混合搜索：向量相似度（70%） + FTS5 BM25（30%）
本地Embeddings：sentence-transformers all-MiniLM-L6-v2（384维度）
Markdown感知分块：约400 tokens/块，80 tokens重叠