@yottameta/yotta-skills-plugin 0.28.1 → 0.28.3

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

@@ -1017,6 +1017,277 @@ function unlinkSkills(options) {
   return { hubDir, targetDir, dryRun, results };
 }
 
+/**
+ * 删除 Hub 技能：全宿主清理指向 Hub 的链接（含死链）→ Hub 目录移入回收站 →
+ * 定向清 Hub 台账与链接台账 → 写审计。
+ *
+ * 五阶段 fail-closed：
+ *   1. preflight（只读分类，dry-run 到此为止）
+ *   2. unlink（只删指向 Hub 的链接；报错即中止，不进入 3）
+ *   3. trash（目录移入回收站保留 7 天；跨卷走复制 + 校验 + 删源）
+ *   4. ledger（定向删 Hub 台账条目 + 过滤链接台账；不调 syncHubState，防记回 missing）
+ *   5. 汇总（含版本闸门报告）
+ *
+ * options:
+ * - hubDir / slug（必填）
+ * - targets: [{ dir, label, agentId }]（调用方解析范围；核心不做范围判断）
+ * - dryRun / trashRoot / trashRetentionDays / now
+ * - renameEntry / unlink（测试注入点）
+ */
+function removeSkills(options) {
+  const opts = options || {};
+  const hubDir = path.resolve(opts.hubDir);
+  const slug = String(opts.slug || '').trim().toLowerCase();
+  const dryRun = Boolean(opts.dryRun);
+  const unlinkFn = typeof opts.unlink === 'function' ? opts.unlink : unlinkSkills;
+  const targets = (Array.isArray(opts.targets) ? opts.targets : [])
+    .filter((item) => item && item.dir)
+    .map((item) => ({
+      dir: path.resolve(item.dir),
+      label: item.label || '指定目录',
+      agentId: item.agentId || null,
+    }));
+  const trashRoot = resolveTrashRoot(hubDir, opts);
+  const skillDir = path.join(hubDir, slug);
+  const compact = (plan) => ({
+    dir: plan.dir,
+    label: plan.label,
+    status: plan.status,
+    action: plan.action,
+    note: plan.note,
+    ...(plan.version ? { version: plan.version } : {}),
+    ...(plan.versionGate ? { versionGate: true } : {}),
+    ...(plan.drift ? { drift: true } : {}),
+    ...(plan.broken ? { broken: true } : {}),
+  });
+
+  let hubPathKind = 'missing';
+  let hubEntry = null;
+  try {
+    const stat = fs.lstatSync(skillDir);
+    hubPathKind = stat.isSymbolicLink() ? 'link' : stat.isDirectory() ? 'directory' : 'file';
+  } catch (_) {
+    hubPathKind = 'missing';
+  }
+  if (hubPathKind === 'file') {
+    return {
+      hubDir,
+      slug,
+      dryRun,
+      verdict: 'failed',
+      ok: false,
+      exitCode: 1,
+      hubPresent: false,
+      hubPathKind,
+      hubVersion: null,
+      targets: [],
+      unlinkable: 0,
+      kept: [],
+      failed: [{ dir: skillDir, note: 'Hub 内同名路径是普通文件；fail-closed，拒绝删除' }],
+      trashedTo: null,
+    };
+  }
+  if (hubPathKind !== 'missing') {
+    hubEntry = scanHubSkills(hubDir).find((item) => samePath(item.dir, skillDir)) || null;
+  }
+  const hubVersion = hubEntry && hubEntry.version ? hubEntry.version : '';
+
+  // ── 1. preflight（只读） ────────────────────────────────────────────────
+  const plans = targets.map((target) => {
+    const targetPath = path.join(target.dir, slug);
+    const current = classifyTarget(targetPath, hubDir);
+    if (current.kind === 'missing') {
+      return {
+        dir: target.dir,
+        label: target.label,
+        target: targetPath,
+        action: 'none',
+        status: 'missing',
+        note: '目标不存在',
+      };
+    }
+    if (current.kind === 'link') {
+      if (!current.inHub) {
+        return {
+          dir: target.dir,
+          label: target.label,
+          target: targetPath,
+          action: 'keep',
+          status: 'refused',
+          note: '链接指向 Hub 之外；fail-closed 保留',
+        };
+      }
+      const drift = !samePath(current.target, skillDir);
+      const broken = current.targetExists === false;
+      return {
+        dir: target.dir,
+        label: target.label,
+        target: targetPath,
+        action: 'unlink',
+        status: 'link',
+        drift,
+        broken,
+        note: broken
+          ? '死链（Hub 目标缺失），将清理'
+          : drift
+            ? '链接指向 Hub 内其它技能，将一并清理'
+            : '指向本技能的链接，将清理',
+      };
+    }
+    if (current.kind === 'directory') {
+      const meta = readSkillMeta(targetPath);
+      const version = meta && meta.version ? meta.version : '';
+      const higher = Boolean(version && hubVersion && compareVersions(version, hubVersion) > 0);
+      return {
+        dir: target.dir,
+        label: target.label,
+        target: targetPath,
+        action: 'keep',
+        status: 'kept-directory',
+        version: version || null,
+        versionGate: higher,
+        note: higher
+          ? '宿主真副本 v' + version + ' 高于 Hub v' + hubVersion + '；保留（先确认该副本）'
+          : '宿主真副本，保留（只删链接）',
+      };
+    }
+    return {
+      dir: target.dir,
+      label: target.label,
+      target: targetPath,
+      action: 'keep',
+      status: 'kept-file',
+      note: '普通文件，保留',
+    };
+  });
+
+  const stateSnapshot = readHubState(hubDir);
+  const hasStateEntry = Boolean(stateSnapshot.skills && stateSnapshot.skills[slug]);
+  const hubPresent = hubPathKind === 'directory' || hubPathKind === 'link';
+  const unlinkable = plans.filter((plan) => plan.action === 'unlink').length;
+  const kept = plans.filter((plan) => plan.action === 'keep');
+  const base = {
+    hubDir,
+    slug,
+    dryRun,
+    hubPresent,
+    hubPathKind,
+    hubVersion: hubVersion || null,
+    targets: plans.map(compact),
+    unlinkable,
+    kept: kept.map(compact),
+  };
+  if (dryRun) {
+    return { ...base, verdict: 'dry-run', ok: true, exitCode: 0, trashedTo: null };
+  }
+
+  // ── 2. unlink（含死链；报错即中止，不删 Hub） ───────────────────────────
+  const unlinked = [];
+  const failed = [];
+  for (const plan of plans) {
+    if (plan.action !== 'unlink') continue;
+    const result = unlinkFn({ hubDir, targetDir: plan.dir, slugs: [slug], dryRun: false });
+    const item = (result.results || [])[0] || { status: 'error', note: '未知结果' };
+    plan.status = item.status;
+    plan.note = item.note || plan.note;
+    if (item.status === 'error') failed.push({ dir: plan.dir, note: item.note });
+    else unlinked.push({ dir: plan.dir, status: item.status, note: item.note });
+  }
+  if (failed.length > 0) {
+    if (fs.existsSync(hubDir)) {
+      try {
+        appendAudit(hubDir, {
+          event: 'remove',
+          slug,
+          verdict: 'failed',
+          reason: 'unlink-error',
+          targets: plans.map(compact),
+          removedLinks: unlinked.length,
+        });
+      } catch (_) { /* audit best-effort */ }
+    }
+    return { ...base, verdict: 'failed', ok: false, exitCode: 1, unlinked, failed, trashedTo: null };
+  }
+
+  // ── 3. trash（Hub 目录入回收站；失败即中止） ────────────────────────────
+  let trashedTo = null;
+  let method = null;
+  if (hubPresent) {
+    trashedTo = path.join(trashRoot, trashRunStamp(opts.now), 'hub-remove', slug);
+    try {
+      fs.mkdirSync(path.dirname(trashedTo), { recursive: true });
+      const transfer = moveEntryAcrossDevices(skillDir, trashedTo, { renameEntry: opts.renameEntry });
+      method = transfer.method;
+    } catch (error) {
+      if (fs.existsSync(hubDir)) {
+        try {
+          appendAudit(hubDir, {
+            event: 'remove',
+            slug,
+            verdict: 'failed',
+            reason: 'trash-error',
+            targets: plans.map(compact),
+            removedLinks: unlinked.length,
+            trashedTo,
+          });
+        } catch (_) { /* audit best-effort */ }
+      }
+      return {
+        ...base,
+        verdict: 'failed',
+        ok: false,
+        exitCode: 1,
+        unlinked,
+        failed: [{ dir: skillDir, note: error.message }],
+        trashedTo,
+      };
+    }
+  }
+
+  // ── 4. ledger（定向清台账；不调 syncHubState） ──────────────────────────
+  const state = readHubState(hubDir);
+  if (state.skills && state.skills[slug]) {
+    delete state.skills[slug];
+    writeHubState(hubDir, state);
+  }
+  const linkState = readLinkState(hubDir);
+  const remainingLinks = linkState.links.filter((item) => item.slug !== slug);
+  if (remainingLinks.length !== linkState.links.length) {
+    writeLinkState(hubDir, { links: remainingLinks });
+  }
+  let prunedTrash = 0;
+  try { prunedTrash = pruneTrash(trashRoot, { days: opts.trashRetentionDays }); } catch (_) { prunedTrash = 0; }
+
+  // ── 5. 汇总 + 审计 ─────────────────────────────────────────────────────
+  const verdict = hubPresent ? 'removed' : (unlinked.length > 0 || hasStateEntry ? 'cleanup-only' : 'not-found');
+  const exitCode = verdict === 'not-found' ? 4 : 0;
+  if (fs.existsSync(hubDir)) {
+    try {
+      appendAudit(hubDir, {
+        event: 'remove',
+        slug,
+        verdict,
+        targets: plans.map(compact),
+        removedLinks: unlinked.length,
+        kept: kept.length,
+        trashedTo,
+        method,
+      });
+    } catch (_) { /* audit best-effort */ }
+  }
+  return {
+    ...base,
+    verdict,
+    ok: exitCode === 0,
+    exitCode,
+    unlinked,
+    kept: kept.map(compact),
+    trashedTo,
+    method,
+    prunedTrash,
+  };
+}
+
 function linkStatus(hubDir) {
   const state = readLinkState(hubDir);
   return state.links.map((item) => {
@@ -1233,6 +1504,7 @@ module.exports = {
   classifyTarget,
   linkSkills,
   unlinkSkills,
+  removeSkills,
   linkStatus,
   status,
   doctor,

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

@@ -86,11 +86,35 @@ npx -y @yottameta/yotta-skills hub link --all --include-discovered
 # 只删除链接，不动 Hub 真源；清理范围外链接用 --dir <目录> 精确指定
 npx -y @yottameta/yotta-skills hub unlink --all
 
+# 指定智能体分发 / 解除（只影响该宿主；Hub 真源保留）
+npx -y @yottameta/yotta-skills hub link yotta-memory --agent codex
+npx -y @yottameta/yotta-skills hub unlink yotta-memory --agent codex
+
+# 彻底删除 Hub 技能：全宿主清链接（含死链）+ 目录入回收站 + 清台账 + 审计
+npx -y @yottameta/yotta-skills hub remove my-skill --dry-run
+
 # 查看来源、版本、链接宿主与异常
 npx -y @yottameta/yotta-skills hub status
 npx -y @yottameta/yotta-skills hub doctor
 ```
 
+## 删除技能（hub remove，0.28.3 起）
+
+`hub remove <slug>` 五阶段 fail-closed：
+
+1. **preflight（只读）**：逐目录分类健康链接 / 死链 / 漂移链接 / 指向 Hub 外链接 /
+   真副本 / 不存在；`--dry-run` 到此为止（零写入）。
+2. **unlink**：只删指向 Hub 的链接（含死链）；报错即中止，不进入下一步。
+3. **trash**：Hub 目录移入 `<hub>/../trash/<stamp>/hub-remove/<slug>`，保留 7 天；
+   跨卷自动回退「复制 → 校验 → 删源」。
+4. **ledger**：定向删 `.yotta-hub.json` 条目 + 过滤 `.yotta-links.json`
+   （不调 `syncHubState`，防止把删除记回 `missing`）。
+5. **审计 + 汇总**：写 `remove` 审计；无痕迹时退出码 4。
+
+边界：真副本 / 外部链接一律保留并报告（真副本版本高于 Hub 时逐条提示）；
+`--agent` / `--dir` 收窄仅用于「Hub 目标已缺失」的死链清理；恢复路径 =
+从回收站取回 + `hub install` 重装 + `hub link` 重建。
+
 ## 宿主发现口径
 
 1. 已收录宿主映射（81 条；兼容 Vercel Labs `skills` CLI / SkillCat 的公开宿主表，
@@ -121,9 +145,11 @@ npx -y @yottameta/yotta-skills view --port 8790
 
 面板只在 `127.0.0.1`（默认 8789）监听，零远程资源、零遥测，只读写 Hub
 目录与台账 / 证据文件，不读元忆、不改宿主全局配置。六个视图：概览、宿主矩阵、
-收编向导、链接与体检、记录与回滚、路由与编排，另附高级 CLI 页。
+收编向导、链接与体检、记录与回滚、路由与编排，另附**全量 CLI 页**（全部命令 /
+子命令 + 人话说明 + 可复制示例 + 完整选项，与 `--help` 单一真源）。
 
-动作边界：收编 / 链接 / 解除 / 回滚可执行（预览 → 确认 → 执行 → 证据）；
+动作边界：收编 / 链接 / 解除 / 回滚 / 删除技能可执行（预览 → 确认 → 执行 → 证据；
+删除技能需手输 slug 二次确认）；概览 Hub 内容行可过滤后直接删除技能；
 install / update / refresh 只在高级 CLI 页给出可复制命令，不在网页执行。
 写操作需要页面会话令牌，解除与回滚需要破坏性确认串；收编始终逐项运行元信
 扫描，high / critical 阻断。
@@ -132,6 +158,8 @@ install / update / refresh 只在高级 CLI 页给出可复制命令，不在网
 
 - `unlink` 只删除 lstat 确认为链接、且 readlink 目标位于 Hub 内的路径。
 - 真目录 / 非 Hub 链接一律拒绝删除；`--force` 对真目录先备份再替换。
+- `remove` 只删指向 Hub 的链接与 Hub 内目录；链接清理报错即中止、不删 Hub；
+  Hub 目录入回收站保留 7 天，可恢复。
 - 收敛只动元技能在宿主目录中的旧副本：移入回收站（7 天）而非直删；
   不碰插件与宿主 MCP 配置；外部技能源文件绝不修改。
 - Hub 仅本机使用，不对外分发技能内容。

package/skills/yotta-skills/references/skill-list.md

@@ -1,14 +1,14 @@
 # 全家技能清单（27 个）
 
 > 机器权威源：`skills.json`（随包分发）；本文件为人工可读副本，新技能发布后须同步更新
-> `skills.json`（登记表为内部台账，不随包分发）。清单更新日期：2026-10-02。
+> `skills.json`（登记表为内部台账，不随包分发）。清单更新日期：2026-10-03。
 
 | slug | 中文名 | npm 包 | 清单版本 | 家族 | 说明 |
 |---|---|---|---|---|
 | `yotta-anti-shallow` | 元谨 | `@yottameta/yotta-anti-shallow` | 1.4.2 | quality | 防 AI 敷衍规则引擎（深入分析/根因追溯时激活） |
 | `yotta-code-quality` | 元质 | `@yottameta/yotta-code-quality` | 0.4.3 | quality | 结对式代码质量评审（十二类腐化风险 + 0-100 健康分） |
 | `yotta-workflow` | 元序 | `@yottameta/yotta-workflow` | 0.4.3 | workflow | 跨会话/跨项目通用工作流协议（状态就近存） |
-| `yotta-memory` | 元忆 | `@yottameta/yotta-memory` | 0.21.1 | memory | 有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT） |
+| `yotta-memory` | 元忆 | `@yottameta/yotta-memory` | 0.22.1 | memory | 有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT） |
 | `yotta-learn` | 元习 | `@yottameta/yotta-learn` | 0.2.2 | memory | 学习沉淀 CLI：错误/纠正/洞见沉淀为 .learnings/ 条目 |
 | `yotta-security-audit` | 元安 | `@yottameta/yotta-security-audit` | 0.3.1 | security | 安全扫描引擎：13 类检测器 + 系统安全基线 + 学生数据隐私（教育版） |
 | `yotta-vetter` | 元审 | `@yottameta/yotta-vetter` | 0.2.7 | security | 安全审查协议：四阶段 review + SAFE TO INSTALL 判定 |

package/skills/yotta-skills/scan-policy.json

@@ -197,10 +197,10 @@
       ]
     },
     "yotta-memory": {
-      "version": "0.21.1",
-      "treeHash": "sha256:452c1674084e916b3f6e0831f3662eaf2852af0e9a4fea3b0ff6a42c6bec9e71",
+      "version": "0.22.1",
+      "treeHash": "sha256:0fb2fa87f85c43a4e6393791944516e3daa5fecbf5bff77648f57eed71aa1ee2",
       "files": 18,
-      "bytes": 1270192,
+      "bytes": 1299467,
       "mode": "strict",
       "exceptions": [
         {

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

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

package/skills/yotta-skills/skills.json

@@ -31,7 +31,7 @@
     "slug": "yotta-memory",
     "name": "元忆",
     "pkg": "@yottameta/yotta-memory",
-    "version": "0.21.1",
+    "version": "0.22.1",
     "domain": "memory",
     "runtimePayload": ["bin"],
     "desc": "有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT）"