Skip to content

Latest commit

 

History

History
53 lines (36 loc) · 2.64 KB

CONTRIBUTING.md

File metadata and controls

53 lines (36 loc) · 2.64 KB

贡献指南

感谢你愿意帮助卡阅。这个仓库只公开站点、文档、参考资料索引与安装包;核心应用源码不在公开范围内。

可以贡献什么

  • Bug 报告:描述设备、Android 版本、应用版本、复现步骤与实际/预期结果。
  • 数据更正:BIN、银行名称、卡产品名、城市/卡种/站点信息;请附公开来源,不要只凭记忆。
  • 站点与文档:错别字、失效链接、可访问性、构建与校验脚本的改进。
  • 协议资料:公开规范、官方文档或开源实现的链接,标明许可与适用范围。

不能接受什么

  • 写入、克隆、模拟、充值、破解卡片密钥的代码或教程。
  • 真实卡号、证件号、证件照、完整 APDU、密钥、签名文件或任何用户数据。
  • 第三方 APK、反编译产物、规范 PDF、含第三方角色形象的素材。
  • 核心 Android / Windows / iOS 源码的补丁或整包拷贝。应用源码不公开,维护者无法合并这类贡献。
  • 绕过签名、完整性校验、访问控制或平台安全机制的内容。

报告 Bug

  1. 先搜索已有 Issues。
  2. 使用 Bug 模板,填写版本、设备、卡片类型与复现步骤。
  3. 脱敏后再粘贴诊断文本:卡号只保留前 6 位,删除姓名、证件号、证件照、应用序列号与原始 APDU。
  4. 涉及安全问题时不要开公开 Issue,按 SECURITY.md 私下报告。

提交站点或文档改动

  1. Fork 仓库,从 main 创建分支。

  2. 修改后运行:

    node scripts/check-site.mjs
  3. 提交 Pull Request,说明改动目的、影响的页面和验证方式。

  4. 涉及版本清单的改动必须同时更新 site/data/releases.json、site/index.html 与 site/downloads/ 中的安装包,并保证同一渠道的 versionCode 递增。

数据来源要求

  • 每条数据尽量给出可公开访问的来源链接与访问日期。
  • 区分“官方公布”“开源数据整理”“社区报告”“真卡验证”;没有证据就写“未验证”。
  • 不要删除现有署名与许可声明。新增数据必须确认许可允许再分发;不允许再分发的数据只能给链接,不能提交内容。

许可

  • 站点、文档、参考资料索引与脚本采用 MIT,见 LICENSE。
  • 安装包与未公开的应用源码采用专有许可,见 APP-LICENSE.md。
  • 提交贡献即表示你有权提交该内容,并同意按对应许可发布。

行为准则

参与本项目即表示同意遵守 CODE_OF_CONDUCT.md。