xiamingxing725@gmail.com

---
name: GitHubTrends
description: 显示GitHub热门项目趋势，生成可视化仪表板。USE WHEN github trends, trending projects, hot repositories, popular github projects, generate dashboard, create webpage.
version: 2.0.0
---

## Customization

**Before executing, check for user customizations at:**
`~/.claude/skills/CORE/USER/SKILLCUSTOMIZATIONS/GitHubTrends/`

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

# GitHubTrends - GitHub热门项目趋势

**快速发现GitHub上最受欢迎的开源项目。**

---

## Philosophy

GitHub trending是发现优质开源项目的最佳途径。这个skill让老王我能快速获取当前最热门的项目列表，按时间周期（每日/每周）和编程语言筛选，帮助发现值得学习和贡献的项目。

---

## Quick Start

```bash
# 查看本周最热门的项目（默认）
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly

# 查看今日最热门的项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts daily

# 按语言筛选
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=TypeScript
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=Python

# 指定显示数量
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --limit=20
```

---

## When to Use This Skill

**Core Triggers - Use this skill when user says:**

### Direct Requests
- "show github trends" 或 "github trending"
- "显示热门项目" 或 "看看有什么热门项目"
- "what's trending on github" 或 "github hot projects"
- "本周热门项目" 或 "weekly trending"
- "今日热门项目" 或 "daily trending"

### Discovery Requests
- "discover popular projects" 或 "发现热门项目"
- "show repositories trending" 或 "显示trending仓库"
- "github上什么最火" 或 "what's hot on github"
- "找点好项目看看" 或 "find good projects"

### Language-Specific
- "TypeScript trending projects" 或 "TypeScript热门项目"
- "Python trending" 或 "Python热门项目"
- "show trending Rust projects" 或 "显示Rust热门项目"
- "Go语言热门项目" 或 "trending Go projects"

### Dashboard & Visualization
- "生成 GitHub trending 仪表板" 或 "generate trending dashboard"
- "创建趋势网页" 或 "create trending webpage"
- "生成交互式报告" 或 "generate interactive report"
- "export trending dashboard" 或 "导出仪表板"
- "可视化 GitHub 趋势" 或 "visualize github trends"

---

## Core Capabilities

### 获取趋势列表
- **每日趋势** - 过去24小时最热门项目
- **每周趋势** - 过去7天最热门项目（默认）
- **语言筛选** - 按编程语言过滤（TypeScript, Python, Go, Rust等）
- **自定义数量** - 指定返回项目数量（默认10个）

### 生成可视化仪表板 🆕
- **交互式HTML** - 生成交互式网页仪表板
- **数据可视化** - 语言分布饼图、Stars增长柱状图
- **技术新闻** - 集成 Hacker News 技术资讯
- **实时筛选** - 按语言筛选、排序、搜索功能
- **响应式设计** - 支持桌面、平板、手机

### 项目信息
- 项目名称和描述
- Star数量和变化
- 编程语言
- 项目URL

---

## Tool Usage

### GetTrending.ts

**Location:** `Tools/GetTrending.ts`

**功能：** 从GitHub获取trending项目列表

**参数：**
- `period` - 时间周期：`daily` 或 `weekly`（默认：weekly）
- `--language` - 编程语言筛选（可选）
- `--limit` - 返回项目数量（默认：10）

**使用示例：**
```bash
# 基本用法
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly

# 带参数
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=TypeScript --limit=15

# 简写
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts daily -l=Python
```

**实现方式：**
使用 GitHub官方trending页面：https://github.com/trending
通过 fetch API 读取页面内容并解析

---

### GenerateDashboard.ts 🆕

**Location:** `Tools/GenerateDashboard.ts`

**功能：** 生成交互式数据可视化仪表板HTML文件

**参数：**
- `--period` - 时间周期：`daily` 或 `weekly`（默认：weekly）
- `--language` - 编程语言筛选（可选）
- `--limit` - 返回项目数量（默认：10）
- `--include-news` - 包含技术新闻
- `--news-count` - 新闻数量（默认：10）
- `--output` - 输出文件路径（默认：./github-trends.html）

**使用示例：**
```bash
# 基本用法 - 生成本周仪表板
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts

# 包含技术新闻
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts --include-news

# TypeScript 项目每日仪表板
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts \
  --period daily \
  --language TypeScript \
  --limit 20 \
  --include-news \
  --output ~/ts-daily.html
```

**实现方式：**
- 获取 GitHub trending 项目数据
- 获取 Hacker News 技术新闻
- 使用 Handlebars 模板引擎渲染 HTML
- 集成 Tailwind CSS 和 Chart.js
- 生成完全独立的 HTML 文件（通过 CDN 加载依赖）

---

## Output Format

```markdown
# GitHub Trending Projects - Weekly (2025-01-19)

## 1. vercel/next.js - ⭐ 125,342 (+1,234 this week)
**Language:** TypeScript
**Description:** The React Framework for the Web
**URL:** https://github.com/vercel/next.js

## 2. microsoft/vscode - ⭐ 160,890 (+987 this week)
**Language:** TypeScript
**Description:** Visual Studio Code
**URL:** https://github.com/microsoft/vscode

...

---
📊 Total: 10 projects | Language: All | Period: Weekly
```

---

## Supported Languages

常用编程语言筛选：
- **TypeScript** - TypeScript项目
- **JavaScript** - JavaScript项目
- **Python** - Python项目
- **Go** - Go语言项目
- **Rust** - Rust项目
- **Java** - Java项目
- **C++** - C++项目
- **Ruby** - Ruby项目
- **Swift** - Swift项目
- **Kotlin** - Kotlin项目

---

## Workflow Integration

这个skill可以被其他skill调用：
- **OSINT** - 在调查技术栈时发现热门工具
- **Research** - 研究特定语言生态系统的趋势
- **System** - 发现有用的PAI相关项目

---

## Technical Notes

**数据来源：** GitHub官方trending页面
**更新频率：** 每小时更新一次
**无需认证：** 使用公开页面，无需GitHub API token
**解析方式：** 通过HTML解析提取项目信息

**错误处理：**
- 网络错误会显示友好提示
- 解析失败会返回原始HTML供调试
- 支持的语言参数不区分大小写

---

## Future Enhancements

可能的未来功能：
- 支持月度趋势（如果GitHub提供）
- 按stars范围筛选（1k+, 10k+, 100k+）
- 保存历史数据用于趋势分析
- 集成到其他skill的自动化工作流

---

## Voice Notification

**When executing a workflow, do BOTH:**

1. **Send voice notification:**
   ```bash
   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the GitHubTrends workflow"}' \
     > /dev/null 2>&1 &
   ```

2. **Output text notification:**
   ```
   Running the **GitHubTrends** workflow...
   ```

**Full documentation:** `~/.claude/skills/CORE/SkillNotifications.md`
FILE:README.md
# GitHubTrends Skill

**快速发现GitHub上最受欢迎的开源项目，生成可视化仪表板！**

## 功能特性

### 基础功能
- ✅ 获取每日/每周热门项目列表
- ✅ 按编程语言筛选（TypeScript, Python, Go, Rust等）
- ✅ 自定义返回项目数量
- ✅ 显示Star总数和周期增长
- ✅ 无需GitHub API token

### 可视化仪表板 🆕
- ✨ **交互式HTML** - 生成交互式网页仪表板
- 📊 **数据可视化** - 语言分布饼图、Stars增长柱状图
- 📰 **技术新闻** - 集成 Hacker News 最新资讯
- 🔍 **实时筛选** - 按语言筛选、排序、搜索
- 📱 **响应式设计** - 支持桌面、平板、手机
- 🎨 **美观界面** - Tailwind CSS + GitHub 风格

## 快速开始

### 查看本周热门项目（默认）

```bash
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly
```

### 查看今日热门项目

```bash
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts daily
```

### 按语言筛选

```bash
# TypeScript热门项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=TypeScript

# Python热门项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=Python

# Go热门项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly -l=Go
```

### 指定返回数量

```bash
# 返回20个项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --limit=20

# 组合使用：返回15个TypeScript项目
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=TypeScript --limit=15
```

---

## 生成可视化仪表板 🆕

### 基本用法

```bash
# 生成本周趋势仪表板（默认）
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts
```

### 包含技术新闻

```bash
# 生成包含 Hacker News 的仪表板
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts --include-news
```

### 高级选项

```bash
# 生成 TypeScript 项目每日仪表板，包含 15 条新闻
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts \
  --period daily \
  --language TypeScript \
  --limit 20 \
  --include-news \
  --news-count 15 \
  --output ~/Downloads/ts-daily-trends.html
```

### 仪表板功能

生成的 HTML 文件包含：
- **统计概览** - 总项目数、总 stars、top 项目
- **语言分布图** - 饼图展示各语言占比
- **Stars 增长图** - 柱状图展示增长趋势
- **项目卡片** - 美观的卡片式项目展示
- **技术新闻** - Hacker News 最新资讯
- **交互功能** - 筛选、排序、搜索
- **响应式** - 自适应各种屏幕尺寸

---

## 输出示例

```markdown
# GitHub Trending Projects - Weekly (2026-01-19)

📊 **Total:** 10 projects | **Language:** All | **Period:** Weekly

---

## 1. vercel/next.js - ⭐ 125,342 (+1,234 this week)
**Language:** TypeScript
**Description:** The React Framework for the Web
**URL:** https://github.com/vercel/next.js

## 2. microsoft/vscode - ⭐ 160,890 (+987 this week)
**Language:** TypeScript
**Description:** Visual Studio Code
**URL:** https://github.com/microsoft/vscode

...
```

## 参数说明

| 参数 | 说明 | 默认值 | 可选值 |
|------|------|--------|--------|
| `period` | 时间周期 | `weekly` | `daily`, `weekly` |
| `--language` | 编程语言筛选 | 全部 | TypeScript, Python, Go, Rust, Java等 |
| `--limit` | 返回项目数量 | 10 | 任意正整数 |

## 支持的语言

常用的编程语言都可以作为筛选条件：
- **TypeScript** - TypeScript项目
- **JavaScript** - JavaScript项目
- **Python** - Python项目
- **Go** - Go语言项目
- **Rust** - Rust项目
- **Java** - Java项目
- **C++** - C++项目
- **Ruby** - Ruby项目
- **Swift** - Swift项目
- **Kotlin** - Kotlin项目

## Skill 触发词

当你说以下任何内容时，这个skill会被触发：

- "show github trends" / "github trending"
- "显示热门项目" / "看看有什么热门项目"
- "weekly trending" / "本周热门项目"
- "daily trending" / "今日热门项目"
- "TypeScript trending" / "Python trending"
- "what's hot on github" / "github上什么最火"

## 技术实现

- **数据源**: GitHub官方trending页面 (https://github.com/trending)
- **解析方式**: HTML解析提取项目信息
- **认证**: 无需GitHub API token
- **更新频率**: 每小时更新一次

## 目录结构

```
~/.claude/skills/GitHubTrends/
├── SKILL.md              # Skill主文件
├── README.md             # 使用文档（本文件）
├── Tools/
│   └── GetTrending.ts    # 获取trending数据的工具
└── Workflows/
    └── GetTrending.md    # 工作流文档
```

## 注意事项

1. **网络要求**: 需要能访问GitHub官网
2. **更新频率**: 数据每小时更新，不是实时
3. **解析准确性**: GitHub页面结构变化可能影响解析，如遇问题请检查 `/tmp/github-trending-debug-*.html`
4. **语言参数**: 不区分大小写，`--language=typescript` 和 `--language=TypeScript` 效果相同

## 已知问题

- GitHub trending页面的HTML结构复杂，某些项目的URL和名称可能解析不完整
- 如果GitHub页面结构变化，工具可能需要更新解析逻辑

## 未来改进

- [ ] 支持保存历史数据用于趋势分析
- [ ] 按stars范围筛选（1k+, 10k+, 100k+）
- [ ] 更智能的HTML解析（使用HTML解析库而非正则）
- [ ] 集成到其他skill的自动化工作流

## 贡献

如果发现问题或有改进建议，欢迎提出！

---

**Made with ❤️ by 老王**
FILE:Tools/GetTrending.ts
#!/usr/bin/env bun
/**
 * GitHub Trending Projects Fetcher
 *
 * 从GitHub获取trending项目列表
 * 支持每日/每周趋势，按语言筛选
 */

import { $ } from "bun";

interface TrendingProject {
  rank: number;
  name: string;
  description: string;
  language: string;
  stars: string;
  starsThisPeriod: string;
  url: string;
}

interface TrendingOptions {
  period: "daily" | "weekly";
  language?: string;
  limit: number;
}

function buildTrendingUrl(options: TrendingOptions): string {
  const baseUrl = "https://github.com/trending";
  const since = options.period === "daily" ? "daily" : "weekly";
  let url = `baseUrl?since=since`;
  if (options.language) {
    url += `&language=encodeURIComponent(options.language.toLowerCase())`;
  }
  return url;
}

function parseTrendingProjects(html: string, limit: number): TrendingProject[] {
  const projects: TrendingProject[] = [];
  try {
    const articleRegex = /<article[^>]*>([\s\S]*?)<\/article>/g;
    const articles = html.match(articleRegex) || [];
    const articlesToProcess = articles.slice(0, limit);
    articlesToProcess.forEach((article, index) => {
      try {
        const headingMatch = article.match(/<h[12][^>]*>([\s\S]*?)<\/h[12]>/);
        let repoName: string | null = null;
        if (headingMatch) {
          const headingContent = headingMatch[1];
          const validLinkMatch = headingContent.match(
            /<a[^>]*href="\/([^\/"\/]+\/[^\/"\/]+)"[^>]*>(?![^<]*login)/
          );
          if (validLinkMatch) {
            repoName = validLinkMatch[1];
          }
        }
        if (!repoName) {
          const repoMatch = article.match(
            /<a[^>]*href="\/([a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+)"[^>]*>(?!.*(?:login|stargazers|forks|issues))/
          );
          repoName = repoMatch ? repoMatch[1] : null;
        }
        const descMatch = article.match(/<p[^>]*class="[^"]*col-9[^"]*"[^>]*>([\s\S]*?)<\/p>/);
        const description = descMatch
          ? descMatch[1]
              .replace(/<[^>]+>/g, "")
              .replace(/&amp;/g, "&")
              .replace(/&lt;/g, "<")
              .replace(/&gt;/g, ">")
              .replace(/&quot;/g, '"')
              .trim()
              .substring(0, 200)
          : "No description";
        const langMatch = article.match(/<span[^>]*itemprop="programmingLanguage"[^>]*>([^<]+)<\/span>/);
        const language = langMatch ? langMatch[1].trim() : "Unknown";
        const starsMatch = article.match(/<a[^>]*href="\/[^"]+\/stargazers"[^>]*>(\d[\d,]*)\s*stars?/);
        const totalStars = starsMatch ? starsMatch[1] : "0";
        const starsAddedMatch = article.match(/(\d[\d,]*)\s*stars?\s*(?:today|this week)/i);
        const starsAdded = starsAddedMatch ? `+starsAddedMatch[1]` : "";
        if (repoName && !repoName.includes("login") && !repoName.includes("return_to")) {
          projects.push({
            rank: index + 1,
            name: repoName,
            description,
            language,
            stars: totalStars,
            starsThisPeriod: starsAdded,
            url: `https://github.com/repoName`,
          });
        }
      } catch (error) {
        console.error(`解析第index + 1个项目失败:`, error);
      }
    });
  } catch (error) {
    console.error("解析trending项目失败:", error);
  }
  return projects;
}

function formatProjects(projects: TrendingProject[], options: TrendingOptions): string {
  if (projects.length === 0) {
    return "# GitHub Trending - No Projects Found\n\n没有找到trending项目，可能是网络问题或页面结构变化。";
  }
  const periodLabel = options.period === "daily" ? "Daily" : "Weekly";
  const languageLabel = options.language ? `Language: options.language` : "Language: All";
  const today = new Date().toISOString().split("T")[0];
  let output = `# GitHub Trending Projects - periodLabel (today)\n\n`;
  output += `📊 **Total:** projects.length projects | **languageLabel** | **Period:** periodLabel\n\n`;
  output += `---\n\n`;
  projects.forEach((project) => {
    output += `## project.rank. project.name - ⭐ project.stars`;
    if (project.starsThisPeriod) {
      output += ` (project.starsThisPeriod this options.period)`;
    }
    output += `\n`;
    output += `**Language:** project.language\n`;
    output += `**Description:** project.description\n`;
    output += `**URL:** project.url\n\n`;
  });
  output += `---\n`;
  output += `📊 Data from: https://github.com/trending\n`;
  return output;
}

async function main() {
  const args = process.argv.slice(2);
  let period: "daily" | "weekly" = "weekly";
  let language: string | undefined;
  let limit = 10;
  for (const arg of args) {
    if (arg === "daily" || arg === "weekly") {
      period = arg;
    } else if (arg.startsWith("--language=")) {
      language = arg.split("=")[1];
    } else if (arg.startsWith("-l=")) {
      language = arg.split("=")[1];
    } else if (arg.startsWith("--limit=")) {
      limit = parseInt(arg.split("=")[1]) || 10;
    }
  }
  const options: TrendingOptions = { period, language, limit };
  try {
    const url = buildTrendingUrl(options);
    console.error(`正在获取 GitHub trending 数据: url`);
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP response.status: response.statusText`);
    }
    const html = await response.text();
    const projects = parseTrendingProjects(html, limit);
    const formatted = formatProjects(projects, options);
    console.log(formatted);
    if (projects.length === 0) {
      const debugFile = `/tmp/github-trending-debug-Date.now().html`;
      await Bun.write(debugFile, html);
      console.error(`\n调试: 原始HTML已保存到 debugFile`);
    }
  } catch (error) {
    console.error("❌ 获取trending数据失败:");
    console.error(error);
    process.exit(1);
  }
}

main();
FILE:Workflows/GetTrending.md
# GetTrending Workflow

获取GitHub trending项目列表的工作流程。

## Description

这个工作流使用 GetTrending.ts 工具从GitHub获取当前最热门的项目列表，支持按时间周期（每日/每周）和编程语言筛选。

## When to Use

当用户请求以下任何内容时使用此工作流：
- "show github trends" / "github trending"
- "显示热门项目" / "看看有什么热门项目"
- "weekly trending" / "本周热门项目"
- "daily trending" / "今日热门项目"
- "TypeScript trending" / "Python trending" / 按语言筛选
- "what's hot on github" / "github上什么最火"

## Workflow Steps

### Step 1: 确定参数
向用户确认或推断以下参数：
- **时间周期**: daily (每日) 或 weekly (每周，默认)
- **编程语言**: 可选（如 TypeScript, Python, Go, Rust等）
- **项目数量**: 默认10个

### Step 2: 执行工具
运行 GetTrending.ts 工具：

```bash
# 基本用法（本周，全部语言，10个项目）
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly

# 指定语言
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --language=TypeScript

# 指定数量
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts weekly --limit=20

# 组合参数
bun ~/.claude/skills/GitHubTrends/Tools/GetTrending.ts daily --language=Python --limit=15
```

### Step 3: 显示结果
工具会自动格式化输出，包括：
- 项目排名
- 项目名称
- Star总数和周期内增长
- 编程语言
- 项目描述
- GitHub URL

### Step 4: 后续操作（可选）
根据用户需求，可以：
- 打开某个项目页面
- 使用其他skill进一步分析项目
- 将结果保存到文件供后续参考

## Integration with Other Skills

- **OSINT**: 在调查技术栈时发现热门工具
- **Research**: 研究特定语言生态系统的趋势
- **Browser**: 打开项目页面进行详细分析

## Notes

- 数据每小时更新一次
- 无需GitHub API token
- 使用公开的GitHub trending页面
- 支持的语言参数不区分大小写
FILE:Tools/GenerateDashboard.ts
#!/usr/bin/env bun
/**
 * GitHub Trending Dashboard Generator
 *
 * 生成交互式数据可视化仪表板
 *
 * 使用方式：
 *   ./GenerateDashboard.ts [options]
 *
 * 选项：
 *   --period       - daily | weekly (默认: weekly)
 *   --language     - 编程语言筛选 (可选)
 *   --limit        - 项目数量 (默认: 10)
 *   --include-news - 包含技术新闻
 *   --news-count   - 新闻数量 (默认: 10)
 *   --theme        - light | dark | auto (默认: auto)
 *   --output       - 输出文件路径 (默认: ./github-trends.html)
 *
 * 示例：
 *   ./GenerateDashboard.ts
 *   ./GenerateDashboard.ts --period daily --language TypeScript --include-news
 *   ./GenerateDashboard.ts --limit 20 --output ~/trends.html
 */

import Handlebars from 'handlebars';
import type { DashboardOptions, TrendingProject, TechNewsItem, TemplateData } from './Lib/types';
import { registerHelpers, renderTemplate } from './Lib/template-helpers';
import { analyzeData } from './Lib/visualization-helpers';

// 注册 Handlebars 辅助函数
registerHelpers();

/**
 * 构建 GitHub trending URL
 */
function buildTrendingUrl(options: DashboardOptions): string {
  const baseUrl = "https://github.com/trending";
  const since = options.period === "daily" ? "daily" : "weekly";
  let url = `baseUrl?since=since`;

  if (options.language) {
    url += `&language=encodeURIComponent(options.language.toLowerCase())`;
  }

  return url;
}

/**
 * 解析 HTML 提取 trending 项目
 * （从 GetTrending.ts 复制的逻辑）
 */
async function getTrendingProjects(options: DashboardOptions): Promise<TrendingProject[]> {
  const url = buildTrendingUrl(options);

  console.error(`正在获取 GitHub trending 数据: url`);

  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`HTTP response.status: response.statusText`);
  }

  const html = await response.text();
  return parseTrendingProjects(html, options.limit);
}

/**
 * 解析 HTML
 */
function parseTrendingProjects(html: string, limit: number): TrendingProject[] {
  const projects: TrendingProject[] = [];

  try {
    const articleRegex = /<article[^>]*>([\s\S]*?)<\/article>/g;
    const articles = html.match(articleRegex) || [];
    const articlesToProcess = articles.slice(0, limit);

    articlesToProcess.forEach((article, index) => {
      try {
        const headingMatch = article.match(/<h[12][^>]*>([\s\S]*?)<\/h[12]>/);
        let repoName: string | null = null;

        if (headingMatch) {
          const headingContent = headingMatch[1];
          const validLinkMatch = headingContent.match(
            /<a[^>]*href="\/([^\/"\/]+\/[^\/"\/]+)"[^>]*>(?![^<]*login)/
          );
          if (validLinkMatch) {
            repoName = validLinkMatch[1];
          }
        }

        if (!repoName) {
          const repoMatch = article.match(
            /<a[^>]*href="\/([a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+)"[^>]*>(?!.*(?:login|stargazers|forks|issues))/
          );
          repoName = repoMatch ? repoMatch[1] : null;
        }

        const descMatch = article.match(/<p[^>]*class="[^"]*col-9[^"]*"[^>]*>([\s\S]*?)<\/p>/);
        const description = descMatch
          ? descMatch[1]
              .replace(/<[^>]+>/g, "")
              .replace(/&amp;/g, "&")
              .replace(/&lt;/g, "<")
              .replace(/&gt;/g, ">")
              .replace(/&quot;/g, '"')
              .trim()
              .substring(0, 200)
          : "No description";

        const langMatch = article.match(/<span[^>]*itemprop="programmingLanguage"[^>]*>([^<]+)<\/span>/);
        const language = langMatch ? langMatch[1].trim() : "Unknown";

        // 提取stars总数 - GitHub 改了 HTML 结构，数字在 SVG 后面
        const starsMatch = article.match(/stargazers[^>]*>[\s\S]*?<\/svg>\s*([\d,]+)/);
        const totalStars = starsMatch ? starsMatch[1] : "0";

        // 尝试提取新增stars - 格式：XXX stars today/this week
        const starsAddedMatch = article.match(/(\d[\d,]*)\s+stars?\s+(?:today|this week)/);
        const starsAdded = starsAddedMatch ? `+starsAddedMatch[1]` : "";

        if (repoName && !repoName.includes("login") && !repoName.includes("return_to")) {
          projects.push({
            rank: index + 1,
            name: repoName,
            description,
            language,
            stars: totalStars,
            starsThisPeriod: starsAdded,
            url: `https://github.com/repoName`,
          });
        }
      } catch (error) {
        console.error(`解析第index + 1个项目失败:`, error);
      }
    });
  } catch (error) {
    console.error("解析trending项目失败:", error);
  }

  return projects;
}

/**
 * 获取技术新闻
 */
async function getTechNews(count: number): Promise<TechNewsItem[]> {
  const HN_API = 'https://hn.algolia.com/api/v1/search_by_date';

  try {
    const response = await fetch(`HN_API?tags=story&hitsPerPage=count`);
    if (!response.ok) {
      throw new Error(`HTTP response.status: response.statusText`);
    }

    const data = await response.json();

    return data.hits.slice(0, count).map((hit: any) => ({
      id: hit.objectID,
      title: hit.title,
      url: hit.url || `https://news.ycombinator.com/item?id=hit.objectID`,
      source: 'hackernews',
      points: hit.points || 0,
      comments: hit.num_comments || 0,
      timestamp: new Date(hit.created_at).toISOString(),
      tags: hit._tags || []
    }));
  } catch (error) {
    console.error('获取 Hacker News 失败:', error);
    return [];
  }
}

/**
 * 生成仪表板
 */
async function generateDashboard(options: DashboardOptions): Promise<void> {
  try {
    console.error('🚀 开始生成 GitHub Trending Dashboard...\n');

    // 1. 获取 GitHub Trending 数据
    const projects = await getTrendingProjects(options);
    console.error(`✅ 获取到 projects.length 个项目`);

    // 2. 获取技术新闻（如果启用）
    let news: TechNewsItem[] = [];
    if (options.includeNews) {
      news = await getTechNews(options.newsCount);
      console.error(`✅ 获取到 news.length 条新闻`);
    }

    // 3. 分析数据
    const analytics = analyzeData(projects);
    console.error(`✅ 数据分析完成`);

    // 4. 准备模板数据
    const templateData: TemplateData = {
      title: 'GitHub Trending Dashboard',
      generatedAt: new Date().toLocaleString('zh-CN'),
      period: options.period === 'daily' ? 'Daily' : 'Weekly',
      projects,
      news,
      analytics,
      options
    };

    // 5. 渲染模板
    const templatePath = `import.meta.dir/../Templates/dashboard.hbs`;
    const templateContent = await Bun.file(templatePath).text();
    const template = Handlebars.compile(templateContent);
    const html = template(templateData);
    console.error(`✅ 模板渲染完成`);

    // 6. 保存文件
    await Bun.write(options.output, html);
    console.error(`\n🎉 仪表板生成成功！`);
    console.error(`📄 文件路径: options.output`);
    console.error(`\n💡 在浏览器中打开查看效果！`);

  } catch (error) {
    console.error('\n❌ 生成仪表板失败:');
    console.error(error);
    process.exit(1);
  }
}

/**
 * 解析命令行参数
 */
function parseArgs(): DashboardOptions {
  const args = process.argv.slice(2);

  const options: DashboardOptions = {
    period: 'weekly',
    limit: 10,
    output: './github-trends.html',
    includeNews: false,
    newsCount: 10,
    theme: 'auto'
  };

  for (let i = 0; i < args.length; i++) {
    const arg = args[i];

    switch (arg) {
      case '--period':
        options.period = args[++i] === 'daily' ? 'daily' : 'weekly';
        break;
      case '--language':
        options.language = args[++i];
        break;
      case '--limit':
        options.limit = parseInt(args[++i]) || 10;
        break;
      case '--include-news':
        options.includeNews = true;
        break;
      case '--news-count':
        options.newsCount = parseInt(args[++i]) || 10;
        break;
      case '--theme':
        options.theme = args[++i] === 'light' || args[++i] === 'dark' ? args[i] : 'auto';
        break;
      case '--output':
        options.output = args[++i];
        break;
      default:
        if (arg.startsWith('--output=')) {
          options.output = arg.split('=')[1];
        } else if (arg.startsWith('--language=')) {
          options.language = arg.split('=')[1];
        } else if (arg.startsWith('--limit=')) {
          options.limit = parseInt(arg.split('=')[1]) || 10;
        }
    }
  }

  return options;
}

/**
 * 主函数
 */
async function main() {
  const options = parseArgs();
  await generateDashboard(options);
}

// 如果直接运行此脚本
if (import.meta.main) {
  main();
}

// 导出供其他模块使用
export { generateDashboard };
export type { DashboardOptions };
FILE:Tools/GetTechNews.ts
#!/usr/bin/env bun
/**
 * Tech News Fetcher
 *
 * 从 Hacker News 和其他来源获取技术新闻
 *
 * 使用方式：
 *   ./GetTechNews.ts [count]
 *
 * 参数：
 *   count        - 获取新闻数量 (默认: 10)
 *
 * 示例：
 *   ./GetTechNews.ts
 *   ./GetTechNews.ts 20
 */

import Parser from 'rss-parser';
import type { TechNewsItem } from './Lib/types';

const HN_API = 'https://hn.algolia.com/api/v1/search';
const parser = new Parser();

/**
 * 从 Hacker News Algolia API 获取新闻
 */
async function getHackerNews(count: number): Promise<TechNewsItem[]> {
  try {
    const response = await fetch(`HN_API?tags=front_page&hits=count`);
    if (!response.ok) {
      throw new Error(`HTTP response.status: response.statusText`);
    }

    const data = await response.json();

    return data.hits.map((hit: any) => ({
      id: hit.objectID,
      title: hit.title,
      url: hit.url || `https://news.ycombinator.com/item?id=hit.objectID`,
      source: 'hackernews',
      points: hit.points || 0,
      comments: hit.num_comments || 0,
      timestamp: new Date(hit.created_at).toISOString(),
      tags: hit._tags || []
    }));
  } catch (error) {
    console.error('获取 Hacker News 失败:', error);
    return [];
  }
}

/**
 * 从 Hacker News RSS 获取新闻（备用方案）
 */
async function getHackerNewsRSS(count: number): Promise<TechNewsItem[]> {
  try {
    const feed = await parser.parseURL('https://news.ycombinator.com/rss');

    return feed.items.slice(0, count).map((item: any) => ({
      id: item.guid || item.link,
      title: item.title || 'No title',
      url: item.link,
      source: 'hackernews',
      timestamp: item.pubDate || new Date().toISOString(),
      tags: ['hackernews', 'rss']
    }));
  } catch (error) {
    console.error('获取 Hacker News RSS 失败:', error);
    return [];
  }
}

/**
 * 获取技术新闻（主函数）
 */
async function getTechNews(count: number = 10): Promise<TechNewsItem[]> {
  console.error(`正在获取技术新闻（count条）...`);

  // 优先使用 Hacker News API
  let news = await getHackerNews(count);

  // 如果失败，尝试 RSS 备用
  if (news.length === 0) {
    console.error('Hacker News API 失败，尝试 RSS...');
    news = await getHackerNewsRSS(count);
  }

  console.error(`✅ 获取到 news.length 条新闻`);
  return news;
}

/**
 * CLI 入口
 */
async function main() {
  const args = process.argv.slice(2);
  const count = parseInt(args[0]) || 10;

  try {
    const news = await getTechNews(count);

    // 输出 JSON 格式（便于程序调用）
    console.log(JSON.stringify(news, null, 2));
  } catch (error) {
    console.error('❌ 获取新闻失败:');
    console.error(error);
    process.exit(1);
  }
}

// 如果直接运行此脚本
if (import.meta.main) {
  main();
}

// 导出供其他模块使用
export { getTechNews };
export type { TechNewsItem };
FILE:Tools/Lib/types.ts
/**
 * GitHubTrends - 类型定义
 *
 * 定义所有 TypeScript 接口和类型
 */

/**
 * GitHub Trending 项目
 */
export interface TrendingProject {
  rank: number;
  name: string;
  description: string;
  language: string;
  stars: string;
  starsThisPeriod: string;
  url: string;
}

/**
 * 技术新闻条目
 */
export interface TechNewsItem {
  id: string;
  title: string;
  url: string;
  source: string; // 'hackernews', 'reddit', etc.
  points?: number;
  comments?: number;
  timestamp: string;
  tags: string[];
}

/**
 * 仪表板生成选项
 */
export interface DashboardOptions {
  period: 'daily' | 'weekly';
  language?: string;
  limit: number;
  output: string;
  includeNews: boolean;
  newsCount: number;
  theme: 'light' | 'dark' | 'auto';
}

/**
 * 数据分析结果
 */
export interface Analytics {
  languageDistribution: Record<string, number>;
  totalStars: number;
  topProject: TrendingProject;
  growthStats: {
    highest: TrendingProject;
    average: number;
  };
}

/**
 * Trending 查询选项（用于 GetTrending.ts）
 */
export interface TrendingOptions {
  period: "daily" | "weekly";
  language?: string;
  limit: number;
}

/**
 * 图表数据
 */
export interface ChartData {
  labels: string[];
  data: number[];
  colors: string[];
}

/**
 * 模板渲染数据
 */
export interface TemplateData {
  title: string;
  generatedAt: string;
  period: string;
  projects: TrendingProject[];
  news?: TechNewsItem[];
  analytics: Analytics;
  options: DashboardOptions;
}
FILE:Tools/Lib/template-helpers.ts
/**
 * Template Helpers
 *
 * Handlebars 自定义辅助函数
 */

import Handlebars from 'handlebars';

/**
 * 注册所有自定义辅助函数
 */
export function registerHelpers(): void {
  // 格式化数字（添加千位分隔符）
  Handlebars.registerHelper('formatNumber', (value: number) => {
    return value.toLocaleString();
  });

  // 截断文本
  Handlebars.registerHelper('truncate', (str: string, length: number = 100) => {
    if (str.length <= length) return str;
    return str.substring(0, length) + '...';
  });

  // 格式化日期
  Handlebars.registerHelper('formatDate', (dateStr: string) => {
    const date = new Date(dateStr);
    return date.toLocaleDateString('zh-CN', {
      year: 'numeric',
      month: 'long',
      day: 'numeric',
      hour: '2-digit',
      minute: '2-digit'
    });
  });

  // JSON 序列化（用于内嵌数据）
  Handlebars.registerHelper('json', (context: any) => {
    return JSON.stringify(context);
  });

  // 条件判断
  Handlebars.registerHelper('eq', (a: any, b: any) => {
    return a === b;
  });

  Handlebars.registerHelper('ne', (a: any, b: any) => {
    return a !== b;
  });

  Handlebars.registerHelper('gt', (a: number, b: number) => {
    return a > b;
  });

  Handlebars.registerHelper('lt', (a: number, b: number) => {
    return a < b;
  });
}

/**
 * 渲染模板
 */
export async function renderTemplate(
  templatePath: string,
  data: any
): Promise<string> {
  const templateContent = await Bun.file(templatePath).text();
  const template = Handlebars.compile(templateContent);
  return template(data);
}

export default { registerHelpers, renderTemplate };
FILE:Tools/Lib/visualization-helpers.ts
/**
 * Visualization Helpers
 *
 * 数据分析和可视化辅助函数
 */

import type { TrendingProject, Analytics } from './types';

/**
 * 分析项目数据
 */
export function analyzeData(projects: TrendingProject[]): Analytics {
  // 语言分布统计
  const languageDistribution: Record<string, number> = {};
  projects.forEach(project => {
    const lang = project.language;
    languageDistribution[lang] = (languageDistribution[lang] || 0) + 1;
  });

  // 总 stars 数
  const totalStars = projects.reduce((sum, project) => {
    return sum + parseInt(project.stars.replace(/,/g, '') || 0);
  }, 0);

  // 找出 top project
  const topProject = projects.reduce((top, project) => {
    const topStars = parseInt(top.stars.replace(/,/g, '') || 0);
    const projStars = parseInt(project.stars.replace(/,/g, '') || 0);
    return projStars > topStars ? project : top;
  }, projects[0]);

  // 增长统计
  const projectsWithGrowth = projects.filter(p => p.starsThisPeriod);
  const growthValues = projectsWithGrowth.map(p =>
    parseInt(p.starsThisPeriod.replace(/[+,]/g, '') || 0)
  );

  const highestGrowth = projectsWithGrowth.reduce((highest, project) => {
    const highestValue = parseInt(highest.starsThisPeriod.replace(/[+,]/g, '') || 0);
    const projValue = parseInt(project.starsThisPeriod.replace(/[+,]/g, '') || 0);
    return projValue > highestValue ? project : highest;
  }, projectsWithGrowth[0] || projects[0]);

  const averageGrowth = growthValues.length > 0
    ? Math.round(growthValues.reduce((a, b) => a + b, 0) / growthValues.length)
    : 0;

  // 提取唯一语言列表（用于筛选）
  const languages = Object.keys(languageDistribution).sort();

  // 生成图表数据
  const growthData = projects.slice(0, 10).map(p => ({
    name: p.name.split('/')[1] || p.name,
    growth: parseInt(p.starsThisPeriod.replace(/[+,]/g, '') || 0)
  }));

  return {
    languageDistribution,
    totalStars,
    topProject,
    growthStats: {
      highest: highestGrowth,
      average: averageGrowth
    },
    languages,
    growthData
  };
}

/**
 * 格式化 stars 数字
 */
export function formatStars(starsStr: string): number {
  return parseInt(starsStr.replace(/,/g, '') || 0);
}

/**
 * 解析增长数值
 */
export function parseGrowth(growthStr: string): number {
  if (!growthStr) return 0;
  return parseInt(growthStr.replace(/[+,]/g, '') || 0);
}

export default { analyzeData, formatStars, parseGrowth };
FILE:Templates/dashboard.hbs
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>GitHub Trending Dashboard - {{period}}</title>

  <!-- Tailwind CSS -->
  <script src="https://cdn.tailwindcss.com"></script>
  <script>
    tailwind.config = {
      theme: {
        extend: {
          colors: {
            github: {
              dark: '#0d1117',
              light: '#161b22',
              border: '#30363d',
              accent: '#58a6ff'
            }
          }
        }
      }
    }
  </script>

  <!-- Chart.js -->
  <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>

  <style>
    body {
      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
    }
    .project-card {
      transition: all 0.3s ease;
    }
    .project-card:hover {
      transform: translateY(-2px);
      box-shadow: 0 8px 25px rgba(0,0,0,0.15);
    }
    .stat-card {
      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    }
    .badge {
      display: inline-block;
      padding: 0.25rem 0.75rem;
      border-radius: 9999px;
      font-size: 0.75rem;
      font-weight: 600;
    }
    .news-item {
      border-left: 3px solid #58a6ff;
      padding-left: 1rem;
    }
  </style>
</head>

<body class="bg-gray-50 min-h-screen">
  <!-- 页头 -->
  <header class="bg-white shadow-sm sticky top-0 z-50">
    <div class="max-w-7xl mx-auto px-4 py-4 sm:px-6 lg:px-8">
      <div class="flex justify-between items-center">
        <div>
          <h1 class="text-3xl font-bold text-gray-900">🚀 GitHub Trending Dashboard</h1>
          <p class="text-gray-600 mt-1">
            周期: <span class="font-semibold text-github-accent">{{period}}</span> |
            生成时间: <span class="text-gray-500">{{generatedAt}}</span>
          </p>
        </div>
        <div class="flex gap-2">
          <button onclick="window.print()" class="px-4 py-2 bg-gray-100 hover:bg-gray-200 rounded-lg text-sm font-medium">
            🖨️ Print
          </button>
        </div>
      </div>
    </div>
  </header>

  <main class="max-w-7xl mx-auto px-4 py-8 sm:px-6 lg:px-8">

    <!-- 统计概览 -->
    <section class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-8">
      <div class="stat-card rounded-xl p-6 text-white shadow-lg">
        <h3 class="text-lg font-semibold opacity-90">项目总数</h3>
        <p class="text-4xl font-bold mt-2">{{projects.length}}</p>
        <p class="text-sm opacity-75 mt-1">{{period}} 热门趋势</p>
      </div>

      <div class="bg-gradient-to-br from-green-500 to-emerald-600 rounded-xl p-6 text-white shadow-lg">
        <h3 class="text-lg font-semibold opacity-90">总 Stars 数</h3>
        <p class="text-4xl font-bold mt-2">{{analytics.totalStars}}</p>
        <p class="text-sm opacity-75 mt-1">所有项目总计</p>
      </div>

      <div class="bg-gradient-to-br from-orange-500 to-red-500 rounded-xl p-6 text-white shadow-lg">
        <h3 class="text-lg font-semibold opacity-90">最热项目</h3>
        <p class="text-xl font-bold mt-2 truncate">{{analytics.topProject.name}}</p>
        <p class="text-sm opacity-75 mt-1">{{analytics.topProject.stars}} stars</p>
      </div>
    </section>

    <!-- 筛选和搜索 -->
    <section class="bg-white rounded-xl shadow-sm p-6 mb-8">
      <div class="flex flex-wrap gap-4 items-center">
        <div class="flex-1 min-w-64">
          <label class="block text-sm font-medium text-gray-700 mb-1">搜索项目</label>
          <input
            type="text"
            id="searchInput"
            placeholder="按名称或描述搜索..."
            class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-github-accent focus:border-transparent"
            oninput="filterProjects()"
          >
        </div>

        <div>
          <label class="block text-sm font-medium text-gray-700 mb-1">语言筛选</label>
          <select
            id="languageFilter"
            class="px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-github-accent focus:border-transparent"
            onchange="filterProjects()"
          >
            <option value="all">全部语言</option>
            {{#each analytics.languages}}
              <option value="{{this}}">{{this}}</option>
            {{/each}}
          </select>
        </div>

        <div>
          <label class="block text-sm font-medium text-gray-700 mb-1">排序方式</label>
          <select
            id="sortSelect"
            class="px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-github-accent focus:border-transparent"
            onchange="sortProjects()"
          >
            <option value="rank">排名</option>
            <option value="stars">总 Stars</option>
            <option value="growth">本期增长</option>
          </select>
        </div>
      </div>
    </section>

    <!-- 语言分布图表 -->
    <section class="bg-white rounded-xl shadow-sm p-6 mb-8">
      <h2 class="text-2xl font-bold text-gray-900 mb-4">📊 语言分布</h2>
      <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
        <div>
          <canvas id="languageChart"></canvas>
        </div>
        <div>
          <canvas id="growthChart"></canvas>
        </div>
      </div>
    </section>

    <!-- Trending Projects -->
    <section class="mb-8">
      <h2 class="text-2xl font-bold text-gray-900 mb-4">🔥 热门项目</h2>
      <div id="projects-container" class="grid grid-cols-1 gap-4">
        {{#each projects}}
        <div class="project-card bg-white rounded-xl shadow-sm p-6 border border-gray-200"
             data-rank="{{rank}}"
             data-language="{{language}}"
             data-stars="{{stars}}"
             data-growth="{{starsThisPeriod}}"
             data-name="{{name}}"
             data-description="{{description}}">
          <div class="flex items-start justify-between">
            <div class="flex-1">
              <div class="flex items-center gap-3 mb-2">
                <span class="text-2xl font-bold text-github-accent">#{{rank}}</span>
                <h3 class="text-xl font-semibold text-gray-900">
                  <a href="{{url}}" target="_blank" class="hover:text-github-accent">{{name}}</a>
                </h3>
                <span class="badge bg-blue-100 text-blue-800">{{language}}</span>
              </div>
              <p class="text-gray-600 mb-3">{{description}}</p>
              <div class="flex items-center gap-4 text-sm text-gray-500">
                <span>⭐ {{stars}} stars</span>
                {{#if starsThisPeriod}}
                  <span class="text-green-600 font-semibold">(+{{starsThisPeriod}} this {{../period}})</span>
                {{/if}}
              </div>
            </div>
            <a href="{{url}}" target="_blank" class="px-4 py-2 bg-github-accent text-white rounded-lg hover:bg-blue-600 transition font-medium">
              View →
            </a>
          </div>
        </div>
        {{/each}}
      </div>
    </section>

    <!-- Tech News -->
    {{#if news}}
    <section class="mb-8">
      <h2 class="text-2xl font-bold text-gray-900 mb-4">📰 技术资讯</h2>
      <div class="grid grid-cols-1 gap-4">
        {{#each news}}
        <div class="news-item bg-white rounded-xl shadow-sm p-5 hover:shadow-md transition">
          <div class="flex items-start justify-between">
            <div class="flex-1">
              <h3 class="text-lg font-semibold text-gray-900 mb-1">
                <a href="{{url}}" target="_blank" class="hover:text-github-accent">{{title}}</a>
              </h3>
              <div class="flex items-center gap-4 text-sm text-gray-500">
                <span class="text-orange-600">📰 {{source}}</span>
                {{#if points}}
                  <span>⬆️ {{points}} points</span>
                {{/if}}
                {{#if comments}}
                  <span>💬 {{comments}} comments</span>
                {{/if}}
              </div>
            </div>
          </div>
        </div>
        {{/each}}
      </div>
    </section>
    {{/if}}

  </main>

  <!-- 页脚 -->
  <footer class="bg-white border-t border-gray-200 mt-12">
    <div class="max-w-7xl mx-auto px-4 py-6 sm:px-6 lg:px-8">
      <p class="text-center text-gray-500 text-sm">
        由 GitHubTrends Skill 生成 | 数据来源：GitHub 和 Hacker News
      </p>
    </div>
  </footer>

  <!-- JavaScript -->
  <script>
    // 注入数据
    window.dashboardData = {
      projects: {{{json projects}}},
      analytics: {
        languageDistribution: {{{json analytics.languageDistribution}}},
        growthData: {{{json analytics.growthData}}}
      }
    };

    // 初始化图表
    document.addEventListener('DOMContentLoaded', function() {
      initLanguageChart();
      initGrowthChart();
    });

    // 语言分布饼图
    function initLanguageChart() {
      const ctx = document.getElementById('languageChart').getContext('2d');
      const data = window.dashboardData.analytics.languageDistribution;

      new Chart(ctx, {
        type: 'pie',
        data: {
          labels: Object.keys(data),
          datasets: [{
            data: Object.values(data),
            backgroundColor: [
              '#58a6ff', '#238636', '#f1e05a', '#d73a49',
              '#8957E5', '#e34c26', '#CB3837', '#DA5B0B',
              '#4F5D95', '#563d7c'
            ]
          }]
        },
        options: {
          responsive: true,
          plugins: {
            legend: {
              position: 'right'
            },
            title: {
              display: true,
              text: 'Projects by Language'
            }
          }
        }
      });
    }

    // Stars 增长柱状图
    function initGrowthChart() {
      const ctx = document.getElementById('growthChart').getContext('2d');
      const projects = window.dashboardData.projects.slice(0, 10);

      new Chart(ctx, {
        type: 'bar',
        data: {
          labels: projects.map(p => p.name.split('/')[1] || p.name),
          datasets: [{
            label: 'Stars This Period',
            data: projects.map(p => parseInt(p.starsThisPeriod.replace('+', '') || 0)),
            backgroundColor: 'rgba(88, 166, 255, 0.8)',
            borderColor: 'rgba(88, 166, 255, 1)',
            borderWidth: 1
          }]
        },
        options: {
          responsive: true,
          indexAxis: 'y',
          plugins: {
            title: {
              display: true,
              text: 'Top 10 Growth'
            }
          },
          scales: {
            x: {
              beginAtZero: true
            }
          }
        }
      });
    }

    // 筛选项目
    function filterProjects() {
      const searchValue = document.getElementById('searchInput').value.toLowerCase();
      const languageValue = document.getElementById('languageFilter').value;

      const cards = document.querySelectorAll('.project-card');

      cards.forEach(card => {
        const name = card.dataset.name.toLowerCase();
        const description = card.dataset.description.toLowerCase();
        const language = card.dataset.language;

        const matchesSearch = name.includes(searchValue) || description.includes(searchValue);
        const matchesLanguage = languageValue === 'all' || language === languageValue;

        card.style.display = matchesSearch && matchesLanguage ? 'block' : 'none';
      });
    }

    // 排序项目
    function sortProjects() {
      const sortBy = document.getElementById('sortSelect').value;
      const container = document.getElementById('projects-container');
      const cards = Array.from(container.children);

      cards.sort((a, b) => {
        switch(sortBy) {
          case 'stars':
            return parseInt(b.dataset.stars.replace(/,/g, '')) - parseInt(a.dataset.stars.replace(/,/g, ''));
          case 'growth':
            const growthA = parseInt(a.dataset.growth.replace(/[+,]/g, '') || 0);
            const growthB = parseInt(b.dataset.growth.replace(/[+,]/g, '') || 0);
            return growthB - growthA;
          case 'rank':
          default:
            return parseInt(a.dataset.rank) - parseInt(b.dataset.rank);
        }
      });

      cards.forEach(card => container.appendChild(card));
    }
  </script>
</body>
</html>
FILE:Workflows/GenerateDashboard.md
# GenerateDashboard Workflow

生成交互式数据可视化仪表板的工作流程。

## Description

这个工作流使用 GenerateDashboard.ts 工具从 GitHub 获取 trending 项目，并生成交互式 HTML 仪表板，支持：
- 项目卡片展示
- 语言分布饼图
- Stars 增长柱状图
- 技术新闻列表
- 实时筛选、排序、搜索功能

## When to Use

当用户请求以下任何内容时使用此工作流：
- "生成 GitHub trending 仪表板"
- "创建趋势网页"
- "生成可视化报告"
- "export trending dashboard"
- "生成交互式网页"

## Workflow Steps

### Step 1: 确定参数
向用户确认或推断以下参数：
- **时间周期**: daily (每日) 或 weekly (每周，默认)
- **编程语言**: 可选（如 TypeScript, Python, Go, Rust等）
- **项目数量**: 默认10个
- **包含新闻**: 是否包含技术新闻
- **新闻数量**: 默认10条
- **输出路径**: 默认 ./github-trends.html

### Step 2: 执行工具
运行 GenerateDashboard.ts 工具：

```bash
# 基本用法（本周，10个项目）
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts

# 指定语言和新闻
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts \
  --period weekly \
  --language TypeScript \
  --limit 20 \
  --include-news \
  --news-count 15 \
  --output ~/trends.html

# 每日趋势
bun ~/.claude/skills/GitHubTrends/Tools/GenerateDashboard.ts \
  --period daily \
  --output ~/daily-trends.html
```

### Step 3: 显示结果
工具会自动：
1. 获取 GitHub trending 数据
2. 获取技术新闻（如果启用）
3. 分析数据生成统计信息
4. 渲染 HTML 模板
5. 保存到指定路径

### Step 4: 验证和打开
生成的 HTML 文件包含：
- ✅ 响应式布局
- ✅ 项目卡片展示
- ✅ 语言分布饼图
- ✅ Stars 增长柱状图
- ✅ 实时筛选功能
- ✅ 排序功能
- ✅ 搜索功能
- ✅ 技术新闻列表

## Example Usage

### Example 1: 基本仪表板
```
User: "生成本周 GitHub trending 仪表板"

Assistant:
运行 GenerateDashboard 工具...
[执行命令，生成 /tmp/github-trends.html]
✅ 仪表板生成成功！已在浏览器中打开。
```

### Example 2: 包含新闻的仪表板
```
User: "生成 TypeScript 项目的每日趋势，包含新闻"

Assistant:
生成 TypeScript 每日趋势仪表板，包含技术新闻...
[执行命令：--period daily --language TypeScript --include-news]
✅ 仪表板已生成到 ~/Downloads/ts-daily-trends.html
```

### Example 3: 自定义输出
```
User: "生成一个包含 20 个项目的仪表板，保存到桌面"

Assistant:
生成 20 个项目的趋势仪表板...
[执行命令：--limit 20 --output ~/Desktop/github-trends.html]
✅ 完成！文件已保存到桌面
```

## Tool Options

| 参数 | 说明 | 默认值 | 可选值 |
|------|------|--------|--------|
| `--period` | 时间周期 | `weekly` | `daily`, `weekly` |
| `--language` | 编程语言筛选 | 全部 | TypeScript, Python, Go, Rust等 |
| `--limit` | 返回项目数量 | 10 | 任意正整数 |
| `--include-news` | 包含技术新闻 | false | - |
| `--news-count` | 新闻数量 | 10 | 任意正整数 |
| `--theme` | 主题 | `auto` | `light`, `dark`, `auto` |
| `--output` | 输出文件路径 | `./github-trends.html` | 任意路径 |

## Output Features

### 数据可视化
- **语言分布饼图**: 展示各编程语言的项目占比
- **Stars 增长柱状图**: 展示前 10 名项目的 stars 增长

### 交互功能
- **搜索**: 按项目名称或描述搜索
- **筛选**: 按编程语言筛选
- **排序**: 按排名、总 stars、周期内增长排序

### 响应式设计
- 支持桌面、平板、手机
- 使用 Tailwind CSS 构建美观界面
- GitHub 风格配色

## Error Handling

如果遇到错误：
1. **网络错误**: 检查网络连接，确保能访问 GitHub
2. **解析失败**: GitHub 页面结构可能变化，工具会显示调试信息
3. **文件写入失败**: 检查输出路径的写权限

## Voice Notification

执行此工作流时发送语音通知：

```bash
curl -s -X POST http://localhost:8888/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "正在生成 GitHub Trending Dashboard..."}' \
  > /dev/null 2>&1 &
```

并输出文本通知：
```
Running the **GenerateDashboard** workflow from the **GitHubTrends** skill...
```

## Integration with Other Skills

- **Browser**: 验证生成的 HTML 页面效果
- **System**: 保存仪表板快照到 MEMORY/
- **OSINT**: 分析技术栈趋势

## Notes

- 数据每小时更新一次（GitHub trending 更新频率）
- 生成的 HTML 是完全独立的，无需服务器
- 所有依赖通过 CDN 加载（Tailwind CSS, Chart.js）
- 支持离线查看（图表已内嵌数据）

## Advanced Usage

### 批量生成
```bash
# 生成多个语言的仪表板
for lang in TypeScript Python Go Rust; do
  bun Tools/GenerateDashboard.ts \
    --language $lang \
    --output ~/trends-$lang.html
done
```

### 定时任务
```bash
# 每小时生成一次快照
# 添加到 crontab:
0 * * * * cd ~/.claude/skills/GitHubTrends && bun Tools/GenerateDashboard.ts --output ~/trends-$(date +%H).html
```

### 定制主题
通过修改 `Templates/dashboard.hbs` 可以自定义：
- 配色方案
- 布局结构
- 添加新的图表类型
- 添加新的交互功能