重构: 源码文件蛇形命名, 接口去I头(BindRequestContext/SimApiAuthChecker), 清理C#相关说明, serialization依赖路径改 serialization-cj

src/annotations/simapi_sign.cj

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2025 SimcuTeam. All rights reserved.
+ * 遵循 MIT 许可证。
+ * 声明式签名校验注解。
+ *
+ * 标注在控制器方法或类上，请求派发时（SimApiRequestDelegateFactory）自动执行验签：
+ *   - 提取 appId / timestamp / nonce / sign（Query 优先，其次 Header）
+ *   - 通过 keyProvider（DI 解析）获取密钥
+ *   - 过期校验 + nonce 去重（需缓存）
+ *   - 拼接 SignFields + appId + timestamp + nonce + key，MD5 比对
+ *
+ * 用法：
+ *   @SimApiSign                                   // 默认 SimApiSignProviderBase（应用需注册实现）
+ *   @SimApiSign["MySignProvider"]                 // 指定 provider 类型名（DI 注册的实现类）
+ *
+ * 说明：仓颉注解参数须为编译期常量，无法直接持有 Type；
+ * 故 keyProvider 用类型名 String，运行时经 TypeInfo.get 解析后从 DI 取实例。
+ */
+
+package simcu::simapi.annotations
+
+@Annotation[target: [MemberFunction, Type]]
+public class SimApiSign {
+    /// 签名提供器类型名（DI 注册的 SimApiSignProviderBase 实现类名）
+    public let keyProvider: String
+
+    public const init() {
+        this.keyProvider = ""
+    }
+
+    public const init(keyProvider: String) {
+        this.keyProvider = keyProvider
+    }
+}