解析Markdown文件的YAML元数据 :param file_path: markdown文件路径 :return: 元数据字典

拆分 `中文---English` 形式的文本

创建一个季度的所有图表并添加到对应的标签页 Args: data (list): 原始数据列表 start (int): 起始索引 end (int): 结束索引 bar_tab (Tab): 柱状图标签页对

替换 front matter 中的单行字段，并尽量保留原始引号风格

将解析后的markdown内容转换为格式化的字符串 :param contents: 包含标题和子标题的字典 :return: 格式化后的字符串，每个标题下的列表项使用圆圈数字标记

为生成的 HTML 文件添加自定义样式 Args: html_file (str): HTML 文件路径

提取周刊标题冒号后的主题部分

读取并解析markdown文件，返回内容二级标题及其子标题 :param file_path: markdown文件路径 :return: 字典，key为二级标题，value为其下的子标题列表 注：只返回包含子标题的部分

写入摘要文件的内容 :param f: 文件对象 :param content_meta: 元数据字典 :param md_body: 正文内容 :param weekly_no: 期号 :param source_file: 源文件路径，用于复制元

将中文统计描述转换为英文描述

基于 `中文---English` 主标题约定构造英文周刊标题

从文件内容中提取期号 :param file_path: 周刊文件路径 :return: 期号字符串

过滤停用词 Args: words (list): 词列表 stopwords (set): 停用词集合 Returns: list: 过滤后的词列表

处理周刊的主函数 :param pub_date: 可选的发布日期，默认为当天 处理流程： 1. 拆分中英文版本（英文版自动保存到tmp目录，中文版覆盖原文件） 2. 统计中文版字数并更新 3. 复制中文版到项目归档目录 4. 生成中文版摘要

更新单个README文件 :param readme_file: README文件路径 :param description: 描述 :param section_start: 往期列表部分的开始标记（如 "## 🦄往期列表"） :param entry_f

更新单个README文件中的统计数据

生成两个版本的摘要文件： 1. 博客版本：使用完整版的元数据，但内容是摘要 2. Github版本：仅保留title和pubDate元数据，内容是摘要 :param weekly_no: 期号 :param content_meta: 元数据字典 :

根据期数查找对应日期。

扫描 docs/ 下所有周刊文件，返回 [(date_str, issue_no), ...] 按日期升序。

去掉 Astro 专用 frontmatter 字段，只保留 title 和 pubDate。

复制中文完整版到项目归档目录 :param source_file: 源文件路径 :param pub_date: 发布日期 :param weekly_no: 期号

统计markdown文件的字数 :param file_path: 文件路径 :return: 字数统计 注：不包括链接URL和元数据部分

创建堆叠柱状图，展示每期周刊的内容分布 Args: issue_nos (list): 期号列表 articles (list): 文章数量列表 projects (list): 项目数量列表 audio_v

创建饼图，展示一个季度内容的整体分布 Args: articles (list): 文章数量列表 projects (list): 项目数量列表 audio_video (list): 音视频数量列表 hot

创建词云图组件，展示一个季度的关键词分布 Args: tab_name (str): 标签页名称，用于确定加载哪个词云图 Returns: Image: pyecharts Image 组件对象

创建词云图片 Args: file_path (str): Markdown 文件路径 season_no (int): 季度编号

公开处理 N-50 期：将归档全文替换正式目录的简化版。 检查 docs/tmp/ 中是否有第 N-50 期的全文版，若有则： 1. 中文：提取全文，去掉 Astro 专用 frontmatter，覆盖 docs/ 2. 英文：若 docs/en/tmp/ 有全文，覆盖 d

从单个周刊文件中提取内容 Args: file_path (str): 周刊文件的路径 Returns: list: 提取并格式化后的内容列表，包含标题、原文链接和分类内容

从 markdown 文件中提取条目并按类别整理。 参数说明： filename (str): 输入的 markdown 文件路径 output_file (str): 整理后的输出文件保存路径 处理流程：

从文件内容中提取期号和标题 Args: lines (list): 文件内容的行列表 Returns: str: 格式化后的标题，如果未找到则返回None

默认文件第二行为标题，解析期数

异步获取周刊本周发布的标题和链接

组装完整的Telegram消息 :param weekly_no: 期号 :param content_body: 正文内容 :return: 完整的消息文本

读取模板文件，填充元数据和翻译的正文，删除模板中多余的内容

从数据库获取各类别的总数统计

解析正文内容，拆分进行翻译，返回翻译后的结构化信息

处理特殊词组，如版本号、专有名词等 Args: text (str): 输入文本 Returns: list: 特殊词组列表

判断文件名中的日期是否在指定的日期范围内 Args: filename (str): 文件名，格式应为'YYYY-MM-DD-weekly.md' start_date (datetime): 起始日期 end_date (

主函数：生成每季度的词云图

主函数：执行数据查询、图表生成和HTML渲染的完整流程

解析markdown文件，返回正文内容的二级标题及其子条目 :param file_content: md文件内容 :return: 结构化的字典

解析markdown文件，返回内容二级标题及其子标题 :param file_content: md文件内容 :return: 内容摘要的字典

解析markdown文件内容，提取二级标题和其下的列表项 :param file_content: markdown文件内容 :return: 字典，key为二级标题，value为其下的列表项

将数据库查询结果转换为图表所需的数据格式 Args: data (list): 原始数据列表 start (int): 起始索引 end (int): 结束索引 Returns: tuple

处理指定目录下的所有周刊文件，将符合日期范围的文件内容合并 Args: directory (str): 要处理的目录路径 season (tuple): 包含开始和结束日期的元组 (start_date, end_date)

处理文章的各个分类部分（如文章&教程、项目&资源等） Args: lines (list): 文件内容的行列表 header_regex (Pattern): 用于匹配分类标题的正则表达式 Returns:

从数据库查询周刊内容统计数据 Returns: list: 包含期号和各类内容数量的元组列表

读取 Markdown 文件并统计词频 Args: markdown_file_path (str): Markdown 文件路径 Returns: list: 词频统计结果，格式为 [(词, 频次), ...]

生成最终的 HTML 页面，整合所有图表 Args: bar_tab_html (str): 柱状图 HTML 文件路径 pie_tab_html (str): 饼图 HTML 文件路径 wc_tab_html (str):

发送消息到Telegram频道 :param bot_token: Telegram机器人token :param chat_id: 目标频道ID :param text: 消息文本 :param image_path: 可选的图片路径

分离文本中的中文和英文 Args: text (str): 输入文本 Returns: tuple: (中文文本列表, 英文文本列表)

返回Telegram频道信息 :return: 频道信息文本

返回Telegram消息的页脚部分 :return: 订阅信息文本

生成Telegram消息的标题部分 :param no: 期号 :return: 格式化的标题字符串

异步组装每期周刊要发布的内容

分拆源文件的中英文标题，生成两份文件 :param input_file: 输入文件路径（中英双语版） :param tmp_en_file: 输出文件路径（英文版） 注：中文版会覆盖原始输入文件

更新landing page的统计数据JSON文件

更新README文件，在往期列表部分添加新的周刊链接 :param weekly_no: 期号 :param zh_weekly_file: 中文周刊路径 :param zh_content_meta: 中文元数据 :param en_weekly_file

更新README文件中的统计数据，支持中英文两个文件

更新文件中的字数统计 :param file_path: 文件路径 :param word_count: 字数统计结果

将处理后的内容写入新的Markdown文件 Args: new_content (list): 要写入的内容列表 output_file_name (str): 输出文件名

生成英文版摘要文件，用于发布到Medium、Dev.to等英文博客平台 :param weekly_no: 期号 :param pub_date: 发布日期 :param en_weekly_file: 英文周刊文件路径