四、词条数据规范

16 个字段精确定义每个词条

8 个必填字段保证基础信息完整，8 个选填字段提供深度上下文。结构化数据，便于检索、筛选、展示。

{}

4.1

必填字段 8 项

每个词条必须包含这 8 个字段，缺一不可。它们构成了词库的最小可用单元。

字段	类型	说明	示例
id	string	唯一标识 = 层级代号 + 单词小写（空格转连字符）	"L5-FIG-auto-layout"
word	string	英文单词 / 短语	"Auto Layout"
phonetic	string	美式 IPA 音标	"/ˌɔːtoʊ ˈleɪaʊt/"
pos	string	词性（n / v / adj / adv / phrase）	"noun phrase"
cn	string	中文翻译（精准、一词定义）	"自动布局"
definition	string	英文释义（简单英语，单句，≤30 词）	"A system that arranges child elements automatically..."
layer	string	金字塔坐标	"L5-FIG"
frequency	number	使用频率 1-5（见第五节）	5

4.2

选填字段 8 项

根据词条类型选择性填写，提供更丰富的上下文信息。设计类词条侧重 visual，编程类词条侧重 code。

cefrstring

CEFR 等级（A1 / A2 / B1 / B2 / C1 / —）

softwarestring[]

出现在哪些软件界面中

contextstring

在软件界面中的真实使用语境

relatedstring[]

完整示例

三类词条的完整 JSON 示例：设计类、编程类、系统类。每个示例展示全部 16 个字段的实际填写方式。

{
  "id": "L1-UI-opacity",
  "word": "Opacity",
  "phonetic": "/oʊˈpæsəti/",
  "pos": "noun",
  "cn": "不透明度",
  "definition": "The degree to which an element is see-through, from 0% to 100%",
  "layer": "L1-UI",
  "frequency": 5,
  "cefr": "C1",
  "software": ["Figma", "Photoshop", "Illustrator", "After Effects", "CSS"],
  "context": "Opacity: 80%（属性面板）",
  "related": ["Transparency", "Alpha", "Fill", "Blend Mode"],
  "collocations": ["reduce opacity", "set opacity to", "layer opacity"],
  "visual": "100% 完全不透明 → 50% 半透明 → 0% 完全透明",
  "note": "Opacity 影响整个图层含子元素，Fill 只影响填充色"
}

{
  "id": "L3-GEN-variable",
  "word": "Variable",
  "phonetic": "/ˈvɛriəbl/",
  "pos": "noun",
  "cn": "变量",
  "definition": "A named container that stores a value which can change during execution",
  "layer": "L3-GEN",
  "frequency": 5,
  "cefr": "B1",
  "software": ["VS Code", "Xcode", "Cursor"],
  "context": "声明变量：let / const / var",
  "related": ["Constant", "Type", "Scope", "Declaration"],
  "collocations": ["declare a variable", "global variable", "local variable"],
  "code": "let name = "子慦"\nconst age = 29\nvar score = 100",
  "note": "JS 中 let 可变、const 不可变；Swift 中 var 可变、let 不可变"
}

{
  "id": "L2-MAC-spotlight",
  "word": "Spotlight",
  "phonetic": "/ˈspɑːtlaɪt/",
  "pos": "noun",
  "cn": "聚焦搜索",
  "definition": "macOS built-in search that finds files, apps, and web results instantly",
  "layer": "L2-MAC",
  "frequency": 4,
  "cefr": "B1",
  "software": ["macOS"],
  "context": "⌘ + Space → Spotlight Search",
  "related": ["Finder", "Launchpad", "Search"],
  "collocations": ["open Spotlight", "Spotlight search", "Spotlight results"],
  "note": "iOS 对应功能是下拉搜索。macOS Ventura+ 改为与 Siri 合并入口"
}

总字段数

必填字段

选填字段

词条类型

规范已定

进入词库，查看遵循数据规范的真实词条

进入词库