# CyberGo > CyberGo — 高性能 Go 开源库文档 / High-Performance Go Open Source Libraries CyberGo 是一组高性能、生产就绪的 Go 开源库。本索引遵循 llms.txt 标准，供 LLM 一次性摄取。 完整正文见 /llms-full.txt。 ## JSON - [JSON 处理库 - CyberGo JSON | 高性能 Go 库](https://www.cybergo.dev/zh/json/): CyberGo JSON 是高性能、线程安全的 Go JSON 处理库，支持 JSONPath 路径查询、流式处理、泛型 API、Schema 验证与钩子扩展，内置输入校验、危险模式检测与智能缓存，100% 兼容 encoding/json，可无缝替换标准库。 - [缓存与预解析 - CyberGo JSON | 缓存策略](https://www.cybergo.dev/zh/json/advanced/caching): CyberGo JSON 内置缓存机制与预解析策略：EnableCache 自动缓存查询结果、GetStats 监控命中率、WarmupCache 预热、PreParse 一次解析多次查询、CacheSharedResults 零拷贝与 ClearCache 清理，附高频查询配方与选型决策。 - [并发与并行处理 - CyberGo JSON | 实战指南](https://www.cybergo.dev/zh/json/advanced/concurrency): CyberGo JSON 并发与并行处理：Processor 线程安全保证、ParallelIterator 并行迭代器、StreamJSONLParallel 并行 JSONL、SetGlobalProcessor 全局共享与 MaxConcurrency 并发限制，附并发处理大型数据集配方。 - [错误处理 - CyberGo JSON | 最佳实践](https://www.cybergo.dev/zh/json/advanced/error-handling): CyberGo JSON 错误处理：JsonsError 类型判断、errors.Is/As 匹配、SafeError 安全输出与 RedactedPath 脱敏日志，配合哨兵错误分类、Op/Path 定位失败点、默认值兜底与重试降级策略，构建健壮异常机制。 - [性能优化 - CyberGo JSON | 高性能指南](https://www.cybergo.dev/zh/json/advanced/performance): CyberGo JSON 性能优化：EnableCache/CacheTTL 缓存、ParallelThreshold 并行、PreParse 预解析与 WarmupCache 预热，配合 CompilePath 预编译路径、对象池复用与基准测试，提升高频 JSON 处理性能。 - [API 参考 - CyberGo JSON | 完整函数文档](https://www.cybergo.dev/zh/json/api-reference/): CyberGo JSON API 参考：GetString/GetInt 路径查询、Set/Delete 修改、Marshal/Unmarshal 序列化、Processor 处理器与 Schema 验证，涵盖包级函数与实例方法两种风格，100% 兼容标准库。 - [Config 配置 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/config): CyberGo JSON Config 配置：DefaultConfig 默认、SecurityConfig 安全、PrettyConfig 格式化与缓存、大小限制，涵盖编码选项、JSONL 参数、Validate 自动修正与 MergeMode 合并策略，自定义 Go 应用 JSON 行为。 - [常量与错误 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/constants): CyberGo JSON 常量与错误：DefaultMaxJSONSize、DefaultMaxNestingDepth 限制、ErrPathNotFound 错误变量与 MergeMode 合并模式，含 JsonsError 结构、触发场景速查与常量默认值对照，支撑 Go 配置。 - [包函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/): CyberGo JSON 包级函数：Get/GetString/GetInt 路径查询、Set/Delete/MergeJSON 修改、Marshal/Unmarshal 编解码与 ParseJSONL/ProcessBatch 批量处理。 - [批量操作函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/batch): CyberGo JSON 批量操作函数：ProcessBatch 一次性处理多个 JSON 操作，配合 BatchOperation 描述结构与 BatchResult 结果结构，支持 get/set/delete/validate 四类操作且单条失败不中断批次。 - [删除函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/delete): CyberGo JSON 删除函数：Delete 按路径删除、DeleteClean 删除后自动清理空值与空数组并级联移除空父节点，支持通配符、切片、多字段与 JSON Pointer 路径表达式，批量路径缺失静默跳过，不可变返回新字符串，保留链式调用能力。 - [文件操作函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/file-io): CyberGo JSON 文件操作函数：LoadFromFile/SaveToFile 读写、LoadFromReader/SaveToWriter 流式 I/O 与 MarshalToFile/UnmarshalFromFile 序列化。 - [包级迭代函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/iterate): CyberGo JSON 包级迭代函数：Foreach、ForeachWithPath、ForeachNested 递归、ForeachWithError 错误处理与 IterableValue 数据访问，含 ForeachFile 文件迭代。 - [JSONL 处理函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/jsonl): CyberGo JSON JSONL 处理函数：ParseJSONL/ToJSONL/ToJSONLString 转换、StreamJSONL/ForeachJSONL 流式处理、StreamLinesInto[T] 泛型流与 NewJSONLWriter 写入器。 - [修改函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/modify): CyberGo JSON 修改函数：Set/SetMultiple 设置、MergeJSON/MergeMany 合并，支持自动路径创建、原子操作与联合、交集、差集三种 MergeMode 策略，数组路径支持索引替换与追加，修改返回新字符串不改动原输入。 - [编码输出函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/output): CyberGo JSON 编码输出函数：Marshal/Unmarshal 序列化、Compact/Indent/HTMLEscape 格式化与 Encode/EncodePretty/Prettify 配置化编码，兼有 EncodeFields 字段过滤与流式编解码，100% 兼容标准库。 - [解析与验证函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/parse): CyberGo JSON 解析与验证函数：Parse/ParseAny 解析、Valid/ValidWithConfig 校验与 ValidateSchema 的 JSON Schema 验证，解析前执行大小、嵌套深度与危险模式安全校验，覆盖完整处理链路。 - [查询与获取函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/functions/query): CyberGo JSON 查询与获取函数：Get/GetString/GetInt 类型安全获取、GetTyped[T] 泛型、GetMultiple 批量与 SafeGet 安全访问，支持 JSONPath 通配符、切片、默认值回退与 GetWithContext 超时取消。 - [泛型操作 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/generics): CyberGo JSON 泛型 API：GetTyped[T] 泛型获取、Result[T] 结果类型、AccessResult 动态访问，利用 Go 1.18+ 泛型实现编译时类型安全检查，支持基本类型与自定义结构体、默认值回退及单元素数组自动解包。 - [工具函数 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/helpers): CyberGo JSON 辅助函数：CompareJSON 忽略键序与数字精度差异、ClearCache/GetStats 缓存管理、GetHealthStatus 健康监控、全局处理器管理与 SafeError/RedactedPath 安全辅助，简化 Go 日常 JSON 操作。 - [接口定义 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/interfaces): CyberGo JSON 扩展接口：CustomEncoder、TypeEncoder、Validator、Hook、PathParser 与 DangerousPattern，含 HookContext 上下文与预定义钩子，灵活扩展编码、验证与安全防护能力。 - [迭代器与 IterableValue - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/iterator): CyberGo JSON 迭代器类型：Iterator 顺序遍历、IterableValue 数据访问、StreamIterator/StreamObjectIterator 流式、BatchIterator 批量与 ParallelIterator 并行迭代器构造与方法。 - [Processor 处理器 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/): CyberGo JSON Processor 处理器：New 创建、GetString/Set/Delete 操作、Foreach 迭代、Encode 编码与 Close 生命周期，内置缓存加速重复操作，支持链式调用与全局处理器管理，适合高频复用场景。 - [Processor 批量操作 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/batch): CyberGo JSON Processor 批量操作：ProcessBatch 一次调用处理 get/set/delete/validate 多类操作、BatchOperation 与 BatchResult 类型，按 Config 定制批次并适合复用实例的批量处理。 - [Processor 删除方法 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/delete): CyberGo JSON Processor 删除方法：Delete 按路径删除、DeleteClean 删除后自动清理空值与空数组并级联移除空父节点，支持通配符、切片与多字段路径，缺失目标静默跳过，不可变返回新字符串，出错时返回原输入，保留链式调用能力。 - [Processor 文件操作方法 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/file-io): CyberGo JSON Processor 文件方法：LoadFromFile/LoadFromReader 加载、SaveToFile/MarshalToFile 保存、UnmarshalFromFile 读取、SaveToWriter 写入流。 - [Processor 迭代方法 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/iterate): CyberGo JSON Processor 迭代方法：Foreach、ForeachWithPath、ForeachNested 迭代、IterableValue 数据访问与 IteratorControl 控制流，支持 ForeachReturn 修改式迭代与批量迭代实践。 - [Processor JSONL 方法 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/jsonl): CyberGo JSON Processor JSONL 方法：StreamJSONL 流式逐行、StreamJSONLParallel 并行、ForeachJSONL 迭代、MapJSONL 映射、ReduceJSONL 归约与 FilterJSONL 过滤，适合流式数据处理。 - [Processor 生命周期 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/lifecycle): CyberGo JSON Processor 生命周期：New 创建、Close 幂等释放资源并排空在途操作、IsClosed 状态检查、GetStats 统计与 GetHealthStatus 健康监控，配合 ClearCache 与 WarmupCache 缓存管理，保障并发安全关闭。 - [Processor 数据修改 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/modify): CyberGo JSON Processor 修改方法：Set 设置、SetMultiple 批量、SetCreate 自动创建路径、SetMultipleCreate 批量创建，不可变返回新字符串，配合 SetFromParsed 预解析连续修改，所有方法支持链式调用。 - [Processor 编码输出 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/output): CyberGo JSON Processor 输出方法：Encode、EncodePretty、EncodeWithConfig、EncodeBatch/EncodeFields 批量与 Compact/Indent/HTMLEscape 格式化。 - [Processor 解析与验证 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/parse): CyberGo JSON Processor 解析方法：Valid 验证并返回失败原因、ValidBytes 快速判定、Parse 解析、ParseAny 任意类型、PreParse 预解析优化与 GetFromParsed 快速查询，支持配置化解析。 - [Processor 路径查询 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/processor/query): CyberGo JSON Processor 路径查询：Get/GetString/GetInt 类型获取、GetMultiple 批量、SafeGet 返回 AccessResult 与 GetTyped[T] 泛型，支持 JSONPath。 - [Schema 校验 - CyberGo JSON | JSON Schema 验证指南](https://www.cybergo.dev/zh/json/api-reference/schema): CyberGo JSON Schema 校验：ValidateSchema 用法、Schema 约束字段、Format 格式校验、ValidationError 错误处理与 NewSchemaWithConfig 创建方式，覆盖对象、字符串、数值与数组约束。 - [类型定义 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/api-reference/types): CyberGo JSON 核心类型：Result[T] 泛型、AccessResult 访问、BatchOperation、BatchResult、Schema、Stats 与 IterableValue，兼有 CompiledPath 预编译路径，构成完整类型系统。 - [使用示例 - CyberGo JSON | 实战代码示例](https://www.cybergo.dev/zh/json/examples/): CyberGo JSON 实战示例：路径查询与修改、结构体 Marshal/Unmarshal、泛型 API、Processor 复用与缓存预热、迭代遍历与并行处理、JSONL 流式处理、Hook 钩子、Schema 验证与错误处理，含可运行 Go 代码。 - [API 响应解析 - CyberGo JSON | 分页与结构体反序列化](https://www.cybergo.dev/zh/json/examples/api-response): CyberGo JSON 解析 HTTP API 响应：ParseAny 解析任意值、GetString/GetInt 提取状态与分页元信息、Get/GetArray 提取嵌套数据、路径切片处理分页数组、GetTyped 反序列化到结构体，并以 ForeachWithPath 逐元素遍历条目。 - [配置文件处理 - CyberGo JSON | 加载、修改与合并](https://www.cybergo.dev/zh/json/examples/config-files): CyberGo JSON 配置文件实战：LoadFromFile 加载、GetString/GetInt 读取嵌套值、Set/SetCreate 修改、SaveToFile 搭配 PrettyConfig 格式化保存、MergeJSON 合并默认与用户配置并重载验证。 - [JSONL 数据管道 - CyberGo JSON | 流式处理与批量转换](https://www.cybergo.dev/zh/json/examples/data-pipeline): CyberGo JSON 构建 JSONL 数据管道：StreamLinesInto 流式读取并转换、ToJSONL/ToJSONLString 批量格式转换、NDJSONProcessor 与 ForeachFile 处理大文件，实现字段富化与批量转换。 - [高级功能示例 - CyberGo JSON | 进阶用法](https://www.cybergo.dev/zh/json/examples/examples-advanced): CyberGo JSON 高级示例：EncodeBatch 批量编码、EncodeFields 字段选择过滤敏感信息、PreParse 预解析、SafeGet 安全获取与 WarmupCache 缓存预热，并涵盖钩子与高级配置的完整可运行示例，提升性能。 - [CustomEncoder - CyberGo JSON | 自定义编码器](https://www.cybergo.dev/zh/json/extensions/custom-encoder): CyberGo JSON 自定义编码器：CustomEncoder 接口与 TypeEncoder 类型编码器的定义与实现，实践 json.Marshaler 与 TextMarshaler 接口及 CustomEscapes 转义映射，为 Go 类型注册 JSON 序列化逻辑。 - [Hook 钩子系统 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/extensions/hooks): CyberGo JSON Hook 钩子系统：Hook 接口、LoggingHook、TimingHook、ValidationHook、ErrorHook 与自定义钩子，经 Before/After 与 HookContext 上下文在 JSON 操作前后插入自定义逻辑。 - [快速开始 - CyberGo JSON | 5 分钟上手指南](https://www.cybergo.dev/zh/json/getting-started/): CyberGo JSON 快速入门：安装配置、路径查询 GetString/GetInt、Set/Delete 修改、Marshal/Unmarshal 编解码、迭代遍历与错误判别，附常见第一小时问题解答，5 分钟上手 Go JSON 处理。 - [速查表 - CyberGo JSON | API 快速参考](https://www.cybergo.dev/zh/json/getting-started/cheatsheet): CyberGo JSON API 速查表：47 个包级函数全覆盖——路径查询、Set/Delete 修改、批量操作、序列化与格式化、文件读写、验证、迭代流式 JSONL、缓存安全扩展，附读文件改字段写回等高频组合模式与 Processor 用法，一页快速查阅。 - [从标准库迁移 - CyberGo JSON | encoding/json 兼容指南](https://www.cybergo.dev/zh/json/getting-started/migration): 从标准库 encoding/json 迁移到 CyberGo JSON：三步完成、只改 import 即可编译，Marshal/Encoder/Decoder 方法与错误类型兼容清单逐项核对，附默认安全校验行为差异表、迁移 FAQ 与增量能力使用指南。 - [路径表达式语法 - CyberGo JSON | JSONPath 查询指南](https://www.cybergo.dev/zh/json/getting-started/path-syntax): CyberGo JSON 路径表达式语法完整指南：属性访问、数组索引与负索引、切片步长、通配符收集、多字段与扁平化提取、追加与 JSON Pointer（RFC 6901），每个语法配输入输出对照，并汇总负索引越界、提取静默未命中等语法陷阱。 - [格式化输出 - CyberGo JSON | 打印与美化 JSON 指南](https://www.cybergo.dev/zh/json/getting-started/print): CyberGo JSON 格式化输出指南：Prettify、EncodePretty、MarshalIndent、Compact/CompactString、Indent 与 HTMLEscape 选型对比及可运行示例，覆盖自定义缩进、已有文本压缩与流式输出，含 Print 系列迁移说明。 - [Processor 入门 - CyberGo JSON | 何时使用处理器](https://www.cybergo.dev/zh/json/getting-started/processor-guide): CyberGo JSON Processor 入门：包函数与 Processor 选型对比、PreParse 预解析与 CompilePath 路径预编译、多 goroutine 共享、生命周期管理、监控统计与全局处理器配置，掌握高性能 JSON 处理。 - [安全概述 - CyberGo JSON | 安全最佳实践](https://www.cybergo.dev/zh/json/security/): CyberGo JSON 安全最佳实践：输入验证、MaxNestingDepthSecurity/MaxMemory 资源限制防御深嵌套与超大输入、路径遍历与 JSON 注入防御、敏感数据过滤，可用 SecurityConfig 预设一键收紧不可信输入全部限制。 - [生产检查清单 - CyberGo JSON | 安全部署](https://www.cybergo.dev/zh/json/security/production-checklist): CyberGo JSON 生产部署安全清单：SecurityConfig 配置、MaxNestingDepthSecurity/MaxJSONSize 资源限制、输入验证、错误处理、监控告警与性能安全平衡，附默认值与建议生产值对照表，确保生产环境可靠运行。 - [安全模式 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/security/security-mode): CyberGo JSON 安全 API：安全配置、AddDangerousPattern 注册自定义危险模式、PatternLevel 三级严重度与内置危险模式，配合输入验证防御 JSON 注入、原型污染与 XSS 等威胁，命中即拒绝且匹配大小写不敏感。 - [JSONL 处理器 - CyberGo JSON | API 参考](https://www.cybergo.dev/zh/json/streaming/jsonl): CyberGo JSON JSONL 处理器：StreamJSONL 流式处理、JSONLWriter 写入、StreamLinesInto[T] 泛型流、ParseJSONL 解析与 ToJSONL 转换，支持 JSON Lines 读写。 - [大文件处理 - CyberGo JSON | 指南](https://www.cybergo.dev/zh/json/streaming/large-files): CyberGo JSON 大文件处理：ForeachFile、ForeachFileChunked、ForeachFileWithPath 与 ForeachFileNested 流式方法，配合 NDJSONProcessor 与 StreamIterator 控制内存，适用日志分析与 ETL。 ## JWT - [JWT 认证库 - CyberGo JWT | 生产级令牌签发与验证](https://www.cybergo.dev/zh/jwt/): CyberGo JWT 是面向 Go 的生产级 JWT 认证库，覆盖 HMAC、RSA、RSA-PSS、ECDSA 四类 12 种签名算法，提供令牌生成、验证、刷新、吊销、黑名单与速率限制，所有方法并发安全。 - [API 参考 - CyberGo JWT | 完整接口文档](https://www.cybergo.dev/zh/jwt/api-reference/): CyberGo JWT API 参考总览：导航至包级工厂函数、Processor 核心方法、Config 与 BlacklistConfig 配置、Claims 与 RegisteredClaims 声明、扩展接口、辅助类型与 19 个哨兵错误。 - [Claims - CyberGo JWT | 内置声明结构](https://www.cybergo.dev/zh/jwt/api-reference/claims): Claims 是 CyberGo JWT 内置声明结构，含 UserID、Username、Role、权限、作用域等业务字段与 RFC 7519 RegisteredClaims，附带字段长度、数组大小与注入模式验证约束。 - [Config - CyberGo JWT | 统一配置说明](https://www.cybergo.dev/zh/jwt/api-reference/config): Config 是 CyberGo JWT 统一配置：签名密钥与算法、访问与刷新令牌 TTL、签发者、期望受众、时钟偏移、黑名单与速率限制等全部字段、默认值、自动填充规则与 Validate 校验逻辑。 - [错误参考 - CyberGo JWT | 哨兵错误清单](https://www.cybergo.dev/zh/jwt/api-reference/errors): 错误参考：CyberGo JWT 定义 19 个哨兵错误，覆盖配置校验、令牌验证、签名算法、过期、签发者与受众、黑名单、速率限制与生命周期场景，全部支持 errors.Is 匹配。 - [包函数 - CyberGo JWT | 工厂函数与默认值](https://www.cybergo.dev/zh/jwt/api-reference/functions): 包级函数参考：New 创建并校验 Processor、DefaultConfig 与 DefaultBlacklistConfig 返回默认配置、NewNumericDate 构造时间戳、NewRateLimiter 创建令牌桶限流器，含完整签名与默认值。 - [接口定义 - CyberGo JWT | 核心扩展接口](https://www.cybergo.dev/zh/jwt/api-reference/interfaces): 接口定义参考：TokenManager 令牌操作核心接口、CustomClaims 自定义声明、BlacklistStore 黑名单后端、RateLimitProvider 限流器、ClockProvider 时钟注入与可选 RateLimitKeyer 限流键。 - [Processor - CyberGo JWT | 核心令牌操作类型](https://www.cybergo.dev/zh/jwt/api-reference/processor): Processor 是 CyberGo JWT 核心类型：提供 Create、Validate、Refresh、Revoke、IsRevoked、ParseUnverified、Close 等全部令牌操作方法的签名、参数、返回值、错误与示例说明。 - [类型与常量 - CyberGo JWT | 序列化与时钟类型](https://www.cybergo.dev/zh/jwt/api-reference/types): 类型与常量参考：NumericDate 与 StringOrSlice 序列化类型、SigningMethod 算法类型、ValidationError 字段级错误、RateLimiter、SystemClock 与 FixedClock 时钟及 12 种算法常量。 - [高级示例 - CyberGo JWT | 非对称签名与自定义存储](https://www.cybergo.dev/zh/jwt/examples/advanced): 高级示例集：RSA、RSA-PSS 与 ECDSA 非对称签名、密钥分离跨服务验证、PEM 密钥加载、CustomClaims 自定义声明、Redis 黑名单后端、FixedClock 时钟注入及未验证令牌解析。 - [基础示例 - CyberGo JWT | HMAC 签发与吊销](https://www.cybergo.dev/zh/jwt/examples/basic): 基础示例集：用 HMAC 对称密钥签发并验证访问令牌、配合刷新令牌轮换获取新令牌、通过内置黑名单吊销令牌阻止已注销会话、配置令牌桶速率限制防暴力滥用，所有示例完整可独立编译运行。 - [Web 服务器集成 - CyberGo JWT | 认证中间件与 RBAC](https://www.cybergo.dev/zh/jwt/examples/web-server): 生产级 JWT Web 服务器集成示例：认证流程、Bearer 中间件、RBAC 角色控制、刷新令牌轮换、登出吊销与优雅关闭，覆盖完整 HTTP 服务生命周期。 - [快速开始 - CyberGo JWT | 5 分钟入门指南](https://www.cybergo.dev/zh/jwt/getting-started/): CyberGo JWT 快速开始指南：安装库并创建 Processor，完成访问令牌与刷新令牌的签发、验证、刷新和吊销，涵盖核心用法与进阶功能导航。 - [核心概念 - CyberGo JWT | 架构与令牌模型](https://www.cybergo.dev/zh/jwt/getting-started/concepts): CyberGo JWT 核心概念：Processor 中心类型与令牌生命周期、双层令牌模型、Claims 声明结构与 CustomClaims 接口、Config 配置概览及 TokenManager、BlacklistStore 等扩展接口。 - [令牌黑名单 - CyberGo JWT | 吊销与外部存储](https://www.cybergo.dev/zh/jwt/guides/blacklist): 令牌黑名单指南：讲解内置内存存储配置与过期清理机制，用 Revoke 与 IsRevoked 吊销令牌，并实现 BlacklistStore 接口对接 Redis 等外部存储，附带多实例部署最佳实践。 - [配置详解 - CyberGo JWT | 配置字段与安全加固](https://www.cybergo.dev/zh/jwt/guides/configuration): 配置详解指南：讲解 Config 全部字段含签发者受众校验、时钟偏移容忍、强制过期、TTL 设计，以及内置输入校验的长度限制、注入模式检测与 ValidationError 错误处理。 - [自定义 Claims - CyberGo JWT | 业务声明接口](https://www.cybergo.dev/zh/jwt/guides/custom-claims): 自定义 Claims 指南：实现 CustomClaims 接口定义业务专属声明字段，对比内置 Claims 与自定义类型的验证差异，演示 ValidateInto 与 RefreshInto 解析刷新用法。 - [错误处理 - CyberGo JWT | 哨兵错误匹配](https://www.cybergo.dev/zh/jwt/guides/error-handling): 错误处理指南：分类讲解 CyberGo JWT 全部 19 个哨兵错误在配置、令牌验证、限流与生命周期阶段的触发条件，演示 errors.Is 匹配、ValidationError 字段错误与标准化响应实践。 - [速率限制 - CyberGo JWT | 令牌桶限流](https://www.cybergo.dev/zh/jwt/guides/rate-limiting): 速率限制指南：基于令牌桶配置签发接口每窗口最大请求数，讲解限流键的 Subject、UserID 与 RateLimitKeyer 优先级查找，支持内置与自定义分布式限流实现。 - [签名算法 - CyberGo JWT | 算法对比与选型](https://www.cybergo.dev/zh/jwt/guides/signing-algorithms): 签名算法指南：对比 HMAC、RSA、RSA-PSS 与 ECDSA 四类 12 种算法的密钥类型、生成方式、签名验证性能、签名长度与架构耦合度，给出选型决策与密钥管理安全实践。 - [测试与时钟注入 - CyberGo JWT | 固定时钟可重复测试](https://www.cybergo.dev/zh/jwt/guides/testing): 测试与时钟注入指南：通过 ClockProvider 注入 FixedClock 固定时钟，在单元测试中精确控制时间流逝，验证令牌过期、刷新、自定义 Claims 解析与吊销逻辑，确保可重复独立执行。 - [令牌刷新与轮换 - CyberGo JWT | 访问与刷新令牌策略](https://www.cybergo.dev/zh/jwt/guides/token-refresh): 令牌刷新与轮换指南：讲解访问令牌与刷新令牌的双层 TTL 设计、CreateRefresh 签发与 Refresh 轮换流程、自定义 Claims 的 RefreshInto 用法、重用与一次性轮换策略对比及 Refresh 不自动吊销的安全语义。 ## HTTPC - [HTTP 客户端 - CyberGo HTTPC | 安全高性能客户端](https://www.cybergo.dev/zh/httpc/): CyberGo HTTPC 是 Go 语言安全高性能 HTTP 客户端库，提供 TLS 1.2+ 强制加密、SSRF 防护、智能指数退避重试、洋葱模型中间件链、连接池管理与 Result 生命周期自动管理，适用于微服务通信与高并发 API 调用场景。 - [API 参考 - CyberGo HTTPC | API 总索引](https://www.cybergo.dev/zh/httpc/api-reference/): HTTPC API 参考总索引：按核心函数、请求选项、Result、Config 配置、Handler 中间件、Mutator 变更器、类型、错误与常量九组给出完整 API 地图，覆盖 28 个 WithXxx 选项、5 个配置预设、7 个内置中间件与 12 个错误变量，并附快速上手示例。 - [配置 - CyberGo HTTPC | Config 与预设](https://www.cybergo.dev/zh/httpc/api-reference/client-config/config): HTTPC 配置系统 API 参考：Config 及 Timeouts、Connection、Security、Retry、Middleware 子配置全字段说明，DefaultConfig 等五种预设、ValidateConfig 校验范围与代理轮换自动提升重试等派生规则。 - [域名客户端 - CyberGo HTTPC | NewDomain 与会话](https://www.cybergo.dev/zh/httpc/api-reference/client-config/domain-client): HTTPC 域名客户端 API 参考：NewDomain 创建函数、七种 HTTP 方法与 Request 通用方法、URL 自动拼接规则、DomainClienter 接口的 SetHeader/SetCookie 会话管理与 Close 生命周期。 - [文件下载 - CyberGo HTTPC | Download 与校验](https://www.cybergo.dev/zh/httpc/api-reference/client-config/download): HTTPC 文件下载 API 参考：Download 统一下载入口函数、DownloadConfig 配置结构体、DownloadProgressCallback 进度回调、DownloadResult 结果类型、SHA-256 校验和验证与 UNC 路径防护等六层安全保护。 - [中间件 - CyberGo HTTPC | 七大内置中间件](https://www.cybergo.dev/zh/httpc/api-reference/client-config/middleware): HTTPC 中间件系统 API 参考：Chain 洋葱模型组合、七个内置中间件（Recovery/Logging/Timeout/Metrics/Audit 等）、各中间件配置结构体与 Default 构造函数、AuditEvent 审计事件结构。 - [会话管理 - CyberGo HTTPC | SessionManager](https://www.cybergo.dev/zh/httpc/api-reference/client-config/session): HTTPC SessionManager API 参考：NewSessionManager 创建、SessionConfig 配置、SetHeader 头管理、SetCookie 方法与 SetCookieSecurity 验证的完整用法。 - [包级函数与客户端方法 - CyberGo HTTPC | HTTP 方法 API](https://www.cybergo.dev/zh/httpc/api-reference/core/functions): HTTPC 包级函数与客户端方法 API 参考：Get/Post 等七种 HTTP 方法、New 客户端创建、Download 统一下载入口、FormatBytes/FormatSpeed 工具与 NewDomain 域名客户端创建，配合请求选项实现灵活配置。 - [请求选项 - CyberGo HTTPC | WithXxx 选项](https://www.cybergo.dev/zh/httpc/api-reference/core/options): HTTPC 请求选项 API 参考：完整覆盖 28 个 WithXxx 函数——WithHeader 请求头、WithBearerToken 认证、WithJSON/WithForm/WithFile 请求体、Cookie 校验与回调，并注明各选项覆盖的 Config 默认值与校验规则。 - [Result - CyberGo HTTPC | Result 响应类型](https://www.cybergo.dev/zh/httpc/api-reference/core/result): HTTPC Result 响应类型 API 参考：StatusCode/Body 等全部 17 个 nil 安全方法、状态判断、Cookie 操作、Unmarshal 解析、SaveToFile 保存与 RequestInfo/ResponseInfo/RequestMeta 子类型（含 ProxyURL 代理字段）。 - [Handler 管线与自定义中间件 - CyberGo HTTPC | 请求处理管线](https://www.cybergo.dev/zh/httpc/api-reference/handler/handler-chain): HTTPC Handler 管线架构详解：双层设计中 Layer 1 方法 API 如何组装 MiddlewareFunc 洋葱链并执行 Handler，Chain 组合器原理、clientImpl.middlewareChain 实现机制与自定义中间件编写示例。 - [请求与响应变更器 - CyberGo HTTPC | Mutator 接口](https://www.cybergo.dev/zh/httpc/api-reference/handler/mutators): HTTPC 中间件读写契约详解：RequestMutator 与 ResponseMutator 两个公开组合接口的请求与响应全部读写方法，WithOnRequest/WithOnResponse 回调选项用法，附经变更器改写请求头与读取响应状态码的可编译示例。 - [常量与类型 - CyberGo HTTPC | 常量与辅助类型](https://www.cybergo.dev/zh/httpc/api-reference/types/constants): HTTPC 常量与辅助类型 API 参考：BodyKind 六种请求体枚举及自动检测规则、ProxyStrategy 代理策略、FormData 与 FileData 文件上传类型、AuditEvent 审计事件结构体、AuditConfig 审计配置与 SourceIPKey 等上下文键定义。 - [错误类型 - CyberGo HTTPC | ClientError 详解](https://www.cybergo.dev/zh/httpc/api-reference/types/errors): HTTPC 错误类型 API 参考：ClientError 结构体八字段及 Code、IsRetryable、Unwrap 等方法、ErrorTypeNetwork 等十二种错误分类枚举、ErrNilConfig 等哨兵错误变量与 errors.Is/As 匹配示例。 - [接口定义 - CyberGo HTTPC | 核心接口](https://www.cybergo.dev/zh/httpc/api-reference/types/interfaces): HTTPC 核心接口 API 参考：Client 全功能接口、Doer 最小执行接口、DomainClienter 域名客户端、RetryPolicy 重试策略与 RequestMutator/ResponseMutator 中间件接口定义。 - [高级示例 - CyberGo HTTPC | 生产级代码](https://www.cybergo.dev/zh/httpc/examples/advanced-usage): HTTPC 高级示例集：自定义 RetryPolicy 重试策略、超时与重试组合、请求响应回调、完整中间件链、RESTful 客户端封装、域名客户端自定义配置、Cookie 与 SessionManager 会话、worker pool 并发模式与 HMAC 请求签名中间件。 - [基础用法 - CyberGo HTTPC | 可运行示例](https://www.cybergo.dev/zh/httpc/examples/basic-usage): HTTPC 基础用法示例集：GET/POST/PUT/DELETE/HEAD/PATCH 全方法示例、XML 与二进制请求体、查询参数与认证、响应状态判定与 Result 三元组、DefaultConfig 自定义配置、代理、中间件与带进度回调的文件下载完整可运行代码。 - [常见问题 - CyberGo HTTPC | 疑问与解答](https://www.cybergo.dev/zh/httpc/faq/): HTTPC 常见问题解答：包级函数与客户端实例的选择依据、五种配置预设对比与适用场景、HTTP/SOCKS5 代理与 DoH 设置、Cookie 会话管理与重试配置、errors.Is/As 错误匹配模式与五级超时体系调优策略的详细解答与建议。 - [快速开始 - CyberGo HTTPC | 5 分钟上手](https://www.cybergo.dev/zh/httpc/getting-started/): HTTPC 快速开始指南：go get 安装与项目初始化、GET/POST 请求发送与响应处理、五种配置预设选型、JSON 解析与类型绑定、Bearer Token 认证与 ClientError 错误分类处理，五分钟上手安全 HTTP 客户端库。 - [速查表 - CyberGo HTTPC | 常用代码速查](https://www.cybergo.dev/zh/httpc/getting-started/cheatsheet): HTTPC 速查表：客户端创建与五种配置预设、Get/Post 等七种请求方法、28 个常用 WithXxx 请求选项、Result 响应处理、中间件链组合、ClientError 错误分类、文件下载与域名客户端操作的完整可复用代码片段，方便开发者快速查阅。 - [核心概念 - CyberGo HTTPC | 双层架构与配置体系](https://www.cybergo.dev/zh/httpc/getting-started/concepts): HTTPC 核心概念详解：双层 API 架构与核心构件职责表（Client、Result、Session、中间件、Mutator）、Config 配置与 With* 请求选项分层、请求生命周期流程图、域名会话客户端与 ClientError 错误模型，帮助开发者建立整体认知。 - [连接池与 DNS - CyberGo HTTPC | 连接池调优与 DNS 解析](https://www.cybergo.dev/zh/httpc/guides/connection-pool): HTTPC 连接池与 DNS 指南：MaxIdleConns 与 MaxConnsPerHost 调优、空闲连接与总连接上限、TIME_WAIT 治理、对象池复用、并发请求模式、DoH 加密解析降级回退与 HTTP/2 多路复用实践，附高并发场景推荐参数。 - [域名客户端与会话 - CyberGo HTTPC | 会话与域名管理](https://www.cybergo.dev/zh/httpc/guides/domain-session): HTTPC 域名客户端与会话管理指南：NewDomain 与 NewDomainDefault 创建域名作用域客户端、URL 拼接规则与路径穿越防护、SetHeader 会话头、Cookie 自动捕获与选项自动持久化、CookieSecurity 验证、并发语义与 REST 客户端封装实战。 - [错误处理 - CyberGo HTTPC | 分类与哨兵匹配](https://www.cybergo.dev/zh/httpc/guides/error-handling): HTTPC 错误处理指南：ErrorType 十二种错误分类与错误分类决策树、ClientError 字段与 IsRetryable 细粒度判定、平台 syscall 可重试映射、哨兵错误匹配、panic 恢复与中间件统一错误处理、超时分层最佳实践。 - [文件上传与下载 - CyberGo HTTPC | 上传与下载](https://www.cybergo.dev/zh/httpc/guides/file-transfer): HTTPC 文件上传与下载指南：WithFile 与 WithFormData 多文件上传、Download 流式下载、进度回调、断点续传 ResumeDownload、SHA-256 校验和验证、文件冲突与清理语义及 UNC 路径等多层安全防护。 - [中间件链 - CyberGo HTTPC | 洋葱模型与链组合](https://www.cybergo.dev/zh/httpc/guides/middleware-chain): HTTPC 中间件链指南：洋葱模型与完整执行顺序语义、请求/响应双向处理、与请求选项及重试的关系、Recovery/Logging 等七个内置中间件、Chain 组合、自定义 MiddlewareFunc 与断路器短路示例，构建可观测请求管道。 - [从 net/http 迁移 - CyberGo HTTPC | 迁移指南](https://www.cybergo.dev/zh/httpc/guides/migration): 从 net/http 平滑迁移到 CyberGo HTTPC：完整 API 对照表（http.Get、http.Client、Transport、CookieJar 到 httpc 对应项）、错误模型差异、五级超时体系与迁移陷阱清单，帮助已有标准库经验的开发者快速切换。 - [性能优化 - CyberGo HTTPC | 预设与并发](https://www.cybergo.dev/zh/httpc/guides/performance): HTTPC 性能优化指南：Default/Secure/Performance/Testing/Minimal 五种预设对比与场景选型、连接池空闲连接自动推导规则、并发模型与信号量限流完整示例、超时预算分层建议、零分配热路径、对象池与 resultBundle 机制及性能反模式分析。 - [代理与代理池 - CyberGo HTTPC | 代理配置与轮换熔断](https://www.cybergo.dev/zh/httpc/guides/proxy): HTTPC 代理与代理池完整指南：HTTP/HTTPS/SOCKS5 单代理配置、系统代理自动检测与 NO_PROXY 绕过规则、代理池轮询与随机策略、连接失败熔断与冷却恢复、ProxyRotateOnStatus 按状态码换 IP、每请求轮换与重试预算自动提升详解。 - [重定向 - CyberGo HTTPC | 跟随控制与安全白名单](https://www.cybergo.dev/zh/httpc/guides/redirects): HTTPC 重定向指南：默认自动跟随与 10 次上限、WithFollowRedirects 与 WithMaxRedirects 请求级控制、RedirectChain 链路追踪、301/302/303/307/308 方法语义、跨域凭据自动剥离与 RedirectWhitelist 域名白名单防开放重定向。 - [请求与响应 - CyberGo HTTPC | 请求选项与响应](https://www.cybergo.dev/zh/httpc/guides/request-response): HTTPC 请求与响应完整指南：包级函数与客户端方法、WithJSON/WithForm/WithBody 请求体、WithQuery 查询参数、Cookie 与认证选项、Result 解析（Unmarshal、SaveToFile、String）、上下文控制、流式上传与响应自动解压及大小限制配置。 - [重试与容错 - CyberGo HTTPC | 退避与自动重试](https://www.cybergo.dev/zh/httpc/guides/retry-fault-tolerance): HTTPC 重试与容错指南：指数退避与 ±10% 抖动算法详解、408/429/5xx 与网络错误重试条件、Retry-After 自动解析与 60 秒安全上限、跨重试共享总超时预算、请求体重放缓冲、WithMaxRetries 按请求控制与代理池轮换联动。 - [测试指南 - CyberGo HTTPC | httptest 与断言](https://www.cybergo.dev/zh/httpc/guides/testing): HTTPC 测试指南：TestingConfig 测试专用配置、net/http/httptest 模拟服务器集成、Doer 接口 Mock 注入、模拟错误响应/延迟/重定向场景、确定性重试与文件下载测试、表格驱动测试与 Cookie 会话断言最佳实践。 - [实战教程 - CyberGo HTTPC | GitHub API 实战](https://www.cybergo.dev/zh/httpc/guides/tutorial): 三十分钟实战教程：以 GitHub API 为场景从零构建完整 HTTP 客户端，覆盖包级函数与默认客户端、Client 实例与配置预设、WithQuery/WithJSON 请求选项、NewDomain 域名客户端、中间件链、ClientError 错误分类、文件下载与并发请求实战。 - [安全概述 - CyberGo HTTPC | 安全特性总览](https://www.cybergo.dev/zh/httpc/security/): HTTPC 安全特性总览：纵深防御分层地图、默认开启与需手动开启的安全行为对照表、SSRF 私有 IP 阻止与 CIDR 豁免、TLS 版本与密码套件控制、证书锁定、CRLF 注入防护、Cookie 安全验证、解压炸弹防护、URL 凭据脱敏与安全警告机制。 - [生产检查清单 - CyberGo HTTPC | 上线前核查](https://www.cybergo.dev/zh/httpc/security/production-checklist): HTTPC 生产环境安全检查清单：TLS 版本与证书固定、SSRF 豁免审计、五级超时预算、连接池上限、重试风暴控制、大小限制、Cookie 安全、文件下载、Body 关闭与临时文件清理、敏感信息日志脱敏，每项含默认值、推荐生产值与代码验证方法。 - [SSRF 防护 - CyberGo HTTPC | 私有 IP 与元数据](https://www.cybergo.dev/zh/httpc/security/ssrf): HTTPC SSRF 防护详解：默认阻止 IPv4/IPv6 私有 IP 与云元数据端点、SSRFExemptCIDRs 精确豁免、AllowPrivateIPs 危险对比、DNS 重绑定防护、WithAllowPrivateIPs 请求级覆盖与 RedirectWhitelist 重定向白名单。 - [TLS 与证书固定 - CyberGo HTTPC | 加密与证书固定](https://www.cybergo.dev/zh/httpc/security/tls-certpin): HTTPC TLS 与证书固定指南：TLS 1.2-1.3 版本控制、SPKI 哈希生成步骤与密钥轮换、三种 Pinner 构造器对比、自定义 CertificatePinner、mTLS 双向认证、自定义 CA 证书与 Let's Encrypt 短周期证书固定策略。 ## HTML - [HTML 提取工具库 - CyberGo html | 内容提取与清洗](https://www.cybergo.dev/zh/html/): CyberGo html 是高性能 Go 语言 HTML 提取与清洗库，集成智能文章识别、15+ 编码自动检测、Markdown/JSON 多格式输出、链接与媒体提取、批量并发处理、可插拔审计管道与多层安全防护，适用于 Web 抓取、爬虫与内容采集场景。 - [API 参考 - CyberGo html | 完整函数与类型清单](https://www.cybergo.dev/zh/html/api-reference/): CyberGo html 完整 API 参考索引：对比包函数与 Processor 两种调用模式，导航至内容提取、输出格式转换、链接提取、批量并发处理、Config 配置、多层安全防护、可插拔审计系统、核心接口、数据类型定义与错误常量等核心模块文档，便于快速定位。 - [配置 - CyberGo html | Config 字段详解](https://www.cybergo.dev/zh/html/api-reference/core/config): CyberGo html Config 配置结构体字段详解：覆盖资源管理、安全防护、内容提取、输出格式与链接过滤六大类共 30+ 字段，含 DefaultConfig 等四种预设配置、取值约束、零值语义与 Validate 验证方法，便于精准定制提取行为。 - [包函数 - CyberGo html | 用法、参数与示例](https://www.cybergo.dev/zh/html/api-reference/core/functions): CyberGo html 包级便捷函数参考：Extract、ExtractText、ExtractToMarkdown、ExtractToJSON 与 ExtractBatch 等签名详解，内部经 sync.Pool 复用 Processor 并禁用缓存，适合一次性低频调用场景。 - [Processor - CyberGo html | 用法、参数与示例](https://www.cybergo.dev/zh/html/api-reference/core/processor): CyberGo html Processor 处理器 API 参考：New 构造、Extract 方法族、ExtractText 等文本提取、ClearCache 清理、GetStatistics 统计与 Close 生命周期管理详解，复用缓存与编码检测器，适合高频调用场景。 - [审计系统 - CyberGo html | 可插拔审计 API](https://www.cybergo.dev/zh/html/api-reference/modules/audit): CyberGo html 可插拔审计系统 API 参考：AuditConfig 全字段配置、8 种审计事件类型（阻止标签、属性、URL、输入违规等）、Info/Warning/Critical 三级、AuditEntry 结构与 Logger/Writer/Channel 等六种内置 Sink 及级别过滤管道。 - [批量处理 - CyberGo html | 并发批量提取 API](https://www.cybergo.dev/zh/html/api-reference/modules/batch): CyberGo html 并发批量提取 API 参考：ExtractBatch、ExtractBatchFiles 及其 WithContext 上下文版本签名详解，支持并发处理，单批上限 10000 项，含 BatchResult 结果结构与部分失败处理机制。 - [链接提取 - CyberGo html | 资源链接提取 API](https://www.cybergo.dev/zh/html/api-reference/modules/links): CyberGo html 链接提取 API 参考：ExtractAllLinks 系列与 GroupLinksByType 详解，提取脚本、样式、图片等资源链接并按类型分组，支持配置过滤，结果自动按 URL 排序去重，适用于爬虫与资源收集场景。 - [输出格式 - CyberGo html | Markdown 与 JSON 输出](https://www.cybergo.dev/zh/html/api-reference/modules/output): CyberGo html 输出格式 API 参考：ExtractToMarkdown 与 ExtractToJSON 包函数及 Processor 方法详解，支持从字节或文件提取并转换为 Markdown、JSON 格式，含临时 Processor 缓存隔离机制说明。 - [安全防护 - CyberGo html | 多层安全 API 参考](https://www.cybergo.dev/zh/html/api-reference/modules/security): CyberGo html 多层安全防护 API 参考：内容消毒、MaxInputSize 输入限制、MaxDepth DOM 深度、路径遍历防护与 AllowedBaseDir 文件沙箱，含 HighSecurityConfig 预设与 InputError 等安全错误类型。 - [常量与错误 - CyberGo html | 默认值与错误类型](https://www.cybergo.dev/zh/html/api-reference/types/constants): CyberGo html 常量与错误类型参考：默认值常量（MaxInputSize、CacheTTL 等）、审计事件常量、哨兵错误及 InputError、ConfigError、FileError 结构化错误，支持 errors.Is/As 精准判断。 - [接口定义 - CyberGo html | 核心接口参考](https://www.cybergo.dev/zh/html/api-reference/types/interfaces): CyberGo html 核心接口参考：Extractor 提取主接口、StatsProvider 统计接口、ContentNode 节点接口、Scorer 内容评分接口与 AuditSink 审计输出接口，用于功能扩展、自定义实现、单元测试与第三方集成。 - [类型定义 - CyberGo html | 数据类型参考](https://www.cybergo.dev/zh/html/api-reference/types/type-defs): CyberGo html 核心数据类型参考：Result、ImageInfo、LinkInfo、LinkResource、VideoInfo、AudioInfo、Statistics、BatchResult 等结构体字段说明，含自定义 MarshalJSON 序列化行为。 - [高级示例 - CyberGo html | 进阶场景示例](https://www.cybergo.dev/zh/html/examples/advanced-usage): CyberGo html 高级进阶可运行示例集：自定义 Scorer 内容评分算法、多 Sink 审计管道构建、批量文件并发处理、Processor 池化复用、缓存命中率优化与 Web 服务单例模式等复杂场景代码，助你应对生产级内容采集需求。 - [基础用法 - CyberGo html | 典型场景代码速查](https://www.cybergo.dev/zh/html/examples/basic-usage): CyberGo html 基础用法场景代码速查页：正文提取与纯文本输出、文件读取、Markdown 与 JSON 转换、链接分组、媒体信息、批量并发与超时控制六类典型场景，每类附完整可编译的最小示例与详解入口，新手可直接抄代码上手并按需深入学习。 - [常见问题 - CyberGo html | 高频问题解答](https://www.cybergo.dev/zh/html/faq/): CyberGo html 常见问题高频解答：包函数与 Processor 如何选择、15+ 编码自动检测原理、输入大小限制与 DOM 深度防护、空文本结果排查、GetStatistics 统计监控启用、审计日志配置与缓存命中率优化等典型疑问的解决方案。 - [快速开始 - CyberGo html | 5 分钟入门指南](https://www.cybergo.dev/zh/html/getting-started/): CyberGo html 快速入门指南：5 分钟掌握 Go 1.25+ 环境下的安装、基本内容提取、DefaultConfig 等四种 Config 预设选择，以及纯文本、Markdown、JSON 三种输出格式与 Processor 并发安全调用实践。 - [速查表 - CyberGo html | API 一页速查](https://www.cybergo.dev/zh/html/getting-started/cheatsheet): CyberGo html 常用 API 一页速查表：汇总 Extract、ExtractText、ExtractToMarkdown 等包级函数与 Processor 方法、四种 Config 预设、errors.Is 错误判断及 AuditConfig 审计配置，覆盖核心函数签名与典型用法。 - [配置实战 - CyberGo html | Config 字段选择指南](https://www.cybergo.dev/zh/html/guides/core-features/configuration): CyberGo html 配置实战指南：DefaultConfig、HighSecurityConfig、TextOnlyConfig、MarkdownConfig 四种预设选择建议、六大类字段导览、常见配置组合与 Validate 验证，助新手快速选型。 - [内容提取实战 - CyberGo html | 提取流程指南](https://www.cybergo.dev/zh/html/guides/core-features/content-extraction): CyberGo html 内容提取实战指南：详解完整提取流程（输入校验、编码检测、DOM 解析、安全清洗、文章智能识别与格式化）、候选节点评分算法原理、Result 结构体各字段含义、自定义 Scorer 评分器与编码自动检测机制及最佳实践。 - [编码检测实战 - CyberGo html | 字符编码自动识别指南](https://www.cybergo.dev/zh/html/guides/core-features/encoding-detection): CyberGo html 字符编码自动识别指南：四级检测优先级详解（手动指定、meta 标签声明、统计算法、UTF-8 兜底）、15+ 编码支持、Config.Encoding 手动指定与 GBK、Shift_JIS、Windows-1252 自动检测示例。 - [链接提取实战 - CyberGo html | 资源收集指南](https://www.cybergo.dev/zh/html/guides/core-features/link-extraction): CyberGo html 链接提取实战指南：ExtractAllLinks 提取脚本、样式与图片等资源链接、GroupLinksByType 按类型分组、Include 字段过滤、URL 规范化解析与 BaseURL 自动检测，适用于爬虫与资源收集场景。 - [媒体提取实战 - CyberGo html | 视频与音频提取指南](https://www.cybergo.dev/zh/html/guides/core-features/media-extraction): CyberGo html 媒体提取实战指南：视频三源扫描机制详解（原始 HTML 扫描、DOM 遍历、正则兜底）、音频双源提取策略、VideoInfo 与 AudioInfo 结构体字段含义、Type 字段区分文件来源与 embed 嵌入类型。 - [输出格式实战 - CyberGo html | 格式对比指南](https://www.cybergo.dev/zh/html/guides/core-features/output-formats): CyberGo html 输出格式实战指南：对比纯文本、Markdown、JSON 三种格式的特点与适用场景（搜索索引、博客文档、API 传输），含 InlineImageFormat 与 InlineLinkFormat 内联格式选项配置。 - [HTTP 集成 - CyberGo html | Web 服务实战](https://www.cybergo.dev/zh/html/guides/integration/http-integration): CyberGo html 与标准库 net/http 集成实战指南：单页抓取与内容提取、并发批量抓取处理、Processor 单例复用 Web 服务模式、指数退避重试策略、超时控制、GBK 编码自动检测等生产级 HTTP 网页内容采集与服务部署最佳实践。 - [测试与自定义扩展 - CyberGo html | 测试体系指南](https://www.cybergo.dev/zh/html/guides/integration/testing-custom): CyberGo html 测试与自定义扩展指南：自定义 Scorer 内容评分算法实现、ContentNode 节点遍历、测试组织模式与 mock 数据构造、Extractor 接口 mock 示例，助你定制内容识别逻辑与编写可靠的单元测试。 - [批量处理实战 - CyberGo html | 并发提取指南](https://www.cybergo.dev/zh/html/guides/performance/batch-processing): CyberGo html 批量处理实战指南：ExtractBatch 等四个批量 API 详解、BatchResult 结果结构、WorkerPoolSize 并发控制、context 上下文取消、部分失败处理与按数据量规模的分级性能调优建议。 - [错误处理 - CyberGo html | 健壮错误处理指南](https://www.cybergo.dev/zh/html/guides/performance/error-handling): CyberGo html 健壮错误处理指南：五类错误分类（输入、配置、文件、处理、系统）、errors.Is 哨兵错误判断、errors.As 结构化错误字段提取、context 超时取消、批量处理部分失败与 panic 恢复的应对策略与最佳实践。 - [性能优化 - CyberGo html | 吞吐量提升指南](https://www.cybergo.dev/zh/html/guides/performance/performance): CyberGo html 性能优化总览：sync.Pool 复用 Processor、缓存命中率监控、批量并发控制、WorkerPoolSize 调优、ProcessingTimeout 超时设置与反模式规避，系统提升 HTML 处理吞吐量。 - [Processor 复用与缓存 - CyberGo html | 复用指南](https://www.cybergo.dev/zh/html/guides/performance/processor-cache): CyberGo html Processor 复用与缓存指南：包函数与 Processor 实例的核心区别与选择策略、sync.Pool 内部复用机制、缓存策略配置、GetStatistics 命中率监控与 Web 服务单例复用的最佳实践。 - [安全概述 - CyberGo html | 安全防护总览](https://www.cybergo.dev/zh/html/guides/security/): CyberGo html 安全防护总览：深度防御三层架构（输入层、处理层、审计层）、MaxInputSize 与 MaxDepth 限制、路径遍历防护、panic 恢复机制、HTML 内容清洗与 HighSecurityConfig 高安全预设应用。 - [审计系统实战 - CyberGo html | 管道构建指南](https://www.cybergo.dev/zh/html/guides/security/audit-pipeline): CyberGo html 审计系统实战指南：从基础启用到多层级管道构建，涵盖 8 种审计事件类型详解、内置 Sink 对比（Stderr、File、Channel）、Info/Warn/Error 级别过滤与自定义 AuditSink 监控实践。 - [生产检查清单 - CyberGo html | 上线安全核对](https://www.cybergo.dev/zh/html/guides/security/production-checklist): CyberGo html 生产部署安全核对清单：按 P0/P1/P2 优先级分级检查，涵盖 HighSecurityConfig 预设、Processor 生命周期管理、审计监控启用、context 超时控制、错误处理与资源释放等上线必查项。 ## DD - [结构化日志 - CyberGo DD | 高性能 Go 日志库](https://www.cybergo.dev/zh/dd/): CyberGo DD 是 CyberGo 组织推出的高性能 Go 结构化日志库，提供线程安全的日志记录、灵活的输出目标配置、文件自动轮换、敏感数据自动过滤、异步审计日志、HMAC 完整性签名和低分配优化，帮助开发者快速构建安全可靠的日志记录系统。 - [性能优化 - CyberGo DD | 高性能日志](https://www.cybergo.dev/zh/dd/advanced/performance): CyberGo DD 日志库性能优化完整指南，详解低分配优化技巧、BufferedWriter 缓冲写入配置、日志采样策略与频率控制、级别提前检查避免无用分配、sync.Pool 对象池复用和基准测试分析方法，帮助开发者在高并发场景下获得极致日志性能。 - [API 参考 - CyberGo DD | 概览](https://www.cybergo.dev/zh/dd/api-reference/): CyberGo DD 结构化日志库完整 API 参考文档概览，全面涵盖 Logger 核心记录器、Config 配置选项、Writers 输出目标、Security 安全过滤、Audit 审计日志、Hooks 钩子系统和 Integrity 完整性签名等核心功能模块。 - [配置 - CyberGo DD | Config 详解](https://www.cybergo.dev/zh/dd/api-reference/core/config): CyberGo DD Config 结构体完整 API 文档，包含 DefaultConfig/DevelopmentConfig/JSONConfig 预设配置函数、OutputTarget 输出目标配置、字段验证规则、采样控制、格式化选项和 Validate 验证方法，提供灵活且类型安全的日志记录器行为定制能力。 - [常量与错误 - CyberGo DD | LogLevel、Format、SentinelErrors](https://www.cybergo.dev/zh/dd/api-reference/core/constants): CyberGo DD 常量定义与错误类型完整文档，包括 LogLevel 日志级别常量（Debug/Info/Warn/Error/Fatal）、Format 输出格式常量和 SentinelErrors 哨兵错误定义，用于精确控制日志行为和错误处理，是理解 DD 日志库配置体系的核心基础。 - [LoggerEntry - CyberGo DD | 预设字段日志](https://www.cybergo.dev/zh/dd/api-reference/core/entry): CyberGo DD LoggerEntry 类型完整 API 文档，用于创建带预设字段的链式日志记录器，传入字段时返回新的不可变 Entry 实例（不传字段时返回原 Entry），支持字段累积组合、上下文绑定传播和级别继承机制，适用于请求级日志追踪和上下文关联等场景。 - [结构化字段 - CyberGo DD | Field 构造器与校验](https://www.cybergo.dev/zh/dd/api-reference/core/fields): CyberGo DD 结构化字段 API：20 种类型安全字段构造器（String/Int/Float/Bool/Time/Duration/Err 等）、Field 类型与字段键校验（命名约定与 Log4Shell 安全检测），支持自定义校验模式与预设配置。 - [包函数 - CyberGo DD | 全局函数和构造器](https://www.cybergo.dev/zh/dd/api-reference/core/functions): CyberGo DD 包级函数完整 API 文档，包括 New 日志记录器创建函数、Default/SetDefault/InitDefault 全局日志管理函数、DefaultConfig/DevelopmentConfig/JSONConfig 配置预设函数以及所有构造器工厂函数，支持通过 dd. 前缀直接调用。 - [钩子系统 - CyberGo DD | HookRegistry](https://www.cybergo.dev/zh/dd/api-reference/core/hooks): CyberGo DD 生命周期钩子系统完整 API 文档，支持在日志写入前后（BeforeLog/AfterLog）、文件轮换（OnRotate）、错误发生（OnError）等关键事件上注册自定义回调函数，提供 HookRegistry 注册表和灵活的日志处理扩展机制。 - [接口定义 - CyberGo DD | Logger 接口层次](https://www.cybergo.dev/zh/dd/api-reference/core/interfaces): CyberGo DD 日志库接口层次定义完整文档，包括 CoreLogger 基础日志接口、LevelLogger 级别日志接口、ConfigurableLogger 可配置日志接口和 LogProvider 日志提供者接口，支持从简单到复杂的多层次日志抽象需求，便于自定义实现和依赖注入。 - [Logger - CyberGo DD | 核心日志记录器](https://www.cybergo.dev/zh/dd/api-reference/core/logger): CyberGo DD Logger 核心日志记录器 API：日志输出方法（Info/Warn/Error/Fatal）、级别动态管理、Writer 增删替换、生命周期控制（Close/Flush）与链式字段设置，是日志库线程安全高性能的核心入口类型。 - [调试输出 - CyberGo DD | Print/JSON/Text/Exit](https://www.cybergo.dev/zh/dd/api-reference/dev-tools/debug-visual): CyberGo DD 调试可视化输出函数完整 API 文档，包括 Print 格式化打印、JSON 结构化输出、Text 纯文本输出和 Exit 致命退出等快速调试函数，支持直接通过包级函数调用，无需创建 Logger 实例即可使用，大幅简化开发调试流程。 - [测试辅助 - CyberGo DD | LoggerRecorder](https://www.cybergo.dev/zh/dd/api-reference/dev-tools/recorder): CyberGo DD 测试辅助工具 LoggerRecorder 完整 API 文档，专为单元测试场景设计，用于捕获和断言日志输出内容，支持按级别过滤日志条目、结构化字段值验证、条目计数统计和按序断言，显著提升日志相关单元测试的编写效率和可读性。 - [上下文集成 - CyberGo DD | Context 集成](https://www.cybergo.dev/zh/dd/api-reference/output-integration/context): CyberGo DD 上下文集成 API：通过 WithTraceID/WithSpanID/WithRequestID 注入追踪标识，ContextKey 类型安全键与 ContextExtractor 函数类型自动提取字段，支持 OpenTelemetry 等分布式追踪框架集成。 - [输出目标 - CyberGo DD | FileWriter、BufferedWriter、MultiWriter](https://www.cybergo.dev/zh/dd/api-reference/output-integration/writers): CyberGo DD 输出目标 API：FileWriter 按文件大小自动轮换并按时间清理旧备份、BufferedWriter 高性能缓冲写入（可配置缓冲区与刷新间隔）与 MultiWriter 多目标并行输出，满足从开发到生产的各类日志输出场景需求，助力构建可靠的日志系统。 - [安全与审计 - CyberGo DD | API 概览](https://www.cybergo.dev/zh/dd/api-reference/security-audit/): CyberGo DD 安全与审计 API 概览，涵盖 SensitiveDataFilter 敏感数据过滤、AuditLogger 异步审计日志和 IntegritySigner HMAC 完整性签名三大组件的功能定位与适用场景。 - [审计日志 - CyberGo DD | AuditLogger](https://www.cybergo.dev/zh/dd/api-reference/security-audit/audit): CyberGo DD 审计日志完整 API 文档，包括 AuditLogger 异步审计事件记录器、AuditConfig 配置选项（输出目标、格式、签名）和审计条目结构化格式化，支持安全相关事件追踪记录，满足企业级合规审计和数据安全监管的各类需求。 - [完整性签名 - CyberGo DD | IntegritySigner](https://www.cybergo.dev/zh/dd/api-reference/security-audit/integrity): CyberGo DD 完整性签名完整 API 文档，支持 HMAC-SHA256 算法签名和序列号递增追踪机制，确保每条日志条目未被篡改，提供 IntegritySigner 签名器和 Verify 验证器，满足安全审计和日志防篡改等各类合规要求。 - [安全过滤 - CyberGo DD | 敏感数据过滤](https://www.cybergo.dev/zh/dd/api-reference/security-audit/security): CyberGo DD 敏感数据过滤完整 API 文档，包括 SensitiveDataFilter 过滤规则配置、SecurityConfig 安全策略选项和预设安全配置方案，自动检测和脱敏日志中的密码、API 密钥、Token、手机号和身份证号等敏感信息，有效防止日志泄露风险。 - [基础用法 - CyberGo DD | 实用示例](https://www.cybergo.dev/zh/dd/examples/basic-usage): CyberGo DD 日志库的实用代码示例集合，涵盖 Gin/Echo Web 服务请求日志、gRPC 拦截器集成、数据库操作日志记录、中间件链式调用、定时任务日志输出和微服务分布式追踪集成等常见场景，提供可直接复制使用的最佳实践代码片段。 - [安全与审计实战 - CyberGo DD | 安全日志示例](https://www.cybergo.dev/zh/dd/examples/security-audit): CyberGo DD 安全过滤与审计日志的完整实战示例集合，涵盖敏感数据过滤规则配置、HMAC 完整性签名与验签、审计事件记录与批量验证、行业合规配置方案（HIPAA/PCI-DSS）以及生产环境安全日志架构设计与部署的最佳实践建议和注意事项。 - [测试模式 - CyberGo DD | LoggerRecorder 测试示例](https://www.cybergo.dev/zh/dd/examples/testing-patterns): CyberGo DD 测试模式示例，详细介绍 LoggerRecorder 在单元测试与集成测试中的完整使用方法，包括日志消息断言、级别过滤测试、字段值检查、多测试用例隔离、并发安全测试以及提升测试覆盖率的完整技巧与最佳实践经验总结。适用于各类 Go 项目的日志测试。 - [Web 服务集成 - CyberGo DD | HTTP 服务日志示例](https://www.cybergo.dev/zh/dd/examples/web-service): CyberGo DD 在 Web 服务中的完整集成示例，包括 HTTP 中间件日志记录、请求链路追踪与 TraceID 传递、多路由分层日志配置、优雅关闭与日志刷新以及生产级日志配置方案，帮助开发者将 DD 日志库快速集成到 HTTP 服务项目中。 - [FAQ - CyberGo DD | 常见问题](https://www.cybergo.dev/zh/dd/faq/): CyberGo DD 日志库常见问题与详细解答汇总，涵盖配置调优技巧、性能优化建议、敏感数据安全过滤规则、审计日志与合规配置方法、文件轮换策略选择与优化、错误处理最佳实践和钩子系统使用示例等主题，帮助开发者快速解决在实际项目中遇到的各类问题。 - [快速开始 - CyberGo DD | 5 分钟入门指南](https://www.cybergo.dev/zh/dd/getting-started/): 快速上手 CyberGo DD 高性能结构化日志库的完整入门教程，从安装依赖到首次输出日志，逐步学习创建日志记录器、配置输出目标与文件轮换策略、使用结构化字段记录请求上下文信息和钩子系统扩展功能，5 分钟即可掌握核心用法并应用到实际项目中。 - [速查表 - CyberGo DD | 常用 API 速查](https://www.cybergo.dev/zh/dd/getting-started/cheatsheet): CyberGo DD 日志库常用 API 速查表，涵盖日志记录器创建与克隆、日志级别控制、结构化字段构造、文件输出轮换与缓冲配置、敏感数据安全过滤规则、钩子注册与回调处理函数、审计日志记录和完整性签名验证等高频操作，方便开发者快速查阅和使用。 - [全局 Logger - CyberGo DD | 默认日志记录器使用指南](https://www.cybergo.dev/zh/dd/getting-started/global-logger): CyberGo DD 全局 Logger 模式详解：Default() 懒初始化、SetDefault() 替换、InitDefault() 带错误处理的初始化方法，以及包级便捷函数 dd.Info() 与实例方法 logger.Info() 的选择策略。 - [安装 - CyberGo DD | 环境要求与集成](https://www.cybergo.dev/zh/dd/getting-started/installation): CyberGo DD 日志库安装指南，涵盖 Go 版本要求、go get 安装、Go Module 集成、CI/CD 配置建议以及常见安装问题排查，帮助开发者快速将 DD 集成到项目中。 - [配置详解 - CyberGo DD | Config 结构体与预设方案](https://www.cybergo.dev/zh/dd/guides/basics/configuration): CyberGo DD 配置体系详解：DefaultConfig、DevelopmentConfig、JSONConfig 三种预设方案，Config 结构体全字段说明，多输出目标配置、JSON 格式定制与 Clone 深拷贝用法。 - [核心概念 - CyberGo DD | 架构与设计理念](https://www.cybergo.dev/zh/dd/guides/basics/core-concepts): 深入理解 CyberGo DD 日志库的核心架构与设计理念，包括 Logger 与 LoggerEntry 的关系与生命周期、结构化字段 Field 的类型安全使用模式、日志处理管道的完整处理流程、四层递进式接口设计以及线程安全并发模型，帮助开发者建立对 DD 库的系统性认知。 - [文件输出与轮换 - CyberGo DD | 文件日志配置指南](https://www.cybergo.dev/zh/dd/guides/basics/file-output): CyberGo DD 文件输出与日志轮换配置指南，涵盖 FileWriter 大小轮换与时间清理策略、BufferedWriter 缓冲写入优化、MultiWriter 多目标分发、动态 Writer 管理以及生产环境最佳实践，帮助开发者构建高可靠性的文件日志系统。 - [结构化日志 - CyberGo DD | 字段与链式调用](https://www.cybergo.dev/zh/dd/guides/basics/structured-logging): CyberGo DD 结构化日志使用指南，详细介绍 20 种类型安全的字段构造器、Field 链式传递模式、LoggerEntry 不可变设计原理、字段命名规范与验证规则，以及结构化日志的最佳实践和常见使用模式，帮助开发者在项目中有效使用高性能的结构化日志记录方案。 - [分布式追踪集成 - CyberGo DD | Context 与追踪指南](https://www.cybergo.dev/zh/dd/guides/integration/context-tracing): CyberGo DD 分布式追踪集成指南：TraceID、SpanID、RequestID 上下文传播，ContextExtractor 自定义提取器、HTTP 中间件集成、请求作用域日志与 OpenTelemetry 分布式追踪系统集成。 - [迁移指南 - CyberGo DD | 从其他日志库迁移](https://www.cybergo.dev/zh/dd/guides/integration/migration): CyberGo DD 从标准库 log/slog 及主流第三方日志库（zap、logrus、zerolog）迁移的完整对照指南，提供详细的 API 映射表、配置参数对照、常见迁移模式和渐进式迁移策略，帮助开发者低风险地将现有日志系统平滑切换到 DD 日志库。 - [错误处理 - CyberGo DD | 日志错误管理](https://www.cybergo.dev/zh/dd/guides/operations/error-handling): CyberGo DD 日志库错误处理完整指南，详解结构化错误类型与层级体系、错误码设计、哨兵错误定义与判断方法、errors.Is/As 错误包装与拆包、自定义错误处理策略实现、错误恢复机制和错误钩子回调配置，帮助开发者精确识别和处理各类日志相关错误。 - [钩子系统 - CyberGo DD | 生命周期钩子实战指南](https://www.cybergo.dev/zh/dd/guides/operations/hooks): CyberGo DD 钩子系统指南：6 种生命周期事件（BeforeLog、AfterLog、OnFilter、OnRotate、OnClose、OnError）、HookRegistry 注册管理、HookContext 上下文与常见扩展场景。 - [日志采样 - CyberGo DD | 高吞吐场景日志降量策略](https://www.cybergo.dev/zh/dd/guides/operations/sampling): CyberGo DD 日志采样配置详解：SamplingConfig 的 Initial、Thereafter、Tick 参数用法，在高吞吐场景下减少日志体积同时保留关键信息，支持运行时动态开关。 - [安全概述 - CyberGo DD | 日志安全](https://www.cybergo.dev/zh/dd/guides/security/): CyberGo DD 日志库安全特性全面概述，包括敏感数据自动检测与脱敏过滤机制、文件路径安全验证与防护策略、异步审计事件记录与链式追踪能力、HMAC 完整性签名防篡改技术和合规配置最佳实践指南，从数据过滤到审计追踪全面保障日志系统运行安全。 - [审计日志 - CyberGo DD | 安全审计实战指南](https://www.cybergo.dev/zh/dd/guides/security/audit-logging): CyberGo DD 审计日志实战指南，涵盖 AuditLogger 异步事件记录机制、11 种内置审计事件类型、严重等级过滤与分级、HMAC 完整性签名集成方案、审计统计与实时监控、日志验证与防篡改策略，帮助开发者构建符合合规要求的企业级安全审计系统。 - [行业合规配置 - CyberGo DD | HIPAA PCI-DSS 政府标准](https://www.cybergo.dev/zh/dd/guides/security/compliance): CyberGo DD 行业合规日志配置专题，详细说明 HIPAA 医疗行业合规、PCI-DSS 金融支付合规和政府安全标准的敏感数据过滤规则配置、审计日志要求、日志保留与轮换策略以及完整合规配置示例，帮助开发者在严格合规要求下构建安全可靠的日志系统。 - [字段验证 - CyberGo DD | 字段键命名规范与安全校验](https://www.cybergo.dev/zh/dd/guides/security/field-validation): CyberGo DD 字段验证功能详解：snake_case、camelCase、PascalCase、kebab-case 命名约定校验，三种验证模式（关闭/警告/严格），内置 Log4Shell 注入防护与同形异义字符检测。 - [HMAC 签名实战 - CyberGo DD | 日志完整性保护](https://www.cybergo.dev/zh/dd/guides/security/integrity): CyberGo DD HMAC-SHA256 日志完整性签名实战指南，涵盖 IntegritySigner 创建与初始化配置、签名与验签完整流程、时间戳与序列号递增机制、防篡改检测策略、与审计日志系统集成方案以及生产环境部署最佳实践，确保日志链路的完整性与可追溯性。 - [生产检查清单 - CyberGo DD | 安全上线检查](https://www.cybergo.dev/zh/dd/guides/security/production-checklist): CyberGo DD 日志库生产环境部署前的完整安全检查清单，涵盖基础配置项验证、敏感数据过滤规则启用与测试验证、审计日志开关确认、文件轮换策略设置、HMAC 完整性签名配置和性能基准调优等关键检查项目，确保日志系统安全可靠且合规上线运行。 - [敏感数据过滤 - CyberGo DD | 自动脱敏配置指南](https://www.cybergo.dev/zh/dd/guides/security/sensitive-filtering): CyberGo DD 敏感数据过滤配置指南，涵盖内置过滤模式（密码、API Key、信用卡、SSN、JWT 等）、自定义正则模式、五级安全等级、行业合规预设（HIPAA、PCI-DSS、政府标准）以及过滤统计与监控，帮助开发者构建合规的日志脱敏方案。 ## ENV - [环境变量管理 - CyberGo env | 安全环境变量配置](https://www.cybergo.dev/zh/env/): CyberGo env 是高安全 Go 环境变量管理库，支持 .env、JSON、YAML 多格式自动检测加载与类型安全转换，内置 SecureValue 内存锁定与自动清零、分片锁线程安全、${VAR} 变量展开、env 标签结构体映射和完整审计日志，适用于微服务与云原生配置管理。 - [性能优化 - CyberGo env | 高并发读写调优](https://www.cybergo.dev/zh/env/advanced/performance): CyberGo env 性能优化指南，详解 RWMutex 读写锁与分片锁的并发安全机制、sync.Pool 对象池复用显著减少分配、mlock 内存锁定开销权衡与大文件流式解析，附基准测试对比、并发吞吐量分析与 MaxFileSize/MaxVariables 参数调优建议。 - [API 参考 - CyberGo env | 完整接口文档](https://www.cybergo.dev/zh/env/api-reference/): CyberGo env 完整 API 参考导航，涵盖包级便捷函数、Config 配置、Loader 加载器、SecureValue 安全值、核心接口定义、ComponentFactory 组件工厂与常量错误等七大模块的详细入口与方法签名索引。 - [Config API - CyberGo env | 配置详解](https://www.cybergo.dev/zh/env/api-reference/config): CyberGo env 的 Config 配置结构体 API 参考，含文件搜索路径、大小与数量限制、键值验证、JSON/YAML 解析选项、变量展开、审计配置及 Development/Production 预设模板，详解嵌套结构与字段提升两种访问方式。 - [常量与错误 - CyberGo env | 哨兵错误与安全常量](https://www.cybergo.dev/zh/env/api-reference/constants): CyberGo env 常量与错误参考，含 DefaultMaxFileSize 与 MaxVariables 限制、ErrFileNotFound 哨兵错误、ParseError 类型、DefaultForbiddenKeys 禁止键及 IsSensitiveKey、MaskValue 工具函数。 - [ComponentFactory API - CyberGo env | 组件工厂](https://www.cybergo.dev/zh/env/api-reference/factory): CyberGo env 的 ComponentFactory 组件工厂 API 参考，统一创建 Validator 验证器、Auditor 审计器、FileSystem 文件系统适配器与变量展开器，并通过 RegisterParser 注册自定义解析器，提供 Close 生命周期管理。 - [包函数 - CyberGo env | 全局便捷函数](https://www.cybergo.dev/zh/env/api-reference/functions): CyberGo env 包级便捷函数 API 参考，提供 Load、GetString、GetInt、GetBool、GetDuration、GetSlice、GetSecure、Lookup、Keys 与 ParseInto 等基于全局默认 Loader 的线程安全接口。 - [接口定义 - CyberGo env | 核心接口层次](https://www.cybergo.dev/zh/env/api-reference/interfaces): CyberGo env 核心接口定义参考，采用细粒度设计支持依赖注入，含 EnvLoader 组合接口与 EnvFileLoader、EnvGetter、EnvSetter、Validator、FullAuditLogger、EnvParser、FileSystem 等子接口。 - [Loader API - CyberGo env | 加载器详解](https://www.cybergo.dev/zh/env/api-reference/loader): CyberGo env 的 Loader 加载器 API 参考，核心类型提供多格式 LoadFiles 加载、GetString/GetInt/GetSlice 类型安全读取、Set/Delete 增删改、Validate 验证、序列化导出与 Close 生命周期管理，所有方法线程安全。 - [SecureValue API - CyberGo env | 安全值存储](https://www.cybergo.dev/zh/env/api-reference/secure-value): CyberGo env 的 SecureValue 安全值 API 参考，含 NewSecureValue 创建、mlock 内存锁定、Reveal 读取明文、Masked 掩码、Release 清零销毁、IsSensitiveKey 检测，安全存储密码、令牌与密钥。 - [快速开始 - CyberGo env | 5 分钟入门指南](https://www.cybergo.dev/zh/env/getting-started/): 5 分钟上手 CyberGo env 环境变量管理库，涵盖 go get 安装、.env 加载、类型安全读取、GetSecure 安全值、结构体映射、变量展开与 errors.Is 错误处理，并讲解四种配置预设与多环境多文件加载，附完整可运行代码示例助您快速入门。 - [速查表 - CyberGo env | 常用 API 速查](https://www.cybergo.dev/zh/env/getting-started/cheatsheet): CyberGo env 常用 API 速查表，一页汇总文件加载、类型读取、结构体映射、变量展开、验证、SecureValue 存储、Marshal/Unmarshal 序列化、哨兵错误 errors.Is 与审计日志等高频操作的核心代码片段，方便日常查阅。 - [审计日志 - CyberGo env | 安全审计配置](https://www.cybergo.dev/zh/env/guides/audit-logging): CyberGo env 审计日志配置指南，涵盖 JSONAuditHandler、LogAuditHandler 与 ChannelAuditHandler 三种处理器，及自定义 AuditHandler 记录变量加载、读取、修改与删除操作，用于安全审计、合规检查与问题排查。 - [自定义解析器 - CyberGo env | 扩展文件格式](https://www.cybergo.dev/zh/env/guides/custom-parser): CyberGo env 自定义解析器指南，实现 EnvParser 接口的 Parse 方法并通过 RegisterParser 注册，借助 ComponentFactory 获取 Validator 与 Auditor，附 TOML 与 INI 解析器完整示例与最佳实践。 - [错误处理 - CyberGo env | 哨兵错误与恢复策略](https://www.cybergo.dev/zh/env/guides/error-handling): CyberGo env 错误处理指南，详解 16 个哨兵错误的 errors.Is 精确匹配、ParseError/FileError/SecurityError 等结构化错误的 errors.As 上下文提取、恢复降级策略与错误链 Unwrap 追踪，附生产环境错误分类实践。 - [多格式配置 - CyberGo env | .env/JSON/YAML](https://www.cybergo.dev/zh/env/guides/multi-format): CyberGo env 多格式配置加载指南，支持 .env、JSON、YAML 自动检测与混合加载，详解嵌套对象与数组的扁平化键名、键值合并优先级、Marshal/UnmarshalMap 格式互转与 RegisterParser 自定义格式，适配微服务与容器化场景。 - [序列化 - CyberGo env | 多格式转换](https://www.cybergo.dev/zh/env/guides/serialization): CyberGo env 序列化指南，详解 .env、JSON、YAML 间的 Map 与结构体转换，含 Marshal/Unmarshal 函数族、Marshaler/Unmarshaler 自定义接口与 DetectFormat 自动检测，覆盖配置导出与格式迁移等实用场景。 - [结构体映射 - CyberGo env | 环境变量到结构体](https://www.cybergo.dev/zh/env/guides/struct-mapping): CyberGo env 结构体映射指南，通过 env、envDefault 标签将环境变量自动映射到 Go 结构体字段，涵盖嵌套结构体、指针与切片、时间类型、自定义类型解码、字段忽略、默认值与必填验证，配合 ParseInto 与 Validate 实现类型安全的配置加载。 - [测试场景 - CyberGo env | 单元测试最佳实践](https://www.cybergo.dev/zh/env/guides/testing): CyberGo env 测试最佳实践指南，含 TestingConfig 配置与 OverwriteExisting 测试隔离、FileSystem 接口模拟内存文件系统、每个测试独立加载器、表驱动与基准测试、ResetDefaultLoader 状态清理策略，保障测试稳定可复现。 - [变量展开 - CyberGo env | ${VAR} 引用与默认值语法](https://www.cybergo.dev/zh/env/guides/variable-expansion): CyberGo env 变量展开语法指南，详解 ${VAR} 与 ${VAR:-default} 引用、${VAR:=default} 默认值、${VAR:?error} 必填校验、$VAR 简写、循环引用检测与 MaxExpansionDepth 深度限制，实现配置复用与动态值替换。 - [常见问题 - CyberGo env | 环境变量常见问题](https://www.cybergo.dev/zh/env/reference/faq): CyberGo env 常见问题解答，涵盖全局模式与实例模式选择、Load 单次初始化限制、JSON/YAML 嵌套键访问、GetSlice 泛型函数设计、线程安全并发访问、SecureValue 生命周期管理、OverwriteExisting 覆盖策略与测试隔离等高频问题。 - [文件格式 - CyberGo env | .env/JSON/YAML 语法](https://www.cybergo.dev/zh/env/reference/file-format): CyberGo env 配置文件格式参考，详解 .env、JSON、YAML 三种格式的语法规则、引号与 export 前缀、变量展开 ${VAR}、多行字符串、嵌套对象与数组扁平化、UTF-8 编码与 DetectFormat 自动检测机制。 - [安全概述 - CyberGo env | 安全架构](https://www.cybergo.dev/zh/env/security/): CyberGo env 安全架构概览，详解 SecureValue 内存锁定与自动清零、键值验证过滤控制字符与空字节、DefaultForbiddenKeys 禁止 PATH 与 LD_PRELOAD、IsSensitiveKey 自动检测、安全预设与审计追踪。 - [敏感数据脱敏 - CyberGo env | 日志安全工具](https://www.cybergo.dev/zh/env/security/data-masking): CyberGo env 敏感数据脱敏工具完整指南，详解 IsSensitiveKey 自动检测密码密钥等敏感键、MaskValue 按敏感性脱敏值、MaskKey 脱敏键名、SanitizeForLog 清理日志字符串与 ClearBytes 安全清零，附 HTTP 中间件与结构化日志实战示例。 - [内存锁定 - CyberGo env | mlock 内存保护](https://www.cybergo.dev/zh/env/security/memory-locking): CyberGo env 内存锁定指南，详解 SetMemoryLockEnabled 启用、IsMemoryLockSupported 检测与 SetMemoryLockStrict 严格模式，阐述 mlock 防止敏感数据被交换到磁盘的原理与 SecureValue 生命周期管理实践。 - [生产检查清单 - CyberGo env | 安全上线检查](https://www.cybergo.dev/zh/env/security/production-checklist): CyberGo env 生产部署安全检查清单，涵盖 .env 文件 600 权限与 .gitignore 保护、RequiredKeys/AllowedKeys 必需键验证、审计日志启用、SecureValue 处理与性能参数调优，保障上线即安全。 ## 其他 - [CyberGo](https://www.cybergo.dev/zh/): CyberGo 是专为 Go 打造的高性能开源库集合，涵盖 JSON 处理、JWT 认证、安全 HTTP 客户端、HTML 提取、结构化日志与环境变量管理，轻量设计、最小依赖，为高并发生产环境提供可靠基础组件。 - [关于 - CyberGo 文档 | 文档站点介绍](https://www.cybergo.dev/zh/about): 了解 CyberGo 文档站点，涵盖文档覆盖范围、贡献方式、技术栈和联系方式等信息。