Article node / reading chamber

Hypervoid · README

置顶2026-05-25 更新于 2026-05-29· 技术· 1,254 字 · 5 分钟· 61·#Hypervoid #README #元信息

GitHub 仓库的 README——这套博客的功能总览、技术栈、本地起步、路线图。基本同步代码库。

随机一篇

相关推荐

1 篇

你好，Hypervoid！

Hypervoid 是 Charon 的个人博客。

2026-06-173m

滚动到这里时加载评论…

✦ About

Hypervoid is the source of my personal blog & digital garden — built from an empty directory, no template, every line designed to grow with me.

Articles live in Postgres, images in Vercel Blob, comments in GitHub Discussions, and the whole site auto-deploys on every push to main. The admin panel writes directly to the database; no rebuilds needed per post. AI summary and Q&A run on Claude Haiku 4.5.

✦ Features

MDX articles with Shiki syntax highlighting — filename header, copy button, language label

GFM alerts (> [!NOTE] etc.) + KaTeX math + reading time (CJK-aware)

Pinned posts + prev/next nav + article series (multi-part collections with sibling-article banner)

Reading progress bar + reading mode toggle (normal / sepia / sepia+large)

"✓ 已读" badge on visited articles (localStorage, after 6 s dwell) + "↻ 更新于" badge when revised

Visitor bookmarks — save articles to a personal /bookmarks page (localStorage)

Hover-expand share buttons (copy link · X · Weibo) + /donate scaffolding (off behind a feature flag)

Tags index + per-tag pages + search filters (filter results by tag/year chips)

Full-text search (pg_trgm GIN, Chinese substrings) with ⌘K / Ctrl+K shortcut

Sticky TOC with IntersectionObserver scroll-spy

Single / double column toggle on /posts, /tags/[tag], /archive

Site settings panel — 6 palettes + free hue · 6 backgrounds (cosmic / particles / acg / paper / waves / plain) · 3 display modes (fullscreen / banner / simple) · 3 fonts

System / light / dark theme + cosmic-orbit favicon (custom SVG) + per-article OG image (auto-sized title, brand mark)

RSS 2.0 feed + sitemap.xml + PWA manifest + apple-touch icon

Comments via Giscus (mapping="pathname")

View counter + like button with localStorage-tracked toggle (atomic Postgres upserts)

AI summary + AI Q&A modal (Claude Haiku 4.5, streamed)

Bangumi integration — anime (detail modal with rating histogram) · movies · books (subject types 2/6/1)

Steam game library — /games, recent-2-weeks + total playtime + search + sort

Cosmic-themed 404 with random article recommendation

Back-to-top floating button + page fade-in transition

Sidebar widgets: profile card · mini calendar · 365-day heatmap · popular posts · tag cloud · recent guestbook · site stats · email subscribe

Custom pages: /projects · /skills · /timeline · /albums · /diary · /friends · /guestbook · /archive · /series

Bilingual UI (zh-CN / en) via custom React Context

Mobile-first responsive layout + hamburger drawer

Admin dashboard at /admin — stats (posts/views/likes/subscribers) · recent published · pending counters (drafts / scheduled / private / missing-summary)

GitHub-OAuth-gated — only ADMIN_GITHUB_LOGIN may enter

In-browser MDX editor — title-driven slug · tags · category · cover · status · public/private visibility · article series + order

AI tag suggestions — Claude Haiku reads the draft and proposes 3-5 tags biased toward your existing taxonomy

AI summary — manual one-click + auto-generated on first publish via next/server's after() (no editor wait)

Draft / scheduled / published workflow + daily cron at 04:00 UTC + comment moderation deep-link to the underlying GitHub Discussion

One-click image upload to Vercel Blob — markdown ![alt](url) injected at cursor

Friends / albums / guestbook CRUD with pill-style admin nav

Email subscriber list — confirmed-only via double opt-in, Resend backend

Print-friendly stylesheet — Ctrl/⌘+P strips chrome, keeps article body

/              首页 (latest posts + sidebar widgets)
/posts         所有文章
/posts/[slug]  文章详情 (TOC · views · likes · AI Q&A · comments · prev/next · share)
/tags          所有标签 (with counts)
/tags/[tag]    标签筛选
/archive       归档 (按年月)
/anime         番剧
/movies        影视 (Bangumi subject_type=6)
/books         书籍 (Bangumi subject_type=1)
/games         Steam 游戏库
/projects      项目
/skills        技能
/timeline      时间线
/albums        相册首页
/albums/[slug] 相册详情
/diary         日记
/friends       友链
/guestbook     留言板
/about         关于
/search        全文搜索 (?q + ?tag + ?year)
/series        文章系列索引
/series/[name] 单个系列详情
/bookmarks     本地收藏夹 (localStorage)
/donate        赞赏页 (默认隐藏，受 siteConfig.donate.enabled 控制)
/admin         后台 dashboard (GitHub OAuth)

✦ Tech stack

Layer	Choice
Framework	Next.js 16 (App Router, Turbopack)
UI	React 19 + Tailwind CSS v4 + @tailwindcss/typography
Content	`next-mdx-remote` + `remark-gfm` + `remark-math` + `remark-github-blockquote-alert` + `rehype-katex` + `rehype-slug` + `rehype-autolink-headings`
Syntax	Shiki via `@shikijs/rehype` (custom transformer for filename/lang meta)
Data	Postgres on Neon + Drizzle ORM
Search	Postgres `pg_trgm` extension + GIN index
Auth	Auth.js v5 + GitHub provider
Images	Vercel Blob
Comments	Giscus
Email	Resend
Analytics	Umami Cloud
AI	Anthropic SDK (Claude Haiku 4.5, streamed)
Hosting	Vercel (Hobby tier + daily cron)

Layer

Choice

Framework

Next.js 16 (App Router, Turbopack)

React 19 + Tailwind CSS v4 + @tailwindcss/typography

Content

next-mdx-remote + remark-gfm + remark-math + remark-github-blockquote-alert + rehype-katex + rehype-slug + rehype-autolink-headings

Syntax

Shiki via @shikijs/rehype (custom transformer for filename/lang meta)

Data

Postgres on Neon + Drizzle ORM

Postgres pg_trgm extension + GIN index

Auth

Auth.js v5 + GitHub provider

Images

Comments

Analytics

Anthropic SDK (Claude Haiku 4.5, streamed)

Hosting

Vercel (Hobby tier + daily cron)

✦ Run locally

bash

git clone https://github.com/HyperCharon/hypervoid.git
cd hypervoid
pnpm install

# 1. Copy env template and fill in your own credentials
cp .env.example .env.local
#   - DATABASE_URL          (Neon project)
#   - AUTH_SECRET           (openssl rand -base64 32)
#   - AUTH_GITHUB_ID/SECRET (https://github.com/settings/developers)
#   - ADMIN_GITHUB_LOGIN    (your GitHub username)
#   - NEXT_PUBLIC_GISCUS_*  (https://giscus.app)
#   - BLOB_READ_WRITE_TOKEN (Vercel Blob)
#   - RESEND_API_KEY        (optional, for newsletter)
#   - ANTHROPIC_API_KEY     (optional, for AI summary/Q&A)
#   - NEXT_PUBLIC_UMAMI_WEBSITE_ID (optional)

# 2. Push schema, then rebuild full-text search indexes (db:push drops them)
pnpm db:push
pnpm exec tsx scripts/setup-search.ts

# 3. Run
pnpm build

⚠ If pnpm dev crashes the browser / IDE, switch to pnpm build && pnpm start. Shiki + Turbopack on Next 16 can eat RAM aggressively.

✦ Roadmap

v0.1 — multi-page scaffold · MDX · theme toggle

v0.2 — RSS · sitemap · OG image · TOC · tag pages

v0.3 — Giscus comments · view counter · like button

v0.4 — admin panel · MDX editor · draft & scheduled publishing · image upload

v0.5 — newsletter (Resend) · analytics (Umami Cloud) · full-text search (pg_trgm)

v1.0 — i18n · guestbook · friends · albums · AI summary & Q&A · live site-settings editor · 70+ features shipped

v1.x — article-level i18n · Resend custom domain · ACG wallpapers activation · donate QR codes

Hypervoid · README

相关推荐

评论

✦ About

✦ Features

Reader-facing

Author-facing

Site map

✦ Tech stack

✦ Run locally

✦ Documentation

✦ Roadmap

✦ License

✦ Credits