@yottameta/yotta-skills-plugin 0.27.0 → 0.27.1

package/.agents/plugins/marketplace.json

@@ -12,7 +12,7 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Developer Tools",
-      "version": "0.27.0",
+      "version": "0.27.1",
       "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
       "interface": {
         "displayName": "元阁 yotta-skills",

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Developer Tools",
-      "version": "0.27.0",
+      "version": "0.27.1",
       "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
       "interface": {
         "displayName": "元阁 yotta-skills",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-skills-plugin",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "YuanGe (元阁) — orchestration and routing for the YottaMeta skill family, packaged as a YottaMeta Agent Plugin and DeepSeek Harness profile bundle.",
   "license": "MIT",
   "keywords": [

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "yotta-skills",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
   "author": {
     "name": "YottaMeta",

package/skills/yotta-skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yotta-skills
-version: 0.27.0
+version: 0.27.1
 description: 元阁 -- 元阁全家技能的总编排策划 + 编排路由 + 一键安装器 + 技能盘点 + 本机技能 Hub + 运行时 hook 适配。Hub 层：hub hosts 只读发现本机已装智能体与技能目录（文件系统优先，不读元忆）；hub install / update 把技能装到 ~/.yottaskills/hub 单点真源（清单 27 + 特殊家族 5，特殊家族跟随各自 npm latest）；hub link --all 用 Windows junction / POSIX symlink 分发到全部已发现宿主，元技能在链接时收敛宿主旧副本（移入 ~/.yottaskills/trash 保留 7 天、版本闸门 Hub ≥ 宿主）；hub unlink 只删链接、fail-closed；非元技能不参与更新（用户自行处理）；hub status 显示来源、版本、链接与异常；view 启动本机技能枢纽面板（默认 127.0.0.1:8789，六视图 + 高级 CLI 页，写操作需页面令牌与确认）；兼容 agentskills.io 技能格式、Vercel Labs skills CLI 的 .agents/skills 通用目录与 .skill-lock.json v3（只读）。路由层：--route / route_request 按需求摘要给出候选组合、调用顺序、角色、置信度、依据、已装/缺失状态与安装命令，只建议不自动安装；非元阁家族已装技能按 frontmatter description 机械匹配作并列候选（标注来源与未扫描状态，只读不自动调用）；M1 记忆裁决层：usage enable/mark 本地结构化记录 + decide-memory / MCP decide_memory 输出 promote / hold / demote 只读建议（需授权 provider；只建议不删除、不自动写元忆）；策划层：按场景给出「该组合哪几个元技能、组合强在哪、怎么组合使用（安装与调用均由用户确认后执行）」；安装层：一条命令把 YottaMeta 已发布的全部 yotta-* 技能装进指定智能体或目录（默认 --pin 锁死清单精确版本）；盘点层：--inventory / --reindex 扫描本机已装技能生成/更新注册表，新装技能自动被发现（install/update 后自动 re-index，会话开工只建议跑本地 --reindex；更新检查走手动 --check 或后台 --check --scheduled）；运行时适配层：hook capabilities / evaluate / bind / unbind 按宿主能力矩阵执行六个统一事件并留证降级，元信 before_install 已接入安装管线；自包含零依赖，不依赖任何元技能；MCP 按需加载且需用户确认后写入配置（可选：list_installed_skills/describe_skill/reindex/route_request/decide_memory，不常驻，未加载降级 CLI）。支持 --list 清单 / --route 路由 / usage 使用记录 / decide-memory 记忆裁决 / hub 技能 Hub / install / update / update --check（只读检查）/ update --check --scheduled（后台周检）/ update --auto（家族自动更新）/ hook 适配 / --inventory / --reindex / --dry-run 预览 / --pin（默认）/ --range。触发：需要批量安装或更新元阁全家技能、单点安装并分发到多个智能体、查看本机装了哪些智能体与技能目录、接管非元技能、按场景组合多个元技能、路由或判断该用哪些技能、判断哪些技能值得长期记忆、查看或记录技能使用信号、盘点或查看本机已装技能、重扫技能注册表、给某个智能体或目录一次性铺齐 yotta-* 技能、评估宿主 hook 能力、预览安装清单、锁版本安装、或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家/检查更新/自动更新/hook 适配/该用哪个技能/路由技能/记忆裁决/技能该不该记住/盘点技能/查看已装技能/技能 Hub/单点安装/链接分发/接管技能/技能枢纽面板/图形化面板 等。边界（Do NOT trigger）：只做「组合策划 + 静态路由建议 + M1 记忆裁决只读建议 + 清单 + 下载 + 落位 + 汇总 + 盘点 + re-index + Hub 本机真源与链接分发 + hook 适配」，不含技能本体、不做技能内容开发、不 -g 污染全局、不自动安装缺失技能、不静默写宿主配置或全局记忆、不自动删除技能或记忆；家族安装先自举或调用元信装前门禁，DO NOT INSTALL 阻断，非元阁家族包不自动安装。
 license: MIT
 metadata:
@@ -162,8 +162,10 @@ Hub 把「每个宿主装一份」改成「本机一份真源，按宿主链接
 元技能（清单 27 + 特殊家族 5：元开 / 元伴 / 元呈 / 元阁本体 / 元信MCP）
 在 `hub link` 执行时收敛唯一性：宿主里的同名真目录 / `yotta-X__*`
 重命名副本会先移入回收站（`~/.yottaskills/trash/<时间戳>/`，保留 7 天、
-输出恢复路径），再建立指向 Hub 的链接；宿主版本高于 Hub 时跳过并提示先
-`hub update`；外部技能同名冲突仍默认跳过、不自动删、不自动更新。
+输出恢复路径；跨卷场景自动回退「复制 → 校验 → 删除源」），再建立指向
+Hub 的链接；宿主版本高于 Hub 时跳过并提示先
+`hub update`；目标条目为指向 Hub 之外的链接时默认跳过，显式 `--force`
+可替换（仅移除链接本身）；外部技能同名冲突仍默认跳过、不自动删、不自动更新。
 
 ```bash
 # 1) 只读发现本机已装智能体与技能目录（文件系统 + 环境变量；不读元忆 / 注册表）
@@ -221,7 +223,7 @@ npx -y @yottameta/yotta-skills hub unlink --all
 | `hub adopt --scan` | 只读预演：扫描各宿主现有技能，输出收编候选、多副本冲突、已在 Hub 状态 |
 | `hub adopt --apply [--include <a,b>] [--force] [--in-place]` | 把选中技能收编进 Hub；输出明示范围与目标 Hub；默认复制保真 + 原目录保留；非元阁来源标注「无更新源」并对严格 YAML 风险只读告警；`--skip-scan` 显式提示跳过装前扫描 |
 | `hub refresh <slug> --from <path>` | 手动同步非元阁技能（重新收编 + 更新哈希 + 台账） |
-| `hub link --agent <id> \| --dir <dir> \| --all` | 把 Hub 技能链接到指定宿主 / 目录 / 全部已发现宿主；元技能链接时收敛旧副本（回收站 7 天）；`--dry-run` 只预览（含将收敛明细） |
+| `hub link --agent <id> \| --dir <dir> \| --all` | 把 Hub 技能链接到指定宿主 / 目录 / 全部已发现宿主；元技能链接时收敛旧副本（回收站 7 天）；`--dry-run` 只预览（含将收敛明细）；`--force` 可替换指向 Hub 之外的链接（仅移除链接本身） |
 | `hub unlink --agent <id> \| --dir <dir> \| --all` | 只删除链接；lstat + readlink 校验目标在 Hub 内，fail-closed |
 | `hub status [--json]` | 查看 Hub 技能来源、版本、链接宿主、异常链接与宿主发现摘要 |
 | `hub doctor [--json]` | 检查断链 / Hub 目标缺失 / slug 不一致 / 单一真源（只读报告多份副本与版本参差）/ 目录权限；异常时退出码 1 |

package/skills/yotta-skills/bin/yotta-skills.js

@@ -55,7 +55,7 @@ const { createInstaller, isSafeTarEntry } = require('../lib/install-pipeline');
 const { COPY_SKIP, copyDir } = require('../lib/copy-tree');
 
 const PKG_ROOT = path.join(__dirname, '..');
-let VERSION = '0.27.0';
+let VERSION = '0.27.1';
 try { VERSION = require(path.join(PKG_ROOT, 'package.json')).version; } catch (_) { /* keep fallback */ }
 
 // @generated view-html:start

package/skills/yotta-skills/lib/hub.js

@@ -189,6 +189,161 @@ function hashTree(dir) {
   return hash.digest('hex');
 }
 
+/** 统计目录树中的普通文件数与总字节数（不跟随链接；跨卷复制校验用）。 */
+function treeStats(dir) {
+  let files = 0;
+  let bytes = 0;
+  const walk = (current) => {
+    for (const name of fs.readdirSync(current)) {
+      const full = path.join(current, name);
+      const stat = fs.lstatSync(full);
+      if (stat.isSymbolicLink()) continue;
+      if (stat.isDirectory()) walk(full);
+      else if (stat.isFile()) {
+        files += 1;
+        bytes += stat.size;
+      }
+    }
+  };
+  walk(path.resolve(dir));
+  return { files, bytes };
+}
+
+/** 重建链接条目：目录优先用 junction（Windows）/ dir（POSIX），文件用 file。 */
+function copyLinkEntry(src, dest) {
+  const target = fs.readlinkSync(src);
+  let kinds;
+  if (process.platform === 'win32') {
+    let isDir = null;
+    try {
+      isDir = fs.statSync(src).isDirectory();
+    } catch (_) {
+      isDir = null;
+    }
+    kinds = isDir === false ? ['file', 'junction'] : ['junction', 'file'];
+  } else {
+    let isDir = false;
+    try {
+      isDir = fs.statSync(src).isDirectory();
+    } catch (_) {
+      isDir = false;
+    }
+    kinds = [isDir ? 'dir' : 'file'];
+  }
+  let lastError = null;
+  for (const kind of kinds) {
+    try {
+      fs.symlinkSync(target, dest, kind);
+      return;
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError || new Error('无法重建链接：' + src);
+}
+
+/** 逐条目复制目录树（保真：含链接、空目录与全部普通文件）。 */
+function copyEntryFaithful(src, dest) {
+  const stat = fs.lstatSync(src);
+  if (stat.isSymbolicLink()) {
+    copyLinkEntry(src, dest);
+    return;
+  }
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const name of fs.readdirSync(src)) {
+      const child = path.join(src, name);
+      const childStat = fs.lstatSync(child);
+      if (childStat.isSymbolicLink()) copyLinkEntry(child, path.join(dest, name));
+      else if (childStat.isDirectory()) copyEntryFaithful(child, path.join(dest, name));
+      else if (childStat.isFile()) fs.copyFileSync(child, path.join(dest, name));
+      else throw new Error('不支持的条目类型：' + child);
+    }
+    return;
+  }
+  if (stat.isFile()) {
+    fs.copyFileSync(src, dest);
+    return;
+  }
+  throw new Error('不支持的条目类型：' + src);
+}
+
+/** 删除条目：链接只删链接本身，不触碰目标。 */
+function removeEntryFaithful(entryPath) {
+  const stat = fs.lstatSync(entryPath);
+  if (stat.isSymbolicLink()) {
+    removeDirLink(entryPath);
+    return;
+  }
+  fs.rmSync(entryPath, { recursive: true, force: true });
+}
+
+/** 校验复制结果：链接比对目标，目录比对 treeHash + 文件数 + 字节数。 */
+function verifyEntryCopy(src, dest) {
+  const srcStat = fs.lstatSync(src);
+  const destStat = fs.lstatSync(dest);
+  if (srcStat.isSymbolicLink() !== destStat.isSymbolicLink()) {
+    return { ok: false, reason: '条目类型不一致' };
+  }
+  if (srcStat.isSymbolicLink()) {
+    if (fs.readlinkSync(src) !== fs.readlinkSync(dest)) {
+      return { ok: false, reason: '链接目标不一致' };
+    }
+    return { ok: true };
+  }
+  if (hashTree(src) !== hashTree(dest)) {
+    return { ok: false, reason: 'treeHash 不一致' };
+  }
+  const from = treeStats(src);
+  const to = treeStats(dest);
+  if (from.files !== to.files || from.bytes !== to.bytes) {
+    return {
+      ok: false,
+      reason: '文件数 / 字节数不一致（源 ' + from.files + ' 个 / ' + from.bytes + ' 字节；副本 ' +
+        to.files + ' 个 / ' + to.bytes + ' 字节）',
+    };
+  }
+  return { ok: true };
+}
+
+/**
+ * 跨卷安全移动：优先 rename；EXDEV（跨盘）时回退「复制 → 校验 → 删除源」。
+ * 任一步失败都不静默丢数据：源完整则回滚副本；源已不完整则保留完整副本并报出路径。
+ */
+function moveEntryAcrossDevices(src, dest, options) {
+  const opts = options || {};
+  const renameEntry = typeof opts.renameEntry === 'function' ? opts.renameEntry : fs.renameSync;
+  try {
+    renameEntry(src, dest);
+    return { method: 'rename' };
+  } catch (error) {
+    if (!error || error.code !== 'EXDEV') throw error;
+  }
+  copyEntryFaithful(src, dest);
+  let check;
+  try {
+    check = verifyEntryCopy(src, dest);
+  } catch (error) {
+    check = { ok: false, reason: error.message };
+  }
+  if (!check.ok) {
+    try { removeEntryFaithful(dest); } catch (_) { /* 保留现场供排查 */ }
+    throw new Error('跨卷复制校验失败（' + check.reason + '）；源目录未动，副本已清理');
+  }
+  try {
+    removeEntryFaithful(src);
+  } catch (error) {
+    let intact = false;
+    try { intact = verifyEntryCopy(dest, src).ok; } catch (_) { intact = false; }
+    if (intact) {
+      try { removeEntryFaithful(dest); } catch (_) { /* 保留现场供排查 */ }
+      throw new Error('跨卷复制完成但源删除失败：' + error.message + '；源目录完整，副本已回滚');
+    }
+    throw new Error('跨卷复制完成但源删除失败：' + error.message + '；完整副本保留在 ' + dest);
+  }
+  return { method: 'copy' };
+}
+
 function scanHubSkills(hubDir) {
   const root = path.resolve(hubDir);
   const result = [];
@@ -491,6 +646,7 @@ function linkSkills(options) {
   const results = [];
   const trashRoot = resolveTrashRoot(hubDir, opts);
   const makeLink = typeof opts.createLink === 'function' ? opts.createLink : createDirLink;
+  const renameEntry = typeof opts.renameEntry === 'function' ? opts.renameEntry : fs.renameSync;
   const stamp = trashRunStamp(opts.now);
   const hostName = safeHostName(opts.label || path.basename(targetDir));
   let prunedTrash = 0;
@@ -520,6 +676,7 @@ function linkSkills(options) {
       const moves = [];
       const skipped = [];
       let block = null;
+      let replaceExactLink = false;
 
       const evaluate = (copy, isExact) => {
         if (!copy) return;
@@ -532,7 +689,11 @@ function linkSkills(options) {
             return;
           }
           if (isExact) {
-            block = { status: 'conflict', note: '目标已存在指向 Hub 之外的链接（默认跳过；确认后可加 --force 替换）' };
+            if (force) {
+              replaceExactLink = true;
+            } else {
+              block = { status: 'conflict', note: '目标已存在指向 Hub 之外的链接（默认跳过；确认后可加 --force 替换）' };
+            }
           } else {
             skipped.push(copy.name + '（外部链接，保留）');
           }
@@ -593,7 +754,8 @@ function linkSkills(options) {
           slug,
           status: 'would-converge',
           target,
-          note: '将收敛 ' + moves.length + ' 份旧副本（移入回收站，保留 ' + TRASH_RETENTION_DAYS + ' 天）后建立链接：' +
+          note: '将收敛 ' + moves.length + ' 份旧副本（移入回收站，保留 ' + TRASH_RETENTION_DAYS + ' 天）' +
+            (replaceExactLink ? '并替换指向 Hub 之外的链接' : '') + '后建立链接：' +
             moves.map((item) => item.name).join('、'),
           moves: moves.map((item) => ({ from: item.dir, name: item.name, version: item.version || null })),
           trashDir: trashRoot,
@@ -601,11 +763,14 @@ function linkSkills(options) {
         continue;
       }
       if (moves.length === 0 && dryRun) {
-        results.push({ slug, status: 'would-link', target, note: '将建立链接' });
+        results.push(replaceExactLink
+          ? { slug, status: 'would-replace', target, note: '将替换指向 Hub 之外的链接并建立链接' }
+          : { slug, status: 'would-link', target, note: '将建立链接' });
         continue;
       }
       if (moves.length === 0) {
         try {
+          if (replaceExactLink) removeDirLink(target);
           makeLink(skill.dir, target);
           const index = links.findIndex((item) => item.slug === slug && samePath(item.dir || '', targetDir));
           const record = {
@@ -624,15 +789,25 @@ function linkSkills(options) {
             slug,
             status: 'linked',
             target,
-            note: '已建立链接' + (skipped.length ? '（保留：' + skipped.join('、') + '）' : ''),
+            note: (replaceExactLink
+              ? '已替换指向 Hub 之外的链接并建立链接（仅移除链接本身，目标目录未动）'
+              : '已建立链接') + (skipped.length ? '（保留：' + skipped.join('、') + '）' : ''),
+          });
+          appendAudit(hubDir, {
+            event: 'link',
+            slug,
+            target,
+            hubDir: skill.dir,
+            backup: null,
+            ...(replaceExactLink ? { replacedExternalLink: true } : {}),
           });
-          appendAudit(hubDir, { event: 'link', slug, target, hubDir: skill.dir, backup: null });
         } catch (error) {
           results.push({
             slug,
             status: 'error',
             target,
-            note: error.message + '（未静默降级为复制；请检查目录权限或改用 --dir 指定可写目录）',
+            note: (replaceExactLink ? '替换失败：' : '') + error.message +
+              '（未静默降级为复制；请检查目录权限或改用 --dir 指定可写目录）',
           });
         }
         continue;
@@ -642,10 +817,19 @@ function linkSkills(options) {
         for (const item of moves) {
           const dest = path.join(trashRoot, stamp, hostName, item.name);
           fs.mkdirSync(path.dirname(dest), { recursive: true });
-          fs.renameSync(item.dir, dest);
-          moved.push({ from: item.dir, to: dest, name: item.name, version: item.version || null });
+          const transfer = moveEntryAcrossDevices(item.dir, dest, { renameEntry });
+          moved.push({
+            from: item.dir,
+            to: dest,
+            name: item.name,
+            version: item.version || null,
+            method: transfer.method,
+          });
+        }
+        if (!exactHealthy) {
+          if (replaceExactLink) removeDirLink(target);
+          makeLink(skill.dir, target);
         }
-        if (!exactHealthy) makeLink(skill.dir, target);
         const index = links.findIndex((item) => item.slug === slug && samePath(item.dir || '', targetDir));
         const record = {
           slug,
@@ -660,11 +844,14 @@ function linkSkills(options) {
         };
         if (index >= 0) links[index] = record;
         else links.push(record);
+        const copiedCount = moved.filter((item) => item.method === 'copy').length;
         results.push({
           slug,
           status: 'linked',
           target,
           note: '已收敛 ' + moved.length + ' 份旧副本（回收站保留 ' + TRASH_RETENTION_DAYS + ' 天）并建立链接' +
+            (replaceExactLink ? '（已替换指向 Hub 之外的链接；仅移除链接本身）' : '') +
+            (copiedCount ? '（其中 ' + copiedCount + ' 份跨卷复制，校验通过）' : '') +
             (skipped.length ? '；保留：' + skipped.join('、') : ''),
           moved,
           trashDir: trashRoot,
@@ -677,13 +864,14 @@ function linkSkills(options) {
           hubVersion: skill.version,
           moved,
           trashDir: trashRoot,
+          ...(replaceExactLink ? { replacedExternalLink: true } : {}),
         });
       } catch (error) {
         let restored = true;
         for (const item of moved.slice().reverse()) {
           try {
             fs.mkdirSync(path.dirname(item.from), { recursive: true });
-            fs.renameSync(item.to, item.from);
+            moveEntryAcrossDevices(item.to, item.from, { renameEntry });
           } catch (_) { restored = false; }
         }
         results.push({
@@ -1009,6 +1197,7 @@ module.exports = {
   writeLinkState,
   appendAudit,
   hashTree,
+  moveEntryAcrossDevices,
   scanHubSkills,
   syncHubState,
   familySlugSet,

package/skills/yotta-skills/references/hub.md

@@ -23,7 +23,12 @@ symlink），升级只改真源，已链接宿主即时生效。
 2. 版本闸门：Hub 版本 ≥ 宿主副本版本才收敛；宿主更高 → 跳过并提示先 `hub update`；
    版本无法解析 → 跳过提示（fail-safe）；
 3. 旧副本移入回收站（保留 7 天、输出恢复路径）→ 建立指向 Hub 的链接；
+   跨盘（源目录在其它卷，或经 junction / symlink 落在其它卷）时 `rename`
+   会报 `EXDEV`，自动回退「复制 → 校验（treeHash + 文件数 + 字节数）→ 删除源」；
+   建链失败后的恢复同样支持跨盘回退，校验不通过不会删除源；
 4. 先移后链；建链失败自动尝试恢复已移动副本，恢复失败时报出回收站路径；
+   目标条目为指向 Hub 之外的链接时默认跳过；显式 `--force` 可替换为 Hub 链接
+   （仅移除链接本身，目标目录不动；dry-run 报 `would-replace`）；
 5. 外部技能保持原行为：同名冲突默认跳过，不自动删、不自动更新。
 
 落地后跑一次 `hub link --all` 即可完成现存收敛。`hub doctor` 的

package/skills/yotta-skills/scripts/yotta-skills-mcp.py

@@ -27,7 +27,7 @@ import subprocess
 import sys
 from pathlib import Path
 
-VERSION = "0.27.0"
+VERSION = "0.27.1"
 TOOL_NAME = "yotta-skills"
 CN_NAME = "元阁"
 MCP_PROTOCOL_MODERN = "2026-07-28"