def method(param: str) -> str:
    """
    方法说明
    
    Args:
        param: 参数说明
        
    Returns:
        返回值说明
    """
    # 实现逻辑
    return result

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Markdown 格式检查脚本
"""

import os
import re
from pathlib import Path

def check_front_matter(content, filepath):
    """检查 Front Matter 格式"""
    errors = []
    
    # 检查 Front Matter 是否存在
    if not content.startswith('---'):
        errors.append(f"{filepath}: 缺少 Front Matter")
        return errors
    
    # 提取 Front Matter
    fm_match = re.match(r'^---\n(.*?)\n---\n', content, re.DOTALL)
    if not fm_match:
        errors.append(f"{filepath}: Front Matter 格式错误")
        return errors
    
    fm_content = fm_match.group(1)
    
    # 检查必需字段
    required_fields = ['title', 'date', 'categories']
    for field in required_fields:
        if field not in fm_content:
            errors.append(f"{filepath}: 缺少必需字段 {field}")
    
    # 检查 date 格式
    date_match = re.search(r'date:\s*(\d{4}-\d{2}-\d{2}[\s\d:+-]*)', fm_content)
    if date_match:
        date_value = date_match.group(1).strip()
        if not re.match(r'\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} \+0800', date_value):
            errors.append(f"{filepath}: date 格式错误，应为 YYYY-MM-DD HH:mm:ss +0800")
    
    # 检查 categories 格式（应为数组）
    if 'categories:' in fm_content:
        if re.search(r'categories:\s*\n\s*-', fm_content):
            errors.append(f"{filepath}: categories 应使用数组格式 [分类]")
    
    # 检查 tags 格式（应为数组）
    if 'tags:' in fm_content:
        if re.search(r'tags:\s*\n\s*-', fm_content):
            errors.append(f"{filepath}: tags 应使用数组格式 [tag1, tag2]")
    
    return errors

def check_code_blocks(content, filepath):
    """检查代码块格式"""
    errors = []
    
    # 查找所有代码块
    code_block_pattern = r'```(\w+)?\n'
    matches = re.finditer(code_block_pattern, content)
    
    for match in matches:
        lang = match.group(1)
        if not lang:
            line_num = content[:match.start()].count('\n') + 1
            errors.append(f"{filepath}: 第 {line_num} 行代码块缺少语言标识")
    
    return errors

def check_file_naming(filepath):
    """检查文件名格式"""
    errors = []
    filename = Path(filepath).name
    
    # 检查文件名格式
    if not re.match(r'\d{4}-\d{2}-\d{2}-[a-z0-9-]+\.md', filename):
        errors.append(f"{filepath}: 文件名格式错误，应为 YYYY-MM-DD-kebab-title.md")
    
    return errors

def check_all_files(directory):
    """检查目录下所有 Markdown 文件"""
    all_errors = []
    
    for md_file in Path(directory).rglob("*.md"):
        if md_file.name == "README.md":
            continue
        
        print(f"检查: {md_file}")
        
        with open(md_file, 'r', encoding='utf-8') as f:
            content = f.read()
        
        # 检查各项
        all_errors.extend(check_file_naming(str(md_file)))
        all_errors.extend(check_front_matter(content, str(md_file)))
        all_errors.extend(check_code_blocks(content, str(md_file)))
    
    return all_errors

if __name__ == "__main__":
    base_dir = "/Users/anshengyo/WorkSpace/leahana.github.io/source/_posts"
    print(f"开始检查目录: {base_dir}\n")
    
    errors = check_all_files(base_dir)
    
    if errors:
        print("\n❌ 发现以下格式错误：")
        for error in errors:
            print(f"  - {error}")
        exit(1)
    else:
        print("\n✅ 所有文件格式检查通过！")
        exit(0)