docs: build enhance and cli config

Author: Sunny-117

README.md

@@ -435,6 +435,42 @@ You can use `stub: true` (per entry config) or the `--stub` CLI flag. In this mo
 >
 > Feedback and contributions are very welcome! If you'd like to make changes with more than a few lines of code, please open an issue first to discuss.
 
+## 📚 Documentation
+
+### 🎯 Guides
+- [Getting Started](./docs/guide/getting-started.md) - Get up and running in 5 minutes
+- [CLI Usage](./docs/guide/cli.md) - Complete command-line interface guide
+- [Configuration](./docs/guide/configuration.md) - Detailed configuration reference
+- [Build Modes](./docs/guide/build-modes.md) - Bundle vs Transform modes
+- [Watch Mode](./docs/guide/watch-mode.md) - Real-time development builds
+- [Stub Mode](./docs/guide/stub-mode.md) - Lightning-fast development mode
+- [TypeScript](./docs/guide/typescript.md) - TypeScript best practices
+- [ESM](./docs/guide/esm.md) - ES modules support
+- [Performance](./docs/guide/performance.md) - Build performance optimization
+
+### 🔧 Feature Guides
+- [CLI & Config Enhancements](./docs/guide/cli-config-enhancements.md) - Multi-format output, platform targets, environment variables
+- [Build Enhancements](./docs/guide/build-enhancements.md) - File copying, hashing, banner/footer, extensions
+- [Development Experience](./docs/guide/dev-experience.md) - Success callbacks, watch optimization, Vite integration
+
+### 🏢 Enterprise Features
+- [Enterprise Features](./docs/guide/enterprise.md) - Workspace, filtering, exports, migration
+- [Plugin System](./docs/guide/plugins.md) - Plugin development and usage
+- [Advanced Build Options](./docs/guide/advanced-build.md) - Loaders, shims, CJS handling
+- [Hooks](./docs/guide/hooks.md) - Build lifecycle hooks
+
+### 📖 API Reference
+- [API Overview](./docs/api/index.md) - Programmatic API overview
+- [Configuration API](./docs/api/config.md) - Configuration options
+- [CLI API](./docs/api/cli.md) - Command-line interface
+- [Type Definitions](./docs/api/types.md) - TypeScript type definitions
+
+### 🏗️ Architecture
+- [Core Architecture](./docs/architecture/core.md) - robuild core design
+- [Builders](./docs/architecture/builders.md) - Bundle and Transform builders
+- [Plugin System](./docs/architecture/plugins.md) - Plugin architecture design
+- [Performance](./docs/architecture/performance.md) - Performance optimization strategies
+
 ## Prior Arts
 
 - [unbuild](https://github.com/unjs/unbuild): Stable solution based on rollup and [mkdist](https://github.com/unjs/mkdist).

TODO.md

@@ -8,23 +8,23 @@
 
 ### 🔧 CLI 和配置增强
 
-- [x] **多格式输出支持** - 支持 `esm`, `cjs`, `iife`, `umd` 多种输出格式
-- [x] **全局变量名配置** - 为 IIFE/UMD 格式指定全局变量名 (`globalName`)
-- [x] **平台目标配置** - 支持 `browser`, `node`, `neutral` 平台目标
-- [x] **目标环境配置** - 支持 ES 版本目标如 `es2015`, `esnext` 等
-- [x] **外部依赖配置** - 更灵活的 `external` 和 `noExternal` 配置
-- [x] **别名配置** - 模块路径别名支持 (`alias`)
-- [x] **环境变量注入** - 编译时环境变量定义 (`env`, `define`)
+- [x] **多格式输出支持** - 支持 `esm`, `cjs`, `iife`, `umd` 多种输出格式 ✅ [文档](docs/guide/cli-config-enhancements.md#多格式输出支持)
+- [x] **全局变量名配置** - 为 IIFE/UMD 格式指定全局变量名 (`globalName`) ✅ [文档](docs/guide/cli-config-enhancements.md#全局变量名配置)
+- [x] **平台目标配置** - 支持 `browser`, `node`, `neutral` 平台目标 ✅ [文档](docs/guide/cli-config-enhancements.md#平台目标配置)
+- [x] **目标环境配置** - 支持 ES 版本目标如 `es2015`, `esnext` 等 ✅ [文档](docs/guide/cli-config-enhancements.md#目标环境配置)
+- [x] **外部依赖配置** - 更灵活的 `external` 和 `noExternal` 配置 ✅ [文档](docs/guide/cli-config-enhancements.md#外部依赖配置)
+- [x] **别名配置** - 模块路径别名支持 (`alias`) ✅ [文档](docs/guide/cli-config-enhancements.md#别名配置)
+- [x] **环境变量注入** - 编译时环境变量定义 (`env`, `define`) ✅ [文档](docs/guide/cli-config-enhancements.md#环境变量注入)
 
 ### 🏗️ 构建功能增强
 
-- [x] **清理功能** - 构建前自动清理输出目录 (`clean`)
-- [x] **文件复制** - 静态资源复制功能 (`copy`)
-- [x] **文件哈希** - 输出文件名哈希支持 (`hash`)
-- [x] **固定扩展名** - 强制使用 `.cjs`/`.mjs` 扩展名 (`fixedExtension`)
-- [x] **自定义扩展名** - 灵活的输出文件扩展名配置 (`outExtensions`)
-- [x] **Banner/Footer** - 文件头尾注释添加
-- [x] **Node.js 协议处理** - `node:` 前缀的添加/移除 (`nodeProtocol`)
+- [x] **清理功能** - 构建前自动清理输出目录 (`clean`) ✅ [文档](docs/guide/cli-config-enhancements.md#清理功能)
+- [x] **文件复制** - 静态资源复制功能 (`copy`) ✅ [文档](docs/guide/build-enhancements.md#文件复制功能)
+- [x] **文件哈希** - 输出文件名哈希支持 (`hash`) ✅ [文档](docs/guide/build-enhancements.md#文件哈希支持)
+- [x] **固定扩展名** - 强制使用 `.cjs`/`.mjs` 扩展名 (`fixedExtension`) ✅ [文档](docs/guide/build-enhancements.md#扩展名控制)
+- [x] **自定义扩展名** - 灵活的输出文件扩展名配置 (`outExtensions`) ✅ [文档](docs/guide/build-enhancements.md#扩展名控制)
+- [x] **Banner/Footer** - 文件头尾注释添加 ✅ [文档](docs/guide/build-enhancements.md#bannerfooter-支持)
+- [x] **Node.js 协议处理** - `node:` 前缀的添加/移除 (`nodeProtocol`) ✅ [文档](docs/guide/build-enhancements.md#nodejs-协议处理)
 
 #### 🎯 构建功能增强实现详情
 
@@ -61,32 +61,32 @@
 
 ### 🔄 开发体验
 
-- [x] **成功回调** - 构建成功后执行命令 (`onSuccess`)
+- [x] **成功回调** - 构建成功后执行命令 (`onSuccess`) ✅ [文档](docs/guide/dev-experience.md#成功回调功能)
   - 支持字符串命令和函数回调
   - CLI 支持 `--on-success` 参数
   - 完整的错误处理和测试覆盖
 
-- [x] **忽略监听路径** - 监听模式下忽略特定路径 (`ignoreWatch`)
+- [x] **忽略监听路径** - 监听模式下忽略特定路径 (`ignoreWatch`) ✅ [文档](docs/guide/dev-experience.md#忽略监听路径)
   - 支持 glob 模式匹配
   - 默认忽略常见目录（node_modules, dist, .git 等）
   - CLI 支持 `--ignore-watch` 参数
 
-- [x] **Vite 配置复用** - 从 Vite/Vitest 复用配置 (`fromVite`)
+- [x] **Vite 配置复用** - 从 Vite/Vitest 复用配置 (`fromVite`) ✅ [文档](docs/guide/dev-experience.md#vite-配置复用)
   - 自动检测 Vite 配置文件
   - 转换 Vite 配置到 robuild 格式
   - CLI 支持 `--from-vite` 参数
 
-- [x] **调试模式** - 详细的调试日志输出
+- [x] **调试模式** - 详细的调试日志输出 ✅ [文档](docs/guide/dev-experience.md#调试模式)
   - 通过 `logLevel: 'verbose'` 启用
   - 详细的构建过程日志
   - 功能执行状态跟踪
 
-- [x] **日志级别控制** - 可配置的日志级别 (`logLevel`)
+- [x] **日志级别控制** - 可配置的日志级别 (`logLevel`) ✅ [文档](docs/guide/dev-experience.md#日志级别控制)
   - 支持 silent, error, warn, info, verbose 级别
   - CLI 支持 `--log-level` 参数
   - 全局日志配置和计数功能
 
-- [x] **构建失败处理** - 警告时失败选项 (`failOnWarn`)
+- [x] **构建失败处理** - 警告时失败选项 (`failOnWarn`) ✅ [文档](docs/guide/dev-experience.md#构建失败处理)
   - 可配置警告时构建失败
   - CLI 支持 `--fail-on-warn` 参数
   - 警告和错误计数跟踪