@yixinkj/priority-buyer-alert-cli 0.1.52 → 0.1.56

package/changelog.json

@@ -0,0 +1,66 @@
+{
+  "//": "随包发布的更新日志。启动器用它决定「这次更新要不要打断调用方」，并把 summary 打给模型看（只写 stderr，不要求转述给终端用户）。",
+  "//impact": "output = 只影响怎么读结果，本次命令仍然有效，照常执行；invocation = 影响怎么发命令，调用方手上那条命令可能已经失效，必须停下重读。缺省和写坏一律按 invocation 处理。发版时填不出 summary，多半说明这次压根不该动 SKILL.md 正文。",
+  "entries": [
+    {
+      "version": "0.1.56",
+      "impact": "output",
+      "summary": "买家在询价卡之后又发了图片或文件时，不会再把图片当成询价卡去读，需求内容不再丢失"
+    },
+    {
+      "version": "0.1.55",
+      "impact": "output",
+      "summary": "卡片读不出内容时，首响清单里会带一段结构诊断，便于定位是哪一类卡片没支持"
+    },
+    {
+      "version": "0.1.54",
+      "impact": "output",
+      "summary": "定制询价卡不再把「款式和数量」这个栏目名当成买家要的数量；那张卡上的数字是产品起订量，不是买家自己填的量"
+    },
+    {
+      "version": "0.1.53",
+      "impact": "output",
+      "summary": "版本更新不再每次打断：只有会影响命令怎么发的改动才要求重跑，其余照常执行并提示重读"
+    },
+    {
+      "version": "0.1.52",
+      "impact": "output",
+      "summary": "定制询价卡现在能读出数量、目标单价和定制规格；同一浏览器 Profile 开着多个消息中心页面时不再中断扫描"
+    },
+    {
+      "version": "0.1.51",
+      "impact": "output",
+      "summary": "卡片读不出内容时会带回结构诊断，便于定位是哪一类卡片不支持"
+    },
+    {
+      "version": "0.1.50",
+      "impact": "output",
+      "summary": "推送内容改成纯文本加粗，去掉表格和标题，飞书钉钉里不再显示成一堆符号"
+    },
+    {
+      "version": "0.1.49",
+      "impact": "output",
+      "summary": "业务员回复之后不会再被误报成没人回。以前询盘列表的时间没及时更新，预警会继续提醒几个小时"
+    },
+    {
+      "version": "0.1.48",
+      "impact": "output",
+      "summary": "清单为空时也会留下产物文件；跑完自动清掉中间文件，不再占磁盘"
+    },
+    {
+      "version": "0.1.47",
+      "impact": "output",
+      "summary": "摘要新增本轮清单条数。原来那个待办数不等于清单长度，容易被读成「本轮什么都没推」"
+    },
+    {
+      "version": "0.1.46",
+      "impact": "output",
+      "summary": "不再按消息条数给会话分档。真实询盘普遍超过原来的阈值，导致开场白几乎从不生成"
+    },
+    {
+      "version": "0.1.45",
+      "impact": "invocation",
+      "summary": "新询盘首响扫描的无人值守心跳现在必须带 --mark，否则同一批询盘每轮都会重复推送"
+    }
+  ]
+}

package/index.js

@@ -48,6 +48,9 @@ const REPOSITORY_SKILL_PATH = path.join(
 const BUNDLED_SKILL_PATH = fs.existsSync(PACKED_SKILL_PATH)
   ? PACKED_SKILL_PATH
   : REPOSITORY_SKILL_PATH;
+// 更新日志随包发布，启动器据此判断「这次更新要不要打断调用方」。
+// 缺文件、读不出、区间为空时一律按最保守的 invocation 处理，见 core.readChangelog。
+const CHANGELOG_PATH = path.join(PACKAGE_ROOT, 'changelog.json');
 const SKILL_VERSION_MARKER = `.${SKILL_ID}-version.json`;
 const SKILL_ROOT = path.join(os.homedir(), '.yixin', SKILL_ID);
 const RUNTIME_ROOT = path.join(SKILL_ROOT, 'runtime');
@@ -194,7 +197,10 @@ const resolveSkillGate = (skillPath, { homeDir = os.homedir(), syncOptions = {}
  * @param {object} [options] 测试注入的内置文件路径。
  * @returns {object} 同步结论与版本信息。
  */
-function syncSkillInstallation(skillPath, { bundledSkillPath = BUNDLED_SKILL_PATH } = {}) {
+function syncSkillInstallation(
+  skillPath,
+  { bundledSkillPath = BUNDLED_SKILL_PATH, changelogPath = CHANGELOG_PATH } = {}
+) {
   const resolvedSkillPath = core.resolveSkillMdPath(skillPath);
   const { content: bundledSkill, metadata: bundledMetadata } = core.loadBundledSkill(bundledSkillPath);
   // 内核只检查包自身完整性（文件在不在、name/description 有没有），身份判定留在本仓。
@@ -281,15 +287,42 @@ function syncSkillInstallation(skillPath, { bundledSkillPath = BUNDLED_SKILL_PAT
     }
   });
 
+  // 判据是**正文**变没变，不是文件变没变：frontmatter 的版本号每次发布必然变，
+  // 拿整份文件比对等于「每次发布都打断一次」。真机一周 4 次更新，其中 2 次正文一个字
+  // 没动，却照样把调用方挡回去重跑，换来零信息。
+  const bodyChanged = core.skillBody(currentSkill) !== core.skillBody(bundledSkill);
+  const changelog = core.readChangelog(changelogPath, currentVersion, SKILL_VERSION);
+  // 正文没变 → 无条件放行。正文变了 → 由日志里的 impact 决定：
+  // 只影响「怎么读结果」就放行（调用方读到提示后自己重读 SKILL.md 再解读产物），
+  // 影响「怎么发命令」就必须停——那条命令是读着旧说明构造的，可能已经失效。
+  const blocking = bodyChanged && changelog.impact !== 'output';
   return {
-    action: skillChanged ? 'updated' : 'registry_updated',
+    action: blocking ? 'updated' : 'synced',
     skillPath: resolvedSkillPath,
     currentVersion,
     targetVersion: SKILL_VERSION,
-    registryPath: registryPreview.registryPath
+    registryPath: registryPreview.registryPath,
+    bodyChanged,
+    changelog
   };
 }
 
+/// 把「已更新、请重读」这件事说给调用方听，但**不打断本次执行**。
+///
+/// 只写 stderr：stdout 是产物 JSON，混进去会让调用方解析失败。也刻意不要求转述给终端
+/// 用户——重读 SKILL.md 是模型自己的事，业务员不需要每次更新都被告知一遍。
+function reportSkillSynced(sync) {
+  if (!sync || !sync.bodyChanged) return;
+  const entries = (sync.changelog && sync.changelog.entries) || [];
+  console.error(
+    `[${SKILL_ID}] 已更新到 ${sync.targetVersion}。本次结果请按新版说明解读，`
+      + `下一步动作前重新读一次 SKILL.md。`
+  );
+  for (const entry of entries) {
+    if (entry && entry.summary) console.error(`[${SKILL_ID}] 　${entry.summary}`);
+  }
+}
+
 /** 帮助文案是本仓的命令面，不进共享内核。 */
 function printHelp() {
   process.stdout.write(`${SKILL_DISPLAY_NAME} ${SKILL_VERSION}（Runtime ${RUNTIME_VERSION}）
@@ -379,16 +412,22 @@ async function main() {
     }
     emitStatus(
       'skill_updated',
-      `${SKILL_DISPLAY_NAME}已更新至 ${SKILL_VERSION}。请重新试一次，本次不执行扫描。`,
+      `${SKILL_DISPLAY_NAME}已更新至 ${SKILL_VERSION}。本次改动会影响命令怎么发，`
+        + `请重新读一次 SKILL.md 再按新版执行；本次不执行扫描。`,
       {
         skill_path: gate.sync.skillPath,
         previous_version: gate.sync.currentVersion || null,
         skills_registry: gate.sync.registryPath || null,
-        restart_required: true
+        restart_required: true,
+        changes: ((gate.sync.changelog && gate.sync.changelog.entries) || [])
+          .map((entry) => entry.summary)
+          .filter(Boolean)
       }
     );
     return;
   }
+  // 放行的更新只提示、不打断：正文没变，或者改动只影响怎么读结果。
+  reportSkillSynced(gate.sync);
 
   const runtimeOverride = process.env.PRIORITY_BUYER_ALERT_RUNTIME_BINARY;
   if (runtimeOverride) {

package/launcher-core.js

@@ -629,7 +629,7 @@ function resolveSkillGate(skillPath, { syncSkill, discoverSkillPaths, discovered
   }
   if (skillPath) {
     const sync = syncSkill(skillPath);
-    return { allowRun: sync.action === 'current', sync };
+    return { allowRun: isRunnableSyncAction(sync.action), sync };
   }
   const candidates = discoverSkillPaths();
   if (candidates.length !== 1) {
@@ -643,12 +643,76 @@ function resolveSkillGate(skillPath, { syncSkill, discoverSkillPaths, discovered
   if (discoveredPathPolicy === 'require_argument') {
     return {
       allowRun: false,
-      sync: { ...sync, action: 'skill_path_required', candidates, synced: sync.action !== 'current' }
+      sync: {
+        ...sync,
+        action: 'skill_path_required',
+        candidates,
+        synced: !isRunnableSyncAction(sync.action)
+      }
     };
   }
   return { allowRun: false, sync: { ...sync, action: 'restart_required' } };
 }
 
+/// 同步之后仍然可以继续执行本次命令吗。
+///
+/// `current` 是什么都没变；`synced` 是变了但**不影响本次这条命令**——版本号单独升、
+/// 或者改动只影响「怎么读结果」。两者都放行，调用方读到提示后自己重读 SKILL.md 即可。
+///
+/// 真机数据：一周里 4 次更新有 2 次正文一个字没动，只是 frontmatter 的版本号跟着升了，
+/// 那 2 次全都把调用方挡回去重跑一遍，换来零信息。
+///
+/// 写成函数而不是模块级 Set，是为了不动内核那条「模块级只允许一个策略常量」的守卫——
+/// 那条守卫是 SKILL_ID 事故留下的，不该为了少写两个字就把它放宽。
+function isRunnableSyncAction(action) {
+  return action === 'current' || action === 'synced';
+}
+
+/// 剥掉 frontmatter 里的 `version:` 行，用来判断**正文**变没变。
+///
+/// 版本号每次发布必然变，拿整份文件比对等于「每次发布都算正文变了」。而真正决定要不要
+/// 打断调用方的，是那些指导它怎么做的文字有没有变。
+function skillBody(content) {
+  return String(content ?? '').replace(/^version:.*$/m, '');
+}
+
+/// 取 `(fromVersion, toVersion]` 区间内的更新日志条目。
+///
+/// `impact` 决定要不要打断本次调用，只有两个取值：
+/// - `output` —— 只影响「怎么读结果」。本次命令仍然有效，照常执行，事后重读即可。
+/// - `invocation` —— 影响「怎么发命令」。调用方是读着旧说明构造的这条命令，它可能已经
+///   失效，必须停下重来。
+///
+/// **缺省和读不出来一律按 `invocation`。** 真机上栽过一次：SKILL.md 从「`--mark` 只配
+/// `--start`」改成「首响心跳也必须带 `--mark`」，按旧说明构造的命令没有 `--mark`，
+/// 放行执行的结果是水位不记账、同一批新询盘每轮重复推送——不报错，只是结果是错的。
+/// 默认成放行的话，漏标一次就是这种静默出错，而且没人会发现。
+function readChangelog(changelogPath, fromVersion, toVersion) {
+  const fallback = { impact: 'invocation', entries: [] };
+  if (!changelogPath || !fs.existsSync(changelogPath)) return fallback;
+  let data;
+  try {
+    data = JSON.parse(fs.readFileSync(changelogPath, 'utf8'));
+  } catch {
+    return fallback;
+  }
+  const all = Array.isArray(data) ? data : Array.isArray(data.entries) ? data.entries : null;
+  if (!all) return fallback;
+  const entries = all.filter((entry) => {
+    const version = entry && typeof entry.version === 'string' ? entry.version : '';
+    if (!version) return false;
+    // 左开右闭：本地已经是 from 那一版，它的改动不必再说一遍。
+    return (
+      (!fromVersion || compareVersions(version, fromVersion) > 0) &&
+      compareVersions(version, toVersion) <= 0
+    );
+  });
+  if (!entries.length) return fallback;
+  // 区间里只要有一条影响调用方式，整段就必须按 invocation 处理。
+  const impact = entries.some((entry) => entry.impact !== 'output') ? 'invocation' : 'output';
+  return { impact, entries };
+}
+
 /* ------------------------------------------------------------------ *
  * 六、平台识别与下载源
  * ------------------------------------------------------------------ */
@@ -1439,6 +1503,8 @@ export {
   reportPrunedRuntimeVersions,
   resolveReleaseBaseUrls,
   resolveSkillGate,
+  readChangelog,
+  skillBody,
   resolveSkillMdPath,
   restoreFile,
   restoreTree,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yixinkj/priority-buyer-alert-cli",
-  "version": "0.1.52",
+  "version": "0.1.56",
   "description": "重点买家未回复预警独立启动器，只读扫描询盘并提醒，不发送任何消息。",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
   "files": [
     "index.js",
     "launcher-core.js",
+    "changelog.json",
     "skills.json",
     "skill"
   ],

package/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: 哨兵预警-0812
 description: 重点买家未回复预警。只读扫描阿里国际站询盘列表，挑出重点买家（金品店铺为 L2 及以上真实档；出口通店铺只有 L1+ 一个值，它是 L1–L4 的合集，必然包含 L1），判断买家最后一句是否超过 SLA 仍没有真人业务员回复，并输出中文预警清单；机器人自动接待不算人工回复。Use when 用户要求检查重点买家有没有超时未回复、查询盘超时提醒、看 L3/L4 有没有快凉的，或要求运行重点买家预警。
-version: "0.1.52"
+version: "0.1.56"
 ---
 
 # 重点买家预警
@@ -26,6 +26,13 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 
 启动成功后立即记录返回的 `run_id`，此后只用同一个 `run_id` 轮询，不要再次执行 `--start`。
 
+**关于版本更新的两种提示，处理方式不同：**
+
+- stderr 出现「已更新到 x.y.z，本次结果请按新版说明解读」——**本次命令照常执行完了，结果有效**。
+  下一步动作之前重新读一次 SKILL.md 即可，不要重跑这条命令。
+- 返回 `skill_updated`——本次**没有执行**。这类更新会影响命令怎么发，手上这条可能已经失效，
+  必须重新读 SKILL.md 再按新版重跑。
+
 预警扫描参数（与 `--start` 一起使用）：
 
 - `--minutes 30`：SLA，超过多少分钟没有人工回复算超时。默认 30，严格大于才触发。
@@ -220,7 +227,11 @@ npx -y @yixinkj/priority-buyer-alert-cli@latest \
 猜他要什么。
 
 首响清单里除了这句摘要，还有结构化的 `last_buyer_card`：`quantity`、`product_moq`、
-`product_unit_price`、`detail_requirement`（买家自己写的需求原文）。**把清单文件直接交给
+`product_unit_price`、`detail_requirement`（买家自己写的需求原文）。
+
+**`quantity` 为空不等于买家没说数量。**定制询价卡上通常只有产品的最低起订量，没有买家
+自己填的数量，这时 `quantity` 是空的、数字在 `product_moq` 里。转述时要说成「这款起订量
+500」，不要说成「他要 500 个」——那是两回事，说错了买家一眼看得出你没看卡。**把清单文件直接交给
 首响 Skill**，它用 `--from-scan` 就能拿到这些，不必为同样的数据再开一次详情页——
 两边调的本来就是同一个接口。没有卡片时该字段为空，首响 Skill 会自己回落去抓。
 

package/skills.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.42",
+  "runtimeVersion": "0.1.45",
   "platforms": {
     "darwin-arm64": {
       "id": "mac-arm64",
@@ -24,7 +24,7 @@
   "skill": {
     "name": "哨兵预警-0812",
     "id": "priority-buyer-alert",
-    "version": "0.1.52",
+    "version": "0.1.56",
     "bin": "priority-buyer-alert-cli"
   }
 }