feat: 补充注释

server/utils/logging.ts

@@ -1,8 +1,10 @@
+// server/utils/logging.ts - API 调试日志工具：为每次请求生成 requestId 并输出安全错误摘要。
 import { randomUUID } from "node:crypto";
 import { consola } from "consola";
 
 type LogMeta = Record<string, unknown>;
 
+/** 创建带 requestId、scope 和耗时统计的接口日志器 */
 export const createApiLogger = (scope: string) => {
   const requestId = randomUUID();
   const startedAt = Date.now();
@@ -36,6 +38,7 @@ export const createApiLogger = (scope: string) => {
   };
 };
 
+/** 将未知错误转换为可写入日志的安全摘要，避免把 cookie/key 等响应体细节打进日志 */
 export const toSafeLogError = (error: unknown) => {
   const maybeError = error as {
     message?: string;