改了 Skill 代码让 AI 重启,跑的却是旧版本?“源码指纹自升级”

本文由AI创作

你有没有遇到过这种情况——

你写了一个 skill，它平时是当服务在后台跑的。

某天你改了服务端的代码，让 AI 去帮你重启。

结果一测，发现跑的还是旧的那份代码。新改动根本没生效。

问题出在哪？

AI 把你之前已经启动过的旧进程又用了起来，根本没用你改过的新代码。

最笨的办法：每次都先杀再启

最直接的做法，是你手动把旧服务停掉，再让 AI 启动新的。

或者更粗暴——在代码开头直接写：“不管三七二十一，先把旧程序杀掉，再启动一遍自己。”

不管代码改没改，每次都杀掉重启。

这法子能用，但很糙：服务会断一下。而且明明代码没动，你却白白重启了一次。

理想状态：代码变了才重启

我们真正想要的是：

• 代码有改动 → 自动替掉旧程序，用新的。
• 代码没改动 → 直接复用已经在跑的服务，别瞎重启。

怎么让程序自己“认得出”变没变？

答案就是标题里说的——源码指纹自升级（Source Fingerprint Self-Upgrade）。

一句话讲清：什么是源码指纹？

不靠人去手写版本号。

而是直接对程序自己的源码算一个哈希指纹。

源码有任何改动，指纹就变；源码没动，指纹就不变。

启动的时候，程序先算好自己的指纹 FP_new，再去问已经在跑的旧程序要它的指纹 FP_old：

1. 端口上没有旧程序 → 直接正常启动。
2. 有旧程序，且 FP_old === FP_new → 两份代码一模一样 → 说明“我”就是已经在跑的那个 → 直接退出，不重复启动。
3. 有旧程序，且 FP_old !== FP_new → 代码升级了 → 先优雅关掉旧的（释放端口），再启动自己，替掉旧的。

源码指纹自升级 流程图

核心代码：指纹到底怎么算？

整个机制的核心，就是一个纯函数 computeFingerprint()。

它递归扫描目录下的所有 .js 文件，拼起来算一个 sha256，取前 16 位十六进制：

●●●
javascript
// demo/fingerprint.js（核心，纯函数，无第三方依赖）import crypto from "node:crypto";import fs from "node:fs";import path from "node:path";// 递归收集目录下所有 .js 文件（排除不该算进指纹的目录）function collectJsFiles(dir) {  const result = [];  let entries;  try {    entries = fs.readdirSync(dir, { withFileTypes: true });  } catch {    return result; // 读不到目录就返回空，不影响整体  }  for (const e of entries) {    // 这些目录不是源码，按规则跳过：    if (e.name === "node_modules" || e.name === "runtime" || e.name.startsWith(".")) {      continue;    }    const full = path.join(dir, e.name);    if (e.isDirectory()) {      result.push(...collectJsFiles(full)); // 递归：子目录/子子目录都进去    } else if (e.isFile() && e.name.endsWith(".js")) {      result.push(full); // 只收 .js 文件    }  }  return result;}export function computeFingerprint(rootDir) {  const files = collectJsFiles(rootDir).sort(); // 先排序，保证跨机器一致  const hash = crypto.createHash("sha256");  for (const f of files) {    try {      hash.update(fs.readFileSync(f));      hash.update("\0"); // 文件间用 \0 分隔，避免首尾拼接误判    } catch {      // 读不到就跳过这个文件    }  }  return hash.digest("hex").slice(0, 16); // 取前 16 位十六进制}

就这么点代码，没有一行第三方依赖，Node 内置 crypto 就够了。

为什么不用版本号？

版本号是人写的字符串，最容易漏改：

• 改了代码但忘了 bump 版本号 → 两份不同代码被认为“同一版本” → 旧程序不会被替换，bug 还在。
• 没改代码但误 bump 版本号 → 被认为是“新版本” → 白白重启一次。

源码指纹是代码算出来的，代码变它才变，不存在“忘了改”的问题。

指纹到底采哪些文件？（规则表）

这块最容易踩坑，记牢这几条：

关键提醒：像 demo/scripts/run.sh 这种部署脚本，是程序的一部分，但按规则不计入指纹。

因为改个部署脚本，不该触发“代码升级重启”。

如果你确实想让某些非 JS 文件也计入，可以在规则里放开——但默认只认 .js。

协调逻辑：先放旧程序，再启自己

入口文件 main.js 里做两件事：算指纹 + 协调启动。

核心的“自升级协调”函数长这样：

●●●
javascript
// 返回 true 表示“继续启动自己”；false 表示“已存在相同实例，退出”export async function coordinateStart(port) {  const existing = await probeOld(port);     // 向旧实例要指纹  if (!existing) return true;                // 端口空闲 → 正常启动  if (existing.fingerprint === FP) {    console.log(`已存在相同实例（fp=${FP}），退出避免重复启动`);    return false;                            // 同一份代码 → 不重复启动  }  console.log(`检测到旧实例 fp=${existing.fingerprint}，当前 fp=${FP}，执行自升级`);  await gracefulReplace(port);               // 先让旧实例释放端口，再启动自己  return true;}

gracefulReplace 会先 POST /shutdown 让旧实例自己停机，再轮询等端口释放（最多约 8 秒）。

一条铁律：先让旧程序释放端口，再启动自己。

绝不允许“先启动新的、再杀旧的”——新程序会因为端口被占而启动失败。

项目结构长这样

●●●
text
source-fingerprint-self-upgrade/├── package.json         # type: module├── demo/│   ├── fingerprint.js   # 指纹计算模块（核心，纯函数）│   ├── main.js          # 入口：HTTP 服务 + 自升级协调逻辑│   ├── lib/│   │   ├── util.js│   │   └── sub/│   │       ├── helper.js│   │       └── deeper/│   │           └── nested.js   # 验证递归扫描│   └── scripts/│       ├── run.sh       # 非 JS（不计入指纹）│       └── setup.py     # 非 JS（不计入指纹）└── test/    └── test.js          # 验证指纹行为

跑起来看效果

●●●
bash
node demo/main.js            # 启动示例服务（默认端口 9421）# 另开终端curl http://localhost:9421/version   # 看指纹curl http://localhost:9421/health    # 健康检查node test/test.js           # 跑测试（验证指纹行为）

验证指纹是否生效：

• 改一个 .js 文件（比如给 lib/util.js 加一行注释）→ 指纹立刻变化。
• 改 scripts/run.sh → 指纹不变（它不计入指纹）。

如果你用 AI 帮你写这套机制

把需求丢给 AI 时，记得提这 6 点，能少踩很多坑：

1. 把 fingerprint.js 当成纯函数模块引入，别在里面写副作用。
2. 入口文件在最前面调用 computeFingerprint()，并在 /version 接口返回它。
3. 自升级协调遵守顺序：先让旧程序释放端口，再启动自己。
4. 关旧程序优先用它的优雅停机接口（如 POST /shutdown）；没有再回退到按 PID 杀。
5. 指纹不一致且旧程序无响应时，要有超时兜底，避免卡死。
6. 永远别为了“方便”把 node_modules、上传目录、截图目录算进指纹，否则指纹会天天变。

小结

• 让服务“自己认得出”变没变，比手写版本号靠谱得多。
• 源码指纹 = 对 .js 源码算 sha256，代码变它才变。
• 启动时比对旧实例指纹：一样就复用，不一样才升级重启。
• 纯 Node、零依赖、不需要 git，丢进项目就能用。

源码指纹自升级的代码和文档参考

https://pan.quark.cn/s/283a6e2080bb

你平时写 skill / 服务时，是怎么处理“改了代码要重启”这件事的？评论区聊聊你的做法。

觉得有用的话，点个收藏，下次改完 Skill 代码重启前, 看看有没有做到源码指纹自升级。

写本文用到的

• 工具: WorkBuddy
• Skill
• 本地markdown发布到公众号 https://github.com/steelan9199/wechat-publisher/tree/main/skills/wechat-publisher-yashu
• 生成常见图表 流程图等 https://github.com/steelan9199/wechat-publisher/tree/main/skills/svg-diagram-yashu
• 反向提问，理清需求 https://github.com/steelan9199/wechat-publisher/tree/main/skills/elite-intent-architect-yashu