dsh-prime-memory 0.26.11 → 0.26.13

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 更新日志（Changelog）
 
+## [0.26.13] — 2026-10-28
+
+> 修复 issue #19：单条 L1 priority 越界（如 LLM 回 `-1`）经无夹取写点落库后，`memoryRecall` 投影的 `viewSchema` 严格校验（判非负整数）抛错 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据打死整个会话历史**。
+
+### 修复
+
+- **双防线**：
+  - **写侧夹取（防新增）**：新建 `src/util/priority.ts` 单源 `clampPriority`（非有限→回落缺省、小数 `Math.round`、夹到整数 `[0,100]`），L1 抽取/合并构造（`pipeline/l1.ts` 两处）、upsert 绑定层（`store/sqlite.ts`，保留历史缺省 50）、MD 导入解析（`store/memory-md-parse.ts`）统一走同一夹取。
+  - **读侧兜底（自愈存量）**：投影 `makeView` 遇脏 priority 就地夹取并 `warn`（带 record id + 原值），绝不让单条脏字段打死整会话。因升级必重启宿主、`viewMemo`（进程内 WeakMap）随之清空，脏行读时被夹取 → **存量脏数据无需手动改库、无需迁移**。
+- 保留 `viewSchema` 严格校验（纵深防御仍在，只是喂进去的已是干净值）；合法 0–100 整数读写逐字不变；`slots.ts` 的同名私有 `clampPriority`（floor/50，memorySlots 另一条链）不受影响。
+- 本版叠加在 0.26.12（DSH 0.2.1-rc.4 适配）之上，`latest` 与 `dsh-0.2.1-rc.4` dist-tag 同指本版。
+
+## [0.26.12] — 2026-10-28
+
+> 0.26.12: host enumeration addendum for DSH 0.2.1-rc.4 (declaration-only bump; contract plane zero diff). `engines.dsh`/`dsh.plugin.json`/README 同串补 `0.2.1-rc.4` 枚举行（19 档）。
+
 ## [0.26.11] — 2026-10-27
 
 > 本版闭环三条外部 issue：#12（两级 Room slug 写不进）、#13（默认路由表硬编码作者本机路径）、#14（重建以已写停的 L0 为事实源）、#16（图谱投影只有配置文件开关）。

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
 

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）。
 
 ## 快速开始
 

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/index.js

@@ -497,7 +497,7 @@ export async function apply(ctx, config) {
     // memoryRecall 投影：本会话“已注入且未被压缩覆盖”的召回集（会话感知，init 取 header.id），
     // 与常驻槽位是两条轴：那个是手动 pin 的硬注入约定，这个是非常驻的相关性浮现结果。
     // 带上反馈面：条目要显示人已经打过的那一笔（rating）。
-    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback);
+    registerRecallProjection(ctx, stores.recalled, stores.l1, recallFeedback, logger);
     // 人打 -1 声明过时后，下一轮向模型一次性播报“这条已退场、别再依据它作答”。
     registerObsoleteNotice(ctx, config, obsoleteNotices, logger);
     void slotRecall;

package/dist/pipeline/l1.js

@@ -14,6 +14,7 @@ import { buildConflictPair, conflictRejectId, DEFER_MAX, normalizeClaimKey, norm
 import { formatExtractionPrompt, getExtractMemoriesSystemPrompt } from '../prompts/l1-extraction.js';
 import { normTags, normUsageScenario, readCognitiveHall, readWing } from '../metadata-validators.js';
 import { acceptTitle } from '../util/md-name.js';
+import { clampPriority } from '../util/priority.js';
 import { formatBatchConflictPrompt, getConflictDetectionSystemPrompt } from '../prompts/l1-dedup.js';
 import { resolveSourceAnchors, withSourceAnchors } from './anchors.js';
 import { stampValidity, validToSourceOf } from '../store/validity.js';
@@ -196,7 +197,7 @@ export function toStoreRecord(m, now, ts, anchorMap) {
         id: m.record_id,
         content: m.content,
         type: m.type,
-        priority: Number(m.priority) || 60,
+        priority: clampPriority(m.priority),
         scene_name: m.scene_name,
         timestamps: [Number.isNaN(ts) ? now : ts],
         createdAt: now,
@@ -714,7 +715,7 @@ routeHealth) {
             id: m.record_id,
             content: mergedContent,
             type: decision.merged_type || m.type,
-            priority: Number(decision.merged_priority) || Number(m.priority) || 60,
+            priority: clampPriority(decision.merged_priority ?? m.priority),
             scene_name: m.scene_name,
             timestamps: Array.from(new Set(mergedTs)).sort((a, b) => a - b),
             createdAt: now,

package/dist/projection/recall.d.ts

@@ -116,5 +116,7 @@ export interface RecallFeedbackFace {
  * apply 是 O(1) 判脏（store.revision() 与反馈序号比对），任意已提交事件都会带进来看一眼。
  * @param feedback - 相关度反馈只读面；缺席时 view 不带 rating（旧行为）。
  */
-export declare function registerRecallProjection(ctx: Context, store: SessionRecalledStore, l1?: RecallL1Face, feedback?: RecallFeedbackFace): void;
+export declare function registerRecallProjection(ctx: Context, store: SessionRecalledStore, l1?: RecallL1Face, feedback?: RecallFeedbackFace, log?: {
+    warn(message: string): void;
+}): void;
 export {};

package/dist/projection/recall.js

@@ -1,5 +1,6 @@
 import { isRetired } from '../store/supersede.js';
 import { stateOfRecord } from '../store/validity.js';
+import { clampPriority, isDirtyPriority } from '../util/priority.js';
 export const MEMORY_RECALL_KEY = 'memoryRecall';
 /** view 最多透出条数（最近在上；超出部分只计入 count，防 wire 体量失控）。 */
 export const RECALL_VIEW_CAP = 20;
@@ -141,7 +142,7 @@ function sameIds(a, b) {
 }
 /** view 引用稳定：同一 state 恒返回同一对象（registry 按 Object.is 判发布）。 */
 const viewMemo = new WeakMap();
-function makeView(state, l1, feedback) {
+function makeView(state, l1, feedback, log) {
     const memoized = viewMemo.get(state);
     if (memoized !== undefined)
         return memoized;
@@ -163,11 +164,16 @@ function makeView(state, l1, feedback) {
         // 未退场行才会真判过时两档（退场行由 retired 键表达，validity 不再叠加）。
         const vState = isRetired(r) ? undefined : stateOfRecord(r, Date.now());
         const showValidity = vState === 'expired' || vState === 'expired_suspect';
+        // #19 读侧兜底：脏 priority（负/超界/非整数/非有限）就地夹取，绝不让 viewSchema
+        // 因单条脏字段抛错打死整会话；命中时 warn 留痕（静默夹取会掩盖上游 LLM 异常）。
+        const rawPriority = r.priority;
+        if (isDirtyPriority(rawPriority))
+            log?.warn(`[memory][recall] 脏 priority 回落 record=${r.id} raw=${String(rawPriority)}`);
         items.push({
             id: r.id,
             type: r.type,
             title: r.name || firstLine(r.content),
-            priority: r.priority,
+            priority: clampPriority(rawPriority),
             body: clampBody(r.content),
             ...(scenario !== undefined && scenario.length > 0 ? { scenario } : {}),
             ...(typeof rating === 'number' ? { rating } : {}),
@@ -196,7 +202,7 @@ function sessionIdOf(header) {
  * apply 是 O(1) 判脏（store.revision() 与反馈序号比对），任意已提交事件都会带进来看一眼。
  * @param feedback - 相关度反馈只读面；缺席时 view 不带 rating（旧行为）。
  */
-export function registerRecallProjection(ctx, store, l1, feedback) {
+export function registerRecallProjection(ctx, store, l1, feedback, log) {
     ctx.inject(['sessionProjections'], (injected) => {
         const registry = injected.sessionProjections;
         if (registry === undefined || typeof registry.register !== 'function')
@@ -208,9 +214,9 @@ export function registerRecallProjection(ctx, store, l1, feedback) {
             stateSchema,
             init: (header) => buildState(sessionIdOf(header), store, fbRev()),
             apply: (state) => buildState(state.sessionId, store, fbRev(), state),
-            wire: { viewSchema, view: (state) => makeView(state, l1, feedback) },
+            wire: { viewSchema, view: (state) => makeView(state, l1, feedback, log) },
             schema: viewSchema,
-            view: (state) => makeView(state, l1, feedback),
+            view: (state) => makeView(state, l1, feedback, log),
             stateVersion: 0,
         };
         registry.register(definition);

package/dist/store/memory-md-parse.js

@@ -13,6 +13,7 @@
  * 与正文本体是否一致（`hashValid`），不替调用方决定怎么处置——那属于同步侧的裁决。
  */
 import { contentHash } from './memory-md.js';
+import { clampPriority } from '../util/priority.js';
 /** 取 frontmatter 块：首行必须是 `---`，到下一个 `---` 为止。 */
 function splitFrontmatter(text) {
     // BOM 与 CRLF 都要先吃掉：人在记事本里改一行就会引入 \r，而 `\r` 会让 key 匹配不上。
@@ -71,7 +72,7 @@ export function parseMdFile(text) {
     return {
         name: str(fields.get('name')),
         type: str(fields.get('type')),
-        priority: Number.isFinite(prio) ? prio : 60,
+        priority: clampPriority(prio),
         createdAt: str(fields.get('createdAt')),
         updatedAt: str(fields.get('updatedAt')),
         usageScenario: scenario,

package/dist/store/sqlite.js

@@ -26,6 +26,7 @@ import { normApplicability } from '../repo-scope.js';
 import { normalizeWorkspacePath } from '../workspace.js';
 import { bm25RankToScore, buildFtsQuery, tokenizeForFts } from './search-utils.js';
 import { describeTokenizer, ensureTokenizer, tokenizerStamp } from '../util/tokenizer.js';
+import { clampPriority } from '../util/priority.js';
 const require = createRequire(import.meta.url);
 const TAG = '[memory][sqlite]';
 /**
@@ -992,7 +993,7 @@ export class MemoryDb {
         // 无法绑定(node:sqlite 拒绝绑定),曾致旧版导入逐条全挂、每次启动无限重试。
         // 主表与 FTS 两条语句共用同源归一化值;type 归一化后 familyForType 也不再收到 undefined。
         const type = record.type ?? '';
-        const priority = record.priority ?? 50;
+        const priority = clampPriority(record.priority, 50);
         const sceneName = record.scene_name ?? '';
         const family = record.family ?? familyForType(type);
         // §E 写入侧兜底归一,并维持一条**不变量**:`scope='global'` 的记录 `workspace_id` 恒为空串。

package/dist/util/priority.d.ts

@@ -0,0 +1,22 @@
+/**
+ * L1 记忆 priority 的归一单源（issue #19）。
+ *
+ * 存在理由：priority 是磁盘契约列，且被 memoryRecall 投影的 `viewSchema` 严格校验
+ * （`requireCounter` 判非负整数）。任一写入口把 LLM 回传的负数/超界/小数原样落库，
+ * 投影出网即抛 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据
+ * 打死整个会话历史**。故所有喂进 `l1_records.priority` 的路径必须过同一夹取。
+ *
+ * 语义（用户选定）：非有限值→`fallback`；小数 `Math.round`；结果夹到整数 `[0,100]`。
+ * `fallback` 形参是为保留各写点既有的缺省差异（upsert 绑定层历史上用 50，抽取用 60），
+ * 避免为修范围而把某处的默认值静默漂移。
+ *
+ * 注意：**不动** `store/slots.ts` 里的同名私有 `clampPriority`（floor/50，服务 memorySlots
+ * 另一条链）；本文件只服务 L1 记忆 priority。
+ */
+export declare const PRIORITY_DEFAULT = 60;
+export declare const PRIORITY_MIN = 0;
+export declare const PRIORITY_MAX = 100;
+/** 夹取到 `[PRIORITY_MIN, PRIORITY_MAX]` 的整数；非有限值回落 `fallback`。 */
+export declare function clampPriority(value: unknown, fallback?: number): number;
+/** 是否会被夹取改变（负 / 超界 / 非整数 / 非有限 / 缺失）——供读侧判定要不要 warn。 */
+export declare function isDirtyPriority(value: unknown): boolean;

package/dist/util/priority.js

@@ -0,0 +1,36 @@
+/**
+ * L1 记忆 priority 的归一单源（issue #19）。
+ *
+ * 存在理由：priority 是磁盘契约列，且被 memoryRecall 投影的 `viewSchema` 严格校验
+ * （`requireCounter` 判非负整数）。任一写入口把 LLM 回传的负数/超界/小数原样落库，
+ * 投影出网即抛 → 宿主把整会话包成 `SESSION_QUERY_CORRUPT_SESSION` → **一条脏数据
+ * 打死整个会话历史**。故所有喂进 `l1_records.priority` 的路径必须过同一夹取。
+ *
+ * 语义（用户选定）：非有限值→`fallback`；小数 `Math.round`；结果夹到整数 `[0,100]`。
+ * `fallback` 形参是为保留各写点既有的缺省差异（upsert 绑定层历史上用 50，抽取用 60），
+ * 避免为修范围而把某处的默认值静默漂移。
+ *
+ * 注意：**不动** `store/slots.ts` 里的同名私有 `clampPriority`（floor/50，服务 memorySlots
+ * 另一条链）；本文件只服务 L1 记忆 priority。
+ */
+export const PRIORITY_DEFAULT = 60;
+export const PRIORITY_MIN = 0;
+export const PRIORITY_MAX = 100;
+/** 夹取到 `[PRIORITY_MIN, PRIORITY_MAX]` 的整数；非有限值回落 `fallback`。 */
+export function clampPriority(value, fallback = PRIORITY_DEFAULT) {
+    const sanitize = (x) => Math.max(PRIORITY_MIN, Math.min(PRIORITY_MAX, Math.round(x)));
+    // null/undefined 显式回落（Number(null) 得 0，若不当缺省处理会把旧 `?? 50` 漂移成 0）。
+    if (value === null || value === undefined)
+        return sanitize(fallback);
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n))
+        return sanitize(fallback);
+    return sanitize(n);
+}
+/** 是否会被夹取改变（负 / 超界 / 非整数 / 非有限 / 缺失）——供读侧判定要不要 warn。 */
+export function isDirtyPriority(value) {
+    if (value === null || value === undefined)
+        return true;
+    const n = typeof value === 'number' ? value : Number(value);
+    return !Number.isInteger(n) || n < PRIORITY_MIN || n > PRIORITY_MAX;
+}

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.11",
+  "version": "0.26.13",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
   },
   "components": {
     "host": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.11",
+  "version": "0.26.13",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",
@@ -41,10 +41,20 @@
     "README.en.md",
     "README.ja.md",
     "README.ko.md",
+    "README.de.md",
+    "README.es.md",
+    "README.fr.md",
+    "README.it.md",
+    "README.ru.md",
     "INSTALL.md",
     "INSTALL.en.md",
     "INSTALL.ja.md",
     "INSTALL.ko.md",
+    "INSTALL.de.md",
+    "INSTALL.es.md",
+    "INSTALL.fr.md",
+    "INSTALL.it.md",
+    "INSTALL.ru.md",
     "CHANGELOG.md",
     "CHANGELOG.en.md",
     "CHANGELOG.ja.md",
@@ -54,6 +64,7 @@
     "CHANGELOG.fr.md",
     "CHANGELOG.it.md",
     "CHANGELOG.ru.md",
+    "LICENSE",
     "ENGINEERING-NOTES.md"
   ],
   "scripts": {
@@ -69,7 +80,7 @@
   },
   "engines": {
     "node": ">=22.16.0",
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
   },
   "keywords": [
     "dsh",
@@ -93,15 +104,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-session": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-agent": {