用途：为在 Swift 中使用 Valkey（Redis 的开源分支）提供专家级指导，覆盖 valkey-swift 客户端库的连接、命令与集群用法。
主要能力：支持 async/await；单机与集群连接（按 key 哈希槽自动路由，支持 {hashTag} 使多键落同一分片）；字符串 SET/GET/INCR/DECR、条件 NX/XX 与过期时间；哈希 hset/hget/hgetall；列表 lpush/rpush/lpop/lrange；集合 sadd/sismember/smembers；有序集合 zadd/zrange/zrank；发布订阅与 psubscribe 模式订阅；MULTI/EXEC 事务与多命令流水线；连接配置含密码、库号、超时与 TLS；ValkeyClientError 错误分支处理。
使用方式：在 Package.swift 添加依赖 .package(url: "https://github.com/valkey-io/valkey-swift.git", from: "1.0.0")，import Valkey 后用 ValkeyClient.connect(to:) 连接，再调用相应方法执行命令。
适用场景：Swift 服务端需要接入 Valkey/Redis 做缓存、会话、计数器、队列、排行榜或消息通知时。
限制：资料未提供性能基准、版本兼容矩阵与收费信息；示例中集群地址与密码等为占位值，需替换为实际环境；部分高级主题需参考附带 reference 文件。