@yottameta/yotta-skills 0.23.0 → 0.23.2

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## v0.23.2 (2026-10-01)
+
+- 修复家族安装管线嵌套载荷丢失：复制原语的顶层跳过名单（`package.json` / `bin` / `node_modules` / `.git`）此前按条目名逐层生效，会把技能包内嵌套的同名载荷（如元造 `template/package.json`、`template/bin/install.js`）一并跳过——家族安装 / 更新元造后，其脚手架自检会失败（缺必需文件）。现改为仅顶层生效，与元造 0.1.3 的安装器修复对齐。
+- 新增 `lib/copy-tree.js`（单一复制原语）与回归测试：顶层同名跳过、嵌套同名保留、缓存类（`__pycache__` / `.pytest_cache` / `.mypy_cache` / `*.pyc` / `*.pyo`）任意层级清理；家族管线集成回归同步补齐。
+- 清单同步：`skills.json` / `references/skill-list.md` 更新元造 0.1.4、元案 0.1.1。
+
+## v0.23.1 (2026-10-01)
+
+- 文档：环境变量表补齐 `YOTTA_SKILLS_REGISTRY_FILE` / `YOTTA_SKILLS_USAGE_FILE` / `YOTTA_PROVIDER_HOME` 三项，并新增「隔离环境：三个状态文件成组导出」小节（bash / PowerShell 示例）——测试、CI 与多 agent 场景需三件成组导出，避免读写宿主真实状态。
+- 行为零变更：安装 / 更新 / 路由 / hook / MCP 契约不变。
+
 ## v0.23.0 (2026-10-01)
 
 - O1 动态路由 MVP：`--route` / MCP `route_request` 在静态 playbook 之上，可选调用本地 provider（capability `o1.route`）做确定性组合排序；新增 `confidence` / `reasons` / `summary` / `alternatives` 输出。

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yotta-skills
-version: 0.23.0
+version: 0.23.2
 description: 元阁 -- 元阁全家技能的总编排策划 + 编排路由 + 一键安装器 + 技能盘点 + 运行时 hook 适配。路由层：--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 记忆裁决 / install / update / update --check（只读检查）/ update --check --scheduled（后台周检）/ update --auto（家族自动更新）/ hook 适配 / --inventory / --reindex / --dry-run 预览 / --pin（默认）/ --range。触发：需要批量安装或更新元阁全家技能、按场景组合多个元技能、路由或判断该用哪些技能、判断哪些技能值得长期记忆、查看或记录技能使用信号、盘点或查看本机已装技能、重扫技能注册表、给某个智能体或目录一次性铺齐 yotta-* 技能、评估宿主 hook 能力、预览安装清单、锁版本安装、或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家/检查更新/自动更新/hook 适配/该用哪个技能/路由技能/记忆裁决/技能该不该记住/盘点技能/查看已装技能 等。边界（Do NOT trigger）：只做「组合策划 + 静态路由建议 + M1 记忆裁决只读建议 + 清单 + 下载 + 落位 + 汇总 + 盘点 + re-index + hook 适配」，不含技能本体、不做技能内容开发、不 -g 污染全局、不自动安装缺失技能、不静默写宿主配置或全局记忆、不自动删除技能或记忆；家族安装先自举或调用元信装前门禁，DO NOT INSTALL 阻断，非元阁家族包不自动安装。
 license: MIT
 metadata:
@@ -417,6 +417,29 @@ npx -y @yottameta/yotta-skills usage reset --yes
 | `YOTTA_SKILLS_PYTHON` | 指定 python 可执行文件（元信 scan 用，同 `--python`） |
 | `YOTTA_SKILLS_VERIFY` | 指定 yotta_verify.py 路径（同 `--verify`） |
 | `YOTTA_SKILLS_MANIFEST` | 指定技能清单 JSON 路径（默认随包 skills.json） |
+| `YOTTA_SKILLS_REGISTRY_FILE` | 技能注册表文件路径（多 agent / 隔离环境用；默认 `~/.yottaskills/registry.json`） |
+| `YOTTA_SKILLS_USAGE_FILE` | 使用记录文件路径（`usage` 记录落点；默认 `~/.yottaskills/usage.json`） |
+| `YOTTA_PROVIDER_HOME` | provider 配置根目录（M1 裁决 / O1 动态路由；默认 `~/.yottameta/`，协议见 `references/provider-protocol.md`） |
+
+### 隔离环境：三个状态文件成组导出
+
+测试、CI 与多 agent 共存场景建议把下面三个状态文件变量**成组**导出，避免读写宿主真实状态；
+只导出其中一个时，其余状态仍会落到用户目录（例如漏掉 `YOTTA_SKILLS_USAGE_FILE` 时，
+`usage` 记录仍会写入 `~/.yottaskills/usage.json`）。
+
+```bash
+# bash（Linux / macOS / Git Bash）
+export YOTTA_SKILLS_REGISTRY_FILE="${TMPDIR:-/tmp}/registry.json"
+export YOTTA_SKILLS_USAGE_FILE="${TMPDIR:-/tmp}/usage.json"
+export YOTTA_PROVIDER_HOME="${TMPDIR:-/tmp}/provider"
+```
+
+```powershell
+# PowerShell（Windows）
+$env:YOTTA_SKILLS_REGISTRY_FILE = "$env:TEMP\registry.json"
+$env:YOTTA_SKILLS_USAGE_FILE = "$env:TEMP\usage.json"
+$env:YOTTA_PROVIDER_HOME = "$env:TEMP\provider"
+```
 
 ## 常见问题
 

package/bin/yotta-skills.js

@@ -42,9 +42,10 @@ const m1FeaturesLib = require('../lib/m1-features');
 const routeFeaturesLib = require('../lib/route-features');
 const routeDynamicLib = require('../lib/route-dynamic');
 const { createInstaller, isSafeTarEntry } = require('../lib/install-pipeline');
+const { COPY_SKIP, copyDir } = require('../lib/copy-tree');
 
 const PKG_ROOT = path.join(__dirname, '..');
-let VERSION = '0.23.0';
+let VERSION = '0.23.2';
 try { VERSION = require(path.join(PKG_ROOT, 'package.json')).version; } catch (_) { /* keep fallback */ }
 
 function loadManifest() {
@@ -513,24 +514,7 @@ async function runUpdateAuto(opts, dest) {
   return { code: failed2 > 0 ? autoExitCode : 0 };
 }
 
-function shouldSkip(name, isFile) {
-  if (name === '__pycache__' || name === '.pytest_cache' || name === '.mypy_cache') return true;
-  if (isFile && (name.endsWith('.pyc') || name.endsWith('.pyo'))) return true;
-  return false;
-}
-function copyDir(src, dst, skip) {
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (skip.has(entry.name) || shouldSkip(entry.name, entry.isFile())) continue;
-    const s = path.join(src, entry.name);
-    const d = path.join(dst, entry.name);
-    if (entry.isDirectory()) {
-      fs.mkdirSync(d, { recursive: true });
-      copyDir(s, d, skip);
-    } else if (entry.isFile()) {
-      fs.copyFileSync(s, d);
-    }
-  }
-}
+// 复制原语（顶层跳过口径 / 缓存清理）统一在 lib/copy-tree.js，此处不再保留第二份实现。
 
 function resolveTargetDir(opts) {
   if (opts.dir) return path.resolve(opts.dir);
@@ -659,8 +643,6 @@ function extractTarball(tarball, extractDir) {
   return { pkgDir };
 }
 
-const COPY_SKIP = new Set(['package.json', 'bin', 'node_modules', '.git', '__pycache__']);
-
 function ensureGate(context) {
   const { skill, extracted, dest, opts } = context;
   const current = findVerifyEngine(dest, opts);
@@ -716,7 +698,7 @@ function ensureGate(context) {
 const installOne = createInstaller({
   runNpmPack,
   extractTarball,
-  copyDir: (src, dst) => copyDir(src, dst, COPY_SKIP),
+  copyDir: (src, dst) => copyDir(src, dst, COPY_SKIP, true),
   readInstalledVersion,
   ensureGate,
   scanTarget,

package/lib/copy-tree.js

@@ -0,0 +1,38 @@
+'use strict';
+
+/**
+ * 安装落位的复制原语（单一真源）。
+ *
+ * 口径（2026-10-01，与元造 0.1.3 的安装器修复对齐）：
+ * - 顶层开发文件 / 目录（package.json / bin / node_modules / .git）只在**安装包顶层**跳过；
+ *   技能包内嵌套的同名载荷（如 template/package.json、template/bin/install.js）必须保留。
+ * - 缓存 / 编译产物（__pycache__ / .pytest_cache / .mypy_cache / *.pyc / *.pyo）任意层级都跳过。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const COPY_SKIP = new Set(['package.json', 'bin', 'node_modules', '.git']);
+
+function shouldSkipCache(name, isFile) {
+  if (name === '__pycache__' || name === '.pytest_cache' || name === '.mypy_cache') return true;
+  if (isFile && (name.endsWith('.pyc') || name.endsWith('.pyo'))) return true;
+  return false;
+}
+
+function copyDir(src, dst, skip, topLevel) {
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (topLevel && skip.has(entry.name)) continue;
+    if (shouldSkipCache(entry.name, entry.isFile())) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      fs.mkdirSync(d, { recursive: true });
+      copyDir(s, d, skip, false);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+module.exports = { COPY_SKIP, shouldSkipCache, copyDir };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-skills",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
   "license": "MIT",
   "keywords": [

package/references/skill-list.md

@@ -18,7 +18,7 @@
 | `yotta-logs` | 元史 | `@yottameta/yotta-logs` | 0.3.2 | 跨智能体历史会话 / 记忆日志检索 |
 | `yotta-security-testing` | 元测 | `@yottameta/yotta-security-testing` | 0.3.1 | 有纪律的 AI 安全测试方法论 + Scope Guard 五道防线 |
 | `yotta-agent-hardening` | 元安全 | `@yottameta/yotta-agent-hardening` | 0.2.6 | 防御向 AI 智能体自身安全加固（配置面静态扫描三域） |
-| `yotta-skill-creator` | 元造 | `@yottameta/yotta-skill-creator` | 0.1.3 | 工坊「造」：端到端造技能脚手架 |
+| `yotta-skill-creator` | 元造 | `@yottameta/yotta-skill-creator` | 0.1.4 | 工坊「造」：端到端造技能脚手架 |
 | `yotta-publish-guard` | 元守 | `@yottameta/yotta-publish-guard` | 0.4.2 | 工坊「守」：发布前守门（版本四件对齐 + 三通道查重） |
 | `yotta-logwatch` | 元察 | `@yottameta/yotta-logwatch` | 0.3.0 | 安全日志分析检测引擎（攻击链识别/告警聚合） |
 | `yotta-intel` | 元情 | `@yottameta/yotta-intel` | 0.2.1 | 威胁情报 IOC 提取与规范化引擎（STIX-lite） |
@@ -29,7 +29,7 @@
 | `yotta-verify` | 元信 | `@yottameta/yotta-verify` | 0.3.3 | 装前安全扫描器 + audited 徽章（prompt injection + 危险模式） |
 | `yotta-compliance` | 元规 | `@yottameta/yotta-compliance` | 0.1.0 | 本地确定性合规条款审查（PIPL + 数据出境规则包 / 证据锚点 / 框架覆盖分级） |
 | `yotta-mirror` | 元镜 | `@yottameta/yotta-mirror` | 0.1.0 | 本地确定性学情分析（知识点掌握率 / 分层与临界生 / 薄弱点诊断，学生数据不出本机） |
-| `yotta-lesson` | 元案 | `@yottameta/yotta-lesson` | 0.1.0 | 本地确定性教案骨架与覆盖校验（课标映射 / 环节时间精确分配 / 缺口检查） |
+| `yotta-lesson` | 元案 | `@yottameta/yotta-lesson` | 0.1.1 | 本地确定性教案骨架与覆盖校验（课标映射 / 环节时间精确分配 / 缺口检查） |
 | `yotta-item` | 元题 | `@yottameta/yotta-item` | 0.1.0 | 本地确定性组卷与试卷校验（双向细目表 / 题库选题 / 缺口检查） |
 | `yotta-school-doc` | 元公 | `@yottameta/yotta-school-doc` | 0.1.2 | 本地确定性学校公文可信起草与校验（文种规则包 / 可复算骨架 / 12 类缺口） |
 

package/scripts/yotta-skills-mcp.py

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

package/skill-manifest.json

@@ -3,7 +3,7 @@
   "slug": "yotta-skills",
   "name": "元阁",
   "package": "@yottameta/yotta-skills",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "trust": "yottameta",
   "install": {
     "idempotent": true

package/skills.json

@@ -1,6 +1,6 @@
 {
   "manifestVersion": 1,
-  "updated": "2026-09-30",
+  "updated": "2026-10-01",
   "note": "清单同步要求：每次技能发布新版本后，按 YottaSkills 技能登记表更新本文件（登记表为内部台账，不随包分发）。",
   "skills": [
     {
@@ -98,7 +98,7 @@
       "slug": "yotta-skill-creator",
       "name": "元造",
       "pkg": "@yottameta/yotta-skill-creator",
-      "version": "0.1.3",
+      "version": "0.1.4",
       "desc": "工坊「造」：端到端造技能脚手架"
     },
     {
@@ -175,7 +175,7 @@
       "slug": "yotta-lesson",
       "name": "元案",
       "pkg": "@yottameta/yotta-lesson",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "desc": "本地确定性教案骨架与覆盖校验（课标映射 / 环节时间精确分配 / 缺口检查）"
     },
     {