---
title: Joplin Rebuild Schema
tags:
  - schema
  - joplin
  - workflow
type: schema
created: 2026-04-22
updated: 2026-04-22
aliases:
  - joplin-rebuild-schema
---

# Joplin Rebuild Schema

> [!note]
> `raw/Joplin` 不是普通资料堆，而是已经过初步加工的学习笔记集合。重构目标不是压缩成短摘要，而是重新组织成更适合 Obsidian 浏览、连接和复习的知识页。

## 目标

- 让每个主题都有清晰入口。
- 让细节进入可复习的模块页和概念页，而不是堆在导航页。
- 让原始资料继续只读，知识层持续可维护。
- 让新增来源如 `raw/Documents` 能沿用同一流程接入。

## 固定分层

### 来源层

- `raw/Joplin/`
- `raw/Documents/`
- `raw/<其他来源>/`

这些目录一律只读，不改写原始内容。

### 资源引用

- 资源不再默认复制到 `assets/`
- 被 wiki 页面引用到的图片、PDF、附件，优先按现有仓库路径直接建立链接或嵌入。

### 知识层

- `X-Knowledge-Base/wiki/index.md`
- `X-Knowledge-Base/wiki/log.md`
- `X-Knowledge-Base/wiki/*.md`

## 页面类型

### 主题页

- 作为总导航入口。
- 偏路径和组织，不承担大段正文细节。
- 内容包括：
  - 主题问题
  - 推荐复习顺序
  - 模块地图
  - 关键概念
  - 常见误区
  - 来源范围

### 模块页

- 承担真正可复习的正文。
- 重点写：
  - 模块结论
  - 机制、步骤、对比
  - 关键例子
  - 易错点
  - 自测问题
  - 来源

### 概念页

- 补齐跨模块复用的稳定概念。
- 适合写：
  - 定义
  - 判别边界
  - 相邻概念区别
  - 作用或应用
  - 来源

### 来源页

- 默认不建。
- 只有在确实需要保留来源视角时才建 `source-*` 页。

## 拆分原则

- 长模块不继续堆大单页。
- 模块内若已经出现多个相对独立的小主题，就拆成多个子模块页。
- 主题页统一导航这些子模块页。

## 命名原则

- 文件名和正文标题统一使用同一种主要语言。
- 当前已落地主题以中文为主，因此本批页面继续保持中文一致。
- 不混用“英文文件名 + 中文标题”的写法。

## Obsidian 规则

- 内部关系一律使用 `[[wikilink]]`
- 资源优先使用 `![[path/to/file]]` 或 `[[path/to/file]]`
- 页面必须带 frontmatter
- 主题页、模块页、概念页底部都要显式列来源
- 来源中的 raw 路径直接写成 `[[raw/...]]`
- 不写 `[[X-Knowledge-Base/raw/...]]` 这类带 Vault 前缀的形式

## 执行流程

### Ingest

1. 读取来源目录中的总纲文件与代表文件
2. 判断是更新已有主题、补充模块，还是新增概念页
3. 检查是否有需要建立链接或嵌入的资源
4. 编写或更新 wiki 页面
5. 补交叉链接
6. 更新 `index.md`
7. 追加 `log.md`

### Lint

1. 检查孤立页
2. 检查缺失回链
3. 检查重复概念
4. 检查已删除入口是否需要恢复
5. 检查资源链接是否仍然有效

## 当前默认决策

- `raw/` 永远只读
- 主题页负责导航
- 模块页负责详细内容
- 长模块优先拆子模块
- 默认不建 `source-*` 页
- `index.md` 与 `log.md` 每次都维护