@yixinkj/inquiry-opening-coach-cli 0.3.4 → 0.3.6

package/changelog.json

@@ -0,0 +1,31 @@
+{
+  "//": "随包发布的更新日志。启动器用它决定「这次更新要不要打断调用方」，并把 summary 打给模型看（只写 stderr，不要求转述给终端用户）。",
+  "//impact": "output = 只影响怎么读结果，本次命令仍然有效，照常执行；invocation = 影响怎么发命令，调用方手上那条命令可能已经失效，必须停下重读。缺省和写坏一律按 invocation 处理。发版时填不出 summary，多半说明这次压根不该动 SKILL.md 正文。",
+  "entries": [
+    {
+      "version": "0.3.6",
+      "impact": "output",
+      "summary": "版本更新不再每次打断：只有会影响命令怎么发的改动才要求重跑，其余照常执行并提示重读"
+    },
+    {
+      "version": "0.3.5",
+      "impact": "invocation",
+      "summary": "档案缺业务员英文名或公司英文名时，先问用户补齐再生成，不再直接用 [Your Name] 占位交付；存回档案要先读后合并，避免覆盖已有资料"
+    },
+    {
+      "version": "0.3.4",
+      "impact": "output",
+      "summary": "汇总改成纯文本加粗，默认只给推荐那一版全文，飞书钉钉里不再刷屏"
+    },
+    {
+      "version": "0.3.3",
+      "impact": "output",
+      "summary": "同一浏览器开着多个 Profile 时会自动认出哪个登着阿里；认不出时会列出各 Profile 开着哪些站点"
+    },
+    {
+      "version": "0.3.2",
+      "impact": "output",
+      "summary": "今天进来、之前没起草过的询盘都会写开场白，不再因为消息条数多而跳过"
+    }
+  ]
+}

package/index.js

@@ -57,6 +57,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`;
 // 注意：SKILL_ROOT 下面除了 runtime/ 还住着用户的记忆库（banks/、config.json）。
 // 那是用户从 0.2 起累积的资料，任何发布都不许动它——本文件只写 runtime/ 这一层。
@@ -242,7 +245,10 @@ function bundledAssetDirNames(bundledSkillRoot) {
  * @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);
@@ -347,8 +353,17 @@ function syncSkillInstallation(skillPath, { bundledSkillPath = BUNDLED_SKILL_PAT
     }
   });
 
+  // 判据是**正文**变没变，不是文件变没变：frontmatter 的版本号每次发布必然变，
+  // 拿整份文件比对等于「每次发布都打断一次」。附带素材（references/ 那棵树）算进正文——
+  // 它们是创作细则，变了同样要重读。
+  const bodyChanged =
+    core.skillBody(currentSkill) !== core.skillBody(bundledSkill) || changedAssets.length > 0;
+  const changelog = core.readChangelog(changelogPath, currentVersion, SKILL_VERSION);
+  const blocking = bodyChanged && changelog.impact !== 'output';
   return {
-    action: skillChanged || changedAssets.length > 0 ? 'updated' : 'registry_updated',
+    action: blocking ? 'updated' : 'synced',
+    bodyChanged,
+    changelog,
     skillPath: resolvedSkillPath,
     currentVersion,
     targetVersion: SKILL_VERSION,
@@ -357,6 +372,22 @@ function syncSkillInstallation(skillPath, { bundledSkillPath = BUNDLED_SKILL_PAT
   };
 }
 
+/// 把「已更新、请重读」这件事说给调用方听，但**不打断本次执行**。
+///
+/// 只写 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}）
@@ -438,17 +469,23 @@ 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,
         synced_assets: gate.sync.syncedAssets || [],
         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.INQUIRY_OPENING_COACH_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/inquiry-opening-coach-cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "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: create-inquiry-openers
 description: 为阿里巴巴国际站业务员创作新询盘的首次响应（英文开场白），可直接从询盘详情页读取买家国家、需求卡片和买家原话，也可由用户口述信息生成；结合本机记忆库的行为约束与长期经验，固定生成热情自然、幽默记忆、专业创意三种版本，并沉淀一条经验。同时管理这个本机记忆库和业务档案：通过纯 Rust CLI 写入、查看、修改、停用和删除记忆，并把累积的经验归纳为长期心智模型。Use when 用户给出询盘详情页链接、要求给某条新询盘写第一次回复、要求批量处理首响待办清单或看看有哪些新询盘要回、提到询盘开场白、客户第一句话、开发信开头、根据客户国家和产品写英文开场、修改或优化三套开场白；也 use when 用户说记住这个、保存公司资料、保存产品能力、维护 FAQ、设置禁止承诺、个人记忆点、查看或整理记忆库、把对话附件沉淀为长期资料、归纳历史询盘经验。
-version: "0.3.4"
+version: "0.3.6"
 ---
 
 # 询盘开场白创意教练
@@ -19,6 +19,9 @@ npx -y @yixinkj/inquiry-opening-coach-cli@latest \
 - **每一条命令都要带 `--skill-path`**，值是你本次实际读取的这份 `SKILL.md` 的绝对路径。缺了它本次不执行，启动器会直接把该带的参数和路径告诉你——那不是可以重试的错误，原样重跑一万次也不会成功。
 - 不要固定路径、目录名或版本号，也不要去找宿主 PATH 里的 `inquiry-opening-coach`、插件缓存或任何本地二进制。原生运行时由启动器自己下载并校验 SHA256。
 - 返回 `skill_updated` 时说明本机 Skill 刚被同步到新版：**本次不执行**，请重新读一次 SKILL.md 再按新版执行。
+- stderr 出现「已更新到 x.y.z，本次结果请按新版说明解读」时，**本次命令照常执行完了，结果有效**。
+  下一步动作之前重新读一次 SKILL.md 即可，不要重跑这条命令。这类更新不影响命令怎么发，
+  只影响怎么读结果；真正会让命令失效的更新走上面那条 `skill_updated`，那才要停。
 - 返回 `skill_version_conflict` 时说明本机 Skill 版本高于 npm 包，启动器拒绝降级；如实告诉用户，不要绕过。
 
 CLI 不含 LLM。它只负责抓取、召回、校验和落盘，文案由你直接创作。
@@ -243,14 +246,25 @@ npx -y @yixinkj/inquiry-opening-coach-cli@latest \
 - **`profileGapsAction`** —— **有值就照做，这是动作不是提示。**它只在缺少署名字段
   （业务员英文名、公司英文名）时出现，因为那两项缺了会在开场白正文里留下
   `[Your Name]` / `[Your Company]`，业务员要么手工替换、要么把占位符发给客户。
-  **先用 ask_user 问用户补齐**，拿到后用 `profile set` 存进档案——一次性，以后不再问。
+  **先用 ask_user 问用户补齐**，然后按下面「存回档案」的三步存进去——一次性，以后不再问。
   用户明确说先不填时才用占位符继续，并在交付时点名哪几处需要他手工替换。
 - **`profileGaps`** —— 产品优势、个人记忆点这类空缺，只会让开场白平淡一些，
   不影响能不能直接用。**不要为此打断生成**，交付后用一句话提一次即可。
 
-用户想改已有资料时同样用 ask_user 问清要改哪一项、改成什么，再 `profile set`；
+用户想改已有资料时同样用 ask_user 问清要改哪一项、改成什么，再按下面三步存回；
 不要凭一句「换个公司名」就自行猜写。
 
+#### 存回档案：三步，不能跳
+
+**`profile save` 是整份覆盖，不是合并。**只把新问到的两个字段写进去，会丢掉主营产品、
+公司名和已有的一切。所以必须：
+
+1. `profile show --json` 拿到当前完整档案；
+2. 在那份 JSON 上**改动要改的字段**，其余原样保留；
+3. 写成临时文件，`profile save --file <文件> --json`。
+
+没有 `profile set` 这个子命令，`profile` 只有 `show` 和 `save` 两个。
+
 `budget.droppedCount` 大于 0 表示有记忆因预算未注入，`droppedTitles` 列出了前几条。若本次询盘明显需要更多背景，用 `--budget 12000` 重新召回一次。
 
 `warnings` 非空表示 `memories.jsonl` 有行损坏、已被跳过。**照常完成本次生成**，交付结果后再用一句话提醒用户哪一行需要修——此时写入类命令会失败，所以生成后的经验沉淀这次会跳过，不要反复重试。

package/skills.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.3.3",
+  "runtimeVersion": "0.3.4",
   "platforms": {
     "darwin-arm64": {
       "id": "mac-arm64",
@@ -24,7 +24,7 @@
   "skill": {
     "name": "create-inquiry-openers",
     "id": "inquiry-opening-coach",
-    "version": "0.3.4",
+    "version": "0.3.6",
     "bin": "inquiry-opening-coach-cli"
   }
 }