refactor(docs): 完善README

Author: 苏青安

README.md

@@ -1,18 +1,37 @@
 ### PHP Trade Splitter
 
-一个灵活、可扩展的交易/利润分账组件，提供百分比、固定金额、阶梯与递归分账等内置策略，并支持注册自定义策略。
+<div align="center">
+  <a href="./README.md">English</a>｜<a href="./README.zh-CN.md">简体中文</a>
+  <hr width="50%"/>
+</div>
+
+A **flexible and extensible** trade/profit distribution component.  
+Built-in strategies include **Percentage**, **Fixed Amount**, **Ladder**, and **Recursive**, and you can easily register **custom strategies**.
+
+Perfect for multi-level commissions, e-commerce settlements, platform fees, and agent profit sharing.
+
+**This project has been parsed by Zread. If you need a quick overview of the project, you can click here to view it：[Understand this project](https://zread.ai/zxc7563598/php-trade-splitter)**
 
 ---
 
-## 安装
+## ✨ Features
+
+- 🔧 **Multiple Strategies** – 4 common built-in distribution modes
+- 🧩 **Extensible Design** – easily register your own strategy
+- ⚡ **Simple to Use** – one static method does it all
+- 🧠 **Clean Architecture** – object-oriented with the Strategy pattern
+
+---
+
+## 📦 Installation
 
 ```bash
 composer require hejunjie/trade-splitter
 ```
 
-要求：PHP >= 8.1
+---
 
-## 快速开始
+## 🚀 Quick Start
 
 ```php
 <?php
@@ -21,113 +40,190 @@ require __DIR__ . '/vendor/autoload.php';
 
 use Hejunjie\TradeSplitter\Splitter;
 
-// 百分比分账（比例之和必须为 1.0）
+// Percentage-based split (the sum of all rates must equal 1.0)
 $allocations = Splitter::split(1000, [
-    ['name' => '平台', 'rate' => 0.1],
-    ['name' => '作者', 'rate' => 0.9],
+    ['name' => 'Platform', 'rate' => 0.1],
+    ['name' => 'Author', 'rate' => 0.9],
 ], 'percentage');
 
-// 将结果转换为数组
+// Convert to array and print results
 $result = array_map(fn($a) => $a->toArray(), $allocations);
 print_r($result);
 ```
 
-输出示例：
+Example output:
 
 ```php
 Array
 (
     [0] => Array
         (
-            [name] => 平台
+            [name] => Platform
             [amount] => 100
             [ratio] => 0.1
         )
 
     [1] => Array
         (
-            [name] => 作者
+            [name] => Author
             [amount] => 900
             [ratio] => 0.9
         )
 )
 ```
 
-## 核心概念
+---
+
+## 🧩 Core Concepts
+
+| Concept               | Description                                                                     |
+| --------------------- | ------------------------------------------------------------------------------- |
+| **Splitter**          | The main entry point — selects the strategy and performs the split              |
+| **StrategyInterface** | Contract every strategy must implement:`split(SplitContext $context): array`​   |
+| **SplitContext**      | Contains the split context (`total`and`participants`)                           |
+| **Allocation**        | Represents a split result with`name`,`amount`, and`ratio`; provides`toArray()`​ |
 
-- **Splitter**: 对外统一入口，负责选择策略并执行分账。
-- **StrategyInterface**: 策略接口，所有策略需实现 `split(SplitContext $context): array`。
-- **SplitContext**: 分账上下文，包含 `total` 与 `participants`。
-- **Allocation**: 分账结果对象，包含 `name`、`amount`、`ratio`，并提供 `toArray()` 方法。
+---
 
-## 内置策略
+## 🧮 Built-in Strategies
 
-### 1) 百分比分账 `percentage`
+### Percentage Split `percentage`​
 
-- 参与者参数：`name`, `rate`（0~1），所有 `rate` 之和必须等于 1.0。
-- 示例：
+Distributes amounts by percentage. The sum of all `rate` values must equal `1.0`.
 
 ```php
 $result = Splitter::split(1000, [
-    ['name' => '平台', 'rate' => 0.1],
-    ['name' => '作者', 'rate' => 0.9],
+    ['name' => 'Platform', 'rate' => 0.1],
+    ['name' => 'Author', 'rate' => 0.9],
 ], 'percentage');
+
+echo json_encode(array_map(fn($r) => $r->toArray(), $result), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . PHP_EOL;
+
+// Output:
+// [
+//     {
+//         "name": "Platform",
+//         "amount": 100,
+//         "ratio": 0.1
+//     },
+//     {
+//         "name": "Author",
+//         "amount": 900,
+//         "ratio": 0.9
+//     }
+// ]
 ```
 
-### 2) 固定金额分账 `fixed`
+---
 
-- 参与者参数：`name`, `amount`（固定金额）。所有固定金额之和不得超过 `total`。
-- 示例：
+### Fixed Amount Split `fixed`​
+
+Splits by fixed amounts. The total of all fixed values must not exceed the total amount.
 
 ```php
 $result = Splitter::split(3000, [
-    ['name' => '代理A', 'amount' => 200],
-    ['name' => '代理B', 'amount' => 300],
+    ['name' => 'Agent A', 'amount' => 200],
+    ['name' => 'Agent B', 'amount' => 300],
 ], 'fixed');
+
+echo json_encode(array_map(fn($r) => $r->toArray(), $result), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . PHP_EOL;
+
+// Output:
+// [
+//     {
+//         "name": "Agent A",
+//         "amount": 200,
+//         "ratio": 0.0667
+//     },
+//     {
+//         "name": "Agent B",
+//         "amount": 300,
+//         "ratio": 0.1
+//     }
+// ]
 ```
 
-> 说明：若固定金额总和超出总额，将抛出异常。
+---
 
-### 3) 阶梯分账 `ladder`
+### Ladder Split `ladder`​
 
-- 参与者可设置阶梯规则 `ladders`（按不超过 `max` 的比例分成，`max` 为 null 表示无上限），或直接使用固定 `rate`。
-- 将根据总金额匹配命中区间的 `rate` 进行计算。
-- 示例：
+Applies different percentage rates based on amount tiers.  
+Use `null` for no upper limit.
 
 ```php
 $result = Splitter::split(5000, [
     [
-        'name' => '代理A',
+        'name' => 'Agent A',
         'ladders' => [
             ['max' => 1000, 'rate' => 0.05],
             ['max' => 5000, 'rate' => 0.10],
             ['max' => null, 'rate' => 0.15],
         ],
     ],
     [
-        'name' => '平台',
+        'name' => 'Platform',
         'rate' => 0.05,
     ],
 ], 'ladder');
+
+echo json_encode(array_map(fn($r) => $r->toArray(), $result), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . PHP_EOL;
+
+// Output:
+// [
+//     {
+//         "name": "Agent A",
+//         "amount": 500,
+//         "ratio": 0.1
+//     },
+//     {
+//         "name": "Platform",
+//         "amount": 250,
+//         "ratio": 0.05
+//     }
+// ]
 ```
 
-### 4) 递归分账 `recursive`
+---
+
+### Recursive Split `recursive`​
 
-- 每一层的金额都基于上一层的分润金额计算，随后转换为“净收益”（自己所得减去下级从自己处分走的金额）。
-- 参与者参数：`name`, `rate`（0~1）。
-- 示例：
+Each level’s share is calculated based on the remaining amount from the previous level.  
+Useful for multi-tier agent or channel commission systems.
 
 ```php
 $result = Splitter::split(10000, [
-    ['name' => '一级', 'rate' => 0.2],
-    ['name' => '二级', 'rate' => 0.2],
-    ['name' => '三级', 'rate' => 0.2],
+    ['name' => 'Level 1', 'rate' => 0.2],
+    ['name' => 'Level 2', 'rate' => 0.2],
+    ['name' => 'Level 3', 'rate' => 0.2],
 ], 'recursive');
+
+echo json_encode(array_map(fn($r) => $r->toArray(), $result), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . PHP_EOL;
+
+// Output:
+// [
+//     {
+//         "name": "Level 1",
+//         "amount": 1600,
+//         "ratio": 0.2
+//     },
+//     {
+//         "name": "Level 2",
+//         "amount": 320,
+//         "ratio": 0.2
+//     },
+//     {
+//         "name": "Level 3",
+//         "amount": 80,
+//         "ratio": 0.2
+//     }
+// ]
 ```
 
-## 自定义策略
+---
+
+## 🧠 Custom Strategy
 
-实现 `Hejunjie\TradeSplitter\Contracts\StrategyInterface` 并注册：
+Implement the `Hejunjie\TradeSplitter\Contracts\StrategyInterface` and register it:
 
 ```php
 use Hejunjie\TradeSplitter\Contracts\StrategyInterface;
@@ -139,21 +235,48 @@ class MyStrategy implements StrategyInterface
 {
     public function split(SplitContext $context): array
     {
-        // 自定义分账逻辑
-        return [new Allocation('someone', $context->total, 1.0)];
+        // Custom split logic
+        // total: $context->total
+        // participants: $context->participants
+        return [
+            new Allocation('someone', $context->total, 1.0)
+        ];
     }
 }
 
 Splitter::registerStrategy('my_strategy', MyStrategy::class);
-$result = Splitter::split(123, [['name' => 'someone']], 'my_strategy');
+
+// Usage
+$total = 1000;
+$participants = [];
+$result = Splitter::split($total, $participants, 'my_strategy');
 ```
 
-## 运行示例
+---
+
+## 🧪 Run the Demo
 
-仓库内提供 `tests/demo.php`：
+A demo script is included in the repository:
 
 ```bash
 php tests/demo.php
 ```
 
-示例脚本包含对四种内置策略的演示。
+This script demonstrates all four built-in strategies.
+
+---
+
+## 💡 Motivation
+
+This component was born from my frustration with rigid, hard-coded profit-sharing logic in various projects.  
+I wanted a **clear, pluggable, and reusable** solution that could be integrated into any project — without reinventing the wheel each time.
+
+If you’ve encountered strange or complex split scenarios in your business,  
+feel free to collaborate and help make this tool even more powerful!
+
+---
+
+## 🤝 Contributing
+
+Got ideas, feedback, or found a bug? PRs and Issues are always welcome 🙌  
+If you find this project helpful, please consider giving it a ⭐ Star — that’s the biggest motivation for me to keep improving it!