lintendo 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
- 先把需求整理为结构化查询。只提取平台、行业、产品类型、页面类型、风格、品牌气质、色系、明暗模式、密度和关键词。不得把用户原文传给脚本或网络端点。
- 确定平台。用户没有指定时，向用户确认平台，或同时搜索 desktop 和 mobile 两份索引；不要擅自默认。
- 按 query-schema.md 和 taxonomy.md 生成请求。默认使用
scripts/cli.mjs search读取 Make-Template 的线上 manifest；只有在源码工作区或用户明确指定时才传--index和--local-root。 - 对每个候选读取
matched、unmatched、scoreBreakdown、reviewStatus和publishable，再取得完整的DESIGN.md并查看 preview。不能只按 score 选择。 - 结合用户约束说明推荐理由和不匹配项。
deferred可用于本地参考，但不得描述为已获公开发布授权。 - 只有用户工作流需要落地资源时才下载 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
| Situation | Action |
|---|---|
| Platform missing | Confirm, or search both indexes |
| Deferred result | Read verified DESIGN.md and preview locally或在线；package stays unavailable |
| Online result | Default to the canonical Make-Template manifest and verified hashes |
| Too few results | Report resultSummary.reason; do not pad or duplicate |
| Stale cache | State it explicitly; do not silently downgrade |
Common mistakes
- Passing the user's original prose as
termsinstead of extracting a minimal structured query. - Choosing the top score without reading unmatched constraints and full DESIGN.md.
- Treating
deferredas 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.