back
loading skill details...
GitHub Trending查看、项目搜索、Star/Fork/Watch操作、Issues管理、Pull Request操作、代码内容获取、评论管理等完整助手。当用户需要查看GitHub Trending排行榜、搜索GitHub项目、对仓库进行操作、管理Issues/PR、获取代码内容时使用此技能。
---
name: github-assistant
description: GitHub Trending查看、项目搜索、Star/Fork/Watch操作、Issues管理、Pull Request操作、代码内容获取、评论管理等完整助手。当用户需要查看GitHub Trending排行榜、搜索GitHub项目、对仓库进行操作、管理Issues/PR、获取代码内容时使用此技能。
license: MIT
---
# GitHub Assistant
> **🌐 默认输出语言：中文**
> 除非用户明确要求使用其他语言，所有回复、Trending 展示、搜索结果、操作反馈均使用中文。
> 项目描述、贡献者用户名、仓库名等原始英文内容保持不变。
通过 GitHub REST API + Playwright 浏览器双模式，提供 GitHub Trending、搜索、仓库操作、Issues/PR管理、代码内容获取等完整能力。
## 能力概览
1. **Trending 查询** — 查看每日/每周/每月热门项目
2. **项目搜索** — 搜索仓库、查看详情
3. **仓库操作** — Star/Unstar/Fork/Watch/Unwatch、创建仓库、列出Forks
4. **Issues 管理** — 创建、列出、关闭、重新打开、评论、标签管理、锁定
5. **Pull Requests** — 创建、列出、关闭、合并、审查、评论、请求审查者
6. **代码内容** — 获取文件、目录、README、创建/更新文件
7. **分支管理** — 列出、创建、删除分支
8. **Releases 管理** — 列出、创建、更新、删除 Release
9. **Actions 操作** — 列出工作流、触发/取消/重新运行工作流
10. **用户操作** — 获取用户信息、列出仓库、关注/取消关注
11. **通知管理** — 列出通知、标记已读
12. **组织操作** — 列出组织、获取组织信息、列出成员
13. **评论管理** — Issue/PR 评论
14. **账户管理** — 登录/登出/状态检查
---
## Onboarding（首次使用必读）
### 环境准备
```bash
cd <skill-dir>/scripts
pip install -r requirements.txt
```
**安装浏览器引擎（仅浏览器模式需要）**
#### 方式1：智能安装脚本（推荐）
```bash
python3 install_browser.py
```
**脚本功能：**
- ✅ 自动检测前10秒下载进度
- ✅ 无进度时提示选择国内镜像源
- ✅ 自动验证浏览器安装状态
- ✅ 支持淘宝/清华/华为云镜像
#### 方式2：默认安装
```bash
python3 -m playwright install chromium
```
#### 方式3：使用国内镜像源（下载失败时使用）
Playwright 支持通过环境变量 `PLAYWRIGHT_DOWNLOAD_HOST` 设置浏览器下载镜像源。
**Mac/Linux:**
```bash
# 使用淘宝镜像（推荐）
PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright python3 -m playwright install chromium
# 或使用清华大学镜像
PLAYWRIGHT_DOWNLOAD_HOST=https://mirrors.tuna.tsinghua.edu.cn/playwright python3 -m playwright install chromium
```
**Windows (PowerShell):**
```powershell
$env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"
python -m playwright install chromium
```
**Windows (CMD):**
```cmd
set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
python -m playwright install chromium
```
**常用镜像源：**
- 淘宝：`https://npmmirror.com/mirrors/playwright`
- 清华：`https://mirrors.tuna.tsinghua.edu.cn/playwright`
- 华为云：`https://mirrors.huaweicloud.com/playwright`
### 登录 GitHub（二选一）
#### 方式A：浏览器手动登录（推荐）
告诉用户："我来帮你打开浏览器登录 GitHub，请在弹出的窗口中手动输入账号密码完成登录。"
执行步骤：
1. 运行 `python3 github_login.py browser`
2. 等待用户在浏览器中完成登录
3. 登录成功后会自动保存 session
> 注意：浏览器模式仅用于 Trending 页面抓取。API操作（Star/Fork/Watch）仍需 Token。
#### 方式B：Token 登录（支持全部操作）
支持两种 Token 类型：**Fine-grained PAT**（推荐）或 **Classic PAT**
---
**选项 1：Fine-grained Personal Access Token（推荐）**
更安全的权限控制，可为每个仓库单独配置权限。
1. **打开设置页面**
- 访问 https://github.com/settings/tokens?type=beta
- 或 GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
2. **生成新 Token**
- 点击 "Generate new token"
- 输入 Token 名称（如：GitHub-Assistant-Skill）
- 设置过期时间（建议 90 天或更长）
- 描述：用于 GitHub Assistant Skill 的完整操作
3. **配置权限（重要！）**
**Repository permissions（仓库权限）- 全部设置为 Read and Write：**
| 权限 | 用途 |
|------|------|
| **Actions** | 读取工作流运行状态 |
| **Administration** | 读取仓库管理信息 |
| **Checks** | 读取检查运行状态 |
| **Commit statuses** | 读取提交状态 |
| **Contents** | 读取/创建/更新/删除文件 |
| **Dependabot alerts** | 读取安全警报 |
| **Deployments** | 读取部署信息 |
| **Discussions** | 读取/创建讨论（如需要） |
| **Environments** | 读取环境信息 |
| **Issues** | 读取/创建/更新/关闭 Issues |
| **Metadata** | 读取基础仓库信息（必需）|
| **Packages** | 读取包信息 |
| **Pages** | 读取 GitHub Pages 信息 |
| **Pull requests** | 读取/合并/审查 PR |
| **Repository security advisories** | 读取安全公告 |
| **Secret scanning alerts** | 读取密钥扫描警报 |
| **Workflows** | 读取工作流 |
**Account permissions（账户权限）：**
- 保持默认即可
4. **选择仓库访问范围**
- **All repositories** - 访问所有仓库（推荐）
- **Only select repositories** - 仅访问指定仓库
5. **生成并保存 Token**
- 点击 "Generate token"
- **⚠️ 立即复制 Token**（页面关闭后无法再次查看）
- 运行 `python3 github_login.py token <TOKEN>`
- 验证成功后 Token 会被安全存储到本地
---
**选项 2：Classic Personal Access Token**
传统的 Token 类型，使用 scopes 权限模型。
1. **打开设置页面**
- 访问 https://github.com/settings/tokens
- 或 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
2. **生成新 Token**
- 点击 "Generate new token (classic)"
- 输入 Token 名称（如：GitHub-Assistant-Skill）
- 设置过期时间（建议 90 天或更长）
3. **选择 Scopes（权限范围）**
**必需 Scopes：**
| Scope | 用途 |
|-------|------|
| `repo` | 完全控制私有仓库（包含所有仓库操作）|
| `public_repo` | 访问公共仓库 |
**推荐 Scopes（根据需要使用）：**
| Scope | 用途 |
|-------|------|
| `workflow` | 更新 GitHub Actions 工作流文件 |
| `read:org` | 读取组织成员信息 |
| `read:user` | 读取用户资料信息 |
| `read:discussion` | 读取团队讨论 |
4. **生成并保存 Token**
- 点击 "Generate token"
- **⚠️ 立即复制 Token**（页面关闭后无法再次查看）
- 运行 `python3 github_login.py token <TOKEN>`
- 验证成功后 Token 会被安全存储到本地
---
**Token 类型对比：**
| 特性 | Fine-grained PAT | Classic PAT |
|------|-----------------|-------------|
| 权限粒度 | 按仓库、按权限细粒度控制 | 全局 scopes |
| 安全性 | 更高，可限制访问范围 | 较低，全局权限 |
| 组织仓库 | 需要组织管理员批准 | 直接可用 |
| 推荐度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 适用场景 | 生产环境、团队协作 | 个人使用、快速测试 |
### 验证登录状态
运行 `python3 github_login.py check` 查看当前登录状态。
---
## 功能指令映射
### 1. 查看 Trending（核心功能）
**触发词**: trending、热门、排行榜、最火
| 参数 | 值 |
|------|-----|
| since | daily（默认）/ weekly / monthly |
| language | python / javascript / go / rust 等（可选）|
**Agent 执行流程**：
> ⚠️ **必须使用浏览器模式** 以获取完整数据（含贡献者和期间Star数）。
> API 模式仅作为 fallback，不包含 `built_by` 和 `period_stars`。
```bash
# 浏览器模式（推荐，自动滚动获取所有项目）
python3 github_trending.py daily "" browser # 今日所有Trending项目
python3 github_trending.py weekly python browser # 本周Python所有Trending项目
python3 github_trending.py monthly "" browser # 本月所有Trending项目
```
> 💡 **自动加载所有项目**：脚本会自动滚动页面，加载 **当日/当周/当月的所有 Trending 项目**（不仅仅是首页显示的），直到没有新项目加载为止。
#### ⭐ Trending 输出格式规范（⚠️ 必须严格遵守）
> 🔴 **重要**：所有 Trending 输出**必须严格遵循以下格式模板**，不得自行创造其他格式。
> 这是本 Skill 的标准输出规范，确保一致性和可读性。
>
> **默认行为**：Agent 在输出 Trending 项目时，**必须严格按照下方「标准输出模板」的格式输出**，包括：
> - 标题格式和日期
> - 热榜概览结构
> - 每个仓库的详解格式（含深度解读）
> - 今日洞察部分
>
> **除非用户明确提出了额外的格式要求或特殊指令**，否则必须完全按照模板输出，不得：
> - 省略任何部分
> - 更改输出格式
> - 使用 Markdown 表格（IM 聊天平台禁止使用）
> - 简化或合并内容
**新模板结构：**
1. **标题** — 带日期和表情符号
2. **热榜概览** — 统计数据和亮点总结
3. **仓库详解** — 每个仓库的详细分析（含深度解读）
4. **今日洞察** — 核心主题、趋势信号、实用推荐
**标准输出模板**（IM聊天平台，不使用Markdown表格）：
```
🔥 GitHub 今日 Trending (2026-04-02)
📊 今日热榜概览
• 总上榜仓库数：8个
• 最大热点：anthropics/claude-code 正式发布，单日 +8,764 ⭐ 爆棚！
• AI 编程 Agent 双雄：Claude Code + OpenAI Codex 同日霸榜
• 热门语言：Python 领跑（5/8），Shell/Rust/JavaScript 跟进
• 数据来源：GitHub Trending 页面（browser 模式）
━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 Trending 仓库详解
━━━━━━━━━━━━━━━━━━━━━━━━━
1. anthropics/claude-code ⭐ 105,566
⭐ Stars: 105,566 | 🍴 Forks: 16,781 | 💻 语言: Shell | 📅 今日上榜
🔗 项目链接: https://github.com/anthropics/claude-code
📝 项目简介：
一款运行在终端中的智能编程工具，能理解你的代码库，通过自然语言命令帮你更快写代码——执行常规任务、解释复杂代码、处理 Git 工作流。
🔍 深度解读：
• 项目定位：Anthropic 官方推出的 AI 编程 Agent 终端工具，Claude Code 正式开源仓库
• 核心功能：终端内 AI 编程助手，代码理解、自动修改、Git 操作全自然语言驱动
• 为何火爆：Claude Code 此前为闭源工具，社区高度关注。今日 +8,764 星标创近期绝对记录，表明开发者对官方开源的热情极高
• 适用场景：所有日常编程开发工作，尤其是需要频繁操作 Git 和代码审查的场景
• 推荐指数：⭐⭐⭐⭐⭐（今日无可争议的第一名）
━━━━━━━━━━━━━━━━━━━━━━━━━
2. openai/codex ⭐ 72,448
⭐ Stars: 72,448 | 🍴 Forks: 10,140 | 💻 语言: Rust | 📅 今日上榜
🔗 项目链接: https://github.com/openai/codex
📝 项目简介：
一款运行在终端中的轻量级编程 Agent。
🔍 深度解读：
• 项目定位：OpenAI 官方的终端编程 Agent，Claude Code 的直接竞争对手
• 核心功能：用 Rust 编写的高性能终端 AI 助手，聚焦轻量和速度
• 为何火爆：与 Claude Code 同日上榜，AI 编程 Agent 赛道竞争白热化的标志
• 适用场景：偏好 OpenAI 生态、追求极致性能的终端编程开发者
• 推荐指数：⭐⭐⭐⭐⭐
━━━━━━━━━━━━━━━━━━━━━━━━━
3. microsoft/VibeVoice ⭐ 34,994
⭐ Stars: 34,994 | 🍴 Forks: 3,977 | 💻 语言: Python | 📅 今日上榜
🔗 项目链接: https://github.com/microsoft/VibeVoice
📝 项目简介：
微软开源的前沿语音 AI 项目。
🔍 深度解读：
• 项目定位：微软出品的开源语音 AI 框架，持续霸榜多日
• 核心功能：前沿语音合成、语音识别能力，面向研究者和开发者
• 为何火爆：微软品牌背书 + 语音 AI 赛道持续升温，连续多日上榜说明热度不减
• 适用场景：语音助手开发、语音 AI 研究、多模态应用
• 推荐指数：⭐⭐⭐⭐
━━━━━━━━━━━━━━━━━━━━━━━━━
💡 今日洞察
🎯 核心主题：AI 编程 Agent 正式进入「双雄时代」
今日 Trending 最大看点是 anthropics/claude-code 和 openai/codex 首次同日上榜：
• Anthropic Claude Code 今日 +8,764 ⭐，创近期单日最高纪录，官方开源引爆社区
• OpenAI Codex 以 +1,416 ⭐ 紧随其后，Rust 实现主打轻量高性能
• 两家 AI 巨头在同一赛道正面交锋，标志着 AI 编程工具从萌芽期进入全面竞争阶段
📈 三大趋势信号：
1️⃣ AI 编程工具全面开源化：Claude Code 官方仓库今日上榜，加上此前社区的逆向工程和 Python 重写版本，整个生态正在从闭源走向开放
2️⃣ AI 基础模型领域扩展加速：google-research/timesfm 将基础模型从 NLP/CV 扩展到时间序列，预示更多垂直领域基础模型将涌现
3️⃣ 语音 AI 持续火热：microsoft/VibeVoice 连续多日上榜，语音作为 AI 交互的重要入口正在被各大厂商押注
🔧 实用推荐：
• 如果你在用 Claude Code → claude-howto 配套教程值得收藏
• 如果你在做时间序列 → google-research/timesfm 是官方优选
• 如果你在做 OCR → zai-org/GLM-OCR 新晋选手值得关注
📡 数据来源：GitHub Trending (browser) | 下次推送：2026-04-03 22:00 CST
```
**关键规则（⚠️ 必须严格遵守）**：
> 🔴 **所有输出必须严格遵循上述模板格式，不得使用Markdown表格或其他格式。**
> 这是本 Skill 的唯一标准输出规范。
- 每个项目之间用 `━━━━━━━━━━━━━━━━━━━━━━━━━` 分隔，提升可读性
- 仓库信息必须包含：名称、链接、描述、语言、Star/Fork、贡献者、新增 Star
- 每个仓库必须有 **🔍 深度解读** 部分，包含：
- 项目定位（一句话说明这是什么）
- 核心功能（技术亮点）
- 为何火爆（上榜原因分析）
- 适用场景（谁应该用）
- 推荐指数（1-5星）
- 输出末尾必须有 **💡 今日洞察** 部分，包含：
- 🎯 核心主题（今日最大看点）
- 📈 趋势信号（2-3个行业趋势）
- 🔧 实用推荐（针对不同用户的建议）
- 📡 数据来源和下次推送时间
- 所有标签使用中文
- since 参数映射：每日→daily、每周→weekly、每月→monthly
- 输出标题使用中文并带日期
### 2. 搜索项目
**触发词**: 搜索、查找、search
```bash
python3 github_search.py repos "机器学习" 10 # 搜索仓库
python3 github_search.py repos "stars:>10000 language:python"
python3 github_search.py users "octocat" # 搜索用户
python3 github_search.py info microsoft vscode # 查看仓库详情
```
**输出格式**：
```
🔍 搜索结果：「关键词」（共 xxx 个）
1. owner/repo
🔗 https://github.com/owner/repo
📝 项目描述...
🔤 Python | ⭐ 12,345 | 🍴 1,234 | Updated: 2024-xx-xx
```
### 3. 仓库操作
**触发词**: star、fork、watch、unwatch、取消关注
> ⚠️ 需要 Token 登录 或 浏览器模式登录
```bash
python3 github_operations.py star microsoft/vscode
python3 github_operations.py unstar owner/repo
python3 github_operations.py fork owner/repo
python3 github_operations.py watch owner/repo
python3 github_operations.py unwatch owner/repo
python3 github_operations.py info owner/repo # 获取仓库信息
python3 github_operations.py starred # 列出已star的仓库
```
**操作反馈**：
```
⭐ 已收藏: microsoft/vscode
🍴 已克隆: owner/repo → your-username/repo
👁️ 已关注: owner/repo
```
### 4. Issues 管理
**触发词**: issue、问题、缺陷、bug
> ⚠️ 需要 Token 登录，权限：Issues (Read and Write)
```bash
# 列出 Issues
python3 github_operations.py issues microsoft/vscode open # open/closed/all
python3 github_operations.py issue microsoft/vscode 1234 # 获取指定 Issue
# 创建 Issue
python3 github_operations.py create-issue owner/repo "Bug标题" "详细描述"
# 关闭/重新打开 Issue
python3 github_operations.py close-issue owner/repo 1234
python3 github_operations.py reopen-issue owner/repo 1234
```
### 5. Pull Requests 操作
**触发词**: pr、pull request、合并请求
> ⚠️ 需要 Token 登录，权限：Pull requests (Read and Write)
```bash
# 列出 PRs
python3 github_operations.py prs microsoft/vscode open # open/closed/all
python3 github_operations.py pr microsoft/vscode 1234 # 获取指定 PR
# 创建 PR
python3 github_operations.py create-pr owner/repo "PR标题" feature-branch main ["描述"]
# 关闭/重新打开 PR
python3 github_operations.py close-pr owner/repo 1234
python3 github_operations.py reopen-pr owner/repo 1234
# 合并 PR
python3 github_operations.py merge-pr owner/repo 1234 "合并标题"
# 审查 PR
python3 github_operations.py approve-pr owner/repo 1234 "LGTM!"
# PR 详情
python3 github_operations.py pr-files owner/repo 1234 # 列出修改的文件
python3 github_operations.py pr-commits owner/repo 1234 # 列出提交记录
python3 github_operations.py pr-reviews owner/repo 1234 # 列出审查记录
```
### 6. 代码内容获取
**触发词**: 代码、文件、内容、readme
> ⚠️ 需要 Token 登录，权限：Contents (Read)
```bash
# 获取文件内容
python3 github_operations.py file owner/repo path/to/file.py [分支/标签]
# 获取 README
python3 github_operations.py readme owner/repo [分支/标签]
# 列出目录
python3 github_operations.py ls owner/repo [path] [分支/标签]
# 创建/更新文件（需要 Contents Write 权限）
python3 github_operations.py create-file owner/repo "path/file.py" "提交信息" "文件内容"
```
### 7. 评论管理
**触发词**: 评论、comment
> ⚠️ 需要 Token 登录，权限：Issues (Write) 或 Pull requests (Write)
```bash
# Issue 评论
python3 github_operations.py comments owner/repo 1234 # 列出评论
python3 github_operations.py comment owner/repo 1234 "评论内容"
```
### 8. 用户操作
**触发词**: 用户、user、followers、关注
> ⚠️ 需要 Token 登录，部分操作需要 user 权限
```bash
# 获取用户信息
python3 github_operations.py user # 当前登录用户
python3 github_operations.py user torvalds # 指定用户
# 列出用户的仓库
python3 github_operations.py my-repos owner # 当前用户的仓库
python3 github_operations.py user-repos torvalds # 指定用户的仓库
# 粉丝和关注
python3 github_operations.py followers # 当前用户的粉丝
python3 github_operations.py following # 当前用户关注的人
python3 github_operations.py follow username # 关注用户
python3 github_operations.py unfollow username # 取消关注
```
### 9. 仓库管理
**触发词**: 创建仓库、create repo
> ⚠️ 需要 Token 登录，权限：Contents (Write)
```bash
# 创建新仓库
python3 github_operations.py create-repo my-new-repo "仓库描述"
# 列出仓库的 Forks
python3 github_operations.py forks owner/repo
# 列出 Stargazers
python3 github_operations.py stargazers owner/repo
```
### 10. 分支管理
**触发词**: 分支、branch
> ⚠️ 需要 Token 登录，创建分支需要 Contents (Write)
```bash
# 列出分支
python3 github_operations.py branches owner/repo
# 获取分支信息
python3 github_operations.py branch owner/repo main
# 创建分支
python3 github_operations.py create-branch owner/repo new-branch main
```
### 11. Releases 管理
**触发词**: release、发布
> ⚠️ 需要 Token 登录，创建需要 Contents (Write)
```bash
# 列出 Releases
python3 github_operations.py releases owner/repo
# 获取指定 Release
python3 github_operations.py release owner/repo <release_id>
# 创建 Release
python3 github_operations.py create-release owner/repo v1.0.0 "Release名称" "发布说明"
```
### 12. Actions 操作
**触发词**: workflow、工作流、actions
> ⚠️ 需要 Token 登录，权限：Actions (Read)、Contents (Read/Write)
```bash
# 列出工作流运行
python3 github_operations.py workflows owner/repo
# 获取指定工作流
python3 github_operations.py workflow owner/repo <workflow_id>
# 触发工作流
python3 github_operations.py trigger-workflow owner/repo ci.yml main
```
### 13. Issue Labels 管理
**触发词**: label、标签
> ⚠️ 需要 Token 登录，权限：Issues (Write)
```bash
# 列出 Issue 标签
python3 github_operations.py labels owner/repo 1234
# 添加标签
python3 github_operations.py add-labels owner/repo 1234 bug priority
# 锁定/解锁 Issue
python3 github_operations.py lock-issue owner/repo 1234 "off-topic"
python3 github_operations.py unlock-issue owner/repo 1234
```
### 14. 通知管理
**触发词**: 通知、notification
> ⚠️ 需要 Token 登录，权限：Notifications
```bash
# 列出通知
python3 github_operations.py notifications # 未读通知
python3 github_operations.py notifications --all # 所有通知
# 仓库通知
python3 github_operations.py repo-notifications owner/repo
# 标记已读
python3 github_operations.py mark-read <thread_id>
```
### 15. 组织操作
**触发词**: 组织、org
```bash
# 列出当前用户的组织
python3 github_operations.py orgs
# 获取组织信息
python3 github_operations.py org github
# 列出组织仓库
python3 github_operations.py org-repos github
# 列出组织成员
python3 github_operations.py org-members github
```
### 16. 其他操作
```bash
# 查看提交历史
python3 github_operations.py commits owner/repo [文件路径]
# 检查登录状态
python3 github_operations.py check
# 查看 API 限流
python3 github_operations.py rate-limit
```
### 17. 浏览器自动化操作（API 不支持的功能）
**触发词**: 贡献图、insights、流量、网络图、blame、设置页面、探索、marketplace
> ⚠️ 这些功能 GitHub REST API 不支持，需要通过浏览器自动化实现
> 浏览器操作过程可见，操作结束后浏览器保持打开，用户可继续手动操作
```bash
# 用户相关（API 不支持）
python3 github_browser_ops.py contributions torvalds # 查看贡献图
python3 github_browser_ops.py activity torvalds # 查看活动时间线
python3 github_browser_ops.py stars torvalds # 查看 Star 列表页面
python3 github_browser_ops.py followers torvalds # 查看粉丝列表页面
python3 github_browser_ops.py sponsors torvalds # 查看赞助页面
# 仓库 Insights（需要 push 权限）
python3 github_browser_ops.py insights owner/repo # Pulse 概览
python3 github_browser_ops.py traffic owner/repo # 流量统计
python3 github_browser_ops.py network owner/repo # Fork 网络图
python3 github_browser_ops.py dependents owner/repo # 依赖者列表
# 代码相关
python3 github_browser_ops.py blame owner/repo path/file.py # Git Blame
python3 github_browser_ops.py history owner/repo path/file.py # 文件提交历史
python3 github_browser_ops.py compare owner/repo main dev # 分支比较
python3 github_browser_ops.py codesearch owner/repo "keyword" # 仓库内代码搜索
# 设置页面
python3 github_browser_ops.py settings # 用户设置
python3 github_browser_ops.py settings owner/repo # 仓库设置
# 导航
python3 github_browser_ops.py notifications # 通知页面
python3 github_browser_ops.py explore # Explore 页面
python3 github_browser_ops.py marketplace # Marketplace
python3 github_browser_ops.py search "query" # GitHub 搜索
python3 github_browser_ops.py goto "https://..." # 导航到指定 URL
# 浏览器控制
python3 github_browser_ops.py close # 关闭浏览器
```
**操作反馈**：
```
🌐 正在导航到: https://github.com/torvalds
📋 查看用户 @torvalds 的个人资料
✅ 页面加载完成: https://github.com/torvalds
💡 浏览器保持打开，您可以继续手动操作。
浏览器将保持打开状态，您可以继续手动操作。
如需关闭浏览器，请运行: python3 github_browser_ops.py close
```
---
## 浏览器模式指南（Agent专用）
当需要使用 Playwright 浏览器（browser_* 工具）时，遵循以下流程：
### Trending 页面数据提取
**URL 格式**：
- 全语言：`https://github.com/trending?since={daily|weekly|monthly}`
- 按语言：`https://github.com/trending/{language}?since={daily|weekly|monthly}`
**页面 CSS 选择器映射**：
| 数据项 | 选择器 / 提取方式 |
|--------|------------------|
| 仓库名 | `article h2 a` → `href` 去掉前导 `/` |
| 描述 | `article p` → innerText |
| 语言 | `article [itemprop="programmingLanguage"]` → innerText |
| 总Stars | `article a[href*="/stargazers"]` → innerText |
| Forks | `article a[href*="/forks"]` → innerText |
| 贡献者 | `article a` 中 textContent 以 `@` 开头的链接 |
| 期间Stars | 正则匹配 innerText: `(\d[\d,]*) stars (today\|this week\|this month)` |
### 浏览器执行 Star 操作（备选方案）
```
1. 导航到 https://github.com/{owner}/{repo}
2. 找到 "Star" 按钮（已登录状态）
3. 点击 Star
4. 确认按钮变为 "Starred"
```
### 浏览器执行 Watch 操作（备选方案）
```
1. 导航到 https://github.com/{owner}/{repo}
2. 找到 "Watch" 下拉按钮
3. 选择 "Custom" → "Issues, Pull Requests" 等
4. 确认已变为 "Watching"
```
---
## 权限速查表
| 操作 | 所需权限 | 权限级别 |
|------|---------|---------|
| Trending 查看 | 无需登录 | - |
| 项目搜索 | 无需登录 | - |
| Star/Unstar | Token | - |
| Fork | Token | - |
| Watch/Unwatch | Token | Metadata (Read) |
| 查看仓库信息 | Token | Metadata (Read) |
| **创建仓库** | Token | Contents (Write) |
| **列出 Issues** | Token | Issues (Read) |
| **创建/关闭 Issue** | Token | Issues (Write) |
| **Issue Labels** | Token | Issues (Write) |
| **锁定 Issue** | Token | Issues (Write) |
| **列出 PRs** | Token | Pull requests (Read) |
| **创建/关闭 PR** | Token | Pull requests (Write) |
| **合并 PR** | Token | Pull requests (Write) |
| **PR 审查** | Token | Pull requests (Write) |
| **获取文件内容** | Token | Contents (Read) |
| **创建/更新文件** | Token | Contents (Write) |
| **分支管理** | Token | Contents (Write) |
| **Release 管理** | Token | Contents (Write) |
| **查看 Actions** | Token | Actions (Read) |
| **触发工作流** | Token | Contents (Write) |
| **用户信息** | Token | - |
| **关注用户** | Token | user:follow |
| **通知** | Token | Notifications |
| **组织信息** | Token | read:org |
---
## 文件结构
```
github-assistant/
├── SKILL.md ← 你正在读的文件
├── README.md ← GitHub项目介绍
├── LICENSE ← MIT 许可证
├── scripts/
│ ├── github_trending.py ← Trending抓取（浏览器模式）
│ ├── github_search.py ← 项目搜索
│ ├── github_operations.py ← 完整操作（Star/Fork/Issues/PR/代码/评论）
│ ├── github_browser_ops.py ← 浏览器自动化操作（API不支持的功能）
│ ├── github_login.py ← 登录管理
│ ├── install_browser.py ← 浏览器安装脚本
│ ├── config.py ← 集中配置管理
│ └── requirements.txt ← Python依赖
├── references/
│ └── github_api_endpoints.md ← API参考
└── assets/
~/.github-assistant/ ← 用户数据目录（不在skill文件夹内）
├── github_token.txt ← Token存储
├── github_auth.json ← 浏览器session
└── browser_data/ ← 浏览器持久化数据
```
> ⚠️ **安全说明**：敏感数据（Token、浏览器会话）存储在用户目录 `~/.github-assistant/`，不会出现在 skill 文件夹中，可安全上传到公开仓库。
## 注意事项
- Token 存储在本地文件 `github_token.txt`，请勿上传到公开仓库
- GitHub API 限流：未认证 60次/小时，认证后 5000次/小时
- 浏览器模式首次需安装 Chromium：`playwright install chromium`
- Trending 查询优先使用浏览器模式以获取完整数据（含贡献者和期间Star数）
- IM 聊天平台**禁止使用 Markdown 表格**，使用 emoji + 列表格式
- Fine-grained PAT 权限需要仔细配置，权限不足会导致操作失败
don't have the plugin yet? install it then click "run inline in claude" again.