D2 可检索设计知识库与检索引擎（Issue #124）

.scd/plans/20261109-232616-d2-knowledge-base/decisions.md

@@ -0,0 +1,19 @@
+---
+status: approved
+version: 1
+created_at: 2026-11-09T23:26:16+08:00
+updated_at: 2026-11-09T23:26:16+08:00
+recorded_timezone: Asia/Shanghai
+---
+
+# 决策与事件
+
+- 事件ID：DEC-1
+- 类型：开工
+- 文件及文档版本：本目录四份 v1；依据 Issue #124 契约、Initiative #122 图版本 2 确认 + 用户执行授权
+- 目标Git SHA：main（fa8c969）
+- 用户实际依据：Initiative 摘要"ok" + "全部完成 scdexcute"
+- 任务或Issue范围：Issue #124 范围；NOTICES 仅追加 ui-ux-pro-max 节
+- occurred_at：null
+- recorded_at：2026-11-09T23:26:16+08:00
+- 未决选择：无（9 张核心表=styles/typography/products/ui-reasoning/ux-guidelines/icons/charts/motion/landing；colors.csv 属原始色板不入核心，landing 入）

.scd/plans/20261109-232616-d2-knowledge-base/implementation.md

@@ -0,0 +1,15 @@
+---
+status: approved
+version: 1
+created_at: 2026-11-09T23:26:16+08:00
+updated_at: 2026-11-09T23:26:16+08:00
+recorded_timezone: Asia/Shanghai
+---
+
+# 实施计划
+
+1. 分支 delivery/124-design-knowledge-base
+2. 下载 9 核心 CSV + 2 元数据 + 22 stacks（清单核对）
+3. search.mjs：零依赖 CSV 解析（引号/逗号状态机）、域映射、词项计分、--domain/--limit/--json
+4. SKILL.md「形成可实施的视觉交付」后插入「检索设计知识库」段
+5. NOTICES 追加节；测试；A1 冒烟；A2 隔离会话；PR/验收/合并/关单/图版本 4

.scd/plans/20261109-232616-d2-knowledge-base/plan.md

@@ -0,0 +1,14 @@
+---
+status: approved
+version: 1
+created_at: 2026-11-09T23:26:16+08:00
+updated_at: 2026-11-09T23:26:16+08:00
+recorded_timezone: Asia/Shanghai
+---
+
+# 任务索引
+
+- 任务与Issue：Delivery Issue #124（design-knowledge-base），Initiative #122 图版本 3（节点依赖已满足：#123 DONE）
+- 所需文档及版本：requirements.md v1、implementation.md v1、decisions.md v1
+- 基线来源：main（#128 合并后）
+- 批准与开工事件：decisions.md DEC-1

.scd/plans/20261109-232616-d2-knowledge-base/requirements.md

@@ -0,0 +1,16 @@
+---
+status: approved
+version: 1
+created_at: 2026-11-09T23:26:16+08:00
+updated_at: 2026-11-09T23:26:16+08:00
+recorded_timezone: Asia/Shanghai
+---
+
+# 需求（Issue #124 契约）
+
+- data/knowledge/：ui-ux-pro-max 核心 9 CSV（styles/typography/products/ui-reasoning/ux-guidelines/icons/charts/motion/landing）+ catalog-summary.json + data-provenance.json
+- data/stacks/：22 张框架 CSV
+- skills/scd-uiux/scripts/search.mjs：node 零依赖检索，--domain 参数，空结果如实报告
+- SKILL.md 查询契约段（中文）：最小查询模式/单一意图/2–5 词/失败一次收窄重试/不保留未验证输出
+- NOTICES 追加 ui-ux-pro-max 节
+- A1 检索各域可用；A2 隔离会话检索给出带来源建议；A3 全量测试绿

skills/scd-uiux/SKILL.md

@@ -66,6 +66,8 @@ description: "在生产实施前设计或完善 Web 产品的用户体验和界
 
 ## 形成可实施的视觉交付
 
+视觉方向、字体搭配、配色、图标、图表或动效需要具体参照时，检索内置设计知识库：`node <skill-root>/scripts/search.mjs <2-5 个关键词> [--domain <域>]`，域见 `--list-domains`（styles/typography/products/reasoning/ux/icons/charts/motion/landing/stacks）。一次查询围绕单一意图；结果为空或离题时收窄或换域重试一次，仍无命中则如实报告无验证匹配，不得把一般性建议当作检索结果，也不保留未验证输出。检索所得具体值进入方向块或 UX 契约时注明来源域与条目。
+
 创建或验证线框图、视觉稿或原型前，阅读 `references/visual-evidence.md`。生成任何视觉产物前，先按[设计品味](references/design-taste.md)写出五项方向块并逐条排查反模式黑名单；命名不出方向时不得开始生成。
 视觉设计自动使用共用的[页面视觉质量](references/visual-quality.md)：统一方向、八维检查、实际渲染的有限轮次自审与可核对对比。已有页面只需视觉打磨时可独立使用 [scd-ui-polish](../scd-ui-polish/SKILL.md)；生产实施仍交给 QuickDev，清晰局部变更不增加设计阶段。
 

skills/scd-uiux/data/THIRD-PARTY-NOTICES.md

@@ -8,3 +8,10 @@
 - 许可：MIT License，版权归属上游作者
 - 收录范围：`tokens/`（14 个 DTCG 令牌 JSON）、`components/`（11 份组件规范 Markdown）
 - 改动：无（原样搬运）；后续如有改动在各节记录
+
+## nextlevelbuilder/ui-ux-pro-max-skill（MIT License）
+
+- 来源：<https://github.com/nextlevelbuilder/ui-ux-pro-max-skill>（main 分支，按文件原样收录）
+- 许可：MIT License，版权归属上游作者
+- 收录范围：`knowledge/`（styles/typography/products/ui-reasoning/ux-guidelines/icons/charts/motion/landing 共 9 张 CSV + catalog-summary.json + data-provenance.json）、`stacks/`（22 张框架 CSV）
+- 改动：无（原样搬运）；检索脚本 `scripts/search.mjs` 为本项目自研（node 零依赖），非上游代码

skills/scd-uiux/data/knowledge/catalog-summary.json

@@ -0,0 +1,78 @@
+{
+  "schemaVersion": 1,
+  "verifiedAt": "2026-11-04",
+  "counts": {
+    "styles": {
+      "total": 89,
+      "searchable": 80,
+      "active": 51,
+      "supplemental": 29,
+      "deprecated": 9
+    },
+    "products": 192,
+    "palettes": 192,
+    "reasoningProfiles": 192,
+    "fontPairings": 74,
+    "googleFonts": 1934,
+    "curatedIcons": 105,
+    "upstreamPhosphorIcons": 1512,
+    "uxGuidelines": 120,
+    "motionPresets": 17,
+    "chartTypes": 25,
+    "stacks": 22,
+    "stackGuidelines": 1278
+  },
+  "snapshots": {
+    "google-fonts.csv": {
+      "sha256": "1c8c3b2ea1faf6a1012da463756def8b3889db33f2226f0343bb4daa80307d03"
+    },
+    "google-font-licenses.json": {
+      "sha256": "35688523f2955795caa1a47c53b83099e60c1708461476f9cc3a050cf3b0148a"
+    },
+    "icons.csv": {
+      "sha256": "50816c6012030178195a16ee481ebf58b47bd985d70e8ec58886cc83f6eddafc"
+    },
+    "phosphor-icons-upstream.json": {
+      "sha256": "2399325233b277b5c97a80e6a5e8941154f5d057beee4e7613db87c87d700236"
+    }
+  },
+  "promotionPolicy": {
+    "changedFamilySetRequiresExplicitApproval": true,
+    "relevanceGateRequired": true,
+    "unlicensedFamiliesExcluded": true
+  },
+  "pendingCandidates": [
+    {
+      "family": "Edu NSW ACT Cursive",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu NSW ACT Hand Pre",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu QLD Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu SA Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu VIC WA NT Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu VIC WA NT Hand Pre",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Google Sans",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Google Sans Flex",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    }
+  ]
+}