原始来源日期:2026-10-02。
原文编译
新的REST接口让安全工具能够列出、新增和编辑仓库安全公告评论,并可按更新时间增量同步。GitHub把功能标为public preview,普通评论继续遵循安全公告现有协作者权限。接口目前不提供删除操作,自动化需要把更正设计为编辑或追加说明。
同日上线的机密评论解决维护者内部讨论问题。拥有仓库写权限的人可以把评论标记为Confidential;漏洞报告者和没有写权限的受邀协作者既看不到内容,也不会收到通知。查看机密评论会写入审计日志,人员失去写权限后也随即失去读取能力。
普通与机密是发布时确定的属性,之后不能相互转换。机密评论可通过GraphQL访问,但REST API不会返回;因此同时使用两套API的同步工具若只抓REST,会得到有意不完整的时间线。公开统计中的评论数量也不能被直接解释为所有人都可见的内容数。
功能适用于启用私密漏洞报告的公共仓库以及相应GitHub方案。维护者可以在同一公告内保留调查敏感细节,但这也要求机器人令牌和导出工具严格遵循最小权限,避免把GraphQL取得的机密文本写入公开工单。
量仔观察
本站认为自动化首先要识别可见性,而不是把评论统一当作字符串。数据模型应保留confidential属性、来源API和访问主体,并在日志、搜索索引与通知中继承同样边界。
由于评论不能事后切换,维护者在发布前需要明确选择。误发机密信息到普通评论不能靠改标签补救;应准备内容删除或公告处置流程,并对拥有写权限的机器人定期审计。
