@topmindspace/topmind-writing-skills 0.8.40 → 0.8.42

package/CHANGELOG.md

@@ -1,4 +1,20 @@
-## [0.8.40] - 2026-10-16
+## [0.8.42] - 2026-10-16
+
+> 根包 0.8.41 → **0.8.42**（patch，仅安装器与文档）；技能版本不变。
+
+- 文档对齐默认升级：README 中英文加 `@latest` 升级、`--force` 重装 / 降级示例，钉版本示例注明已装更新时需 `--force`；PUBLISHING 加「升级」一行。
+- CI 安装冒烟改测新行为：同版本 → Already up to date，旧版本 → Upgraded。
+
+ - 2026-10-16
+
+> 根包 0.8.40 → **0.8.41**（patch，仅安装器）；技能版本不变。
+
+### 变更（安装器默认升级）
+
+- `install` 遇到已装技能时默认升级：包内版本更新（或已装版本缺失 / 解析不了）→ 直接覆盖，不备份，打印 `Upgraded <id> <旧> -> <新>`；版本相同 → `Already up to date`，exit 0，`--force` 重装；已装版本更新 → 拒绝降级，`--force` 才覆盖。
+- 帮助文本、README 中英文同步；`test_installer_cli.js` 新增升级 / 同版本 / 已装更新 / 版本缺失用例。
+
+ - 2026-10-16
 
 > 根包 0.8.39 → **0.8.40**（patch）；技能版本：topmind-briefs 0.2.20 → 0.2.21、topmind-format 0.1.5 → 0.1.6、topmind-viral-posts 0.3.12 → 0.3.13、topmind-wechat-post 0.3.12 → 0.3.13、topmind-x-article 0.4.18 → 0.4.19。
 

package/README.en.md

@@ -128,7 +128,7 @@ Every skill ships sample outputs written by us (fictional or neutral topics; no
 | [`topmind-format`](./topmind-format/) | **0.1.6** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + sensible lists, emoji optional); layout only, words unchanged, with a fidelity check; one copy-ready plain-text body, links / images sent separately |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | HTML+CSS → high-res long image / poster / infographic PNG: headless Chrome 2× screenshot + auto-trim; "one image per section" batch workflow (generator + renderer) |
 
-Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.40** (whole-repo same-tag releases).
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.42** (whole-repo same-tag releases).
 
 ### Which skill, and how they combine
 
@@ -151,7 +151,9 @@ Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package
 npx @topmindspace/topmind-writing-skills list
 npx @topmindspace/topmind-writing-skills install topmind-briefs
 npx @topmindspace/topmind-writing-skills install topmind-briefs --to ./.claude/skills
-npx @topmindspace/topmind-writing-skills@0.8.4 install topmind-briefs   # pin
+npx @topmindspace/topmind-writing-skills@latest install topmind-briefs   # upgrade: older install is overwritten, no --force needed
+npx @topmindspace/topmind-writing-skills install topmind-briefs --force   # reinstall same version / downgrade
+npx @topmindspace/topmind-writing-skills@0.8.4 install topmind-briefs   # pin (needs --force if a newer version is installed)
 npx @topmindspace/topmind-writing-skills uninstall topmind-briefs --to ./.claude/skills
 ```
 
@@ -162,7 +164,7 @@ npx github:topmindspace/topmind-writing-skills install topmind-briefs
 
 Default probe order: `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`, then user-level `~/.claude`, etc. Or pass `--to`. When `--to` is omitted, the install summary explicitly prints the auto-detected target directory. Do not `npm install topmind-briefs` (skill id is not a standalone package).
 
-`install` details: if a same-named skill already exists, the installed version is reported and overwriting is refused — pass `--force` to replace (or `uninstall` first). On success, a three-line summary is printed: where it was installed / installed skill version and installer version / next steps.
+`install` details: upgrades by default: if the installed version is older (or unreadable), it is overwritten in place (no backup) and `Upgraded <skill> <old> -> <new>` is printed; the same version prints `Already up to date` (`--force` reinstalls); an installed version newer than the package is refused unless `--force`. On success, a three-line summary is printed: where it was installed / installed skill version and installer version / next steps.
 
 ## Repo layout
 

package/README.md

@@ -128,7 +128,7 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 | [`topmind-format`](./topmind-format/) | **0.1.6** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + 合理列表，emoji 可选），只动排版不改字，带原文保真校验；交付一段可复制纯文本，链接 / 原图另发 |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
 
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.40**（整仓同 tag 发版）。
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.42**（整仓同 tag 发版）。
 
 ### 怎么选、怎么组合
 
@@ -155,7 +155,9 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 npx @topmindspace/topmind-writing-skills list
 npx @topmindspace/topmind-writing-skills install topmind-briefs
 npx @topmindspace/topmind-writing-skills install topmind-briefs --to ./.claude/skills
-npx @topmindspace/topmind-writing-skills@0.8.4 install topmind-briefs   # 钉版本
+npx @topmindspace/topmind-writing-skills@latest install topmind-briefs   # 升级：已装旧版直接覆盖，无需 --force
+npx @topmindspace/topmind-writing-skills install topmind-briefs --force   # 同版本重装 / 降级
+npx @topmindspace/topmind-writing-skills@0.8.4 install topmind-briefs   # 钉版本（已装更新的版本时需 --force）
 npx @topmindspace/topmind-writing-skills uninstall topmind-briefs --to ./.claude/skills
 ```
 
@@ -166,7 +168,7 @@ npx github:topmindspace/topmind-writing-skills install topmind-briefs
 
 默认探测：`./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再用户级 `~/.claude` 等；也可用 `--to`。未给 `--to` 时安装摘要会明确打印探测到的目标目录。不要 `npm install topmind-briefs`（技能 id 不是独立包）。
 
-`install` 细节：若同名技能已存在，会报出已装版本并拒绝覆盖，需加 `--force` 才替换（或先 `uninstall` 再装）。安装成功后打印三行摘要：装到哪里 / 装的技能版本与安装器版本 / 下一步。
+`install` 细节：默认升级：已装版本比包里旧（或读不到版本）就直接覆盖（不备份），打印 `Upgraded <技能> <旧> -> <新>`；版本相同打印 `Already up to date`，加 `--force` 可重装；已装版本比包里新则拒绝降级，需加 `--force`。安装成功后打印三行摘要：装到哪里 / 装的技能版本与安装器版本 / 下一步。
 
 ## 仓库结构
 

package/bin/topmind-writing-skills.js

@@ -193,6 +193,20 @@ function assertDestOutsideSource(src, dest) {
   }
 }
 
+/** 比较版本 a 与 b：a>b 返回 1，相等 0，a<b -1。b 缺失或解析不了视为最旧（返回 1）。 */
+function parseVer(v) {
+  const m = String(v || '').trim().replace(/^["']|["']$/g, '').replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
+  return m ? m.slice(1, 4).map(Number) : null;
+}
+function compareVersions(a, b) {
+  const pa = parseVer(a);
+  const pb = parseVer(b);
+  if (!pb) return 1;
+  if (!pa) return -1;
+  for (let i = 0; i < 3; i++) if (pa[i] !== pb[i]) return pa[i] > pb[i] ? 1 : -1;
+  return 0;
+}
+
 function install(skillId, targetRoot, { force = false, defaultTarget = false } = {}) {
   assertSkillId(skillId);
   const src = skillDir(skillId);
@@ -210,25 +224,32 @@ function install(skillId, targetRoot, { force = false, defaultTarget = false } =
         'Choose a --to directory that can be created (not a file, not unwritable).'
     );
   }
+  let upgradedFrom = null;
   if (fs.existsSync(dest)) {
-    if (!force) {
-      // 已装过：报出已装版本，要求 --force 才覆盖（不静默覆盖）。
-      const installedVer = readSkillVersion(dest) || 'unknown';
-      const packageVer = readSkillVersion(src) || 'unknown';
+    // 已装过：默认升级。打包版本更新 → 直接覆盖（不备份）；相同 → 已是最新；已装版本更新 → 需 --force。
+    const installedVer = readSkillVersion(dest);
+    const packageVer = readSkillVersion(src) || 'unknown';
+    const cmp = compareVersions(packageVer, installedVer);
+    if (!force && cmp === 0) {
+      console.log(`Already up to date: ${skillId} ${installedVer} (use --force to reinstall)`);
+      console.log(`  at:      ${dest}`);
+      return;
+    }
+    if (!force && cmp < 0) {
       die(
-        `Already installed: ${dest}\n` +
-          `  installed version: ${installedVer} (this package ships ${packageVer})\n` +
-          'Refusing to overwrite. Pass --force (or -f) to replace, or remove it first:\n' +
-          `  topmind-writing-skills uninstall ${skillId} --to ${targetRoot}`
+        `Installed ${skillId} ${installedVer} is newer than packaged ${packageVer}; not downgrading. ` +
+          'Pass --force (or -f) to downgrade.'
       );
     }
+    upgradedFrom = cmp > 0 ? installedVer || 'unknown' : null;
     fs.rmSync(dest, { recursive: true, force: true });
   }
   copyDir(src, dest);
   // 安装摘要三行：装到哪里 / 装了什么版本 / 下一步。
   const toNote = defaultTarget ? '  (default, auto-detected — no --to given)' : '';
   const skillVer = readSkillVersion(dest) || 'unknown';
-  console.log(`Installed ${skillId}`);
+  if (upgradedFrom) console.log(`Upgraded ${skillId} ${upgradedFrom} -> ${skillVer}`);
+  else console.log(`Installed ${skillId}`);
   console.log(`  to:      ${dest}${toNote}`);
   console.log(`  version: skill ${skillVer} (installer ${installerVersion()})`);
   console.log(`  next:    ${nextStep(skillId, dest)}`);
@@ -290,8 +311,12 @@ Usage:
 
 Behavior:
   install    copies <skill-id>/ into <dir>/<skill-id>/. If the skill is already
-             installed, the installed version is reported and --force is required
-             to overwrite. Prints where/what-version/next-steps when done.
+             installed: a newer packaged version upgrades it in place (no backup,
+             prints "Upgraded <id> <old> -> <new>"); the same version prints
+             "Already up to date" (--force reinstalls); an installed version newer
+             than the package is refused unless --force. A missing/unparseable
+             installed version counts as an upgrade. Prints where/what-version/
+             next-steps when done.
   uninstall  removes <dir>/<skill-id>/ (refuses: not installed, not a skill
              directory, or the package's own skill source).
   No --to: the target directory is auto-detected (probe order below) and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.40",
+  "version": "0.8.42",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",

package/topmind-briefs/README.en.md

@@ -7,7 +7,7 @@ A brief is not a long-form article — **no HTML by default**: the workflow is v
 The X version is one copy-ready plain-text block (emoji optional); **links (including sources), original images and any generated images are sent separately**, never mixed into the body.
 The WeChat version is ~300–800 Chinese characters of Markdown. With no original image it asks before generating one.
 
-- Version: **v0.2.21** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.2.21** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-briefs/README.md

@@ -7,7 +7,7 @@
 X 版交付一段可直接复制的纯文本（emoji 可选），**链接（含来源）、原图、配图另发**，不和正文混在一起；公众号版约 300–800 字 Markdown。
 没有原图时先问要不要配图（`topmind-cover`）；链接那一条写明来源名称、发布时间与 URL。
 
-- 版本：**v0.2.21**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.2.21**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装
 

package/topmind-cover/README.en.md

@@ -4,7 +4,7 @@
 
 A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
 
-- Version: **v0.4.11** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.4.11** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Style gallery
 

package/topmind-cover/README.md

@@ -4,7 +4,7 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
-- 版本：**v0.4.11**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.4.11**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 风格样张
 

package/topmind-format/README.en.md

@@ -4,7 +4,7 @@
 
 Lays out existing text for X: **duanzi mode** (one sentence per line, a blank line between every line, no emoji at all, bullets without symbols) or **short-post mode** (paragraphing; lists become 「·」/「1）」 or, optionally, emoji bullets; title emoji and motifs are optional). Layout only — the words are never changed; a fidelity check enforces it. Links, source lines and image notes are pulled out of the body so it stays one copy-ready plain-text block; links and images are sent separately.
 
-- Version: **v0.1.6** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.1.6** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-format/README.md

@@ -4,7 +4,7 @@
 
 把现成的文字排成 X 上好读的样子：**转段子**（每句一行、行间空一行，完全不用 emoji，分点不加符号）或**格式化成短文**（合理分段换行、列表改「·」「1）」或 emoji，标题 emoji 与人设点缀可选）。只动排版，不改字，自带原文保真校验；正文里的链接、来源行、配图行会拿出来另列，交付一段可直接复制的纯文本，链接和图片另发。
 
-- 版本：**v0.1.6**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.1.6**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装
 

package/topmind-poster/README.en.md

@@ -4,7 +4,7 @@
 
 Rankings, infographics, monthly-report long images, posters — plus the "one image per section" workflow for splitting a long article into N shareable images. Text is 100% controllable, diffable, and iterable.
 
-- Version: **v0.1.6** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.1.6** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-poster/README.md

@@ -4,7 +4,7 @@
 
 榜单、信息图、月报长图、海报，以及「一段一图」的分段图批量出图。文本 100% 可控、可 diff、可迭代。
 
-- 版本：**v0.1.6**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.1.6**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装
 

package/topmind-viral-posts/README.en.md

@@ -4,7 +4,7 @@
 
 Short, real, hooked — read in 3 seconds, impossible not to like/comment/follow. 18 post types plus hook × body × closer combinations, summarised from common high-engagement writing patterns in the Chinese X community (all examples are original). Posts default to "duanzi" layout (one sentence per line, a blank line between lines), original images first, plus a hashtag set and classification tags. Existing text → `topmind-format`.
 
-- Version: **v0.3.13** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.3.13** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-viral-posts/README.md

@@ -4,7 +4,7 @@
 
 短、真、钩子——3 秒看完，忍不住点赞/评论/关注。基于对 X 中文区常见高互动写法的归纳，提供 18 类型模板 + 钩子×主体×收尾组合玩法（示例均为自编），默认段子体排版（一句一行、行间空一行），配图原图优先，并附话题标签与分类标签。
 
-- 版本：**v0.3.13**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.3.13**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装
 

package/topmind-wechat-post/README.en.md

@@ -4,7 +4,7 @@
 
 Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates, status sync, WeChat inline typography, and publish checklist.
 
-- Version: **v0.3.13** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.3.13** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-wechat-post/README.md

@@ -4,7 +4,7 @@
 
 公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
 
-- 版本：**v0.3.13**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.3.13**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装
 

package/topmind-x-article/README.en.md

@@ -4,7 +4,7 @@
 
 Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
 
-- Version: **v0.4.19** (ships with `@topmindspace/topmind-writing-skills@0.8.40`)
+- Version: **v0.4.19** (ships with `@topmindspace/topmind-writing-skills@0.8.42`)
 
 ## Install
 

package/topmind-x-article/README.md

@@ -4,7 +4,7 @@
 
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
-- 版本：**v0.4.19**（随 `@topmindspace/topmind-writing-skills@0.8.40` 发布）
+- 版本：**v0.4.19**（随 `@topmindspace/topmind-writing-skills@0.8.42` 发布）
 
 ## 安装