Niubi Guard 使用手册

这份手册会带你完成从 Token 接入、权限设置、仓库同步到自动删除异常 Issue 的完整流程。推荐第一次使用时按顺序操作一遍。

开始前先知道

✓ 写入 GitHub Token 后，Niubi Guard 才能扫描并处理你的仓库 Issue。

✓ 如果仓库属于组织，还需要在 Organization Settings 里开启 Issue deletion 权限。

✓ 仓库默认可以选择“全部保护”，不需要一个一个重复勾选。

✓ 第一次同步和第一次扫描可能会比较慢，请耐心等待。

✓ 最后记得开启自动托管，定时任务才会持续自动删除命中的异常 Issue。

1. 写入 GitHub Token

进入防护中心，把你的 GitHub Personal Access Token 粘贴进去并完成接入。建议使用 Fine-grained Token，并确保它对要保护的仓库具备 Issues、Metadata 和互动限制相关权限。

2. 如果是组织仓库，先打开 Issue deletion

如果你的仓库属于组织账号，请先到 Organization Settings → Member privileges，把 Issue deletion 打开。没有这项权限时，Niubi Guard 可以识别异常 Issue，但无法真正删除它们。

3. 同步仓库并选择保护范围

点击“同步仓库”后，Niubi Guard 会把当前账号下可管理的仓库拉进来。默认建议开启“保护所有仓库”；如果你只想保护部分仓库，也可以只勾选需要的仓库。

4. 开启自动托管

开启后，系统会自动把删除异常 Issue、限制异常账号互动、持续扫描这些能力一起打开。当前默认策略是 Limit to existing users，并保持 6 个月。

5. 等待第一次同步和扫描完成

第一次同步仓库、第一次加载历史 Issue、第一次命中删除都可能比较慢。这是正常现象，尤其是仓库较多或历史 Issue 较多时。请耐心等待，不要在几秒内反复切换配置。

• 确认仓库已经进入受保护范围。

• 确认当前 Token 对该仓库有 Issues 相关权限。

• 确认组织仓库已经开启 Issue deletion。

• 确认自动托管已开启，并等待一次定时任务执行完成。

• 确认防护日志里有没有 delete_issue 或错误信息。

处理过程可能会有几分钟延迟，尤其是在第一次同步和第一次扫描时。只要权限正确、仓库已接入、自动托管已开启，Niubi Guard 就会持续自动处理命中的异常 Issue。