在 DeepSeek Harness (DSH) 的插件生態中，聯網工具通常需要處理複雜的 API 鑑權和數據展示。dsh-github-mcp-hint 是一個專注於 GitHub MCP 交互的輔助插件。它解決了開發者在使用 GitHub MCP 時缺乏示例參考以及無法直觀查看公開倉庫數據的問題。
這是一個由開發者 ZIye1208 維護的聯網工具插件。它提供兩個核心能力：一是將 GitHub MCP 的示例用法整理成面板，隨機展示並支持複製；二是提供 GitHub 倉庫的公開數據可視化統計與對話工具。
核心功能¶
1. GitHub MCP 示例提示面板¶
在 DSH 的「設置 → 插件」中，dsh-github-mcp-hint 會作爲 GitHub MCP 的子入口出現。面板內置 30 條示例用法，每次隨機展示 4 條。用戶可以點擊示例文本將其直接複製到剪貼板，用於快速構建查詢。
2. 公開倉庫統計（可視化）¶
在面板中輸入 GitHub 用戶名，插件會可視化展示該用戶的公開倉庫統計，包括 ⭐星數、🍴fork 數和使用的編程語言。點擊對應的倉庫鏈接可跳轉查看詳情。
爲了保證在未認證情況下不觸發 GitHub API 的限流（403），前端採用了本地緩存策略：結果會存儲在 localStorage 中，30 分鐘內不重複請求。同時具備容錯機制，遇到網絡失敗或 403 錯誤時會回退展示緩存數據並給出提示。
3. 模型工具¶
插件提供了兩個模型工具供對話調用：
* gh_repo_stats：讀取環境變量 GITHUB_TOKEN，拉取當前賬號全部倉庫（含私有倉庫）的星數、fork 數及近 14 天克隆量。併發拉取克隆量，最多列出前 30 個，避免觸發限流。
* gh_current_user：返回當前 token 對應的 GitHub 賬號（login），用於在對話中核對當前登錄狀態。
安裝與啓用¶
本插件依賴宿主已接入 GitHub MCP（需配置 GITHUB_TOKEN 並在 cordis.patch.yml 中添加相關配置）。在確保前置條件滿足後，執行以下命令安裝：
dsh plugin --profile web add dsh-github-mcp-hint
安裝後，該插件不會自動出現在插件列表中。必須顯式安裝，它纔會作爲 GitHub MCP 的子功能出現在「設置 → 插件 → GitHub MCP」入口下。
典型用法¶
- 查看統計：在設置頁的 GitHub MCP 面板中輸入目標用戶名，查看公開倉庫的星、叉和語言分佈。
- 對話查詢：在對話中直接詢問“我的倉庫有多少星多少下載”，模型會調用
gh_repo_stats工具返回詳細數據。 - 覈對賬號：在對話中詢問“當前 GitHub 賬號是誰”，模型會調用
gh_current_user工具返回賬號信息。 - 複製示例：點擊面板中的示例文本，即可將其複製到剪貼板。
注意事項¶
- 顯式安裝：插件僅作爲
dsh-github-mcp的依賴被攜帶，如果只安裝了dsh-github-mcp而未執行上述安裝命令，該面板不會自動顯示。 - 鑑權與緩存：公開數據的可視化展示使用前端直連 API 並配合本地緩存降頻，以避免消耗 GitHub 未認證配額；而需要鑑權（如私有倉庫）的克隆量數據則通過宿主側的工具獲取。
- Token 配置：使用
gh_repo_stats和gh_current_user工具時，必須配置有效的GITHUB_TOKEN環境變量。
