From 129fe72df21b60b46e39535106cbffeb2aa7770f Mon Sep 17 00:00:00 2001
From: pjh456 <147148383@qq.com>
Date: Thu, 17 Sep 2026 16:46:01 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=E5=AD=97=E7=AC=A6?=
 =?UTF-8?q?=E4=B8=B2=E6=AF=94=E8=BE=83=E5=88=86=E6=94=AF=E6=B3=A8=E9=87=8A?=
 =?UTF-8?q?=E7=9A=84=E7=AD=89=E4=BB=B7=E8=A1=A8=E8=BF=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 crates/oxide_runtime_api/src/coercion.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/crates/oxide_runtime_api/src/coercion.rs b/crates/oxide_runtime_api/src/coercion.rs
index c386a9b0..8a286a2d 100644
--- a/crates/oxide_runtime_api/src/coercion.rs
+++ b/crates/oxide_runtime_api/src/coercion.rs
@@ -520,7 +520,7 @@ pub fn relational_compare(lhs: JsValue, rhs: JsValue) -> Option<bool> {
         let l = unsafe { &*lhs.as_string_ptr() };
         let r = unsafe { &*rhs.as_string_ptr() };
         if l.is_flat() && r.is_flat() {
-            // 双 Flat：直接按文本字典序比较（与 rope 的码元字典序结果一致）。
+            // 双 Flat：直接按文本（UTF-8 码点序）字典序比较；任一侧非 Flat 时整体走单元序列比较。
             return Some(l.as_str() < r.as_str());
         }
         // 单元口径：码元字典序即规范序，Flat 编码与 rope 扁平化统一走单元通道。