前言¶
在 DSH（DeepSeek Harness）生态中，插件是扩展能力的核心单元。当开发者从公开仓库安装插件时，不仅需要关注功能是否符合预期，更需警惕仓库本身是否为「假星」「水军刷量」或「供应链投毒」的目标。已有做法往往依赖人工审查，耗时且易遗漏。下面介绍一个基于 CMU StarScout 启发式指标实现的仓库审计插件，它在 DSH 原生环境中提供自动化检测与安装门禁。
这是什么¶
suxeca/dsh-plugin-repo-auditor 是一个 DSH 原生插件，由维护者 Suxeca 开发，分类为 admin-security。它通过 CMU StarScout 论文中的启发式指标，检测 GitHub 仓库的假星、水军账号、空壳代码库，并对插件安装进行供应链投毒与敏感权限的静态预检。
核心功能¶
插件提供五类检测能力：
-
假星与互动比率审计
- 检测 Fork/Star、Watcher/Star 比率异常
- 对大仓（>50k stars）提供通知疲劳校准与豁免模型 -
空壳与脉冲刷量
- 识别高星但代码体积 < 30 KB 的空壳仓库
- 检测活跃跨度不足 2 天的增星脉冲
- 对 0-Issue 异常增星提供豁免（维护者关闭 Issues 时） -
点星水军抽样
- 在一阶指标可疑（评分 < 85）时，并发抽检最新 Stargazers 的 Profile
- 识别「三无空白号」与新注册闪电水军
- 抽样数量可通过sampleSize配置，默认为 5 -
供应链投毒预检
- 静态拉取仓库的package.json与cordis.patch.yml
- 识别高危安装钩子：远程下载、eval、混淆、凭据窃取
- 检测 DSH 敏感权限：密钥服务注入、插件管理服务、宿主进程 API、工具执行前置钩子 -
安装拦截门禁
- 通过工具执行前置钩子（pre-execution hook）监听插件安装动作
- 拦截命令中的git clone/npm install github:...
- 对星标信度低或供应链/敏感权限中高风险的仓库，弹出 DSH 原生审批卡片
安装与启用¶
插件无需构建，安装命令如下：
dsh plugin add github:Suxeca/dsh-plugin-repo-auditor
安装后，在 DSH 配置中启用插件与门禁：
- insert:
- id: repo-auditor
name: '@suxeca/dsh-plugin-repo-auditor'
config:
token: "" # GitHub PAT（可选）
sampleSize: 5 # 水军账号抽样数量
enableInstallGate: true # 安装拦截门禁开关
配置说明¶
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
token |
string |
"" |
GitHub Personal Access Token（可选）。留空时按四级顺序自动探测：config.token → DSH 凭据服务 → 环境变量 GITHUB_TOKEN → 本地 ~/.bashrc / ~/.env / .env。未鉴权时受 60 次/小时配额限制，鉴权后为 5000 次/小时。 |
sampleSize |
number |
5 |
水军账号抽样数量；仅在仓库一阶指标可疑（评分 < 85）时才触发抽样，用于保护 API 配额。 |
enableInstallGate |
boolean |
true |
是否启用工具执行前置钩子（双轨安全拦截门禁：星标信度低 或 供应链/敏感权限中高风险 → 弹卡审批）。 |
紧急逃生通道：在命令前加环境变量 SKIP_REPO_AUDIT=1 可跳过安装门禁。
适用场景与注意¶
该插件适合需要从公开仓库批量安装插件、对仓库真实性有安全要求的 DSH 管理员与智能体开发者。
插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。本仓库为自动生成的发布镜像，源码与开发文档位于 Suxeca/dsh-plugin。
小结¶
仓库审计是 DSH 安全链路中的重要一环。本插件通过 CMU StarScout 启发式指标与静态供应链扫描，为插件安装提供了自动化门禁能力。更多细节与源码，可访问插件目录页与 GitHub 仓库。
- 插件目录页：https://www.skillhub.cn/plugins/Suxeca/dsh-plugin-repo-auditor
- GitHub：https://github.com/Suxeca/dsh-plugin-repo-auditor
