Firestore数据管理工具

预设数据导入

以下是预设好的数据集合，点击相应按钮可一键导入数据

基础数据集合

汉字基础数据

集合: hanzi_data (100+ 文档)

包含汉字字符、拼音、含义、笔画数等基础信息

汉字集合

集合: character_sets (10+ 文档)

包含HSK等级、常用汉字等预定义字符集

游戏模式

集合: game_modes (8+ 文档)

应用中各种游戏模式的配置和描述

学习模块

集合: learning_modules (5+ 文档)

汉字学习模块的结构和内容

用户数据集合

用户账号

集合: users (5+ 文档)

用户基本账号信息和配置

用户设置

集合: user_settings (5+ 文档)

用户个性化设置和偏好

用户子集合数据

用户成就 (用户: zjsdn9)

集合: users/user_zjsdn9/achievements (15+ 文档)

用户获得的成就和奖励记录

用户字符学习 (用户: zjsdn9)

集合: user_characters/user_zjsdn9/shard0 (50+ 文档)

用户汉字学习进度和掌握情况

用户每日进度 (用户: zjsdn9)

集合: user_progress/user_zjsdn9/daily (30+ 文档)

用户每日学习活动和统计数据

一键全部导入

自定义数据导入

使用此功能可以导入任意路径的自定义JSON数据

提示: 可以使用此功能导入任意用户的动态路径数据，如 users/任意用户ID/achievements

汉字数据挖掘

本工具根据HSK级别收集汉字数据，并将其导入到Firestore数据库。

挖掘配置

HSK级别选择

HSK 1级

HSK 2级

HSK 3级

HSK 4级

HSK 5级

HSK 6级

汉字API URL 用于查询汉字详细信息的API地址

挖掘进度

准备就绪

挖掘结果

脚本源码

下面是当前汉字数据挖掘脚本的源码，可以用于调试和修改。

/**
 * 汉字数据挖掘API端点
 * 功能：调用外部API获取HSK分级汉字数据
 */

// HSK词汇列表URL
const HSK_URLS = {
  1: 'https://www.digmandarin.com/hsk-1-vocabulary-list',
  2: 'https://www.digmandarin.com/hsk-2-vocabulary-list',
  3: 'https://www.digmandarin.com/hsk-3-vocabulary-list',
  4: 'https://www.digmandarin.com/hsk-4-vocabulary-list',
  5: 'https://www.digmandarin.com/hsk-5-vocabulary-list',
  6: 'https://www.digmandarin.com/hsk-6-vocabulary-list'
};

// 默认汉字API
const DEFAULT_HANZI_API = 'https://api.hanzi.dict.cn/character/';

// 静态HSK数据 - 为了避免爬取网站而准备的备用数据
const STATIC_HSK_DATA = {
  1: {
    vocabulary: [
      { character: "我", pinyin: "wǒ", meaning: "I, me", level: 1 },
      { character: "你", pinyin: "nǐ", meaning: "you", level: 1 },
      { character: "好", pinyin: "hǎo", meaning: "good, well", level: 1 },
      { character: "人", pinyin: "rén", meaning: "person, people", level: 1 },
      { character: "是", pinyin: "shì", meaning: "to be", level: 1 }
    ],
    characters: ["我", "你", "好", "人", "是"]
  },
  // 其他级别的预定义数据可以在这里添加
};

export async function onRequest(context) {
  // 处理CORS预检请求
  if (context.request.method === 'OPTIONS') {
    return new Response(null, {
      headers: {
        'Access-Control-Allow-Origin': '*',
        'Access-Control-Allow-Methods': 'POST, OPTIONS',
        'Access-Control-Allow-Headers': 'Content-Type, Authorization',
      },
      status: 204,
    });
  }

  // 检查认证
  const authHeader = context.request.headers.get('Authorization');
  if (!authHeader || !authHeader.startsWith('Bearer ')) {
    return new Response(JSON.stringify({ error: '未授权访问' }), {
      status: 401,
      headers: {
        'Content-Type': 'application/json',
        'Access-Control-Allow-Origin': '*',
      },
    });
  }

  // 只允许POST请求
  if (context.request.method !== 'POST') {
    return new Response(JSON.stringify({ error: '只接受POST请求' }), {
      status: 405,
      headers: {
        'Content-Type': 'application/json',
        'Access-Control-Allow-Origin': '*',
      },
    });
  }

  try {
    // 解析请求参数
    const requestData = await context.request.json();
    const { action, level, apiUrl = DEFAULT_HANZI_API, character } = requestData;

    let responseData;

    // 根据请求操作执行不同功能
    if (action === 'getHskVocabulary') {
      if (!level || !HSK_URLS[level]) {
        throw new Error('无效的HSK级别');
      }
      // 使用静态数据而不是爬取网站，以避免部署问题
      responseData = getStaticHskData(level);
    } 
    else if (action === 'getCharacterDetails') {
      if (!character) {
        throw new Error('缺少汉字参数');
      }
      responseData = await getCharacterDetails(character, apiUrl);
    }
    else {
      throw new Error('未知操作类型');
    }

    // 返回成功响应
    return new Response(JSON.stringify(responseData), {
      headers: {
        'Content-Type': 'application/json',
        'Access-Control-Allow-Origin': '*',
      },
    });
  } catch (error) {
    console.error('汉字挖掘API错误:', error);
    
    // 返回错误响应
    return new Response(JSON.stringify({ 
      error: error.message || '处理请求时发生错误',
      stack: error.stack
    }), {
      status: 500,
      headers: {
        'Content-Type': 'application/json',
        'Access-Control-Allow-Origin': '*',
      },
    });
  }
}

/**
 * 获取静态HSK数据
 * @param {number} level HSK级别(1-6)
 * @returns {Object} 词汇数据和统计信息
 */
function getStaticHskData(level) {
  // 如果有预定义的静态数据则返回
  if (STATIC_HSK_DATA[level]) {
    const data = STATIC_HSK_DATA[level];
    return {
      vocabulary: data.vocabulary || [],
      characters: data.characters || [],
      stats: {
        vocabularyCount: data.vocabulary ? data.vocabulary.length : 0,
        characterCount: data.characters ? data.characters.length : 0,
        level
      }
    };
  }
  
  // 如果没有预定义数据，则生成一些示例数据
  // 这是一个备用方案，实际生产环境中应该有完整的静态数据
  const mockVocabulary = [
    { character: "示例", pinyin: "shì lì", meaning: "example", level },
    { character: "汉字", pinyin: "hàn zì", meaning: "Chinese character", level },
    { character: "学习", pinyin: "xué xí", meaning: "to study", level }
  ];
  
  const mockCharacters = ["示", "例", "汉", "字", "学", "习"];
  
  return {
    vocabulary: mockVocabulary,
    characters: mockCharacters,
    stats: {
      vocabularyCount: mockVocabulary.length,
      characterCount: mockCharacters.length,
      level
    }
  };
}

/**
 * 获取汉字详细信息
 * @param {string} character 汉字
 * @param {string} apiUrl API地址
 * @returns {Promise<Object>} 汉字详细信息
 */
async function getCharacterDetails(character, apiUrl) {
  try {
    const response = await fetch(`${apiUrl}${encodeURIComponent(character)}`);
    
    if (!response.ok) {
      throw new Error(`API请求失败: ${response.status} ${response.statusText}`);
    }
    
    const data = await response.json();
    
    // 根据API返回的数据结构提取必要信息
    // 这里假设一个通用结构，实际使用时可能需要根据具体API调整
    return {
      character,
      strokes: data.stroke_count || data.strokes || 0,
      radical: data.radical || '',
      pinyin: data.pinyin || data.readings?.pinyin || '',
      meaning: data.definition || data.english || '',
      frequency: data.frequency || 0
    };
  } catch (error) {
    console.error(`获取汉字 ${character} 详细信息失败`, error);
    
    // 如果API调用失败，返回一些基本信息
    return {
      character,
      strokes: 0,
      radical: '',
      pinyin: '',
      meaning: '(API获取失败)',
      frequency: 0,
      error: error.message
    };
  }
}

注意：脚本更新后需要重新部署才能生效

HanziBlocks 数据管理工具

数据导入工具

集合路径变量工具