Repos / zenx-global / zenx-database OWN

zenx-database

佛教三藏数据库

佛教三藏数据库

覆盖北传(大乘)、南传(上座部)、藏传(金刚乘)三大佛教传承的知识库与数据平台。

内容统计

传承 文件数 类别
北传 274 经典·教义·人物·宗派·禅宗·辞典·戒律·修行·仪轨·止观·论典
南传 119 经典·教义·人物·宗派·禅修·戒律·止观·阿毗达摩·论典·历史·仪轨
藏传 150 经典·密法·人物·宗派·传承·辞典·戒律·修行·仪轨·教义·止观
公共 51 人物·历史·学术·教义(跨传承比较)
百科 52 英文百科词条
学习路径 5 基础正见→进阶深入→研学精深→实修专修
专题 17 唯识与中观·禅修日读(专题长文)
总计 668

目录结构

content/                                    ← 全部词条内容(MDX)
  ├─ 北传/ 南传/ 藏传/ 公共/ 学习路径/ 专题/
  ├─ 禅学社/ 图解/                           活动资料与图解
  └─ 百科/                                  英文百科词条(含 英文版/)
data/                                       ← 原始语料
  ├─ 经文/                                  经文纯文本(CBETA 转换 + 注音版)
  └─ corpus/                                CBETA XML / 84000 JSON / BDTL 原始下载
apps/
  ├─ web/                                   Next.js 前端
  └─ mac/                                   macOS 原生应用(SwiftUI,./apps/mac/build.sh 构建)
infra/
  ├─ database/                              Prisma ORM + SQLite
  ├─ tools/                                 下载/导入/维护脚本
  └─ catalog/                               词条反向链接与经文元数据索引
docs/
  ├─ gtm/                                   GTM 资料
  ├─ ai-chat/                               mac 应用保存的 AI 问答记录
  └─ *.md                                   项目文档与评估

技术栈

  • 前端:Next.js 16 (Turbopack) + Tailwind CSS + TypeScript
  • 数据库:SQLite + Prisma ORM(13 个模型)
  • 内容:MDX(frontmatter + Markdown)
  • 经文源文件:CBETA XML(汉传)、84000 JSON(藏传)

快速启动

# 安装依赖
npm install

# 生成 Prisma Client
npx prisma generate --schema infra/database/prisma/schema.prisma

# 启动开发服务器(端口 3099)
npm run dev

API 端点

端点 方法 功能
/api/sutras GET 列出所有经典
/api/sutras/[id] GET 获取单部经典详情
/api/search?q= GET 全文搜索
/api/stats GET 数据统计

URL 结构

/zh/docs/北传/经典/心经
/zh/docs/南传/教义/四念处
/zh/docs/藏传/密法/大圆满
/zh/docs/专题/禅修日读/01-止观双运教法体系
/en/docs/教义/菩提心
/en/docs/南传/禅修/葛印卡内观

数据来源

传承 来源 授权
北传 CBETA 中华电子佛典协会 开放资料
南传 SuttaCentral / Buddhist Digital Text Library CC BY 4.0
藏传 84000 翻译佛经 CC BY 4.0

脚本

# 下载 CBETA 汉文大藏经
npx tsx infra/tools/download/cbeta-download.ts

# 导入全部数据
npx tsx infra/tools/import/full-import.ts

# 维护:回填 frontmatter ID
node infra/tools/maintenance/backfill-id.mjs

# 维护:校验全库 frontmatter(必填字段 + enum,非0退出码=有违规)
node infra/tools/maintenance/lint-frontmatter.mjs

# 维护:重建反向链接索引
node infra/tools/maintenance/build-backlinks.mjs

许可

内容采用各来源原有授权。CBETA 数据为开放资料,84000 与 BDTL 数据为 CC BY 4.0。