fix: 转移一下README.md的重心

Author: longsizhuo

CONTRIBUTING.md

@@ -114,15 +114,15 @@ cd involutionhell.github.io
 ### 2. 安装依赖
 
 ```bash
-npm install
+pnpm install    # 推荐；如需可改用 npm install
 ```
 
 ### 3. 本地开发
 
 运行开发服务器：
 
 ```bash
-npm dev
+pnpm dev
 ```
 
 打开浏览器访问 [http://localhost:3000](http://localhost:3000)。
@@ -131,6 +131,23 @@ npm dev
 
 ---
 
+## 🛠️ 可用脚本
+
+常用脚本集中在 `package.json` 中，以下是最常用的命令：
+
+```bash
+pnpm dev             # 启动开发服务器
+pnpm build           # 构建生产版本
+pnpm start           # 启动生产服务器
+pnpm lint:images     # 检查图片是否符合规范
+pnpm migrate:images  # 自动迁移图片到对应 assets 目录
+pnpm postinstall     # 同步必要的 Husky/Fumadocs 配置
+```
+
+> Windows + VSCode(Cursor) 用户：如遇 Husky 在 VSCode 内置终端阻止提交，请使用外部命令行执行 `git commit`。
+
+---
+
 ## 📚 文档规范
 
 所有文档放在 `docs/` 目录。

README.en.md

@@ -8,147 +8,96 @@
 
 [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/InvolutionHell/involutionhell.github.io)
 
-This is a collaborative documentation platform based on modern web technologies, designed to help students share and access learning materials.
+A collaborative documentation platform built with modern web technologies to help students share study notes, course materials, and project experience.
+
+**Highlights**
+
+- High-performance site powered by Next.js App Router and Fumadocs UI
+- Multi-language support with a "folder as navigation" content model
+- Automated deployment, image migration, and linting to reduce maintenance overhead
 
 ## 🚀 Quick Start
 
-### Prerequisites
+**Prerequisites**
 
 - Node.js 18+
-- pnpm (recommended)
-
-### ❗️If you are using `Windows` + `VSCode(Cursor)`, you may encounter a `Husky` bug. Please use the command line (`git commit`) to commit your code.❗️
+- pnpm recommended (npm / yarn also work)
 
-### Installation
+**Local preview**
 
 ```bash
-# Clone the repository
 git clone https://github.com/involutionhell/involutionhell.github.io.git
 cd involutionhell.github.io
-
-If you don't have pnpm installed yet, you can run:
-
-# Install pnpm globally
-npm install -g pnpm
-
-# Install dependencies
 pnpm install
-
-# Start the development server
 pnpm dev
 ```
 
-Open your browser and visit [http://localhost:3000](http://localhost:3000) to see the site.
+Visit [http://localhost:3000](http://localhost:3000) in your browser.
+
+> On Windows with VSCode(Cursor) you may hit a Husky hook issue. Run `git commit` from a terminal instead.
+
+Looking for additional scripts, debugging tips, or contribution workflows? Check out [CONTRIBUTING.md](CONTRIBUTING.md).
 
-## 📁 Project Structure
+## 📁 Directory Overview
 
 ```
 📦 involutionhell.github.io
-├── 📂 app/                          # Next.js App Router
-│   ├── 📂 components/               # React components
-│   ├── 📂 docs/                     # Document content
-│   │   └── 📂 ai/                   # AI knowledge base
-│   ├── 📄 layout.tsx               # Root layout
-│   └── 📄 page.tsx                 # Home page
-├── 📂 source.config.ts              # Fumadocs configuration
-├── 📂 tailwind.config.ts           # Tailwind CSS configuration
-└── 📄 package.json                 # Dependencies and scripts
+├── 📂 app/              # Next.js App Router
+│   ├── 📂 components/   # UI components
+│   ├── 📂 docs/         # Content (folder-as-a-book)
+│   └── 📄 layout.tsx    # Root layout
+├── 📄 source.config.ts  # Fumadocs configuration
+├── 📄 tailwind.config.ts
+└── 📄 package.json
 ```
 
-## 🤝 Contributing
+Documentation follows a layered "Folder as a Book" structure. Naming rules, required frontmatter, and authoring tips live in the contribution guide.
 
-We welcome community contributions! Before you start, please read our [Contribution Guide](CONTRIBUTING.md).
+## 🤝 Contribute Together
 
-### How to Contribute
+Community contributions are always welcome:
 
-- 📝 **Content**: Add new articles or improve existing ones
-- 🐛 **Bug Fixes**: Report and fix issues
-- 🎨 **UI/UX**: Improve design and user experience
-- 🌐 **Translation**: Help with multi-language support
-- 📖 **Documentation**: Improve project documentation
+- Content & translations
+- Bug fixes and tooling improvements
+- UI / UX design and implementation
+- Documentation and workflow enhancements
 
-### Quick Start for Contributors
+For the full workflow, PR checklist, and UI collaboration guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
-1. Fork this repository
-2. Create a feature branch: `git checkout -b feat/your-feature`
-3. Make your changes
-4. Test your changes: `pnpm check:content`
-5. Submit a PR
+## 🖼️ Documentation & Assets
 
-## 📚 Documentation Structure
+The repo ships with automated image migration and linting. Learn how to place assets, reference images, and structure frontmatter in:
 
-Our content uses a hierarchical "Folder as a Book" structure:
+- [Documentation guidelines & asset rules](CONTRIBUTING.md#-文档规范)
+- [Available scripts & automation](CONTRIBUTING.md#-可用脚本)
 
-```
-📂 docs/
-├── 📂 computer-science/           # Computer Science
-│   ├── 📄 index.mdx               # Computer Science Overview
-│   └── 📂 data-structures/        # Data Structures
-│       ├── 📄 index.mdx           # Data Structures Overview
-│       ├── 📂 array/              # Array
-│       │   ├── 📄 index.mdx       # Array Overview
-│       │   ├── 📄 01-static-array.mdx
-│       │   └── 📄 02-dynamic-array.mdx
-│       └── 📂 linked-list/        # Linked List
-│           ├── 📄 index.mdx       # Linked List Overview
-│           └── 📄 01-singly-linked-list.mdx
-```
+## 🙏 Special Thanks
 
-## 🛠️ Available Scripts
-
-```bash
-# Development
-pnpm dev              # Start the development server
-pnpm build            # Build for production
-pnpm start            # Start the production server
-pnpm postinstall
-pnpm lint:images      # Check if images follow the rules
-pnpm migrate:images   # Migrate images
-```
-
-## Image Management Guidelines (Brief)
-
-An automated script will move the images you reference to the same directory as the MDX file, following these rules:
-
-- **Storage**: In `./<basename>.assets/` in the same directory as the MDX file.
-  - Example: `foo.mdx` → `./foo.assets/<img>.png`; `index.mdx` → `./index.assets/<img>.png`.
-- **Reference**: Relative path `![](./<basename>.assets/<img>.png)`.
-- **Automation**: Automatically migrates and changes references on commit; Image Lint only warns and does not block commits.
-- **Sharing**: Use `/images/site/*` for site-level images, `/images/components/<name>/*` for component demos; images shared by multiple documents can be kept in `/images/...`.
-
-## Special Thanks
-
-### Thanks to Shanghai AI Lab for providing computing power support for this project!
+Thanks to Shanghai AI Lab for providing computing support!
 
 ![](./public/shanghaiailab.png)
 
-- [InternS1 Project Address](https://github.com/InternLM/Intern-S1/tree/main)
-- [InternStudio Computing Power Platform](https://studio.intern-ai.org.cn/console/dashboard)
-- [Puyu API Documentation](https://internlm.intern-ai.org.cn/api/document)
+- [InternS1 Project](https://github.com/InternLM/Intern-S1/tree/main)
+- [InternStudio Platform](https://studio.intern-ai.org.cn/console/dashboard)
+- [Puyu API Docs](https://internlm.intern-ai.org.cn/api/document)
 
-## Star History
+## ⭐️ Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=InvolutionHell/involutionhell.github.io&type=Date)](https://star-history.com/#InvolutionHell/involutionhell.github.io&Date)
 
-## License and Copyright Notice
-
-### About the Project Code
-
-The **code** part of this project (referring to the program code used to build and run this website) is licensed under the MIT License.
+## 📜 License & Copyright
 
-This means you are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the code, but you must include the original copyright notice and license statement in all copies or substantial portions of the software.
+The project code is released under the [MIT License](LICENSE).
 
-For details, see the [LICENSE](LICENSE) file.
+### Codebase
 
-### About Shared Content
+The **code** (i.e., the software powering this site) is licensed under MIT: you may use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software as long as the original copyright notice and permission notice are included. See [LICENSE](LICENSE) for details.
 
-The copyright of **articles, comments, and other forms of content** displayed/collected on this platform belongs to the original authors.
+### Shared Content
 
-**Please note**:
-1. The copyright of the content does **not** follow the MIT license and is still retained by the original author.
-2. Unless otherwise stated or authorized by the original author, **no one may** use this content for commercial purposes, such as reprinting, modification, and other secondary creations.
-3. As a sharing platform, this project cannot verify the originality and legality of all content one by one.
+The copyright of **articles, comments, and other contributed content** remains with the original authors:
 
-#### Copyright Infringement Handling
+1. The content is **not** covered by the MIT License; commercial reuse or derivative works require permission.
+2. We cannot individually verify every submission for originality or legality.
 
-We respect and are committed to protecting intellectual property. If you believe that any content on the platform infringes your legal rights, please contact us immediately by **[submitting an Issue](https://github.com/InvolutionHell/involutionhell.github.io/issues/new)**. We promise to take necessary measures such as deletion and blocking promptly after receiving the notification and verifying the situation.
+If your rights are infringed, please **[open an issue](https://github.com/InvolutionHell/involutionhell.github.io/issues/new)**. We will review and take appropriate action (removal, blocking, etc.) promptly.