@xdxer/dingtalk-agent 0.1.4-beta.15 → 0.1.4-beta.17

package/dist/src/skill-manager.js

@@ -1,14 +1,18 @@
 // Skill 安装生命周期由开放生态的 `npx skills` 负责。
 // dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。
-// 默认（不指定 name）对全部内置 Skill 生效：基础行为 + Agent 装配；指定 name 时只操作该 Skill。
-import { existsSync, lstatSync, readFileSync, readlinkSync } from 'node:fs';
+// 默认（不指定 name）对全部内置 Skill 生效：基础行为 + Agent 装配 + 交付后评测；指定 name 时只操作该 Skill。
+import { existsSync, lstatSync, readdirSync, readFileSync, readlinkSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { cleanVersion, compareVersions, isValidVersion } from './version.js';
 export const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior';
 // 默认套装：所有机器都装的通用 Skill。平台 Skill（deploy/boot-multica 等）不在默认套装内，
 // 只有工作区通过 `dta agent-platform use` 选择对应 managed agent platform 时才按名安装。
-export const BUNDLED_SKILL_NAMES = [GLOBAL_SKILL_NAME, 'dingtalk-agent-compose'];
+export const BUNDLED_SKILL_NAMES = [
+    GLOBAL_SKILL_NAME, 'dingtalk-agent-compose', 'dingtalk-agent-eval',
+];
 export const INSTALLABLE_SKILL_NAMES = [
     ...BUNDLED_SKILL_NAMES,
     'dingtalk-agent-deploy-multica', 'dingtalk-agent-boot-multica', 'multica-external',
@@ -55,9 +59,15 @@ export function skillStatus(packageRoot, options = {}) {
     const paths = globalPaths(packageRoot, options.home, name);
     const bundled = bundledInfo(packageRoot, name);
     const canonicalExists = isDirectory(paths.canonical);
-    const installedVersion = canonicalExists
-        ? parseSkillFrontmatter(readFileSync(join(paths.canonical, 'SKILL.md'), 'utf8')).version
-        : '';
+    const installedVersion = canonicalExists ? readInstalledVersion(paths.canonical) : '';
+    const installedHash = canonicalExists ? skillContentHash(paths.canonical) : '';
+    const drift = driftOf({
+        exists: canonicalExists,
+        installedVersion,
+        installedHash,
+        bundledVersion: bundled.skillVersion,
+        bundledHash: bundled.contentHash,
+    });
     const claude = inspectExposure(paths.claude, paths.canonical);
     const sharedState = canonicalExists ? 'ok' : 'missing';
     return {
@@ -69,7 +79,10 @@ export function skillStatus(packageRoot, options = {}) {
             path: paths.canonical,
             exists: canonicalExists,
             installedVersion,
-            current: Boolean(canonicalExists && installedVersion === bundled.skillVersion),
+            installedHash,
+            state: drift.state,
+            comparison: drift.comparison,
+            current: drift.state === 'current',
         },
         claude: { path: paths.claude, ...claude },
         clients: [
@@ -113,12 +126,21 @@ function runSkills(packageRoot, action, args, options) {
     ];
     const command = ['npx', ...commandArgs].map(shellQuote).join(' ');
     const before = skillStatus(packageRoot, options);
+    const beforeState = { installedVersion: before.canonical.installedVersion, state: before.canonical.state };
     if (options.dryRun) {
         return {
             ...before,
-            operation: { action, command, executed: false, exitCode: null, output: '' },
+            operation: {
+                action, command, executed: false, exitCode: null, output: '',
+                before: beforeState, after: null,
+            },
         };
     }
+    // 本机比包内新时覆盖就是降级；与 npm 包升级策略一致，默认拒绝。
+    if (action !== 'uninstall' && before.canonical.state === 'ahead' && !options.allowDowngrade) {
+        throw new Error(`拒绝降级 ${before.name}: 本机 ${before.canonical.installedVersion} 高于包内 ` +
+            `${before.bundled.skillVersion}；确认要覆盖时加 --allow-downgrade`);
+    }
     const env = {
         ...process.env,
         ...(options.env || {}),
@@ -135,9 +157,20 @@ function runSkills(packageRoot, action, args, options) {
         throw new Error(`skills CLI ${action} 失败: ${reason}\n` +
             `可手动执行: ${command}`);
     }
+    // 退出码 0 不等于本机副本已经是目标版本；升级/安装后必须回读确认。
+    const after = skillStatus(packageRoot, options);
+    if (action !== 'uninstall' && after.canonical.state !== 'current') {
+        throw new Error(`skills CLI ${action} 退出码为 0，但回读 ${after.name} 仍为 ${after.canonical.state}` +
+            `（本机 ${after.canonical.installedVersion || '未声明'} / 包内 ${after.bundled.skillVersion}）\n` +
+            `可手动执行: ${command}`);
+    }
     return {
-        ...skillStatus(packageRoot, options),
-        operation: { action, command, executed: true, exitCode: run.status, output },
+        ...after,
+        operation: {
+            action, command, executed: true, exitCode: run.status, output,
+            before: beforeState,
+            after: { installedVersion: after.canonical.installedVersion, state: after.canonical.state },
+        },
     };
 }
 function globalPaths(packageRoot, home = homedir(), name = GLOBAL_SKILL_NAME) {
@@ -156,6 +189,57 @@ function bundledInfo(packageRoot, name) {
         path: source,
         packageVersion: String(pkg.version || ''),
         skillVersion: frontmatter.version,
+        contentHash: skillContentHash(source),
+    };
+}
+/** 本机副本的版本号；用户手改坏格式时返回空串并由调用方降级为 unknown，不抛错。 */
+function readInstalledVersion(canonical) {
+    try {
+        return parseSkillFrontmatter(readFileSync(join(canonical, 'SKILL.md'), 'utf8')).version;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * 全树内容 hash：按相对路径排序，逐个 update(相对路径 + \0 + 内容)。
+ * 它证明 references/assets 完整一致，补上"改了正文但没 bump 版本"这类版本号测不出的漂移。
+ */
+export function skillContentHash(root) {
+    const hash = createHash('sha256');
+    for (const relative of listSkillFiles(root)) {
+        hash.update(relative);
+        hash.update('\0');
+        hash.update(readFileSync(join(root, relative)));
+    }
+    return `sha256:${hash.digest('hex').slice(0, 16)}`;
+}
+function listSkillFiles(root, prefix = '') {
+    const files = [];
+    for (const entry of readdirSync(join(root, prefix), { withFileTypes: true })) {
+        if (entry.name === '.DS_Store' || entry.isSymbolicLink())
+            continue;
+        const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            files.push(...listSkillFiles(root, relative));
+        else if (entry.isFile())
+            files.push(relative);
+    }
+    return files.sort();
+}
+function driftOf(input) {
+    if (!input.exists)
+        return { state: 'missing', comparison: null };
+    if (!isValidVersion(input.installedVersion))
+        return { state: 'unknown', comparison: null };
+    const comparison = compareVersions(input.installedVersion, input.bundledVersion);
+    if (comparison > 0)
+        return { state: 'ahead', comparison };
+    if (comparison < 0)
+        return { state: 'outdated', comparison };
+    return {
+        state: input.installedHash === input.bundledHash ? 'current' : 'modified',
+        comparison,
     };
 }
 function inspectExposure(exposure, canonical) {
@@ -181,6 +265,10 @@ function validateSkill(root, name) {
     }
     if (!metadata.description)
         throw new Error('Skill frontmatter 缺少 description');
+    // 包内 Skill 缺版本号是仓库缺陷：没有版本就无法判断本机副本是否过期，直接 fail closed。
+    if (!metadata.version)
+        throw new Error(`Skill 缺少 metadata.version: ${root}`);
+    cleanVersion(metadata.version);
 }
 function bundledSkillName(value = '') {
     const name = value.trim() || GLOBAL_SKILL_NAME;

package/dist/src/skill-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// Skill 安装生命周期由开放生态的 `npx skills` 负责。\n// dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。\n// 默认（不指定 name）对全部内置 Skill 生效：基础行为 + Agent 装配；指定 name 时只操作该 Skill。\n\nimport { existsSync, lstatSync, readFileSync, readlinkSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\nimport { spawnSync } from 'node:child_process'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\n// 默认套装：所有机器都装的通用 Skill。平台 Skill（deploy/boot-multica 等）不在默认套装内，\n// 只有工作区通过 `dta agent-platform use` 选择对应 managed agent platform 时才按名安装。\nexport const BUNDLED_SKILL_NAMES = [GLOBAL_SKILL_NAME, 'dingtalk-agent-compose'] as const\nexport const INSTALLABLE_SKILL_NAMES = [\n  ...BUNDLED_SKILL_NAMES,\n  'dingtalk-agent-deploy-multica', 'dingtalk-agent-boot-multica', 'multica-external',\n] as const\n\n// 仓库/包内的 Skill 源码路径注册表：core 为通用套装，platforms/<platform> 按平台装填。\n// 安装后的 canonical 布局仍是扁平的 ~/.agents/skills/<name>；分层只存在于包内。\nconst BUNDLED_SKILL_DIRS: Record<string, string> = {\n  'dingtalk-basic-behavior': 'skills/core/dingtalk-basic-behavior',\n  'dingtalk-agent-compose': 'skills/core/dingtalk-agent-compose',\n  'dingtalk-agent-eval': 'skills/core/dingtalk-agent-eval',\n  'dingtalk-agent-deploy-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-deploy-multica',\n  'dingtalk-agent-boot-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-boot-multica',\n  'multica-external': 'skills/platforms/multica-dingtalk/multica-external',\n}\n\n/** 解析包内 Skill 源码目录；未注册的名字回退到历史扁平布局。 */\nexport function bundledSkillPath(packageRoot: string, name: string): string {\n  return join(packageRoot, BUNDLED_SKILL_DIRS[name] || join('skills', name))\n}\nconst SKILLS_PACKAGE = 'skills@latest'\nconst REGISTRY = 'https://registry.npmjs.org'\nconst AGENTS = ['claude-code', 'codex', 'opencode']\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  env?: NodeJS.ProcessEnv\n  name?: string\n}\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@2'\n  name: string\n  manager: 'skills-cli'\n  bundled: { path: string; packageVersion: string; skillVersion: string }\n  canonical: {\n    path: string\n    exists: boolean\n    installedVersion: string\n    current: boolean\n  }\n  claude: { path: string; state: 'ok' | 'missing' | 'conflict'; target: string }\n  clients: Array<{\n    name: 'claude-code' | 'codex' | 'opencode'\n    label: string\n    discovery: 'symlink' | 'shared-agent-skills'\n    path: string\n    state: 'ok' | 'missing' | 'conflict'\n  }>\n  operation?: {\n    action: 'install' | 'upgrade' | 'uninstall'\n    command: string\n    executed: boolean\n    exitCode: number | null\n    output: string\n  }\n}\n\nexport interface GlobalSkillSuiteStatus {\n  $schema: 'dingtalk-agent/skill-status-suite@1'\n  manager: 'skills-cli'\n  names: string[]\n  skills: GlobalSkillStatus[]\n}\n\nexport function skillSuiteStatus(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => skillStatus(packageRoot, { ...options, name })))\n}\n\nexport function installBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => installGlobalSkill(packageRoot, { ...options, name })))\n}\n\nexport function upgradeBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => upgradeGlobalSkill(packageRoot, { ...options, name })))\n}\n\nexport function uninstallBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => uninstallGlobalSkill(packageRoot, { ...options, name })))\n}\n\nfunction suiteOf(skills: GlobalSkillStatus[]): GlobalSkillSuiteStatus {\n  return {\n    $schema: 'dingtalk-agent/skill-status-suite@1',\n    manager: 'skills-cli',\n    names: skills.map((skill) => skill.name),\n    skills,\n  }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const name = bundledSkillName(options.name)\n  const paths = globalPaths(packageRoot, options.home, name)\n  const bundled = bundledInfo(packageRoot, name)\n  const canonicalExists = isDirectory(paths.canonical)\n  const installedVersion = canonicalExists\n    ? parseSkillFrontmatter(readFileSync(join(paths.canonical, 'SKILL.md'), 'utf8')).version\n    : ''\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  const sharedState = canonicalExists ? 'ok' : 'missing'\n  return {\n    $schema: 'dingtalk-agent/skill-status@2',\n    name,\n    manager: 'skills-cli',\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      installedVersion,\n      current: Boolean(canonicalExists && installedVersion === bundled.skillVersion),\n    },\n    claude: { path: paths.claude, ...claude },\n    clients: [\n      {\n        name: 'claude-code', label: 'Claude Code', discovery: 'symlink',\n        path: paths.claude, state: claude.state,\n      },\n      {\n        name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n      {\n        name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n    ],\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'install', [\n    'add', globalPaths(packageRoot, undefined, bundledSkillName(options.name)).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  // Skill 随 npm 包发布；重新 add 当前包内目录，让 skills CLI 执行自己的覆盖/链接语义。\n  return runSkills(packageRoot, 'upgrade', [\n    'add', globalPaths(packageRoot, undefined, bundledSkillName(options.name)).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'uninstall', [\n    'remove', bundledSkillName(options.name),\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nfunction runSkills(\n  packageRoot: string,\n  action: 'install' | 'upgrade' | 'uninstall',\n  args: string[],\n  options: SkillManagerOptions,\n): GlobalSkillStatus {\n  const commandArgs = [\n    '--yes', `--registry=${REGISTRY}`, `--package=${SKILLS_PACKAGE}`, '--', 'skills', ...args,\n  ]\n  const command = ['npx', ...commandArgs].map(shellQuote).join(' ')\n  const before = skillStatus(packageRoot, options)\n  if (options.dryRun) {\n    return {\n      ...before,\n      operation: { action, command, executed: false, exitCode: null, output: '' },\n    }\n  }\n\n  const env = {\n    ...process.env,\n    ...(options.env || {}),\n    HOME: options.home || options.env?.HOME || process.env.HOME || homedir(),\n  }\n  const run = spawnSync('npx', commandArgs, {\n    encoding: 'utf8', env, timeout: 120_000,\n  })\n  const output = [run.stdout, run.stderr].filter(Boolean).join('\\n').trim()\n  if (run.error || run.status !== 0) {\n    const reason = (run.error as NodeJS.ErrnoException | undefined)?.code === 'ENOENT'\n      ? 'PATH 找不到 npx；请安装带 npm/npx 的 Node.js 18.3+'\n      : run.error?.message || output || `退出码 ${run.status}`\n    throw new Error(\n      `skills CLI ${action} 失败: ${reason}\\n` +\n      `可手动执行: ${command}`,\n    )\n  }\n  return {\n    ...skillStatus(packageRoot, options),\n    operation: { action, command, executed: true, exitCode: run.status, output },\n  }\n}\n\nfunction globalPaths(packageRoot: string, home = homedir(), name = GLOBAL_SKILL_NAME) {\n  return {\n    source: bundledSkillPath(packageRoot, name),\n    canonical: join(home, '.agents', 'skills', name),\n    claude: join(home, '.claude', 'skills', name),\n  }\n}\n\nfunction bundledInfo(packageRoot: string, name: string) {\n  const source = globalPaths(packageRoot, undefined, name).source\n  validateSkill(source, name)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(source, 'SKILL.md'), 'utf8'))\n  return {\n    path: source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n  }\n}\n\nfunction inspectExposure(exposure: string, canonical: string): {\n  state: 'ok' | 'missing' | 'conflict'\n  target: string\n} {\n  if (!pathExists(exposure)) return { state: 'missing', target: '' }\n  const stat = lstatSync(exposure)\n  if (!stat.isSymbolicLink()) return { state: 'conflict', target: '' }\n  const raw = readlinkSync(exposure)\n  return resolve(dirname(exposure), raw) === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction validateSkill(root: string, name: string): void {\n  if (!isDirectory(root)) throw new Error(`内置 Skill 不存在: ${root}`)\n  const file = join(root, 'SKILL.md')\n  if (!existsSync(file)) throw new Error(`Skill 缺少 SKILL.md: ${root}`)\n  const metadata = parseSkillFrontmatter(readFileSync(file, 'utf8'))\n  if (metadata.name !== name) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${name} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\n}\n\nfunction bundledSkillName(value = ''): string {\n  const name = value.trim() || GLOBAL_SKILL_NAME\n  if (!(INSTALLABLE_SKILL_NAMES as readonly string[]).includes(name)) {\n    throw new Error(`不支持的内置 Skill: ${name}；可用: ${INSTALLABLE_SKILL_NAMES.join(', ')}`)\n  }\n  return name\n}\n\nfunction parseSkillFrontmatter(text: string): { name: string; description: string; version: string } {\n  const match = text.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n|$)/)\n  if (!match) throw new Error('SKILL.md 缺少 YAML frontmatter')\n  const block = match[1]\n  const readScalar = (key: string) => {\n    const found = block.match(new RegExp(`^${key}:\\\\s*(.+)$`, 'm'))\n    return found ? found[1].trim().replace(/^(['\"])(.*)\\1$/, '$2') : ''\n  }\n  const nestedVersion = block.match(/^metadata:\\s*\\r?\\n(?:[ \\t]+.*\\r?\\n)*?[ \\t]+version:\\s*['\"]?([^'\"\\r\\n]+)['\"]?\\s*$/m)\n  return {\n    name: readScalar('name'),\n    description: readScalar('description'),\n    version: nestedVersion?.[1]?.trim() || readScalar('version'),\n  }\n}\n\nfunction isDirectory(path: string): boolean {\n  try { return lstatSync(path).isDirectory() } catch { return false }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction shellQuote(value: string): string {\n  return /^[A-Za-z0-9_./:=@-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n"]}
+{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// Skill 安装生命周期由开放生态的 `npx skills` 负责。\n// dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。\n// 默认（不指定 name）对全部内置 Skill 生效：基础行为 + Agent 装配 + 交付后评测；指定 name 时只操作该 Skill。\n\nimport { existsSync, lstatSync, readdirSync, readFileSync, readlinkSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\nimport { spawnSync } from 'node:child_process'\nimport { createHash } from 'node:crypto'\nimport { cleanVersion, compareVersions, isValidVersion } from './version.js'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\n// 默认套装：所有机器都装的通用 Skill。平台 Skill（deploy/boot-multica 等）不在默认套装内，\n// 只有工作区通过 `dta agent-platform use` 选择对应 managed agent platform 时才按名安装。\nexport const BUNDLED_SKILL_NAMES = [\n  GLOBAL_SKILL_NAME, 'dingtalk-agent-compose', 'dingtalk-agent-eval',\n] as const\nexport const INSTALLABLE_SKILL_NAMES = [\n  ...BUNDLED_SKILL_NAMES,\n  'dingtalk-agent-deploy-multica', 'dingtalk-agent-boot-multica', 'multica-external',\n] as const\n\n// 仓库/包内的 Skill 源码路径注册表：core 为通用套装，platforms/<platform> 按平台装填。\n// 安装后的 canonical 布局仍是扁平的 ~/.agents/skills/<name>；分层只存在于包内。\nconst BUNDLED_SKILL_DIRS: Record<string, string> = {\n  'dingtalk-basic-behavior': 'skills/core/dingtalk-basic-behavior',\n  'dingtalk-agent-compose': 'skills/core/dingtalk-agent-compose',\n  'dingtalk-agent-eval': 'skills/core/dingtalk-agent-eval',\n  'dingtalk-agent-deploy-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-deploy-multica',\n  'dingtalk-agent-boot-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-boot-multica',\n  'multica-external': 'skills/platforms/multica-dingtalk/multica-external',\n}\n\n/** 解析包内 Skill 源码目录；未注册的名字回退到历史扁平布局。 */\nexport function bundledSkillPath(packageRoot: string, name: string): string {\n  return join(packageRoot, BUNDLED_SKILL_DIRS[name] || join('skills', name))\n}\nconst SKILLS_PACKAGE = 'skills@latest'\nconst REGISTRY = 'https://registry.npmjs.org'\nconst AGENTS = ['claude-code', 'codex', 'opencode']\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  env?: NodeJS.ProcessEnv\n  name?: string\n  allowDowngrade?: boolean\n}\n\n/**\n * 本机副本相对包内 Skill 的漂移状态。`current` 是它的派生布尔，保留给既有读者。\n * 版本相等但内容不同（用户手改过）必须与真正一致区分开，否则升级提示会漏掉这类漂移。\n */\nexport type SkillDriftState =\n  | 'missing'   // canonical 不存在\n  | 'current'   // 版本相等且内容 hash 相等\n  | 'modified'  // 版本相等但内容 hash 不等\n  | 'outdated'  // 已装版本低于包内版本\n  | 'ahead'     // 已装版本高于包内版本\n  | 'unknown'   // 已装版本缺失或非法\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@2'\n  name: string\n  manager: 'skills-cli'\n  bundled: { path: string; packageVersion: string; skillVersion: string; contentHash: string }\n  canonical: {\n    path: string\n    exists: boolean\n    installedVersion: string\n    installedHash: string\n    state: SkillDriftState\n    comparison: number | null\n    current: boolean\n  }\n  claude: { path: string; state: 'ok' | 'missing' | 'conflict'; target: string }\n  clients: Array<{\n    name: 'claude-code' | 'codex' | 'opencode'\n    label: string\n    discovery: 'symlink' | 'shared-agent-skills'\n    path: string\n    state: 'ok' | 'missing' | 'conflict'\n  }>\n  operation?: {\n    action: 'install' | 'upgrade' | 'uninstall'\n    command: string\n    executed: boolean\n    exitCode: number | null\n    output: string\n    before: { installedVersion: string; state: SkillDriftState }\n    after: { installedVersion: string; state: SkillDriftState } | null\n  }\n}\n\nexport interface GlobalSkillSuiteStatus {\n  $schema: 'dingtalk-agent/skill-status-suite@1'\n  manager: 'skills-cli'\n  names: string[]\n  skills: GlobalSkillStatus[]\n}\n\nexport function skillSuiteStatus(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => skillStatus(packageRoot, { ...options, name })))\n}\n\nexport function installBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => installGlobalSkill(packageRoot, { ...options, name })))\n}\n\nexport function upgradeBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => upgradeGlobalSkill(packageRoot, { ...options, name })))\n}\n\nexport function uninstallBundledSkills(\n  packageRoot: string,\n  options: Omit<SkillManagerOptions, 'name'> = {},\n): GlobalSkillSuiteStatus {\n  return suiteOf(BUNDLED_SKILL_NAMES.map((name) => uninstallGlobalSkill(packageRoot, { ...options, name })))\n}\n\nfunction suiteOf(skills: GlobalSkillStatus[]): GlobalSkillSuiteStatus {\n  return {\n    $schema: 'dingtalk-agent/skill-status-suite@1',\n    manager: 'skills-cli',\n    names: skills.map((skill) => skill.name),\n    skills,\n  }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const name = bundledSkillName(options.name)\n  const paths = globalPaths(packageRoot, options.home, name)\n  const bundled = bundledInfo(packageRoot, name)\n  const canonicalExists = isDirectory(paths.canonical)\n  const installedVersion = canonicalExists ? readInstalledVersion(paths.canonical) : ''\n  const installedHash = canonicalExists ? skillContentHash(paths.canonical) : ''\n  const drift = driftOf({\n    exists: canonicalExists,\n    installedVersion,\n    installedHash,\n    bundledVersion: bundled.skillVersion,\n    bundledHash: bundled.contentHash,\n  })\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  const sharedState = canonicalExists ? 'ok' : 'missing'\n  return {\n    $schema: 'dingtalk-agent/skill-status@2',\n    name,\n    manager: 'skills-cli',\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      installedVersion,\n      installedHash,\n      state: drift.state,\n      comparison: drift.comparison,\n      current: drift.state === 'current',\n    },\n    claude: { path: paths.claude, ...claude },\n    clients: [\n      {\n        name: 'claude-code', label: 'Claude Code', discovery: 'symlink',\n        path: paths.claude, state: claude.state,\n      },\n      {\n        name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n      {\n        name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',\n        path: paths.canonical, state: sharedState,\n      },\n    ],\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'install', [\n    'add', globalPaths(packageRoot, undefined, bundledSkillName(options.name)).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  // Skill 随 npm 包发布；重新 add 当前包内目录，让 skills CLI 执行自己的覆盖/链接语义。\n  return runSkills(packageRoot, 'upgrade', [\n    'add', globalPaths(packageRoot, undefined, bundledSkillName(options.name)).source,\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  return runSkills(packageRoot, 'uninstall', [\n    'remove', bundledSkillName(options.name),\n    '--global', '--yes', '--agent', ...AGENTS,\n  ], options)\n}\n\nfunction runSkills(\n  packageRoot: string,\n  action: 'install' | 'upgrade' | 'uninstall',\n  args: string[],\n  options: SkillManagerOptions,\n): GlobalSkillStatus {\n  const commandArgs = [\n    '--yes', `--registry=${REGISTRY}`, `--package=${SKILLS_PACKAGE}`, '--', 'skills', ...args,\n  ]\n  const command = ['npx', ...commandArgs].map(shellQuote).join(' ')\n  const before = skillStatus(packageRoot, options)\n  const beforeState = { installedVersion: before.canonical.installedVersion, state: before.canonical.state }\n  if (options.dryRun) {\n    return {\n      ...before,\n      operation: {\n        action, command, executed: false, exitCode: null, output: '',\n        before: beforeState, after: null,\n      },\n    }\n  }\n  // 本机比包内新时覆盖就是降级；与 npm 包升级策略一致，默认拒绝。\n  if (action !== 'uninstall' && before.canonical.state === 'ahead' && !options.allowDowngrade) {\n    throw new Error(\n      `拒绝降级 ${before.name}: 本机 ${before.canonical.installedVersion} 高于包内 ` +\n      `${before.bundled.skillVersion}；确认要覆盖时加 --allow-downgrade`,\n    )\n  }\n\n  const env = {\n    ...process.env,\n    ...(options.env || {}),\n    HOME: options.home || options.env?.HOME || process.env.HOME || homedir(),\n  }\n  const run = spawnSync('npx', commandArgs, {\n    encoding: 'utf8', env, timeout: 120_000,\n  })\n  const output = [run.stdout, run.stderr].filter(Boolean).join('\\n').trim()\n  if (run.error || run.status !== 0) {\n    const reason = (run.error as NodeJS.ErrnoException | undefined)?.code === 'ENOENT'\n      ? 'PATH 找不到 npx；请安装带 npm/npx 的 Node.js 18.3+'\n      : run.error?.message || output || `退出码 ${run.status}`\n    throw new Error(\n      `skills CLI ${action} 失败: ${reason}\\n` +\n      `可手动执行: ${command}`,\n    )\n  }\n  // 退出码 0 不等于本机副本已经是目标版本；升级/安装后必须回读确认。\n  const after = skillStatus(packageRoot, options)\n  if (action !== 'uninstall' && after.canonical.state !== 'current') {\n    throw new Error(\n      `skills CLI ${action} 退出码为 0，但回读 ${after.name} 仍为 ${after.canonical.state}` +\n      `（本机 ${after.canonical.installedVersion || '未声明'} / 包内 ${after.bundled.skillVersion}）\\n` +\n      `可手动执行: ${command}`,\n    )\n  }\n  return {\n    ...after,\n    operation: {\n      action, command, executed: true, exitCode: run.status, output,\n      before: beforeState,\n      after: { installedVersion: after.canonical.installedVersion, state: after.canonical.state },\n    },\n  }\n}\n\nfunction globalPaths(packageRoot: string, home = homedir(), name = GLOBAL_SKILL_NAME) {\n  return {\n    source: bundledSkillPath(packageRoot, name),\n    canonical: join(home, '.agents', 'skills', name),\n    claude: join(home, '.claude', 'skills', name),\n  }\n}\n\nfunction bundledInfo(packageRoot: string, name: string) {\n  const source = globalPaths(packageRoot, undefined, name).source\n  validateSkill(source, name)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(source, 'SKILL.md'), 'utf8'))\n  return {\n    path: source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n    contentHash: skillContentHash(source),\n  }\n}\n\n/** 本机副本的版本号；用户手改坏格式时返回空串并由调用方降级为 unknown，不抛错。 */\nfunction readInstalledVersion(canonical: string): string {\n  try {\n    return parseSkillFrontmatter(readFileSync(join(canonical, 'SKILL.md'), 'utf8')).version\n  } catch {\n    return ''\n  }\n}\n\n/**\n * 全树内容 hash：按相对路径排序，逐个 update(相对路径 + \\0 + 内容)。\n * 它证明 references/assets 完整一致，补上\"改了正文但没 bump 版本\"这类版本号测不出的漂移。\n */\nexport function skillContentHash(root: string): string {\n  const hash = createHash('sha256')\n  for (const relative of listSkillFiles(root)) {\n    hash.update(relative)\n    hash.update('\\0')\n    hash.update(readFileSync(join(root, relative)))\n  }\n  return `sha256:${hash.digest('hex').slice(0, 16)}`\n}\n\nfunction listSkillFiles(root: string, prefix = ''): string[] {\n  const files: string[] = []\n  for (const entry of readdirSync(join(root, prefix), { withFileTypes: true })) {\n    if (entry.name === '.DS_Store' || entry.isSymbolicLink()) continue\n    const relative = prefix ? `${prefix}/${entry.name}` : entry.name\n    if (entry.isDirectory()) files.push(...listSkillFiles(root, relative))\n    else if (entry.isFile()) files.push(relative)\n  }\n  return files.sort()\n}\n\nfunction driftOf(input: {\n  exists: boolean\n  installedVersion: string\n  installedHash: string\n  bundledVersion: string\n  bundledHash: string\n}): { state: SkillDriftState; comparison: number | null } {\n  if (!input.exists) return { state: 'missing', comparison: null }\n  if (!isValidVersion(input.installedVersion)) return { state: 'unknown', comparison: null }\n  const comparison = compareVersions(input.installedVersion, input.bundledVersion)\n  if (comparison > 0) return { state: 'ahead', comparison }\n  if (comparison < 0) return { state: 'outdated', comparison }\n  return {\n    state: input.installedHash === input.bundledHash ? 'current' : 'modified',\n    comparison,\n  }\n}\n\nfunction inspectExposure(exposure: string, canonical: string): {\n  state: 'ok' | 'missing' | 'conflict'\n  target: string\n} {\n  if (!pathExists(exposure)) return { state: 'missing', target: '' }\n  const stat = lstatSync(exposure)\n  if (!stat.isSymbolicLink()) return { state: 'conflict', target: '' }\n  const raw = readlinkSync(exposure)\n  return resolve(dirname(exposure), raw) === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction validateSkill(root: string, name: string): void {\n  if (!isDirectory(root)) throw new Error(`内置 Skill 不存在: ${root}`)\n  const file = join(root, 'SKILL.md')\n  if (!existsSync(file)) throw new Error(`Skill 缺少 SKILL.md: ${root}`)\n  const metadata = parseSkillFrontmatter(readFileSync(file, 'utf8'))\n  if (metadata.name !== name) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${name} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\n  // 包内 Skill 缺版本号是仓库缺陷：没有版本就无法判断本机副本是否过期，直接 fail closed。\n  if (!metadata.version) throw new Error(`Skill 缺少 metadata.version: ${root}`)\n  cleanVersion(metadata.version)\n}\n\nfunction bundledSkillName(value = ''): string {\n  const name = value.trim() || GLOBAL_SKILL_NAME\n  if (!(INSTALLABLE_SKILL_NAMES as readonly string[]).includes(name)) {\n    throw new Error(`不支持的内置 Skill: ${name}；可用: ${INSTALLABLE_SKILL_NAMES.join(', ')}`)\n  }\n  return name\n}\n\nfunction parseSkillFrontmatter(text: string): { name: string; description: string; version: string } {\n  const match = text.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n|$)/)\n  if (!match) throw new Error('SKILL.md 缺少 YAML frontmatter')\n  const block = match[1]\n  const readScalar = (key: string) => {\n    const found = block.match(new RegExp(`^${key}:\\\\s*(.+)$`, 'm'))\n    return found ? found[1].trim().replace(/^(['\"])(.*)\\1$/, '$2') : ''\n  }\n  const nestedVersion = block.match(/^metadata:\\s*\\r?\\n(?:[ \\t]+.*\\r?\\n)*?[ \\t]+version:\\s*['\"]?([^'\"\\r\\n]+)['\"]?\\s*$/m)\n  return {\n    name: readScalar('name'),\n    description: readScalar('description'),\n    version: nestedVersion?.[1]?.trim() || readScalar('version'),\n  }\n}\n\nfunction isDirectory(path: string): boolean {\n  try { return lstatSync(path).isDirectory() } catch { return false }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction shellQuote(value: string): string {\n  return /^[A-Za-z0-9_./:=@-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n"]}

package/dist/src/upgrade.js

@@ -2,6 +2,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { delimiter, join } from 'node:path';
 import { spawnSync } from 'node:child_process';
+import { cleanVersion, compareVersions } from './version.js';
+import { skillSuiteStatus } from './skill-manager.js';
 const PACKAGE_NAME = '@xdxer/dingtalk-agent';
 const REGISTRY = 'https://registry.npmjs.org';
 export function upgradeAgent(packageRoot, options = {}) {
@@ -12,6 +14,8 @@ export function upgradeAgent(packageRoot, options = {}) {
     const prefix = options.prefix || join(home, '.local');
     const binDir = process.platform === 'win32' ? prefix : join(prefix, 'bin');
     const executable = join(binDir, process.platform === 'win32' ? 'dta.cmd' : 'dta');
+    // 升级前先冻结本机 Skill 版本，否则重装之后无从核对到底动了什么。
+    const skillsBefore = skillSuiteStatus(packageRoot, { home }).skills;
     if (options.channel && options.version) {
         throw new Error('upgrade 的 --channel 与 --version 不能同时使用');
     }
@@ -37,6 +41,14 @@ export function upgradeAgent(packageRoot, options = {}) {
             $schema: 'dingtalk-agent/upgrade@1', currentVersion, targetVersion,
             target: packageSource, prefix, executable, changed, dryRun: true,
             ready: false, setup: null,
+            skills: skillsBefore.map((item) => ({
+                name: item.name,
+                before: item.canonical.installedVersion,
+                after: null,
+                bundled: item.bundled.skillVersion,
+                state: item.canonical.state,
+                changed: item.canonical.state !== 'current',
+            })),
             commands: { install: installCommand, verify: verifyCommand },
         };
     }
@@ -82,6 +94,17 @@ export function upgradeAgent(packageRoot, options = {}) {
         target: packageSource, prefix, executable, changed, dryRun: false,
         ready: setupRun.status === 0 && setup.doctor?.ready === true,
         setup,
+        skills: skillsBefore.map((item) => {
+            const after = (setup?.skills || []).find((entry) => entry?.name === item.name);
+            return {
+                name: item.name,
+                before: item.canonical.installedVersion,
+                after: after?.canonical?.installedVersion ?? null,
+                bundled: after?.bundled?.skillVersion ?? item.bundled.skillVersion,
+                state: after?.canonical?.state ?? 'unknown',
+                changed: (after?.canonical?.installedVersion ?? '') !== item.canonical.installedVersion,
+            };
+        }),
         commands: { install: installCommand, verify: verifyCommand },
     };
 }
@@ -104,33 +127,6 @@ function resolveTargetVersion(packageSource, env) {
         return output.replace(/^['"]|['"]$/g, '');
     throw new Error(`npm view 没有返回 ${packageSource} 的版本`);
 }
-function cleanVersion(value = '') {
-    const clean = value.trim().replace(/^v/, '');
-    if (!clean)
-        return '';
-    if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(clean)) {
-        throw new Error(`非法版本号: ${value}`);
-    }
-    return clean;
-}
-function compareVersions(a, b) {
-    const parse = (value) => {
-        const [core, prerelease = ''] = value.replace(/^v/, '').split('-', 2);
-        return { core: core.split('.').map((part) => Number.parseInt(part, 10) || 0), prerelease };
-    };
-    const left = parse(a);
-    const right = parse(b);
-    for (let index = 0; index < 3; index += 1) {
-        if ((left.core[index] || 0) !== (right.core[index] || 0)) {
-            return (left.core[index] || 0) > (right.core[index] || 0) ? 1 : -1;
-        }
-    }
-    if (!left.prerelease && right.prerelease)
-        return 1;
-    if (left.prerelease && !right.prerelease)
-        return -1;
-    return left.prerelease.localeCompare(right.prerelease, undefined, { numeric: true });
-}
 function shellQuote(value) {
     return /^[A-Za-z0-9_./:=@"$-]+$/.test(value) ? value : `'${value.replace(/'/g, `'"'"'`)}'`;
 }

package/dist/src/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/upgrade.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { delimiter, join } from 'node:path'\nimport { spawnSync } from 'node:child_process'\n\nconst PACKAGE_NAME = '@xdxer/dingtalk-agent'\nconst REGISTRY = 'https://registry.npmjs.org'\n\nexport interface UpgradeOptions {\n  home?: string\n  env?: NodeJS.ProcessEnv\n  prefix?: string\n  channel?: 'beta' | 'latest'\n  version?: string\n  dryRun?: boolean\n  force?: boolean\n}\n\nexport interface UpgradeResult {\n  $schema: 'dingtalk-agent/upgrade@1'\n  currentVersion: string\n  targetVersion: string\n  target: string\n  prefix: string\n  executable: string\n  changed: boolean\n  dryRun: boolean\n  ready: boolean\n  setup: Record<string, any> | null\n  commands: { install: string; verify: string }\n}\n\nexport function upgradeAgent(packageRoot: string, options: UpgradeOptions = {}): UpgradeResult {\n  const home = options.home || homedir()\n  const env = { ...process.env, ...(options.env || {}) }\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const currentVersion = String(pkg.version || '')\n  const prefix = options.prefix || join(home, '.local')\n  const binDir = process.platform === 'win32' ? prefix : join(prefix, 'bin')\n  const executable = join(binDir, process.platform === 'win32' ? 'dta.cmd' : 'dta')\n\n  if (options.channel && options.version) {\n    throw new Error('upgrade 的 --channel 与 --version 不能同时使用')\n  }\n  const channel = options.channel || (currentVersion.includes('-') ? 'beta' : 'latest')\n  if (!['beta', 'latest'].includes(channel)) {\n    throw new Error(`不支持的升级通道: ${channel}；只能是 beta 或 latest`)\n  }\n  const requested = cleanVersion(options.version) || channel\n  const packageSource = env.DTA_UPGRADE_PACKAGE_SOURCE || `${PACKAGE_NAME}@${requested}`\n  const targetVersion = env.DTA_UPGRADE_TARGET_VERSION || resolveTargetVersion(packageSource, env)\n  if (compareVersions(targetVersion, currentVersion) < 0 && !(options.version && options.force)) {\n    throw new Error(\n      `升级目标 ${targetVersion} 低于当前版本 ${currentVersion}，拒绝自动降级；` +\n      '如确需降级，请同时使用 --version 与 --force',\n    )\n  }\n  const installArgs = [\n    'install', '--global', '--prefix', prefix, '--registry', REGISTRY, packageSource,\n  ]\n  const installCommand = ['npm', ...installArgs].map(shellQuote).join(' ')\n  const verifyCommand = `${shellQuote(executable)} setup --skip-cli-install`\n  const changed = options.force || targetVersion !== currentVersion\n\n  if (options.dryRun) {\n    return {\n      $schema: 'dingtalk-agent/upgrade@1', currentVersion, targetVersion,\n      target: packageSource, prefix, executable, changed, dryRun: true,\n      ready: false, setup: null,\n      commands: { install: installCommand, verify: verifyCommand },\n    }\n  }\n\n  if (changed) {\n    const install = spawnSync('npm', installArgs, { encoding: 'utf8', env, timeout: 120_000 })\n    const output = [install.stdout, install.stderr].filter(Boolean).join('\\n').trim()\n    if (install.error || install.status !== 0) {\n      throw new Error(\n        `CLI 升级失败: ${install.error?.message || output || `退出码 ${install.status}`}\\n` +\n        `可手动执行: ${installCommand}`,\n      )\n    }\n  }\n  if (!existsSync(executable)) {\n    throw new Error(`npm 升级完成但找不到新 CLI: ${executable}\\n可手动执行: ${installCommand}`)\n  }\n  const effectiveEnv = {\n    ...env,\n    HOME: home,\n    PATH: [binDir, env.PATH || ''].filter(Boolean).join(delimiter),\n  }\n  const versionRun = spawnSync(executable, ['--version'], {\n    encoding: 'utf8', env: effectiveEnv, timeout: 8_000,\n  })\n  const installedVersion = String(versionRun.stdout || '').trim()\n  if (versionRun.status !== 0 || installedVersion !== targetVersion) {\n    throw new Error(\n      `新 CLI 版本校验失败: expected=${targetVersion}, actual=${installedVersion || 'unknown'}\\n` +\n      `可重试: ${installCommand}`,\n    )\n  }\n  const setupRun = spawnSync(executable, ['setup', '--skip-cli-install', '--json'], {\n    encoding: 'utf8', env: effectiveEnv, timeout: 180_000,\n  })\n  let setup: Record<string, any> | null = null\n  try { setup = setupRun.stdout ? JSON.parse(setupRun.stdout) : null } catch { /* reported below */ }\n  if (!setup) {\n    throw new Error(\n      `CLI 已升级到 ${installedVersion}，但 setup 输出无法解析: ` +\n      `${String(setupRun.stderr || setupRun.stdout).trim() || `退出码 ${setupRun.status}`}\\n` +\n      `可手动执行: ${verifyCommand}`,\n    )\n  }\n  return {\n    $schema: 'dingtalk-agent/upgrade@1', currentVersion, targetVersion,\n    target: packageSource, prefix, executable, changed, dryRun: false,\n    ready: setupRun.status === 0 && setup.doctor?.ready === true,\n    setup,\n    commands: { install: installCommand, verify: verifyCommand },\n  }\n}\n\nfunction resolveTargetVersion(packageSource: string, env: NodeJS.ProcessEnv): string {\n  const run = spawnSync('npm', ['view', packageSource, 'version', '--json', '--registry', REGISTRY], {\n    encoding: 'utf8', env, timeout: 30_000,\n  })\n  const output = String(run.stdout || '').trim()\n  if (run.error || run.status !== 0) {\n    throw new Error(\n      `无法解析升级目标 ${packageSource}: ` +\n      `${run.error?.message || String(run.stderr || '').trim() || `退出码 ${run.status}`}`,\n    )\n  }\n  try {\n    const value = JSON.parse(output)\n    if (typeof value === 'string' && value) return value\n  } catch { /* fall through */ }\n  if (output) return output.replace(/^['\"]|['\"]$/g, '')\n  throw new Error(`npm view 没有返回 ${packageSource} 的版本`)\n}\n\nfunction cleanVersion(value = ''): string {\n  const clean = value.trim().replace(/^v/, '')\n  if (!clean) return ''\n  if (!/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/.test(clean)) {\n    throw new Error(`非法版本号: ${value}`)\n  }\n  return clean\n}\n\nfunction compareVersions(a: string, b: string): number {\n  const parse = (value: string) => {\n    const [core, prerelease = ''] = value.replace(/^v/, '').split('-', 2)\n    return { core: core.split('.').map((part) => Number.parseInt(part, 10) || 0), prerelease }\n  }\n  const left = parse(a)\n  const right = parse(b)\n  for (let index = 0; index < 3; index += 1) {\n    if ((left.core[index] || 0) !== (right.core[index] || 0)) {\n      return (left.core[index] || 0) > (right.core[index] || 0) ? 1 : -1\n    }\n  }\n  if (!left.prerelease && right.prerelease) return 1\n  if (left.prerelease && !right.prerelease) return -1\n  return left.prerelease.localeCompare(right.prerelease, undefined, { numeric: true })\n}\n\nfunction shellQuote(value: string): string {\n  return /^[A-Za-z0-9_./:=@\"$-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n"]}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/upgrade.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { delimiter, join } from 'node:path'\nimport { spawnSync } from 'node:child_process'\nimport { cleanVersion, compareVersions } from './version.js'\nimport { skillSuiteStatus } from './skill-manager.js'\n\nconst PACKAGE_NAME = '@xdxer/dingtalk-agent'\nconst REGISTRY = 'https://registry.npmjs.org'\n\nexport interface UpgradeOptions {\n  home?: string\n  env?: NodeJS.ProcessEnv\n  prefix?: string\n  channel?: 'beta' | 'latest'\n  version?: string\n  dryRun?: boolean\n  force?: boolean\n}\n\nexport interface UpgradeResult {\n  $schema: 'dingtalk-agent/upgrade@1'\n  currentVersion: string\n  targetVersion: string\n  target: string\n  prefix: string\n  executable: string\n  changed: boolean\n  dryRun: boolean\n  ready: boolean\n  setup: Record<string, any> | null\n  skills: UpgradeSkillReport[]\n  commands: { install: string; verify: string }\n}\n\n/** 升级前后各 Skill 的版本核对；`after` 为 null 表示 dry-run 尚未执行。 */\nexport interface UpgradeSkillReport {\n  name: string\n  before: string\n  after: string | null\n  bundled: string\n  state: string\n  changed: boolean\n}\n\nexport function upgradeAgent(packageRoot: string, options: UpgradeOptions = {}): UpgradeResult {\n  const home = options.home || homedir()\n  const env = { ...process.env, ...(options.env || {}) }\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const currentVersion = String(pkg.version || '')\n  const prefix = options.prefix || join(home, '.local')\n  const binDir = process.platform === 'win32' ? prefix : join(prefix, 'bin')\n  const executable = join(binDir, process.platform === 'win32' ? 'dta.cmd' : 'dta')\n  // 升级前先冻结本机 Skill 版本，否则重装之后无从核对到底动了什么。\n  const skillsBefore = skillSuiteStatus(packageRoot, { home }).skills\n\n  if (options.channel && options.version) {\n    throw new Error('upgrade 的 --channel 与 --version 不能同时使用')\n  }\n  const channel = options.channel || (currentVersion.includes('-') ? 'beta' : 'latest')\n  if (!['beta', 'latest'].includes(channel)) {\n    throw new Error(`不支持的升级通道: ${channel}；只能是 beta 或 latest`)\n  }\n  const requested = cleanVersion(options.version) || channel\n  const packageSource = env.DTA_UPGRADE_PACKAGE_SOURCE || `${PACKAGE_NAME}@${requested}`\n  const targetVersion = env.DTA_UPGRADE_TARGET_VERSION || resolveTargetVersion(packageSource, env)\n  if (compareVersions(targetVersion, currentVersion) < 0 && !(options.version && options.force)) {\n    throw new Error(\n      `升级目标 ${targetVersion} 低于当前版本 ${currentVersion}，拒绝自动降级；` +\n      '如确需降级，请同时使用 --version 与 --force',\n    )\n  }\n  const installArgs = [\n    'install', '--global', '--prefix', prefix, '--registry', REGISTRY, packageSource,\n  ]\n  const installCommand = ['npm', ...installArgs].map(shellQuote).join(' ')\n  const verifyCommand = `${shellQuote(executable)} setup --skip-cli-install`\n  const changed = options.force || targetVersion !== currentVersion\n\n  if (options.dryRun) {\n    return {\n      $schema: 'dingtalk-agent/upgrade@1', currentVersion, targetVersion,\n      target: packageSource, prefix, executable, changed, dryRun: true,\n      ready: false, setup: null,\n      skills: skillsBefore.map((item) => ({\n        name: item.name,\n        before: item.canonical.installedVersion,\n        after: null,\n        bundled: item.bundled.skillVersion,\n        state: item.canonical.state,\n        changed: item.canonical.state !== 'current',\n      })),\n      commands: { install: installCommand, verify: verifyCommand },\n    }\n  }\n\n  if (changed) {\n    const install = spawnSync('npm', installArgs, { encoding: 'utf8', env, timeout: 120_000 })\n    const output = [install.stdout, install.stderr].filter(Boolean).join('\\n').trim()\n    if (install.error || install.status !== 0) {\n      throw new Error(\n        `CLI 升级失败: ${install.error?.message || output || `退出码 ${install.status}`}\\n` +\n        `可手动执行: ${installCommand}`,\n      )\n    }\n  }\n  if (!existsSync(executable)) {\n    throw new Error(`npm 升级完成但找不到新 CLI: ${executable}\\n可手动执行: ${installCommand}`)\n  }\n  const effectiveEnv = {\n    ...env,\n    HOME: home,\n    PATH: [binDir, env.PATH || ''].filter(Boolean).join(delimiter),\n  }\n  const versionRun = spawnSync(executable, ['--version'], {\n    encoding: 'utf8', env: effectiveEnv, timeout: 8_000,\n  })\n  const installedVersion = String(versionRun.stdout || '').trim()\n  if (versionRun.status !== 0 || installedVersion !== targetVersion) {\n    throw new Error(\n      `新 CLI 版本校验失败: expected=${targetVersion}, actual=${installedVersion || 'unknown'}\\n` +\n      `可重试: ${installCommand}`,\n    )\n  }\n  const setupRun = spawnSync(executable, ['setup', '--skip-cli-install', '--json'], {\n    encoding: 'utf8', env: effectiveEnv, timeout: 180_000,\n  })\n  let setup: Record<string, any> | null = null\n  try { setup = setupRun.stdout ? JSON.parse(setupRun.stdout) : null } catch { /* reported below */ }\n  if (!setup) {\n    throw new Error(\n      `CLI 已升级到 ${installedVersion}，但 setup 输出无法解析: ` +\n      `${String(setupRun.stderr || setupRun.stdout).trim() || `退出码 ${setupRun.status}`}\\n` +\n      `可手动执行: ${verifyCommand}`,\n    )\n  }\n  return {\n    $schema: 'dingtalk-agent/upgrade@1', currentVersion, targetVersion,\n    target: packageSource, prefix, executable, changed, dryRun: false,\n    ready: setupRun.status === 0 && setup.doctor?.ready === true,\n    setup,\n    skills: skillsBefore.map((item) => {\n      const after = (setup?.skills || []).find((entry: any) => entry?.name === item.name)\n      return {\n        name: item.name,\n        before: item.canonical.installedVersion,\n        after: after?.canonical?.installedVersion ?? null,\n        bundled: after?.bundled?.skillVersion ?? item.bundled.skillVersion,\n        state: after?.canonical?.state ?? 'unknown',\n        changed: (after?.canonical?.installedVersion ?? '') !== item.canonical.installedVersion,\n      }\n    }),\n    commands: { install: installCommand, verify: verifyCommand },\n  }\n}\n\nfunction resolveTargetVersion(packageSource: string, env: NodeJS.ProcessEnv): string {\n  const run = spawnSync('npm', ['view', packageSource, 'version', '--json', '--registry', REGISTRY], {\n    encoding: 'utf8', env, timeout: 30_000,\n  })\n  const output = String(run.stdout || '').trim()\n  if (run.error || run.status !== 0) {\n    throw new Error(\n      `无法解析升级目标 ${packageSource}: ` +\n      `${run.error?.message || String(run.stderr || '').trim() || `退出码 ${run.status}`}`,\n    )\n  }\n  try {\n    const value = JSON.parse(output)\n    if (typeof value === 'string' && value) return value\n  } catch { /* fall through */ }\n  if (output) return output.replace(/^['\"]|['\"]$/g, '')\n  throw new Error(`npm view 没有返回 ${packageSource} 的版本`)\n}\n\nfunction shellQuote(value: string): string {\n  return /^[A-Za-z0-9_./:=@\"$-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n"]}

package/dist/src/version.js

@@ -0,0 +1,73 @@
+// 版本号解析与比较。npm 包版本与 Skill frontmatter 版本共用同一实现，避免两套排序规则。
+// 比较结果只用于报告与门禁，不用于跳过执行：安装/升级始终由上游 skills CLI 无条件覆盖。
+/** 归一化版本号；空串表示"未声明"，非法格式直接抛错。 */
+export function cleanVersion(value = '') {
+    const clean = value.trim().replace(/^v/, '');
+    if (!clean)
+        return '';
+    if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(clean)) {
+        throw new Error(`非法版本号: ${value}`);
+    }
+    return clean;
+}
+/** 版本号是否合法且非空。用于把"用户手改坏了"与"格式正确"分开处理。 */
+export function isValidVersion(value = '') {
+    try {
+        return Boolean(cleanVersion(value));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * semver 比较：core 三段按数值，prerelease 按 dot-identifier 逐段。
+ * 数字段按数值比较，数字段低于非数字段，段数少者在前缀相同时更小（semver §11）。
+ */
+export function compareVersions(a, b) {
+    const parse = (value) => {
+        const [core, prerelease = ''] = value.replace(/^v/, '').split('-', 2);
+        return { core: core.split('.').map((part) => Number.parseInt(part, 10) || 0), prerelease };
+    };
+    const left = parse(a);
+    const right = parse(b);
+    for (let index = 0; index < 3; index += 1) {
+        if ((left.core[index] || 0) !== (right.core[index] || 0)) {
+            return (left.core[index] || 0) > (right.core[index] || 0) ? 1 : -1;
+        }
+    }
+    // 有 prerelease 者小于无 prerelease 者。
+    if (!left.prerelease && right.prerelease)
+        return 1;
+    if (left.prerelease && !right.prerelease)
+        return -1;
+    if (!left.prerelease && !right.prerelease)
+        return 0;
+    return comparePrerelease(left.prerelease, right.prerelease);
+}
+function comparePrerelease(a, b) {
+    const left = a.split('.');
+    const right = b.split('.');
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const l = left[index];
+        const r = right[index];
+        if (l === undefined)
+            return -1;
+        if (r === undefined)
+            return 1;
+        const lNumeric = /^\d+$/.test(l);
+        const rNumeric = /^\d+$/.test(r);
+        if (lNumeric && rNumeric) {
+            const diff = Number.parseInt(l, 10) - Number.parseInt(r, 10);
+            if (diff !== 0)
+                return diff > 0 ? 1 : -1;
+            continue;
+        }
+        // 数字段永远低于非数字段。
+        if (lNumeric !== rNumeric)
+            return lNumeric ? -1 : 1;
+        if (l !== r)
+            return l > r ? 1 : -1;
+    }
+    return 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,oDAAoD;AAEpD,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,EAAE;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,cAAc,CAAC,KAAK,GAAG,EAAE;IACvC,IAAI,CAAC;QAAC,OAAO,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACrE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAA;IAC5F,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IACD,kCAAkC;IAClC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,CAAA;IAClD,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,CAAA;IACnD,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,CAAA;IACnD,OAAO,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;AAC7D,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS,EAAE,CAAS;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACzB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACrB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QACtB,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChC,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5D,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YACxC,SAAQ;QACV,CAAC;QACD,eAAe;QACf,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC","sourcesContent":["// 版本号解析与比较。npm 包版本与 Skill frontmatter 版本共用同一实现，避免两套排序规则。\n// 比较结果只用于报告与门禁，不用于跳过执行：安装/升级始终由上游 skills CLI 无条件覆盖。\n\n/** 归一化版本号；空串表示\"未声明\"，非法格式直接抛错。 */\nexport function cleanVersion(value = ''): string {\n  const clean = value.trim().replace(/^v/, '')\n  if (!clean) return ''\n  if (!/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/.test(clean)) {\n    throw new Error(`非法版本号: ${value}`)\n  }\n  return clean\n}\n\n/** 版本号是否合法且非空。用于把\"用户手改坏了\"与\"格式正确\"分开处理。 */\nexport function isValidVersion(value = ''): boolean {\n  try { return Boolean(cleanVersion(value)) } catch { return false }\n}\n\n/**\n * semver 比较：core 三段按数值，prerelease 按 dot-identifier 逐段。\n * 数字段按数值比较，数字段低于非数字段，段数少者在前缀相同时更小（semver §11）。\n */\nexport function compareVersions(a: string, b: string): number {\n  const parse = (value: string) => {\n    const [core, prerelease = ''] = value.replace(/^v/, '').split('-', 2)\n    return { core: core.split('.').map((part) => Number.parseInt(part, 10) || 0), prerelease }\n  }\n  const left = parse(a)\n  const right = parse(b)\n  for (let index = 0; index < 3; index += 1) {\n    if ((left.core[index] || 0) !== (right.core[index] || 0)) {\n      return (left.core[index] || 0) > (right.core[index] || 0) ? 1 : -1\n    }\n  }\n  // 有 prerelease 者小于无 prerelease 者。\n  if (!left.prerelease && right.prerelease) return 1\n  if (left.prerelease && !right.prerelease) return -1\n  if (!left.prerelease && !right.prerelease) return 0\n  return comparePrerelease(left.prerelease, right.prerelease)\n}\n\nfunction comparePrerelease(a: string, b: string): number {\n  const left = a.split('.')\n  const right = b.split('.')\n  for (let index = 0; index < Math.max(left.length, right.length); index += 1) {\n    const l = left[index]\n    const r = right[index]\n    if (l === undefined) return -1\n    if (r === undefined) return 1\n    const lNumeric = /^\\d+$/.test(l)\n    const rNumeric = /^\\d+$/.test(r)\n    if (lNumeric && rNumeric) {\n      const diff = Number.parseInt(l, 10) - Number.parseInt(r, 10)\n      if (diff !== 0) return diff > 0 ? 1 : -1\n      continue\n    }\n    // 数字段永远低于非数字段。\n    if (lNumeric !== rNumeric) return lNumeric ? -1 : 1\n    if (l !== r) return l > r ? 1 : -1\n  }\n  return 0\n}\n"]}