Search Design System

Overview

Turn a design need into a private, structured search; inspect the returned evidence before selecting a theme. Search and scoring run locally after the versioned index is loaded.

Workflow

1. 先把需求整理为结构化查询。只提取平台、行业、产品类型、页面类型、风格、品牌气质、色系、明暗模式、密度和关键词。不得把用户原文传给脚本或网络端点。
2. 确定平台。用户没有指定时，向用户确认平台，或同时搜索 desktop 和 mobile 两份索引；不要擅自默认。
3. 按 query-schema.md 和 taxonomy.md 生成请求。默认使用 scripts/cli.mjs search 读取 Make-Template 的线上 manifest；只有在源码工作区或用户明确指定时才传 --index 和 --local-root。
4. 对每个候选读取 matched、unmatched、scoreBreakdown、reviewStatus 和 publishable，再取得完整的 DESIGN.md 并查看 preview。不能只按 score 选择。
5. 结合用户约束说明推荐理由和不匹配项。deferred 可用于本地参考，但不得描述为已获公开发布授权。
6. 只有用户工作流需要落地资源时才下载 package；普通选型只读取 DESIGN.md 和 preview。不得发送 use 事件或 analytics 事件。

Example

将本地整理出的请求写入临时文件：

{
  "schemaVersion": 1,
  "readerVersion": "1.0.0",
  "platform": "desktop",
  "terms": ["analytics", "finance"],
  "hardFilters": { "industries": ["finance-payments"] },
  "softFilters": { "styles": ["professional"], "density": ["high"] },
  "exclude": { "styles": ["playful"] },
  "limit": 4
}

node scripts/cli.mjs search --index /path/to/desktop.json --request /path/to/request.json --local-root /path/to/runtime

Then pass one returned result to scripts/cli.mjs fetch --kind designMd and read the full body before choosing.

Quick reference

Common mistakes

• Passing the user's original prose as terms instead of extracting a minimal structured query.
• Choosing the top score without reading unmatched constraints and full DESIGN.md.
• Treating deferred as publishable or inventing a public artifact URL.
• Downloading a package during exploration when DESIGN.md and preview are sufficient.

Read response-schema.md for result fields, artifact behavior, and stable error codes.