贡献指南(CONTRIBUTING)

August 16, 2026 · View on GitHub

感谢你愿意帮 dsh-lab 变得更好。四种贡献方式,任选其一:

1. 送测请求

想让某个插件进入实测队列?开一个 issue,标题 [送测] <插件名>,包含:

  • 仓库或 npm 链接;
  • 一句话说明它解决什么问题;
  • 你认为值得测的理由(例如"同类插件很多但没人验证过")。

我们会按队列测试并发布报告(遵守 METHODOLOGY.md 的四关协议)。

2. 实测不一致反馈

你复现了某份报告,但结果不同?开 issue,标题 [复现不一致] <插件名>,必须包含:

  • 你的复现命令与完整日志;
  • 你的 DSH / pnpm / node 版本;
  • 与报告不一致的具体关卡。

我们复测后:结果确属报告过期 → 更新报告并保留勘误记录;结果无法复现 → 在 issue 里说明环境差异。

3. 教程纠错 / 新教程

直接提 PR。要求:

  • 原创:不接受从任何其他仓库、目录、博客搬运的文案。翻译类内容须注明来源并确认许可。
  • 事实可验证:涉及命令与行为的,附你本机的验证输出或注明版本。
  • 中文为主,专有名词保留英文。

4. 路线图建议

对阶段 2(兼容矩阵)、阶段 3(竞技场)的设计有想法?开 issue,标题 [路线图] ...。我们特别欢迎:矩阵的数据结构建议、竞技场的评分口径建议、愿意贡献的 CI/工具代码。


底线

  • 诚实第一:没有测过的事不要写"已验证"。
  • 对事不对人:批评插件时只批评可复现的行为,不攻击作者。
  • 安全边界:本仓库是测试记录,不是安全背书;不要在本仓库发布未经验证的安全承诺。