GitHub Reader Skill v3.2

深度解讀 GitHub 專案 / Deeply Analyze GitHub Projects

📖 輸入 GitHub 倉庫連結，自動生成結構化分析報告 — 純 GitHub REST API，不經過任何第三方服務。

🚀 安裝 / Installation

cd github-reader/
./install_v3_secure.sh

重啟 Agent gateway：

來源於7w4.net。

openclaw gateway restart

💡 用法 / Usage

命令方式（推薦，精準觸發）

/github-read microsoft/BitNet

GitHub URL

https://github.com/HKUDS/nanobot

自然語言（需包含 owner/repo）

分析 HKUDS/nanobot
解讀倉庫：microsoft/BitNet

⚠️ 注意：不帶倉庫名的泛化語句（如 "幫我分析這個倉庫"）不會觸發，避免誤觸發。

📊 輸出示例 / Output Example

# 📦 microsoft/BitNet 深度解讀報告

> 分析時間: 2026-05-24 15:30
> 資料來源: GitHub REST API（純 API，不經第三方）

---

## 💡 專案簡介
BitNet.cpp 是微軟官方推出的 1 位元量化大語言模型推理框架...

## 📊 專案卡片

| 指標 | 值 |
|------|-----|
| ⭐ Stars | 12.5k |
| 🍴 Forks | 2.1k |
| 📝 Issues | 156 |
| 🐍 語言 | Python |
| 📄 許可證 | MIT License |
| 🕐 最後更新 | 3天前 |

## 🔗 連結
| 平臺 | 連結 |
|------|------|
| GitHub | https://github.com/microsoft/BitNet |

## 📖 README 摘要
> BitNet.cpp is the official inference framework for 1-bit LLMs...

## 🔗 快速開始
```bash
git clone https://github.com/microsoft/BitNet.git
cd BitNet

🔒 資料流向宣告：本次分析僅使用 GitHub REST API，不會將倉庫資訊傳送給任何第三方服務。分析結果本地快取 24 小時，快取目錄：/tmp/gitview_cache。

v3.2 — 純 GitHub API，無第三方資料外傳

---

## 🔒 隱私與安全 / Privacy & Security

### 資料流向
- ✅ **僅使用 GitHub 官方 REST API**（`api.github.com`）
- ✅ **不經過任何第三方服務**（Zread、GitView 等已移除）
- ✅ **分析結果本地快取**，快取位置和時長可配置
- ✅ **不訪問使用者的私有倉庫列表或 Token**

### 快取管理
快取目錄：`/tmp/gitview_cache`（預設），可通過環境變數修改：
```bash
export GITVIEW_CACHE_DIR="/path/to/cache"  # 快取目錄
export GITVIEW_CACHE_TTL="24"              # 快取時間（小時）

清除快取：rm -rf /tmp/gitview_cache

⚙️ 配置 / Configuration

# 快取配置
export GITVIEW_CACHE_DIR="/tmp/gitview_cache"
export GITVIEW_CACHE_TTL="24"
export GITVIEW_CACHE_MAX_SIZE="1"    # MB

# 效能配置
export GITVIEW_GITHUB_DELAY="1.0"    # API 呼叫間隔（秒）

# 超時配置
export GITVIEW_GITHUB_TIMEOUT="10"   # API 超時（秒）

📈 效能指標 / Performance

📁 檔案結構 / File Structure

github-reader/
├── github_reader_v3_secure.py    # v3.2 主程式碼（純 API）
├── __init__.py                   # Skill 註冊
├── clawhub.json                  # ClawHub 後設資料
├── SECURITY.md                   # 安全說明（程式碼對應）
├── SKILL.md                      # 本檔案
├── RELEASE_NOTES.md              # 釋出說明
├── README.md                     # 簡要說明
├── README_BILINGUAL.md           # 雙語說明
├── README_EN_CN.md               # 詳細中英對照
├── PACKAGE.md                    # 打包說明
└── install_v3_secure.sh          # 安裝指令碼

🔄 版本變更（v3.1 → v3.2）

📄 許可證 / License

MIT License

👨‍💻 作者 / Author

Kris Lu

版本: v3.2（純 API 安全版）
最後更新: 2026-05-24

這個工具用起來不錯，能快速生成 GitHub 專案的分析報告，資訊全面、更新及時，而且不向第三方傳送資料，隱私有保障。不過分析質量依賴專案的 README 是否完整規範，部分冷門專案的摘要可能不夠準確。介面提示友好，但使用前需要了解正確的輸入格式。總體來說是款用心之作，適合經常逛 GitHub 的使用者使用。