@yottameta/yotta-skills-plugin 0.7.2 → 0.19.0

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

@@ -4,7 +4,7 @@
 
 - **安装目标**：未指定目标怎么办 · 支持哪些智能体 · 装完为什么看不到
 - **网络与源**：国内访问慢 · 镜像延迟 · 网络失败
-- **更新**：`update --check` 退出码 · 自动更新边界 · 幂等
+- **更新**：`update --check` 退出码 · 后台周检缓存 · 自动更新边界 · 幂等
 - **版本**：`--pin` 与默认策略 · 清单漂移 · 单技能安装
 - **安全**：装前扫描 · 目标目录校验 · 失败恢复
 
@@ -43,6 +43,13 @@ YOTTA_SKILLS_NPM_FLAGS="--registry=https://registry.npmmirror.com" npx -y @yotta
 
 该命令只读，不修改文件。
 
+## 4.1 `update --check --scheduled` 什么时候用？
+
+它是后台周检入口：默认 7 天加 0 到 24 小时随机抖动，未到期不联网；到期只检查一次，
+结果写入 `~/.yottaskills/update-check.json`。文本模式网络失败静默并退出 0，
+`--json` 可读取 `error` / `cache` 诊断字段。会话开工只建议做本地 `--reindex`，
+不默认联网更新检查。
+
 ## 5. `update --auto` 会更新所有技能吗？
 
 只自动更新元阁家族内技能（`yotta-*` 且在清单中）。其他已装技能只提示，不自动改动。
@@ -69,11 +76,23 @@ npx -y @yottameta/yotta-skills install yotta-memory yotta-workflow --agent codex
 
 ## 10. 安装前安全扫描怎么用？
 
-默认会查找可用的元信引擎并输出摘要；可用 `--verify <path>` 指定引擎，或 `--skip-scan` 关闭。扫描结果仅提示，不替代人工判断。
+家族安装默认执行元信门禁：没有元信时先自动自举，再扫描待装包。`DO NOT INSTALL`
+和扫描失败会阻断；`INSTALL WITH CAUTION` / `REVIEW REQUIRED` 会继续但显示风险。
+可用 `--verify <path>` 指定引擎。`--skip-scan` 只是人工应急路径，会标记
+`explicit-unverified`，`update --auto` 不使用它。
 
 ## 11. 安装失败后如何恢复？
 
-查看汇总中的失败原因，先修复目录权限或网络，再单独安装失败技能：
+查看汇总中的失败原因。setup / doctor 失败时元阁会自动恢复旧版本；旧版本快照仍保存在
+`~/.yottaskills/snapshots/`。可以先用 `doctor` 自检，再用 `rollback` 恢复最近快照：
+
+```bash
+npx -y @yottameta/yotta-skills doctor --dir /path/to/skills --slug <slug>
+npx -y @yottameta/yotta-skills rollback --list --dir /path/to/skills
+npx -y @yottameta/yotta-skills rollback --slug <slug> --dir /path/to/skills
+```
+
+如果只是安装源或网络问题，再单独安装失败技能：
 
 ```bash
 npx -y @yottameta/yotta-skills install <slug> --dir /path/to/skills
@@ -82,3 +101,7 @@ npx -y @yottameta/yotta-skills install <slug> --dir /path/to/skills
 ## 12. 装完为什么智能体里看不到？
 
 确认安装目录与智能体实际读取目录一致；安装后通常需要重启会话或重新加载技能列表。
+
+## 13. `hook evaluate` 会真的拦截动作吗？
+
+不一定。适配层先探测宿主能力：`native-block` 才能声明动作前阻断；`native-audit` 只能审计并触发一次纠偏，结果会标记 `explicit-unverified`；`wrapper-only` 仅在 wrapper 注册后保证；未知宿主全部按 `unsupported` 处理。当前 Codex 已实测能力见 `hook capabilities --host codex`。

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

@@ -10,10 +10,13 @@
 1. 读清单（`skills.json`，默认随包；`YOTTA_SKILLS_MANIFEST` 可覆盖）；
 2. `npm pack <pkg>@<spec> --pack-destination <临时目录>`；
 3. 系统 `tar -xzf` 解压到临时目录（产物应有 `SKILL.md`）；
-4. 元信装前摘要（若引擎可用；`--skip-scan` 关闭）；
-5. 删除目标 `<dest>/<slug>` 后重新复制（跳过规则见下）；
-6. 汇总报告：✔ 成功 / - 跳过（已是最新）/ ✘ 失败；有失败项时退出码 1。
-7. 全部完成后自动 re-index 本地技能注册表（`~/.yottaskills/registry.json`）：重扫技能根目录并增量合并，
+4. 读取包内 `skill-manifest.json`；没有 manifest 时使用 `skills.json` 的家族默认契约；
+5. 校验 slug / package / version / 权限 / 生命周期脚本路径；
+6. 元信装前扫描：已有元信则直接扫描；没有则自动安装元信自身，再扫描；
+7. 通过后创建旧版本快照，把新版本复制到同盘暂存目录，再原子切换到目标目录；
+8. 依次执行包内 setup、内置 doctor、包内自定义 doctor；任一步失败自动恢复旧版本；
+9. 汇总报告：✔ 成功 / - 跳过（已是最新）/ ✘ 失败；
+10. 全部成功后自动 re-index 本地技能注册表（`~/.yottaskills/registry.json`）：重扫技能根目录并增量合并，
    新装 / 更新的技能随即进入注册表（`--no-reindex` 可关闭；`--dry-run` 不触发）。
 
 ## 复制跳过规则
@@ -24,6 +27,27 @@
 因此装进技能目录的是「技能本体」（SKILL.md / references / scripts 等），不含 npm
 安装器自身、测试夹具与 Python 字节码缓存。
 
+## manifest 与家族默认契约
+
+每个技能包可以自带根目录 `skill-manifest.json`。有 manifest 时：
+
+- 校验 `slug` / `package` / `version` 与包目录、`package.json`、`SKILL.md` 一致；
+- 校验 `install.idempotent` 为 `true`；
+- 校验 setup / doctor / rollback 路径为包内相对路径，不能包含绝对路径或 `..`。
+
+没有 manifest 时使用家族默认契约：来源 `yottameta`、幂等安装、自动应用模式 `route`，
+不声明 MCP、hook 或自定义生命周期脚本。
+
+## 自定义生命周期脚本
+
+包内 `skill-manifest.json` 可声明 `install.setup` / `install.doctor` /
+`install.rollback`，值必须是包内相对路径，不能是绝对路径或包含 `..`。
+
+元阁用当前 Node.js 直接执行脚本，不经过 shell。脚本接收 `--skill-dir` /
+`--package-dir` / `--dest`，rollback 另接收 `--snapshot`，并始终追加 `--json`；
+脚本必须输出一个 JSON 对象，至少包含 `ok`。setup 或 doctor 失败时，先恢复旧版本，
+再在声明了 rollback 时调用它。生命周期结果、回滚结果和快照路径都会写入安装证据。
+
 ## re-index（装技能后自动重扫注册表）
 
 - `install` / `update` 完成后，CLI 自动调用 `--reindex`（同一套 `lib/skills-scan.js` 扫描核心）：
@@ -51,14 +75,76 @@
   其它 → 直接执行；
 - `YOTTA_SKILLS_NPM_FLAGS` 追加到 `npm pack` 参数。
 
-## 元信装前摘要
+## 元信装前门禁
 
 - 引擎查找：`--verify` → `YOTTA_SKILLS_VERIFY` → `<dest>/yotta-verify/scripts/yotta_verify.py`；
 - python 查找：`--python` → `YOTTA_SKILLS_PYTHON` → `python3` / `python` / `py`（win32）；
 - 执行：`python -B <engine> scan <解压目录> --json`（`-B` 禁止写 `__pycache__`，防止污染
   引擎所在目录）；
-- 输出 verdict + counts（critical / high / medium / low / info）；DO NOT INSTALL 额外提示
-  人工复核；仅摘要、不拦截。
+- 元信缺失时：先按 `skills.json` 安装 `yotta-verify`，并记录 `gate_mode=trusted-bootstrap`
+  与 `bootstrap_scan=self`，随后用元信扫描其余家族包；
+- verdict 处置：`SAFE TO INSTALL` 继续；`INSTALL WITH CAUTION` / `REVIEW REQUIRED`
+  继续但显示风险并留证；`DO NOT INSTALL` 和扫描失败阻断，不替换目标；
+- `--skip-scan` 只保留为人工应急路径，使用时输出 `explicit-unverified` 并写入证据；
+- `update --auto` 始终执行装前门禁，不接受 `--skip-scan`。
+
+## 更新检查缓存
+
+- 手动 `update --check`：每次联网，只读，保持退出码 0 / 3 / 1。
+- 后台周检 `update --check --scheduled`：默认 7 天加 0 到 24 小时随机抖动；未到期直接返回，
+  到期只检查一次；文本失败静默，`--json` 保留诊断。
+- 缓存文件：`~/.yottaskills/update-check.json`；按目标技能目录隔离记录，
+  字段包含 `last_checked`、`next_check`、`last_result`、`last_error`。
+- 本缓存只记录版本检查结果与网络错误，不记录技能内容或用户数据。
+
+## 运行时 hook 适配
+
+- `hook capabilities --host <name>`：查看六个统一事件的四档宿主能力；未知宿主默认 `unsupported`。
+- `hook evaluate --host <name> --event <event> --manifest <file> --context <json>`：按 manifest 顺序评估声明，输出 `allow` / `block` / `warn` / `unverified`。
+- `hook bind --manifest <file>` / `hook unbind <id>`：幂等注册或反注册声明，不直接改写宿主配置。
+- 评估证据写入 `~/.yottaskills/hook-log.jsonl`，绑定记录写入 `~/.yottaskills/hook-bindings.json`。
+- `native-audit` 不等于强制；缺少能力或证据时必须显示 `explicit-unverified`。
+
+## 快照与回滚
+
+- 旧版本快照：`~/.yottaskills/snapshots/<slug>/<timestamp>-<version>-<随机后缀>/`；
+- 新快照同时写入 `<快照目录>.meta.json`，包含 SHA-256 摘要、版本、文件数和来源；
+- 无元数据的旧快照仍可按 `SKILL.md` 做结构校验；
+- 新版本先落在 `<dest>/.yottaskills-staging/<slug>-<随机后缀>/`；
+- 旧目标先重命名为同盘备份，再把暂存目录切到目标；切换失败时恢复备份；
+- 证据写入失败会触发回滚，不把安装标记为成功；
+- Windows 上对 `EPERM` / `EACCES` / `EBUSY` 做短重试，避免杀毒或索引服务造成的瞬时锁。
+
+回滚命令：
+
+```bash
+yotta-skills rollback --list --dir <skills-dir>
+yotta-skills rollback --slug <slug> --dir <skills-dir>
+```
+
+恢复前校验快照摘要；恢复时先在目标目录同盘暂存，再替换当前目录。恢复成功后执行
+内置 doctor 和自定义 doctor，并保留原快照供再次恢复。
+
+## doctor
+
+```bash
+yotta-skills doctor --dir <skills-dir> --slug <slug>
+yotta-skills doctor --dir <skills-dir> --json
+```
+
+doctor 只读检查目录、`SKILL.md`、版本、manifest 身份、注册表记录和自定义 doctor，
+不会修改目标目录或注册表。注册表版本不一致属于 warning，可用 `--reindex` 修复。
+
+## 安装证据
+
+每次安装决策写入：
+
+```text
+~/.yottaskills/install-log.jsonl
+```
+
+记录包含时间、事件、技能、包名、版本、`gate_mode`、verdict、decision
+和快照路径；不记录技能内容或用户数据，只写本机。
 
 ## 退出码
 
@@ -68,6 +154,8 @@
 | 1 | 安装 / 更新存在失败项 |
 | 2 | 用法错误（未知参数 / 未知技能 / 未收录智能体） |
 | 4 | 未指定目标且当前目录未检测到项目级技能目录 |
+| 5 | 装前 gate 阻断或元信不可用 |
+| 6 | manifest / 身份校验失败 |
 
 ## 目标目录解析
 

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

@@ -7,26 +7,26 @@
 |---|---|---|---|---|
 | `yotta-anti-shallow` | 元谨 | `@yottameta/yotta-anti-shallow` | 1.4.0 | 防 AI 敷衍规则引擎（深入分析/根因追溯时激活） |
 | `yotta-code-quality` | 元质 | `@yottameta/yotta-code-quality` | 0.4.0 | 结对式代码质量评审（十二类腐化风险 + 0-100 健康分） |
-| `yotta-workflow` | 元序 | `@yottameta/yotta-workflow` | 0.4.0 | 跨会话/跨项目通用工作流协议（状态就近存） |
-| `yotta-memory` | 元忆 | `@yottameta/yotta-memory` | 0.11.0 | 有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT） |
+| `yotta-workflow` | 元序 | `@yottameta/yotta-workflow` | 0.4.1 | 跨会话/跨项目通用工作流协议（状态就近存） |
+| `yotta-memory` | 元忆 | `@yottameta/yotta-memory` | 0.13.0 | 有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT） |
 | `yotta-learn` | 元习 | `@yottameta/yotta-learn` | 0.2.0 | 学习沉淀 CLI：错误/纠正/洞见沉淀为 .learnings/ 条目 |
-| `yotta-security-audit` | 元安 | `@yottameta/yotta-security-audit` | 0.2.2 | 安全扫描引擎：13 类检测器 + 系统安全基线 |
+| `yotta-security-audit` | 元安 | `@yottameta/yotta-security-audit` | 0.2.3 | 安全扫描引擎：13 类检测器 + 系统安全基线 |
 | `yotta-vetter` | 元审 | `@yottameta/yotta-vetter` | 0.2.3 | 安全审查协议：四阶段 review + SAFE TO INSTALL 判定 |
-| `yotta-recon` | 元析 | `@yottameta/yotta-recon` | 0.1.5 | 跨智能体网络侦察：零依赖端口/服务/版本指纹探测 |
-| `yotta-guardian` | 元盾 | `@yottameta/yotta-guardian` | 0.1.2 | 跨智能体危险调用拦截护栏：确定性规则 + 可插拔意图验证 |
+| `yotta-recon` | 元析 | `@yottameta/yotta-recon` | 0.1.6 | 跨智能体网络侦察：零依赖端口/服务/版本指纹探测 |
+| `yotta-guardian` | 元盾 | `@yottameta/yotta-guardian` | 0.1.3 | 跨智能体危险调用拦截护栏：确定性规则 + 可插拔意图验证 |
 | `yotta-humanize` | 元真 | `@yottameta/yotta-humanize` | 0.2.0 | 去 AI 味中文写作编辑：检测器引擎 |
 | `yotta-logs` | 元史 | `@yottameta/yotta-logs` | 0.3.0 | 跨智能体历史会话 / 记忆日志检索 |
 | `yotta-security-testing` | 元测 | `@yottameta/yotta-security-testing` | 0.3.0 | 有纪律的 AI 安全测试方法论 + Scope Guard 五道防线 |
 | `yotta-agent-hardening` | 元安全 | `@yottameta/yotta-agent-hardening` | 0.2.4 | 防御向 AI 智能体自身安全加固（配置面静态扫描三域） |
-| `yotta-skill-creator` | 元造 | `@yottameta/yotta-skill-creator` | 0.1.0 | 工坊「造」：端到端造技能脚手架 |
-| `yotta-publish-guard` | 元守 | `@yottameta/yotta-publish-guard` | 0.3.0 | 工坊「守」：发布前守门（版本四件对齐 + 三通道查重） |
-| `yotta-logwatch` | 元察 | `@yottameta/yotta-logwatch` | 0.2.7 | 安全日志分析检测引擎（攻击链识别/告警聚合） |
+| `yotta-skill-creator` | 元造 | `@yottameta/yotta-skill-creator` | 0.1.1 | 工坊「造」：端到端造技能脚手架 |
+| `yotta-publish-guard` | 元守 | `@yottameta/yotta-publish-guard` | 0.4.1 | 工坊「守」：发布前守门（版本四件对齐 + 三通道查重） |
+| `yotta-logwatch` | 元察 | `@yottameta/yotta-logwatch` | 0.2.8 | 安全日志分析检测引擎（攻击链识别/告警聚合） |
 | `yotta-intel` | 元情 | `@yottameta/yotta-intel` | 0.2.0 | 威胁情报 IOC 提取与规范化引擎（STIX-lite） |
 | `yotta-secret` | 元钥 | `@yottameta/yotta-secret` | 0.2.0 | 密钥 / 凭据泄露源头扫描引擎 |
 | `yotta-chain` | 元链 | `@yottameta/yotta-chain` | 0.1.2 | 供应链依赖校验引擎 |
-| `yotta-triage` | 元鉴 | `@yottameta/yotta-triage` | 0.1.1 | 恶意样本静态初筛引擎（哈希/熵/字符串/PE-ELF） |
+| `yotta-triage` | 元鉴 | `@yottameta/yotta-triage` | 0.1.2 | 恶意样本静态初筛引擎（哈希/熵/字符串/PE-ELF） |
 | `yotta-prompt` | 元引 | `@yottameta/yotta-prompt` | 0.2.0 | 意图澄清 + 生态入口（常驻注入，map 串联元阁全家） |
-| `yotta-verify` | 元信 | `@yottameta/yotta-verify` | 0.2.2 | 装前安全扫描器 + audited 徽章（prompt injection + 危险模式） |
+| `yotta-verify` | 元信 | `@yottameta/yotta-verify` | 0.3.0 | 装前安全扫描器 + audited 徽章（prompt injection + 危险模式） |
 
 ## 家族分布
 

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

@@ -8,7 +8,7 @@
 
 - 学会 `--list` / `install` / `update` / `--dry-run` / `--pin` / `--force` 的用法；
 - 理解版本策略（range 与 --pin）与幂等行为；
-- 掌握元信装前摘要的开关与配置；
+- 了解元信装前门禁、元信自举与 `--skip-scan` 的人工应急边界；
 - 前置：Node.js 18+、npm、系统 tar（Windows 10+ 自带）；网络可访问 npm 注册表
   （国内可配置镜像或代理）。
 
@@ -76,22 +76,35 @@ dry-run 只打印将要执行的清单（含目标与版本策略），不联网
 npx -y @yottameta/yotta-skills install --agent codex --pin
 ```
 
-## 8. 强制重装与跳过元信摘要
+## 8. 强制重装与元信门禁
 
 ```bash
 npx -y @yottameta/yotta-skills install --agent codex --force     # 已是最新也重装
-npx -y @yottameta/yotta-skills install --agent codex --skip-scan # 跳过装前摘要
+npx -y @yottameta/yotta-skills install --agent codex --skip-scan # 人工应急：显式未验证
 ```
 
-元信（yotta-verify）已安装时默认会对每个待装技能输出装前摘要（verdict + 计数），仅提示
-不拦截；verdict 为 DO NOT INSTALL 时会提示人工复核。
+家族安装默认执行元信门禁：没有元信时，元阁先按可信源安装元信自身，再扫描待装技能。
+`DO NOT INSTALL` 会阻断安装；`INSTALL WITH CAUTION` / `REVIEW REQUIRED` 会继续但显示风险。
+旧版本会先快照到 `~/.yottaskills/snapshots/`，安装决策写入
+`~/.yottaskills/install-log.jsonl`。`--skip-scan` 只用于人工应急，会输出
+`explicit-unverified` 并留证，`update --auto` 不会使用它。
+
+安装阶段还会按包内 manifest 执行 setup / doctor；setup 或 doctor 失败时自动恢复旧版本。
+可以用 `doctor` 只读自检，用 `rollback` 校验并恢复最近快照：
+
+```bash
+npx -y @yottameta/yotta-skills doctor --agent codex --slug yotta-memory
+npx -y @yottameta/yotta-skills rollback --list --agent codex
+npx -y @yottameta/yotta-skills rollback --slug yotta-memory --agent codex
+```
 
 ## 9. 验证安装结果
 
 - 看安装汇总：成功 N / 跳过 N / 失败 N；
 - 抽查技能目录：`ls ~/.codex/skills/yotta-memory/SKILL.md`；
 - 复核版本：每个技能 SKILL.md 的 frontmatter `version` 应与 `--list` 一致（这也是幂等
-  判断的依据）。
+  判断的依据）；
+- 需要安全复核时，查看 `~/.yottaskills/install-log.jsonl` 中的 verdict 与 `gate_mode`。
 
 ## 10. 常见问题
 
@@ -104,6 +117,11 @@ npx -y @yottameta/yotta-skills install --agent codex --skip-scan # 跳过装前
 - **目标未指定**：当前目录没有项目级技能目录时报错（退出码 4），加 `--agent` 或
   `--dir`。
 - **已有旧版本**：默认按 range 覆盖升级到最新 patch；`--pin` 则锁定清单版本。
+- **doctor 报注册表版本不一致**：运行 `yotta-skills --reindex` 重扫注册表；doctor 本身不会写文件。
+- **需要撤销最近安装 / 更新**：先用 `rollback --list` 查看快照，再执行
+  `rollback --slug <slug>`；恢复前会自动校验快照。
+- **后台更新检查没有输出**：`update --check --scheduled` 在未到期、已最新或网络失败时
+  文本模式保持静默；需要诊断时加 `--json`。
 
 ## 11. 盘点已装技能与 re-index（新装技能自动被发现）
 
@@ -118,6 +136,9 @@ npx -y @yottameta/yotta-skills --reindex
 - `install` / `update` 完成后会自动重扫注册表（`~/.yottaskills/registry.json`），新装 / 更新的
   技能随即出现在 `--inventory` / `--reindex` 里；`--no-reindex` 可关闭自动重扫。
 - 建议每会话开工先跑一次 `--reindex`（快速增量，只合并变化），让后装的技能自动被看见。
+- 更新检查不再作为会话开工默认动作：手动检查用 `update --check`；后台周检用
+  `update --check --scheduled`，未到期不联网，到期只检查一次并写
+  `~/.yottaskills/update-check.json`。
 
 ## 编排路由（--route）
 
@@ -130,3 +151,16 @@ npx -y @yottameta/yotta-skills --route "检查代码质量，别糊弄"
 输出会告诉你命中哪个组合、按什么顺序调用、每个技能负责什么、哪些已装、哪些缺失，以及缺失技能的安装命令。元阁只给建议，不会自动安装；安装前请先做装前安全扫描，并由用户确认。
 - `--json` 输出机器可读结果（含新增 / 更新 / 消失），适合脚本与钩子。
 - 如果本机还装了非元阁家族技能，`--route` 会额外列出「其他已装技能候选」：只按 frontmatter description 与需求文本做本地机械匹配，标注来源、得分、命中词项与扫描状态（默认未扫描），不读取全文指令、不自动调用；使用/安装前请先做装前安全扫描。
+
+## 运行时 hook 适配（hook）
+
+技能 manifest 只声明六个统一事件的要求；元阁负责能力探测、确定性评估、证据留痕和降级标注：
+
+```bash
+npx -y @yottameta/yotta-skills hook capabilities --host codex --json
+npx -y @yottameta/yotta-skills hook evaluate --host codex --event before_send --manifest ./skill-manifest.json --context '{"checks":{}}' --json
+npx -y @yottameta/yotta-skills hook bind --host codex --manifest ./skill-manifest.json
+```
+
+`native-block` 才会显示动作前阻断；`native-audit` 只能审计并触发一次纠偏，结果标
+`explicit-unverified`；未知宿主全部按 `unsupported` 处理。本层不联网、不下载、不改宿主配置文件。

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

@@ -30,15 +30,23 @@ npx -y @yottameta/yotta-skills --agent codex
 npx -y @yottameta/yotta-skills update --check --agent codex
 ```
 
-2. 根据输出确认可更新清单。
+2. 如果由后台调度执行，改用周检入口：
 
-3. 执行增量更新：
+```bash
+npx -y @yottameta/yotta-skills update --check --scheduled --agent codex
+```
+
+未到期时不联网；到期只检查一次并把结果写入 `~/.yottaskills/update-check.json`。
+
+3. 根据输出确认可更新清单。
+
+4. 执行增量更新：
 
 ```bash
 npx -y @yottameta/yotta-skills update --agent codex
 ```
 
-4. 复核：已最新的技能应显示跳过，落后的技能显示更新；失败项单独重装。
+5. 复核：已最新的技能应显示跳过，落后的技能显示更新；失败项单独重装。
 
 ## 走查 3：按路由安装单个技能
 

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

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