Skip to content

Security: yijiu2025/theme

SECURITY.md

安全策略(Security Policy)

报告渠道

请勿为安全漏洞开设公开 issue。 统一走 GitHub 私密漏洞报告(GHSA):

https://github.com/yijiu2025/theme/security/advisories/new

⚠️ 维护者注意:该链接需先在 Settings → Code security → Private vulnerability reporting 点 Enable 才可用(未开启会 404)。公开仓库默认支持此功能。

报告请包含:受影响的导出 API / 版本、复现或利用路径、影响评估(能注入什么 / 绕过什么)、你的使用形态(npm 版 / monorepo 源码直供)。

响应时限

阶段 承诺
确认收悉 48 小时
评估结论(含 CVSS 定级与修复计划) 10 个工作日
协同披露 修复发布后 90 天内,或双方另行约定

修复发布后,将在 Release 说明与致谢名单中提及报告者(除非你要求匿名)。

支持版本

只维护最新 minor。请先在最新 release 上复现再报告;更早版本的问题一般不回填。

本仓的漏洞判定范围

skinsuite 是零运行时依赖的纯逻辑内核,没有 DOM、没有网络、没有密钥——攻击面集中在「被下游当作安全边界使用」与「发布通道」两处。判定口径如下,避免无效报告:

在范围内

  • token 校验可被绕过:CSS 变量 token 的安全校验(如变量名 / 值格式白名单)存在可绕过的注入路径,导致未净化值进入宿主样式表(下游常见的 XSS 落地方式)
  • 鸭子类型判据静默落后:由接口派生的判据(如 Record<keyof T, …>)因手抄成员名等原因与类型脱节,导致本应拦截的非法输入被放行
  • 设备 / URL 参数读取缺陷:readDeviceParam 等对空串、非法值、大小写的处理与契约不符,被宿主当作可信来源使用
  • 产物与源码不一致:dist/ 与 src/ 行为分歧(NodeNext 说明符、导出面漂移),导致按文档消费的一方踩坑
  • 供应链:npm 发布通道、GitHub Actions workflow、tag 被劫持或篡改

不在范围内(预期设计,不算漏洞)

  • 包不提供 XSS 防护全链路:本包只做「值形态合法」的白名单校验;把用户输入渲染进 DOM 是宿主的责任
  • 主题 / 配色的具体视觉值不安全(如某配色对比度不足):这是无障碍议题,见 ACCESSIBILITY.md
  • 下游应用自身的安全问题(登录态、权限、接口越权):请报告给对应应用仓库
  • 单纯的功能建议或类型瑕疵:请开普通 issue

处理流程

确认 → 定级(CVSS v3.1)→ 修复分支 → 发版(按破坏性定 major / minor)→ 公开披露与致谢。高危漏洞在修复发布前,维护者会尽量提前通知已知的消费方。

禁止事项

  • 修复发布前公开传播漏洞细节或利用代码
  • 未经授权对生产部署站点进行扫描 / 渗透测试
  • 在报告中包含真实用户数据、生产密钥或任何敏感信息(提供脱敏复现即可)

致谢

本策略参考 GitHub 安全策略最佳实践编写;内核特有的判定范围(token 校验、鸭子类型判据、产物一致性、供应链)为本仓自定义。

There aren't any published security advisories