背景

• scripts/dev-setup.sh / scripts/dev-setup.ps1 将 golangci-lint、gitleaks、pre-commit 安装到 managed 目录（Linux/macOS 为 ~/.local/share/gitcode-cli/dev-tools/bin），设计上不修改 shell profile，仅在结尾输出一行 export PATH 提示。
• .pre-commit-config.yaml 中 gitleaks 钩子为 language: system，依赖 PATH 解析。
• 后果：贡献者运行 dev-setup 显示 "dev environment ready" 后，若未将 managed bin 加入 PATH，首次 git commit 时钩子因找不到 gitleaks 直接失败，报错仅为 gitleaks: command not found，与 dev-setup 的关联不可见，排查成本高。

改动建议

1. dev-setup.sh / dev-setup.ps1：
   • 检测 managed bin 是否在 PATH 上；缺失时将结尾提示升级为明确警告（说明 pre-commit/pre-push 钩子会失败），并给出可直接粘贴的 profile 配置示例
   • --check 模式将 PATH 缺失计入 gap 并非零退出
2. go mod download 失败时的 gap 提示增强：提示检查网络与 go env GOPROXY；proxy.golang.org 不可达时可切换公共 Go 模块镜像，例如：

   go env -w GOPROXY=https://goproxy.cn,direct
   # 或 go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
   

   （示例性列举常见公共镜像，由使用者按自身网络环境选择；是否将镜像示例嵌入脚本输出、还是仅保留在文档，可在评审时定夺）
3. 同步更新 scripts/test-dev-setup.* 契约测试（CI 3 OS 运行，见 spec/delivery/ci-workflows.md）
4. CONTRIBUTING.md managed bin 段落补充 PATH 与钩子依赖关系的后果说明

验收标准

• 未配置 PATH 的全新环境：dev-setup 成功输出含"钩子将失败"警告；--check 报 gap 且非零退出
• go mod download 失败提示含 GOPROXY 检查指引与公共镜像示例（如 goproxy.cn、阿里云），措辞为示例而非指定推荐
• scripts/test-dev-setup.* 在 Linux/macOS/Windows 全部通过
• 不改变"脚本不修改 shell profile"的既有契约

影响范围

scripts/dev-setup.sh、scripts/dev-setup.ps1、scripts/test-dev-setup.*、CONTRIBUTING.md