@hutusi/amytis 1.7.0 → 1.9.0

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,69 @@ 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.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
+- **Digital Garden Foundation**: Introduced **Notes** (`content/notes/`) as atomic, evergreen units of knowledge.
+- **Interconnected Knowledge**:
+  - **Wiki-links**: Native support for `[[Slug]]` and `[[Slug|Display]]` bidirectional linking across all content types.
+  - **Backlinks**: Automated "Linked References" display with context snippets for every note.
+  - **Knowledge Graph**: Interactive, visual network map of the entire digital garden at `/graph`.
+- **Advanced Navigation**:
+  - **'More' Dropdown**: Configurable navbar menu for static child links (Archive, Tags, Links).
+  - **Scroll-aware UI**: Navbar now features scroll-triggered transparency and glassmorphism effects.
+  - **Active Route Tracking**: Visual indicators for currently active navigation paths.
+  - **Mobile Sub-groups**: Grouped navigation links in the mobile drawer for better information hierarchy.
+
+### Changed
+- **Content Experience**: Removed titles from daily Flows for a more immersive, journal-like journal experience.
+- **Layout Evolution**:
+  - Promoted `FlowHubTabs` to a primary page heading for easier navigation between Flows, Notes, and Graph.
+  - Moved note backlinks and breadcrumbs to the left sidebar for a cleaner, more aligned reading view.
+- **Improved Excerpts**: Refined logic to preserve content within inline code blocks during excerpt generation.
+
+### Fixed
+- **Navbar Stability**: Resolved a flash of transparency on initial mount by initializing scroll state correctly.
+- **Visual Distinction**: Added subtle bracket decorations and consistent hover states for wiki-links.
+- **Static Export**: Fixed handling of empty notes and trailing slashes in active state detection.
+
+## [1.7.0] - 2026-02-21
+
+### Added
+- **Subscription Hub**: Dedicated `/subscribe` page with support for RSS, Email/Substack, Telegram, and WeChat.
+- **Social Sharing**: New configurable `ShareBar` for posts and books with support for 10+ platforms (X, Reddit, Telegram, etc.).
+- **Enhanced Tags UX**:
+  - Redesigned tags index with A-Z grouping and popularity badges.
+  - Tabbed filtering for "Posts" vs "Flows" within each tag page.
+  - Sidebar-driven tag navigation with pagination and search.
+- **Improved Archive**: Redesigned chronological archive with year-based navigation, post counts, and series indicators.
+- **Content Expansion**: New multimedia showcase post and deep-dives on i18n routing strategies.
+- **Author Pages**: Added series contribution tracking and per-author book listings.
+
+### Changed
+- **Homepage Refinement**: Dynamic sections with configurable ordering, scrolling thresholds, and item limits via `site.config.ts`.
+- **Navigation Upgrade**: Segmented pill design for the language switcher and improved mobile drawer.
+- **Documentation**: Synchronized and streamlined `GEMINI.md`, `ARCHITECTURE.md`, and `TODO.md` roadmap.
+
+### Fixed
+- **Engineering**: Resolved multiple race conditions in scroll listeners via a new `useScrollY` singleton hook.
+- **Layout Consistency**: Standardized spacing, dividers, and typography across all content layouts.
+- **i18n Logic**: Fixed locale-specific TOC heading extraction and variant file exclusions.
+
 ## [1.6.0] - 2026-02-20
 
 ### Added

package/CLAUDE.md

@@ -26,23 +26,14 @@ bun run build:dev          # Development build (no image optimization, faster)
 bun run clean              # Remove .next, out, public/posts directories
 
 # 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
@@ -171,11 +162,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/GEMINI.md

@@ -67,6 +67,12 @@ bun test
 - **Cover Images**: Support for local paths, external URLs, and dynamic desaturated gradients (`text:Label`).
 - **External Links**: Posts can include a list of curated external resources in frontmatter.
 
+### Digital Garden Features
+- **Notes**: Atomic, evergreen notes for personal knowledge management (`content/notes/`).
+- **Wiki-links**: Bidirectional linking using `[[Slug]]` syntax across all content types.
+- **Backlinks**: Automatic display of "Linked References" with context snippets.
+- **Knowledge Graph**: Interactive visualization of content relationships at `/graph`.
+
 ### Refined UX & Design
 - **Homepage**: Elegant layout with "Curated Series" and "Featured Stories" sections using horizontal scroll triggers.
 - **Navigation**: Command+K fuzzy search, sticky TOC with progress tracking, and Series Catalog sidebars.

package/README.md

@@ -9,10 +9,15 @@
 ## Features
 
 - **Digital Garden Philosophy:** Non-linear navigation through tags, series, authors, books, flows, and chronological archives.
+- **Interconnected Knowledge:**
+  - **Wiki-links:** Bidirectional linking (`[[Slug]]`) between all content types.
+  - **Backlinks:** Automatic "Linked References" display on notes.
+  - **Knowledge Graph:** Interactive visual map of your content connections.
 - **Full-text Search:** Fast, static client-side search across all content (Cmd/Ctrl+K) powered by Pagefind.
 - **Structured Content:**
   - **Series:** Multi-part content organization with manual or automatic ordering.
   - **Books:** Long-form content with explicit chapters, parts, and a dedicated reading interface.
+  - **Notes:** Atomic, evergreen concepts for personal knowledge management.
   - **Flows:** Stream-style daily notes or micro-blogging for quick thoughts.
 - **Rich MDX Content:**
   - GitHub Flavored Markdown (tables, task lists, strikethrough).
@@ -100,8 +105,38 @@ bun run new-from-images ./photos                  # Create post from image folde
 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
+bun run new-note "Concept"                        # Create a new atomic note
+bun run new-flow-from-chat                        # Import all new files in imports/chats/
+bun run sync-book                                 # Sync book chapters with files on disk
+bun run series-draft "series-slug"                # Set all posts in a series to draft
+bun run series-draft "series-slug" --undraft      # Remove draft status from series posts
 ```
 
+### Importing Chat Logs to Flows
+
+Amytis includes a powerful script to convert chat logs (like those from LLMs or messaging apps) into Flow entries.
+
+1. Place your `.txt` or `.log` files in `imports/chats/`.
+2. Ensure the format is:
+   ```
+   Author Name YYYY-MM-DD HH:mm:ss
+   Message content line 1
+   Message content line 2
+   ```
+3. Run the importer:
+   ```bash
+   bun run new-flow-from-chat
+   ```
+
+Options:
+- `--all`: Re-import every file (ignores history).
+- `--dry-run`: Preview changes without writing files.
+- `--author "Name"`: Only include messages from a specific author.
+- `--append`: Append to existing flow files instead of skipping.
+- `--timestamp`: Include timestamps in the rendered blocks.
+
+Import history is tracked in `imports/chats/.imported`.
+
 ## Configuration
 
 All site settings are managed in `site.config.ts`:
@@ -142,6 +177,10 @@ Create a directory in `content/series/` with an `index.mdx`.
 
 Books are for long-form, structured content. Create a directory in `content/books/`.
 
+### Notes
+
+Create evergreen notes in `content/notes/` (e.g., `concept.mdx`). Use `[[wiki-links]]` to connect them.
+
 ## Project Structure
 
 ```
@@ -150,21 +189,26 @@ amytis/
     posts/              # Blog posts
     series/             # Series collections
     books/              # Long-form books
+    notes/              # Digital garden notes
     flows/              # Daily notes (YYYY/MM/DD)
     about.mdx           # Static pages
   public/               # Static assets
   src/
     app/                # Next.js App Router pages
       books/            # Book routes
+      notes/            # Note routes
+      graph/            # Knowledge graph
       flows/            # Flow routes
     components/         # React components
     lib/
       markdown.ts       # Data access layer
+  site.config.ts        # Site configuration
 ```
 
 ## Documentation
 
 - [Architecture Overview](docs/ARCHITECTURE.md)
+- [Digital Garden Guide](docs/DIGITAL_GARDEN.md)
 - [Contributing Guide](docs/CONTRIBUTING.md)
 
 ## License

package/TODO.md

@@ -5,13 +5,25 @@
 - [ ] **Breadcrumbs**: Extend Flow breadcrumbs to standard Posts and Books.
 - [ ] **Dynamic OG**: Generate automated social cards with Satori for every post.
 - [ ] **PWA Support**: Add manifest and service worker for offline reading.
+- [ ] **SEO Boost**: Implement JSON-LD structured data for Articles, Books, and Breadcrumbs.
 
 ## 🌿 Digital Garden Evolution
-- [ ] **Backlinks**: Automatically list "Pages that link here" at the bottom of articles.
-- [ ] **Wiki-links**: Support `[[internal-link]]` syntax for easier cross-referencing.
-- [ ] **Knowledge Graph**: Interactive visual map of all connected notes.
+- [ ] **Knowledge Graph**: 
+  - [ ] Interactive fullscreen mode for the graph.
+  - [ ] Filter graph by tags or content types.
+  - [ ] "Local Graph" view in the sidebar of individual notes.
+- [ ] **Discovery**: 
+  - [ ] "On this day" section for Flows (history from previous years).
+  - [ ] RSS/Atom feeds for specific categories or tags.
+- [ ] **Notes**: Support for un-linked mentions (searching for note titles in plain text).
+
+## 🛠 Tooling & Maintenance
+- [ ] **Link Validator**: Script to check for broken internal wiki-links and external URLs.
+- [ ] **Content Porter**: Tool to import/export notes from Obsidian or Notion.
+- [ ] **Optimization**: Automatically compress and resize co-located images during build.
 
 ## ✅ Completed Highlights
+- [x] **Digital Garden**: Notes, Wiki-links, Backlinks, and interactive Knowledge Graph.
 - [x] **Pagefind Search**: High-performance static full-text indexing with rich UI.
 - [x] **Smart Navigation**: Persistent "Previous" and "Next" article links on all posts.
 - [x] **Multi-format Content**: Native support for **Posts**, **Series**, **Books**, and **Flows**.

package/bun.lock

@@ -7,6 +7,7 @@
       "dependencies": {
         "@giscus/react": "^3.1.0",
         "@tailwindcss/typography": "^0.5.19",
+        "d3": "^7.9.0",
         "github-slugger": "^2.0.0",
         "gray-matter": "^4.0.3",
         "image-size": "^2.0.2",
@@ -30,6 +31,7 @@
       "devDependencies": {
         "@tailwindcss/postcss": "^4.1.18",
         "@types/bun": "^1.3.9",
+        "@types/d3": "^7.4.3",
         "@types/image-size": "^0.8.0",
         "@types/node": "^24.10.13",
         "@types/react": "^19.2.14",
@@ -556,7 +558,7 @@
 
     "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
 
-    "commander": ["commander@8.3.0", "", {}, "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww=="],
+    "commander": ["commander@7.2.0", "", {}, "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw=="],
 
     "concat-map": ["concat-map@0.0.1", "", {}, "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="],
 
@@ -1502,8 +1504,6 @@
 
     "cytoscape-fcose/cose-base": ["cose-base@2.2.0", "", { "dependencies": { "layout-base": "^2.0.0" } }, "sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g=="],
 
-    "d3-dsv/commander": ["commander@7.2.0", "", {}, "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw=="],
-
     "d3-sankey/d3-array": ["d3-array@2.12.1", "", { "dependencies": { "internmap": "^1.0.0" } }, "sha512-B0ErZK/66mHtEsR1TkPEEkwdy+WDesimkM5gpZr5Dsg54BiTA5RXtYW5qTLIAcekaS9xfZrzBLF/OAkB3Qn1YQ=="],
 
     "d3-sankey/d3-shape": ["d3-shape@1.3.7", "", { "dependencies": { "d3-path": "1" } }, "sha512-EUkvKjqPFUAZyOlhY5gzCxCeI0Aep04LwIRpsZ/mLFelJiUfnK56jo5JMDSE7yyP2kLSb6LtF+S5chMk7uqPqw=="],
@@ -1520,6 +1520,8 @@
 
     "is-bun-module/semver": ["semver@7.7.3", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q=="],
 
+    "katex/commander": ["commander@8.3.0", "", {}, "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww=="],
+
     "mdast-util-find-and-replace/escape-string-regexp": ["escape-string-regexp@5.0.0", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],
 
     "micromatch/picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],

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) 获取完整文档和配置说明。

package/content/books/sample-book/index.mdx

@@ -10,13 +10,13 @@ chapters:
   - part: "Part I: Getting Started"
     chapters:
       - title: "Introduction to Digital Gardens"
-        file: "introduction"
+        id: "introduction"
       - title: "Setting Up Your Garden"
-        file: "setup"
+        id: "setup"
   - part: "Part II: Growing Your Garden"
     chapters:
       - title: "Writing and Organizing Content"
-        file: "writing-content"
+        id: "writing-content"
 ---
 
 Welcome to **The Digital Garden Handbook**. This book will guide you through the philosophy, setup, and maintenance of a digital garden — a personal knowledge base that grows organically over time.

package/content/flows/2026/02/05.md

@@ -1,5 +1,4 @@
 ---
-title: "Bun as a Package Manager"
 tags: ["tooling", "bun"]
 ---
 

package/content/flows/2026/02/10.mdx

@@ -1,8 +1,9 @@
 ---
-title: "On Digital Gardens"
 tags: ["writing", "digital-garden"]
 ---
 
 Been thinking about the difference between blogs and digital gardens. Blogs are streams — chronological, finished thoughts published into the void. Gardens are networks — interconnected ideas that grow and evolve over time.
 
 This site tries to bridge both: structured posts for polished essays, and this flow section for raw, daily observations. The garden metaphor resonates because ideas really do need tending.
+
+The [[zettelkasten-method]] is the underlying system that makes a garden actually work — atomic notes linked by meaning rather than filed in folders. And [[digital-garden-philosophy]] explores why publishing half-formed ideas in public is worth the discomfort.

package/content/flows/2026/02/15.md

@@ -1,8 +1,9 @@
 ---
-title: "Tailwind CSS v4 First Impressions"
 tags: ["css", "tailwind"]
 ---
 
 Upgraded the project to Tailwind CSS v4 today. The new CSS-first configuration approach is a breath of fresh air — no more `tailwind.config.js` for most use cases.
 
 The `@theme` directive for defining design tokens directly in CSS feels much more natural. Performance improvements are noticeable too, especially during development with faster HMR.
+
+More detailed notes captured in [[tailwind-v4]] — particularly the breaking changes around dark mode and `@apply`.

package/content/flows/2026/02/18.mdx

@@ -1,5 +1,4 @@
 ---
-title: "Exploring React Server Components"
 tags: ["react", "notes"]
 ---
 
@@ -12,3 +11,5 @@ Spent some time digging into React Server Components today. The mental model shi
 - Data fetching becomes much simpler without `useEffect` chains
 
 The composability of mixing server and client components in the same tree is elegant once you get used to it.
+
+Writing up a fuller note on this: [[react-server-components]].

package/content/flows/2026/02/20.md

@@ -1,5 +1,4 @@
 ---
-title: "Multimedia embeds in markdown"
 tags: ["video", "podcast", "markdown", "web"]
 ---
 

package/content/notes/algorithms-and-data-structures.mdx

@@ -0,0 +1,51 @@
+---
+title: "Algorithms and Data Structures"
+date: "2026-01-28"
+tags: ["algorithms", "computer-science", "fundamentals"]
+aliases: ["algorithms"]
+---
+
+Algorithms and data structures are the grammar of computation. You can write software without thinking about them explicitly, but the moment performance matters — or the problem gets hard — you need this vocabulary.
+
+## Why They Still Matter
+
+Modern abstractions (ORMs, high-level languages, framework magic) can obscure algorithmic complexity. But complexity doesn't disappear — it hides. A seemingly innocent nested loop in an ORM query is still O(n²). Knowing the fundamentals lets you see through the abstractions.
+
+## The Core Data Structures
+
+**Arrays** — contiguous memory, O(1) random access, O(n) insertion. The foundation of almost everything else.
+
+**Linked lists** — O(1) insertion at head, O(n) random access. Useful when you need frequent insertion/deletion and don't need random access.
+
+**Hash maps** — amortized O(1) for insert, lookup, delete. The most-used data structure in practice. Collision resolution strategy matters.
+
+**Trees** — hierarchical structure. Binary search trees give O(log n) operations when balanced. The key insight: balance is not automatic.
+
+**Heaps** — a tree where every parent is ≥ (max-heap) or ≤ (min-heap) its children. The natural implementation of a priority queue.
+
+**Graphs** — the most general structure. Almost every interesting problem is a graph problem in disguise.
+
+## Sorting as a Lens
+
+Sorting algorithms are pedagogically valuable because they expose different algorithmic strategies in a simple domain:
+
+- **Insertion sort** — O(n²) worst case, but excellent on nearly-sorted data
+- **Merge sort** — O(n log n) guaranteed, stable, but O(n) extra space
+- **QuickSort** — O(n log n) average, O(n²) worst case, but cache-friendly and in-place
+- **HeapSort** — O(n log n) guaranteed, O(1) space, but not stable and poor cache behavior
+
+The [[the-art-of-algorithms|QuickSort deep dive]] post covers the implementation and visualization in detail.
+
+## Complexity Intuition
+
+A useful mental model: for n = 1,000,000 operations per second,
+
+| Complexity | n=1000 | n=1,000,000 |
+|-----------|--------|-------------|
+| O(1)      | instant | instant |
+| O(log n)  | ~10 ops | ~20 ops |
+| O(n)      | 1ms     | 1s |
+| O(n log n)| ~10ms   | ~20s |
+| O(n²)     | 1s      | 11.5 days |
+
+This table should be tattooed on the inside of every programmer's eyelids.

package/content/notes/digital-garden-philosophy.mdx

@@ -0,0 +1,36 @@
+---
+title: "Digital Garden Philosophy"
+date: "2026-02-03"
+tags: ["digital-garden", "writing", "knowledge-management"]
+aliases: ["digital-gardens"]
+---
+
+A digital garden is a different way of thinking about a personal website. Unlike a blog — where posts are dated, finished, and pushed into a feed — a garden is a space of growing, evolving ideas.
+
+## The Garden vs. The Stream
+
+The stream metaphor (Twitter, blogs, newsletters) privileges recency. New things rise, old things sink. The garden metaphor privileges *connection*. Notes link to other notes; ideas accrete over time.
+
+Mike Caulfield's 2015 talk "The Garden and the Stream" is the canonical introduction to this distinction. He argues the stream has colonized how we think about the web, and that the garden offers a richer alternative.
+
+## Epistemic States
+
+In a garden, notes can exist at different stages of development:
+
+- **Seedling** — rough, barely-formed idea
+- **Budding** — developing, but incomplete
+- **Evergreen** — mature and stable (but still revisable)
+
+Publishing work-in-progress is uncomfortable at first. But it's honest, and it invites readers to engage with thinking rather than just conclusions.
+
+## This Garden
+
+[[welcome-to-amytis|This site's founding post]] describes the original intent. The notes section implements the garden layer on top of the existing blog structure.
+
+The underlying method is [[zettelkasten-method|Zettelkasten]]: atomic notes, linked by meaning rather than filed by category. The result is a network of ideas that can be navigated in any direction — following curiosity rather than chronology.
+
+## Further Reading
+
+- Mike Caulfield, *The Garden and the Stream: A Technopastoral*
+- Maggie Appleton's digital garden theory essays
+- Andy Matuschak's notes on evergreen note-writing