@yottameta/yotta-skills-plugin 0.28.2 → 0.28.3

package/skills/yotta-skills/lib/cli-help.js

@@ -0,0 +1,313 @@
+'use strict';
+
+/**
+ * yotta-skills（元阁）CLI 帮助单一真源。
+ *
+ * - CLI_HELP_MODEL：分组 → 命令 → usage / what / when / options（引用全局选项）
+ * - CLI_HELP_QUICK：全量速查（每个命令与子命令至少一条：示例 + 危险标记 + 注意）
+ * - CLI_GLOBAL_OPTIONS：全局选项明细（--help 选项区 / 面板完整参数 / 官网导出）
+ *
+ * 面板 /api/help、CLI --help、官网结构化导出都从这里取；新增命令必须同步本文件，
+ * 否则 test/cli-help-coverage.test.js 会 FAIL（防漂移）。
+ */
+
+const CLI_GLOBAL_OPTIONS = [
+  { flag: '--agent', arg: '<name>', what: '指定智能体（用它的默认用户级技能目录）', when: '给某个智能体装 / 链接 / 解除时', caution: '未收录的智能体请改用 --dir' },
+  { flag: '--dir', arg: '<path>', what: '指定技能目录（技能落到 <path>/<slug>）', when: '给任意宿主或自定义目录安装 / 分发时', caution: '' },
+  { flag: '--pin', arg: '', what: '锁死清单精确版本（默认）', when: '需要可复现安装时（默认行为）', caution: '' },
+  { flag: '--range', arg: '', what: '跟随同 major 最新 patch（非默认：显式指定后才浮动跟随）', when: '想主动跟随 patch 更新时', caution: '浮动版本每次安装结果可能不同' },
+  { flag: '--force', arg: '', what: '已是最新也重装；hub link 时替换同名真目录 / 外部链接', when: '确认要覆盖现有内容时', caution: '可能替换目标目录；先确认目标与备份' },
+  { flag: '--skip-scan', arg: '', what: '跳过元信装前扫描（装了元信时自动启用）', when: '已确认来源可信、需要离线安装时', caution: '跳过后风险自负；安装记录会标记 explicit-unverified' },
+  { flag: '--only', arg: '<a,b>', what: 'install / update 只处理指定技能', when: '只维护几个技能时', caution: '' },
+  { flag: '--domain', arg: '<name>', what: 'install / update 只处理指定家族', when: '按领域批量维护时', caution: '可用值见 --list 的家族列' },
+  { flag: '--installed-only', arg: '', what: 'update 只维护目标目录已安装的技能（不补装缺失）', when: '接管现有技能、不想新增时', caution: '无匹配时退出码 0（无动作）' },
+  { flag: '--npm', arg: '<path>', what: '指定 npm 可执行文件', when: 'npm 不在 PATH 或需要指定版本时', caution: '' },
+  { flag: '--python', arg: '<path>', what: '指定 python 可执行文件（元信扫描用）', when: 'Python 不在 PATH 时', caution: '' },
+  { flag: '--verify', arg: '<path>', what: '指定 yotta_verify.py 路径', when: '使用自带的元信引擎时', caution: '' },
+  { flag: '--json', arg: '', what: '输出 JSON（inventory / reindex / route / doctor / rollback / hub 等）', when: '脚本或自动化读取结果时', caution: '' },
+  { flag: '--slug', arg: '<slug>', what: 'doctor / rollback 只处理指定技能', when: '只检查 / 回滚一个技能时', caution: '' },
+  { flag: '--route', arg: '<需求>', what: '静态编排路由：组合 / 顺序 / 依据 / 缺失技能建议', when: '想知道该用哪些技能时', caution: '只建议不自动安装' },
+  { flag: '--check', arg: '', what: 'update 时只读检查更新（对 npm 最新版本，不改动）', when: '定期检查或发布前核对时', caution: '退出码 0=最新 / 3=有更新 / 1=检查失败' },
+  { flag: '--scheduled', arg: '', what: '与 update --check 合用：后台周检（未到期不联网）', when: '挂后台定时检查时', caution: '只与 update --check 一起使用' },
+  { flag: '--auto', arg: '', what: 'update 检查到家族更新后自动更新（仅 yotta-* 家族）', when: '想自动跟进家族更新时', caution: '自动更新含装前扫描；不会自动安装缺失技能' },
+  { flag: '--registry', arg: '<url>', what: 'npm registry 地址（默认官方源）', when: '需要走镜像或私有源时', caution: '' },
+  { flag: '--host', arg: '<name>', what: 'hook 适配宿主名（默认 generic）', when: '评估 / 绑定宿主 hook 时', caution: '当前已实测 codex' },
+  { flag: '--event', arg: '<event>', what: 'hook 六事件之一', when: 'evaluate / 排查 hook 时', caution: '六事件：before_start / before_tool / before_install / before_publish / after_milestone / before_send' },
+  { flag: '--manifest', arg: '<file>', what: 'hook evaluate / bind 使用的 skill-manifest.json', when: '按技能声明评估 hook 时', caution: '' },
+  { flag: '--context', arg: '<json>', what: 'hook evaluate 的检查结果 JSON', when: '外部传入 checks / wrapperRegistered / evidence 时', caution: '' },
+  { flag: '--skill', arg: '<slug>', what: 'usage mark 的技能 slug', when: '记录技能使用信号时', caution: '' },
+  { flag: '--signal', arg: '<name>', what: 'usage mark 的信号：used / named / accepted', when: '记录技能使用信号时', caution: '' },
+  { flag: '--yes', arg: '', what: 'usage reset 的确认开关', when: '确认清空本地使用记录时', caution: '会清空记录文件' },
+  { flag: '--explain', arg: '', what: 'decide-memory 文本报告追加信号明细', when: '想看裁决依据时', caution: '' },
+  { flag: '--promote', arg: '', what: 'decide-memory 只写本地建议文件（不写元忆）', when: '想留下裁决建议文件时', caution: '不会写元忆、不会删除任何内容' },
+  { flag: '--hub', arg: '<path>', what: 'Hub 目录（默认 ~/.yottaskills/hub）', when: '使用自定义 Hub 位置时', caution: 'YOTTA_SKILLS_HUB 环境变量同样可覆盖' },
+  { flag: '--port', arg: '<n>', what: 'view 面板端口（默认 8789）', when: '端口冲突或想固定端口时', caution: '仅 127.0.0.1 监听' },
+  { flag: '--all', arg: '', what: 'hub link / unlink 作用于全部已核实宿主', when: '全量分发或解除时', caution: '' },
+  { flag: '--include-discovered', arg: '', what: 'hub link / unlink / remove 时纳入自动发现目录', when: '确认要扩围到未核实目录时', caution: '默认只链已核实宿主；桥接目录永不链接' },
+  { flag: '--scan', arg: '', what: 'hub adopt 只读预演（默认行为）', when: '先看收编候选与冲突时', caution: '' },
+  { flag: '--apply', arg: '', what: 'hub adopt 执行收编', when: '确认候选后执行时', caution: '执行时逐项运行元信扫描；high / critical 默认阻断' },
+  { flag: '--in-place', arg: '', what: 'hub adopt 原地登记，不复制', when: '想让 Hub 直接指向原目录时', caution: '原目录删除即断链；默认复制保真更安全' },
+  { flag: '--allow-unverified', arg: '', what: '显式允许未扫描导入（默认 high / critical 阻断）', when: '已人工确认来源可信时', caution: '会放宽装前扫描门禁，谨慎使用' },
+  { flag: '--from', arg: '<path>', what: 'hub refresh 的来源目录', when: '手动同步非元阁技能时', caution: '无统一更新源，需显式指定来源' },
+  { flag: '--include', arg: '<a,b>', what: 'hub adopt --apply 只收编指定技能', when: '从候选中挑几个收编时', caution: '' },
+  { flag: '--project', arg: '', what: 'inventory / reindex 附加扫描当前项目 .agents/skills / .codex/skills', when: '盘点项目级技能时', caution: '' },
+  { flag: '--no-reindex', arg: '', what: '安装 / 更新后不自动重扫注册表', when: '批量操作后再统一重扫时', caution: '' },
+  { flag: '--dry-run', arg: '', what: '只预览不写入（install / update / hub link / hub unlink / hub remove）', when: '执行前先看影响时', caution: '预演只读，不改动任何文件' },
+  { flag: '--list', arg: '', what: '列出全家技能 + 版本 + 说明', when: '查看清单或核对版本时', caution: '' },
+  { flag: '--inventory', arg: '', what: '盘点本机已装技能（自研扫描）', when: '接手机器或排查技能分布时', caution: '' },
+  { flag: '--reindex', arg: '', what: '重扫本地技能注册表', when: '手工安装技能后刷新注册表时', caution: '' },
+  { flag: '-h, --help', arg: '', what: '显示帮助', when: '忘了命令怎么用时', caution: '' },
+  { flag: '-v, --version', arg: '', what: '显示版本', when: '确认安装版本时', caution: '' },
+];
+
+const CLI_HELP_MODEL = [
+  {
+    group: '安装与更新',
+    commands: [
+      {
+        name: 'install',
+        usage: 'install [skill...] [--agent <name> | --dir <path>] [--only <a,b> | --domain <name>] [--dry-run]',
+        what: '装全家或指定技能到目标目录',
+        when: '新机器铺齐、补装单个技能、按领域安装时',
+        options: ['--agent', '--dir', '--only', '--domain', '--pin', '--range', '--dry-run', '--force', '--skip-scan', '--no-reindex'],
+      },
+      {
+        name: 'update',
+        usage: 'update [--agent <name> | --dir <path>] [--installed-only] [--check [--scheduled] | --auto] [--only <a,b> | --domain <name>]',
+        what: '增量更新已装技能（补齐缺失 / 升级版本不一致）',
+        when: '日常维护、只读检查更新、后台周检、自动跟进时',
+        options: ['--agent', '--dir', '--installed-only', '--check', '--scheduled', '--auto', '--only', '--domain', '--dry-run', '--skip-scan'],
+      },
+      {
+        name: '--dry-run',
+        usage: '--dry-run',
+        what: '只预览将安装 / 更新 / 链接 / 删除的清单，不联网不改动（与 install / update / hub link / hub unlink / hub remove 合用）',
+        when: '执行前先确认影响面时',
+        options: ['--dry-run'],
+      },
+    ],
+  },
+  {
+    group: '体检与回滚',
+    commands: [
+      {
+        name: 'doctor',
+        usage: 'doctor [--agent <name> | --dir <path>] [--slug <slug>] [--json]',
+        what: '只读自检技能目录（SKILL / 版本 / manifest / 注册表）',
+        when: '安装后、异常后、升级后确认状态时',
+        options: ['--agent', '--dir', '--slug', '--json'],
+      },
+      {
+        name: 'rollback',
+        usage: 'rollback [--agent <name> | --dir <path>] [--slug <slug>] [--list] [--json]',
+        what: '回滚最近一次技能安装或更新',
+        when: '新版本有问题、想回到快照时',
+        options: ['--agent', '--dir', '--slug', '--list', '--json'],
+      },
+    ],
+  },
+  {
+    group: '盘点与路由',
+    commands: [
+      {
+        name: '--list',
+        usage: '--list',
+        what: '列出全家技能 + 版本 + 说明',
+        when: '查看清单、核对版本、确认技能名时',
+        options: ['--list'],
+      },
+      {
+        name: '--inventory',
+        usage: '--inventory [--project] [--json]',
+        what: '盘点本机已装技能（自研扫描，不依赖任何元技能）',
+        when: '接手机器、排查技能分布、找同名多副本时',
+        options: ['--inventory', '--project', '--json'],
+      },
+      {
+        name: '--reindex',
+        usage: '--reindex [--project]',
+        what: '重扫本地技能注册表（install / update 后也会自动重扫）',
+        when: '手工安装技能后刷新注册表时',
+        options: ['--reindex', '--project'],
+      },
+      {
+        name: '--route',
+        usage: '--route "<需求摘要>" [--json]',
+        what: '按需求给出技能组合、调用顺序、缺失技能安装建议',
+        when: '不知道该用哪些技能、想按场景组合时',
+        options: ['--route', '--json'],
+      },
+      {
+        name: 'decide-memory',
+        usage: 'decide-memory [--dry-run | --promote] [--explain] [--json]',
+        what: 'M1 记忆裁决：输出 promote / hold / demote 只读建议',
+        when: '判断哪些技能值得长期记忆时',
+        options: ['--dry-run', '--promote', '--explain', '--json'],
+      },
+    ],
+  },
+  {
+    group: '技能 Hub',
+    commands: [
+      {
+        name: 'hub',
+        usage: 'hub <子命令> [选项]',
+        what: 'Hub 单点真源：发现宿主、安装 / 收编、链接分发、体检、删除',
+        when: '多智能体共享技能、统一管理技能目录时',
+        options: ['--hub', '--all', '--include-discovered', '--dry-run', '--json'],
+        subcommands: [
+          { name: 'hosts', usage: 'hub hosts [--json]', what: '发现本机已装智能体与技能目录（已核实 / 自动发现 / 桥接）', when: '先看这台机器有哪些宿主目录时', options: ['--json'] },
+          { name: 'install', usage: 'hub install [skill...]', what: '把元技能装进 Hub 真源（清单 27 + 特殊家族 5）', when: '初始化 Hub 或补装技能时', options: ['--hub'] },
+          { name: 'update', usage: 'hub update', what: '更新 Hub 内的元技能（非元技能不参与）', when: '日常维护 Hub 真源时', options: ['--hub'] },
+          { name: 'adopt', usage: 'hub adopt [--scan | --apply] [--include <a,b>] [--in-place]', what: '把各宿主已有技能收编进 Hub（默认复制保真）', when: '接管机器上已装的技能时', options: ['--scan', '--apply', '--include', '--in-place', '--force', '--skip-scan', '--allow-unverified'] },
+          { name: 'refresh', usage: 'hub refresh <slug> --from <path>', what: '手动同步非元阁技能（无统一更新源）', when: '外部技能更新后刷新 Hub 副本时', options: ['--from'] },
+          { name: 'link', usage: 'hub link [skill...] [--all | --agent <id> | --dir <path>] [--include-discovered] [--dry-run]', what: '把 Hub 技能链接到宿主目录（指定智能体 / 全量）', when: '分发技能到各智能体时', options: ['--all', '--agent', '--dir', '--include-discovered', '--force', '--dry-run'] },
+          { name: 'unlink', usage: 'hub unlink [skill...] [--all | --agent <id> | --dir <path>] [--dry-run]', what: '只删除链接，不动 Hub 真源（fail-closed）', when: '解除某个 / 全部宿主的链接时', options: ['--all', '--agent', '--dir', '--include-discovered', '--dry-run'] },
+          { name: 'remove', usage: 'hub remove <slug> [--dry-run] [--include-discovered]', what: '删除 Hub 技能：全宿主清链接（含死链）+ 目录入回收站 + 清台账 + 审计', when: '彻底删除某个 Hub 技能时', options: ['--dry-run', '--include-discovered', '--json'] },
+          { name: 'status', usage: 'hub status [--json]', what: '查看 Hub 技能 / 来源 / 版本 / 链接 / 宿主', when: '核对 Hub 现状时', options: ['--json'] },
+          { name: 'doctor', usage: 'hub doctor [--json]', what: '检查断链 / 目标缺失 / slug 不一致 / 单一真源 / 链接范围', when: 'Hub 异常后排查时', options: ['--json'] },
+        ],
+      },
+    ],
+  },
+  {
+    group: '使用记录与 Hook',
+    commands: [
+      {
+        name: 'usage',
+        usage: 'usage <子命令>',
+        what: '本地技能使用记录（默认关闭；只记结构化计数）',
+        when: '想看技能使用信号、给路由 / 裁决提供依据时',
+        options: ['--json'],
+        subcommands: [
+          { name: 'status', usage: 'usage status [--json]', what: '查看开关与计数', when: '核对记录状态时', options: ['--json'] },
+          { name: 'enable', usage: 'usage enable', what: '开启本地使用记录', when: '想开始积累使用信号时', options: [] },
+          { name: 'disable', usage: 'usage disable', what: '关闭本地使用记录', when: '不想再记录时', options: [] },
+          { name: 'mark', usage: 'usage mark --skill <slug> --signal used|named|accepted', what: '记录一次使用信号', when: '技能被实际使用 / 点名 / 接受时', options: ['--skill', '--signal'] },
+          { name: 'reset', usage: 'usage reset --yes', what: '清空本地使用记录', when: '确认要重置计数时', options: ['--yes'] },
+        ],
+      },
+      {
+        name: 'hook',
+        usage: 'hook <子命令> [--host <name>]',
+        what: '宿主 hook 适配：能力矩阵 / 评估 / 绑定 / 反注册',
+        when: '接入宿主六事件、排查 hook 时',
+        options: ['--host', '--event', '--manifest', '--context', '--json'],
+        subcommands: [
+          { name: 'capabilities', usage: 'hook capabilities [--host <name>] [--json]', what: '查看宿主六事件能力矩阵', when: '确认宿主支持哪些 hook 时', options: ['--host', '--json'] },
+          { name: 'evaluate', usage: 'hook evaluate --event <event> --manifest <file> [--context <json>]', what: '评估 hook 声明并留证', when: '上线前验证 hook 行为时', options: ['--host', '--event', '--manifest', '--context', '--json'] },
+          { name: 'bind', usage: 'hook bind --manifest <file> [--host <name>]', what: '注册 hook 声明（幂等）', when: '给宿主登记 hook 时', options: ['--host', '--manifest', '--json'] },
+          { name: 'unbind', usage: 'hook unbind <binding-id> [--host <name>]', what: '反注册 hook 声明', when: '下线 hook 时', options: ['--host', '--json'] },
+        ],
+      },
+    ],
+  },
+  {
+    group: '面板与帮助',
+    commands: [
+      {
+        name: 'view',
+        usage: 'view [--port <n>]',
+        what: '启动本机技能枢纽面板（127.0.0.1:8789）',
+        when: '想图形化管理 Hub、看宿主矩阵 / 体检 / 路由时',
+        options: ['--port'],
+      },
+      {
+        name: '--version',
+        usage: '--version；短写法 -v',
+        what: '显示当前版本',
+        when: '确认安装的是哪个版本时',
+        options: [],
+      },
+      {
+        name: '--help',
+        usage: '--help；短写法 -h',
+        what: '显示命令与选项帮助',
+        when: '忘了命令怎么用时',
+        options: [],
+      },
+    ],
+  },
+];
+
+const CLI_HELP_QUICK = [
+  {
+    group: '安装与更新',
+    items: [
+      { cmd: 'install', example: 'yotta-skills install --agent codex' },
+      { cmd: 'install', example: 'yotta-skills install yotta-memory --dir <技能目录>' },
+      { cmd: 'update', example: 'yotta-skills update --installed-only --dir <技能目录>' },
+      { cmd: 'update', example: 'yotta-skills update --check' },
+      { cmd: 'update', example: 'yotta-skills update --auto' },
+      { cmd: '--dry-run', example: 'yotta-skills install --dry-run --agent codex' },
+    ],
+  },
+  {
+    group: '体检与回滚',
+    items: [
+      { cmd: 'doctor', example: 'yotta-skills doctor --dir <技能目录>' },
+      { cmd: 'rollback', example: 'yotta-skills rollback --list' },
+      { cmd: 'rollback', example: 'yotta-skills rollback --slug <技能> --dir <技能目录>' },
+    ],
+  },
+  {
+    group: '盘点与路由',
+    items: [
+      { cmd: '--list', example: 'yotta-skills --list' },
+      { cmd: '--inventory', example: 'yotta-skills --inventory --json' },
+      { cmd: '--reindex', example: 'yotta-skills --reindex' },
+      { cmd: '--route', example: 'yotta-skills --route "帮我做发布前质量检查"' },
+      { cmd: 'decide-memory', example: 'yotta-skills decide-memory --dry-run' },
+    ],
+  },
+  {
+    group: '技能 Hub',
+    items: [
+      { cmd: 'hub', example: 'yotta-skills hub' },
+      { cmd: 'hub hosts', example: 'yotta-skills hub hosts' },
+      { cmd: 'hub install', example: 'yotta-skills hub install' },
+      { cmd: 'hub update', example: 'yotta-skills hub update' },
+      { cmd: 'hub adopt', example: 'yotta-skills hub adopt --scan' },
+      { cmd: 'hub adopt', example: 'yotta-skills hub adopt --apply --include <技能>' },
+      { cmd: 'hub refresh', example: 'yotta-skills hub refresh <技能> --from <技能目录>' },
+      { cmd: 'hub link', example: 'yotta-skills hub link --all' },
+      { cmd: 'hub link', example: 'yotta-skills hub link <技能> --agent codex', note: '针对指定智能体分发' },
+      { cmd: 'hub unlink', example: 'yotta-skills hub unlink <技能> --agent codex', note: '只解除该智能体的链接，Hub 真源保留' },
+      { cmd: 'hub unlink', example: 'yotta-skills hub unlink --all' },
+      { cmd: 'hub remove', example: 'yotta-skills hub remove <技能> --dry-run', danger: true, note: '删除 Hub 技能：全宿主清链接（含死链）+ 目录入回收站（7 天）+ 清台账；先 --dry-run 看影响' },
+      { cmd: 'hub status', example: 'yotta-skills hub status' },
+      { cmd: 'hub doctor', example: 'yotta-skills hub doctor' },
+    ],
+  },
+  {
+    group: '使用记录与 Hook',
+    items: [
+      { cmd: 'usage', example: 'yotta-skills usage status' },
+      { cmd: 'usage status', example: 'yotta-skills usage status --json' },
+      { cmd: 'usage enable', example: 'yotta-skills usage enable' },
+      { cmd: 'usage disable', example: 'yotta-skills usage disable' },
+      { cmd: 'usage mark', example: 'yotta-skills usage mark --skill yotta-memory --signal used' },
+      { cmd: 'usage reset', example: 'yotta-skills usage reset --yes', danger: true, note: '清空本地使用记录，先确认不再需要计数' },
+      { cmd: 'hook', example: 'yotta-skills hook capabilities' },
+      { cmd: 'hook capabilities', example: 'yotta-skills hook capabilities --host codex --json' },
+      { cmd: 'hook evaluate', example: 'yotta-skills hook evaluate --event before_install --manifest <file>' },
+      { cmd: 'hook bind', example: 'yotta-skills hook bind --manifest <file>' },
+      { cmd: 'hook unbind', example: 'yotta-skills hook unbind <binding-id>' },
+    ],
+  },
+  {
+    group: '面板与帮助',
+    items: [
+      { cmd: 'view', example: 'yotta-skills view' },
+      { cmd: 'view', example: 'yotta-skills view --port 8790' },
+      { cmd: '--version', example: 'yotta-skills --version' },
+      { cmd: '--help', example: 'yotta-skills --help' },
+    ],
+  },
+];
+
+module.exports = {
+  CLI_HELP_MODEL,
+  CLI_HELP_QUICK,
+  CLI_GLOBAL_OPTIONS,
+};

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

@@ -32,6 +32,7 @@ const routeFeaturesLib = require('./route-features');
 const routeDynamicLib = require('./route-dynamic');
 const providerLib = require('./provider');
 const usageLib = require('./usage-journal');
+const cliHelpLib = require('./cli-help');
 
 const DEFAULT_HOST = '127.0.0.1';
 const DEFAULT_PORT = 8789;
@@ -41,7 +42,7 @@ const DEFAULT_LIMIT = 100;
 const MAX_LIMIT = 500;
 const TOKEN_HEADER = 'x-yotta-view-token';
 const TOKEN_PLACEHOLDER = '__YOTTA_VIEW_TOKEN__';
-const CONFIRM = { unlink: 'unlink', rollback: 'rollback' };
+const CONFIRM = { unlink: 'unlink', rollback: 'rollback', remove: 'remove' };
 const SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
 
 function nowIso() {
@@ -372,6 +373,65 @@ function restoreFromSnapshot(ctx, slug, snapshotPath) {
   };
 }
 
+/**
+ * 面板删除技能的目标范围 = 已核实宿主 ∪ 本技能链接台账（与 CLI 默认范围一致）。
+ */
+function removeTargets(ctx, slug) {
+  const found = discovery(ctx);
+  const targets = [];
+  const seen = new Set();
+  const add = (dir, label, agentId) => {
+    if (!dir) return;
+    const resolved = path.resolve(dir);
+    const key = normalizeDir(resolved);
+    if (seen.has(key)) return;
+    seen.add(key);
+    targets.push({ dir: resolved, label: label || '指定目录', agentId: agentId || null });
+  };
+  for (const host of found.hosts || []) {
+    if (!host.exists || host.bridgeOnly || !host.verified) continue;
+    add(host.dir, host.label, host.agentId);
+  }
+  for (const item of hubLib.readLinkState(ctx.hubDir).links.filter((link) => link.slug === slug)) {
+    add(item.dir, item.label || '台账记录目录', item.agent);
+  }
+  return targets;
+}
+
+function removePlanPayload(ctx, slug) {
+  return hubLib.removeSkills({
+    hubDir: ctx.hubDir,
+    slug,
+    targets: removeTargets(ctx, slug),
+    dryRun: true,
+    manifest: ctx.manifest,
+    homeDir: ctx.homeDir,
+    env: ctx.env,
+  });
+}
+
+function writeRemove(ctx, body) {
+  if (String(body.confirm || '') !== CONFIRM.remove) {
+    return { code: 400, payload: { error: '破坏性操作确认不匹配；请确认后再执行。' } };
+  }
+  const slug = String(body.slug || '').trim().toLowerCase();
+  if (!SLUG_RE.test(slug)) return { code: 400, payload: { error: '技能 slug 非法。' } };
+  if (String(body.confirmSlug || '') !== slug) {
+    return { code: 400, payload: { error: '技能名确认不匹配；请输入完整 slug。' } };
+  }
+  const payload = hubLib.removeSkills({
+    hubDir: ctx.hubDir,
+    slug,
+    targets: removeTargets(ctx, slug),
+    dryRun: false,
+    manifest: ctx.manifest,
+    homeDir: ctx.homeDir,
+    env: ctx.env,
+  });
+  const code = payload.verdict === 'failed' ? 500 : payload.verdict === 'not-found' ? 404 : 200;
+  return { code, payload };
+}
+
 function writeAdopt(ctx, body) {
   if (body.skipScan || body.allowUnverified) {
     return {
@@ -558,6 +618,19 @@ function handleGet(ctx, pathname, url, res) {
     });
   }
   if (pathname === '/api/overview') return json(res, 200, overviewPayload(ctx));
+  if (pathname === '/api/help') {
+    return json(res, 200, {
+      version: ctx.version || '',
+      groups: cliHelpLib.CLI_HELP_MODEL,
+      quick: cliHelpLib.CLI_HELP_QUICK,
+      options: cliHelpLib.CLI_GLOBAL_OPTIONS,
+    });
+  }
+  if (pathname === '/api/skills/remove-plan') {
+    const slug = String(url.searchParams.get('slug') || '').trim().toLowerCase();
+    if (!SLUG_RE.test(slug)) return json(res, 400, { error: '技能 slug 非法。' });
+    return json(res, 200, removePlanPayload(ctx, slug));
+  }
   if (pathname === '/api/hosts') return json(res, 200, hostsPayload(ctx));
   if (pathname === '/api/adopt/scan') return json(res, 200, adoptScanPayload(ctx));
   if (pathname === '/api/links') return json(res, 200, linksPayload(ctx));
@@ -590,6 +663,7 @@ function handlePost(ctx, pathname, req, res) {
       if (pathname === '/api/links/apply') return writeLink(ctx, body);
       if (pathname === '/api/links/remove') return writeUnlink(ctx, body);
       if (pathname === '/api/rollback/apply') return writeRollback(ctx, body);
+      if (pathname === '/api/skills/remove') return writeRemove(ctx, body);
       return { code: 404, payload: { error: 'not found' } };
     };
     ctx.queue(run)