refactor: 后端代码质量优化 - 复用公共库、使用标准库、类型安全错误判断

## 高优先级修复
- stats_service_impl: 使用 strings.SplitN 替代错误的索引分割
- provider_handler: 使用 errors.Is(err, gorm.ErrDuplicatedKey) 替代字符串匹配
- client: 重写 isNetworkError 使用 errors.As/Is 类型安全判断
- proxy_handler: 使用 encoding/json 标准库解析 JSON（extractModelName、isStreamRequest）

## 中优先级修复
- stats_handler: 添加 parseDateParam 辅助函数消除重复日期解析
- pkg/errors: 新增 ErrRequestCreate/Send/ResponseRead 错误类型和 WithCause 方法
- client: 使用结构化错误替代 fmt.Errorf
- ConversionEngine: logger 依赖注入，替换所有 zap.L() 调用

## 低优先级修复
- encoder: 删除 joinStrings，使用 strings.Join
- adapter: 删除 modelInfoRegex 正则，使用 isModelInfoPath 字符串函数

## 文档更新
- README.md: 添加公共库使用指南和编码规范章节
- specs: 同步 delta specs 到 main specs（error-handling、structured-logging、request-validation）

## 归档
- openspec/changes/archive/2026-04-20-refactor-backend-code-quality/

openspec/specs/error-handling/spec.md

@@ -47,6 +47,24 @@
 - **THEN** SHALL 使用 ErrInternal 等预定义错误
 - **THEN** SHALL 设置 HTTP 状态码为 500
 
+#### Scenario: 请求创建错误
+
+- **WHEN** 创建 HTTP 请求失败
+- **THEN** SHALL 使用 ErrRequestCreate 预定义错误
+- **THEN** SHALL 设置 HTTP 状态码为 500
+
+#### Scenario: 请求发送错误
+
+- **WHEN** 发送 HTTP 请求失败
+- **THEN** SHALL 使用 ErrRequestSend 预定义错误
+- **THEN** SHALL 设置 HTTP 状态码为 500
+
+#### Scenario: 响应读取错误
+
+- **WHEN** 读取 HTTP 响应失败
+- **THEN** SHALL 使用 ErrResponseRead 预定义错误
+- **THEN** SHALL 设置 HTTP 状态码为 500
+
 ### Requirement: 支持错误包装
 
 系统 SHALL 支持错误包装。
@@ -127,6 +145,30 @@
 - **THEN** SHALL 包装数据库错误
 - **THEN** SHALL 转换为应用错误
 
+### Requirement: 使用类型安全错误判断
+
+系统 SHALL 使用类型安全方式判断错误类型。
+
+#### Scenario: 数据库错误判断
+
+- **WHEN** 判断数据库唯一约束错误
+- **THEN** SHALL 使用 errors.Is(err, gorm.ErrDuplicatedKey)
+- **THEN** SHALL NOT 使用字符串匹配 err.Error()
+
+#### Scenario: 网络错误判断
+
+- **WHEN** 判断网络错误
+- **THEN** SHALL 使用 errors.As(err, &net.Error) 判断网络错误
+- **THEN** SHALL 使用 errors.As(err, &net.OpError) 判断操作错误
+- **THEN** SHALL 使用 errors.Is(opErr.Err, syscall.ECONNRESET) 判断连接重置
+- **THEN** SHALL NOT 使用字符串匹配判断错误类型
+
+#### Scenario: 错误链判断
+
+- **WHEN** 判断错误链中的特定错误
+- **THEN** SHALL 使用 errors.Is 进行链式判断
+- **THEN** SHALL 使用 errors.As 提取特定类型错误
+
 ## ADDED Requirements
 
 ### Requirement: 定义 ConversionError 错误类型

openspec/specs/request-validation/spec.md

@@ -120,3 +120,29 @@
 - **WHEN** 处理请求
 - **THEN** SHALL 在 handler 函数开始时验证
 - **THEN** SHALL 在验证通过后才执行业务逻辑
+
+### Requirement: 使用标准库解析 JSON
+
+系统 SHALL 使用 encoding/json 标准库解析 JSON 请求。
+
+#### Scenario: 提取 model 字段
+
+- **WHEN** 从请求体提取 model 字段
+- **THEN** SHALL 使用 json.Unmarshal 解析到结构体
+- **THEN** SHALL NOT 手动扫描字节查找字段
+- **THEN** 解析失败 SHALL 返回空字符串（不报错）
+
+#### Scenario: 检测 stream 字段
+
+- **WHEN** 检测请求是否为流式请求
+- **THEN** SHALL 使用 json.Unmarshal 解析到结构体
+- **THEN** SHALL NOT 手动扫描字节查找字段
+- **THEN** 解析失败 SHALL 返回 false（非流式）
+
+#### Scenario: JSON 解析健壮性
+
+- **WHEN** 解析 JSON 请求体
+- **THEN** SHALL 正确处理转义字符
+- **THEN** SHALL 正确处理嵌套结构
+- **THEN** SHALL 正确处理 Unicode 字符
+- **THEN** 解析失败 SHALL 有明确的错误处理

openspec/specs/structured-logging/spec.md

@@ -20,6 +20,13 @@
 - **THEN** SHALL 支持嵌套字段
 - **THEN** SHALL 自动包含时间戳和日志级别
 
+#### Scenario: 日志注入
+
+- **WHEN** 创建需要记录日志的组件
+- **THEN** SHALL 通过构造函数注入 *zap.Logger
+- **THEN** SHALL 允许 logger 参数为 nil，此时使用全局 logger zap.L()
+- **THEN** SHALL NOT 直接使用全局 logger zap.L()（除非在构造函数默认值中）
+
 ### Requirement: 支持日志滚动
 
 系统 SHALL 支持日志文件滚动，使用 lumberjack。
@@ -122,3 +129,20 @@
 - **WHEN** 创建日志文件
 - **THEN** SHALL 使用 `nex-YYYY-MM-DD.log` 格式命名
 - **THEN** SHALL 按日期创建新文件
+
+### Requirement: ConversionEngine 日志注入
+
+ConversionEngine SHALL 通过依赖注入获取 logger。
+
+#### Scenario: ConversionEngine 构造函数
+
+- **WHEN** 创建 ConversionEngine 实例
+- **THEN** 构造函数 SHALL 接受 *zap.Logger 参数
+- **THEN** 参数为 nil 时 SHALL 使用 zap.L() 作为默认值
+- **THEN** SHALL 将 logger 存储在结构体字段中
+
+#### Scenario: ConversionEngine 日志使用
+
+- **WHEN** ConversionEngine 记录日志
+- **THEN** SHALL 使用注入的 logger 字段
+- **THEN** SHALL NOT 直接调用 zap.L()