qwtag：基于 AI 的智能标签管理系统设计与实现

/**
 * 智能标签生成的核心流程
 */
async generateTags(title: string, content: string): Promise<TagResponse> {
  // 1. 构建多维度分析提示词
  const prompt = this.buildPrompt(title, content)
  
  // 2. 调用 AI 进行语义分析
  const completion = await this.client.chat.completions.create({
    model: 'qwen3-235b-a22b-instruct-2507',
    messages: [
      { role: 'system', content: '你是一个专业的技术标签分析师。' },
      { role: 'user', content: prompt }
    ],
    temperature: 0.3,  // 低随机性确保结果稳定
    max_tokens: 1000
  })
  
  // 3. 解析并标准化标签数据
  return this.parseResponse(completion.choices[0].message.content)
}

/**
 * 标签处理流水线
 */
private parseResponse(response: string): TagResponse {
  const validTags = data.tags
    .map((tag: string) => {
      const normalized = tag.toLowerCase().trim()  // 标准化格式
      
      // 1. 别名映射 (js -> javascript, cpp -> cpp)
      if (this.aliases[normalized]) {
        return this.aliases[normalized]
      }
      
      // 2. 标签池匹配
      if (this.coreTags.includes(normalized)) {
        return normalized
      }
      
      // 3. 新标签记录和扩展
      newTags.push(normalized)
      return normalized
    })
    .filter((tag: string) => tag.length > 0)  // 过滤空标签
    .slice(0, 5)  // 严格控制为5个标签
    
  return { tags: validTags, reasoning, analysis }
}

# 为新文档生成标签 - 保护现有标签
qwtag tag content/new-article.md
 
# 重新生成现有文档标签 - 完全重新分析
qwtag retag content/existing-article.md

// 检查现有标签 - 避免意外覆盖用户手动设置的标签
if (parsed.data.tags && parsed.data.tags.length > 0) {
  console.log(`⚠️  文档已有标签: ${parsed.data.tags.join(', ')}`)
  console.log(`💡 使用 'retag' 命令重新生成标签`)
  return
}

✅ 已添加标签: cpp, memory-management, raii, smart-pointers, modern-cpp
🔍 内容分析: 文章深入探讨了现代C++中的RAII设计理念...
💭 推荐理由: 选择cpp和modern-cpp体现核心技术栈...

{
  "core_tags": [
    // 编程语言类
    "cpp", "javascript", "python", "rust", "go",
    // 框架技术类  
    "react", "vue", "spring", "django", "express",
    // 系统架构类
    "microservices", "kubernetes", "docker", "aws",
    // 计算机科学类
    "algorithms", "data-structures", "machine-learning"
  ],
  "aliases": {
    "js": "javascript",
    "ts": "typescript", 
    "c++": "cpp",
    "k8s": "kubernetes"
  }
}

/**
 * 增量学习机制 - 将新标签添加到标签池
 */
private addNewTagsToPool(newTags: string[]): void {
  try {
    const tagsData = JSON.parse(readFileSync(tagsFilePath, 'utf-8'))
    
    let hasChanges = false
    for (const tag of newTags) {
      if (!tagsData.core_tags.includes(tag)) {
        tagsData.core_tags.push(tag)
        hasChanges = true
        console.log(`📝 新标签已加入标签池: ${tag}`)
      }
    }
    
    if (hasChanges) {
      tagsData.core_tags.sort()  // 保持整洁
      writeFileSync(tagsFilePath, JSON.stringify(tagsData, null, 2))
      this.coreTags = tagsData.core_tags  // 内存同步
    }
  } catch (error) {
    console.warn(`⚠️  更新标签池失败: ${error}`)
  }
}

/**
 * 智能环境变量加载
 */
function loadEnvFile(): void {
  const envPath = join(process.cwd(), '.env.local')
  if (existsSync(envPath)) {
    const envContent = readFileSync(envPath, 'utf-8')
    envContent.split('\n').forEach(line => {
      const match = line.match(/^([^=]+)=(.*)$/)
      if (match && !line.startsWith('#')) {
        const [, key, value] = match
        process.env[key.trim()] = value.trim()
      }
    })
  }
}

try {
  const result = await this.client.generateTags(title, content)
  // 处理成功流程
} catch (error) {
  console.error(`❌ 处理失败: ${error}`)
  // 不中断程序，提供友好的错误信息
}