newtype Wiki 搭建记录
newtype Wiki 是一次把 Substack 长期内容结构化的实验：主站继续发布文章，Wiki 负责沉淀概念、工具、术语、对比和路径。
newtype 最早是一个 Substack 站点。
它适合发布 Newsletter、笔记、长文和更新。但当内容越来越多时，一个问题开始变得明显：文章适合按时间发布，却不适合承载一个完整知识体系。
读者可以读到最新文章，但很难快速理解整个系统：AI OS 是什么？newtype OS 是什么？OpenCode 和 Claude Code 有什么区别？哪些概念是长期主线？
于是，newtype Wiki 作为第二层内容结构被搭建出来。
为什么不直接放在 Substack 里
Substack 适合发布。
Wiki 适合组织。
Substack 的强项是订阅、邮件、文章分发和作者关系。它像一个持续更新的出版系统。
但 Wiki 需要更多结构能力：
- 自定义路径。
- 分类索引。
- sitemap。
- llms.txt。
- 页面互链。
- 更自由的 SEO 元数据。
- 可持续增加的次级页面。
这些能力不一定适合放在 Substack 后台里完成。
所以更合理的分工是：Substack 做主站和发布，Wiki 做结构化知识库。
为什么用子域名
newtype 的主域名已经绑定到 Substack。
为了不破坏主站和订阅系统，Wiki 放在子域名：
wiki.newtype.pro这样有几个好处。
第一，不影响主站。
www.newtype.pro 继续承载 Substack。
第二，Wiki 可以自由开发。
Vercel、静态站点、构建脚本、样式、sitemap 都可以自己控制。
第三，搜索引擎仍然能识别关联。
通过导航、外链、Substack 页面跳转、Google Search Console 和 sitemap，Wiki 可以成为 newtype 内容生态的一部分。
技术路线
newtype Wiki 采用的是很轻的静态站点路线。
内容用 Markdown 写在仓库里。
构建脚本把 Markdown 转成 HTML，生成：
- 页面。
- 分类首页。
- sitemap.xml。
- robots.txt。
- llms.txt。
- 静态样式。
部署使用 GitHub + Vercel。
每次提交到 GitHub，Vercel 自动部署到 wiki.newtype.pro。
为什么用 Markdown
Markdown 是这个系统的核心。
它足够简单，人可以直接读，AI 也可以直接读写。
对于 Wiki 来说，Markdown 有几个优势：
- 内容可迁移。
- Git 可追踪。
- AI 可编辑。
- 页面结构清晰。
- 不依赖封闭数据库。
- 容易生成 HTML、sitemap 和 llms.txt。
这和 newtype 长期强调的「万物皆文件」是一致的。
第一批页面
第一批页面不是随机生成的，而是围绕 newtype 内容体系里的核心节点展开。
包括：
- newtype OS。
- AI OS。
- Claude Code。
- OpenCode。
- Oh My OpenCode。
- Skills。
- MCP。
- Context Engineering。
- Agentic Workflow。
- RAG vs AI OS。
- Claude Code vs OpenCode。
- Obsidian vs NotebookLM。
这些页面共同构成一个可导航的知识骨架。
和 Substack 文章的关系
Wiki 不替代文章。
每篇 Wiki 页面都应该尽量链接回相关 Substack 文章。
文章保留原始语境、观点推进和写作现场。Wiki 页面则把这些内容抽象成稳定定义、结构和关系。
一个读者可以先读 Wiki，快速理解概念；再回到 Substack，阅读完整文章。
也可以反过来：先通过文章认识一个观点，再进入 Wiki 看到它在整个体系中的位置。
SEO 和 GEO 的考虑
Wiki 的 SEO 目标不是追热点。
它更适合承接稳定搜索：
- 是什么。
- 有什么区别。
- 怎么搭建。
- 怎么选择。
- 核心概念。
- 术语解释。
GEO 方面，Wiki 的价值在于帮助 AI 搜索和回答系统理解 newtype 的知识结构。
llms.txt、sitemap、清晰标题、稳定路径、页面互链，都在为这件事服务。
当前状态
newtype Wiki 已经形成几个主要分区：
- Products。
- Topics。
- Guides。
- Compare。
- Tools。
- Glossary。
- Concepts。
- Threads。
- Entities。
它不是一个完成品，而是一个会随着内容继续生长的系统。
后续方向
后续最重要的不是继续堆页面，而是维护质量。
需要持续做几件事：
- 给新文章补充相关 Wiki 链接。
- 给新概念创建页面。
- 定期更新旧页面。
- 增加页面之间的互链。
- 检查 Search Console 数据。
- 根据搜索词补充高意图页面。
Wiki 的价值来自长期维护。
它不是一次性搭建项目，而是 newtype 内容系统的第二大脑。