docs: 文档模块接口字段确认

- 更新 API 接口联调日志
  - 文档模块接口状态从"初稿"更新为"待联调"
  - weekHotAPI（本周热门资料）：字段已确认
  - fileListAPI（文档列表）：字段已确认，修正接口路径为 `/srv/?a=file&t=file_list`
  - 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
- 更新 CHANGELOG 记录本次文档更新
- 更新接口文档版本至 v2.4

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

@@ -5,6 +5,30 @@
 
 
 ---
 ---
 
 
+## [2026-02-04] - 文档模块接口字段确认
+
+### 文档
+- 更新 API 接口联调日志（`docs/api-integration-log.md`）
+  - 文档模块接口状态更新：从"初稿"更新为"待联调"
+  - weekHotAPI（本周热门资料）：字段已确认，更新接口文档
+  - fileListAPI（文档列表）：字段已确认，更新接口文档，修正接口路径
+  - 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
+- 更新接口文档版本至 v2.4
+
+---
+
+**详细信息**：
+- **影响文件**:
+  - `docs/api-integration-log.md` - API 联调日志更新
+  - `src/api/file.js` - 接口文档 JSDoc 注释已更新
+- **技术栈**: 文档
+- **测试状态**: ✅ 文档已更新，待联调
+- **备注**:
+  - 文档模块的两个接口字段已确认，可以开始前端集成和联调工作
+  - fileListAPI 接口路径修正为 `/srv/?a=file&t=file_list`
+
+---
+
 ## [2026-02-04] - 知识库页面新增搜索功能
 ## [2026-02-04] - 知识库页面新增搜索功能
 
 
 ### 新增
 ### 新增

@@ -8,26 +8,15 @@
 - **已完成**: 12 (46.2%)
 - **已完成**: 12 (46.2%)
 - **联调中**: 0 (0%)
 - **联调中**: 0 (0%)
 - **已废弃**: 3 (11.5%)
 - **已废弃**: 3 (11.5%)
-- **待联调**: 9 (34.6%)
-- **初稿（字段未确定）**: 2 (7.7%)
+- **待联调**: 11 (42.3%)
 - **有阻塞**: 0
 - **有阻塞**: 0
 
 
 ---
 ---
 
 
 **📝 最近更新** (2026-02-04):
 **📝 最近更新** (2026-02-04):
-- 🔧 **优化 OpenAPI 文档生成工具**：
-  - 添加 CLAUDE.md 文件过滤，避免将文档文件当作 API 文档处理
-  - 改进新增模块检测逻辑，显示新增模块包含的所有接口
-  - 优化变更检测报告，提升可读性
-  - 修复接口信息显示为 undefined 的问题
-- 🗑️ **清理 Apifox API 依赖**：
-  - 删除不再工作的 Apifox API 相关脚本（apifox-to-openapi.js、apifox-sync.js 等）
-  - 删除 .env.apifox 配置文件
-  - 更新 package.json，移除 api:sync 和 api:test 命令
-  - 创建 API_GUIDE.md 使用指南，明确手动维护 OpenAPI 文档的工作流
-- 📝 **新增文档模块接口（初稿）**：
-  - weekHotAPI（本周热门资料）：字段未最终确定，待联调确认
-  - fileListAPI（文档列表）：字段未最终确定，待联调确认
+- 📝 **文档模块接口字段确认**：
+  - weekHotAPI（本周热门资料）：字段已确认，更新接口文档，待联调
+  - fileListAPI（文档列表）：字段已确认，更新接口文档，待联调
 - ✅ **收藏模块后端完成**：3 个收藏接口（addAPI、delAPI、listAPI）后端已开发完成，前端待联调
 - ✅ **收藏模块后端完成**：3 个收藏接口（addAPI、delAPI、listAPI）后端已开发完成，前端待联调
 - ✅ **埋点接口后端完成**：埋点接口（addAPI）后端已开发完成，前端待联调
 - ✅ **埋点接口后端完成**：埋点接口（addAPI）后端已开发完成，前端待联调
 - ✅ **产品模块联调完成**：产品列表接口（listAPI）联调成功
 - ✅ **产品模块联调完成**：产品列表接口（listAPI）联调成功
@@ -830,7 +819,7 @@
 
 
 ### 文档模块
 ### 文档模块
 
 
-#### 接口 1: 本周热门资料（初稿）
+#### 接口 1: 本周热门资料
 
 
 **接口信息**
 **接口信息**
 - **接口名称**: `weekHotAPI`
 - **接口名称**: `weekHotAPI`
@@ -843,22 +832,22 @@
 
 
 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
 |------|------|---------|---------|---------|
 |------|------|---------|---------|---------|
+| 2026-02-04 | v1.0 | 字段确认，更新接口文档 | 后端确认字段结构 | [查看](docs/api-specs/file/week_hot.md) |
 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/file/week_hot.md) |
 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/file/week_hot.md) |
 
 
 **页面调试情况**
 **页面调试情况**
 
 
 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
 |------|---------|---------|---------|------|
 |------|---------|---------|---------|------|
-| 2026-02-04 | - | 后端字段未确定 | 待后端确认后更新 | ⏳ 待联调 |
+| 2026-02-04 | - | 后端字段已确认 | 待前端集成联调 | ⏳ 待联调 |
 
 
-**接口状态**: ⏳ 初稿 - 后端字段未确定
+**接口状态**: ⏳ 待联调
 
 
 **备注**:
 **备注**:
-- ⚠️ **初稿状态**：当前接口文档为初稿，后端字段可能还有调整
 - **参数**：
 - **参数**：
   - `page`: 页码，从 0 开始
   - `page`: 页码，从 0 开始
   - `limit`: 每页数量
   - `limit`: 每页数量
-- **预期返回数据结构**：
+- **返回数据结构**：
   ```javascript
   ```javascript
   {
   {
     code: 1,
     code: 1,
@@ -876,16 +865,16 @@
     }
     }
   }
   }
   ```
   ```
-- **字段确认状态**：待后端确认最终字段结构
+- **字段确认状态**：✅ 字段已确认
 - 实现位置：`src/api/file.js:weekHotAPI`
 - 实现位置：`src/api/file.js:weekHotAPI`
 
 
 ---
 ---
 
 
-#### 接口 2: 文档列表（初稿）
+#### 接口 2: 文档列表
 
 
 **接口信息**
 **接口信息**
 - **接口名称**: `fileListAPI`
 - **接口名称**: `fileListAPI`
-- **接口路径**: `/srv/?a=get_file_list&t=file_list`
+- **接口路径**: `/srv/?a=file&t=file_list`
 - **请求方法**: GET
 - **请求方法**: GET
 - **负责页面**: 待确认
 - **负责页面**: 待确认
 - **负责人**: 后端团队
 - **负责人**: 后端团队
@@ -894,52 +883,62 @@
 
 
 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
 | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
 |------|------|---------|---------|---------|
 |------|------|---------|---------|---------|
+| 2026-02-04 | v1.0 | 字段确认，更新接口文档 | 后端确认字段结构 | [查看](docs/api-specs/file/file_list.md) |
 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/get_file_list/file_list.md) |
 | 2026-02-04 | v0.1 | 初稿版本 | 后端字段未确定，待联调确认 | [查看](docs/api-specs/get_file_list/file_list.md) |
 
 
 **页面调试情况**
 **页面调试情况**
 
 
 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
 | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
 |------|---------|---------|---------|------|
 |------|---------|---------|---------|------|
-| 2026-02-04 | - | 后端字段未确定 | 待后端确认后更新 | ⏳ 待联调 |
+| 2026-02-04 | - | 后端字段已确认 | 待前端集成联调 | ⏳ 待联调 |
 
 
-**接口状态**: ⏳ 初稿 - 后端字段未确定
+**接口状态**: ⏳ 待联调
 
 
 **备注**:
 **备注**:
-- ⚠️ **初稿状态**：当前接口文档为初稿，后端字段可能还有调整
 - **参数**：
 - **参数**：
   - `client_id`: 主体 ID（可选）
   - `client_id`: 主体 ID（可选）
   - `cid`: 分类 ID（可选）
   - `cid`: 分类 ID（可选）
   - `page`: 页码（从 0 开始）
   - `page`: 页码（从 0 开始）
   - `limit`: 每页数量
   - `limit`: 每页数量
-- **预期返回数据结构**：
+- **返回数据结构**：
   ```javascript
   ```javascript
   {
   {
     code: 1,
     code: 1,
     data: {
     data: {
-      categories: [
-        { id: 2769851, name: "分类名称" }
+      cate: {
+        id: 2769851,              // 分类id
+        category_name: "分类名称", // 分类名称
+        category_parent: 0,        // 分类父级
+        icon: "https://..."        // 分类图标
+      },
+      children: [
+        {
+          id: 2769852,              // 二级分类id
+          category_name: "二级分类名",
+          category_parent: 2769851, // 二级分类父级id
+          icon: "https://...",     // 二级分类图标
+          list: [...],             // 二级分类的附件列表
+          children: [...]          // 三级分类
+        }
       ],
       ],
       list: [
       list: [
         {
         {
-          id: 2769856,                    // 产品id
-          product_name: "产品名称",        // 产品名
-          recommend: "hot",                // 推荐位: normal-普通, hot-热卖
-          form_sn: "customize_jsj_pnzuky", // 产品编号
-          created_time: "2026-02-03 10:36:29",
-          categories: [                    // 产品所属分类
-            { id: "2769851", name: "分类名称" }
-          ],
-          tags: [                          // 产品标签
-            { id: "2769847", name: "标签名", bg_color: "#3e5160", text_color: "#ffffff" }
-          ]
+          name: "附件名称",         // 附件名称
+          value: "https://...",    // 附件地址
+          extension: "pdf",        // 后缀名
+          post_date: "2026-02-04", // 发布时间
+          size: "2.5MB",           // 附件大小
+          id: "12345"              // 附件id
         }
         }
       ],
       ],
-      total: 3                           // 产品总数
+      total: 100,                 // 主分类附件数量
+      max_level: "3"              // 层级
     }
     }
   }
   }
   ```
   ```
-- **字段确认状态**：待后端确认最终字段结构
-- 实现位置：`src/api/get_file_list.js:fileListAPI`
+- **字段确认状态**：✅ 字段已确认
+- **接口路径更正**：`/srv/?a=file&t=file_list`（之前错误为 `/srv/?a=get_file_list&t=file_list`）
+- 实现位置：`src/api/file.js:fileListAPI`
 
 
 ---
 ---
 
 
@@ -1063,7 +1062,7 @@
 - [❌ 已废弃](#通用模块) - 3个接口
 - [❌ 已废弃](#通用模块) - 3个接口
 - [⏳ 待联调](#收藏模块) - 3个接口
 - [⏳ 待联调](#收藏模块) - 3个接口
 - [⏳ 待联调](#埋点模块) - 1个接口
 - [⏳ 待联调](#埋点模块) - 1个接口
-- [⏳ 初稿 - 字段未确定](#文档模块) - 2个接口
+- [⏳ 待联调](#文档模块) - 2个接口
 - [⏳ 后端开发中](#消息模块) - 2个接口
 - [⏳ 后端开发中](#消息模块) - 2个接口
 
 
 ### 按模块查看
 ### 按模块查看
@@ -1073,7 +1072,7 @@
 - [产品](#产品模块) - ✅ 1个已完成
 - [产品](#产品模块) - ✅ 1个已完成
 - [收藏](#收藏模块) - ⏳ 3个待联调
 - [收藏](#收藏模块) - ⏳ 3个待联调
 - [埋点](#埋点模块) - ⏳ 1个待联调
 - [埋点](#埋点模块) - ⏳ 1个待联调
-- [文档](#文档模块) - ⏳ 2个初稿
+- [文档](#文档模块) - ⏳ 2个待联调
 - [消息](#消息模块) - ⏳ 2个后端开发中
 - [消息](#消息模块) - ⏳ 2个后端开发中
 - [知识库](#知识库模块) - ⏳ 未开始
 - [知识库](#知识库模块) - ⏳ 未开始
 - [家办](#家办模块) - ⏳ 未开始
 - [家办](#家办模块) - ⏳ 未开始
@@ -1111,20 +1110,14 @@
 
 
 ---
 ---
 
 
-**最后更新时间**: 2026-02-04 15:30
-**文档版本**: v2.3
+**最后更新时间**: 2026-02-04 18:00
+**文档版本**: v2.4
 **更新内容**:
 **更新内容**:
-- 📝 **新增文档模块接口（初稿）**：
-  - weekHotAPI（本周热门资料）：字段未最终确定
-  - fileListAPI（文档列表）：字段未最终确定
-- 🗑️ **移除 Apifox API 依赖**：
-  - 删除 apifox-to-openapi.js 等不再工作的脚本
-  - 更新 package.json，简化为 api:generate 单一命令
-  - 明确手动维护 OpenAPI 文档的工作流
-- 🔧 **API 生成工具优化**：
-  - 修复新增模块接口信息显示为 undefined 的问题
-  - 改进接口信息提取逻辑
-- 更新总体进度：26个接口（12个已完成，9个待联调，2个初稿，3个已废弃）
+- 📝 **文档模块接口字段确认**：
+  - weekHotAPI（本周热门资料）：字段已确认，更新接口文档
+  - fileListAPI（文档列表）：字段已确认，更新接口文档，修正接口路径
+- 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
+- 文档模块从"初稿"状态更新为"待联调"状态
 
 
 **历史版本**:
 **历史版本**:
 - v2.1 (2026-02-03 21:00): 产品模块联调完成
 - v2.1 (2026-02-03 21:00): 产品模块联调完成

 import { fn, fetch } from '@/api/fn';
 import { fn, fetch } from '@/api/fn';
 
 
 const Api = {
 const Api = {
+  FileList: '/srv/?a=file&t=file_list',
   WeekHot: '/srv/?a=file&t=week_hot',
   WeekHot: '/srv/?a=file&t=week_hot',
 }
 }
 
 
 /**
 /**
+ * @description 文档列表
+ * @remark 
+ * @param {Object} params 请求参数
+ * @param {string} params.client_id (可选) 主体id
+ * @param {string} params.limit (可选) 
+ * @param {string} params.page (可选) 
+ * @param {string} params.cid (可选) 分类id
+ * @returns {Promise<{
+ *   code: number; // 状态码
+ *   msg: string; // 消息
+ *   data: {
+ *     cate: {
+ *       id: integer; // 分类id
+ *       category_name: string; // 分类名称
+ *       category_parent: integer; // 分类父级
+ *       icon: string; // 
+ *     };
+ *     children: Array<{
+ *       id: integer; // 二级分类id
+ *       category_name: string; // 二级分类名
+ *       category_parent: integer; // 二级分类名父级id
+ *       icon: string; // 二级分类图标
+ *       list: array; // 二级分类的附件列表
+ *       children: array; // 三级分类
+ *     }>;
+ *     list: Array<{
+ *       name: string; // 附件名称
+ *       value: string; // 附件地址
+ *       extension: string; // 后缀名
+ *       post_date: string; // 发布时间
+ *       size: string; // 附件大小
+ *       id: string; // 附件id
+ *     }>;
+ *     total: integer; // 主分类附件数量
+ *     max_level: string; // 层级
+ *   };
+ * }>}
+ */
+export const fileListAPI = (params) => fn(fetch.get(Api.FileList, params));
+
+/**
  * @description 本周热门资料
  * @description 本周热门资料
  * @remark 
  * @remark 
  * @param {Object} params 请求参数
  * @param {Object} params 请求参数

-import { fn, fetch } from '@/api/fn';
-
-const Api = {
-  FileList: '/srv/?a=get_file_list&t=file_list',
-}
-
-/**
- * @description 文档列表
- * @remark 
- * @param {Object} params 请求参数
- * @param {string} params.client_id (可选) 主体id
- * @param {string} params.limit (可选) 
- * @param {string} params.page (可选) 
- * @param {string} params.cid (可选) 分类id
- * @returns {Promise<{
- *   code: number; // 状态码
- *   msg: string; // 消息
- *   data: {
- *     categories: Array<{
- *       id: integer; // 分类id
- *       name: string; // 分类名
- *     }>;
- *     list: Array<{
- *       id: integer; // 产品id
- *       product_name: string; // 产品名
- *       recommend: string; // 推荐位: normal-普通, hot-热卖
- *       form_sn: string; // 
- *       created_time: string; // 创建时间
- *       categories: array; // 产品所属分类
- *       tags: array; // 产品标签
- *     }>;
- *     total: integer; // 产品总数
- *   };
- * }>}
- */
-export const fileListAPI = (params) => fn(fetch.get(Api.FileList, params));