dsh-date-wrapper 0.3.0 → 0.4.0

package/README.md

@@ -4,28 +4,38 @@
 - [中文 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)
 
 > **▼ DSH version compatibility**
 >
-> | DSH version | Load | Host contract | Client half |
-> | --- | --- | --- | --- |
-> | 0.1.0-rc.7 ~ 0.1.7.x (0.1.x line) | ✅ artifact ≤ 0.2.0 | `systemPrompt.context({ name, order, text })` | — (host-only plugin) |
-> | 0.2.0-rc.1+ (`>=0.2.0-rc.1 <0.2.1-0`) | ✅ artifact ≥ 0.3.0 | same signature; `packages/core/system-prompt` diff vs `dsh-v0.1.7-rc.2` is the version string only | — (host-only plugin) |
->
-> One contract covers all lines: the plugin only calls `systemPrompt.context`, whose
-> signature and semantics are unchanged from `dsh-v0.1.1-rc.2` through
-> `dsh-v0.2.0-rc.1`. It registers no settings namespace, reads no session data and
-> makes no RPC call, so the 0.1.1 → 0.1.2 client/session/persistence rewrites and
-> the 0.1.7 → 0.2.0-rc.1 host changes do not touch it. Older 0.1.x hosts stay on
-> artifact ≤ 0.2.0 (dist-tag `dsh-0.1.7`); the 0.2.0 line is served by artifact
-> ≥ 0.3.0.
+> The supported DSH version list is **script-managed, not hand-written** — see the
+> generated block below (single source: `scripts/hosts.mjs`; distributed by
+> `scripts/sync-hosts.mjs` to `package.json` peerDependencies + engines.dsh,
+> `dsh.plugin.json`, and this README in nine languages). The plugin's single host
+> contract is `systemPrompt.context({ name, order, text })`; it registers no
+> settings namespace, reads no session data and makes no RPC call, so host-side
+> client/session/persistence rewrites do not touch it.
 
 > A minimal date line: it hangs `Current date: 2026-09-08 Asia/Shanghai Tuesday` (46 characters, ~12 tokens) onto the runtime-context snapshot DSH already sends.
 > It does **not** load `@deepseek-ai/dsh-time-context`, does **not** add extra session messages, does **not** patch DSH source, and needs no PR.
@@ -33,6 +43,11 @@
 - [How it works: DSH sessions, JSONL and request assembly](./docs/dsh-session-and-context-mechanics.md) (Chinese)
 - [HANDOVER.md](./HANDOVER.md) (Chinese)
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Supported DSH hosts:** `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` (15 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Runtime-verified:** `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` — evidence in `.compat-results/`
+<!-- host-compat:end -->
+
 ## What this plugin solves
 
 DSH's own `@deepseek-ai/dsh-time-context` injects about **280 characters** of metadata on every request:
@@ -61,13 +76,16 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 | Item | Verdict |
 |------|---------|
-| Target DSH versions | 0.1.0-rc.7 → 0.1.7.x (0.1.x line — artifact ≤ 0.2.0) and 0.2.0-rc.1 → 0.2.0.x (0.2.0 line, `engines.dsh: >=0.2.0-rc.1 <0.2.1-0` — artifact ≥ 0.3.0) |
+| Target DSH versions | Script-managed enum — `scripts/hosts.mjs` (15 rc releases across lines 0.1.0 → 0.2.0); runtime-verified list in the generated block at the top |
 | settings API | **Not applicable**: the plugin registers no settings and exports no schemastery `Config` |
 | Contract points used | Exactly one — `systemPrompt.context()` |
 | Conflict with a native feature | Overlaps `@deepseek-ai/dsh-time-context`; **do not use both**. Not installed by default = off by default |
 | Browser half | **None**: no slot, no DOM, no CSS semantic tokens |
 | DSH package imports | **Zero**: nothing from `@deepseek-ai/*`, which is stricter than the "runtime detection + dual API fallback" pattern |
 
+Historical static audit (npm-pack type diff, kept for reference; **version-support
+claims now come from the enum + runtime matrix, not from this table**):
+
 | Contract point | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
 |---|---|---|---|---|---|---|
 | `systemPrompt.context(ctx): () => void` | yes | yes (verified on this host) | yes | yes | yes | yes (diff vs 0.1.7-rc.2: version string only) |
@@ -78,7 +96,7 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 > Method: `npm pack @deepseek-ai/dsh-system-prompt@<version>`, unpack, and compare `lib/types/index.d.ts` and `lib/index.js`; the same for `@deepseek-ai/dsh-agent-loop`.
 > Between `dsh-v0.1.7-rc.2` and `dsh-v0.2.0-rc.1` the `packages/core/system-prompt` diff is a single version line, the 110/115/120 `systemPrompt.context` call sites are unchanged, and the plugin migration guide has no `systemPrompt` entry.
-> Only 0.1.1-rc.2 has been verified **at runtime** on this host; runtime smoke on 0.2.0-rc.1 is tracked in `HANDOVER.md` §7.
+> Runtime verification is now **per host rc in the local isolation matrix** (`scripts/test-host-compat.mjs`, evidence in `.compat-results/`); the green list is the generated block at the top of this README. The 0.1.1-rc.2 note in `HANDOVER.md` §7 predates the matrix.
 
 ## Why a runtime-context snapshot instead of a message
 

package/README.ru.md

@@ -0,0 +1,236 @@
+# dsh-date-wrapper
+
+- [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)
+
+> Список поддерживаемых версий DSH **управляется скриптом, а не пишется вручную** — см. сгенерированный блок ниже (единственный источник: `scripts/hosts.mjs`; распространяется `scripts/sync-hosts.mjs` в `package.json` peerDependencies + engines.dsh, `dsh.plugin.json` и этот README на девяти языках). Единственный контракт плагина с хостом — `systemPrompt.context({ name, order, text })`; он не регистрирует namespace настроек, не читает данные сессий и не делает RPC-вызовов — переработки на стороне хоста его не затрагивают.
+
+> Минималистичная строка с датой: она подвешивает `Current date: 2026-09-08 Asia/Shanghai Tuesday` (46 символов, ~12 токенов) к снимку контекста времени выполнения, который DSH и так уже отправляет.
+> Она **не** загружает `@deepseek-ai/dsh-time-context`, **не** добавляет лишних сообщений в сессию, **не** патчит исходники DSH и не требует PR.
+
+- [Как это работает: сессии DSH, JSONL и сборка запроса](./docs/dsh-session-and-context-mechanics.md) (китайский)
+- [HANDOVER.md](./HANDOVER.md) (китайский)
+
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Поддерживаемые хосты 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` (15 rc по линиям 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Проверено на этапе выполнения:** `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` — доказательства в `.compat-results/`
+<!-- host-compat:end -->
+
+## Какую задачу решает этот плагин
+
+Собственный `@deepseek-ai/dsh-time-context` в DSH внедряет при каждом запросе около **280 символов** метаданных:
+
+```
+Time sampled while preparing turn 3, step 2: 2026-09-08T16:05:36+08:00[Asia/Shanghai]
+Browser time zone for this request: Asia/Shanghai. Interpret otherwise-unqualified dates and times in this zone.
+Elapsed since the preceding model-visible message: 2m 34s.
+```
+
+Этот плагин сжимает ту же информацию в одну строку из **46 символов** и меняет место её назначения — она больше не попадает в поток сообщений:
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+| Измерение | `dsh-time-context` | `dsh-date-wrapper` |
+|-----------|--------------------|--------------------|
+| Внедряемый текст | ~280 символов | 46 символов (↓84%), ~12 токенов |
+| Место назначения | Одно сообщение на каждый pre-step (`user/message`) | Снимок контекста времени выполнения платформы (`systemPrompt.context`) |
+| Частота | Одно событие на каждый подходящий step | Повторно отправляется со снимком только при изменении текста (0 событий в течение суток) |
+| Зависимость | Сервис `agents` | Сервис `systemPrompt` |
+| Зависимости времени выполнения | — | нет |
+
+## Совместимость версий
+
+| Пункт | Вердикт |
+|------|---------|
+| Целевые версии DSH | 0.1.0-rc.7 → 0.1.7.x (линия 0.1.x — артефакт ≤ 0.2.0) и 0.2.0-rc.1 → 0.2.0.x (линия 0.2.0, `engines.dsh: >=0.2.0-rc.1 <0.2.1-0` — артефакт ≥ 0.3.0) |
+| settings API | **Неприменимо**: плагин не регистрирует настройки и не экспортирует schemastery-`Config` |
+| Используемые точки контракта | Ровно одна — `systemPrompt.context()` |
+| Конфликт со встроенной функцией | Пересекается с `@deepseek-ai/dsh-time-context`; **не использовать оба сразу**. Не установлен по умолчанию = выключен по умолчанию |
+| Браузерная половина | **Отсутствует**: ни slot, ни DOM, ни CSS-семантических токенов |
+| Импорты пакетов DSH | **Ноль**: ничего из `@deepseek-ai/*`, что строже паттерна «определение в рантайме + двойной API-фолбэк» |
+
+| Точка контракта | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
+|---|---|---|---|---|---|---|
+| `systemPrompt.context(ctx): () => void` | да | да (проверено на этом хосте) | да | да | да | да (diff относительно 0.1.7-rc.2: только строка версии) |
+| `PromptContext = { name, order, text }`, без поля `complete` | да | да | да | да | да | да |
+| `includeRuntimeContext` / `suppressRuntimeContext` | да | да | да | да | да | да |
+| дедупликация по тексту в `project()` agent-loop и `surfaceOp: "append"` | да | да | да | не сравнивалось | да | да |
+| `order: 116` без коллизий (110 / 115 / 120 заняты) | да | да | да | да | да | да |
+
+> Метод: `npm pack @deepseek-ai/dsh-system-prompt@<version>`, распаковать и сравнить `lib/types/index.d.ts` и `lib/index.js`; то же для `@deepseek-ai/dsh-agent-loop`.
+> Между `dsh-v0.1.7-rc.2` и `dsh-v0.2.0-rc.1` diff `packages/core/system-prompt` — одна строка версии, точки вызова `systemPrompt.context` на 110/115/120 не тронуты, а в гайде по миграции плагинов нет ни одного упоминания `systemPrompt`.
+> **В рантайме** проверена только 0.1.1-rc.2 на этом хосте; runtime-смоук 0.2.0-rc.1 отслеживается в `HANDOVER.md` §7.
+
+## Почему снимок контекста времени выполнения, а не сообщение
+
+Первая попытка копировала `dsh-time-context` и добавляла `user/message` в `agent/pre-step`. Измеренные затраты оказались слишком велики: каждое JSONL-событие весит **339 байт** (на текст приходится лишь 46, потому что `content` и `sections` хранят по копии), и такое событие писалось **каждый ход**.
+
+При регистрации контекста времени выполнения вместо этого дата складывается в то сообщение-снимок, которое платформа уже отправляет:
+
+- Платформа **дедуплицирует снимки по тексту** (`RuntimeContextProjection.project()` в `dsh-agent-loop`: `if (this.retained?.text === snapshot) return`), поэтому пока дата не меняется, **не пишется ни одного лишнего события**;
+- Снимки **дописывают** новое сообщение (`surfaceOp: 'append'`), а не переписывают существующее, поэтому последовательность запроса только растёт → **префиксный кэш сохраняется**;
+- Наши предельные затраты — те самые 46 байт, и только когда снимок переотправляется из-за изменения текста.
+
+Измерено на этом хосте (одна реальная сессия, 10 ходов / 231 шаг):
+
+| Пункт | Измерено |
+|------|----------|
+| Снимки контекста времени выполнения платформы | 2 события, по 1133 Б, всего 2,3 КБ |
+| Реальные сообщения пользователя | 10 событий, по 396 Б |
+| Старый подход (одно сообщение на ход) | 10 × 339 Б ≈ 3,4 КБ |
+| Этот подход | 0 лишних событий; ~46 Б складываются в существующий снимок |
+
+## Конфигурация
+
+Поставляется в `cordis.patch.yml`; после изменения требуется перезапуск:
+
+```yaml
+- insert:
+    - id: date-wrapper
+      name: dsh-date-wrapper
+      config:
+        timeZone: Asia/Shanghai   # IANA zone; omit to use the process zone
+```
+
+- Некорректный `timeZone` бросает исключение при старте (**никакого** тихого фолбэка на UTC).
+- Имя зоны в тексте — это разрешённое имя IANA (имя зоны процесса, если `timeZone` не указан).
+- Запись контекста времени выполнения называется `date-wrapper:date` с order `116` (занято: 110 sandbox, 115 approval, 120 subagent).
+- Плагин **не экспортирует schemastery-`Config`**, поэтому его конфигурация не проходит схемную валидацию хоста; всё проверяется вручную в `validateConfig()`. Именно поэтому на странице Settings → Plugins для него нет формы конфигурации.
+
+## Включение/выключение: переключатель — это активация плагина, отдельной панели нет
+
+Плагин не содержит **ни** переключателя в панели настроек, **ни** поля конфигурации `enabled`, потому что:
+
+- Переключатель функции — это и есть *активность строки плагина*. Неактивна → `apply()` не выполняется → записи контекста времени выполнения не существует → не внедряется ни одного символа.
+- Браузерной половины нет (`dsh.client`), поэтому в UI нет ни одного нашего виджета.
+- Встроенная страница DSH **Settings → Plugins** уже показывает статус каждой записи как `enabled / disabled` (только для чтения).
+
+### Как выключить
+
+Переопределите её по `id` в **своём собственном** слое profile patch — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml`:
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **Горячо, без перезапуска**: файл наблюдается Cordis HMR, и `disabled: true` немедленно уничтожает fiber этой строки.
+- Если строки `date-wrapper` ещё нет (не установлен), этот patch лишь запишет предупреждение `entry "date-wrapper" not found`; старт всё равно пройдёт успешно.
+- ⚠️ Файл должен быть **YAML-массивом верхнего уровня**; если он повреждён, **старт падает** (DSH для пользовательских слоёв patch работает по принципу fail-loud).
+
+### Как удалить полностью
+
+```bash
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+Удаление идёт через слой bundle и **требует перезапуска** dsh web (bundle-patch не перезагружаются на лету).
+
+## Установка
+
+```bash
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Перезапустите dsh web и обновите страницу. Локальные пути, режим link и устранение неполадок: [INSTALL.ru.md](./INSTALL.ru.md).
+
+## Проверка
+
+| # | Как | Ожидается |
+|---|-----|----------|
+| A1 | Открыть новую сессию и отправить одно сообщение | В снимке контекста времени выполнения появляется `Current date: YYYY-MM-DD <zone> <weekday>` (показывается как строка внедрённого контекста с источником `system-prompt`) |
+| A2 | Проверить эту строку | ≤50 символов (измерено 46; порог PRD в 30 был смягчён ради запрошенного формата) |
+| A3 | Отключить плагин (profile patch `disabled: true`) | Строка больше не появляется в снимках последующих сессий |
+| A4 | Поискать в журнале сессии | Нет `Time sampled` / `Elapsed since` / `Browser time zone` |
+| A5 | Поставить `timeZone` в `UTC` и перезапустить | Дата следует UTC (на границе зон возможен сдвиг в один день) |
+
+## Примечания по реализации
+
+```
+dsh-date-wrapper/
+├── package.json          # name / type: module / main / exports["."] / dsh.bundle.patch / files
+├── cordis.patch.yml      # one insert row (no patch-level id → lands at the profile root = host plane)
+├── src/
+│   ├── format.js         # pure functions: resolveZone / renderDate / createDateContextText / validateConfig / TEXT_LABEL
+│   └── index.js          # apply(ctx, config) → ctx.inject(['systemPrompt'], …) → systemPrompt.context(...)
+└── tests/
+    ├── format.test.mjs   # 11 cases (zone projection, weekday, format and length, degradation, config validation)
+    └── context.test.mjs  # 7 cases (registration contract against a fake ctx)
+```
+
+- **Строка на плоскости хоста**: `ctx.inject(['systemPrompt'], …)` открывает дочернюю fiber; если сервиса нет, плагин молча ничего не регистрирует, вместо того чтобы уронить всю загрузку.
+- **Fail-soft провайдер текста**: исключение во время сборки промпта уронило бы **каждый** запрос, поэтому при ошибке рендера возвращается пустая строка (платформа отфильтровывает пустой текст).
+- **Без `complete`**: если его задать, он затрёт весь системный промпт.
+- **Дедупликация — задача платформы**: никакого состояния per-agent не хранится; после полуночи снимок просто несёт новую дату.
+- **Жизненный цикл**: регистрация принадлежит дочерней fiber `ctx.inject` и освобождается при деактивации плагина.
+
+## Разработка: TDD + lint
+
+```bash
+npm install          # devDependencies only (eslint / @eslint/js); zero runtime dependencies
+
+npm run tdd          # watch mode: rerun on src/ or tests/ changes (node --test --watch)
+npm test             # one full run: node --test "tests/*.test.mjs"
+node tests/format.test.mjs   # run a single file (most reliable under a sandbox: no child process)
+
+npm run lint         # eslint . (src + tests + eslint.config.mjs)
+npm run lint:fix     # auto-fix what can be fixed
+npm run verify       # lint + test; run this before committing
+```
+
+### Красный-зелёный-рефакторинг
+
+Тест-кейсы напрямую соответствуют критериям приёмки: сначала пишется падающая проверка, затем её доводят до зелёной.
+
+| Шаг | Действие | Команда |
+|------|--------|---------|
+| 1 красный | Добавить в `tests/*.test.mjs` проверку, названную по критерию приёмки, которая проверяет поведение, которого у вас **ещё нет** | `npm run tdd` |
+| 2 зелёный | Написать в `src/` минимальную реализацию, чтобы она прошла, не трогая другие проверки | `npm run tdd` |
+| 3 рефакторинг | Оставаясь в зелёном, переименовывать и выделять чистые функции; вся чистая логика живёт в `src/format.js`, `src/index.js` только регистрирует | `npm run tdd` |
+| 4 шлюз | Перед коммитом прогнать lint + весь набор тестов | `npm run verify` |
+
+Сегодня 18 проверок: `format.test.mjs` (11) покрывает чистые функции, `context.test.mjs` (7) проверяет контракт регистрации против фейкового ctx.
+
+### Особенности конфигурации lint
+
+- ESLint 10 flat config (`eslint.config.mjs`) с `@eslint/js` recommended в качестве базовой линии.
+- Ужесточённые правила: `eqeqeq`, `prefer-const`, `object-shorthand`, `no-unused-vars` (префикс `_` освобождён).
+- Глобальные объекты Node `crypto` / `console` / `process` объявлены явно, иначе `no-undef` даёт ложные срабатывания.
+
+## Известные ограничения
+
+- **Не работает с fixed-prompt-пресетами**: если persona пресета задаёт `includeRuntimeContext: false` (так делают и официальный `minimal`, и локальный `simple-reply`), `assemble()` возвращает `contexts: []`, и запись этого плагина отбрасывается целиком. Такие пресеты специально запрещают последующим listener'ам добавлять что-либо в промпт.
+- **Старые снимки остаются в истории**: при смене даты платформа дописывает новый снимок (старый сохраняется), а новый вступает в силу благодаря собственному объявлению "This snapshot supersedes earlier runtime-context snapshots" — точно так же платформа обрабатывает смены cwd / sandbox / политики одобрения.
+- **Bundle-patch не перезагружаются на лету**: изменение `cordis.patch.yml` или обновление плагина требует перезапуска dsh web (изменение `disabled` в profile patch срабатывает горячо).
+- **`dsh-time-context` не загружается и не фильтруется**: если вы явно смонтируете его в пресете, его подробный текст появится как обычно. Не использовать оба.
+- **Нет runtime-пробы точки контракта**: `systemPrompt.context` вызывается без защиты, поэтому будущее переименование со стороны DSH проявится как ошибка загрузки плагина, а не как тихая деградация (см. `HANDOVER.md` §7).
+
+## Лицензия
+
+MIT

package/README.zh.md

@@ -4,26 +4,36 @@
 - [中文 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)
 
 > **▼ DSH 版本适配**
 >
-> | DSH 版本 | 加载 | 宿主契约 | 客户端半 |
-> | --- | --- | --- | --- |
-> | 0.1.0-rc.7 ~ 0.1.7.x（0.1.x 线） | ✅ 产物 ≤ 0.2.0 | `systemPrompt.context({ name, order, text })` | —（纯宿主插件） |
-> | 0.2.0-rc.1+（`>=0.2.0-rc.1 <0.2.1-0`） | ✅ 产物 ≥ 0.3.0 | 同一签名；`packages/core/system-prompt` 相对 `dsh-v0.1.7-rc.2` 的 diff 仅版本号一行 | —（纯宿主插件） |
->
-> 一份契约覆盖所有版本线：插件只调用 `systemPrompt.context`，其签名与语义从
-> `dsh-v0.1.1-rc.2` 到 `dsh-v0.2.0-rc.1` 未变。它不注册设置命名空间、不读会话
-> 数据、不发 RPC，因此 0.1.1 → 0.1.2 的客户端／会话／持久化重写与 0.1.7 →
-> 0.2.0-rc.1 的宿主改动都与它无关。旧 0.1.x 宿主请使用产物 ≤ 0.2.0（dist-tag
-> `dsh-0.1.7`）；0.2.0 线由产物 ≥ 0.3.0 服务。
+> 支持的 DSH 版本清单是**脚本下发、禁止手改**的 —— 见下方自动生成的管理块
+> （单一事实源：`scripts/hosts.mjs`；由 `scripts/sync-hosts.mjs` 下发到
+> `package.json` peerDependencies + engines.dsh、`dsh.plugin.json` 与九语 README）。
+> 插件唯一宿主契约是 `systemPrompt.context({ name, order, text })`：不注册设置
+> 命名空间、不读会话数据、不发 RPC，宿主侧客户端／会话／持久化重写都与它无关。
 
 > 精简版时间注入：把 `Current date: 2026-09-08 Asia/Shanghai Tuesday`（46 字符 ≈ 12 token）挂进 DSH 自带的运行上下文快照。
 > 不加载 `@deepseek-ai/dsh-time-context`，不产生额外会话消息，不改 DSH 源码，不提 PR。
@@ -31,6 +41,11 @@
 - [机制详解：DSH 会话、JSONL 与请求组装](./docs/dsh-session-and-context-mechanics.md)（中文）
 - [交接文档 HANDOVER.md](./HANDOVER.md)（中文）
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **支持的 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.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 六条线共 15 个 rc）
+- **运行时已验证：** `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`（证据见 `.compat-results/`）
+<!-- host-compat:end -->
+
 ## 这个插件解决什么
 
 DSH 自带的 `@deepseek-ai/dsh-time-context` 每次请求注入约 **280 字符**的元数据：
@@ -59,13 +74,15 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 | 项 | 结论 |
 |---|---|
-| 目标 DSH 版本 | 0.1.0-rc.7 → 0.1.7.x（0.1.x 线 — 产物 ≤ 0.2.0）与 0.2.0-rc.1 → 0.2.0.x（0.2.0 线，`engines.dsh: >=0.2.0-rc.1 <0.2.1-0` — 产物 ≥ 0.3.0） |
+| 目标 DSH 版本 | 脚本管理枚举 —— `scripts/hosts.mjs`（0.1.0 → 0.2.0 六条线共 15 个 rc）；运行时已验证清单见文首自动生成块 |
 | settings API | **不适用**：本插件不注册 settings，也不导出 schemastery `Config` |
 | 使用的契约点 | 只有一个 —— `systemPrompt.context()` |
 | 与原生功能冲突 | `@deepseek-ai/dsh-time-context` 功能重叠，**不要同时使用**。本插件默认不安装 = 默认关闭 |
 | client 半 | **无**：不涉及 slot / DOM / CSS 语义 token |
 | DSH 包 import | **零**：不 `import` 任何 `@deepseek-ai/*`，比「运行时检测 + 双 API 回退」更保守 |
 
+历史静态审计（npm-pack 类型比对，留档用；**版本支持声明现以枚举 + 运行时矩阵为准，不再以本表为准**）：
+
 | 契约点 | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
 |---|---|---|---|---|---|---|
 | `systemPrompt.context(ctx): () => void` | ✅ | ✅（本机实装验证） | ✅ | ✅ | ✅ | ✅（相对 0.1.7-rc.2 diff 仅版本号） |
@@ -76,7 +93,7 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 > 验证方式：`npm pack @deepseek-ai/dsh-system-prompt@<版本>` 解包后比对 `lib/types/index.d.ts` 与 `lib/index.js`；`@deepseek-ai/dsh-agent-loop` 同法。
 > `dsh-v0.1.7-rc.2` 与 `dsh-v0.2.0-rc.1` 之间，`packages/core/system-prompt` 的 diff 仅版本号一行，110/115/120 的 `systemPrompt.context` 调用点原位未动，插件迁移指南无任何 `systemPrompt` 条目。
-> **运行时**只在本机 0.1.1-rc.2 上验证过；0.2.0-rc.1 的运行时冒烟记录见 `HANDOVER.md` §7。
+> 运行时验证现按宿主 rc 逐格在**本地隔离矩阵**进行（`scripts/test-host-compat.mjs`，证据在 `.compat-results/`）；绿名单即文首自动生成块。`HANDOVER.md` §7 的 0.1.1-rc.2 记录先于矩阵，属历史。
 
 ## 为什么用运行上下文快照，而不是消息
 

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-date-wrapper",
   "name": "dsh-date-wrapper",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": {
     "en": "Minimal date line for the DeepSeek Harness runtime-context snapshot: a single compact line such as 'Current date: 2026-09-08 Asia/Shanghai Tuesday' (46 chars, ~12 tokens). A cordis host plugin with no DSH source changes.",
     "zh": "为 DeepSeek Harness 运行时上下文快照提供极简日期行：形如「Current date: 2026-09-08 Asia/Shanghai Tuesday」的单行紧凑输出（46 字符，约 12 token）。纯 cordis 宿主插件，不改动 DSH 源码。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.2.0-rc.1 <0.2.1-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"
   },
   "components": {
     "host": "src/index.js"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-date-wrapper",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Minimal date line for the DeepSeek Harness runtime-context snapshot: 'Current date: 2026-09-08 Asia/Shanghai Tuesday' (46 chars, ~12 tokens) - a cordis host plugin, no dsh source changes, no PR required",
   "keywords": [
@@ -30,16 +30,11 @@
     "dsh.plugin.json",
     "screenshots.json",
     "README.md",
-    "README.zh.md",
-    "README.ja.md",
-    "README.ko.md",
+    "README.*.md",
     "INSTALL.md",
-    "INSTALL.zh.md",
-    "INSTALL.ja.md",
-    "INSTALL.ko.md",
+    "INSTALL.*.md",
     "CHANGELOG.md",
-    "CHANGELOG.ja.md",
-    "CHANGELOG.ko.md",
+    "CHANGELOG.*.md",
     "HANDOVER.md",
     "LICENSE"
   ],
@@ -49,14 +44,18 @@
     }
   },
   "publishConfig": {
-    "tag": "dsh-0.1.7"
+    "tag": "latest"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@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"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
       "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
     }
   },
   "scripts": {
@@ -72,6 +71,6 @@
   },
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.2.0-rc.1 <0.2.1-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"
   }
 }