dsh-prime-memory 0.26.10 → 0.26.12

package/INSTALL.de.md

@@ -0,0 +1,92 @@
+# Installationsanleitung (dsh-prime-memory)
+
+Dieses Plugin wird als **offizielles DSH-Bundle** ausgeliefert: Nach der Installation mountet die `dsh.bundle`-Schicht in `cordis.patch.yml` den Plugin-Eintrag automatisch — manuelle Profilbearbeitung ist nicht erforderlich.
+
+## Voraussetzungen
+
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 oder neuer)
+- DeepSeek Harness (im Folgenden DSH) installiert, mit verfügbarem `--profile web`
+
+## Installation
+
+Wählen Sie eine der folgenden Aufrufarten (das Präfix `npx` kann in jedem der folgenden Befehle `dsh` ersetzen):
+
+```bash
+# Variante 1: offizielle CLI direkt per npx ausführen (kein vorinstalliertes dsh nötig; Version kann gepinnt werden, z. B. dsh-prime-memory@0.8.4)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# Variante 2: mit installierter dsh-CLI (dsh ist ein pnpm-Forwarder; falls pnpm fehlt, zuerst npm i -g pnpm)
+dsh plugin --profile web add dsh-prime-memory
+
+# Alternative Paketquellen: GitHub-Repository / lokaler Pfad (Entwicklung/Debug; link: verweist auf das Repository, npm run build + dsh-Neustart genügt)
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Installation durch den Agenten (empfohlen)
+
+Senden Sie die folgende Nachricht unverändert an den aktuellen Agenten (sofern er Terminalbefehle ausführen kann):
+
+```text
+Bitte installiere das Plugin dsh-prime-memory für das Web-Profil von DeepSeek Harness.
+
+Führe ausschließlich die beiden folgenden Befehle aus und ändere keine anderen Profile:
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+Sobald dsh-prime-memory in der Ausgabe erscheint, melde mir das Installationsergebnis.
+Beende oder starte den laufenden DSH nicht selbst neu; erinnere mich nach der Installation daran, den DSH Web Host manuell neu zu starten.
+```
+
+## Update
+
+```bash
+# Auf die neueste Version aktualisieren
+dsh plugin --profile web update dsh-prime-memory
+
+# Auf eine bestimmte Version aktualisieren
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+Ein Update ersetzt nur den Plugin-Code und die `dist/`-Artefakte; das Datenverzeichnis `~/.dsh/memory/` bleibt unberührt.
+
+## Verifikation
+
+Prüfen Sie nach der Installation und dem Neustart des DSH Web Host:
+
+1. **Das Datenverzeichnis entsteht** — das Plugin wurde erfolgreich angewendet: unter `~/.dsh/memory/` erscheinen die Verzeichnisse `conversations/`, `records/`, `scenes/` sowie `memory.db`;
+2. **Die Seite „Memory" erscheint in den Einstellungen** und das Modus-Pill erscheint in der Eingabeleiste — die Client-Hälfte ist bereit;
+3. Schicken Sie eine Nachricht mit persönlichen Informationen, warten Sie die Destillation ab und fragen Sie in einem späteren Zug danach: Im Kontext sollte die Zeile „Kontextinjektion · memory" erscheinen.
+
+Optionaler Rauchtest (Entwicklung/Fehlerdiagnose):
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## Migration / Downgrade
+
+- **Migration von der alten Version (vor 0.5.0 hieß das Paket `dsh-memory-plugin`)**: Das alte Datenverzeichnis ist mit dem neuen Paket inkompatibel; sichern Sie es und löschen Sie `~/.dsh/memory/` — es wird beim ersten Start des neuen Plugins neu aufgebaut. Bestehende Erinnerungen können nicht direkt übernommen werden, sie müssen neu destilliert werden.
+- **Zurück zur alten Version**: Nach `dsh plugin --profile web remove dsh-prime-memory` gemäß der Dokumentation der alten Version neu installieren; das Datenverzeichnis bleibt erhalten, aber die alte Version erkennt die neue Struktur nicht — eine Bereinigung wird empfohlen.
+
+## Deinstallation
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+Die Daten bleiben in `~/.dsh/memory/`; löschen Sie bei Bedarf das gesamte Verzeichnis von Hand.
+
+## Fehlerbehebung
+
+| Symptom | Wahrscheinliche Ursache | Lösung |
+| --- | --- | --- |
+| Nach der Installation fehlt die Seite „Memory" in den Einstellungen | DSH nicht neu gestartet / Bundle nicht gemountet | DSH Web Host neu starten; mit `dsh --profile web --dump-config` prüfen, dass `dsh-prime-memory` enthalten ist |
+| `duplicate loader entry id` beim Neustart | ein manuell hinzugefügtes `insert:` kollidiert mit dem Bundle-Eintrag gleicher id | Das manuell hinzugefügte `insert:`-Element entfernen; das Paket bringt seine Bundle-Schicht bereits mit |
+| Keine Zeile „Kontextinjektion · memory" | Destillation nicht gelaufen / Recall deaktiviert | Prüfen, dass der Modus nicht off und `recall.enabled=true` ist; in `memory.log` nach `L1 阶段完成` suchen |
+| Download des lokalen Embedding-Modells hängt | Mirror direkt nicht erreichbar | `embedding.proxy` setzen, um über einen Proxy zu gehen; oder `embedding.mirror` auf das offizielle `huggingface.co` umstellen |
+| Remote-Embedding meldet 401 | apiKey falsch / schlüsselloser Dienst darf keinen Key erhalten | `embedding.apiKey` prüfen; bei einem selbst gehosteten Dienst ohne Key apiKey leer lassen |
+
+Mehr dazu in [README.md](./README.md) und [CHANGELOG.md](./CHANGELOG.md).

package/INSTALL.es.md

@@ -0,0 +1,92 @@
+# Guía de instalación (dsh-prime-memory)
+
+Este plugin se distribuye como **bundle oficial de DSH**: tras la instalación, la capa `dsh.bundle` de `cordis.patch.yml` monta automáticamente la entrada del plugin; no hace falta editar a mano ningún perfil.
+
+## Requisitos
+
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 o superior)
+- DeepSeek Harness (en adelante DSH) instalado, con `--profile web` disponible
+
+## Instalación
+
+Elige el modo de invocación que prefieras (el prefijo `npx` puede sustituir a `dsh` en cualquiera de los comandos siguientes):
+
+```bash
+# Modo 1: ejecutar la CLI oficial directamente con npx (no requiere dsh preinstalado; se puede fijar la versión, p. ej. dsh-prime-memory@0.8.4)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# Modo 2: con la CLI dsh ya instalada (dsh es un reenviador de pnpm; si no tienes pnpm, antes npm i -g pnpm)
+dsh plugin --profile web add dsh-prime-memory
+
+# Fuentes alternativas del paquete: repositorio de GitHub / ruta local (desarrollo y depuración; link: apunta al repositorio, basta npm run build + reiniciar dsh)
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Dejar que el agente instale (recomendado)
+
+Envía tal cual el siguiente mensaje al agente actual (siempre que pueda ejecutar comandos de terminal):
+
+```text
+Instala el plugin dsh-prime-memory para el perfil web de DeepSeek Harness.
+
+Ejecuta solo los dos comandos siguientes y no modifiques otros perfiles:
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+Cuando aparezca dsh-prime-memory en la salida, infórmame del resultado de la instalación.
+No cierres ni reinicies por tu cuenta el DSH en ejecución; cuando termine la instalación, recuérdame que reinicie manualmente el DSH Web Host.
+```
+
+## Actualización
+
+```bash
+# Actualizar a la última versión
+dsh plugin --profile web update dsh-prime-memory
+
+# Actualizar a una versión concreta
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+La actualización solo reemplaza el código del plugin y los artefactos de `dist/`; el directorio de datos `~/.dsh/memory/` no se ve afectado.
+
+## Verificación
+
+Tras instalar y reiniciar el DSH Web Host, comprueba:
+
+1. **Aparece el directorio de datos** — el plugin se aplicó correctamente: bajo `~/.dsh/memory/` aparecen los directorios `conversations/`, `records/`, `scenes/` y el archivo `memory.db`;
+2. **Aparece la página «Memoria» en los ajustes** y en la barra de entrada aparece la píldora de modo — la mitad cliente está lista;
+3. Envía un mensaje con información personal, espera a que termine la destilación y pregunta por ello en otro turno de conversación: en el contexto debería verse la línea «Inyección de contexto · memory».
+
+Smoke test opcional (desarrollo/diagnóstico):
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## Migración / retroceso
+
+- **Migrar desde la versión antigua (antes de 0.5.0 se llamaba `dsh-memory-plugin`)**: el directorio de datos antiguo es incompatible con el paquete nuevo; haz una copia de seguridad y borra `~/.dsh/memory/`, el nuevo plugin la reconstruirá en su primer arranque. Las memorias existentes no se pueden actualizar directamente: hay que volver a destilarlas.
+- **Volver a la versión antigua**: tras `dsh plugin --profile web remove dsh-prime-memory`, reinstala siguiendo la documentación de la versión antigua; el directorio de datos se conserva, pero la versión antigua no reconoce la nueva estructura; conviene limpiarlo.
+
+## Desinstalación
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+Los datos permanecen en `~/.dsh/memory/`; si ya no los necesitas, borra todo el directorio a mano.
+
+## Resolución de problemas
+
+| Síntoma | Causa probable | Solución |
+| --- | --- | --- |
+| Tras la instalación no aparece la página «Memoria» en los ajustes | DSH sin reiniciar / bundle sin montar | Reinicia el DSH Web Host; con `dsh --profile web --dump-config` comprueba que aparece `dsh-prime-memory` |
+| `duplicate loader entry id` al reiniciar | un `insert:` añadido a mano convive con la entrada bundle del mismo id | Elimina la entrada `insert:` añadida manualmente; el paquete ya incluye su propia capa bundle |
+| No aparece la línea «Inyección de contexto · memory» | destilación sin ejecutar / recuerdo desactivado | Comprueba que el modo no es off y que `recall.enabled=true`; busca `L1 阶段完成` en `memory.log` |
+| La descarga del modelo de embeddings local se queda colgada | el espejo no es accesible en conexión directa | Configura `embedding.proxy` para salir por un proxy; o cambia `embedding.mirror` al oficial `huggingface.co` |
+| El embedding remoto da error 401 | apiKey errónea / servicio sin clave al que no hay que enviarla | Revisa `embedding.apiKey`; en un servicio autoalojado sin clave deja apiKey vacía |
+
+Para más información, consulta [README.md](./README.md) y [CHANGELOG.md](./CHANGELOG.md).

package/INSTALL.fr.md

@@ -0,0 +1,92 @@
+# Guide d'installation (dsh-prime-memory)
+
+Ce plugin est distribué sous forme de **bundle officiel DSH** : après l'installation, la couche `dsh.bundle` de `cordis.patch.yml` monte automatiquement l'entrée du plugin — aucune modification manuelle du profil n'est nécessaire.
+
+## Prérequis
+
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 ou supérieur)
+- DeepSeek Harness (ci-après DSH) installé, avec `--profile web` disponible
+
+## Installation
+
+Choisissez librement l'un des modes d'invocation suivants (le préfixe `npx` peut remplacer `dsh` dans n'importe laquelle des commandes ci-dessous) :
+
+```bash
+# Méthode 1 : lancer le CLI officiel directement via npx (pas besoin d'installer dsh au préalable ; la version peut être épinglée, ex. dsh-prime-memory@0.8.4)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# Méthode 2 : avec le CLI dsh installé (dsh est un relais pnpm ; si pnpm manque, commencez par npm i -g pnpm)
+dsh plugin --profile web add dsh-prime-memory
+
+# Sources de paquets alternatives : dépôt GitHub / chemin local (développement/débogage ; link: pointe vers le dépôt, npm run build + redémarrage de dsh suffisent)
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Laisser l'agent installer (recommandé)
+
+Envoyez tel quel le message ci-dessous à l'agent actuel (du moment qu'il peut exécuter des commandes de terminal) :
+
+```text
+Veuillez installer le plugin dsh-prime-memory pour le profil web de DeepSeek Harness.
+
+Exécutez uniquement les deux commandes suivantes, sans modifier d'autres profils :
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+Une fois que dsh-prime-memory apparaît dans la sortie, confirmez-moi le résultat de l'installation.
+Ne fermez pas et ne redémarrez pas vous-même le DSH en cours d'exécution ; après l'installation, rappelez-moi de redémarrer manuellement le DSH Web Host.
+```
+
+## Mise à jour
+
+```bash
+# Mettre à jour vers la dernière version
+dsh plugin --profile web update dsh-prime-memory
+
+# Mettre à jour vers une version donnée
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+La mise à jour ne remplace que le code du plugin et les artefacts de `dist/` ; le répertoire de données `~/.dsh/memory/` n'est pas affecté.
+
+## Vérification
+
+Après l'installation et le redémarrage du DSH Web Host, vérifiez :
+
+1. **Le répertoire de données apparaît** — le plugin s'est appliqué avec succès : sous `~/.dsh/memory/` apparaissent les répertoires `conversations/`, `records/`, `scenes/` ainsi que `memory.db` ;
+2. **La page « Mémoire » apparaît dans les paramètres** et le pill de mode s'affiche dans la barre de saisie — la moitié client est prête ;
+3. Envoyez un message contenant des informations personnelles, attendez la fin de la distillation, puis demandez ces informations dans un autre tour de conversation : la ligne « Injection de contexte · memory » doit apparaître dans le contexte.
+
+Test de fumée optionnel (développement/diagnostic) :
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## Migration / retour à une version antérieure
+
+- **Migration depuis l'ancienne version (nommée `dsh-memory-plugin` avant le 0.5.0)** : l'ancien répertoire de données est incompatible avec le nouveau paquet ; sauvegardez puis supprimez `~/.dsh/memory/`, il sera reconstruit au premier démarrage du nouveau plugin. Les mémoires existantes ne peuvent pas être mises à niveau directement, une re-distillation est nécessaire.
+- **Revenir à l'ancienne version** : après `dsh plugin --profile web remove dsh-prime-memory`, réinstallez en suivant la documentation de l'ancienne version ; le répertoire de données est conservé, mais l'ancienne version ne reconnaît pas la nouvelle structure — un nettoyage est recommandé.
+
+## Désinstallation
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+Les données restent dans `~/.dsh/memory/` ; supprimez manuellement tout le répertoire si vous n'en avez plus besoin.
+
+## Dépannage
+
+| Symptôme | Cause probable | Solution |
+| --- | --- | --- |
+| Aucune page « Mémoire » dans les paramètres après l'installation | DSH non redémarré / bundle non monté | Redémarrez le DSH Web Host ; vérifiez avec `dsh --profile web --dump-config` que `dsh-prime-memory` figure bien dans la configuration |
+| `duplicate loader entry id` au redémarrage | un `insert:` ajouté manuellement coexiste avec l'entrée bundle de même id | Supprimez l'entrée `insert:` ajoutée à la main ; ce paquet embarque déjà sa couche bundle |
+| Aucune ligne « Injection de contexte · memory » | distillation non exécutée / rappel désactivé | Vérifiez que le mode n'est pas off et que `recall.enabled=true` ; cherchez `L1 阶段完成` dans `memory.log` |
+| Téléchargement du modèle d'embedding local bloqué | miroir inaccessible en connexion directe | Configurez `embedding.proxy` pour passer par un proxy ; ou remplacez `embedding.mirror` par l'officiel `huggingface.co` |
+| Erreur 401 de l'embedding distant | apiKey erronée / service sans clé auquel il ne faut pas en envoyer | Vérifiez `embedding.apiKey` ; laissez apiKey vide pour un service auto-hébergé sans clé |
+
+Pour aller plus loin, voir [README.md](./README.md) et [CHANGELOG.md](./CHANGELOG.md).

package/INSTALL.it.md

@@ -0,0 +1,92 @@
+# Guida all'installazione (dsh-prime-memory)
+
+Questo plugin è distribuito come **bundle ufficiale DSH**: dopo l'installazione, il livello `dsh.bundle` di `cordis.patch.yml` monta automaticamente la voce del plugin — non serve modificare a mano alcun profilo.
+
+## Requisiti
+
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 o superiore)
+- DeepSeek Harness (di seguito DSH) installato, con `--profile web` disponibile
+
+## Installazione
+
+Scegli liberamente uno dei modi di invocazione seguenti (il prefisso `npx` può sostituire `dsh` in qualsiasi comando qui sotto):
+
+```bash
+# Modo 1: eseguire la CLI ufficiale direttamente con npx (niente dsh preinstallato; la versione può essere fissata, es. dsh-prime-memory@0.8.4)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# Modo 2: con la CLI dsh già installata (dsh è un inoltratore pnpm; se pnpm manca, prima npm i -g pnpm)
+dsh plugin --profile web add dsh-prime-memory
+
+# Sorgenti alternative del pacchetto: repository GitHub / percorso locale (sviluppo/debug; link: punta al repository, bastano npm run build + riavvio di dsh)
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Far installare dall'agente (consigliato)
+
+Invia tale e quale il messaggio seguente all'agente attuale (purché possa eseguire comandi da terminale):
+
+```text
+Installa il plugin dsh-prime-memory per il profilo web di DeepSeek Harness.
+
+Esegui solo i due comandi seguenti e non modificare altri profili:
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+Quando dsh-prime-memory compare nell'output, comunicami l'esito dell'installazione.
+Non chiudere o riavviare di tua iniziativa il DSH in esecuzione; a installazione completata, ricordami di riavviare manualmente il DSH Web Host.
+```
+
+## Aggiornamento
+
+```bash
+# Aggiornare all'ultima versione
+dsh plugin --profile web update dsh-prime-memory
+
+# Aggiornare a una versione specifica
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+L'aggiornamento sostituisce solo il codice del plugin e gli artefatti in `dist/`; la directory dei dati `~/.dsh/memory/` non viene toccata.
+
+## Verifica
+
+Dopo l'installazione e il riavvio del DSH Web Host, controlla:
+
+1. **Compare la directory dei dati** — il plugin è stato applicato con successo: sotto `~/.dsh/memory/` compaiono le directory `conversations/`, `records/`, `scenes/` e il file `memory.db`;
+2. **La pagina «Memoria» compare nelle impostazioni** e il pill di modalità compare nella barra di input — la metà client è pronta;
+3. Invia un messaggio con informazioni personali, attendi la fine della distillazione e poi chiedine conto in un altro turno di conversazione: nel contesto dovrebbe comparire la riga «Iniezione di contesto · memory».
+
+Smoke test opzionale (sviluppo/diagnostica):
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## Migrazione / downgrade
+
+- **Migrazione dalla vecchia versione (chiamata `dsh-memory-plugin` prima del 0.5.0)**: la vecchia directory dei dati è incompatibile col nuovo pacchetto; fai un backup e poi elimina `~/.dsh/memory/`, verrà ricostruita al primo avvio del nuovo plugin. Le memorie esistenti non possono essere aggiornate direttamente: serve una nuova distillazione.
+- **Tornare alla vecchia versione**: dopo `dsh plugin --profile web remove dsh-prime-memory` reinstalla seguendo la documentazione della vecchia versione; la directory dei dati resta, ma la vecchia versione non riconosce la nuova struttura — si consiglia di ripulirla.
+
+## Disinstallazione
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+I dati restano in `~/.dsh/memory/`; se non servono più, elimina a mano l'intera directory.
+
+## Risoluzione dei problemi
+
+| Sintomo | Causa probabile | Rimedio |
+| --- | --- | --- |
+| Dopo l'installazione manca la pagina «Memoria» nelle impostazioni | DSH non riavviato / bundle non montato | Riavvia il DSH Web Host; verifica con `dsh --profile web --dump-config` che ci sia `dsh-prime-memory` |
+| `duplicate loader entry id` al riavvio | un `insert:` aggiunto a mano convive con la voce bundle di pari id | Elimina la voce `insert:` aggiunta manualmente; il pacchetto include già il suo livello bundle |
+| Nessuna riga «Iniezione di contesto · memory» | distillazione non eseguita / richiamo disattivato | Verifica che la modalità non sia off e che `recall.enabled=true`; cerca `L1 阶段完成` in `memory.log` |
+| Download del modello di embedding locale bloccato | mirror non raggiungibile in connessione diretta | Imposta `embedding.proxy` per passare da un proxy; oppure sostituisci `embedding.mirror` con l'ufficiale `huggingface.co` |
+| Errore 401 dall'embedding remoto | apiKey errata / servizio senza chiave a cui non va inviata | Controlla `embedding.apiKey`; per un servizio self-hosted senza chiave lascia apiKey vuota |
+
+Per approfondire, vedi [README.md](./README.md) e [CHANGELOG.md](./CHANGELOG.md).

package/INSTALL.ru.md

@@ -0,0 +1,92 @@
+# Руководство по установке (dsh-prime-memory)
+
+Плагин распространяется в виде **официального bundle-пакета DSH**: после установки слой `dsh.bundle` в `cordis.patch.yml` автоматически подключает запись плагина — вручную править конфигурацию профиля не нужно.
+
+## Требования к окружению
+
+- Node.js ≥ 22.16 (DSH 0.2.0-rc.1 и новее)
+- Установленный DeepSeek Harness (далее — DSH), доступен `--profile web`
+
+## Установка
+
+Выберите любой способ вызова (префикс `npx` может заменить `dsh` в любой из команд ниже):
+
+```bash
+# Способ 1: запустить официальный CLI напрямую через npx (предустановка dsh не нужна; можно зафиксировать версию, например dsh-prime-memory@0.8.4)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-prime-memory
+
+# Способ 2: при установленном CLI dsh (dsh — это forwarding-обёртка pnpm; если pnpm нет, сначала npm i -g pnpm)
+dsh plugin --profile web add dsh-prime-memory
+
+# Альтернативные источники пакета: репозиторий GitHub / локальный путь (разработка и отладка; link: указывает на репозиторий, достаточно npm run build + перезапуска dsh)
+dsh plugin --profile web add https://github.com/drscrewdriver/dsh-prime-memory
+dsh plugin --profile web add /path/to/dsh-prime-memory
+```
+
+### Поручить установку агенту (рекомендуется)
+
+Отправьте текущему агенту приведённое ниже сообщение целиком и без изменений (если он умеет выполнять команды терминала):
+
+```text
+Установи плагин dsh-prime-memory для web-профиля DeepSeek Harness.
+
+Выполни только следующие две команды и не изменяй другие профили:
+dsh plugin --profile web add dsh-prime-memory
+dsh --profile web --dump-config
+
+Когда dsh-prime-memory появится в выводе, сообщи мне результат установки.
+Не закрывай и не перезапускай работающий DSH по своей инициативе; после установки напомни мне вручную перезапустить DSH Web Host.
+```
+
+## Обновление
+
+```bash
+# Обновить до последней версии
+dsh plugin --profile web update dsh-prime-memory
+
+# Обновить до конкретной версии
+dsh plugin --profile web update dsh-prime-memory@0.8.11
+```
+
+Обновление заменяет только код плагина и артефакты в `dist/`; каталог данных `~/.dsh/memory/` не затрагивается.
+
+## Проверка
+
+После установки и перезапуска DSH Web Host проверьте:
+
+1. **Появился каталог данных** — плагин успешно применён: в `~/.dsh/memory/` появляются каталоги `conversations/`, `records/`, `scenes/` и файл `memory.db`;
+2. **В настройках появилась страница «Память»** и в строке ввода появился пилюльный переключатель режимов — клиентская половина готова;
+3. Отправьте сообщение с личной информацией, дождитесь завершения дистилляции, затем спросите об этом в другом ходе беседы: в контексте должна появиться строка «Внедрение контекста · memory».
+
+Необязательный smoke-тест (для разработки/диагностики):
+
+```bash
+npm run build
+npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
+node dist-smoke/smoke.js
+```
+
+## Миграция / откат
+
+- **Миграция со старой версии (до 0.5.0 пакет назывался `dsh-memory-plugin`)**: старый каталог данных несовместим с новым пакетом; сделайте резервную копию и удалите `~/.dsh/memory/` — при первом запуске новый плагин пересоздаст его. Существующие воспоминания нельзя перенести напрямую, потребуется повторная дистилляция.
+- **Откат на старую версию**: после `dsh plugin --profile web remove dsh-prime-memory` переустановите по документации старой версии; каталог данных сохранится, но старая версия не распознаёт новую структуру — рекомендуется его очистить.
+
+## Удаление
+
+```bash
+dsh plugin --profile web remove dsh-prime-memory
+```
+
+Данные остаются в `~/.dsh/memory/`; если они больше не нужны, удалите весь каталог вручную.
+
+## Поиск и устранение неисправностей
+
+| Симптом | Вероятная причина | Решение |
+| --- | --- | --- |
+| После установки в настройках нет страницы «Память» | DSH не перезапущен / bundle не подключён | Перезапустите DSH Web Host; командой `dsh --profile web --dump-config` убедитесь, что `dsh-prime-memory` присутствует |
+| При перезапуске ошибка `duplicate loader entry id` | в patch одновременно присутствует ручной `insert:` и добавление bundle с тем же id | Удалите добавленный вручную элемент `insert:`; пакет уже содержит собственный слой bundle |
+| Нет строки «Внедрение контекста · memory» | дистилляция не запускалась / припоминание отключено | Проверьте, что режим не off и `recall.enabled=true`; найдите `L1 阶段完成` в `memory.log` |
+| Загрузка локальной модели эмбеддингов зависает | зеркало недоступно по прямому соединению | Задайте `embedding.proxy` для работы через прокси; либо замените `embedding.mirror` на официальный `huggingface.co` |
+| Удалённый эмбеддинг отдаёт ошибку 401 | неверная apiKey / сервис без ключа, которому ключ передавать не нужно | Проверьте `embedding.apiKey`; для собственного сервиса без ключа оставьте apiKey пустой |
+
+Подробнее см. [README.md](./README.md) и [CHANGELOG.md](./CHANGELOG.md).

package/README.de.md

@@ -61,7 +61,7 @@ alt="DeepSeek Harness Hero-Banner: Unterhaltungen werden automatisch zu mehrschi
 > Kompatibilitätsmechanismus: Die Settings-Registrierung durchläuft zur Laufzeit drei Zweige
 > (`register` → `installSection`-Brücke → Dauerein-Notbetrieb), siehe Eintrag 0.11.0 im
 > [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` deklariert
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Schnellstart
 

package/README.en.md

@@ -61,7 +61,7 @@
 > Compatibility mechanism: settings registration uses a three-way runtime branch
 > (`register` → `installSection` bridge → always-on degradation); see the 0.11.0 entry
 > in [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` declares
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Getting Started
 
@@ -565,9 +565,9 @@ directly ("zero source-less facts" invariant: every edge traces back to live L1
 | Action | Tool | Preconditions | Notes |
 | --- | --- | --- | --- |
 | Revise one memory | `memory_update` | high-privilege mode | Read old → create new (`version+1`, new id) → old row retires via the shared soft-delete confluence with a `superseded` marker (restorable) → new version enters retrieval; then both [old, new] ids are force-reprojected so graph edges follow (edges supported only by the old source get tombstoned). Not a physical delete; the JSONL fact source is append-only and never rewritten |
-| Force reprojection | `memory_reproject` | `graph.enabled` | Erases the "already projected at current version" receipts and re-enqueues at top priority, bypassing the permanent `projector_version` skip. Idempotent: in-flight jobs never pile up. **Manually added/imported memories that never showed up in the graph: this is the back-fill projection channel** (non-distilled writes now auto-enqueue; the tool remains the correction path for legacy rows and post-edit freshness) |
+| Force reprojection | `memory_reproject` | Overview → Knowledge graph switch, or `graph.enabled` | Erases the "already projected at current version" receipts and re-enqueues at top priority, bypassing the permanent `projector_version` skip. Idempotent: in-flight jobs never pile up. **Manually added/imported memories that never showed up in the graph: this is the back-fill projection channel** (non-distilled writes now auto-enqueue; the tool remains the correction path for legacy rows and post-edit freshness) |
 | Migrate one relation | `memory_migrate_relation` | high-privilege mode | Source-derived semantics: hard-validate that every `source_record_ids` is live and un-retired → the new relation lands through the deterministic projection branch (same (from, relation) with a new target closes the old edge) → a new L1 carrier record is written as the traceable basis (tagged `proposal_source=tool` plus a decision receipt). Old edges are not flipped back by later rejections: the reprojection batch pulls only the carrier, not sources whose text still describes the old relation |
-| Non-distilled writes auto-enqueue | `memory_add` / `memory_import` | `graph.enabled` | After a successful write, records join the projection queue at the same priority as distillation output (`GRAPH_PRIORITY_NEW`) — the "only distillation projects" bypass is closed |
+| Non-distilled writes auto-enqueue | `memory_add` / `memory_import` | Overview → Knowledge graph switch, or `graph.enabled` | After a successful write, records join the projection queue at the same priority as distillation output (`GRAPH_PRIORITY_NEW`) — the "only distillation projects" bypass is closed |
 
 Two boundaries worth knowing:
 

package/README.es.md

@@ -61,7 +61,7 @@ alt="Banner hero de DeepSeek Harness: las conversaciones se destilan automática
 > Mecanismo de compatibilidad: el registro de ajustes pasa en tiempo de ejecución por tres ramas
 > (`register` → puente `installSection` → degradación a siempre activado),
 > ver la entrada 0.11.0 del [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` declara
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Inicio rápido
 

package/README.fr.md

@@ -61,7 +61,7 @@ alt="Bannière hero de DeepSeek Harness : les conversations sont automatiquement
 > Mécanisme de compatibilité : l'enregistrement settings passe par trois branches à l'exécution
 > (`register` → pont `installSection` → dégradation en mode toujours actif),
 > voir l'entrée 0.11.0 du [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` déclare
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Démarrage rapide
 

package/README.it.md

@@ -61,7 +61,7 @@ alt="Banner hero di DeepSeek Harness: le conversazioni vengono distillate automa
 > Meccanismo di compatibilità: la registrazione delle impostazioni passa per tre rami a runtime
 > (`register` → ponte `installSection` → degrado a sempre-attivo),
 > vedi la voce 0.11.0 del [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` dichiara
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Avvio rapido
 

package/README.ja.md

@@ -62,7 +62,7 @@ alt="DeepSeek Harness ヒーロー画像：会話がバックグラウンドで
 
 > 互換メカニズム：settings 登録は 3 分岐のランタイム判定（`register` → `installSection` ブリッジ → 常時オン縮退）。
 > 詳細は [CHANGELOG.md](./CHANGELOG.md) の 0.11.0 エントリ参照。`dsh.plugin.json` は
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc） を宣言。
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc） を宣言。
 
 ## クイックスタート
 

package/README.ko.md

@@ -62,7 +62,7 @@ alt="DeepSeek Harness 히어로 이미지: 대화가 백그라운드에서 계
 
 > 호환 메커니즘: settings 등록은 3분기 런타임 분기（`register` → `installSection` 브리지 → 상시 온 강등）.
 > 자세한 내용은 [CHANGELOG.md](./CHANGELOG.md)의 0.11.0 항목 참조. `dsh.plugin.json`은
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc） 선언.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc） 선언.
 
 ## 빠른 시작
 

package/README.md

@@ -60,7 +60,7 @@ alt="DeepSeek Harness hero 横幅：对话自动分层蒸馏成记忆，模型
 
 > 兼容机制：settings 注册走运行时三分支（`register` → `installSection` 桥接 → 恒开降级），
 > 详见 [CHANGELOG.md](./CHANGELOG.md) 的 0.11.0 条目。`dsh.plugin.json` 声明
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）。
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）。
 
 ## 快速开始
 
@@ -436,6 +436,13 @@ dsh 宿主把插件日志打到控制台；插件另把 info 级以上镜像到
 前 400 字符；所有失败告警带堆栈首帧。JSONL 事实源按轮次追加、依赖操作系统写回（不做逐条
 fsync），断电等极端崩溃最多丢最后一小段尾部，检索库可用「重建记忆」从事实源全量重导。
 
+> **重建的事实源边界（0.26.11 起要说清楚）**：重建只能重蒸**事实源覆盖到的那一刻之前**的记忆。L0 正文自 T8.4 起已停写（历史面由 DRSC 供给），所以水位之后新增的记忆**不会被重新蒸馏**——它们会被**原样保留**（保留理由 `post-watermark`：来源消息不在本次快照内），不会丢。确认弹窗会直接写出「事实源覆盖到 X」与「可重造 N 条 / 原样保留 M 条」；若晚于水位的记录超过一半，启动需要二次确认（`force`）——这是**提示**而非永久拒绝（否则停写的库上重建会被永久锁死）。
+
+> **重建的事实源可切换（`rebuild.factSource`，默认 `local`）**：
+> - `local`：本地 `l0_conversations`（已停写的冻结存量），**按会话流式读**——峰值只占单会话，不再把全量正文（3 万条量级约 88MB）驻留整个重建期；
+> - `drsc`（实验性）：`reference-session-collector` 的投影——先枚举会话、再逐会话拉全量，**恒带 `redact=1`**（collector 的 `session` 缺省是原文臂，而捕获侧是写前脱敏）。选了 drsc 但 collector 未装配会**显式报错中止**，不静默回退本地表。
+> - 注意：DRSC 无法枚举消息 id（`drsc:<sid>:<seq>` 与事实源的 `source_message_ids` 不同域），所以 `drsc` 模式下所有有来源的记忆都会被判为**不可重蒸并原样保留**（保守侧失败，不丢数据）。
+
 ## 与 MemoryCore 的差异
 
 - 内嵌完整管线（不依赖外部 Gateway），蒸馏复用 DSH 自己的 LLM；
@@ -513,9 +520,9 @@ fsync），断电等极端崩溃最多丢最后一小段尾部，检索库可用
 | 动作 | 工具 | 前提 | 说明 |
 | --- | --- | --- | --- |
 | 修订一条记忆 | `memory_update` | 高权限模式 | 读旧 → 造新（`version+1`，新 id）→ 旧行经退场汇流口 `superseded` 软删（可恢复）→ 新版进检索面；随后对 [旧,新] 强制重投，图谱边跟随（旧源支撑的边自动标墓碑）。不是物理删，也不覆写 JSONL 事实源 |
-| 强制重投 | `memory_reproject` | 配置 `graph.enabled` | 抹掉"已按当前版本投影"凭证、按高优先级重新入队——绕开 `projector_version` 的永久跳过。幂等：在途任务不堆重。**手加/导入的记忆长期不出现在图谱里，用它补投影**（非蒸馏写入现已自动入队，此工具是给存量与改后保鲜的纠正通道） |
+| 强制重投 | `memory_reproject` | 概览「知识图谱」开关 或 部署 `graph.enabled` | 抹掉"已按当前版本投影"凭证、按高优先级重新入队——绕开 `projector_version` 的永久跳过。幂等：在途任务不堆重。**手加/导入的记忆长期不出现在图谱里，用它补投影**（非蒸馏写入现已自动入队，此工具是给存量与改后保鲜的纠正通道） |
 | 迁移一条关系 | `memory_migrate_relation` | 高权限模式 | 源导语义：先硬校验 `source_record_ids` 全部"现存未退场" → 新关系经确定性投影支路落库（同 (起点,关系) 换目标自动闭旧边出新边）→ 新增一条承载新关系的 L1 源记录留可回溯根据（带 `proposal_source=tool` 审计标记与决策凭证）。旧边不会因后续重投被翻回：重投批只拉载体记录，不拉描述旧关系的旧源 |
-| 非蒸馏写入自动入队 | `memory_add` / `memory_import` | 配置 `graph.enabled` | 落库成功后与蒸馏产出同优先级（`GRAPH_PRIORITY_NEW`）进投影队——"只有蒸馏才投影"的旁路缺口已闭合 |
+| 非蒸馏写入自动入队 | `memory_add` / `memory_import` | 概览「知识图谱」开关 或 部署 `graph.enabled` | 落库成功后与蒸馏产出同优先级（`GRAPH_PRIORITY_NEW`）进投影队——"只有蒸馏才投影"的旁路缺口已闭合 |
 
 两条必须知道的边界：
 

package/README.ru.md

@@ -61,7 +61,7 @@ alt="Баннер hero DeepSeek Harness: диалоги автоматическ
 > Механизм совместимости: регистрация настроек на этапе исполнения идёт по трём ветвям
 > (`register` → мост `installSection` → деградация в режим «всегда включено»),
 > подробнее — запись 0.11.0 в [CHANGELOG.md](./CHANGELOG.md). `dsh.plugin.json` объявляет
-> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.3，18 rc）.
+> `engines.dsh` 为逐 rc 精确枚举串（0.1.0-rc.2 → 0.2.1-rc.4，19 rc）.
 
 ## Быстрый старт
 

package/dist/bench-control.js

@@ -4,7 +4,9 @@ export const BENCH_CONTROL_SERVICE = 'dsh-memory-bench';
 /** 注册控制服务,返回注销函数(调用方在插件 dispose 时执行)。 */
 export function registerBenchControl(ctx, rebuild, modes, logger) {
     const surface = {
-        rebuildStart: () => rebuild.start(),
+        // bench 场景自带可控数据集，需要确定性重建：水位落差的“二次确认”
+        // 属于人机交互护栏，不该阻断自动化赛道，故显式 force。
+        rebuildStart: () => rebuild.start(true),
         rebuildStatus: () => rebuild.getStatus(),
         setSessionMode: (sessionId, mode) => modes.set(sessionId, mode),
         getSessionMode: (sessionId) => modes.get(sessionId),