很多用户的云服务器上早就有一个正在跑核心业务 Node 后端目录(名字常叫 cloud-backend、server、app)。当你想给这个后端「加一个新功能模块」时,最大的风险不是写不出代码,而是手一抖把用户正在跑的线上业务覆盖或删掉。
这个技能就是一套「安全增补」流程:只允许你新增一个自己的子目录 + 在入口文件加一行 require,其余一个字节都不碰。上传时只传你自己的子目录,绝不传父目录,从根上杜绝误删风险。
除此以外,它还给出一套「上线后故障的分层定位法」:用两条简单的访问请求把问题锁死在「服务端坏了 / 端口没放行 / 客户端缓存」中的某一层,避免瞎猜;并专门讲解 PWA(带 Service Worker 的网页)缓存把用户永久锁在旧版这个经典坑。
cloud-backend 之类的目录,想「清理/覆盖」它之前pm2 describe 能看到进程)。在给出任何「目录不对 / 该删」的结论之前,必须先把这组只读命令跑一遍、拿到输出。pm2 describe 里的 script path 和 exec cwd 是唯一权威——它决定 PM2 从哪儿启动、相对路径基准,别靠目录名直觉猜。
本项目只允许「新增一个自己的子目录」+「在入口文件加一行受保护引用」。这样即使模块缺失,既有业务也不受影响:
先 pm2 restart,无效才升级为 delete + start(后者不删任何文件,只重建进程记录,安全)。
用两条 curl 把问题锁到某一层(见第五节示例)。再确认接口返回的 version 字段是不是你刚传的版本——版本号对不上 = 传的还是旧文件。
若手机端仍报旧版错误、清历史记录无效、换无痕窗口却正常,多半是 sw.js 用了 cache-first 且缓存名恒定。改法是:① 每次发布把缓存名改名;② 接口永不缓存;③ 改成 network-first(断网才回缓存)。给用户的话术:删桌面图标 → 浏览器设置清除该网站数据 → 重新打开;或先用无痕窗口验证。
你直接对 AI大模型或AI智能体 说:「帮我把这个新模块挂到我服务器上那个 /opt/app/backend 的后端里,千万别动我原来的业务。」
AI大模型或AI智能体 会:先 pm2 describe 看清真实结构 → 把你的模块只放进 backend/my-module/ 子目录 → 只在 server.js 加一行 try{require('./my-module')} → 只 scp 这个子目录上去 → 用温和的 pm2 restart 重启。全程不碰你原来的任何文件。
你直接对 AI大模型或AI智能体 说:「模块上线后手机页面登录失败,但服务端好像正常。」
AI大模型或AI智能体 会:用两条请求定位——
判读:①✅②✅=服务正常,问题在客户端;①✅②❌=端口未放行,去云控制台安全组加规则;①❌②❌=模块没挂载或进程崩了,看 pm2 logs。再查接口返回的 version 对不对得上。
你直接对 AI大模型或AI智能体 说:「服务端都升级了,手机端还是报旧版的登录错误。」
AI大模型或AI智能体 会:判断是 PWA Service Worker 缓存作祟。先让你用「无痕窗口」打开一次:能进就确认是缓存问题。然后改 sw.js 为 network-first 并每次发布改名缓存,并指导你把桌面图标删掉、清除该网站数据后重新打开。
rm -rf <后端目录>、把后端目录往上层摊平、或 scp 父目录去覆盖。只传自己的子目录,其余一个字节都不碰。不要仅凭「目录名像脚手架」就断言用户放错了位置。pm2 describe 拿到 script path / exec cwd,别靠目录名直觉判断结构。cd 进正确的 exec cwd,否则新进程工作目录错乱。pm2 env 查一下实际生效值,客户端要改成同样的值。version,用来确认传上去的是不是最新。