docs: Update README and CHANGELOG for v1.0.1

- Restore Overview and For AI Agents sections in README
- Add proper project introduction at the beginning
- Update CHANGELOG with v1.0.1 release notes
- Reorganize README structure with better section separation

Author: Demo User

CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.0.1] - 2025-03-11
+
+### Added
+- **NPM Package Support**: Package now available on npm registry
+- **CLI Tool (`pto`)**: Command-line interface for all operations
+- **On-demand Font Download**: Fonts downloaded via `pto download-fonts` instead of bundled
+- **Node.js API**: Full JavaScript/TypeScript API support
+- **GitHub Actions CI/CD**: Automated testing and publishing workflows
+- **TypeScript Definitions**: Complete type definitions in `types/`
+
+### Changed
+- **Package Size**: Reduced from ~76MB to 27.7KB (99.9% reduction)
+- **Font Distribution**: Fonts are no longer bundled, downloaded on-demand
+- **Installation**: Improved post-install checks and user feedback
+- **Documentation**: Updated all README files with npm installation instructions
+
+### Removed
+- Bundled font files from npm package (now downloaded on demand)
+- Example outputs and large asset files from package
+- Deprecated example files (moved to documentation)
+
+### Technical Improvements
+- Added `postinstall.js` for better setup experience
+- Added `download-fonts.js` for font management
+- Improved `.npmignore` to exclude unnecessary files
+- Added `files` field in `package.json` for precise package content control
+
+---
+
 ## [1.0.0] - 2025-03-11
 
 ### Added

README.md

@@ -9,6 +9,28 @@
 
 ---
 
+## Overview
+
+AI-generated images often contain garbled or imperfect text, especially for Chinese, Japanese, Korean (CJK) and other non-Latin scripts. This tool solves this problem by separating image generation and text rendering into two distinct steps:
+
+1. **Generate a clean base image** without text
+2. **Analyze optimal text placement zones**
+3. **Render text** with professional typography and effects
+
+---
+
+## For AI Agents (Natural Language Installation)
+
+Copy and paste this prompt to your LLM agent (Claude Code, Kimi Code, Cursor, etc.):
+
+```
+Install the perfect-text-overlay skill to my workspace. 
+Clone from: https://github.com/stephenlzc/perfect-text-overlay
+Set up all dependencies and verify the installation by running a test with Chinese text extraction.
+```
+
+---
+
 ## Quick Start
 
 ```bash
@@ -25,14 +47,7 @@ pto download-fonts --all
 pto separate "Generate a poster with 'Summer Sale' title"
 ```
 
-## What It Does
-
-AI-generated images often have garbled text, especially for Chinese/Japanese/Korean. This tool fixes that by:
-
-1. **Separate** prompt → image-only prompt + text requirements
-2. **Generate** clean base image (use your AI of choice)
-3. **Analyze** image for best text placement
-4. **Render** perfect text with professional typography
+---
 
 ## Installation
 
@@ -53,6 +68,8 @@ cd perfect-text-overlay
 npm install
 ```
 
+---
+
 ## CLI Usage
 
 ```bash
@@ -73,6 +90,8 @@ pto download-fonts --list
 pto download-fonts --all
 ```
 
+---
+
 ## Node.js API
 
 ```javascript
@@ -93,6 +112,8 @@ async function createPoster() {
 }
 ```
 
+---
+
 ## Font Styles
 
 | Style | Language | Description |
@@ -107,6 +128,8 @@ async function createPoster() {
 
 Download fonts: `pto download-fonts --all`
 
+---
+
 ## Project Structure
 
 ```
@@ -121,12 +144,16 @@ perfect-text-overlay/
 └── types/                  # TypeScript definitions
 ```
 
+---
+
 ## Documentation
 
 - [API Reference](API.md) - Detailed API documentation
 - [Contributing](CONTRIBUTING.md) - Contribution guidelines
 - [CHANGELOG](CHANGELOG.md) - Version history
 
+---
+
 ## License
 
 MIT © [stephenlzc](https://github.com/stephenlzc)