在 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环境变量。
