new

.env.example

@@ -2,6 +2,10 @@
 
 # 可在此添加环境变量，去掉最左边的（# ）注释即可
 # Notion页面ID,必须
+# 单语言格式：NOTION_PAGE_ID=097e5f674880459d8e1b4407758dc4fb
+# 多语言格式（推荐）：NOTION_PAGE_ID=中文数据库ID,en:英文数据库ID
+# 示例：NOTION_PAGE_ID=2a2f7026d6674bd19c5aec3c94bfd453,en:13e00092b9778002a3e2d5278bab3cd9
+# 访问方式：yoursite.com/ (中文默认), yoursite.com/en/ (英文)
 # NOTION_PAGE_ID=097e5f674880459d8e1b4407758dc4fb
 # API_BASE_URL=https://www.notion.so/api/v3
 
@@ -56,10 +60,12 @@
 # NEXT_PUBLIC_POST_RECOMMEND_COUNT=
 # NEXT_PUBLIC_POSTS_PER_PAGE=
 # NEXT_PUBLIC_POST_SORT_BY=
-# NEXT_PUBLIC_ALGOLIA_APP_ID=
-# ALGOLIA_ADMIN_APP_KEY=
-# NEXT_PUBLIC_ALGOLIA_SEARCH_ONLY_APP_KEY=    
-# NEXT_PUBLIC_ALGOLIA_INDEX=
+# Algolia 全文搜索配置 @see https://dashboard.algolia.com/account/api-keys/
+# 免费方案：每月10000次搜索请求，存放10000条数据
+# NEXT_PUBLIC_ALGOLIA_APP_ID=your_app_id
+# ALGOLIA_ADMIN_APP_KEY=your_admin_key（管理端秘钥，不要暴露在前端）
+# NEXT_PUBLIC_ALGOLIA_SEARCH_ONLY_APP_KEY=your_search_only_key（客户端搜索秘钥）
+# NEXT_PUBLIC_ALGOLIA_INDEX=your_index_name（数据库索引名称）
 # NEXT_PUBLIC_PREVIEW_CATEGORY_COUNT=  
 # NEXT_PUBLIC_PREVIEW_TAG_COUNT=
 # NEXT_PUBLIC_POST_TITLE_ICON=
@@ -71,7 +77,11 @@
 # NEXT_PUBLIC_FLUTTERINGRIBBON=
 # NEXT_PUBLIC_RIBBON=
 # NEXT_PUBLIC_STARRY_SKY=
-# NEXT_PUBLIC_CHATBASE_ID=
+# Chatbase AI聊天机器人配置 @see https://www.chatbase.co/
+# 免费方案：每月20条消息限制，1个聊天机器人，400,000字符/机器人
+# 注册后在 "Embed on site" 部分获取您的Chatbot ID
+# 聊天机器人将显示在网站右下角
+# NEXT_PUBLIC_CHATBASE_ID=your_chatbase_id
 # NEXT_PUBLIC_WEB_WHIZ_ENABLED=
 # NEXT_PUBLIC_WEB_WHIZ_BASE_URL=
 # NEXT_PUBLIC_WEB_WHIZ_CHAT_BOT_ID=  

AGENTS.md

@@ -0,0 +1,38 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+pages/ hosts Next.js route entrypoints; keep them thin and move data fetching or transforms into lib/.
+components/ stores reusable view modules (PascalCase) and shared atoms in components/ui; co-locate CSS modules.
+themes/ packages page layouts for DynamicLayout; reuse folder names when adding variations so imports stay stable.
+lib/ contains Notion client adapters, SEO utilities, and service wrappers.
+hooks/ keeps reusable React hooks; prefer colocating supportive types.
+conf/ and blog.config.js hold deployment defaults; public/ carries static assets, icons, and fonts; docs/ tracks longer-form references.
+
+## Build, Test, and Development Commands
+npm install installs dependencies (Node 20+).
+npm run dev launches the hot-reload server for manual QA.
+npm run build compiles the production bundle; follow with npm run post-build to refresh sitemap and RSS artifacts.
+npm run export emits a static bundle when EXPORT=true for GitBook-style deployments.
+npm run bundle-report opens the Webpack analyzer to flag oversized themes or vendors.
+npm run build-all-in-dev simulates a production deploy without leaving local dev.
+
+## Coding Style & Naming Conventions
+Run npx eslint . --ext .js,.jsx,.ts,.tsx before opening a PR; rules inherit Next, React, and TypeScript presets.
+Format with npx prettier --write . (2-space indent, single quotes, no semicolons, JSX brackets inline).
+Name components and hooks with descriptive PascalCase or camelCase (e.g., components/AlgoliaSearchModal.tsx, hooks/useAdjustStyle.ts); group theme-specific pieces under their theme folder.
+Favor TypeScript for new utilities, keep types near usage, and import via the @/ alias rather than deep relative paths.
+
+## Testing Guidelines
+There is no baseline automated coverage; manually smoke-test Notion sync, theme switching, and SEO tags in npm run dev before sign-off.
+Add Jest or Playwright specs alongside critical logic (e.g., lib/notion.spec.ts) and capture follow-up debt in the PR if coverage is deferred.
+Attach brief manual QA notes in pull requests, especially for analytics, auth, or deployment-sensitive changes.
+
+## Commit & Pull Request Guidelines
+Follow the existing history: scope-prefixed, imperative subjects such as SEO: refresh og tags or fix: prevent undefined themeId.
+Keep commits focused and include any paired configuration or translation updates.
+Pull requests must include a concise summary, linked issues, test/QA results, and screenshots or GIFs whenever UI behavior shifts.
+Coordinate reviews with owners of affected themes or integrations and wait for a clean CI build before merging.
+
+## Security & Configuration Tips
+Store secrets only in .env.local or the hosting dashboard; never commit them.
+Mirror .env.example when provisioning environments and ensure VERCEL_ENV is set correctly for preview versus production releases.