iter(g231): search 覆盖配方域三层

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-26T12:39:15.584Z",
+  "generatedAt": "2026-10-26T12:45:44.604Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -3882,7 +3882,7 @@
         "intro": "工程层工具包（private，不发布）。所有 Agent 与人都通过它读取组件库：清单驱动索引、文档、MCP 三件套，外加 style / verify 两道门禁。",
         "steps": [
           "接手先跑 ua doctor（node 版本 / 依赖 / git 钩子 / .ua 元数据一次检完，秒级），再跑 npm run check 确认基线全绿（build → demo → style → typecheck → smoke → index → verify → lint-iterations → audit:visual）",
-          "查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤模糊找（「处理中」这类说明里的词也能搜到，命中非 id 标题时会标出命中字段；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）",
+          "查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤五层 + 配方三层（标题/配方组件/要点）模糊找（命中非 id 标题会标出命中字段，配方命中行直接给 ua recipes <编号> 指路；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）",
           "查配方：ua recipes 列全量（编号 / 标题 / 用到的组件），ua recipes <编号> 看骨架代码与要点（--json 给脚本用；MCP 里对应 list_recipes / get_recipe）",
           "查令牌：ua tokens 打印全部 --ua-* 变量（颜色带暗色值），--json 输出结构化数组；写样式前先查，禁止硬编码。令牌分十二组：颜色 / 混色浓度 / 圆角 / 间距 / 字号 / 字重行高 / 边框 / 阴影 / 动效 / 焦点环 / 控件高度 / 层级，color-mix 混入浓度用 --ua-alpha-soft/tint/line/mid/strong/heavy，弹层阴影用 --ua-shadow-1..4，过渡用 --ua-duration-* + --ua-ease，焦点环用 --ua-focus-ring(_inset)",
           "改完清单跑 npm run docs：同时刷新人类文档站与 llms-full.txt（Agent 首选喂料）",

AGENTS.md

@@ -52,7 +52,7 @@
 
 可用工具：`list_components` / `get_component` / `search_components` / `get_tokens`（返回 --ua-* 令牌清单，避免硬编码颜色间距）/ `list_recipes` / `get_recipe`（取跨组件组合配方：骨架代码 + 要点 + 用到的组件 id，配好再逐个 `get_component` 查参数）。
 
-2. **CLI**：`node packages/tools/cli/bin/ua.js list [--json|--components] | search <关键词> | info <name> [--json] | recipes [编号] [--json] | index | docs | style | verify | changelog`（`--json` 给脚本与 Agent 用，不必解析文本）；`search` 覆盖 id / 标题 / 参数名 / 参数说明 / 步骤五层，命中非 id 标题时会标出命中字段（如「← 参数说明含『处理中』」），`--json` 附带 `matched` 字段
+2. **CLI**：`node packages/tools/cli/bin/ua.js list [--json|--components] | search <关键词> | info <name> [--json] | recipes [编号] [--json] | index | docs | style | verify | changelog`（`--json` 给脚本与 Agent 用，不必解析文本）；`search` 覆盖 id / 标题 / 参数名 / 参数说明 / 步骤五层 + 配方三层（标题 / 配方组件 / 要点，命中行直接给 `ua recipes <编号>` 指路），命中非 id 标题时会标出命中字段（如「← 参数说明含『处理中』」），`--json` 输出 `{ components, recipes }` 两数组、各项带 `matched` 字段
 
 3. **静态索引**：`.ua/index.json`（机器可读索引）、`llms.txt`（速览）或 **`llms-full.txt`（全量 Agent 文档：逐组件参数 / 回调 / 手把手步骤 / 令牌 / 组合配方，无图形纯文本，喂给 Agent 首选）**。
 

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T12:39:15.584Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T12:45:44.604Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -41,7 +41,7 @@
 ### @ui-arch/cli
 
 1. 接手先跑 ua doctor（node 版本 / 依赖 / git 钩子 / .ua 元数据一次检完，秒级），再跑 npm run check 确认基线全绿（build → demo → style → typecheck → smoke → index → verify → lint-iterations → audit:visual）
-2. 查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤模糊找（「处理中」这类说明里的词也能搜到，命中非 id 标题时会标出命中字段；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）
+2. 查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤五层 + 配方三层（标题/配方组件/要点）模糊找（命中非 id 标题会标出命中字段，配方命中行直接给 ua recipes <编号> 指路；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）
 3. 查配方：ua recipes 列全量（编号 / 标题 / 用到的组件），ua recipes <编号> 看骨架代码与要点（--json 给脚本用；MCP 里对应 list_recipes / get_recipe）
 4. 查令牌：ua tokens 打印全部 --ua-* 变量（颜色带暗色值），--json 输出结构化数组；写样式前先查，禁止硬编码。令牌分十二组：颜色 / 混色浓度 / 圆角 / 间距 / 字号 / 字重行高 / 边框 / 阴影 / 动效 / 焦点环 / 控件高度 / 层级，color-mix 混入浓度用 --ua-alpha-soft/tint/line/mid/strong/heavy，弹层阴影用 --ua-shadow-1..4，过渡用 --ua-duration-* + --ua-ease，焦点环用 --ua-focus-ring(_inset)
 5. 改完清单跑 npm run docs：同时刷新人类文档站与 llms-full.txt（Agent 首选喂料）

packages/tools/cli/bin/ua.js

@@ -228,6 +228,23 @@ function matchOf(kw, comp) {
 }
 
 /*** 按关键词搜组件：多词取最弱命中（AND 语义），并标出该词命中的字段，便于判断为何被召回 ***/
+/*** 单个配方对多关键词的命中：标题 3 / 组件 2 / 要点 1，返回最弱档（与组件搜索同一排序口径），未命中返回 null ***/
+function recipeMatch(kws, r) {
+  const fields = [
+    { label: '配方标题', weight: 3, text: String(r.title ?? '').toLowerCase() },
+    { label: '配方组件', weight: 2, text: recipeComps(r).join(' ').toLowerCase() },
+    { label: '配方要点', weight: 1, text: (r.notes ?? []).join(' ').toLowerCase() },
+  ];
+  let weakest = null;
+  for (const kw of kws) {
+    let best = null;
+    for (const f of fields) if (f.text.includes(kw) && (!best || f.weight > best.weight)) best = { ...f, keyword: kw };
+    if (!best) return null; // 任一词不中即淘汰
+    if (!weakest || best.weight < weakest.weight) weakest = best;
+  }
+  return weakest;
+}
+
 function cmdSearch(words = [], args = []) {
   const kws = [...new Set(words.map((w) => String(w).toLowerCase().trim()).filter(Boolean))];
   if (!kws.length) return console.error('usage: ua search <关键词...> [--json]');
@@ -240,21 +257,39 @@ function cmdSearch(words = [], args = []) {
     })
     .filter(Boolean)
     .sort((a, b) => b.score - a.score || String(a.comp.id).localeCompare(String(b.comp.id)));
-  if (!hits.length) {
+  const recipeHits = parseRecipes() // 配方域一并搜：跨组件诉求（怎么拼）的直达载体
+    .map((r) => ({ r, m: recipeMatch(kws, r) }))
+    .filter((x) => x.m)
+    .sort((a, b) => b.m.weight - a.m.weight || Number(a.r.id) - Number(b.r.id));
+  if (!hits.length && !recipeHits.length) {
     const near = nearIds(kws.join(''));
     console.error(`no match: ${words.join(' ')}${near.length ? `（相近：${near.join(' / ')}）` : ''}`);
     return process.exit(1);
   }
   if (args.includes('--json')) {
     return console.log(
-      JSON.stringify(hits.map((h) => ({ package: h.pkg.name, ...h.comp, matched: { field: h.field, keyword: h.keyword } })), null, 2),
+      JSON.stringify(
+        {
+          components: hits.map((h) => ({ package: h.pkg.name, ...h.comp, matched: { field: h.field, keyword: h.keyword } })),
+          recipes: recipeHits.map(({ r, m }) => ({ id: r.id, title: r.title, components: recipeComps(r), matched: { field: m.label, keyword: m.keyword } })),
+        },
+        null,
+        2,
+      ),
     );
   }
   for (const h of hits) {
     const why = h.field === 'id' || h.field === '标题' ? '' : `  ← ${h.field}含「${h.keyword}」`;
     console.log(`${String(h.comp.id).padEnd(16)} ${h.comp.title ?? ''}  (${h.pkg.name})${why}`);
   }
-  console.log(`\n共 ${hits.length} 个组件命中；查参数：ua info <组件id>`);
+  for (const { r, m } of recipeHits) {
+    const why = m.label === '配方标题' ? '' : `  ← ${m.label}含「${m.keyword}」`;
+    console.log(`配方 ${r.id.padEnd(10)} ${r.title}${why}  → 看骨架：ua recipes ${r.id}`);
+  }
+  const parts = [];
+  if (hits.length) parts.push(`${hits.length} 个组件`);
+  if (recipeHits.length) parts.push(`${recipeHits.length} 条配方`);
+  console.log(`\n共 ${parts.join('、')}命中；查参数：ua info <组件id>，看骨架：ua recipes <编号>`);
 }
 
 /*** 输出单包或单组件信息：默认人读摘要，--json 输出原始 JSON ***/
@@ -656,7 +691,7 @@ function cmdMcp() {
     },
     {
       name: 'search_components',
-      description: 'Search by keyword: returns matched packages plus matched components (id/title/prop names/prop descriptions/steps)',
+      description: 'Search by keyword: returns matched packages, matched components (id/title/prop names/prop descriptions/steps) and matched recipes (title/components/notes)',
       inputSchema: {
         type: 'object',
         properties: { query: { type: 'string' } },
@@ -720,8 +755,12 @@ function cmdMcp() {
       const comps = collectComponents(packages) // 组件级命中：包级 exports 只给出包名，Agent 还得再查一次
         .filter(({ comp }) => searchFields(comp).some((f) => f.text.includes(q))) // 与 CLI search 同一份字段表
         .map(({ pkg, comp }) => ({ package: pkg.name, id: comp.id, title: comp.title }));
-      if (!pkgs.length && !comps.length) throw new Error(`no match: ${args.query}`);
+      const recs = parseRecipes() // 配方域：跨组件诉求（怎么拼）的直达载体，与 CLI search 同一套三层字段
-      return { packages: pkgs, components: comps };
+        .map((r) => ({ r, m: recipeMatch([q], r) }))
+        .filter((x) => x.m)
+        .map(({ r, m }) => ({ id: r.id, title: r.title, components: recipeComps(r), matched: { field: m.label, keyword: m.keyword } }));
+      if (!pkgs.length && !comps.length && !recs.length) throw new Error(`no match: ${args.query}`);
+      return { packages: pkgs, components: comps, recipes: recs };
     }
     if (name === 'get_tokens') {
       const list = loadTokenList();

packages/tools/cli/ua.manifest.json

@@ -37,7 +37,7 @@
     "intro": "工程层工具包（private，不发布）。所有 Agent 与人都通过它读取组件库：清单驱动索引、文档、MCP 三件套，外加 style / verify 两道门禁。",
     "steps": [
       "接手先跑 ua doctor（node 版本 / 依赖 / git 钩子 / .ua 元数据一次检完，秒级），再跑 npm run check 确认基线全绿（build → demo → style → typecheck → smoke → index → verify → lint-iterations → audit:visual）",
-      "查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤模糊找（「处理中」这类说明里的词也能搜到，命中非 id 标题时会标出命中字段；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）",
+      "查组件：ua list 看全量，ua search <关键词> 按 id/标题/参数名/参数说明/步骤五层 + 配方三层（标题/配方组件/要点）模糊找（命中非 id 标题会标出命中字段，配方命中行直接给 ua recipes <编号> 指路；拼错会回相近 id），ua info <组件id> 看 props/步骤/示例（ua info <包名> 看单包 api 与约定，加 --json 出原始清单）",
       "查配方：ua recipes 列全量（编号 / 标题 / 用到的组件），ua recipes <编号> 看骨架代码与要点（--json 给脚本用；MCP 里对应 list_recipes / get_recipe）",
       "查令牌：ua tokens 打印全部 --ua-* 变量（颜色带暗色值），--json 输出结构化数组；写样式前先查，禁止硬编码。令牌分十二组：颜色 / 混色浓度 / 圆角 / 间距 / 字号 / 字重行高 / 边框 / 阴影 / 动效 / 焦点环 / 控件高度 / 层级，color-mix 混入浓度用 --ua-alpha-soft/tint/line/mid/strong/heavy，弹层阴影用 --ua-shadow-1..4，过渡用 --ua-duration-* + --ua-ease，焦点环用 --ua-focus-ring(_inset)",
       "改完清单跑 npm run docs：同时刷新人类文档站与 llms-full.txt（Agent 首选喂料）",