dsh-date-wrapper 0.2.0 → 0.4.0

package/INSTALL.de.md

@@ -0,0 +1,130 @@
+# Installationsanleitung (offizielle DSH-CLI)
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+## 0. Voraussetzungen
+
+```powershell
+echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
+dsh --version           # verified on 0.1.1-rc.2 (0.1.x line, plugin <= 0.2.0); 0.2.0-rc.1+ needs plugin >= 0.3.0 (engines >=0.2.0-rc.1 <0.2.1-0)
+pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
+```
+
+## 1. Installation
+
+Von GitHub (empfohlen — pnpm kopiert das Paket nach `node_modules`, und die Lockfile pinnt den exakten Commit):
+
+```powershell
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Oder aus einem lokalen Checkout (Entwicklung):
+
+```powershell
+dsh plugin --profile web add E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+Oder im Link-Modus (Quellcode-Änderungen wirken nach einem Neustart, ohne Neuinstallation):
+
+```powershell
+dsh plugin --profile web add link:E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+> ⚠️ Eine lokale `file:`-/`link:`-Installation macht das Profil von diesem Pfad abhängig. Wird das Verzeichnis umbenannt oder gelöscht, brechen **alle** pnpm-Operationen im Profil mit `ENOENT`, bis die veraltete Abhängigkeit entfernt ist — genau das geschah, als dieses Paket von `dsh-time-wrapper` umbenannt wurde.
+> ⚠️ Ein relativer Pfad ist nur dann an **Ihr aktuelles Verzeichnis** verankert, wenn er mit `.` oder `..` beginnt;
+> `mine-dsh-plugins\dsh-date-wrapper` wird innerhalb des Profil-Verzeichnisses aufgelöst und nicht gefunden. Absolute Pfade sind am sichersten.
+
+Zeichen einer erfolgreichen Installation:
+
+1. pnpm beendet sich mit Code 0;
+2. `C:\Users\<you>\.dsh\profiles\web\package.json` listet `dsh-date-wrapper` unter `dependencies`;
+3. das `dsh.profile.bundles` derselben Datei erhält `dsh-date-wrapper` am Ende (das Paket deklariert `dsh.bundle.patch` und wird deshalb automatisch in die Ebenenliste aufgenommen).
+
+## 2. Neustart
+
+```powershell
+# stop the running dsh web process, then start it again
+dsh web
+```
+
+Dann die Browserseite neu laden.
+
+> Bundle-Patches werden **nicht** heiß nachgeladen: Nur die Profil-/Home-Patch-Ebenen werden überwacht. Änderungen an der
+> eigenen `cordis.patch.yml` des Plugins oder ein Plugin-Upgrade erfordern stets einen Neustart.
+
+## 3. Verifikation
+
+Öffnen Sie eine neue Sitzung und senden Sie eine beliebige Nachricht. Das Datum hängt am **Laufzeitkontext-Snapshot** (in der Sitzung als injizierte Kontextzeile mit der Quelle `system-prompt` angezeigt), und zwar als:
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+Das ist `Current date: ` + `<ISO date> <IANA zone> <English weekday>`, 46 Zeichen (~12 Tokens), **ohne Stunde, Minute oder Sekunde**.
+
+Sie können das Plugin selbst auch von der Kommandozeile aus üben:
+
+```powershell
+cd E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+node tests/format.test.mjs
+node tests/context.test.mjs
+```
+
+## 4. Fehlerbehebung
+
+| Symptom | Ursache und Behebung |
+|---------|---------------|
+| Start schlägt fehl mit `date-wrapper: 非法 IANA timeZone` | Der `timeZone` in `cordis.patch.yml` ist falsch. Das ist **absichtliches Fail-fast**: Lieber beim Start scheitern, als stillschweigend ein falsches Datum in UTC auszugeben |
+| Start schlägt fehl mit `duplicate loader entry id: date-wrapper` | Der Assemblierungsbaum hat bereits eine Zeile mit dieser id; löschen Sie das Duplikat |
+| Kein Datum nach der Installation | ① prüfen, dass `dsh-date-wrapper` in `dsh.profile.bundles` steht; ② prüfen, dass Sie neu gestartet und die Seite neu geladen haben; ③ **prüfen, dass das aktuelle Preset kein Fixed-Prompt-Preset ist** (nächste Zeile) |
+| Kein Datum unter manchen Presets | Die Persona dieses Presets setzt `includeRuntimeContext: false` (das offizielle `minimal` und das lokale `simple-reply` tun beide). Solche Presets verbieten späteren Listeners ausdrücklich, Prompt-Inhalt hinzuzufügen; der Laufzeitkontext dieses Plugins wird daher verworfen — erwartetes Verhalten |
+| Das Datum geht um einen Tag daneben | `timeZone` entspricht nicht Ihrer tatsächlichen Zone; über eine Zonengrenze hinweg (z. B. 00:30 in Peking = 16:30 UTC am Vortag) zeigt sich das als Differenz von einem Tag |
+| Sie sehen zusätzlich `Time sampled …` | Ein Preset montiert `@deepseek-ai/dsh-time-context` explizit. Dieses Plugin lädt oder filtert es nicht; beide dürfen nicht zusammen verwendet werden |
+| Jede pnpm-Operation im Profil schlägt fehl mit `ENOENT: no such file or directory, open '…'` | Eine `file:`-/`link:`-Abhängigkeit zeigt auf einen nicht mehr existierenden Pfad (das Paket wurde umbenannt oder sein Tarball gelöscht). Entfernen Sie die veraltete Abhängigkeit mit `dsh plugin --profile web remove <name>` und installieren Sie neu; `github:`-Installationen haben diesen Fehlermodus nicht |
+
+## 5. An/Aus (kein Panel-Umschalter — die Aktivierung ist der Schalter)
+
+Deaktivieren oder aktivieren Sie es in Ihrer eigenen Profil-Patch-Schicht — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml`:
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **Heiß, ohne Neustart**: Die Datei wird vom Cordis-HMR überwacht; `disabled: true` entsorgt die Fiber der Zeile, und die Injektion stoppt sofort.
+- DSHs eingebaute Seite **Settings → Plugins** zeigt `enabled / disabled` (schreibgeschützt).
+- Die Datei muss ein YAML-Array auf oberster Ebene sein; macht man sie fehlerhaft, **schlägt der Start fehl** (fail-loud).
+- Die vollständige Entfernung läuft über `dsh plugin remove` (nächster Abschnitt) und **erfordert einen Neustart**.
+
+## 6. Deinstallation
+
+```powershell
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+Starten Sie dsh web neu.

package/INSTALL.es.md

@@ -0,0 +1,130 @@
+# Guía de instalación (CLI oficial de DSH)
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+## 0. Requisitos previos
+
+```powershell
+echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
+dsh --version           # verified on 0.1.1-rc.2 (0.1.x line, plugin <= 0.2.0); 0.2.0-rc.1+ needs plugin >= 0.3.0 (engines >=0.2.0-rc.1 <0.2.1-0)
+pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
+```
+
+## 1. Instalación
+
+Desde GitHub (recomendado — pnpm copia el paquete a `node_modules`, y la lockfile fija el commit exacto):
+
+```powershell
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+O desde una copia local (desarrollo):
+
+```powershell
+dsh plugin --profile web add E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+O en modo link (los cambios en el código fuente surten efecto tras un reinicio, sin reinstalar):
+
+```powershell
+dsh plugin --profile web add link:E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+> ⚠️ Una instalación local `file:` / `link:` hace que el perfil dependa de esa ruta. Renombrar o borrar el directorio rompe entonces **todas** las operaciones de pnpm en el perfil con `ENOENT` hasta que se elimine la dependencia obsoleta — exactamente lo que ocurrió cuando este paquete fue renombrado desde `dsh-time-wrapper`.
+> ⚠️ Una ruta relativa solo se ancla a **tu directorio actual** cuando empieza por `.` o `..`;
+> `mine-dsh-plugins\dsh-date-wrapper` se resuelve dentro del directorio del perfil y no se encontrará. Las rutas absolutas son lo más seguro.
+
+Señales de una instalación exitosa:
+
+1. pnpm termina con código 0;
+2. `C:\Users\<you>\.dsh\profiles\web\package.json` lista `dsh-date-wrapper` bajo `dependencies`;
+3. el `dsh.profile.bundles` del mismo archivo gana `dsh-date-wrapper` al final (el paquete declara `dsh.bundle.patch`, así que entra automáticamente en la lista de capas).
+
+## 2. Reinicio
+
+```powershell
+# stop the running dsh web process, then start it again
+dsh web
+```
+
+Luego recarga la página del navegador.
+
+> Los parches de bundle **no** se recargan en caliente: solo se vigilan las capas de parche del perfil / del home. Cambiar el
+> `cordis.patch.yml` del propio plugin o actualizar el plugin siempre exige un reinicio.
+
+## 3. Verificación
+
+Abre una sesión nueva y envía cualquier mensaje. La fecha cuelga de la **instantánea del contexto de ejecución** (se muestra en la sesión como una fila de contexto inyectado procedente de `system-prompt`), así:
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+Es `Current date: ` + `<ISO date> <IANA zone> <English weekday>`, 46 caracteres (~12 tokens), **sin hora, minuto ni segundo**.
+
+También puedes ejercitar el propio plugin desde la línea de comandos:
+
+```powershell
+cd E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+node tests/format.test.mjs
+node tests/context.test.mjs
+```
+
+## 4. Resolución de problemas
+
+| Síntoma | Causa y solución |
+|---------|---------------|
+| El arranque falla con `date-wrapper: 非法 IANA timeZone` | El `timeZone` de `cordis.patch.yml` es incorrecto. Es un **fail-fast intencionado**: mejor fallar al arrancar que emitir en silencio una fecha errónea en UTC |
+| El arranque falla con `duplicate loader entry id: date-wrapper` | El árbol de ensamblado ya tiene una fila con ese id; borra el duplicado |
+| No hay fecha tras instalar | ① confirma que `dsh-date-wrapper` está en `dsh.profile.bundles`; ② confirma que reiniciaste y recargaste la página; ③ **confirma que el preset actual no es de prompt fijo** (siguiente fila) |
+| No hay fecha con algunos presets | La persona de ese preset pone `includeRuntimeContext: false` (lo hacen el `minimal` oficial y el `simple-reply` local). Tales presets prohíben explícitamente que listeners posteriores añadan contenido al prompt, así que el contexto de ejecución de este plugin se descarta — comportamiento esperado |
+| La fecha está desfasada un día | `timeZone` no coincide con tu zona real; al cruzar un límite de zona (p. ej. 00:30 en Pekín = 16:30 UTC del día anterior) se manifiesta como una diferencia de un día |
+| También ves `Time sampled …` | Algún preset monta `@deepseek-ai/dsh-time-context` explícitamente. Este plugin no lo carga ni lo filtra; no deben usarse juntos |
+| Cualquier operación de pnpm en el perfil falla con `ENOENT: no such file or directory, open '…'` | Una dependencia `file:` / `link:` apunta a una ruta que ya no existe (el paquete fue renombrado o se borró su tarball). Elimina la dependencia obsoleta con `dsh plugin --profile web remove <name>` e instala de nuevo; las instalaciones `github:` no tienen este modo de fallo |
+
+## 5. Activar/desactivar (sin toggle en el panel — la activación es el interruptor)
+
+Desactívalo o actívalo en tu propia capa de parche de perfil — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml`:
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **En caliente, sin reinicio**: el archivo está vigilado por el HMR de Cordis; `disabled: true` dispone la fiber de la fila y la inyección se detiene de inmediato.
+- La página **Settings → Plugins** integrada en DSH muestra `enabled / disabled` (solo lectura).
+- El archivo debe ser un array YAML de nivel superior; si se estropea, **el arranque falla** (fail-loud).
+- La eliminación completa pasa por `dsh plugin remove` (sección siguiente) y **requiere un reinicio**.
+
+## 6. Desinstalación
+
+```powershell
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+Reinicia dsh web.

package/INSTALL.fr.md

@@ -0,0 +1,130 @@
+# Guide d'installation (CLI DSH officiel)
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+## 0. Prérequis
+
+```powershell
+echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
+dsh --version           # verified on 0.1.1-rc.2 (0.1.x line, plugin <= 0.2.0); 0.2.0-rc.1+ needs plugin >= 0.3.0 (engines >=0.2.0-rc.1 <0.2.1-0)
+pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
+```
+
+## 1. Installation
+
+Depuis GitHub (recommandé — pnpm copie le paquet dans `node_modules`, et le lockfile épingle le commit exact) :
+
+```powershell
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Ou depuis une copie locale (développement) :
+
+```powershell
+dsh plugin --profile web add E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+Ou en mode link (les modifications du source prennent effet après un redémarrage, sans réinstallation) :
+
+```powershell
+dsh plugin --profile web add link:E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+> ⚠️ Une installation locale `file:` / `link:` rend le profil dépendant de ce chemin. Renommer ou supprimer le répertoire casse alors **toutes** les opérations pnpm du profil avec `ENOENT`, jusqu'à suppression de la dépendance devenue obsolète — c'est exactement ce qui s'est produit quand ce paquet a été renommé depuis `dsh-time-wrapper`.
+> ⚠️ Un chemin relatif n'est ancré à **votre répertoire courant** que s'il commence par `.` ou `..` ;
+> `mine-dsh-plugins\dsh-date-wrapper` est résolu à l'intérieur du répertoire du profil et ne sera pas trouvé. Les chemins absolus sont les plus sûrs.
+
+Signes d'une installation réussie :
+
+1. pnpm sort avec le code 0 ;
+2. `C:\Users\<you>\.dsh\profiles\web\package.json` liste `dsh-date-wrapper` sous `dependencies` ;
+3. le `dsh.profile.bundles` du même fichier gagne `dsh-date-wrapper` à la fin (le paquet déclare `dsh.bundle.patch`, il est donc tiré automatiquement dans la liste des couches).
+
+## 2. Redémarrage
+
+```powershell
+# stop the running dsh web process, then start it again
+dsh web
+```
+
+Puis rafraîchissez la page dans le navigateur.
+
+> Les patches de bundle ne sont **pas** rechargés à chaud : seules les couches de patch du profil / du home sont surveillées. Modifier le
+> `cordis.patch.yml` du plugin lui-même ou mettre à jour le plugin exige toujours un redémarrage.
+
+## 3. Vérification
+
+Ouvrez une nouvelle session et envoyez n'importe quel message. La date est suspendue à l'**instantané du contexte d'exécution** (affiché dans la session comme une ligne de contexte injecté provenant de `system-prompt`), sous la forme :
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+C'est `Current date: ` + `<ISO date> <IANA zone> <English weekday>`, 46 caractères (~12 tokens), **sans heure, minute ni seconde**.
+
+Vous pouvez aussi exercer le plugin lui-même depuis la ligne de commande :
+
+```powershell
+cd E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+node tests/format.test.mjs
+node tests/context.test.mjs
+```
+
+## 4. Dépannage
+
+| Symptôme | Cause et correction |
+|---------|---------------|
+| Le démarrage échoue avec `date-wrapper: 非法 IANA timeZone` | Le `timeZone` de `cordis.patch.yml` est incorrect. C'est un **fail-fast volontaire** : mieux vaut échouer au démarrage que d'émettre silencieusement une date fausse en UTC |
+| Le démarrage échoue avec `duplicate loader entry id: date-wrapper` | L'arbre d'assemblage contient déjà une ligne avec cet id ; supprimez le doublon |
+| Pas de date après l'installation | ① vérifiez que `dsh-date-wrapper` figure dans `dsh.profile.bundles` ; ② vérifiez que vous avez redémarré et rafraîchi la page ; ③ **vérifiez que le preset courant n'est pas à prompt fixe** (ligne suivante) |
+| Pas de date sous certains presets | La persona de ce preset définit `includeRuntimeContext: false` (c'est le cas du `minimal` officiel et du `simple-reply` local). De tels presets interdisent explicitement aux listeners ultérieurs d'ajouter du contenu au prompt, donc le contexte d'exécution de ce plugin est abandonné — comportement attendu |
+| La date est décalée d'un jour | `timeZone` ne correspond pas à votre zone réelle ; à cheval sur une frontière de zone (par ex. 00:30 à Pékin = 16:30 UTC la veille), cela se traduit par un écart d'un jour |
+| Vous voyez aussi `Time sampled …` | Un preset monte `@deepseek-ai/dsh-time-context` explicitement. Ce plugin ne le charge ni ne le filtre ; les deux ne doivent pas être utilisés ensemble |
+| Toute opération pnpm du profil échoue avec `ENOENT: no such file or directory, open '…'` | Une dépendance `file:` / `link:` pointe vers un chemin qui n'existe plus (le paquet a été renommé ou son tarball supprimé). Supprimez la dépendance obsolète avec `dsh plugin --profile web remove <name>` puis réinstallez ; les installations `github:` n'ont pas ce mode de défaillance |
+
+## 5. Marche/arrêt (pas de bouton dans un panneau — l'activation est l'interrupteur)
+
+Désactivez-le ou réactivez-le dans votre propre couche de patch de profil — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml` :
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **À chaud, sans redémarrage** : le fichier est surveillé par le HMR de Cordis ; `disabled: true` détruit la fiber de la ligne et l'injection s'arrête immédiatement.
+- La page **Settings → Plugins** intégrée à DSH affiche `enabled / disabled` (en lecture seule).
+- Le fichier doit être un tableau YAML de premier niveau ; le rendre mal formé fait **échouer le démarrage** (fail-loud).
+- La suppression complète passe par `dsh plugin remove` (section suivante) et **nécessite un redémarrage**.
+
+## 6. Désinstallation
+
+```powershell
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+Redémarrez dsh web.

package/INSTALL.it.md

@@ -0,0 +1,130 @@
+# Guida all'installazione (CLI DSH ufficiale)
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+## 0. Prerequisiti
+
+```powershell
+echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
+dsh --version           # verified on 0.1.1-rc.2 (0.1.x line, plugin <= 0.2.0); 0.2.0-rc.1+ needs plugin >= 0.3.0 (engines >=0.2.0-rc.1 <0.2.1-0)
+pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
+```
+
+## 1. Installazione
+
+Da GitHub (consigliato — pnpm copia il pacchetto in `node_modules` e la lockfile fissa il commit esatto):
+
+```powershell
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Oppure da una copia locale (sviluppo):
+
+```powershell
+dsh plugin --profile web add E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+Oppure in modalità link (le modifiche al sorgente fanno effetto dopo un riavvio, senza reinstallare):
+
+```powershell
+dsh plugin --profile web add link:E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+```
+
+> ⚠️ Un'installazione locale `file:` / `link:` rende il profilo dipendente da quel percorso. Rinominare o eliminare la directory rompe poi **ogni** operazione pnpm nel profilo con `ENOENT`, finché la dipendenza obsoleta non viene rimossa — è esattamente ciò che è successo quando questo pacchetto è stato rinominato da `dsh-time-wrapper`.
+> ⚠️ Un percorso relativo è ancorato alla **directory corrente** solo se inizia con `.` o `..`;
+> `mine-dsh-plugins\dsh-date-wrapper` viene risolto dentro la directory del profilo e non sarà trovato. I percorsi assoluti sono i più sicuri.
+
+Segnali di un'installazione riuscita:
+
+1. pnpm esce con codice 0;
+2. `C:\Users\<you>\.dsh\profiles\web\package.json` elenca `dsh-date-wrapper` sotto `dependencies`;
+3. il `dsh.profile.bundles` dello stesso file guadagna `dsh-date-wrapper` in coda (il pacchetto dichiara `dsh.bundle.patch`, quindi viene tirato automaticamente nell'elenco dei layer).
+
+## 2. Riavvio
+
+```powershell
+# stop the running dsh web process, then start it again
+dsh web
+```
+
+Poi ricaricate la pagina nel browser.
+
+> Le patch bundle **non** fanno hot-reload: vengono sorvegliati solo i layer di patch del profilo / della home. Modificare il
+> `cordis.patch.yml` del plugin stesso o aggiornare il plugin richiede sempre un riavvio.
+
+## 3. Verifica
+
+Aprite una nuova sessione e inviate un messaggio qualsiasi. La data è appesa allo **snapshot del contesto di runtime** (mostrata in sessione come una riga di contesto iniettato proveniente da `system-prompt`), così:
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+È `Current date: ` + `<ISO date> <IANA zone> <English weekday>`, 46 caratteri (~12 token), **senza ora, minuto o secondo**.
+
+Potete anche esercitare il plugin stesso dalla riga di comando:
+
+```powershell
+cd E:\test\rewrite-agently\mine-dsh-plugins\dsh-date-wrapper
+node tests/format.test.mjs
+node tests/context.test.mjs
+```
+
+## 4. Risoluzione dei problemi
+
+| Sintomo | Causa e rimedio |
+|---------|---------------|
+| L'avvio fallisce con `date-wrapper: 非法 IANA timeZone` | Il `timeZone` in `cordis.patch.yml` è sbagliato. È un **fail-fast voluto**: meglio fallire all'avvio che emettere silenziosamente una data sbagliata in UTC |
+| L'avvio fallisce con `duplicate loader entry id: date-wrapper` | L'albero di assemblaggio ha già una riga con quell'id; eliminate il duplicato |
+| Nessuna data dopo l'installazione | ① confermate che `dsh-date-wrapper` è in `dsh.profile.bundles`; ② confermate di aver riavviato e ricaricato la pagina; ③ **confermate che il preset corrente non è a prompt fisso** (riga successiva) |
+| Nessuna data con alcuni preset | La persona di quel preset imposta `includeRuntimeContext: false` (lo fanno sia il `minimal` ufficiale sia il `simple-reply` locale). Tali preset vietano esplicitamente ai listener successivi di aggiungere contenuto al prompt, quindi il contesto di runtime di questo plugin viene scartato — comportamento atteso |
+| La data è sfasata di un giorno | `timeZone` non corrisponde alla vostra zona reale; a cavallo di un confine di zona (es. 00:30 a Pechino = 16:30 UTC del giorno prima) questo si manifesta come una differenza di un giorno |
+| Vedete anche `Time sampled …` | Qualche preset monta `@deepseek-ai/dsh-time-context` esplicitamente. Questo plugin non lo carica né lo filtra; i due non vanno usati insieme |
+| Qualsiasi operazione pnpm nel profilo fallisce con `ENOENT: no such file or directory, open '…'` | Una dipendenza `file:` / `link:` punta a un percorso che non esiste più (il pacchetto è stato rinominato o il suo tarball eliminato). Rimuovete la dipendenza obsoleta con `dsh plugin --profile web remove <name>` e reinstallate; le installazioni `github:` non hanno questa modalità di guasto |
+
+## 5. On/off (nessun toggle nel pannello — l'attivazione è l'interruttore)
+
+Disattivatelo o riattivatelo nel vostro layer di patch del profilo — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml`:
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **A caldo, senza riavvio**: il file è sorvegliato dall'HMR di Cordis; `disabled: true` dispose la fiber della riga e l'iniezione si ferma subito.
+- La pagina **Settings → Plugins** integrata in DSH mostra `enabled / disabled` (sola lettura).
+- Il file deve essere un array YAML di primo livello; renderlo malformato fa **fallire l'avvio** (fail-loud).
+- La rimozione completa passa per `dsh plugin remove` (sezione seguente) e **richiede un riavvio**.
+
+## 6. Disinstallazione
+
+```powershell
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+Riavviate dsh web.

package/INSTALL.ja.md

@@ -4,19 +4,34 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
 
 ## 0. 前提条件
 
 ```powershell
 echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
-dsh --version           # this guide was verified on 0.1.1-rc.2
+dsh --version           # このガイドは 0.1.1-rc.2 で検証（0.1.x 系、プラグイン ≤ 0.2.0）。0.2.0-rc.1+ はプラグイン ≥ 0.3.0 が必要（engines >=0.2.0-rc.1 <0.2.1-0）
 pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
 ```
 

package/INSTALL.ko.md

@@ -4,19 +4,34 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
 
 ## 0. 사전 요구 사항
 
 ```powershell
 echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
-dsh --version           # this guide was verified on 0.1.1-rc.2
+dsh --version           # 이 가이드는 0.1.1-rc.2에서 검증됨(0.1.x 라인, 플러그인 ≤ 0.2.0). 0.2.0-rc.1+에는 플러그인 ≥ 0.3.0 필요(engines >=0.2.0-rc.1 <0.2.1-0)
 pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
 ```
 

package/INSTALL.md

@@ -4,19 +4,34 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
 
 ## 0. Prerequisites
 
 ```powershell
 echo $env:DSH_HOME      # usually C:\Users\<you>\.dsh
-dsh --version           # this guide was verified on 0.1.1-rc.2
+dsh --version           # verified on 0.1.1-rc.2 (0.1.x line, plugin <= 0.2.0); 0.2.0-rc.1+ needs plugin >= 0.3.0 (engines >=0.2.0-rc.1 <0.2.1-0)
 pnpm --version          # `dsh plugin` is a pnpm forwarder, so pnpm must be on PATH
 ```