更新 cast 模块版本至 v1.2.1 及 API 指南 (by AI)

README.md

@@ -6,7 +6,7 @@
 
 | 项目 | 版本 | 核心能力 | 依赖 | 详细技术手册 |
 | :--- | :--- | :--- | :--- | :--- |
-| **go/cast** | v1.1.1 | 基础类型强转; 泛型工具; 序列化 | - | [./cast/README.md](https://apigo.cc/go/cast) |
+| **go/cast** | v1.2.1 | 语义化强转; 泛型工具; 智能序列化; time.Time 支持 | - | [./cast/README.md](https://apigo.cc/go/cast) |
 | **go/convert** | v1.0.4 | 深度数据映射; 智能类型穿透 | cast | [./convert/README.md](https://apigo.cc/go/convert) |
 | **go/time** | v1.0.4 | 时间解析; DSL 加减计算; 归一化时区 | cast | [./time/README.md](https://apigo.cc/go/time) |
 | **go/rand** | v1.0.4 | 高并发随机; 闭区间生成; 洗牌 | - | [./rand/README.md](https://apigo.cc/go/rand) |
@@ -27,15 +27,17 @@
 
 ## API 指南
 
-### cast (类型转换与泛型工具)
+### cast (语义化类型转换与泛型工具)
-- **意图**: 处理类型不确定数据，提供零错误处理、静默失败的转换机制。内置高性能 FastEncoder/FastDecoder 消除 JSON 序列化摩擦。
+- **意图**: 彻底消除类型摩擦。核心 API (`To[T]`, `ToJSON` 等) 永不返回错误，遇错静默返回零值。提供 `As` 用于包装传统双返回函数。原生支持 `time.Time` 及其自定义格式映射。
 - **API**:
-  - **基础转换**: Int, Int64, Uint, Uint64, Float, Float64, String, Bool, Duration
+  - **核心语义**: To[T], As
-  - **批量转换**: Ints, Strings
+  - **容器转换**: ToMap, ToSlice, FillMap, FillSlice
+  - **序列化与构建**: ToJSON, ToJSONBytes, FromJSON, UnmarshalJSON, ToJSONDesensitizeBytes, PrettyToJSON
   - **泛型工具**: If, In, Ptr, ArrayToBoolMap
-  - **序列化**: ToJSON/MustToJSON, ToJSONDesensitize, ToJSONDesensitizeBytes, ToJSONBytes/MustToJSONBytes, UnmarshalJSON/MustUnmarshalJSON, UnmarshalJSONBytes/MustUnmarshalJSONBytes, ToYAML/MustToYAML, YAMLBytes/MustYAMLBytes, UnmarshalYAML/MustUnmarshalYAML, UnmarshalYAMLBytes/MustUnmarshalYAMLBytes
+  - **基础转换**: Int, Int64, Uint, Uint64, Float, Float64, String, Bool, Duration
   - **辅助工具**: Split, SplitArgs, UniqueAppend, JoinArgs, RealValue, GetLowerName, GetUpperName, FixUpperCase
 
+
 ### redis (高性能 Redis 客户端)
 - **意图**: 极简、安全的 Redis 交互层。自动处理连接池、序列化与重试，集成高性能分布式 ID 与发布订阅。
 - **API**: