Anx 的个人网站

个人网站。首页展示个人介绍、GitHub 贡献热力图与最近的内容入口，另有项目、文章、收藏、作品、经历等页面。

尚未发布。 部署到 Vercel 后在项目设置里加 NEXT_PUBLIC_APP_URL，并同步改掉 src/config/site.ts 里的 SITE_DOMAIN（正文的绝对链接、JSON-LD、sitemap、OG 图都从这两处取值）。

技术栈

• Next.js 16（App Router、Turbopack）
• React 19 + TypeScript（strict）
• Tailwind CSS v4 + shadcn/ui
• MDX —— 文章与文档
• Motion —— 动效；Vitest —— 测试
• pnpm —— 包管理

本地运行

pnpm install
cp .env.example .env.local   # 按需填写，见下
pnpm dev

打开 https://anx.localhost（next.config.ts 的 allowedDevOrigins 里配的就是这个域名，.env.local 的 NEXT_PUBLIC_APP_URL 也应指向它 —— 用裸端口会让生成的绝对链接对不上）。

常用命令：

pnpm build          # 生产构建
pnpm start          # 起生产服务
pnpm test:run       # 跑一次测试
pnpm check-types    # 类型检查
pnpm lint           # ESLint
pnpm format:write   # Prettier

推代码前 CI 会跑 lint / format:check / build / check-types，本地先过一遍。

页面

地址	内容
/	个人介绍、GitHub 贡献热力图、About、Blog、Education、Projects
/blog	文章列表（含搜索）
/blog/<slug>	文章正文
/bookmarks	收藏，按分类筛选
/craft	作品展示
/timeline	时间线
/testimonials	评价
/sponsors	赞助

AI 与爬虫可读的纯文本入口：/llms.txt、/index.md，以及每篇文章和每个栏目的 .md 版本（如 /blog/a-place-of-my-own.md）。发 Accept: text/markdown 请求网页地址也会返回 markdown。

内容维护

内容和页面组件分开，改内容不用动组件。

内容	位置
个人信息（名字、简介、头像、位置、时区）	src/features/portfolio/data/user.ts
社交账号	src/features/portfolio/data/social-links.ts
站点配置（域名、导航、许可）	src/config/site.ts
项目	src/features/portfolio/data/projects.tsx
经历 / 教育 / 技能栈	src/features/portfolio/data/{experiences,education,tech-stack}.tsx
奖项、认证、知识产权	src/features/portfolio/data/{awards,certifications,intellectual-property}.ts
时间线	src/features/portfolio/data/timeline.ts
评价	src/features/portfolio/data/testimonials.tsx
赞助商	src/features/sponsor/data.tsx
收藏	src/features/bookmark/data.tsx
作品	src/features/craft/data.ts
文章	src/features/doc/content/blog/*.mdx
头像与图标	public/images/、public/*

几个约定：

• 列表为空时整个区块不渲染。 不想展示某个栏目，把对应数组清空即可，不会留下只有标题的空壳。
• 日期、链接这类字段是选填的。 项目没有公开链接、或不知道开始时间时，整个 period / link 字段省略即可，卡片会自动不显示那一项 —— 不要为了填满而编造。
• 文章用 MDX，frontmatter 需要 title、description、createdAt、updatedAt（YYYY-MM-DD）。分类由目录名决定，放在 content/blog/ 下就是文章。

环境变量

全部可选，不配也能跑；只有需要对应功能时才填。详见 .env.example。

变量	作用
NEXT_PUBLIC_APP_URL	站点绝对地址，影响 JSON-LD、sitemap、OG 图
NEXT_PUBLIC_GITHUB_CONTRIBUTIONS_API_URL	首页贡献热力图的接口，默认用公开的 jogruber API
GITHUB_API_TOKEN	头部仓库 star 数。不填走匿名请求（有限流），也能用
OPENPANEL_*	OpenPanel 分析
NEXT_PUBLIC_GTM_ID	Google Tag Manager
DISCORD_FEEDBACK_WEBHOOK_URL	文档页「这篇有用吗」的回调；不填则打到本地控制台
NEXT_PUBLIC_CARBON_ADS_*	Carbon 广告；两个都留空则完全不渲染广告位

来源与许可

本项目改造自 ncdai/chanhdai.com，MIT 许可。原作者的版权声明保留在 LICENSE 中（MIT 要求），品牌相关的限制见 TRADEMARK.md —— 也就是说，代码可以随便用，但 chanhdai / ncdai 这些名字和他的头像、标识不是。

界面基础控件来自 shadcn/ui，部分组件取自 Cult UI 和 Kibo UI；图标用 Lucide；动效用 Motion。