dsh-modern-web-guidance 0.3.1 → 0.4.0

package/NOTICE

@@ -7,11 +7,12 @@ This package bundles and adapts material from GoogleChrome/modern-web-guidance
 licensed under the Apache License, Version 2.0.
 
 Bundled without modification:
-  - data/guides.json and data/guides/**/*.md — the Modern Web Guidance use-case corpus
-    (version 0.0.197, skill version 2026_10_30-58d055df). One upstream file,
-    data/guides/built-in-ai/prompt-api.md, is not shipped: it was a byte-identical duplicate of
-    language-model.md and is absent from the upstream index, so the corpus is 193 files for 193
-    index entries.
+  - data/guides.json and data/guides/**/*.md — the Modern Web Guidance corpus
+    (version 1.0.0, skill version 2026_11_09-5bcc021b). data/guides.json is upstream's
+    gen/guides.json, copied unchanged; the guides are the files that index lists. One upstream
+    file, data/guides/built-in-ai/prompt-api.md, is not shipped: it is a byte-identical duplicate
+    of language-model.md and is absent from the upstream index, so the corpus is 208 files for
+    208 index entries (the upstream package itself carries 209 guide files).
   - data/skills/chrome-extensions/** — the Chrome extensions skill
     (skill version 2026_08_06-8570fe7c)
 
@@ -20,12 +21,14 @@ Adapted:
     the agent to call the plugin's local tools instead of the upstream `npx` CLI, and it
     drops the upstream CLI workflow and network-approval sections. The guidance content itself
     is unchanged. The file carries an in-header modification notice.
-  - Cross-references inside the guide bodies are rewritten at load time, not on disk: the 121
-    occurrences of `npx -y modern-web-guidance@latest retrieve "id"` across 45 guides become
+  - Cross-references inside the guide bodies are rewritten at load time, not on disk: the 197
+    occurrences of `npx -y modern-web-guidance@latest retrieve "id"` across 64 guides become
     `web_guidance_retrieve({"ids":["id"]})`, so a retrieved guide never tells an agent to fetch and
     execute an unpinned remote package. The markdown files keep matching the pinned upstream
     snapshot byte for byte.
 
-Removed: the upstream `modern-web-guidance` CLI (search.mjs, modern-web.mjs), the bundled
-TensorFlow.js MiniLM embedder, the usage-vectors file, and the Google Clearcut telemetry
-watchdog. This package performs local lexical search instead and sends no telemetry.
+Removed: the upstream `modern-web-guidance` CLI (search.mjs, modern-web.mjs, legacy-scan.mjs and the
+TypeScript-based scan engine it embeds), the precomputed semantic-search tables under `gen/`
+(query-words.*, guide-chunks.*) and the Google Clearcut telemetry watchdog (`watchdog/`). The 0.x
+packages bundled a TensorFlow.js MiniLM embedder instead of those tables; neither is shipped here.
+This package performs local lexical search instead and sends no telemetry.

package/README.md

@@ -10,7 +10,7 @@
 </p>
 
 <p align="center">
-  193 Baseline-aware guides · 3 tools · 2 skills · zero dependencies · local counters only
+  208 Baseline-aware guides · 3 tools · 2 skills · zero dependencies · local counters only
 </p>
 
 <p align="center">
@@ -25,19 +25,19 @@
   <a href="#security-and-limits"><img alt="Telemetry" src="https://img.shields.io/badge/telemetry-local--only-brightgreen"></a>
   <a href="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml"><img alt="tests" src="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml/badge.svg"></a>
   <a href="https://www.npmjs.com/package/dsh-modern-web-guidance"><img alt="npm" src="https://img.shields.io/npm/v/dsh-modern-web-guidance"></a>
-  <img alt="Guides" src="https://img.shields.io/badge/guides-193-2563eb">
+  <img alt="Guides" src="https://img.shields.io/badge/guides-208-2563eb">
   <img alt="DSH plugin" src="https://img.shields.io/badge/DSH-plugin-0d9488">
 </p>
 
 ---
 
-Coding models default to legacy web patterns because that is what their training data contains. This plugin puts 193
+Coding models default to legacy web patterns because that is what their training data contains. This plugin puts 208
 curated, token-efficient guides in front of the agent, plus an offline search tool, so it reaches for the current
 platform API (native `<dialog>`/popover, anchor positioning, container queries, view transitions, scroll-driven
 effects, `:has()`, passkeys, `fetchpriority`, …) instead of a JavaScript workaround or a library.
 
 Everything runs locally: the guides ship inside the package, search is computed in-process, and there are no network
-calls. Usage counters do exist in 0.2.0, but they never leave the machine — see [Usage stats](#usage-stats).
+calls. Usage counters have existed since 0.2.0, but they never leave the machine — see [Usage stats](#usage-stats).
 
 ## What you get
 
@@ -83,7 +83,7 @@ reach for it. There are three ways to work with it.
 
 ### 1. Just ask for web work (default)
 
-The skill's routing description is "search 193 use-case guides before writing HTML, CSS or client-side JavaScript", so
+The skill's routing description is "search 208 use-case guides before writing HTML, CSS or client-side JavaScript", so
 a normal request is enough — the agent searches, retrieves what it needs, and writes code against the current platform
 API instead of a workaround:
 
@@ -110,7 +110,7 @@ Use this when you want the guarantee, or when the agent skipped the lookup on a
 `web_guidance_list` answers "what is even in here" without spending a retrieval:
 
 ```text
-web_guidance_list({})                          → 193 guides across 17 categories
+web_guidance_list({})                          → 208 guides across 17 categories
 web_guidance_list({"category": "css"})         → the 18 CSS guides by id and title
 web_guidance_search({"query": "view transition"}) → ranked shortlist before you retrieve
 ```
@@ -128,13 +128,13 @@ ones instead of an empty result.
 | Light/dark theme switching | `dark mode toggle` | `dark-mode-toggle` |
 | Sliding tab indicator without JavaScript | `anchor positioning` | `anchor-positioning-tab-underline` |
 | Inline validation that doesn't nag while typing | `form validation after interaction` | `validate-input-after-interaction` |
-| Passwordless sign-in | `passkey sign in` | `passkey-registration` |
+| Passwordless sign-in | `passkey registration` | `passkey-registration` |
 | Faster LCP | `prioritize hero image` | `fetchpriority` guides |
 | A Manifest V3 extension | (skill) `chrome-extensions` | extension skill references |
 
 ## How search works
 
-`lib/guidance.js` builds a BM25 index over the bundled corpus at first use (~1.5 MB of markdown, indexed in a few
+`lib/guidance.js` builds a BM25 index over the bundled corpus at first use (~1.9 MB of markdown, indexed in a few
 hundred milliseconds and cached): title, id, description, `featuresUsed`, headings and body, with stopword filtering,
 a small English stemmer, prefix expansion, and exact id/title containment bonuses. No embeddings, no bundled model, no
 TensorFlow.js — the package stays small and every result is explainable.
@@ -159,12 +159,12 @@ sides are bounded:
   has no dependencies and no lifecycle scripts, so nothing is fetched or run at install time. The only file it writes is
   its own counters file (see [Usage stats](#usage-stats)).
 - **Guides cannot smuggle commands.** Upstream's guide bodies cross-reference each other with
-  `npx -y modern-web-guidance@latest retrieve "…"` (121 occurrences in 45 guides). Those references are rewritten to
+  `npx -y modern-web-guidance@latest retrieve "…"` (197 occurrences in 64 guides). Those references are rewritten to
   `web_guidance_retrieve({"ids":["…"]})` when the index loads, so nothing a model reads from the catalog asks it to
   install and execute an unpinned remote package. The files on disk stay byte-identical to the pinned snapshot.
 - **`web_guidance_retrieve` is bounded**: at most 10 guides and 120 000 characters per call, duplicate ids collapse, the
   unknown-id echo stops at 10, and the renderer says explicitly what was not returned and to request it separately.
-  Retrieving all 193 guides used to hand back 1.5 MB (~450k tokens) in one result.
+  Retrieving all 208 guides would hand back 1.9 MB (~475k tokens) in one result.
 - **`web_guidance_search` is bounded**: the query is capped at 512 characters and 24 distinct terms before the lexical
   scan. A 137 KB query used to block the host's event loop for seconds; the same shape now costs milliseconds.
 - **The catalog cannot reach outside the package**: entry ids and categories must be slugs, and every resolved path is
@@ -178,8 +178,8 @@ while a defect is live.
 
 ## Usage stats
 
-0.2.0 records what the three tools are actually asked for. The counters are local: no endpoint, no analytics service, no
-third-party SDK, and nothing leaves the machine.
+Since 0.2.0 the plugin records what the three tools are actually asked for. The counters are local: no endpoint, no
+analytics service, no third-party SDK, and nothing leaves the machine.
 
 The report is a human slash command, not a tool the agent can call:
 
@@ -201,12 +201,12 @@ Turn it off: set `enabled: false` in the plugin config — no listener is regist
 
 ## Sidebar panel
 
-0.3.0 adds a client half: a guidance icon in the left rail opens **Guidance Insights** in the central area. It shows
-the same counters `/guidance-stats` prints, as a view:
+The plugin adds a client half: a guidance icon in the left rail opens **Guidance Insights** in the central area. It
+shows the same counters `/guidance-stats` prints, as a view:
 
 - total calls and hit rate for the last 7 days
 - the most frequent queries, with hit and miss counts
-- category coverage — retrieved guides against the 193 in the corpus
+- category coverage — retrieved guides against the 208 in the corpus
 - the queries that found nothing
 - how many guides were never retrieved
 
@@ -224,11 +224,14 @@ counters off (see [Usage stats](#usage-stats)).
 
 ## Updating the guide corpus
 
-The corpus is a pinned snapshot of upstream `modern-web-guidance@0.0.197`
-(skill version `2026_10_30-58d055df`). To refresh it:
+The corpus is a pinned snapshot of upstream `modern-web-guidance@1.0.0`
+(skill version `2026_11_09-5bcc021b`). To refresh it:
 
-1. Download the upstream npm tarball and extract `package/skills/modern-web-guidance/{guides.json,guides}` into
-   `data/`, and `package/skills/chrome-extensions` into `data/skills/`.
+1. Download the upstream npm tarball. The index lives in `gen/`, not at the package root: copy
+   `package/skills/modern-web-guidance/gen/guides.json` to `data/guides.json` and
+   `package/skills/modern-web-guidance/guides/` to `data/guides/`. Ship only the guides listed in that index
+   (208 of the 209 files; `built-in-ai/prompt-api.md` is a byte-identical duplicate of `language-model.md` and
+   is not indexed). Copy `package/skills/chrome-extensions` to `data/skills/`.
 2. Keep `data/skills/modern-web-guidance/SKILL.md` (this plugin's adapted version) — do not overwrite it with the
    upstream CLI-oriented file.
 3. Run `npm test` to confirm the corpus still loads and the smoke queries still rank correctly. The tests also fail if
@@ -241,7 +244,7 @@ The corpus is a pinned snapshot of upstream `modern-web-guidance@0.0.197`
 npm test
 ```
 
-66 tests across seven files: `guidance.test.mjs` covers the index, ranking, retrieval and the stemmer;
+68 tests across seven files: `guidance.test.mjs` covers the index, ranking, retrieval and the stemmer;
 `plugin.test.mjs` covers tool and skill registration against a mocked Cordis context; `hardening.test.mjs` covers the
 audit findings and fails on the pre-hardening code; `telemetry.test.mjs`, `report.test.mjs`, `store.test.mjs` and
 `stats.test.mjs` cover the usage counters, their report, the durable store and the `/guidance-stats` wiring. In a
@@ -258,5 +261,6 @@ Apache-2.0. The guide corpus, the `chrome-extensions` skill, and the source of t
 [GoogleChrome/modern-web-guidance](https://github.com/GoogleChrome/modern-web-guidance) (Copyright Google LLC,
 Apache-2.0). See [NOTICE](NOTICE) for exactly what was copied, adapted, or removed.
 
-This plugin is not an official Google product. It removes the upstream CLI, the bundled TensorFlow.js embedder and the
-Clearcut telemetry watchdog the upstream CLI ships.
+This plugin is not an official Google product. It removes the upstream CLI (`modern-web.mjs`, `search.mjs`,
+`legacy-scan.mjs`), the precomputed semantic-search tables under `gen/` and the Clearcut telemetry watchdog the
+upstream CLI ships (0.x packages bundled a TensorFlow.js MiniLM model instead of those tables).

package/README.ru.md

@@ -10,7 +10,7 @@
 </p>
 
 <p align="center">
-  193 гайда с Baseline-фолбэками · 3 инструмента · 2 скилла · ноль зависимостей · только локальные счётчики
+  208 гайдов с Baseline-фолбэками · 3 инструмента · 2 скилла · ноль зависимостей · только локальные счётчики
 </p>
 
 <p align="center">
@@ -25,19 +25,19 @@
   <a href="#безопасность-и-границы"><img alt="Телеметрия" src="https://img.shields.io/badge/telemetry-local--only-brightgreen"></a>
   <a href="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml"><img alt="Тесты" src="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml/badge.svg"></a>
   <a href="https://www.npmjs.com/package/dsh-modern-web-guidance"><img alt="npm" src="https://img.shields.io/npm/v/dsh-modern-web-guidance"></a>
-  <img alt="Гайды" src="https://img.shields.io/badge/guides-193-2563eb">
+  <img alt="Гайды" src="https://img.shields.io/badge/guides-208-2563eb">
   <img alt="Плагин DSH" src="https://img.shields.io/badge/DSH-plugin-0d9488">
 </p>
 
 ---
 
 Модели по умолчанию пишут веб-код по своему обучающему срезу — то есть тянут паттерны пятилетней давности. Этот
-плагин кладёт перед агентом 193 курируемых, экономных по токенам гайда и офлайн-поиск по ним, чтобы он брал актуальный
+плагин кладёт перед агентом 208 курируемых, экономных по токенам гайдов и офлайн-поиск по ним, чтобы он брал актуальный
 API платформы (нативные `<dialog>`/popover, anchor positioning, container queries, view transitions, scroll-driven
 эффекты, `:has()`, passkeys, `fetchpriority`, …), а не костыль на JavaScript или библиотеку.
 
 Всё работает локально: гайды лежат внутри пакета, поиск считается в процессе, сетевых вызовов нет. Счётчики
-использования в 0.2.0 есть, но они не покидают машину — см. [Статистика использования](#статистика-использования).
+использования есть с 0.2.0, но они не покидают машину — см. [Статистика использования](#статистика-использования).
 
 ## Что вы получаете
 
@@ -82,7 +82,7 @@ dsh plugin --profile desktop add file:E:/path/to/dsh-modern-web-guidance
 
 ### 1. Просто попросить сделать веб-задачу (обычный режим)
 
-Описание скилла для роутинга — «искать по 193 гайдам, прежде чем писать HTML, CSS или клиентский JavaScript», так что
+Описание скилла для роутинга — «искать по 208 гайдам, прежде чем писать HTML, CSS или клиентский JavaScript», так что
 обычного запроса достаточно: агент ищет, достаёт нужное и пишет код под актуальный API платформы вместо костыля:
 
 ```text
@@ -108,7 +108,7 @@ dsh plugin --profile desktop add file:E:/path/to/dsh-modern-web-guidance
 `web_guidance_list` отвечает на вопрос «что там вообще есть», не тратя вызов на извлечение гайда:
 
 ```text
-web_guidance_list({})                             → 193 гайда в 17 категориях
+web_guidance_list({})                             → 208 гайдов в 17 категориях
 web_guidance_list({"category": "css"})            → 18 CSS-гайдов по id и заголовкам
 web_guidance_search({"query": "view transition"}) → ранжированный список до извлечения
 ```
@@ -126,13 +126,13 @@ web_guidance_search({"query": "view transition"}) → ранжированный
 | Переключение светлой и тёмной темы | `dark mode toggle` | `dark-mode-toggle` |
 | Ползущий индикатор вкладки без JavaScript | `anchor positioning` | `anchor-positioning-tab-underline` |
 | Валидация, которая не придирается во время ввода | `form validation after interaction` | `validate-input-after-interaction` |
-| Вход без пароля | `passkey sign in` | `passkey-registration` |
+| Вход без пароля | `passkey registration` | `passkey-registration` |
 | Быстрый LCP | `prioritize hero image` | гайды про `fetchpriority` |
 | Расширение Manifest V3 | (скилл) `chrome-extensions` | материалы скилла про расширения |
 
 ## Как работает поиск
 
-`lib/guidance.js` при первом использовании строит BM25-индекс по встроенному корпусу (~1.5 MB markdown, индексация
+`lib/guidance.js` при первом использовании строит BM25-индекс по встроенному корпусу (~1.9 MB markdown, индексация
 занимает несколько сотен миллисекунд, дальше кэш): заголовок, id, описание, `featuresUsed`, заголовки разделов и
 текст, со стоп-словами, небольшим английским стеммером, префиксным расширением и бонусами за точное совпадение id или
 заголовка. Никаких эмбеддингов, встроенной модели и TensorFlow.js — пакет остаётся компактным, а каждый результат
@@ -159,12 +159,12 @@ CLI через `npx`, сохраняет заметки про фреймвор
   выполняется. Единственный файл, который он пишет, — собственный файл счётчиков (см.
   [Статистика использования](#статистика-использования)).
 - **Гайды не могут протащить команды.** В телах гайдов апстрима есть перекрёстные ссылки вида
-  `npx -y modern-web-guidance@latest retrieve "…"` (121 вхождение в 45 гайдах). При загрузке индекса они
+  `npx -y modern-web-guidance@latest retrieve "…"` (197 вхождений в 64 гайдах). При загрузке индекса они
   переписываются в `web_guidance_retrieve({"ids":["…"]})`, так что ничто прочитанное моделью из каталога не просит
   её установить и выполнить непинённый удалённый пакет. Файлы на диске остаются побайтово равны закреплённому срезу.
 - **`web_guidance_retrieve` ограничен**: не более 10 гайдов и 120 000 символов за вызов, повторяющиеся id
   схлопываются, эхо несуществующих id обрывается на 10, а рендерер прямо говорит, что не вернул и что нужно запросить
-  отдельно. Извлечение всех 193 гайдов раньше отдавало 1.5 MB (~450k токенов) одним результатом.
+  отдельно. Извлечение всех 208 гайдов отдало бы 1.9 MB (~475k токенов) одним результатом.
 - **`web_guidance_search` ограничен**: запрос обрезается до 512 символов и 24 уникальных термов до лексического
   прохода. Запрос на 137 KB раньше блокировал event loop хоста на секунды; та же форма теперь стоит миллисекунды.
 - **Каталог не может выйти за пределы пакета**: id и категории записей обязаны быть слагами, и каждый разрешённый путь
@@ -178,7 +178,7 @@ CLI через `npx`, сохраняет заметки про фреймвор
 
 ## Статистика использования
 
-0.2.0 записывает, что именно спрашивают у трёх инструментов. Счётчики локальные: ни endpoint, ни аналитического
+С версии 0.2.0 плагин записывает, что именно спрашивают у трёх инструментов. Счётчики локальные: ни endpoint, ни аналитического
 сервиса, ни стороннего SDK — за пределы машины ничего не уходит.
 
 Отчёт смотрит человек командой, а не инструментом, который может вызвать агент:
@@ -201,12 +201,12 @@ CLI через `npx`, сохраняет заметки про фреймвор
 
 ## Боковая панель
 
-0.3.0 добавляет клиентскую часть: иконка в левом рейле открывает в центральной области панель
+Плагин добавляет клиентскую часть: иконка в левом рейле открывает в центральной области панель
 **Guidance Insights**. Это те же счётчики, что печатает `/guidance-stats`, только в виде экрана:
 
 - вызовы и доля попаданий за последние 7 дней
 - самые частые запросы с числом попаданий и промахов
-- покрытие категорий — извлечённые гайды против 193 в корпусе
+- покрытие категорий — извлечённые гайды против 208 в корпусе
 - запросы, которые ничего не нашли
 - сколько гайдов не извлекали ни разу
 
@@ -224,11 +224,14 @@ CLI через `npx`, сохраняет заметки про фреймвор
 
 ## Обновление корпуса гайдов
 
-Корпус — это закреплённый срез апстрима `modern-web-guidance@0.0.197` (версия скилла `2026_10_30-58d055df`). Чтобы
+Корпус — это закреплённый срез апстрима `modern-web-guidance@1.0.0` (версия скилла `2026_11_09-5bcc021b`). Чтобы
 обновить:
 
-1. Скачайте npm-тарбол апстрима и распакуйте `package/skills/modern-web-guidance/{guides.json,guides}` в `data/`,
-   а `package/skills/chrome-extensions` в `data/skills/`.
+1. Скачайте npm-тарбол апстрима. Индекс лежит в `gen/`, а не в корне пакета: скопируйте
+   `package/skills/modern-web-guidance/gen/guides.json` в `data/guides.json`, а
+   `package/skills/modern-web-guidance/guides/` в `data/guides/`. Кладите в пакет только гайды из этого индекса
+   (208 из 209 файлов: `built-in-ai/prompt-api.md` — побайтовый дубль `language-model.md`, в индексе его нет).
+   `package/skills/chrome-extensions` скопируйте в `data/skills/`.
 2. Сохраните `data/skills/modern-web-guidance/SKILL.md` — это адаптированная версия этого плагина, не перезаписывайте
    её файлом апстрима, заточенным под CLI.
 3. Запустите `npm test`, чтобы убедиться, что корпус грузится и дымовые запросы по-прежнему ранжируются правильно.
@@ -258,5 +261,6 @@ Apache-2.0. Корпус гайдов, скилл `chrome-extensions` и исх
 [GoogleChrome/modern-web-guidance](https://github.com/GoogleChrome/modern-web-guidance) (Copyright Google LLC,
 Apache-2.0). Что именно скопировано, адаптировано или удалено — см. [NOTICE](NOTICE).
 
-Этот плагин не является официальным продуктом Google. Он убирает CLI апстрима, встроенный эмбеддер на TensorFlow.js и
-сторож телеметрии Clearcut, который поставляется с этим CLI.
+Этот плагин не является официальным продуктом Google. Он убирает CLI апстрима (`modern-web.mjs`, `search.mjs`,
+`legacy-scan.mjs`), предвычисленные таблицы семантического поиска в `gen/` и сторож телеметрии Clearcut, который
+поставляется с этим CLI (в пакетах 0.x вместо этих таблиц лежала модель TensorFlow.js MiniLM).

package/README.zh.md

@@ -10,7 +10,7 @@
 </p>
 
 <p align="center">
-  193 篇带 Baseline 降级方案的指南 · 3 个工具 · 2 个技能 · 零依赖 · 仅本地统计
+  208 篇带 Baseline 降级方案的指南 · 3 个工具 · 2 个技能 · 零依赖 · 仅本地统计
 </p>
 
 <p align="center">
@@ -25,17 +25,17 @@
   <a href="#安全与边界"><img alt="遥测" src="https://img.shields.io/badge/telemetry-local--only-brightgreen"></a>
   <a href="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml"><img alt="测试" src="https://github.com/metapeka/dsh-modern-web-guidance/actions/workflows/test.yml/badge.svg"></a>
   <a href="https://www.npmjs.com/package/dsh-modern-web-guidance"><img alt="npm" src="https://img.shields.io/npm/v/dsh-modern-web-guidance"></a>
-  <img alt="指南" src="https://img.shields.io/badge/guides-193-2563eb">
+  <img alt="指南" src="https://img.shields.io/badge/guides-208-2563eb">
   <img alt="DSH 插件" src="https://img.shields.io/badge/DSH-plugin-0d9488">
 </p>
 
 ---
 
-编程模型默认会写出过时的 Web 代码，因为它们的训练数据里就是这些内容。这个插件把 193 篇经过筛选、节省 token 的
+编程模型默认会写出过时的 Web 代码，因为它们的训练数据里就是这些内容。这个插件把 208 篇经过筛选、节省 token 的
 指南放到智能体面前，并提供离线检索，让它优先使用当前平台 API（原生 `<dialog>`/popover、锚点定位、容器查询、视图
 过渡、滚动驱动效果、`:has()`、passkey、`fetchpriority` 等），而不是自己写 JavaScript 变通方案或引入库。
 
-一切都本地运行：指南随包分发，检索在进程内计算，没有网络请求。0.2.0 里有使用统计，但它不离开这台机器 ——
+一切都本地运行：指南随包分发，检索在进程内计算，没有网络请求。自 0.2.0 起就有使用统计，但它不离开这台机器 ——
 见[使用统计](#使用统计)。
 
 ## 你得到什么
@@ -81,7 +81,7 @@ bundle 只插入一行（`modern-web-guidance`），不需要构建步骤、依
 
 ### 1. 直接提出 Web 开发需求（默认方式）
 
-技能的路由描述就是“在写 HTML、CSS 或客户端 JavaScript 之前先检索 193 篇用例指南”，所以一句平常的请求就够了 ——
+技能的路由描述就是“在写 HTML、CSS 或客户端 JavaScript 之前先检索 208 篇用例指南”，所以一句平常的请求就够了 ——
 智能体会先检索、取回所需内容，然后按当前平台 API 写代码，而不是写变通方案：
 
 ```text
@@ -107,7 +107,7 @@ bundle 只插入一行（`modern-web-guidance`），不需要构建步骤、依
 `web_guidance_list` 回答“到底有什么”，不必花一次取回去看全文：
 
 ```text
-web_guidance_list({})                             → 17 个分类共 193 篇指南
+web_guidance_list({})                             → 17 个分类共 208 篇指南
 web_guidance_list({"category": "css"})            → 18 篇 CSS 指南的 id 与标题
 web_guidance_search({"query": "view transition"}) → 取回之前的排序候选列表
 ```
@@ -124,13 +124,13 @@ web_guidance_search({"query": "view transition"}) → 取回之前的排序候
 | 深浅色主题切换 | `dark mode toggle` | `dark-mode-toggle` |
 | 不用 JavaScript 的滑动标签指示条 | `anchor positioning` | `anchor-positioning-tab-underline` |
 | 输入过程中不打扰人的行内校验 | `form validation after interaction` | `validate-input-after-interaction` |
-| 免密码登录 | `passkey sign in` | `passkey-registration` |
+| 免密码登录 | `passkey registration` | `passkey-registration` |
 | 更快的 LCP | `prioritize hero image` | `fetchpriority` 相关指南 |
 | Manifest V3 扩展 | （技能）`chrome-extensions` | 扩展技能的参考文件 |
 
 ## 检索如何工作
 
-`lib/guidance.js` 在首次使用时为内置语料建立 BM25 索引（约 1.5 MB markdown，几百毫秒建好并缓存）：标题、id、
+`lib/guidance.js` 在首次使用时为内置语料建立 BM25 索引（约 1.9 MB markdown，几百毫秒建好并缓存）：标题、id、
 描述、`featuresUsed`、各级标题与正文，配合停用词过滤、小型英文词干器、前缀扩展，以及精确 id/标题命中的加权。
 没有 embedding、没有内置模型、没有 TensorFlow.js —— 包保持小巧，每个结果都能解释。
 
@@ -150,11 +150,11 @@ web_guidance_search({"query": "view transition"}) → 取回之前的排序候
 - **无网络、无执行，只有一次本地写入。** 插件只导入本地的 `node:fs`、`node:path` 和 `node:url`；没有依赖，也没有
   lifecycle 脚本，因此安装时不会下载或运行任何东西。它唯一写入的文件是自己的计数文件（见[使用统计](#使用统计)）。
 - **指南里夹带不了命令。** 上游指南正文之间用
-  `npx -y modern-web-guidance@latest retrieve "…"` 互相引用（121 处，分布在 45 篇指南里）。建立索引时这些引用会被
+  `npx -y modern-web-guidance@latest retrieve "…"` 互相引用（197 处，分布在 64 篇指南里）。建立索引时这些引用会被
   改写成 `web_guidance_retrieve({"ids":["…"]})`，所以模型从目录里读到的内容不会要求它安装并执行一个未锁定版本的
   远程包。磁盘上的文件仍与锁定快照逐字节一致。
 - **`web_guidance_retrieve` 有上限**：每次调用最多 10 篇、120 000 字符；重复 id 会去重；未知 id 的回显最多 10
-  个；渲染器会明确说明哪些没有返回、需要单独请求。此前一次取回全部 193 篇会返回 1.5 MB（约 450k token）。
+  个；渲染器会明确说明哪些没有返回、需要单独请求。一次取回全部 208 篇会返回 1.9 MB（约 475k token）。
 - **`web_guidance_search` 有上限**：在进入词法扫描前，查询被截断到 512 字符和 24 个不同词项。此前一个 137 KB
   的查询会阻塞宿主事件循环数秒；同样形状的查询现在只需毫秒级。
 - **目录无法越出包外**：条目 id 与分类必须是 slug，每个解析出的路径都会校验是否位于数据目录内。被篡改的
@@ -167,7 +167,7 @@ web_guidance_search({"query": "view transition"}) → 取回之前的排序候
 
 ## 使用统计
 
-0.2.0 记录三个工具到底被问了什么。计数只在本地：没有上报端点、没有分析服务、没有第三方 SDK，任何东西都不离开这台
+自 0.2.0 起，插件记录三个工具到底被问了什么。计数只在本地：没有上报端点、没有分析服务、没有第三方 SDK，任何东西都不离开这台
 机器。
 
 查看用的是给人用的斜杠命令，不是智能体能调用的工具：
@@ -189,12 +189,12 @@ web_guidance_search({"query": "view transition"}) → 取回之前的排序候
 
 ## 侧边栏面板
 
-0.3.0 增加了客户端部分：左侧栏的图标会在中央区域打开 **Guidance Insights** 面板。它展示的就是
+插件增加了客户端部分：左侧栏的图标会在中央区域打开 **Guidance Insights** 面板。它展示的就是
 `/guidance-stats` 打印的那些计数，只是换成了界面：
 
 - 最近 7 天的调用次数与命中率
 - 最常出现的查询，以及各自的命中与未命中次数
-- 分类覆盖情况 —— 已取回的指南对 193 篇语料
+- 分类覆盖情况 —— 已取回的指南对 208 篇语料
 - 什么都没找到的查询
 - 有多少篇指南从未被取回过
 
@@ -210,10 +210,13 @@ web_guidance_search({"query": "view transition"}) → 取回之前的排序候
 
 ## 更新指南语料
 
-语料是上游 `modern-web-guidance@0.0.197` 的锁定快照（技能版本 `2026_10_30-58d055df`）。更新步骤：
+语料是上游 `modern-web-guidance@1.0.0` 的锁定快照（技能版本 `2026_11_09-5bcc021b`）。更新步骤：
 
-1. 下载上游 npm tarball，把 `package/skills/modern-web-guidance/{guides.json,guides}` 解压到 `data/`，把
-   `package/skills/chrome-extensions` 解压到 `data/skills/`。
+1. 下载上游 npm tarball。索引位于 `gen/` 而不是包根目录：把
+   `package/skills/modern-web-guidance/gen/guides.json` 复制为 `data/guides.json`，把
+   `package/skills/modern-web-guidance/guides/` 复制到 `data/guides/`。只放入索引里列出的指南
+   （209 个文件中的 208 个：`built-in-ai/prompt-api.md` 是 `language-model.md` 的逐字节副本，索引里没有它）。
+   把 `package/skills/chrome-extensions` 复制到 `data/skills/`。
 2. 保留 `data/skills/modern-web-guidance/SKILL.md`（本插件的改编版本），不要用面向 CLI 的上游文件覆盖它。
 3. 运行 `npm test`，确认语料仍能加载、冒烟查询排序仍然正确。如果有任何被返回的指南让智能体去运行上游 CLI，
    测试同样会失败，所以刷新语料后不需要手工再清理一遍 npx —— 改写发生在加载时（`lib/guidance.js`，
@@ -241,4 +244,4 @@ Apache-2.0。指南语料、`chrome-extensions` 技能以及改编版 `SKILL.md`
 [GoogleChrome/modern-web-guidance](https://github.com/GoogleChrome/modern-web-guidance)（Copyright Google LLC，
 Apache-2.0）。具体复制、改编与删除了哪些内容，见 [NOTICE](NOTICE)。
 
-本插件不是 Google 官方产品。它移除了上游 CLI、CLI 附带的 TensorFlow.js 嵌入模型以及 Clearcut 遥测看门狗。
+本插件不是 Google 官方产品。它移除了上游 CLI（`modern-web.mjs`、`search.mjs`、`legacy-scan.mjs`）、`gen/` 下预计算的语义检索表，以及上游 CLI 附带的 Clearcut 遥测看门狗（0.x 版本的包里放的是 TensorFlow.js MiniLM 模型，而不是这些表）。

package/data/corpus.json

@@ -1,4 +1,4 @@
 {
-  "version": "2026_10_30-58d055df",
-  "snapshotDate": "2026-10-30"
-}
+  "version": "2026_11_09-5bcc021b",
+  "snapshotDate": "2026-11-09"
+}