ARTIFACT / PERSONAL-SHRINE

personal-shrine（铸造圣所）

ACTIVE SYSTEM

个人档案与离线工具箱静态站：结合 Astro 静态站点生成器与 Obsidian 笔记库架构，收录单文件离线工具集、学术笔记索引与技术实践归档，构建时完成双链解析与渲染，全站纯静态离线可用。

◈ System Profile ◈

◈ Access · 访问入口 ◈

◈ Sections · 章节 ◈

◈ README ◈

状态：可用（本地构建正常，学术敏感信息已迁出；全站静态生成无后端）；入口：pnpm dev（本地 :4321）或 pnpm ship 静态发布；仓库：fire-disposal/personal-shrine

本质

把 Obsidian Markdown 双链笔记库与单文件 HTML 实用工具集通过 Astro 编译为纯静态离线档案站的内容管线。

基于 Astro 静态生成器的离线优先内容站，笔记采用 Obsidian Markdown 格式，公式由 KaTeX 构建期预渲染，工具采用原生 HTML/JS 编写。

运行时
- Node 22 / pnpm
核心框架
- Astro (Static Site Generation)
- TypeScript
内容与管线
- Obsidian Markdown（src/content/notes/）
- remark-vault（解析 Wikilink、嵌入 ![[]]、行内标签与 Callout）
- KaTeX（构建期数学公式渲染）
- Zod（Frontmatter 模式校验）
工具层
- 原生 HTML5 + CSS3 + 纯 JavaScript（tools/*.html，零外部 CDN）
部署
- 纯静态 dist/ 构建 + rsync 静态服务器部署

离线工具箱：/tools/ 目录收录单文件自包含小工具（考试倒计时、计算器等），file:// 协议直接打开即用。
造物归档：/projects/ 把笔记库 开发/ 架上符合 README 结构的笔记直接编译为造物档案与详情页——状态、入口、仓库、章节全部取自笔记，没有手工项目清单。
笔记档案库：支持 Obsidian 风格的标签检索、置顶推荐与双向链接引用解析。
构建期语法检查：Frontmatter 模式由 Zod 严格校验，元数据错误时构建立即中断。
零运行时依赖：全站不引入远程字体、不加载外部 CDN、不包含任何远程统计跟踪代码。
未完成：端上离线全局模糊全文搜索；主题切换动态平滑过渡。

pnpm install
pnpm dev       # 启动本地预览服务器 http://localhost:4321
pnpm build     # 构建纯静态产物至 dist/
pnpm check     # TypeScript 与 Astro 类型自检

前置：Node 20+ 与 pnpm；全站无任何数据库与外部 API 依赖；执行 pnpm ship 可直接将 dist/ rsync 同步至服务器 nginx 静态目录。