补充部署脚本netstat端口检测

doc/implementation-report-2026-04-01-production-one-click-deploy-netstat-fallback.md

@@ -0,0 +1,32 @@
+# 生产一键部署脚本 netstat 端口检测兼容实施记录
+
+## 问题现象
+- 运行 `bin/prod/deploy_from_package.sh` 时出现报错：
+  - `[2026-04-01 02:45:09] 缺少端口检测命令: ss 或 lsof`
+
+## 根因分析
+- 脚本启动后端前会先检查端口检测命令
+- 之前的实现只支持 `ss` 和 `lsof`
+- 用户实际环境中两者都不可用，因此脚本在前置校验阶段直接退出
+- 当前仓库开发环境中还存在 `netstat`，说明“只支持 `ss`/`lsof`”不是部署链路本身的要求，而是脚本实现约束过窄
+
+## 修改内容
+- 更新 `bin/prod/deploy_from_package.sh`
+- 将端口检测命令支持范围从：
+  - `ss`
+  - `lsof`
+  扩展为：
+  - `ss`
+  - `lsof`
+  - `netstat`
+- 更新端口检测失败提示文案为“缺少端口检测命令: ss、lsof 或 netstat”
+- 更新 `bin/prod/deploy_from_package_test.sh`
+- 新增 `netstat` 回退场景自测，验证在 `PATH` 中无 `ss`、无 `lsof`、仅有 `netstat` 时脚本仍可正常完成部署
+
+## 验证结果
+- 已执行 `sh -n bin/prod/deploy_from_package.sh`
+- 已执行 `sh bin/prod/deploy_from_package_test.sh`
+- 自测结果覆盖：
+  - 正常部署成功
+  - 多个发布 zip 失败
+  - 仅 `netstat` 可用时，端口监听检测仍然通过