✨ feat(vscode): 代码阅读卡片横排多个概念图标

vscode/src/codeReader/contract.ts

@@ -652,6 +652,11 @@ export interface LanguageAdapter {
   steps?: (root: Node, source: string, languageId: string) => StepBlocks
   /** 认代码里给定义起的中文名（见「中文名」）；不填就没有中文名。 */
   displayNames?: DisplayNameReader
+  /**
+   * 这块除了自己的种类，还认得出的概念（异步、抽象）。认到才返回；不填就只有种类那一个。
+   * 种类那一个由宿主按内置种类的图标和翻译插件起的种类名补在最前面，这里不要再报种类。
+   */
+  concepts?: (block: CodeBlock) => BlockConcept[]
 }
 
 // ── 中文名（见「中文名」）──
@@ -777,7 +782,59 @@ export const KIND_ICON_NAMES = [
 
 export type KindIconName = (typeof KIND_ICON_NAMES)[number]
 
-/** 库规则的种类在预览里的样子：块左边只画图标（种类色），名字是悬停提示和读屏念的文字，筛选栏里这个种类也叫它。 */
+/**
+ * 内置种类用哪个图标。宿主排预览时写进概念列表，webview 只按名字画。
+ * 同一类语义共用一个颜色（codeReader.css 的 --cr-kind-*：常量 / 变量 / 字段都是数据，尝试 / 捕获都是异常处理），图标区分具体是哪种。
+ */
+export const KIND_ICONS: Record<BlockKind, KindIconName> = {
+  import: 'import',
+  function: 'square-function',
+  class: 'box',
+  type: 'braces',
+  enum: 'list-ordered',
+  exception: 'triangle-alert',
+  field: 'tag',
+  const: 'lock',
+  variable: 'variable',
+  if: 'split',
+  else: 'corner-down-right',
+  loop: 'repeat',
+  try: 'shield',
+  catch: 'shield-alert',
+  finally: 'shield-check',
+  return: 'corner-down-left',
+  statement: 'code',
+  comment: 'message-square-text',
+  interpreter: 'terminal',
+  options: 'sliders-horizontal',
+  case: 'signpost',
+  command: 'square-terminal',
+  pipeline: 'square-terminal',
+  directive: 'terminal',
+  stage: 'layers',
+  run: 'square-terminal',
+  copy: 'copy',
+  setting: 'sliders-horizontal',
+  label: 'tag',
+  health: 'activity',
+  start: 'play',
+}
+
+/**
+ * 一块上认出的一个概念：稳定 id、悬停名、图标名（只能从 KIND_ICON_NAMES 里挑）、颜色。
+ * 语言的种类不填颜色，图标按 id 用 CSS 里这种种类的颜色；规则声明的概念填颜色，只给这个图标上色。
+ */
+export interface BlockConcept {
+  /** 稳定 id。语言的种类就是块的种类（class）；规则的种类是 RuleCard.kind；规则另认的由规则起。 */
+  id: string
+  /** 悬停提示和读屏念的名字。 */
+  label: string
+  icon: KindIconName
+  /** 不填是语言的种类（颜色在 CSS）。规则的概念填规则给的颜色，不改卡片边框。 */
+  color?: ThemeColor
+}
+
+/** 库规则的种类：筛选栏里叫 label，卡片边框用 color，icon 进概念列表。卡片左边不只这一个图标（见 BlockConcept）。 */
 export interface KindBadge { label: string, color: ThemeColor, icon: KindIconName }
 
 /**
@@ -793,12 +850,17 @@ export type RuleBlock = RuleCard | RuleFacts | RuleOmit
  */
 export interface RuleOmit { omit: true }
 
-/** 规则自己的卡片：一张属性表，种类的图标、颜色、名字和每一行都由规则给（用词归规则）。 */
+/** 规则自己的卡片：一张属性表。种类（badge）决定筛选和边框色；卡片左边的图标是语言的概念再加这个种类、以及 concepts。用词归规则。 */
 export interface RuleCard {
   /** 种类 id，写成「规则 id.名字」（sqlalchemy.table）：筛选的 kind 属性值就是它，筛选记住的也是它，要稳定。 */
   kind: string
-  /** 种类的名字、颜色和图标：筛选栏里这个种类也叫这个名字。 */
+  /** 种类的名字、颜色和图标：筛选栏里这个种类也叫这个名字，卡片边框用这个颜色。图标进概念列表，不换掉语言的概念。 */
   badge: KindBadge
+  /**
+   * 认领时额外认出的概念，排在这个种类（badge）后面。语言认的概念仍在更前面；同一个 id 只留第一个。
+   * 不改筛选的种类，也不改卡片边框色（仍是 badge）。
+   */
+  concepts?: BlockConcept[]
   rows: PropertyRow[]
   /** 块自己的名字（类名）在源码里的范围：跳到的定义就是它时闪整块。 */
   defines?: SourceRange