feat: 补充注释

server/api/images/history/[id].delete.ts

@@ -1,3 +1,4 @@
+// server/api/images/history/[id].delete.ts - 生图历史删除接口：软删除当前用户的单条记录。
 import {
   clearNewApiAuthCookies,
   createApiLogger,
@@ -10,6 +11,15 @@ import {
   toSafeLogError
 } from "~~/server/utils";
 
+/**
+ * DELETE /api/images/history/:id
+ *
+ * 流程：
+ * 1. 从 httpOnly cookie 读取当前用户 ID。
+ * 2. 校验路由参数 id 必须是数字。
+ * 3. 只软删除当前用户且未删除的记录，避免越权删除其他用户历史。
+ * 4. 找不到记录时返回 404，数据库中保留原始记录和 deletedAt。
+ */
 export default defineEventHandler(async (event) => {
   const logger = createApiLogger("images.history.delete");
   logger.info("开始");
@@ -55,6 +65,7 @@ export default defineEventHandler(async (event) => {
   }
 });
 
+/** 校验并解析路由里的生图记录 ID */
 const parseRecordId = (value: string | undefined): bigint => {
   if (!value || !/^\d+$/.test(value)) {
     throw createError({