docs: add bilingual README and update configs

Author: shijiashuai

README.en.md

@@ -0,0 +1,93 @@
+# CleanBook — Smart Bookmark Cleaning & Classification
+
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://lessup.github.io/bookmarks-cleaner/)
+
+[简体中文](README.md) | English
+
+KISS: Rules + ML + optional LLM, offline-ready by default. Unified title emoji cleanup, powerful deduplication, outputs HTML/Markdown/JSON.
+
+## Features
+
+- Rules first, ML/semantic assist, optional LLM integration (auto-fallback on failure)
+- Unified title cleaning to avoid stacked emoji prefixes
+- Always-on deduplication for stable cross-browser export merging
+- Output classification limited to two levels for cleaner results
+
+## Installation (pipx Recommended)
+
+```powershell
+python -m pip install --user pipx
+python -m pipx ensurepath
+pipx install .
+```
+
+Two commands available after installation:
+
+- `cleanbook`: Command-line processing (equivalent to `python main.py`)
+- `cleanbook-wizard`: Interactive wizard experience
+
+## Quick Example
+
+```powershell
+cleanbook -i examples/demo_bookmarks.html -o output
+cleanbook -i "tests/input/*.html" --train
+cleanbook-wizard
+```
+
+Common flags: `--workers` parallel, `--train` train ML, `--no-ml` disable ML, `--health-check` reachability check.
+
+## LLM (Optional)
+
+Edit `config.json` to enable:
+
+```json
+"llm": {
+  "enable": true,
+  "provider": "openai",
+  "base_url": "https://api.openai.com",
+  "model": "gpt-4o-mini",
+  "api_key_env": "OPENAI_API_KEY"
+}
+```
+
+Set environment variable:
+
+```powershell
+$env:OPENAI_API_KEY = "your_api_key"
+```
+
+Falls back to offline classification when key is unset or API fails.
+
+With `organizer.enable`, a secondary LLM pass clusters, sorts and summarizes categories after classification.
+
+## Project Structure
+
+```
+.
+├─ src/
+│  ├─ cleanbook/            # Unified CLI wrapper
+│  │  └─ cli.py
+│  ├─ ai_classifier.py      # Rules + ML + semantic + user profile + LLM
+│  ├─ enhanced_classifier.py
+│  ├─ enhanced_clean_tidy.py
+│  ├─ bookmark_processor.py
+│  ├─ emoji_cleaner.py       # Title emoji cleaning
+│  └─ ...
+├─ models/                  # Models & cache
+├─ examples/
+├─ docs/
+├─ config.json
+├─ main.py                  # Top-level entry
+├─ pyproject.toml           # Packaging & CLI entry points
+└─ changelog/
+```
+
+## Distribution
+
+- **Local/Team**: `pipx install .` for isolated global commands
+- **Open Source**: GitHub Release with example data; optionally publish to PyPI
+- **Windows standalone**: Optional PyInstaller single-file EXE
+
+## License
+
+MIT — see `LICENSE`.

README.md

@@ -1,7 +1,9 @@
-# CleanBook —— 智能书签清理与分类（中文）
+# CleanBook —— 智能书签清理与分类
 
 [![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://lessup.github.io/bookmarks-cleaner/)
 
+简体中文 | [English](README.en.md)
+
 KISS：规则 + 机器学习 + 可选 LLM，默认离线可用。统一清理标题 emoji，强力去重，输出 HTML/Markdown/JSON。
 
 ## 特性

docs/.vitepress/config.mts

@@ -63,13 +63,18 @@ export default defineConfig({
       },
     ],
 
+    editLink: {
+      pattern: 'https://github.com/LessUp/bookmarks-cleaner/edit/master/docs/:path',
+      text: '在 GitHub 上编辑此页',
+    },
+
     socialLinks: [
       { icon: "github", link: "https://github.com/LessUp/bookmarks-cleaner" },
     ],
 
     footer: {
-      message: "MIT License",
-      copyright: "© 2024-present LessUp",
+      message: "基于 MIT 许可发布",
+      copyright: "Copyright © 2025-2026 LessUp",
     },
 
     outline: {
@@ -86,6 +91,11 @@ export default defineConfig({
       text: "最后更新",
     },
 
+    returnToTopLabel: '返回顶部',
+    sidebarMenuLabel: '菜单',
+    darkModeSwitchLabel: '主题',
+    externalLinkIcon: true,
+
     search: {
       provider: "local",
       options: {

docs/guides/development_guide.md

@@ -30,8 +30,8 @@
 
 ```bash
 # 克隆项目
-git clone <repository-url>
-cd CleanBookmarks
+git clone https://github.com/LessUp/bookmarks-cleaner.git
+cd bookmarks-cleaner
 
 # 创建虚拟环境
 python -m venv venv