卷轴文件说明

卷轴文件是一个 JSON 对象：包含卷轴的详情、带观点的章节，以及可选的翻译。本页说明导入时读取的每个对象和字段。

下载

• 示例文件：一个虚构的卷轴，用到了所有常用字段，并包含界面全部 15 种语言的完整版本。
• JSON Schema：用机器可读的形式（JSON Schema 2020-12）写成的同一套规则，供编辑器、脚本和 AI 智能体使用。其中的限制与导入时运行的代码来自同一处。

结构

Scroll
├── language, title, authors, description, tags,
│   sourceUrl, originalYear, originalPeriod
├── summaries: Chapter[]
│   └── ideas: Idea[]
│       └── examples: string[]
└── translations: { language: Translation }
    └── summaries: TranslatedChapter[]
        └── ideas: TranslatedIdea[]

卷轴（Scroll）

根对象。在 schema 中，其他对象叫作 Chapter（章节）、Idea（观点）、Translation（翻译）、TranslatedChapter 和 TranslatedIdea。

章节（Chapter）

观点（Idea）

翻译（Translation）

translations 中的每一项都是该语言的完整卷轴。章节、观点和示例必须与原始版本顺序相同、数量相同。

TranslatedChapter 包含不为空的 title，以及与原章节观点数量相同的 ideas。TranslatedIdea 包含不为空的 text，以及与原观点数量相同、且没有空项的 examples。翻译后的观点不写 tier：它取自原始版本，填写不同的值会被拒绝。

导入如何读取值

• 文本会去掉首尾空格，长度按你看到的字计算。
• 为空的可选字段视为没有填写。
• 本页没有说明的字段会被忽略。
• 读者看到与自己语言相符的版本；没有时看到原始版本。

示例

{
  "language": "en",
  "title": "Small steps",
  "authors": ["Ada Example"],
  "description": "How small, repeated actions shape what you notice and do.",
  "tags": ["habits", "attention"],
  "sourceUrl": "https://example.org/small-steps",
  "originalYear": 1841,
  "summaries": [
    {
      "title": "Starting small",
      "ideas": [
        {
          "text": "Make the first step so small that you can take it on a bad day.",
          "tier": "important",
          "examples": ["Read one page every evening."]
        },
        {
          "text": "You notice more of what you have decided to look for.",
          "tier": "common",
          "examples": []
        }
      ]
    }
  ],
  "translations": {
    "de": {
      "title": "Kleine Schritte",
      "authors": ["Ada Beispiel"],
      "description": "Wie kleine, wiederholte Handlungen prägen, was wir bemerken und tun.",
      "tags": ["gewohnheiten", "aufmerksamkeit"],
      "summaries": [
        {
          "title": "Klein anfangen",
          "ideas": [
            {
              "text": "Mach den ersten Schritt so klein, dass er dir auch an einem schlechten Tag gelingt.",
              "examples": ["Lies jeden Abend eine Seite."]
            },
            {
              "text": "Du bemerkst mehr von dem, wonach du zu suchen beschlossen hast.",
              "examples": []
            }
          ]
        }
      ]
    }
  }
}

限制

常见导入错误

• 文件不是有效的 JSON。 请助手"只回复有效的 JSON"，或检查是否少了逗号或引号。删掉 JSON 对象前后的所有文字。
• 缺少语言。 用 zh-CN 这样的代码添加 "language"。
• 观点或示例太长。 提示会指出语言、章节、观点和示例，把那段文字缩短。
• 翻译对不上。 每个版本的章节、观点和示例数量与顺序都必须相同。
• 观点太多或文件太大。 把来源拆成两个卷轴。
• 你拥有的卷轴已达上限。 替换一个不再需要的卷轴，参见编辑、替换与分享。