docs: upgrade README and adopt LICENSE-only policy

Author: Yifanliu-scut

.gitattributes

@@ -1,71 +1,82 @@
+<div align="center">
+
 # WayToAGI Gesture Control
 
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
-![Framework](https://img.shields.io/badge/backend-Flask%20%2B%20Socket.IO-black)
-![Vision](https://img.shields.io/badge/vision-MediaPipe-green)
-![License](https://img.shields.io/badge/license-MIT-lightgrey)
+Real-time hand-tracking mouse control system for desktop interaction.
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![Flask](https://img.shields.io/badge/backend-Flask%20%2B%20Socket.IO-black.svg)](https://flask.palletsprojects.com/)
+[![MediaPipe](https://img.shields.io/badge/vision-MediaPipe-00A67E.svg)](https://ai.google.dev/edge/mediapipe/solutions/vision/hand_landmarker)
+[![CI](https://img.shields.io/badge/CI-GitHub_Actions-2088FF.svg)](https://github.com/sudo-yf/hackathon2510/actions)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+</div>
+
+## Overview
+
+WayToAGI Gesture Control 是一个面向实时人机交互的手势控制系统：通过摄像头捕获手部关键点，完成光标映射与点击手势识别，并通过 Web UI 提供低延迟可视化与参数调优能力。
+
+## Table of Contents
 
-WayToAGI Hackathon 作品。  
-一个面向实时交互的手势控制系统：摄像头识别手部关键点，后端完成动作映射，前端提供全屏可视化与低延迟控制面板。
+- [Overview](#overview)
+- [Key Features](#key-features)
+- [System Architecture](#system-architecture)
+- [Quick Start](#quick-start)
+- [Docker Deployment](#docker-deployment)
+- [Runtime Configuration](#runtime-configuration)
+- [HTTP API](#http-api)
+- [Project Structure](#project-structure)
+- [Design References](#design-references)
 
-## Highlights
+## Key Features
 
-- Real-time 手势识别（21 landmarks）
-- 鼠标映射算法（中心增稳 + 边缘加速）
-- 动作触发（左键/右键点击）
-- 设置持久化（SQLite）
-- Docker 运行与 `uv` 环境管理
+- 21-point hand landmark tracking (MediaPipe Hands)
+- 非线性光标映射（中心稳态 + 边缘加速）
+- 手势点击触发（左键 / 右键）
+- Socket.IO 实时视频帧与状态推送
+- SQLite 参数持久化（平滑系数、灵敏度、边缘加速）
+- 可在无系统鼠标注入模式下运行（`DISABLE_MOUSE=1`）
 
-## Architecture
+## System Architecture
 
 ```mermaid
 graph LR
-    Cam[Camera Stream] --> Vision[MediaPipe Hands]
-    Vision --> Engine[Gesture Engine]
-    Engine --> Mouse[Mouse Injection]
-    Engine --> WS[Socket.IO]
-    WS --> UI[Web UI]
+    Cam[Camera Input] --> Vision[MediaPipe Hands]
+    Vision --> Gesture[Gesture Engine]
+    Gesture --> Cursor[Cursor Mapping]
+    Gesture --> Click[Gesture Click Detection]
+    Cursor --> Mouse[Mouse Backend]
+    Gesture --> WS[Socket.IO Stream]
+    WS --> UI[Web Dashboard]
     UI --> API[Flask API]
-    API --> Engine
-    API --> DB[(SQLite Settings)]
+    API --> Store[(SQLite Settings)]
 ```
 
-## Project Layout
+## Quick Start
 
-```text
-hackathon2510/
-├── app.py
-├── src/waytoagi_gesture/
-│   ├── config.py
-│   ├── service.py
-│   ├── settings_store.py
-│   ├── web.py
-│   └── static/
-├── tests/
-├── pyproject.toml
-├── Makefile
-├── Dockerfile
-└── RELEASE.md
+### 1. Install Dependencies (uv)
+
+```bash
+uv sync
 ```
 
-## Quick Start
+### 2. Run Service
 
 ```bash
-uv sync
 uv run python app.py
 ```
 
-Open [http://localhost:5000](http://localhost:5000)
+Open: [http://localhost:5000](http://localhost:5000)
 
-## Local Quality Gates
+### 3. Quality Gates
 
 ```bash
 make lint
 make test
 make check
 ```
 
-## Docker
+## Docker Deployment
 
 ```bash
 docker build -t waytoagi-gesture:latest .
@@ -79,29 +90,54 @@ docker run --rm -it \
   waytoagi-gesture:latest
 ```
 
-## Configuration
+## Runtime Configuration
 
-| Key | Default | Description |
+| Env | Default | Description |
 |---|---|---|
 | `HOST` | `0.0.0.0` | 服务监听地址 |
 | `PORT` | `5000` | 服务端口 |
 | `CAMERA_INDEX` | `0` | 摄像头索引 |
-| `FRAME_WIDTH` | `1280` | 视频宽度 |
-| `FRAME_HEIGHT` | `720` | 视频高度 |
-| `FRAME_FPS` | `30` | 视频帧率 |
-| `SETTINGS_DB_PATH` | `data/waytoagi.db` | SQLite 配置库 |
-| `DISABLE_MOUSE` | `0` | 禁用系统鼠标注入 |
+| `FRAME_WIDTH` | `1280` | 采集宽度 |
+| `FRAME_HEIGHT` | `720` | 采集高度 |
+| `FRAME_FPS` | `30` | 采样帧率 |
+| `CORS_ORIGIN` | `*` | 前端跨域来源 |
+| `SETTINGS_DB_PATH` | `data/waytoagi.db` | SQLite 配置存储路径 |
+| `DISABLE_MOUSE` | `0` | 禁用真实鼠标注入（1 为禁用） |
+
+## HTTP API
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/healthz` | 服务与摄像头状态 |
+| `GET` | `/api/settings` | 读取当前控制参数 |
+| `POST` | `/api/settings` | 更新控制参数 |
+| `POST` | `/api/camera/start` | 启动摄像头处理线程 |
+| `POST` | `/api/camera/stop` | 停止摄像头处理线程 |
+| `POST` | `/api/mouse/toggle` | 切换鼠标控制开关 |
+| `POST` | `/api/settings/flip` | 切换镜像翻转 |
 
-## API
+## Project Structure
+
+```text
+hackathon2510/
+├── app.py
+├── src/waytoagi_gesture/
+│   ├── web.py
+│   ├── service.py
+│   ├── config.py
+│   ├── settings_store.py
+│   └── static/
+├── tests/
+├── Dockerfile
+├── Makefile
+├── pyproject.toml
+└── LICENSE
+```
 
-- `GET /healthz`
-- `GET /api/settings`
-- `POST /api/settings`
-- `POST /api/camera/start`
-- `POST /api/camera/stop`
-- `POST /api/mouse/toggle`
-- `POST /api/settings/flip`
+## Design References
 
-## Release Policy
+- [MediaPipe](https://github.com/google-ai-edge/mediapipe)
+- [OpenCV](https://github.com/opencv/opencv)
+- [Flask](https://github.com/pallets/flask)
+- [Flask-SocketIO](https://github.com/miguelgrinberg/Flask-SocketIO)
 
-See [RELEASE.md](RELEASE.md)