# 词汇库收成一个 JSON

> source: 想法/草稿/词汇库收成一个JSON.md

> 这是 AI 整理，不是作者原话。数据已经按这个结构落地，字段可以再改。

## 作者的要求

> 这种方式行不通，需要整洁。我认为最好的是用一个JSON或者别的什么方式封装，把所有这些词都放进去。

之前提过“一个主题一个文件”，作者否定了：主题、词条、外刊词表会拆出很多小文件，反而更乱。改成**一个词汇库数据文件**，主题只是文件里的字段，不是独立文件。

## 现在的做法

`语言学习/词汇库.json` 已经是唯一的数据源：3178 条词条（英语 2576、日语 602）+ 薯条主题。

```json
{
  "version": 1,
  "updated": "2026-10-28",
  "entries": [
    {
      "id": "w441be3a6",
      "lang": "en",
      "term": "soggy",
      "body": "湿漉漉的，湿透的，因吸水而松软的\n\n薯条放久了变软可以用 soggy"
    }
  ],
  "topics": [
    {
      "id": "fries",
      "title": "薯条",
      "aliases": ["薯条", "fries", "French fries", "chips", "フライドポテト"],
      "intro": "两种薯条(说实话我也不知道这两种薯条在中文中叫什么, 只知道一种是细薯条, 另一种为锯齿状)",
      "entries": ["julienne-fries", "french-fries", "crinkle-fries", "crispy", "w441be3a6", "w30b75cd9", "w60fa4db6", "chips"]
    }
  ]
}
```

## 为什么这样更整洁

- 一个文件装完 3178 个词，不再有 `词汇卡片.md`、13 个外刊词表、日语常用词表、托福词表、中上級词表、同义表达这些平行数据源。
- 主题不是文件，是 `topics` 数组里的一项；一个词可以出现在多个主题里，页面按 id 取。
- 词条不再带类型、来源、标签这些结构字段；只有 id、lang、term、body。
- 长文章还是 Markdown，不塞进 JSON；JSON 只存词和主题。

## 代价

- 近 400 KB 的 JSON 不适合手改。需要一个小的编辑工具：命令行或 `/studio` 的词库表格。否则每次加词都要在 JSON 里找位置。
- 一个大文件的 diff 会很长；如果以后很在意合并冲突，可以改成一整份 JSONL（一行一个词），仍是“一个文件”。
- 旧的词表/卡片 Markdown 还在，给阅读书架用；词库已经不再读它们，但两份内容会慢慢漂移，是否归档还没定。

## 已经做的

1. 把卡片、surveillance、13 篇外刊词表、精读解析、日语常用词表、托福词表、中上級词表、词汇例句、同义表达全部导出成 `语言学习/词汇库.json`。
2. 去掉 type/source/tags/direction，只留 id、lang、term、body。
3. 网站改成只读这个 JSON；`/articles/lang`、详情页和主题都从它生成。
4. 加“薯条”主题（8 条），验证主题页能把一组词和解释收成一块。

## 还没做

- 1348 条原始词表没有释义（托福、中上級的一部分），正文为空；可以补解释或删掉。
- 1 MB 级别的 JSON 需要编辑工具；先命令行，够用再做 `/studio` 表格。
- 旧词表/卡片是否归档还没定。
- 长文章要不要也进 JSON（不建议；文章是散文，不是词条）。
- 薯条主题引用的 `idiomatic-english` 目前是 local-only；主题页公开还是只在本机。
