文档审查员 AI 智能体

/**
 * 通过 ID 获取用户
 * @param id - 用户 ID
 * @param includeDeleted - 包括软删除的用户
 */
async function getUser(id: string, options?: GetUserOptions) {
  // includeDeleted 3 个月前移到了 options 对象
  // 但 JSDoc 仍显示旧签名
}

JSDoc 显示带位置参数的旧签名

/**
 * 通过 ID 获取用户
 * @param id - 用户 ID
 * @param options - 查询选项
 * @param options.includeDeleted - 包括软删除的用户
 * @param options.fields - 要选择的字段
 */
async function getUser(id: string, options?: GetUserOptions) {
  // 文档与实际签名匹配
}

已更新以匹配当前的 options 对象模式

// 指数退避重试 3 次
async function fetchWithRetry(url: string) {
  const MAX_RETRIES = 5  // 从 3 改为 5
  const response = await fetch(url)
  // 实际上不再实现重试逻辑
  return response
}

注释描述的重试逻辑并不存在

// 简单的 fetch 包装器，无重试逻辑
// 如需重试，使用 @/lib/http 中的 fetchWithRetry
async function simpleFetch(url: string) {
  const response = await fetch(url)
  return response
}

注释反映实际行为

## 安装
```bash
npm install
npm run setup  # 此脚本已被删除
```

## 环境变量
- `DATABASE_URL` - PostgreSQL 连接
- `REDIS_URL` - Redis 连接  # 我们已改用内存缓存

README 引用了已删除的脚本和旧的 Redis 配置

## 安装
```bash
npm install
```

## 环境变量
- `DATABASE_URL` - PostgreSQL 连接字符串
- `CACHE_TTL` - 缓存持续时间（秒）（默认：3600）

文档反映当前的设置流程