@yottameta/yotta-skills-plugin 0.29.0 → 0.29.1

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

@@ -113,6 +113,30 @@ function compareSemver(left, right) {
   return comparePrerelease(a.prerelease, b.prerelease);
 }
 
+/**
+ * 版本关系判定（元阁 update「只升不降」统一口径，0.29.1 U1）。
+ *
+ * installed：本地已装版本（null = 未装）；target：目标版本（精确 semver 或 'latest'）。
+ * 返回：
+ * - install：本地未装（含 target = latest，解析后照常安装）
+ * - upgrade：本地低于目标（唯一应安装的关系）
+ * - equal：本地与目标相等
+ * - local-ahead：本地高于目标（保留，不降级）
+ * - unknown：任一侧无法解析（fail-safe 保留）
+ * - resolve-needed：目标为 latest（需先解析出精确版本再复判）
+ *
+ * 注意：compareSemver 对不可解析输入返回 0，必须先 parseSemver 校验，
+ * 不能直接拿 compare === 0 当相等。
+ */
+function versionRelation(installed, target) {
+  if (!installed) return 'install';
+  if (target === 'latest') return 'resolve-needed';
+  if (!parseSemver(installed) || !parseSemver(target)) return 'unknown';
+  const diff = compareSemver(installed, target);
+  if (diff === 0) return 'equal';
+  return diff > 0 ? 'local-ahead' : 'upgrade';
+}
+
 /** 从多个安装副本中选择代表版本：优先合法版本中的最高 semver。 */
 function selectRepresentativeVariant(variants) {
   let selected = null;
@@ -436,6 +460,7 @@ module.exports = {
   parseFrontmatter,
   parseSemver,
   compareSemver,
+  versionRelation,
   strictFrontmatterWarnings,
   scanSkillDir,
   defaultRoots,

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

@@ -87,6 +87,36 @@ npx -y @yottameta/yotta-skills hub hosts remove ~/my-agent/skills --purge --yes
 注册表 = `<root>/hosts.json`（root = `YOTTA_SKILLS_HOME` 或 `~/.yottaskills`，schema v1，
 可 diff）；面板「宿主矩阵 → 添加自定义目录」等价可用，写操作需页面令牌与确认串。
 
+## 不接管与目录覆盖（0.29.1 起）
+
+**不接管**（excluded）：把某个智能体或目录从发现、显示、链接三层全部跳过
+（`--include-discovered` 也不纳入）；已建立的链接不受影响，可用 `hub unlink` 清理：
+
+```bash
+npx -y @yottameta/yotta-skills hub hosts exclude box                    # 按 agentId
+npx -y @yottameta/yotta-skills hub hosts exclude "D:\my-agent\skills"  # 按目录
+npx -y @yottameta/yotta-skills hub hosts include box                    # 恢复接管
+```
+
+**目录覆盖**（override）：用户级覆盖某个已收录 agentId 的内置映射目录
+（不改宿主配置；被覆盖的旧目录不再进入默认发现 / 链接）：
+
+```bash
+npx -y @yottameta/yotta-skills hub hosts set box --dir "D:\box-agent\skills"
+npx -y @yottameta/yotta-skills hub hosts set box --clear     # 恢复内置映射
+```
+
+面板「宿主矩阵」提供等价动作：行内「不接管 / 编辑目录 / 标记可用 / 忽略」，
+底部「不接管名单」区可「恢复接管」；写操作均写 Hub 审计。
+
+**YottaCode 不纳入接管**：YottaCode 自带三层技能管理（skill-inventory / skill /
+user-skills），元阁对其 `.yottacode` 路径与 `YOTTACODE_HOME` 子树在映射、扫描、
+注册、标记、链接全部 fail-closed 排除，避免重复管理。
+
+**未核实映射 ≠ 自动发现**：内置映射里尚未逐机核实的条目显示「映射·未核实」；
+「自动发现」只用于文件系统扫描结果。`installed` 配对按「用户注册 / 已核实映射 > env >
+未核实映射 > 自动发现」确定性优选（同级按技能数 + 路径稳定排序）。
+
 ## 命令
 
 ```bash

package/skills/yotta-skills/references/install-flow.md

@@ -77,14 +77,17 @@
 
 - 读取目标 `<dest>/<slug>/SKILL.md` 的 frontmatter `version`；
 - 与清单 `version` 一致 → 跳过（幂等：第二次安装 27 个全部跳过）；
-- `--force` 强制重装；`update` 对「缺失 / 版本不一致」的技能重装。
+- **只升不降（0.29.1 起）**：本地版本高于目标（清单 pin / npm latest）→ 保留并标注「本地领先」，
+  `update` / `hub update` 跳过、`update --check` 不计更新（退出码 0）、`update --auto` 不动作；
+  `latest` / `--range` 目标在解析出精确版本后、任何写入之前复判；
+- `--force` 强制重装 / 显式降级；`rollback` 恢复快照；`update` 对「缺失 / 需要升级」的技能安装。
 
 ## 范围控制（接多少管多少）
 
 | 用法 | 范围 |
 |---|---|
 | `install`（无旗标） | 全量清单全部安装 |
-| `update`（无旗标） | 补齐缺失 + 升级已装（现状语义不变） |
+| `update`（无旗标） | 补齐缺失 + 升级已装（只升不降：本地更高保留不降级） |
 | `update --installed-only` | 只维护目标目录已安装的家族技能（不补装缺失；无匹配时退出码 0） |
 | `--only <a,b>` / `--domain <name>` | 只处理指定技能 / 家族；与 `--installed-only` 取交集 |
 | `update --check` / `--auto` | 只检查 / 维护已装技能，不补装缺失 |

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

@@ -8,7 +8,7 @@
 | `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.22.1 | memory | 有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT） |
+| `yotta-memory` | 元忆 | `@yottameta/yotta-memory` | 0.22.2 | 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.22.1",
-      "treeHash": "sha256:7ad5ec9cb790bd6f96ecc1977fcc5428fbea9c4d1ebb2b2dd5943e75f2e2a410",
+      "version": "0.22.2",
+      "treeHash": "sha256:7b2cd7a2b5d4eef365dabd6f1d83200458d28ddea1140c362bbea628e832b5f6",
       "files": 18,
-      "bytes": 1302396,
+      "bytes": 1302762,
       "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.29.0"
+VERSION = "0.29.1"
 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.22.1",
+    "version": "0.22.2",
     "domain": "memory",
     "runtimePayload": ["bin"],
     "desc": "有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT）"