chore: 清理注释并补充中文文档

Author: yibiner

.github/workflows/ci.yml

@@ -1,124 +1,30 @@
-name: CI/CD Pipeline
+name: CI
 
 on:
   push:
-    branches: [ main, master, develop ]
+    branches: [ main, master ]
   pull_request:
-    branches: [ main, master, develop ]
+    branches: [ main, master ]
 
 jobs:
-  test:
-    name: Test
+  build-and-test:
+    name: Build and Test
     runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        node-version: [18.x, 20.x]
-    
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Setup Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-        
-    - name: Install dependencies
-      run: npm ci
-      
-    - name: Run tests
-      run: npm test
-      
-    - name: Run tests with coverage
-      run: npm test -- --coverage
-      
-    - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v4
-      with:
-        token: ${{ secrets.CODECOV_TOKEN }}
-        file: ./coverage/lcov.info
-        fail_ci_if_error: false
+      - name: Checkout code
+        uses: actions/checkout@v4
 
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-    needs: test
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-        
-    - name: Install dependencies
-      run: npm ci
-      
-    - name: Build project
-      run: npm run build
-      
-    - name: Upload build artifacts
-      uses: actions/upload-artifact@v4
-      with:
-        name: build-files
-        path: build/
-        retention-days: 7
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
 
-  deploy:
-    name: Deploy to GitHub Pages
-    runs-on: ubuntu-latest
-    needs: build
-    if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master'
-    
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Download build artifacts
-      uses: actions/download-artifact@v4
-      with:
-        name: build-files
-        path: build/
-        
-    - name: Setup Pages
-      uses: actions/configure-pages@v4
-      
-    - name: Upload to GitHub Pages
-      uses: actions/upload-pages-artifact@v2
-      with:
-        path: build/
-        
-    - name: Deploy to GitHub Pages
-      id: deployment
-      uses: actions/deploy-pages@v3
+      - name: Install dependencies
+        run: npm ci
 
-  docker:
-    name: Build Docker Image
-    runs-on: ubuntu-latest
-    needs: test
-    
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@v3
-      
-    - name: Build Docker image
-      uses: docker/build-push-action@v5
-      with:
-        context: .
-        push: false
-        tags: protobuf-decoder:latest
-        cache-from: type=gha
-        cache-to: type=gha,mode=max
+      - name: Run tests
+        run: npm test
+
+      - name: Build project
+        run: npm run build

README.md

@@ -1,90 +1,82 @@
-# Protobuf Decoder
+# ProtoDecodeX
 
-[![CircleCI](https://circleci.com/gh/pawitp/protobuf-decoder.svg?style=svg)](https://circleci.com/gh/pawitp/protobuf-decoder)
-[![codecov](https://codecov.io/gh/pawitp/protobuf-decoder/branch/master/graph/badge.svg)](https://codecov.io/gh/pawitp/protobuf-decoder)
-[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)
+[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
 
-Protobuf Decoder is a web application based on React to decode and visualize Protobuf data into prettified table layout.
+ProtoDecodeX is a React-based web app that decodes and visualizes Protobuf data in a readable table view.
 
 > For live version, please visit: https://protobuf-decoder.netlify.app/
 
 ## Getting Started
-
 To start application locally, use `npm` to get the dependencies and start the application.
 
-```
-$ npm install
-$ npm start
+```bash
+npm install
+npm start
 ```
 
-Once the application started, open http://localhost:5173 on web browser.
+Then open `http://localhost:3000`.
 
 ## Supported Input Formats
 
-The decoder supports multiple input formats commonly used in development:
+1. Hexadecimal bytes (with or without spaces)
+2. Base64 string
+3. Java decimal byte array (supports negative values)
+4. Java escaped string (for `ISO_8859_1`/byte dump style)
 
-### 1. Hexadecimal Format
-Traditional hex format with spaces or without spaces.
-```
+## Usage
+
+1. Paste data into the input box
+2. Decoder auto-detects input format
+3. Click `Decode`
+4. Inspect parsed fields in the result table
+
+## Example Data
+
+### 1) Hexadecimal Format
+
+```text
 0a 80 04 0a db 03 1a 2a 9f 2e 2a 2a 2a 2a 97 2e
 ```
 
-### 2. Base64 Format
-Base64 encoded protobuf data.
-```
+### 2) Base64 Format
+
+```text
 CoCAEAq7Aw0aKp8uKioqKlcqni4qgiIK4isqgiInb19YRVpP
 ```
 
-### 3. Java Decimal Array Format
-Comma-separated decimal values (supports negative numbers).
-```
-10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -106, -90, 63, 74, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -88, -101, -84, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57
-```
+### 3) Hex stream (XOR / nested-message scenario)
 
-### 4. Java Escape String Format
-Java string with octal/hex escape sequences.
+```text
+0a 80 04 0a db 03 1a 2a 9f 2e 2a 2a 2a 2a 97 2e 4e 8e 97 96 f0 2e 2a 82 22 e2 2b 98 22 27 6f 5f 58 45 5a 4f 05 68 4f 58 46 43 44 92 22 2b bf 25 2a 2a ba 68 b7 25 2a 2a e2 68 ea 25 aa 34 da 25 99 04 d2 25 99 04 ba 3a 36 b2 3a 0b 8a 3a 0b 82 3a 0b 9f 3a 2a 2a ba 68 97 3a 2a 2a e2 68 ca 3a 99 04 c2 3a 99 04 da 3a 75 d2 3a 2a b2 3b 2b e2 3b 2a fa 3b 2a e7 3c 2a 2a 2a 2a fa 3c 2a cf 3d 6f 1a 02 6a c7 3d 02 d9 bc 97 e0 32 28 0a 2b 82 30 2a ff 31 c1 17 03 6a f2 36 9a 23 ca 36 cb 26 c2 36 29 da 36 aa 34 b7 0a 2a 2a 62 6e 8f 0a 2a 2a 62 6e 87 0a 2a 2a 2a 2a 9f 0a 2a 2a 2a 2a ea 0a 2b e2 0a 8a 2c ff 0f 2a 2a 12 e8 87 0c ad de 45 69 97 0c eb d8 6d 68 ef 0c 2a 2a 2a 2a f2 0c 2b b0 0d 2a 92 07 8a 2c e2 07 2a fa 07 2f f2 07 bb 64 9a 05 2b 90 05 2a ea 05 28 a0 1b 3e 3a 2b 30 3a 68 61 18 1b 70 6f 68 1b 69 6b 1b 1b 1a 18 1b 1a a8 17 3f 20 22 22 ba cf df ed 2c 3a 4e 20 23 22 ba d9 8b e4 2c 3a e2 2b a2 17 2a b8 17 2a 8a 17 2a 82 17 2b 9a 17 2a 92 17 2b ea 17 a8 ea db de 2d e2 17 8a 2c f2 17 2a ca 17 2a c2 17 9d 3b da 17 2b d2 17 2b af 14 2a 2a 2a 2a a7 14 2a 2a 2a 2a ba 14 4e b2 14 2b 8f 14 2c 6a d6 1d 87 14 93 8f 20 15 9f 14 ba ee 19 10 97 14 23 b6 19 17 ef 14 25 76 02 6a e7 14 0c f8 78 14 ff 14 2a 2a 2a 2a f7 14 2a 2a 2a aa cf 14 2a 2a 62 6e ff 61 2a 2a 2a 2a f7 61 2a 2a 2a 2a ca 61 2a da 65 2b aa 7a d6 3b a2 7a 9a 23 ba 7a 9a 23 b2 7a f6 21 8a 7a f6 21 82 7a 2b ca 7a 2a c0 7a 2a d8 7a 2a d0 7a 2a aa 7b 2a 92 77 8a 2c ea 77 2a e2 77 2a 10 02 18 20 20 01 28 01 30 01 38 03 40 fe 01 48 15 50 db 03 70 aa cc 8d 01 78 82 70 80 01 03 88 01 01
 ```
-\2605\006\027}\276\255\270\270\360\373\220\271
-```
-
-## Usage
-
-1. Paste Protobuf data in any supported format
-2. The decoder automatically detects the format and shows it with a colored label
-3. Press **Decode** button to parse the data
-4. View the decoded protobuf structure in a formatted table
-
-## Features
 
-- **Multiple Input Formats**: Support for hex, base64, Java decimal arrays, and Java escape strings
-- **Automatic Format Detection**: No need to specify the format manually
-- **Smart Decode**: Conditional XOR decryption for encrypted protobuf data
-- **Schema-Based Display**: Display decoded data using custom protobuf schemas
-- **Performance Optimized**: Caching and memoization for better performance
-- **Responsive UI**: Modern interface with expand/collapse functionality
-- **File Upload**: Support for uploading binary files directly
+### 4) Multi-message stream
 
-## Example Data
+```text
+0a 2f 0a 08 4a 6f 68 6e 20 44 6f 65 10 01 1a 10 6a 6f 68 6e 40 65 78 61 6d 70 6c 65 2e 63 6f 6d 22 0f 0a 0b 31 31 31 2d 32 32 32 2d 33 33 33 10 01 0a 1e 0a 08 4a 61 6e 65 20 44 6f 65 10 02 1a 10 6a 61 6e 65 40 65 78 61 6d 70 6c 65 2e 63 6f 6d
+```
 
-**Input (Hexadecimal)**
+### 5) Java decimal array
 
-> 0a 2f 0a 08 4a 6f 68 6e 20 44 6f 65 10 01 1a 10 6a 6f 68 6e 40 65 78 61 6d 70 6c 65 2e 63 6f 6d 22 0f 0a 0b 31 31 31 2d 32 32 32 2d 33 33 33 10 01 0a 1e 0a 08 4a 61 6e 65 20 44 6f 65 10 02 1a 10 6a 61 6e 65 40 65 78 61 6d 70 6c 65 2e 63 6f 6d
+```text
+10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -106, -90, 63, 74, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -88, -101, -84, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57, 10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -96, 71, -121, 0, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -61, -41, -85, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57
+```
 
-**Input (Java Decimal Array)**
+### 6) Java escaped string
 
-> 10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -106, -90, 63, 74, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -88, -101, -84, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57
+```text
+\2605\006\027}\276\255\270\270\360\373\220\271
+```
 
-**Output**
+## Features
 
-<img src="https://raw.githubusercontent.com/pugkung/protobuf-decoder/master/screenshot.jpg" alt="screenshot" width="500"/>
+- Multi-format input support
+- Automatic format detection
+- Smart decode (conditional XOR)
+- Schema-based display
+- Expand/collapse table interaction
+- File upload support
 
-## Recent Updates
+## License
 
-- ✅ Added support for Java decimal array format
-- ✅ Added support for Java escape string format  
-- ✅ Automatic format detection with visual indicators
-- ✅ Smart decode feature with conditional XOR decryption
-- ✅ Schema-based display for custom protobuf definitions
-- ✅ Performance optimizations and caching
-- ✅ Improved UI with expand/collapse functionality
-- ✅ Better error handling and user feedback
+MIT

README.zh-CN.md

@@ -0,0 +1,81 @@
+# ProtoDecodeX
+
+[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
+
+ProtoDecodeX 是一个基于 React 的 Web 应用，可将 Protobuf 数据解码并以易读的表格形式展示。
+
+> 在线体验：https://protobuf-decoder.netlify.app/
+
+## 快速开始
+
+```bash
+npm install
+npm start
+```
+
+然后在浏览器中打开 `http://localhost:3000`。
+
+## 支持的输入格式
+
+1. 十六进制字节流（可带空格或不带空格）
+2. Base64 字符串
+3. Java 十进制字节数组（支持负数）
+4. Java 转义字符串（适用于 `ISO_8859_1` / 字节转储场景）
+
+## 使用方式
+
+1. 将数据粘贴到输入框中
+2. 解码器会自动识别输入格式
+3. 点击 `Decode`
+4. 在结果表格中查看解析后的字段
+
+## 示例数据
+
+### 1) 十六进制格式
+
+```text
+0a 80 04 0a db 03 1a 2a 9f 2e 2a 2a 2a 2a 97 2e
+```
+
+### 2) Base64编码格式
+
+```text
+CoCAEAq7Aw0aKp8uKioqKlcqni4qgiIK4isqgiInb19YRVpP
+```
+
+### 2) 十六进制数据流（XOR / 嵌套消息场景）
+
+```text
+0a 80 04 0a db 03 1a 2a 9f 2e 2a 2a 2a 2a 97 2e 4e 8e 97 96 f0 2e 2a 82 22 e2 2b 98 22 27 6f 5f 58 45 5a 4f 05 68 4f 58 46 43 44 92 22 2b bf 25 2a 2a ba 68 b7 25 2a 2a e2 68 ea 25 aa 34 da 25 99 04 d2 25 99 04 ba 3a 36 b2 3a 0b 8a 3a 0b 82 3a 0b 9f 3a 2a 2a ba 68 97 3a 2a 2a e2 68 ca 3a 99 04 c2 3a 99 04 da 3a 75 d2 3a 2a b2 3b 2b e2 3b 2a fa 3b 2a e7 3c 2a 2a 2a 2a fa 3c 2a cf 3d 6f 1a 02 6a c7 3d 02 d9 bc 97 e0 32 28 0a 2b 82 30 2a ff 31 c1 17 03 6a f2 36 9a 23 ca 36 cb 26 c2 36 29 da 36 aa 34 b7 0a 2a 2a 62 6e 8f 0a 2a 2a 62 6e 87 0a 2a 2a 2a 2a 9f 0a 2a 2a 2a 2a ea 0a 2b e2 0a 8a 2c ff 0f 2a 2a 12 e8 87 0c ad de 45 69 97 0c eb d8 6d 68 ef 0c 2a 2a 2a 2a f2 0c 2b b0 0d 2a 92 07 8a 2c e2 07 2a fa 07 2f f2 07 bb 64 9a 05 2b 90 05 2a ea 05 28 a0 1b 3e 3a 2b 30 3a 68 61 18 1b 70 6f 68 1b 69 6b 1b 1b 1a 18 1b 1a a8 17 3f 20 22 22 ba cf df ed 2c 3a 4e 20 23 22 ba d9 8b e4 2c 3a e2 2b a2 17 2a b8 17 2a 8a 17 2a 82 17 2b 9a 17 2a 92 17 2b ea 17 a8 ea db de 2d e2 17 8a 2c f2 17 2a ca 17 2a c2 17 9d 3b da 17 2b d2 17 2b af 14 2a 2a 2a 2a a7 14 2a 2a 2a 2a ba 14 4e b2 14 2b 8f 14 2c 6a d6 1d 87 14 93 8f 20 15 9f 14 ba ee 19 10 97 14 23 b6 19 17 ef 14 25 76 02 6a e7 14 0c f8 78 14 ff 14 2a 2a 2a 2a f7 14 2a 2a 2a aa cf 14 2a 2a 62 6e ff 61 2a 2a 2a 2a f7 61 2a 2a 2a 2a ca 61 2a da 65 2b aa 7a d6 3b a2 7a 9a 23 ba 7a 9a 23 b2 7a f6 21 8a 7a f6 21 82 7a 2b ca 7a 2a c0 7a 2a d8 7a 2a d0 7a 2a aa 7b 2a 92 77 8a 2c ea 77 2a e2 77 2a 10 02 18 20 20 01 28 01 30 01 38 03 40 fe 01 48 15 50 db 03 70 aa cc 8d 01 78 82 70 80 01 03 88 01 01
+```
+
+### 3) 多消息流（Multi-message）
+
+```text
+0a 2f 0a 08 4a 6f 68 6e 20 44 6f 65 10 01 1a 10 6a 6f 68 6e 40 65 78 61 6d 70 6c 65 2e 63 6f 6d 22 0f 0a 0b 31 31 31 2d 32 32 32 2d 33 33 33 10 01 0a 1e 0a 08 4a 61 6e 65 20 44 6f 65 10 02 1a 10 6a 61 6e 65 40 65 78 61 6d 70 6c 65 2e 63 6f 6d
+```
+
+### 4) Java 十进制数组
+
+```text
+10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -106, -90, 63, 74, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -88, -101, -84, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57, 10, 96, 10, 43, 10, 16, 65, 67, 51, 49, 90, 69, 72, 52, 65, 72, 51, 78, 48, 54, 51, 51, 18, 23, 16, 1, 24, 1, 32, 0, 40, 1, 48, 8, 56, -124, 1, 64, -96, 71, -121, 0, 4, -122, -125, -112, 13, 16, 96, 24, 32, 32, 1, 40, 1, 64, -47, 1, 72, 2, 80, 43, 88, 1, 112, -61, -41, -85, 1, 120, -127, -90, 1, -128, 1, 3, -120, 1, 1, -62, 1, 16, 72, 74, 51, 49, 90, 68, 72, 52, 90, 70, 55, 50, 48, 48, 53, 57
+```
+
+### 5) Java 转义字符串
+
+```text
+\2605\006\027}\276\255\270\270\360\373\220\271
+```
+
+## 功能特性
+
+- 支持多种输入格式
+- 自动识别输入格式
+- 智能解码（条件 XOR）
+- 基于 Schema 的展示
+- 表格支持展开/折叠交互
+- 支持文件上传
+
+## 许可证
+
+MIT