GitHub知识库

管理本地GitHub知识库，并通过gh CLI提供GitHub搜索功能。关键文件：知识库目录根部的GITHUB_KB.md文件，用于记录所有项目及其简要描述。

配置

使用前请设置环境变量：

• GITHUB_TOKEN- GitHub个人访问令牌（可选，用于私有仓库）
• GITHUB_KB_PATH- 本地知识库目录的路径（默认：/home/node/clawd/github-kb）

示例：

export GITHUB_TOKEN="ghp_xxxx..."
export GITHUB_KB_PATH="/your/path/github-kb"

令牌隐私：切勿硬编码令牌。应通过环境变量或容器机密注入。

GitHub CLI (gh)

要求：必须安装并完成身份验证的GitHub CLI。

安装：

• macOS： brew install gh
• Linux： apt install gh或查看官方安装指南
• Windows： winget install GitHub.cli

认证：

# Interactive login
gh auth login

# Or use token from GITHUB_TOKEN env var
gh auth login --with-token <(echo "$GITHUB_TOKEN")

验证： gh auth status

如果gh未安装或未认证，请跳过搜索操作，仅使用本地知识库功能。

搜索仓库

# Search repos by keyword
gh search repos <query> [--limit <n>]

# Examples:
gh search repos "typescript cli" --limit 10
gh search repos "language:python stars:>1000" --limit 20
gh search repos "topic:mcp" --limit 15

搜索限定符：

• language:<语言>- 按编程语言筛选
• stars:<数量>或stars:><数量>- 按星标数量筛选
• topic:<名称>- 按主题筛选
• user:<所有者>- 在用户的仓库中搜索
• org:<组织>- 在组织中搜索

搜索问题

gh search issues "react hooks bug" --limit 20
gh search issues "repo:facebook/react state:open" --limit 30
gh search issues "language:typescript label:bug" --limit 15

搜索限定符：

• repo:<所有者/仓库>- 在特定仓库中搜索
• state:open|closed- 按问题状态筛选
• author:<用户名>- 按作者筛选
• label:<名称>- 按标签筛选
• language:<语言>- 按仓库语言筛选
• comments:<n>或comments:><n>- 按评论数量筛选

搜索拉取请求

# Search PRs
gh search prs <query> [--limit <n>]

# Examples:
gh search prs "repo:vercel/next.js state:open" --limit 30
gh search prs "language:go is:merged" --limit 15

搜索限定符：

• repo:<所有者/仓库>- 在特定仓库中搜索
• state:open|closed|merged- 按PR状态筛选
• author:<用户名>- 按作者筛选
• label:<名称>- 按标签筛选
• language:<语言>- 按仓库语言筛选
• is:merged|unmerged- 按合并状态筛选

查看 PR/Issue 详情

# View issue/PR details
gh issue view <number> --repo <owner/repo>
gh pr view <number> --repo <owner/repo>

# View with comments
gh issue view <number> --repo <owner/repo> --comments
gh pr view <number> --repo <owner/repo> --comments

本地知识库工作流程

在知识库中查询关于某个仓库的信息

1. 阅读 GITHUB_KB.md 以了解存在哪些项目
2. 在 ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/ 目录下定位项目目录

将新仓库克隆到知识库

1. 如果不知道完整的仓库名称，请搜索 GitHub
2. 克隆到知识库目录：

   git clone https://github.com/<owner>/<name>.git ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/<name>
   

3. 生成项目描述：阅读 README 或关键文件以了解项目
4. 更新 GITHUB_KB.md：按照现有格式为新仓库添加条目：

   ### [<name>](/<name>)
   Brief one-line description of what the project does. Additional context if useful (key features, tech stack, etc.).
   

5. 确认完成：告知用户仓库已克隆及其位置

默认克隆位置

如果用户只说“克隆 X”而未指定目录，则默认克隆到 ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/。

GITHUB_KB.md 格式

目录文件遵循以下结构：

# GitHub Knowledge Base

This directory contains X GitHub projects covering various domains.

---

## Category Name

### [project-name](/project-name)
Brief description of the project.

更新时请保持分类和格式的一致性。