feat(api): 增强文章API功能并更新文档

- 为文章创建和更新接口添加 `publish_time` 字段支持
- 升级 Markdown 解析器以支持表格扩展
- 增加数据库字段默认值设置，避免严格模式错误
- 禁止客户端设置 `create_time` 和 `update_time` 字段
- 更新 API 文档以反映上述更改
- 将临时文件和工具目录添加到 .gitignore

app/api/controller/Articles.php

@@ -8,7 +8,10 @@ use app\BaseController;
 use app\model\Post;
 use app\model\PostCategory;
 use app\model\PostTag;
-use League\CommonMark\CommonMarkConverter;
+use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
+use League\CommonMark\Extension\Table\TableExtension;
+use League\CommonMark\MarkdownConverter;
 use think\Request;
 
 class Articles extends BaseController
@@ -95,6 +98,9 @@ class Articles extends BaseController
             unset($post_data['tags']);
         }
 
+        // 禁止客户端设置的时间字段
+        unset($post_data['create_time'], $post_data['update_time']);
+
         $post_data['uid'] = uniqid();
         $post_data['source'] = 'api';
         $post_data['create_time'] = time();
@@ -110,16 +116,46 @@ class Articles extends BaseController
             $post_data['content_type'] = 'html';
         }
 
+        // 校验 publish_time 格式（必须是 Y-m-d H:i:s）
+        if (isset($post_data['publish_time']) && !empty($post_data['publish_time'])) {
+            if (!preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $post_data['publish_time'])) {
+                return json_message('publish_time 格式错误，应为 Y-m-d H:i:s，如 2024-01-15 14:30:00');
+            }
+        }
+
         // content_type 白名单校验
         $allowed_content_types = ['html', 'markdown'];
         if (!in_array($post_data['content_type'], $allowed_content_types)) {
             return json_message('无效的content_type', 500);
         }
 
-        // Markdown→HTML 自动转换
+        // Markdown→HTML 自动转换（启用表格扩展）
         if ($post_data['content_type'] === 'markdown' && !empty($post_data['content'])) {
-            $converter = new CommonMarkConverter(['html_input' => 'strip', 'allow_unsafe_links' => false]);
-            $post_data['content_html'] = $converter->convert($post_data['content']);
+            $environment = Environment::createCommonMarkEnvironment();
+            $environment->addExtension(new TableExtension());
+            $converter = new MarkdownConverter($environment);
+            $post_data['content_html'] = $converter->convert($post_data['content'])->getContent();
+        }
+
+        // 提供字段默认值，避免数据库严格模式报错
+        $default_fields = [
+            'jump_to_btn_title' => '',
+            'jump_to_url' => '',
+            'jump_to_url_status' => 0,
+            'poster' => '',
+            'desc' => '',
+            'author_name' => '',
+            'hits' => 0,
+            'is_top' => 0,
+            'sort' => 0,
+            'files' => '',
+            'pictures' => '',
+            'tpl_name' => '',
+        ];
+        foreach ($default_fields as $field => $default) {
+            if (!isset($post_data[$field])) {
+                $post_data[$field] = $default;
+            }
         }
 
         $model_post = Post::create($post_data);
@@ -169,6 +205,16 @@ class Articles extends BaseController
         $post_data = $request->post();
         unset($post_data['id']);
 
+        // 禁止客户端设置的时间字段
+        unset($post_data['create_time'], $post_data['update_time']);
+
+        // 校验 publish_time 格式（必须是 Y-m-d H:i:s）
+        if (isset($post_data['publish_time']) && !empty($post_data['publish_time'])) {
+            if (!preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $post_data['publish_time'])) {
+                return json_message('publish_time 格式错误，应为 Y-m-d H:i:s，如 2024-01-15 14:30:00');
+            }
+        }
+
         // categorys diff update
         if (isset($post_data['categorys'])) {
             $categorys = $post_data['categorys'];
@@ -217,10 +263,33 @@ class Articles extends BaseController
             }
         }
 
-        // Markdown→HTML 自动转换
+        // Markdown→HTML 自动转换（启用表格扩展）
         if (isset($post_data['content_type']) && $post_data['content_type'] === 'markdown' && !empty($post_data['content'])) {
-            $converter = new CommonMarkConverter(['html_input' => 'strip', 'allow_unsafe_links' => false]);
-            $post_data['content_html'] = $converter->convert($post_data['content']);
+            $environment = Environment::createCommonMarkEnvironment();
+            $environment->addExtension(new TableExtension());
+            $converter = new MarkdownConverter($environment);
+            $post_data['content_html'] = $converter->convert($post_data['content'])->getContent();
+        }
+
+        // 提供字段默认值，避免数据库严格模式报错
+        $default_fields = [
+            'jump_to_btn_title' => '',
+            'jump_to_url' => '',
+            'jump_to_url_status' => 0,
+            'poster' => '',
+            'desc' => '',
+            'author_name' => '',
+            'hits' => 0,
+            'is_top' => 0,
+            'sort' => 0,
+            'files' => '',
+            'pictures' => '',
+            'tpl_name' => '',
+        ];
+        foreach ($default_fields as $field => $default) {
+            if (!isset($post_data[$field])) {
+                $post_data[$field] = $default;
+            }
         }
 
         $model_post->save($post_data);