注疏
术语表
站里每一个一等术语——知识图谱的节点。正文里的靛青虚线词都指向这里,悬停即可速览。
mindplace 概念
- 节点mindplace 的基本单位——笔记和术语都是节点,有永久 uid、有版本、可被批注,节点之间靠双链和术语提及连成知识图。
- 派生投影mindplace 的核心纪律——数据库里的一切(节点、边、向量、版本快照)都是从 md+Git 算出来的投影,可随时全量重建,不是原始数据。
- 数字校勘室mindplace 的设计语言——把古籍校勘的三样东西搬进数字知识库:朱批(评论)、校勘记(版本)、注疏(术语双链)。
- 双链作者手写的 [[术语]] 关联,是知识图谱里最硬的一类边——人明确确认的关系,优先级高于机器推断。
- 校勘记mindplace 的版本系统——像古籍末尾记录不同抄本的异文,每篇文章的每次实质修订都留一版整篇快照,可翻回旧文看当时的思路。
- 语义指纹把 md 正文归一化(去空白、NFKC)后取的 sha256,用来判断"内容真的变了没有"——改错别字不算变,重写一段才算。
- 朱批mindplace 的评论系统——像古人用朱笔在书页上批注,读者选中正文一段就地写下想法,评论锚在那段文字上,不挂文末。
- 注疏mindplace 的术语关联系统——像古人给经文做注疏,正文里的术语自动链接到词条,悬停即显释义,点进去看详解。
- md+Git 唯一源mindplace 的地基信条——Markdown 文件加 Git 历史是唯一的原始数据,其余全是派生。选它是因为纯文本活得过任何框架。
- uid节点的永久身份,一个写进 frontmatter 的 UUIDv7。slug 是会变的 URL,uid 不变——改文件名、库重建都不丢评论和版本。
检索
前端
- Astro islandsAstro 的核心架构——页面默认是零 JS 的静态 HTML,只有需要交互的组件(岛)才单独注水,其余保持纯静态。
数据结构
- B-tree数据库索引最常用的平衡多路查找树,把"从海量数据里定位一条"变成几次磁盘跳转。mindplace 的"节点"概念就是从它长出来的。
模型
- bge-small-zh-v1.5智源开源的中文文本嵌入模型,512 维、约 500MB,能在无 GPU 的小服务器上进程内跑 CPU 推理。mindplace 的语义检索用它把文字变成向量。
- DeepSeek一个低价的国产大模型 API。mindplace 只在管道末级用它做隐性关系抽取、释义草稿这类可选活,不进核心链路。
运维
- Caddy一个自动管理 HTTPS 证书的 Web 服务器。mindplace 用它做静态文件服务和 /api 反代,一行配置换来自动续期的证书。
后端
- FastAPIPython 的异步 Web 框架,靠类型注解自动生成校验和文档。mindplace 用它做检索和读写 API,因为它和作者公司技术栈同构。
数据库
- ltreePostgreSQL 的一个扩展,用来存和查树状层级路径(如 1.5.12)。mindplace 用它表示术语的 is_a 层级。
LLM 工程
- pgvector给 PostgreSQL 加向量类型与相似度检索的开源扩展,向量和业务数据同库同事务,支持 ivfflat/HNSW 索引。
Web 标准
- TextQuoteSelectorW3C 标注模型里定位一段文字的方式——用"引用内容"而非"字符位置"锚定,文章别处改了也不飘。mindplace 的批注锚点用它。