ConnProof

开源项目总览 ​

ConnProof 的诊断工具以 MIT 许可证开源，代码在 connproof-tool。开源不只是代码可见——工具的隐私承诺（不上传、默认脱敏、不扫描）之所以可信，正因为每一行实现都可以被审查。这个栏目面向想要理解、使用或改进这个项目的开发者与贡献者。

公开的是需要被审查的部分：CLI、诊断规则库、DNS/TCP/TLS/HTTP/WebSocket 检测器、脱敏器、报告渲染器与浏览器端检测代码。站点内容与运营配置不在其中，它们不参与上述任何一条承诺的实现。

文档入口 ​

  • 项目架构 —— pnpm workspace 的包结构、各包职责与依赖关系、"工具与文档共用规则库"的实现方式；
  • 添加一条诊断规则 —— 从发现新故障模式到规则发布的完整流程：错误码分配、规则字段、配套文档与测试要求；
  • 报告数据结构 —— DiagnosticReport 的字段说明与稳定性承诺，供客服系统和自动化工具接入；
  • 贡献指南 —— 开发环境、代码规范、提交流程与安全红线。

欢迎的贡献类型 ​

  • 新诊断规则：附原始报错、可复现环境与检测证据；
  • 文档修正：结论过时、步骤有误，附依据提交；
  • 测试样本：本地可复现的故障样本（不依赖公网服务）；
  • 兼容性报告：不同系统与客户端上的行为差异。

不会被接受的改动 ​

为保持项目边界清晰，以下方向的 PR 会被直接关闭：任何形式的数据上传、订阅解析/转换/合并、网段扫描或批量端口枚举、绕过证书验证并将结果标记为安全、以及任何漏洞利用或认证绕过功能。详见仓库根目录的 RESPONSIBLE-USE 文档。