docs(api): add endpoint file headers

functions/api/channels.js

@@ -1,4 +1,7 @@
-// 获取上传渠道列表 API
+/**
+ * 上传渠道列表 API
+ * 负责在鉴权后返回当前可用或全部上传渠道的名称与类型
+ */
 import { fetchUploadConfig } from '../utils/sysConfig.js';
 import { getUploadConfig } from './manage/sysConfig/upload.js';
 import { getDatabase } from '../utils/databaseAdapter.js';

functions/api/fetchRes.js

@@ -1,3 +1,7 @@
+/**
+ * 远程资源代理读取 API
+ * 负责在鉴权后拉取请求体中指定 URL 的资源并透传响应内容
+ */
 import { dualAuthCheck } from '../utils/auth/dualAuth.js';
 
 export async function onRequest(context) {
@@ -31,4 +35,4 @@ export async function onRequest(context) {
     return new Response(response.body, {
         headers: headers
     })
-}
+}

functions/api/public/list.js

@@ -1,3 +1,7 @@
+/**
+ * 公开文件列表 API
+ * 负责按公开浏览配置返回可访问文件和目录列表，并维护列表缓存
+ */
 import { fetchOthersConfig } from "../../utils/sysConfig";
 import { readIndex } from '../../utils/indexManager.js';
 

functions/api/userConfig.js

@@ -1,3 +1,7 @@
+/**
+ * 用户端页面配置 API
+ * 负责读取页面配置并转换为前端可直接使用的用户配置对象
+ */
 import { fetchPageConfig } from "../utils/sysConfig";
 
 export async function onRequest(context) {