@hutusi/amytis 1.8.0 → 1.10.0

package/.entire/settings.json

@@ -0,0 +1,4 @@
+{
+  "enabled": true,
+  "telemetry": false
+}

package/.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
         run: bun run lint
 
       - name: Run Tests
-        run: bun test
+        run: bun run test
 
       - name: Build
         run: bun run build:dev

package/CHANGELOG.md

@@ -5,6 +5,44 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.10.0] - 2026-03-02
+
+### Added
+- **Configurable URL Topology**: Added support for `posts.basePath` and `series.customPaths` so posts and series can be served under custom prefixes.
+- **Single-Language Mode**: Added `i18n.enabled` to disable multilingual routing/UI when running a single-locale site.
+- **Homepage Content Controls**: Added pinned-post support and optional post subtitles for improved featured and latest sections.
+- **Author Profile Expansion**: Added configurable default authors plus optional author avatar/social images and header/card visibility toggles.
+- **Publishing Controls**: Added `posts.excludeFromListing` to keep selected series posts out of the main `/posts` feed.
+- **Deployment & Media**: Added one-command Linux/nginx deploy script and `images.cdnBaseUrl` support for serving images from a CDN.
+- **Branding Controls**: Added configurable logo and favicon paths in `site.config.ts`.
+
+### Changed
+- **Homepage Design System**: Refined homepage layout and card hierarchy across hero, featured content, latest writing, and series sections.
+- **Subscribe Surface**: Moved `/subscribe` to content-driven authoring so users can fully edit subscription copy in Markdown/MDX.
+- **Documentation**: Updated architecture, deployment, and configuration guides to reflect current routing and feature behavior.
+
+### Fixed
+- **Static Export Stability**: Fixed `output: "export"` edge cases by returning placeholder params for empty/disabled dynamic routes.
+- **Dynamic Routing Conflicts**: Resolved route naming and generation conflicts for custom prefixes and static params.
+- **Navigation Consistency**: Fixed mismatch between navigation post URL and configured posts base path.
+- **Book Route Safety**: Prevented invalid book chapter params by validating chapter existence before route generation.
+- **Image Handling**: Fixed markdown image path resolution across content types and ensured CDN prefixing is applied consistently.
+- **Rendering & Type Safety**: Fixed TypeScript handling for custom `rss-feed` element and addressed dev-time WebP 404 behavior.
+
+## [1.9.0] - 2026-02-28
+
+### Added
+- **Book Importer**: Added `bun run import-book` to import GitBook/Markdown-style books into `content/books/` with chapter mapping support.
+- **Flow Chat Import Improvements**: Extended `new-flow-from-chat` with improved formatting and optional timestamp output.
+
+### Changed
+- **Import Reliability**: Hardened `import-book` chapter path and ID handling for mixed source structures.
+
+### Fixed
+- **Author Slug Normalization**: Stabilized `getAuthorSlug` output for bracketed and edge-case names.
+- **Image Path Handling**: Fixed import image-path normalization to correctly handle `../images/`, `./images/`, and `images/` patterns.
+- **Test Consistency**: Aligned static-params mock slug behavior with production logic to avoid CI-only test leakage failures.
+
 ## [1.8.0] - 2026-02-24
 
 ### Added

package/CLAUDE.md

@@ -25,24 +25,18 @@ bun run build              # Full production build (copies assets, builds Next.j
 bun run build:dev          # Development build (no image optimization, faster) — also regenerates Pagefind search index in public/pagefind/
 bun run clean              # Remove .next, out, public/posts directories
 
+# Deploy
+bun run deploy             # Deploy out/ to Linux/nginx server via rsync+sshpass (reads .env.local)
+
 # Content creation
-bun run new "Post Title"              # Create new post (flat file)
-bun run new "Title" --folder          # Create as folder with index.mdx
-bun run new "Title" --prefix weekly   # Create with prefix (e.g., weekly-title)
-bun run new "Title" --template custom # Use custom template from templates/
-bun run new "Title" --md              # Create as .md instead of .mdx
-bun run new "Title" --series my-series # Create post in content/series/my-series/
-bun run new-series "Series Name"      # Create new series with cover image
-bun run new-from-pdf doc.pdf          # Create post from PDF (converts pages to images)
-bun run new-from-pdf doc.pdf --title "My Document"  # With custom title
-bun run new-from-pdf doc.pdf --scale 3.0            # Higher resolution (default: 2.0)
+bun run new "Post Title"              # Create new post
+bun run new-series "Series Name"      # Create new series
+bun run new-from-pdf doc.pdf          # Create post from PDF
 bun run new-from-images ./photos      # Create post from image folder
-bun run new-from-images ./photos --title "My Gallery"  # With custom title
-bun run new-from-images ./photos --sort date           # Sort by date (default: name)
-bun run new-from-images ./photos --no-copy             # Reference images instead of copying
-bun run new-flow                    # Create today's flow note (.md)
-bun run new-flow "My Title"         # Create flow with custom title
-bun run new-flow --mdx              # Use .mdx format instead
+bun run new-flow                      # Create today's flow note
+bun run new-flow-from-chat            # Import all new files from imports/chats/
+bun run sync-book                     # Sync chapters list for all books from disk
+bun run sync-book <slug>              # Sync chapters list for one book
 ```
 
 ## Architecture
@@ -58,6 +52,7 @@ bun run new-flow --mdx              # Use .mdx format instead
 
 - `site.config.ts` - Site configuration (nav, social, pagination, themes, i18n, analytics, comments)
 - `src/lib/markdown.ts` - Data access layer with all content query functions
+- `src/lib/urls.ts` - Central URL helpers (`getPostUrl`, `getPostsBasePath`, `getSeriesCustomPaths`, etc.) — always use these instead of hardcoding `/posts/[slug]`
 - `src/lib/search-utils.ts` - Pure search utilities (URL type detection, date extraction, title cleaning, markdown stripping) shared by `Search` and the search index route
 - `src/app/globals.css` - Theme CSS variables and color palettes
 - `src/components/MarkdownRenderer.tsx` - MDX rendering with all plugins
@@ -83,7 +78,9 @@ bun run new-flow --mdx              # Use .mdx format instead
 - `/flows/[year]` - Flows filtered by year
 - `/flows/[year]/[month]` - Flows filtered by month
 - `/flows/[year]/[month]/[day]` - Single flow detail page
-- `/[slug]` - Static pages (about, etc.)
+- `/[slug]` - Static pages (about, subscribe, etc.) and custom posts/series listing pages
+- `/[prefix]/[slug]` - Posts at custom URL prefixes (e.g. `/articles/my-post`, `/weeklies/my-post`)
+- `/[prefix]/page/[page]` - Paginated listing at custom URL prefixes
 
 ### Content Structure
 
@@ -105,6 +102,7 @@ Key configuration options:
 - `nav` - Navigation links with weights
 - `social` - GitHub, Twitter, email links for footer
 - `series.navbar` - Series slugs to show in navbar dropdown
+- `series.customPaths` - Per-series custom URL prefix e.g. `{ 'weeklies': 'weeklies' }` → posts at `/weeklies/[slug]`
 - `pagination.posts`, `pagination.series` - Items per page
 - `themeColor` - 'default' | 'blue' | 'rose' | 'amber'
 - `hero` - Homepage hero title and subtitle
@@ -113,6 +111,12 @@ Key configuration options:
 - `featured.stories` - Scrollable stories: `scrollThreshold` (default: 1), `maxItems` (default: 5)
 - `analytics.provider` - 'umami' | 'plausible' | 'google' | null
 - `comments.provider` - 'giscus' | 'disqus' | null
+- `posts.basePath` - Custom URL prefix for all posts (default: `'posts'`); e.g. `'articles'` → posts at `/articles/[slug]`
+- `posts.authors.default` - Fallback authors when a post has none set in frontmatter
+- `posts.authors.showInHeader` - Show author byline below post title (default: true)
+- `posts.authors.showAuthorCard` - Show author card at end of post (default: true)
+- `posts.excludeFromListing` - Series slugs whose posts are hidden from `/posts` listing pages
+- `authors` - Per-author profiles: `bio`, `avatar` (image path), `social` (array of `{ image, description }`)
 
 ## Content Frontmatter
 
@@ -129,6 +133,7 @@ authors: ["Author Name"]
 series: "series-slug"      # Link to a series
 draft: true                # Hidden in production
 featured: true             # Show in featured section
+pinned: true               # Always shown in featured section; never shuffled away (hero = most recent pinned)
 coverImage: "./images/cover.jpg"  # Local or external URL
 latex: true                # Enable KaTeX math
 toc: false                 # Hide table of contents
@@ -171,11 +176,11 @@ chapters:
   - part: "Part I: Getting Started"    # Optional part grouping
     chapters:
       - title: "Chapter Title"
-        file: "chapter-file"           # Maps to chapter-file.mdx in same directory
+        id: "chapter-file"             # Maps to chapter-file.mdx or chapter-file/index.mdx
   - part: "Part II: Advanced"
     chapters:
       - title: "Another Chapter"
-        file: "another-chapter"
+        id: "another-chapter"
 ---
 ```
 

package/README.md

@@ -1,11 +1,24 @@
 # Amytis
 
-**Amytis** is a high-performance, elegant digital garden built with Next.js 16, React 19, and Tailwind CSS v4. It is designed for cultivating thoughts, sharing knowledge, and growing ideas with a focus on typography and readability.
+[English](README.md) | [简体中文](README.zh.md)
+
+**Amytis** is an elegant, open-source framework for building a personal digital garden: a living knowledge space where ideas grow from raw notes to refined writing. It is built with Next.js 16, React 19, and Tailwind CSS v4, with a strong focus on readability, structure, and long-term content ownership.
 
 [**Live Demo**](https://amytis.vercel.app/)
 
 ![Amytis Screenshot](public/screenshot.png)
 
+## The Knowledge Ladder
+
+Amytis is built around a simple path from rough to refined:
+
+- **Flow**: Capture raw daily thoughts and fragments.
+- **Articles**: Refine one idea into a clear essay.
+- **Series**: Connect related articles into a curated narrative.
+- **Books**: Distill mature knowledge into structured chapters and parts.
+
+Each stage builds on the previous one, so your garden can evolve naturally.
+
 ## Features
 
 - **Digital Garden Philosophy:** Non-linear navigation through tags, series, authors, books, flows, and chronological archives.
@@ -48,6 +61,14 @@
 - **Content CLI Tools:** Create posts, series, and import from PDFs or image folders.
 - **Modern Stack:** Next.js 16, React 19, Tailwind CSS v4, TypeScript 5, Bun.
 
+## Design Philosophy
+
+- **Elegance by default**: Typography, spacing, and color should feel intentional out of the box.
+- **Content over configuration**: Writing and publishing should be simple file-based workflows, not CMS-heavy setup.
+- **Markdown-first, not markdown-limited**: Keep authoring portable while supporting rich output (math, diagrams, code, wikilinks).
+- **Ship what you need**: Features are modular through `site.config.ts`; disable sections you do not use.
+- **Plain text, long-term ownership**: Content stays in Markdown/MDX so it remains versionable and portable.
+
 ## Quick Start
 
 1. **Install Dependencies:**
@@ -75,38 +96,49 @@
 ## CLI Commands
 
 ```bash
-# Development
-bun dev                    # Start dev server at localhost:3000
-bun run lint               # Run ESLint
-
-# Build
-bun run build              # Full production build (copy assets + Next.js build + image optimization)
-bun run build:dev          # Development build (no image optimization, faster)
-bun run clean              # Remove .next, out, public/posts directories
-
-# Testing
-bun test                   # Run all tests
-bun run test:unit          # Run unit tests (src/)
-bun run test:int           # Run integration tests
-bun run test:e2e           # Run end-to-end tests
-
-# Content creation
-bun run new "Post Title"                          # Create new post (flat file)
-bun run new "Title" --folder                      # Create as folder with index.mdx
-bun run new "Title" --prefix weekly               # Create with prefix (e.g., weekly-title)
-bun run new "Title" --template custom             # Use custom template from templates/
-bun run new "Title" --md                          # Create as .md instead of .mdx
-bun run new "Title" --series my-series            # Create post in a series directory
-bun run new-series "Series Name"                  # Create new series with cover image placeholder
-bun run new-from-pdf doc.pdf                      # Create post from PDF (converts pages to images)
-bun run new-from-pdf doc.pdf --title "My Doc"     # With custom title
-bun run new-from-pdf doc.pdf --scale 3.0          # Higher resolution (default: 2.0)
-bun run new-from-images ./photos                  # Create post from image folder
-bun run new-from-images ./photos --title "Gallery" # With custom title
-bun run new-from-images ./photos --sort date      # Sort by date (default: name)
-bun run new-from-images ./photos --no-copy        # Reference images instead of copying
+## Core
+bun dev
+bun run lint
+bun run validate
+
+## Build & Deploy
+bun run build
+bun run build:dev
+bun run clean
+bun run deploy                 # Deploy to Linux/nginx server (requires .env.local)
+
+## Test
+bun test
+bun run test:unit
+bun run test:int
+bun run test:e2e
+
+## Create Content
+bun run new "Post Title"
+bun run new-series "Series Name"
+bun run new-note "Concept"
+bun run new-flow
+
+## Import / Maintain
+bun run new-from-pdf ./doc.pdf
+bun run new-from-images ./photos
+bun run new-flow-from-chat
+bun run import-book
+bun run sync-book
+bun run series-draft "series-slug"
 ```
 
+### Importing Chat Logs to Flows
+
+Drop `.txt` or `.log` files into `imports/chats/`, then run:
+
+```bash
+bun run new-flow-from-chat
+```
+
+Common flags: `--all`, `--dry-run`, `--author "Name"`, `--append`, `--timestamp`.
+Import history is stored in `imports/chats/.imported`.
+
 ## Configuration
 
 All site settings are managed in `site.config.ts`:
@@ -178,6 +210,7 @@ amytis/
 ## Documentation
 
 - [Architecture Overview](docs/ARCHITECTURE.md)
+- [Deployment Guide](docs/deployment.md)
 - [Digital Garden Guide](docs/DIGITAL_GARDEN.md)
 - [Contributing Guide](docs/CONTRIBUTING.md)
 

package/README.zh.md

@@ -0,0 +1,172 @@
+# Amytis
+
+[English](README.md) | [简体中文](README.zh.md)
+
+**Amytis** 是一个优雅的开源数字花园框架，用于构建个人知识空间。它基于 Next.js 16、React 19 和 Tailwind CSS v4，强调可读性、结构化表达与长期内容所有权。
+
+[**在线演示**](https://amytis.vercel.app/)
+
+![Amytis 截图](public/screenshot.png)
+
+## 知识阶梯
+
+Amytis 围绕一条从粗糙到精炼的知识路径构建：
+
+- **Flow（随笔）**：记录每日想法与碎片。
+- **Articles（文章）**：将单个想法打磨成清晰文章。
+- **Series（系列）**：把相关文章串联为一条主题叙事。
+- **Books（书籍）**：将成熟知识沉淀为章节化结构。
+
+每个阶段都建立在上一阶段之上，花园会自然生长。
+
+## 功能特性
+
+- **数字花园体验**：通过标签、系列、作者、书籍、Flow 和归档进行非线性导航。
+- **互联知识网络**：
+  - **双向链接**：支持 `[[Slug]]` 跨内容类型关联。
+  - **反向链接**：在笔记页自动显示“Linked References”。
+  - **知识图谱**：以可视化方式展示内容连接关系。
+- **全文搜索**：基于 Pagefind 的静态搜索，支持 Cmd/Ctrl+K 快捷键。
+- **结构化内容体系**：
+  - **Series**：支持手动或自动排序的多篇集合。
+  - **Books**：支持章节与分部的长篇阅读界面。
+  - **Notes**：原子化常青笔记。
+  - **Flows**：流式日记/微记录。
+- **富文本 MDX 能力**：
+  - GitHub Flavored Markdown（表格、任务列表等）
+  - 代码高亮
+  - Mermaid 图表
+  - KaTeX 数学公式
+  - 原生 HTML 支持
+- **阅读体验与设计**：
+  - 高可读排版与响应式布局
+  - 自动系统主题检测（明/暗）
+  - 四套配色主题：default、blue、rose、amber
+  - 吸顶目录与阅读进度跟踪
+- **性能与 SEO**：
+  - 全静态导出与 WebP 优化
+  - 自动 sitemap 与 RSS
+  - 支持 Latin/CJK 的多语言阅读时长估算
+- **集成能力**：
+  - 统计：Umami / Plausible / Google Analytics
+  - 评论：Giscus / Disqus
+  - i18n：`site.config.ts` 中配置多语言（en / zh）
+
+## 设计理念
+
+- **默认优雅**：排版、间距、色彩开箱即用且有审美一致性。
+- **内容优先**：通过文件化写作与发布流程完成创作，不依赖重型 CMS。
+- **Markdown 优先但不受限**：保持可迁移写作体验，同时支持数学、图表、代码和双向链接。
+- **按需启用**：`site.config.ts` 提供模块化开关，仅启用你需要的能力。
+- **纯文本长期所有权**：内容存储于 Markdown/MDX，便于版本管理与长期迁移。
+
+## 快速开始
+
+1. **安装依赖**
+   ```bash
+   bun install
+   ```
+
+2. **启动开发环境**
+   ```bash
+   bun dev
+   ```
+   打开 [http://localhost:3000](http://localhost:3000)。
+
+3. **生产构建（静态导出）**
+   ```bash
+   bun run build
+   ```
+   产物位于 `out/` 目录。
+
+4. **开发构建（更快，无图片优化）**
+   ```bash
+   bun run build:dev
+   ```
+
+## CLI 命令
+
+```bash
+## Core
+bun dev
+bun run lint
+bun run validate
+
+## Build & Deploy
+bun run build
+bun run build:dev
+bun run clean
+bun run deploy                 # 部署到 Linux/nginx 服务器（需要 .env.local 配置）
+
+## Test
+bun test
+bun run test:unit
+bun run test:int
+bun run test:e2e
+
+## Create Content
+bun run new "Post Title"
+bun run new-series "Series Name"
+bun run new-note "Concept"
+bun run new-flow
+
+## Import / Maintain
+bun run new-from-pdf ./doc.pdf
+bun run new-from-images ./photos
+bun run new-flow-from-chat
+bun run import-book
+bun run sync-book
+bun run series-draft "series-slug"
+```
+
+### 导入聊天记录到 Flows
+
+将 `.txt` 或 `.log` 文件放入 `imports/chats/` 后执行：
+
+```bash
+bun run new-flow-from-chat
+```
+
+常用参数：`--all`、`--dry-run`、`--author "Name"`、`--append`、`--timestamp`。  
+导入历史记录位于 `imports/chats/.imported`。
+
+## 配置
+
+所有站点配置集中在 `site.config.ts`。
+
+## 内容写作
+
+- **Posts**：创建到 `content/posts/`
+- **Flows**：创建到 `content/flows/YYYY/MM/DD.mdx`（或文件夹模式）
+- **Series**：创建 `content/series/<slug>/index.mdx`
+- **Books**：创建到 `content/books/<slug>/`
+- **Notes**：创建到 `content/notes/`，支持 `[[wiki-links]]`
+
+## 项目结构
+
+```text
+amytis/
+  content/
+    posts/
+    series/
+    books/
+    notes/
+    flows/
+  public/
+  src/
+    app/
+    components/
+    lib/
+  site.config.ts
+```
+
+## 文档
+
+- [架构说明](docs/ARCHITECTURE.md)
+- [部署指南](docs/deployment.md)
+- [数字花园指南](docs/DIGITAL_GARDEN.md)
+- [贡献指南](docs/CONTRIBUTING.md)
+
+## 许可证
+
+MIT

package/content/about.mdx

@@ -1,24 +1,78 @@
 ---
 title: "About Amytis"
 date: "2026-01-07"
-excerpt: "Learn more about the philosophy and technology behind this digital garden."
+excerpt: "Amytis is an elegant open-source framework for building your personal digital garden — from raw daily flows to refined articles, curated series, and structured books."
 layout: "simple"
 toc: true
 ---
 
-# About the Garden
+# What is Amytis?
 
-Amytis is a digital garden designed for long-term thought cultivation. Unlike a blog, which is a stream of consciousness, a digital garden is a network of evolving ideas.
+**Amytis** is an elegant, open-source framework for building a personal digital garden — a knowledge space where ideas grow and connect over time. Unlike a traditional blog, a digital garden is a living network of writing at various stages of development: rough notes, refined essays, and everything in between.
+
+This site is a live demo. Everything you see — posts, series, books, flow notes, the knowledge graph, and full-text search — is powered by the framework.
+
+**[View the source on GitHub →](https://github.com/hutusi/amytis)**
+
+## The Knowledge Ladder
+
+Amytis is built around a simple observation: knowledge doesn't arrive fully formed. Ideas follow a natural path from rough to refined:
+
+**Flow** — Capture raw thoughts as they happen. Daily notes, fragments, and fleeting observations. The seeds of everything.
+
+**Articles** — Refine a single idea into a clear, shareable essay. One thought, fully articulated.
+
+**Series** — Gather related articles into a curated collection with a shared thread. A broader argument, explored across multiple pieces.
+
+**Books** — Organize mature knowledge into a structured volume with chapters and parts. The most distilled form of an idea.
+
+Each stage builds on the last. The garden grows.
+
+## Features
+
+- **Articles & Series** — Long-form writing organized into curated, numbered collections
+- **Books** — Multi-chapter content with part grouping and chapter navigation
+- **Flow Notes** — Daily notes with calendar sidebar, year/month browsing, and tag filtering
+- **Knowledge Base** — Atomic notes with `[[wikilink]]` support and a backlinks panel
+- **Knowledge Graph** — D3 force graph visualizing connections across all content
+- **Full-text Search** — Powered by Pagefind, with type filters, recent searches, and keyboard navigation
+- **Table of Contents** — Sticky TOC with scroll-aware reading progress
+- **Multi-language (i18n)** — Built-in English and Chinese, easily extendable
+- **Themes** — Four color palettes: Default, Blue, Rose, and Amber
+- **Comments** — Giscus or Disqus integration
+- **Analytics** — Umami, Plausible, or Google Analytics
+- **RSS Feed** — Automatically generated from your content
 
 ## Technology Stack
 
-- **Next.js 15+** for the foundation.
-- **Tailwind CSS v4** for styling.
-- **MDX** for content rich with React components.
-- **Bun** for a lightning-fast development experience.
+- **[Next.js 15+](https://nextjs.org)** — App Router, static export, `generateStaticParams`
+- **[React 19](https://react.dev)** — Server Components, React Compiler-compatible
+- **[Tailwind CSS v4](https://tailwindcss.com)** — CSS variables, theme design tokens
+- **[MDX](https://mdxjs.com)** — Markdown with React components, remark/rehype plugin pipeline
+- **[Bun](https://bun.sh)** — Fast package manager and runtime
+- **[Pagefind](https://pagefind.app)** — Static full-text search, no server required
+- **[D3.js](https://d3js.org)** — Knowledge graph visualization
+- **[KaTeX](https://katex.org)** — LaTeX math rendering
+
+## Design Philosophy
+
+**Elegance by default.** The typography, spacing, and color system are carefully considered. A fresh Amytis install already looks beautiful — because a garden should be a pleasure to walk through.
+
+**Content over configuration.** Drop an MDX file into `content/posts/` and it becomes a post. Series, books, notes, and flows follow the same pattern — no database, no CMS, no build-time magic beyond what Next.js provides natively.
+
+**Markdown-first, but not Markdown-limited.** All content is authored in Markdown or MDX — familiar, portable, writable in any editor. Amytis extends the format with syntax highlighting, LaTeX math, Mermaid diagrams, `[[wikilinks]]`, auto-generated tables of contents, and smart excerpts. The writing surface stays simple; the rendered output becomes rich.
+
+**Ship what you need, nothing more.** Every feature can be disabled in `site.config.ts`. No books section? No knowledge graph? They simply don't render or generate routes.
+
+**Plain text, forever.** All content lives as Markdown or MDX files — version-controlled, portable, and editor-agnostic. Your writing belongs to you.
 
-## The Philosophy
+## Get Started
 
-We believe in **Public Learning**. This space is where I plant seeds (initial notes), tend to them (refine and link), and eventually grow them into evergreen articles.
+```bash
+git clone https://github.com/hutusi/amytis my-garden
+cd my-garden
+bun install
+bun dev
+```
 
-> "A garden is a grand teacher. It teaches patience and careful watchfulness; it teaches industry and thrift; above all it teaches entire trust." — Gertrude Jekyll
+Edit `site.config.ts` to set your title, navigation, and features. Add content to `content/posts/`. Visit the [GitHub repository](https://github.com/hutusi/amytis) for full documentation and configuration reference.

package/content/about.zh.mdx

@@ -1,21 +1,78 @@
 ---
 title: "关于 Amytis"
 date: "2026-01-07"
-excerpt: "了解这座数字花园背后的理念与技术。"
+excerpt: "Amytis 是一个优雅的开源数字花园框架——从每日随笔到精炼文章，从系列合集到结构化书籍，层层深化。"
 layout: "simple"
+toc: true
 ---
 
-Amytis 是一座为长期思想培育而设计的数字花园。与博客不同，数字花园是一个持续演化的想法网络。
+# Amytis 是什么？
+
+**Amytis** 是一个优雅的开源数字花园框架，用于构建个人知识空间。数字花园不同于传统博客——它是一个随时间生长与关联的写作网络，涵盖各个成熟阶段：粗糙的笔记、精炼的文章，以及两者之间的一切。
+
+本站是 Amytis 的在线演示。你所看到的一切——文章、系列、书籍、随笔、知识图谱和全文搜索——均由该框架驱动。
+
+**[在 GitHub 上查看源码 →](https://github.com/hutusi/amytis)**
+
+## 知识的阶梯
+
+Amytis 的核心是一个简单的观察：知识不会凭空成型，而是沿着一条从粗糙到精炼的自然路径演化：
+
+**随笔（Flow）** — 随时记录涌现的想法。每日笔记、碎片、一闪而过的观察。这是一切的种子。
+
+**文章（Articles）** — 将单一想法提炼为清晰、可分享的文章。一个思考，完整呈现。
+
+**系列（Series）** — 将相关文章整理为有共同主线的精选合集。一个更宏观的论题，通过多篇文章共同探索。
+
+**书籍（Books）** — 将成熟的知识组织为结构化的卷册，设有章节与部分。是想法最终蒸馏后的形态。
+
+每一阶段都在上一阶段的基础上生长。花园，就这样繁茂起来。
+
+## 功能特性
+
+- **文章与系列** — 长篇写作，整理为有序的精选合集
+- **书籍** — 多章节内容，支持章节分组与导航
+- **随笔** — 日常笔记，含日历侧边栏、年月浏览和标签筛选
+- **知识库** — 原子笔记，支持 `[[双向链接]]` 和反向链接面板
+- **知识图谱** — 基于 D3 的力导向图，可视化所有内容的连接关系
+- **全文搜索** — 由 Pagefind 驱动，支持类型过滤、最近搜索和键盘导航
+- **目录导航** — 滚动感知的阅读进度指示器
+- **多语言（i18n）** — 内置中英文支持，易于扩展
+- **主题色** — 四种配色方案：默认、蓝色、玫瑰、琥珀
+- **评论系统** — 支持 Giscus 或 Disqus
+- **数据统计** — 支持 Umami、Plausible 或 Google Analytics
+- **RSS 订阅** — 根据内容自动生成
 
 ## 技术栈
 
-- **Next.js 15+** — 基础框架
-- **Tailwind CSS v4** — 样式系统
-- **MDX** — 支持 React 组件的富内容格式
-- **Bun** — 极速开发体验
+- **[Next.js 15+](https://nextjs.org)** — App Router、静态导出、`generateStaticParams`
+- **[React 19](https://react.dev)** — Server Components，兼容 React Compiler
+- **[Tailwind CSS v4](https://tailwindcss.com)** — CSS 变量，主题设计令牌
+- **[MDX](https://mdxjs.com)** — 支持 React 组件的 Markdown，remark/rehype 插件链路
+- **[Bun](https://bun.sh)** — 高速包管理器与运行时
+- **[Pagefind](https://pagefind.app)** — 静态全文搜索，无需服务端
+- **[D3.js](https://d3js.org)** — 知识图谱可视化
+- **[KaTeX](https://katex.org)** — LaTeX 数学公式渲染
+
+## 设计理念
+
+**优雅，开箱即用。** 字体排版、间距和色彩系统经过精心打磨。一个全新的 Amytis 站点天然美观——因为花园本应是令人愉悦的地方。
+
+**内容优先，配置从简。** 将 MDX 文件放入 `content/posts/` 即成为文章。系列、书籍、笔记和随笔遵循同样的模式——无需数据库、无需 CMS、无需超出 Next.js 原生能力的构建魔法。
+
+**Markdown 优先，但不止于 Markdown。** 所有内容以 Markdown 或 MDX 编写——熟悉、可迁移、随处可写。Amytis 在此基础上扩展了语法高亮、LaTeX 数学公式、Mermaid 图表、`[[双向链接]]`，以及自动生成的目录和摘要。写作界面保持简洁，渲染结果却丰富而强大。
+
+**按需取用，不多不少。** 所有功能均可在 `site.config.ts` 中关闭。不需要书籍？不需要知识图谱？它们将不会渲染，也不会生成路由。
+
+**纯文本，永久可用。** 所有内容以 Markdown 或 MDX 文件存储——可版本控制、可迁移、编辑器无关。你的写作属于你。
 
-## 理念
+## 快速开始
 
-我们相信**公开学习**的力量。这里是种下种子（初始笔记）、悉心耕耘（提炼与关联）、最终长成长青文章的地方。
+```bash
+git clone https://github.com/hutusi/amytis my-garden
+cd my-garden
+bun install
+bun dev
+```
 
-> "花园是最好的老师。它教人耐心与细心观察，教人勤劳与节俭，尤其教人全然的信任。" — Gertrude Jekyll
+编辑 `site.config.ts` 设置标题、导航和功能开关，将内容添加到 `content/posts/`。访问 [GitHub 仓库](https://github.com/hutusi/amytis) 获取完整文档和配置说明。