@rowansenne/workflow-run 0.24.0 → 0.24.1

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## [Unreleased]
 
+## [0.24.1] - 2026-10-21
+
+### 修复
+- WorkBuddy 改用 `--copy` 重装时，将本工具已有的技能软链接转换为真实目录，保留已填配置，避免写入共享来源或影响其他环境；用户指向其他位置的链接保留并报错。
+- 升级以最近一次显式安装的环境和模式为准，自动退回拷贝的清单不覆盖单一来源的完整技能选择。
+- 补充 Windows WorkBuddy 的管理员终端、独立拷贝安装及技能不可见时的排查说明。
+
 ## [0.24.0] - 2026-10-21
 
 ### 变更

package/README.md

@@ -78,6 +78,21 @@ npx @rowansenne/workflow-run docs-repo git@git.example.com:team/team-docs.git
 * Windows：安装与升级（`init` / `upgrade`）**必须在管理员终端执行**（建目录软链接需要该权限）；在普通终端运行会直接停下、不做任何改动，并提示改用「以管理员身份运行」的终端。`doctor`、`seed-templates`、`uninstall` 不要求管理员。少数文件系统仍建不了软链接时，该环境自动退回独立拷贝。在 Windows 上 clone 含软链接的仓库需要 `git config core.symlinks true`。
 * 不想用软链接：加 `--copy`，每个环境各装一份完整文件。
 
+### 在 Windows 的 WorkBuddy 中使用
+
+在**业务项目根目录**打开管理员 PowerShell，运行 npm 包提供的安装命令（仅 `npm install` 下载包不会生成项目技能）：
+
+```powershell
+npx @rowansenne/workflow-run@latest --envs workbuddy --copy --skip-db --yes
+npx @rowansenne/workflow-run@latest doctor --offline
+```
+
+这里用 `--copy` 在 `.codebuddy/skills/<skill>/` 生成真实目录和 `SKILL.md`，便于排除目录软链接的兼容问题。已有指向 `.agents/skills/` 的本工具链接会先转成独立拷贝，保留已填配置，再更新技能文件；共享来源和 Qwen 等其他环境的链接不变。后续 `upgrade` 沿用最近一次显式安装的环境和模式。只选择 WorkBuddy 时，全新安装不会生成 `.qwen/skills/`。
+
+安装后，将 **同一个业务项目目录**设为 WorkBuddy 任务的工作目录，重新打开项目并新建会话，再尝试 `/workflow status`、`/dev` 或 `/project-review`。`/workflow profile` 等是技能参数，不是额外的独立技能。
+
+如果仍然不可见，先确认业务项目下确实有 `.codebuddy/skills/workflow/SKILL.md`，并保留安装命令、`doctor --offline` 输出与 WorkBuddy 版本以便排查。项目级配置目录见 [WorkBuddy 官方说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Project)。
+
 每个 skill 目录结构（四环境一致）：
 
 

package/bin/lib/core.mjs

@@ -107,9 +107,12 @@ export function timestamp() {
 }
 
 export const INSTALL_BASES = [CANON_DIR, ...Object.values(LINK_ENVS)];
-// 找到本项目的安装清单（单一来源优先；--copy 安装时各目录各有一份）
+// 以最近一次显式安装为准；自动退回拷贝的清单不覆盖单一来源的模式与 skill 选择。
 export function findManifests(root) {
-  return INSTALL_BASES.map((rel) => ({ rel, base: path.join(root, rel), m: readManifest(path.join(root, rel)) })).filter((x) => x.m);
+  const found = INSTALL_BASES.map((rel) => ({ rel, base: path.join(root, rel), m: readManifest(path.join(root, rel)) })).filter((x) => x.m);
+  const primary = found.filter((x) => x.rel === CANON_DIR || x.m.mode === 'copy').reduce((latest, x) =>
+    !latest || (Date.parse(x.m.installedAt) || 0) > (Date.parse(latest.m.installedAt) || 0) ? x : latest, null);
+  return primary ? [primary, ...found.filter((x) => x !== primary)] : found;
 }
 export function cmpVersion(a, b) {
   const pa = String(a).split(/[.-]/).map((x) => parseInt(x, 10) || 0);

package/bin/lib/install.mjs

@@ -2,8 +2,9 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import { TPL_DIR, PKG, CANON_DIR, INSTALL_BASES, SKILLS, SKILL_LIST, USER_FILES, MANIFEST, ok, warn, readJson, walk, toPosix, sameFile, writeFile, render, sha256, fileHash, readManifest, removeEmptyDirs, lstat, timestamp, removeLink, HOME } from './core.mjs';
+import { TPL_DIR, PKG, CANON_DIR, INSTALL_BASES, SKILLS, SKILL_LIST, USER_FILES, MANIFEST, ok, warn, fail, readJson, walk, toPosix, sameFile, writeFile, render, sha256, fileHash, readManifest, removeEmptyDirs, lstat, timestamp, removeLink, HOME } from './core.mjs';
 import { writeDbConfig } from './db.mjs';
+import { linkPointsTo } from './uninstall.mjs';
 import { layout, ensureIgnore, homeIsRepo, migrateLayout, IGNORE_LINE, TMP_DIR } from '../../workflow/scripts/requirement.mjs';
 import { detectEnv } from '../../workflow/scripts/resolve.mjs';
 import { rotate as rotateFeedback, ensureUnionMerge } from '../../workflow/scripts/feedback.mjs';
@@ -66,6 +67,19 @@ export async function installSkills(base, db, ctx) {
   for (const skill of selected) {
     const srcDir = path.join(TPL_DIR, skill);
     const dstDir = path.join(base, skill);
+    // --copy 重装已有链接时先解除共享关系，避免写穿链接、仍留下无法被部分宿主发现的链接目录。
+    if (ctx.mode !== 'symlink' && lstat(dstDir)?.isSymbolicLink()) {
+      if (!linkPointsTo(dstDir, path.resolve(ctx.root, CANON_DIR, skill))) fail(`${dstDir} 指向其他位置，不能改为独立拷贝；请先手动处理该链接。`);
+      const tmp = fs.mkdtempSync(path.join(base, '.workflow-run-copy-'));
+      const copy = path.join(tmp, skill);
+      try {
+        if (fs.existsSync(dstDir)) fs.cpSync(dstDir, copy, { recursive: true, dereference: true });
+        else fs.mkdirSync(copy);
+        removeLink(dstDir);
+        fs.renameSync(copy, dstDir);
+      } finally { fs.rmSync(tmp, { recursive: true, force: true }); }
+      ok(`${toPosix(path.relative(ctx.root, dstDir))} 已由软链接改为独立拷贝（已有配置保留）`);
+    }
     const prevSkill = prev?.skills?.[skill];
     const entry = { files: {}, userFiles: {} };
     const notes = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowansenne/workflow-run",
-  "version": "0.24.0",
+  "version": "0.24.1",
   "description": "项目级 Agent Skills 一键初始化：workflow / dev / project-review / code-graph / database-query / md-to-wiki / 技术与上线方案生成",
   "keywords": [
     "agent-skills",