newtype Wiki
wiki-schema · updated 2026-04-07

Wiki Schema

本文件定义了 Wiki 的结构、约定和工作流程。Agent 在操作 Wiki 时必须遵守这些规则。

架构

Wiki 是 OUTPUT 层的导航层和索引层，基于已发布的精选内容（Note、Newsletter、Video Script）构建。

00 - Wiki/
├── _schema.md       # 本文件，Wiki 规则（Agent + 人类共同维护）
├── index.md         # 总目录，所有页面的入口
├── log.md           # 更新日志（追加式）
├── concepts/        # 原创概念/框架页
├── entities/        # 人物/公司/产品页
└── threads/         # 主题线索页（串联多篇内容的叙事线）

页面类型

Concept（概念页）

作者原创的框架、隐喻、理论。每个概念有完整定义、核心论点、来源内容链接。

Entity（实体页）

反复出现的人物、公司、产品。记录与作者内容体系的关系，而非百科式介绍。

Thread（线索页）

横跨多篇内容的叙事主线。展示概念之间的演进关系和逻辑链条。

页面格式约定

Frontmatter（必需）

---
type: concept | entity | thread
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: [内容来源列表]
related: [相关Wiki页面列表]
tags: [标签]
---

正文结构（概念页模板）

# 概念名

> 一句话定义（加粗）

## 核心论点
概念的完整展开，引用原文论述。

## 来源
- [[Newsletter/Note/Video Script 标题]] — 简述该内容中的相关论点

## 相关概念
- [[其他概念页]] — 关联说明

## 演变
概念在不同内容中的发展轨迹（如有）。

正文结构（实体页模板）

# 实体名

> 一句话定位（在作者内容体系中的角色）

## 与内容体系的关系
这个实体为什么重要，在作者的框架中扮演什么角色。

## 关键提及
- [[来源内容]] — 具体论点

## 相关概念
- [[概念页]] — 关联说明

## 相关实体
- [[其他实体页]] — 关联说明

正文结构（线索页模板）

# 线索名

> 一句话概括这条叙事线

## 脉络
按时间/逻辑顺序排列的内容链：
1. [[内容A]] — 这一步建立了什么
2. [[内容B]] — 在A的基础上推进了什么
3. ...

## 核心演进
这条线索的思想是如何一步步发展的。

## 涉及概念
- [[概念页列表]]

工作流

Ingest（摄入新内容时）

  1. 读取新发布的 Note / Newsletter / Video Script
  2. 判断涉及哪些已有概念和实体
  3. 更新相关概念页的"来源"和"演变"部分
  4. 更新相关实体页的"关键提及"部分
  5. 判断是否需要新建概念页或实体页
  6. 更新 index.md
  7. 追加 log.md 条目

Query（查询时）

  1. 先读 index.md 找到相关页面
  2. 深入相关页面获取详细信息
  3. 如果查询结果有价值，考虑归档为新页面

Lint（健康检查，定期执行）

  1. 检查孤立页面（无入链）
  2. 检查缺失页面（被引用但不存在）
  3. 检查过时内容（被新内容推翻的旧观点）
  4. 检查缺失的交叉引用
  5. 建议新的概念页或线索页

命名规范

权限

超级个体
newtype Wiki is a structured knowledge base from newtype.