Ian Chou's Blog

[Linux Tutorial] Understanding apt update, upgrade, and full-upgrade: Best Practices for Daily Maintenance

Break down the differences between apt and apt-get, explain the risks and timing of upgrade / full-upgrade, and provide daily maintenance workflows for desktops and servers.

Troubleshooting Note: Deploy Hooks Not Working? It's main vs master! (With Complete Migration Guide)

Deploy Hooks not responding? CI/CD not triggering? This article shares my actual debugging experience, explaining how inconsistent main/master branch names cause Workflows to fail, and providing a …

[Practical Note] How to Initialize an Astro Project in an 'Existing Folder'? (Deploy to Cloudflare Pages)

A practical guide on how to use npm create cloudflare to initialize an Astro project in an existing Git project folder, and deploy it to Cloudflare Pages. Covers the usage of the -- flag and tips for …

Return to the Decentralized Spirit of Web 1.0: My 'Federated' Blog Architecture (The Blog Federation)

In the world of software architecture, we often say 'what has been united for a long time must divide, and what has been divided for a long time must unite.' This article explores how to …

Astro EC Site MVP: Monorepo Architecture Documentation (Bun Edition)

Detailed documentation for the Astro EC Site MVP (Edge + AI Hybrid). Explores the Monorepo architecture powered by Turborepo and Bun 1.3+, featuring a tech stack of Astro, Cloudflare Workers, Vercel, …

Astro EC Site MVP (Edge + AI Hybrid) Product Requirements Document (PRD)

A product requirements document (PRD) for an Astro-based e-commerce MVP that combines Cloudflare's edge network with Vercel AI SDK to build an Edge + AI hybrid inventory intelligence architecture.

Whitepaper: 2025 E-commerce Technology Revolution – From SEO to GEO, Building a Modern Lightning-Fast Store Powered by Cloudflare and Vercel

A 2025 technical whitepaper for Taiwanese small and medium-sized e-commerce businesses, covering SEO, GEO, and Headless Commerce architecture, with an in-depth comparison of Astro / Nuxt / Remix on …

The Cross-Border Inventory Nightmare: Syncing US Stock Across eBay, Amazon, and Newegg (From ERPs to Python Scripts)

How cross-border sellers can sync US warehouse inventory across eBay, Amazon, and Newegg using ERPs, Google Sheets + automation (n8n vs Make), and Python scripts, with a focus on costs and …

The Cross-Border E-commerce Playbook: Scaling from Marketplaces to a Global Brand (A Technical Guide)

A technical roadmap for cross-border sellers to evolve from marketplaces to a global DTC brand, including tech stack choices and a PayPal-to-Stripe payment strategy.

2025 Best MPA Frameworks for Cloudflare: Who is the True King of the Edge?

A comprehensive ranking of MPA frameworks for Cloudflare in 2025, comparing Astro, Hugo, Next.js, Eleventy, SvelteKit, and Nuxt 3.

Why Do I Need MDX? From Static Documents to Interactive Applications

A deep dive into the real purpose of MDX: when Markdown meets React components. This article itself is the best demonstration of MDX.

Cursor vs. Windsurf: I Was Wrong, Their 'Souls' Are Completely Different

Cursor is the engineer's hands; Windsurf is the creator's brain. Sharing my dual-wielding workflow and the core differences discovered after switching between LangChain development and MDX writing.

Building Human-friendly RAG: Benchmarking Six Major LLMs on Structured Knowledge Extraction

Benchmarking Claude, ChatGPT, Qwen, Doubao, Grok, and Gemini on Human-friendly RAG mental models and accuracy using a Logseq knowledge base, with a three-step implementation guide.

The Evolution of AI Agents: It's Not a Software Upgrade, It's a Leap in Species

A comprehensive look at AI agent evolution: Agents 1.0 (Shallow Loops), 1.5 (Strong Models), 2.0 (Deep Agents & Flow Engineering), and the emerging Agents 3.0 (Digital to Physical Embodiment). The …

The Evolution of AI Agents: Why Isn't Your Assistant Smart Enough Yet? From 1.0 to 3.0

Why can't AI actually 'do' things yet? Using a real-world example of planning a family trip to Kyoto, this article explains the evolution from the chaotic Agents 1.0 to the capable Agents 2.0, and the …

How to Pick a Tree for Qigong

This article shares the differences in Qi field and energy sensation when practicing Qigong in sunlight versus under shade. From the perspective of circulation, expelling stale Qi, and replenishing …

The Evolution of AI Agents: From 1.0 to 3.0, and Why I Don't Believe in Omnipotent AGI