npm - @xdxer/dingtalk-agent - Versions diffs - 0.1.4-beta.9 → 0.1.5-beta.1 - Mend

@xdxer/dingtalk-agent 0.1.4-beta.9 → 0.1.5-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (129) hide show

package/dist/src/skill-manager.js CHANGED Viewed

@@ -1,22 +1,73 @@
 // Skill 安装生命周期由开放生态的 `npx skills` 负责。
 // dingtalk-agent 只做两件事：把内置 Skill 目录交给上游 CLI；只读验证客户端能否发现。
-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';
-export const BUNDLED_SKILL_NAMES = [GLOBAL_SKILL_NAME, 'dingtalk-agent-compose'];
+// 默认套装：所有机器都装的通用 Skill。平台 Skill（deploy/boot-multica 等）不在默认套装内，
+// 只有工作区通过 `dta agent-platform use` 选择对应 managed agent platform 时才按名安装。
+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',
+];
+// 仓库/包内的 Skill 源码路径注册表：core 为通用套装，platforms/<platform> 按平台装填。
+// 安装后的 canonical 布局仍是扁平的 ~/.agents/skills/<name>；分层只存在于包内。
+const BUNDLED_SKILL_DIRS = {
+    'dingtalk-basic-behavior': 'skills/core/dingtalk-basic-behavior',
+    'dingtalk-agent-compose': 'skills/core/dingtalk-agent-compose',
+    'dingtalk-agent-eval': 'skills/core/dingtalk-agent-eval',
+    'dingtalk-agent-deploy-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-deploy-multica',
+    'dingtalk-agent-boot-multica': 'skills/platforms/multica-dingtalk/dingtalk-agent-boot-multica',
+    'multica-external': 'skills/platforms/multica-dingtalk/multica-external',
+};
+/** 解析包内 Skill 源码目录；未注册的名字回退到历史扁平布局。 */
+export function bundledSkillPath(packageRoot, name) {
+    return join(packageRoot, BUNDLED_SKILL_DIRS[name] || join('skills', name));
+}
 const SKILLS_PACKAGE = 'skills@latest';
 const REGISTRY = 'https://registry.npmjs.org';
 const AGENTS = ['claude-code', 'codex', 'opencode'];
+export function skillSuiteStatus(packageRoot, options = {}) {
+    return suiteOf(BUNDLED_SKILL_NAMES.map((name) => skillStatus(packageRoot, { ...options, name })));
+}
+export function installBundledSkills(packageRoot, options = {}) {
+    return suiteOf(BUNDLED_SKILL_NAMES.map((name) => installGlobalSkill(packageRoot, { ...options, name })));
+}
+export function upgradeBundledSkills(packageRoot, options = {}) {
+    return suiteOf(BUNDLED_SKILL_NAMES.map((name) => upgradeGlobalSkill(packageRoot, { ...options, name })));
+}
+export function uninstallBundledSkills(packageRoot, options = {}) {
+    return suiteOf(BUNDLED_SKILL_NAMES.map((name) => uninstallGlobalSkill(packageRoot, { ...options, name })));
+}
+function suiteOf(skills) {
+    return {
+        $schema: 'dingtalk-agent/skill-status-suite@1',
+        manager: 'skills-cli',
+        names: skills.map((skill) => skill.name),
+        skills,
+    };
+}
 export function skillStatus(packageRoot, options = {}) {
     const name = bundledSkillName(options.name);
     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 {
@@ -28,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: [
@@ -72,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 || {}),
@@ -94,14 +157,25 @@ 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) {
     return {
-        source: join(packageRoot, 'skills', name),
+        source: bundledSkillPath(packageRoot, name),
         canonical: join(home, '.agents', 'skills', name),
         claude: join(home, '.claude', 'skills', name),
     };
@@ -115,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) {
@@ -140,11 +265,15 @@ 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;
-    if (!BUNDLED_SKILL_NAMES.includes(name)) {
-        throw new Error(`不支持的内置 Skill: ${name}；可用: ${BUNDLED_SKILL_NAMES.join(', ')}`);
+    if (!INSTALLABLE_SKILL_NAMES.includes(name)) {
+        throw new Error(`不支持的内置 Skill: ${name}；可用: ${INSTALLABLE_SKILL_NAMES.join(', ')}`);
     }
     return name;
 }

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

	@@ -1 +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\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'\nexport const BUNDLED_SKILL_NAMES = [GLOBAL_SKILL_NAME, 'dingtalk-agent-compose'] as const\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 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: join(packageRoot, 'skills', 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 (!(BUNDLED_SKILL_NAMES as readonly string[]).includes(name)) {\n throw new Error(`不支持的内置 Skill: ${name}；可用: ${BUNDLED_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"]}
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, 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/skills.js CHANGED Viewed

@@ -5,6 +5,7 @@ import { homedir } from 'node:os';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { digest, stableStringify } from './events.js';
 import { resolvePackageRoot } from './package-root.js';
+import { bundledSkillPath } from './skill-manager.js';
 const PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
 const INSTALL_MARKER = '.dingtalk-agent-install.json';
 export function snapshotSkills(root, runPath, sources, sessionPath) {
@@ -163,7 +164,7 @@ function resolveSkillSource(rootReal, sourceSpec) {
         [`global:${spec}`, join(homedir(), '.agents', 'skills', spec)],
         [`claude:${spec}`, join(homedir(), '.claude', 'skills', spec)],
         [`legacy-codex:${spec}`, join(homedir(), '.codex', 'skills', spec)],
-        [`bundled:${spec}`, join(PACKAGE_ROOT, 'skills', spec)],
+        [`bundled:${spec}`, bundledSkillPath(PACKAGE_ROOT, spec)],
     ];
     for (const [label, candidate] of candidates) {
         if (!existsSync(candidate) || !lstatSync(candidate).isDirectory())

package/dist/src/skills.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"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","sourcesContent":["// 把本次 Run 要遵守的 Agent Skill 冻结进沙箱（TypeScript source）。\n// 运行中的 Run 永不热加载工作区后来修改的规则；重放时只认快照与 hash。\n\nimport {\n copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync,\n realpathSync, rmSync, writeFileSync,\n} from 'node:fs'\nimport { homedir } from 'node:os'\nimport { basename, dirname, join, relative, resolve } from 'node:path'\nimport { digest, stableStringify } from './events.js'\nimport { resolvePackageRoot } from './package-root.js'\n\nconst PACKAGE_ROOT = resolvePackageRoot(import.meta.url)\nconst INSTALL_MARKER = '.dingtalk-agent-install.json'\n\nexport interface SkillManifestEntry {\n name: string\n description: string\n version: string\n sourcePath: string\n snapshotPath: string\n hash: string\n files: number\n}\n\nexport interface SkillManifest {\n $schema: string\n entries: SkillManifestEntry[]\n hash: string\n}\n\nexport function snapshotSkills(\n root: string,\n runPath: string,\n sources: string[],\n sessionPath: string,\n): SkillManifest {\n if (!Array.isArray(sources) \|\| !sources.length \|\| sources.some((x) => typeof x !== 'string')) {\n throw new Error('Workspace skills 必须是非空 string[]')\n }\n\n const rootReal = realpathSync(resolve(root))\n const snapshotRoot = join(sessionPath, 'skills')\n const existingManifest = join(snapshotRoot, 'manifest.json')\n if (existsSync(existingManifest)) {\n const manifest = verifySnapshotRoot(snapshotRoot)\n copySessionSnapshot(snapshotRoot, runPath)\n return manifest\n }\n rmSync(snapshotRoot, { recursive: true, force: true })\n mkdirSync(snapshotRoot, { recursive: true })\n\n const entries: SkillManifestEntry[] = []\n const names = new Set()\n for (const sourceSpec of sources) {\n const resolved = resolveSkillSource(rootReal, sourceSpec)\n const source = resolved.path\n const skillFile = join(source, 'SKILL.md')\n if (!existsSync(skillFile)) throw new Error(`Agent Skill 缺少 SKILL.md: ${sourceSpec}`)\n\n const metadata = parseFrontmatter(readFileSync(skillFile, 'utf8'), sourceSpec)\n const name = metadata.name \|\| basename(source)\n if (names.has(name)) throw new Error(`Workspace skills 出现重复 Skill name: ${name}`)\n names.add(name)\n\n const files = walk(source)\n const contentIndex = files.map((path) => {\n const rel = relative(source, path).split('\\\\').join('/')\n return { path: rel, hash: digest(readFileSync(path).toString('base64')) }\n })\n const hash = digest(stableStringify(contentIndex))\n const destination = join(snapshotRoot, name)\n for (const path of files) {\n const rel = relative(source, path)\n const out = join(destination, rel)\n mkdirSync(dirname(out), { recursive: true })\n copyFileSync(path, out)\n }\n entries.push({\n name,\n description: metadata.description \|\| '',\n version: metadata.version \|\| '',\n sourcePath: resolved.label,\n snapshotPath: `context/skills/${name}/SKILL.md`,\n hash,\n files: contentIndex.length,\n })\n }\n\n const unsigned = {\n $schema: 'dingtalk-agent/skill-snapshot-manifest@1',\n entries,\n }\n const manifest: SkillManifest = {\n ...unsigned,\n hash: digest(stableStringify(unsigned)),\n }\n writeFileSync(join(snapshotRoot, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\\n')\n copySessionSnapshot(snapshotRoot, runPath)\n return manifest\n}\n\nexport function verifySkillSnapshot(runPath, expectedManifestHash) {\n const snapshotRoot = join(runPath, 'context', 'skills')\n return verifySnapshotRoot(snapshotRoot, expectedManifestHash)\n}\n\nfunction copySessionSnapshot(snapshotRoot: string, runPath: string): void {\n const runSnapshotRoot = join(runPath, 'context', 'skills')\n rmSync(runSnapshotRoot, { recursive: true, force: true })\n cpSync(snapshotRoot, runSnapshotRoot, { recursive: true })\n}\n\nfunction verifySnapshotRoot(snapshotRoot: string, expectedManifestHash = ''): SkillManifest {\n const manifestPath = join(snapshotRoot, 'manifest.json')\n if (!existsSync(manifestPath)) throw new Error('Skill snapshot 缺少 manifest.json')\n const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as SkillManifest\n const { hash, ...unsigned } = manifest\n const actualManifestHash = digest(stableStringify(unsigned))\n if (!hash \|\| hash !== actualManifestHash \|\|\n (expectedManifestHash && hash !== expectedManifestHash)) {\n throw new Error('Skill snapshot manifest hash 不一致')\n }\n if (!Array.isArray(manifest.entries) \|\| !manifest.entries.length) {\n throw new Error('Skill snapshot manifest 没有 entries')\n }\n for (const entry of manifest.entries) {\n const skillRoot = resolve(snapshotRoot, entry.name)\n assertInside(realpathSync(snapshotRoot), realpathSync(skillRoot), `Skill snapshot ${entry.name}`)\n const files = walk(skillRoot)\n const contentIndex = files.map((path) => ({\n path: relative(skillRoot, path).split('\\\\').join('/'),\n hash: digest(readFileSync(path).toString('base64')),\n }))\n if (contentIndex.length !== entry.files \|\| digest(stableStringify(contentIndex)) !== entry.hash) {\n throw new Error(`Skill snapshot 内容漂移: ${entry.name}`)\n }\n }\n return manifest\n}\n\nfunction walk(dir): string[] {\n const out: string[] = []\n for (const name of readdirSync(dir).sort()) {\n // 安装管理元数据不是 Skill 内容，不进入 Session 快照。\n if (name === INSTALL_MARKER) continue\n const path = join(dir, name)\n const stat = lstatSync(path)\n if (stat.isSymbolicLink()) throw new Error(`Agent Skill 不允许符号链接: ${path}`)\n if (stat.isDirectory()) out.push(...walk(path))\n else if (stat.isFile()) out.push(path)\n }\n return out\n}\n\nfunction parseFrontmatter(text, label): Record<string, string> {\n const match = text.match(/^---\\r?\\n([\\s\\S]?)\\r?\\n---(?:\\r?\\n\|$)/)\n if (!match) throw new Error(`Agent Skill ${label}/SKILL.md 缺少 YAML frontmatter`)\n const out: Record<string, string> = {}\n for (const line of match[1].split(/\\r?\\n/)) {\n const m = line.match(/^([A-Za-z][A-Za-z0-9_-]):\\s(.)$/)\n if (!m) continue\n out[m[1]] = m[2].trim().replace(/^(['\"])(.)\\1$/, '$2')\n }\n if (!out.name \|\| !out.description) {\n throw new Error(`Agent Skill ${label}/SKILL.md frontmatter 必须含 name 和 description`)\n }\n const nestedVersion = match[1].match(\n /^metadata:\\s\\r?\\n(?:[ \\t]+.\\r?\\n)?[ \\t]+version:\\s['\"]?([^'\"\\r\\n]+)['\"]?\\s$/m,\n )\n if (nestedVersion?.[1]) out.version = nestedVersion[1].trim()\n return out\n}\n\nfunction resolveSkillSource(rootReal: string, sourceSpec: string): {\n path: string\n label: string\n} {\n const spec = String(sourceSpec \|\| '').trim()\n if (!spec) throw new Error('Workspace Skill name 不能为空')\n\n // 显式路径只允许当前 Workspace 内，保留旧 workspace@1 兼容。\n if (spec.includes('/') \|\| spec.includes('\\\\') \|\| spec.startsWith('.')) {\n const candidate = resolve(rootReal, spec)\n if (!existsSync(candidate) \|\| !lstatSync(candidate).isDirectory()) {\n throw new Error(`Agent Skill 不存在或不是目录: ${sourceSpec}`)\n }\n const actual = realpathSync(candidate)\n assertInside(rootReal, actual, `Agent Skill ${sourceSpec}`)\n return { path: actual, label: spec }\n }\n\n // bare name 的优先级：Workspace override → canonical global → client exposure\n // → npm 内置。Session 创建后仍会冻结，运行中不会热切换。\n const candidates: Array<[string, string]> = [\n [`workspace:${spec}`, join(rootReal, 'skills', spec)],\n [`global:${spec}`, join(homedir(), '.agents', 'skills', spec)],\n [`claude:${spec}`, join(homedir(), '.claude', 'skills', spec)],\n [`legacy-codex:${spec}`, join(homedir(), '.codex', 'skills', spec)],\n [`bundled:${spec}`, join(PACKAGE_ROOT, 'skills', spec)],\n ]\n for (const [label, candidate] of candidates) {\n if (!existsSync(candidate) \|\| !lstatSync(candidate).isDirectory()) continue\n const actual = realpathSync(candidate)\n if (!isInsideKnownSkillRoot(actual, rootReal)) continue\n return { path: actual, label }\n }\n throw new Error(`找不到 Agent Skill: ${spec}；请运行 dingtalk-agent skill install`)\n}\n\nfunction isInsideKnownSkillRoot(path: string, rootReal: string): boolean {\n const roots = [\n join(rootReal, 'skills'),\n join(homedir(), '.agents', 'skills'),\n join(homedir(), '.claude', 'skills'),\n join(homedir(), '.codex', 'skills'),\n join(PACKAGE_ROOT, 'skills'),\n ]\n return roots.some((root) => {\n if (!existsSync(root)) return false\n const actualRoot = realpathSync(root)\n const rel = relative(actualRoot, path)\n return rel !== '..' && !rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`)\n })\n}\n\nfunction assertInside(root, path, label) {\n const rel = relative(root, path)\n if (rel === '..' \|\| rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`) \|\| resolve(root, rel) !== path) {\n throw new Error(`${label} 必须位于当前工作区内`)\n }\n}\n"]}
1	+ {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"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","sourcesContent":["// 把本次 Run 要遵守的 Agent Skill 冻结进沙箱（TypeScript source）。\n// 运行中的 Run 永不热加载工作区后来修改的规则；重放时只认快照与 hash。\n\nimport {\n copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync,\n realpathSync, rmSync, writeFileSync,\n} from 'node:fs'\nimport { homedir } from 'node:os'\nimport { basename, dirname, join, relative, resolve } from 'node:path'\nimport { digest, stableStringify } from './events.js'\nimport { resolvePackageRoot } from './package-root.js'\nimport { bundledSkillPath } from './skill-manager.js'\n\nconst PACKAGE_ROOT = resolvePackageRoot(import.meta.url)\nconst INSTALL_MARKER = '.dingtalk-agent-install.json'\n\nexport interface SkillManifestEntry {\n name: string\n description: string\n version: string\n sourcePath: string\n snapshotPath: string\n hash: string\n files: number\n}\n\nexport interface SkillManifest {\n $schema: string\n entries: SkillManifestEntry[]\n hash: string\n}\n\nexport function snapshotSkills(\n root: string,\n runPath: string,\n sources: string[],\n sessionPath: string,\n): SkillManifest {\n if (!Array.isArray(sources) \|\| !sources.length \|\| sources.some((x) => typeof x !== 'string')) {\n throw new Error('Workspace skills 必须是非空 string[]')\n }\n\n const rootReal = realpathSync(resolve(root))\n const snapshotRoot = join(sessionPath, 'skills')\n const existingManifest = join(snapshotRoot, 'manifest.json')\n if (existsSync(existingManifest)) {\n const manifest = verifySnapshotRoot(snapshotRoot)\n copySessionSnapshot(snapshotRoot, runPath)\n return manifest\n }\n rmSync(snapshotRoot, { recursive: true, force: true })\n mkdirSync(snapshotRoot, { recursive: true })\n\n const entries: SkillManifestEntry[] = []\n const names = new Set()\n for (const sourceSpec of sources) {\n const resolved = resolveSkillSource(rootReal, sourceSpec)\n const source = resolved.path\n const skillFile = join(source, 'SKILL.md')\n if (!existsSync(skillFile)) throw new Error(`Agent Skill 缺少 SKILL.md: ${sourceSpec}`)\n\n const metadata = parseFrontmatter(readFileSync(skillFile, 'utf8'), sourceSpec)\n const name = metadata.name \|\| basename(source)\n if (names.has(name)) throw new Error(`Workspace skills 出现重复 Skill name: ${name}`)\n names.add(name)\n\n const files = walk(source)\n const contentIndex = files.map((path) => {\n const rel = relative(source, path).split('\\\\').join('/')\n return { path: rel, hash: digest(readFileSync(path).toString('base64')) }\n })\n const hash = digest(stableStringify(contentIndex))\n const destination = join(snapshotRoot, name)\n for (const path of files) {\n const rel = relative(source, path)\n const out = join(destination, rel)\n mkdirSync(dirname(out), { recursive: true })\n copyFileSync(path, out)\n }\n entries.push({\n name,\n description: metadata.description \|\| '',\n version: metadata.version \|\| '',\n sourcePath: resolved.label,\n snapshotPath: `context/skills/${name}/SKILL.md`,\n hash,\n files: contentIndex.length,\n })\n }\n\n const unsigned = {\n $schema: 'dingtalk-agent/skill-snapshot-manifest@1',\n entries,\n }\n const manifest: SkillManifest = {\n ...unsigned,\n hash: digest(stableStringify(unsigned)),\n }\n writeFileSync(join(snapshotRoot, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\\n')\n copySessionSnapshot(snapshotRoot, runPath)\n return manifest\n}\n\nexport function verifySkillSnapshot(runPath, expectedManifestHash) {\n const snapshotRoot = join(runPath, 'context', 'skills')\n return verifySnapshotRoot(snapshotRoot, expectedManifestHash)\n}\n\nfunction copySessionSnapshot(snapshotRoot: string, runPath: string): void {\n const runSnapshotRoot = join(runPath, 'context', 'skills')\n rmSync(runSnapshotRoot, { recursive: true, force: true })\n cpSync(snapshotRoot, runSnapshotRoot, { recursive: true })\n}\n\nfunction verifySnapshotRoot(snapshotRoot: string, expectedManifestHash = ''): SkillManifest {\n const manifestPath = join(snapshotRoot, 'manifest.json')\n if (!existsSync(manifestPath)) throw new Error('Skill snapshot 缺少 manifest.json')\n const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as SkillManifest\n const { hash, ...unsigned } = manifest\n const actualManifestHash = digest(stableStringify(unsigned))\n if (!hash \|\| hash !== actualManifestHash \|\|\n (expectedManifestHash && hash !== expectedManifestHash)) {\n throw new Error('Skill snapshot manifest hash 不一致')\n }\n if (!Array.isArray(manifest.entries) \|\| !manifest.entries.length) {\n throw new Error('Skill snapshot manifest 没有 entries')\n }\n for (const entry of manifest.entries) {\n const skillRoot = resolve(snapshotRoot, entry.name)\n assertInside(realpathSync(snapshotRoot), realpathSync(skillRoot), `Skill snapshot ${entry.name}`)\n const files = walk(skillRoot)\n const contentIndex = files.map((path) => ({\n path: relative(skillRoot, path).split('\\\\').join('/'),\n hash: digest(readFileSync(path).toString('base64')),\n }))\n if (contentIndex.length !== entry.files \|\| digest(stableStringify(contentIndex)) !== entry.hash) {\n throw new Error(`Skill snapshot 内容漂移: ${entry.name}`)\n }\n }\n return manifest\n}\n\nfunction walk(dir): string[] {\n const out: string[] = []\n for (const name of readdirSync(dir).sort()) {\n // 安装管理元数据不是 Skill 内容，不进入 Session 快照。\n if (name === INSTALL_MARKER) continue\n const path = join(dir, name)\n const stat = lstatSync(path)\n if (stat.isSymbolicLink()) throw new Error(`Agent Skill 不允许符号链接: ${path}`)\n if (stat.isDirectory()) out.push(...walk(path))\n else if (stat.isFile()) out.push(path)\n }\n return out\n}\n\nfunction parseFrontmatter(text, label): Record<string, string> {\n const match = text.match(/^---\\r?\\n([\\s\\S]?)\\r?\\n---(?:\\r?\\n\|$)/)\n if (!match) throw new Error(`Agent Skill ${label}/SKILL.md 缺少 YAML frontmatter`)\n const out: Record<string, string> = {}\n for (const line of match[1].split(/\\r?\\n/)) {\n const m = line.match(/^([A-Za-z][A-Za-z0-9_-]):\\s(.)$/)\n if (!m) continue\n out[m[1]] = m[2].trim().replace(/^(['\"])(.)\\1$/, '$2')\n }\n if (!out.name \|\| !out.description) {\n throw new Error(`Agent Skill ${label}/SKILL.md frontmatter 必须含 name 和 description`)\n }\n const nestedVersion = match[1].match(\n /^metadata:\\s\\r?\\n(?:[ \\t]+.\\r?\\n)?[ \\t]+version:\\s['\"]?([^'\"\\r\\n]+)['\"]?\\s$/m,\n )\n if (nestedVersion?.[1]) out.version = nestedVersion[1].trim()\n return out\n}\n\nfunction resolveSkillSource(rootReal: string, sourceSpec: string): {\n path: string\n label: string\n} {\n const spec = String(sourceSpec \|\| '').trim()\n if (!spec) throw new Error('Workspace Skill name 不能为空')\n\n // 显式路径只允许当前 Workspace 内，保留旧 workspace@1 兼容。\n if (spec.includes('/') \|\| spec.includes('\\\\') \|\| spec.startsWith('.')) {\n const candidate = resolve(rootReal, spec)\n if (!existsSync(candidate) \|\| !lstatSync(candidate).isDirectory()) {\n throw new Error(`Agent Skill 不存在或不是目录: ${sourceSpec}`)\n }\n const actual = realpathSync(candidate)\n assertInside(rootReal, actual, `Agent Skill ${sourceSpec}`)\n return { path: actual, label: spec }\n }\n\n // bare name 的优先级：Workspace override → canonical global → client exposure\n // → npm 内置。Session 创建后仍会冻结，运行中不会热切换。\n const candidates: Array<[string, string]> = [\n [`workspace:${spec}`, join(rootReal, 'skills', spec)],\n [`global:${spec}`, join(homedir(), '.agents', 'skills', spec)],\n [`claude:${spec}`, join(homedir(), '.claude', 'skills', spec)],\n [`legacy-codex:${spec}`, join(homedir(), '.codex', 'skills', spec)],\n [`bundled:${spec}`, bundledSkillPath(PACKAGE_ROOT, spec)],\n ]\n for (const [label, candidate] of candidates) {\n if (!existsSync(candidate) \|\| !lstatSync(candidate).isDirectory()) continue\n const actual = realpathSync(candidate)\n if (!isInsideKnownSkillRoot(actual, rootReal)) continue\n return { path: actual, label }\n }\n throw new Error(`找不到 Agent Skill: ${spec}；请运行 dingtalk-agent skill install`)\n}\n\nfunction isInsideKnownSkillRoot(path: string, rootReal: string): boolean {\n const roots = [\n join(rootReal, 'skills'),\n join(homedir(), '.agents', 'skills'),\n join(homedir(), '.claude', 'skills'),\n join(homedir(), '.codex', 'skills'),\n join(PACKAGE_ROOT, 'skills'),\n ]\n return roots.some((root) => {\n if (!existsSync(root)) return false\n const actualRoot = realpathSync(root)\n const rel = relative(actualRoot, path)\n return rel !== '..' && !rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`)\n })\n}\n\nfunction assertInside(root, path, label) {\n const rel = relative(root, path)\n if (rel === '..' \|\| rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`) \|\| resolve(root, rel) !== path) {\n throw new Error(`${label} 必须位于当前工作区内`)\n }\n}\n"]}

package/dist/src/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type JsonPrimitive = null \| boolean \| number \| string\nexport type JsonValue = JsonPrimitive \| JsonValue[] \| JsonObject\nexport interface JsonObject { [key: string]: JsonValue }\n\nexport type EventKind =\n \| 'im.message.mentioned'\n \| 'im.message.dm'\n \| 'im.message.group'\n \| 'agent.heartbeat'\n \| (string & {})\n\nexport type ActionKind = 'ack' \| 'reply' \| 'ask' \| 'silence'\nexport type ActionOutcome = 'confirmed' \| 'accepted-unverified' \| 'uncertain'\n\nexport interface Correlation {\n source: string\n key: string\n}\n\nexport interface ReplyTarget {\n tenantId: string\n conversationId: string\n messageId: string\n senderOpenDingTalkId: string\n}\n\nexport interface NormalizedEvent {\n $schema: 'dingtalk-agent/event@1'\n id: string\n idSource: 'source' \| 'derived'\n kind: EventKind\n occurredAt: string \| null\n source: { adapter: string; type: string; subscribeId: string }\n tenant: { id: string }\n actor: {\n id: string\n openDingTalkId: string\n userId: string\n displayName: string\n }\n conversation: { id: string; type: string }\n message: { id: string; text: string; threadId: string; rootMessageId: string }\n correlation: Correlation\n replyTarget: ReplyTarget \| null\n}\n\nexport type InvocationMode =\n \| 'direct'\n \| 'dm'\n \| 'mention'\n \| 'ambient'\n \| 'heartbeat'\n \| 'continuation'\n\nexport interface InvocationContext {\n $schema: 'dingtalk-agent/invocation@1'\n mode: InvocationMode\n authority: 'default' \| 'host' \| 'event'\n eventId: string\n sessionKey: string\n occurredAt: string \| null\n actor: NormalizedEvent['actor'] \| null\n target: ReplyTarget \| null\n conversation: NormalizedEvent['conversation'] \| null\n}\n\nexport interface EnrichmentItem {\n status: 'available' \| 'missing' \| 'rejected'\n source: string\n fetchedAt: string \| null\n confidence: number\n truncated: boolean\n reason: string\n data: Record<string, unknown> \| null\n}\n\nexport interface EnrichedInvocation {\n $schema: 'dingtalk-agent/enriched-invocation@1'\n invocation: InvocationContext\n message: { originalText: string; effectiveText: string }\n enrichments: {\n quote: EnrichmentItem\n burst: EnrichmentItem\n identity: EnrichmentItem\n }\n missing: string[]\n hash: string\n}\n\nexport interface ResponseGateSnapshot {\n $schema: 'dingtalk-agent/response-gate@1'\n decision: 'engage' \| 'silent' \| 'inspect'\n reason: string\n hardAllowedActions: ActionKind[]\n softChecks: string[]\n perceptionHash: string\n hash: string\n}\n\nexport interface AgentDefinition {\n $schema: 'dingtalk-agent/agent-definition@1'\n id: string\n source: {\n kind: 'local-folder' \| 'git-checkout' \| 'dingtalk-doc' \| 'workspace'\n uri: string\n revision: string\n }\n body: { path: string; hash: string } \| null\n skills: Array<{\n name: string\n version: string\n source: string\n path: string\n hash: string\n }>\n storage: {\n memory: string\n knowledge: string\n artifacts: string\n state: string\n }\n authority: { dwsProfile: string; expectedUserId: string }\n configuration: Record<string, 'explicit' \| 'context' \| 'environment' \| 'workspace' \| 'convention'>\n status: 'ready' \| 'partial'\n missing: string[]\n hash: string\n}\n\nexport interface CompactEvent {\n $schema: 'dingtalk-agent/trigger@1'\n id: string\n type: EventKind\n contextId: string\n occurredAt: string \| null\n conversationId: string\n messageId: string\n actorId: string\n actorName: string\n text: string\n}\n\nexport interface RuntimeConfig {\n sessionRoot: string\n eventIndexRoot: string\n waitRoot: string\n waitTtlMs: number\n}\n\nexport interface AgentConfig {\n schemaVersion: number\n agent: { name: string; userId: string; ownerId: string }\n dws: { profile: string; expectedUserId: string }\n runtime: RuntimeConfig\n fields: FieldEntry[]\n ~~kb: Array<Record<string, any>>\n duties: Array<Record<string, any>>\n eval: { target: string~~ }\n}\n\nexport interface FieldEntry {\n id: string\n path: string\n default?: boolean\n priority?: number\n}\n\nexport interface FieldDefinition {\n id: string\n name?: string\n description?: string\n match?: Partial<Record<'tenantIds' \| 'conversationIds' \| 'actorIds' \| 'eventKinds', string[]>>\n transport: {\n mode: 'personal-event' \| 'robot-connect'\n egressOwner: 'dingtalk-agent' \| 'connector'\n }\n dws?: Partial<AgentConfig['dws']>\n behavior: { packs: string[] }\n memory?: Record<string, unknown>\n skills?: Record<string, unknown>\n evolution?: Record<string, unknown>\n}\n\nexport interface BehaviorRule {\n eligibility?: string\n defaultAction: ActionKind\n allowedActions: ActionKind[]\n replyPolicy?: string\n [key: string]: unknown\n}\n\nexport interface BehaviorSnapshot {\n $schema: 'dingtalk-agent/behavior-snapshot@1'\n id: string\n version: string\n description: string\n handles: Record<string, BehaviorRule>\n stateMachine: {\n initial: string\n transitions: Record<string, Partial<Record<ActionKind, string>>>\n terminal: string[]\n }\n limits: Partial<Record<'maxAckPerRun' \| 'maxOutwardActionsPerRun' \| 'maxTerminalMessagesPerRun' \| 'maxTextCharacters', number>>\n invariants: string[]\n packs: Array<{ path: string; id: string; version: string; hash: string }>\n hash: string\n}\n\nexport type ResumeContext =\n \| { mode: 'start' }\n \| {\n mode: 'resume' \| 'cancel'\n waitId: string\n waitScopeHash: string\n sourceRunId: string\n sourceActionId: string\n questionText: string\n questionDelivery: Record<string, unknown> \| null\n claimedByEventId: string\n cancelRequested: boolean\n cancelEventId: string\n suppressedInput: boolean\n }\n\nexport interface ActionCounts {\n ack: number\n reply: number\n ask: number\n silence: number\n outward: number\n terminal: number\n}\n\nexport interface SessionRecord {\n $schema: 'dingtalk-agent/session@1'\n id: string\n contextId: string\n fieldId: string\n correlation: Correlation\n correlationScope: string\n createdAt: string\n generation: number\n principal: NormalizedEvent['actor']\n tenant: NormalizedEvent['tenant']\n conversation: NormalizedEvent['conversation']\n definition?: { id: string; hash: string }\n updatedAt?: string\n cancelledAt?: string\n lastCancelEventId?: string\n}\n\nexport interface RunRecord {\n $schema: 'dingtalk-agent/run@1'\n protocol: 'basic-behavior/v1'\n id: string\n contextId: string\n sessionId: string\n fieldId: string\n eventId: string\n eventHash: string\n eventKind: EventKind\n createdAt: string\n updatedAt: string\n sessionGeneration: number\n resume: ResumeContext\n state: string\n status: string\n actionCounts: ActionCounts\n appliedActionIds: string[]\n behavior: { id: string; version: string; hash: string }\n skills: { manifestHash: string; manifestPath: string }\n definition?: { id: string; hash: string; snapshotPath: string }\n invocation?: { mode: InvocationMode; authority: InvocationContext['authority'] }\n perception?: { hash: string }\n responseGate?: { decision: ResponseGateSnapshot['decision']; hash: string }\n [key: string]: unknown\n}\n\nexport interface ActionReceipt {\n $schema: 'dingtalk-agent/action-receipt@1'\n actionId: string\n runId: string\n kind: ActionKind\n completedAt: string\n fromState: string\n toState: string\n outcome: ActionOutcome\n verified: boolean\n verification: string\n duplicate?: boolean\n [key: string]: unknown\n}\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type JsonPrimitive = null \| boolean \| number \| string\nexport type JsonValue = JsonPrimitive \| JsonValue[] \| JsonObject\nexport interface JsonObject { [key: string]: JsonValue }\n\nexport type EventKind =\n \| 'im.message.mentioned'\n \| 'im.message.dm'\n \| 'im.message.group'\n \| 'agent.heartbeat'\n \| (string & {})\n\nexport type ActionKind = 'ack' \| 'reply' \| 'ask' \| 'silence'\nexport type ActionOutcome = 'confirmed' \| 'accepted-unverified' \| 'uncertain'\n\nexport interface Correlation {\n source: string\n key: string\n}\n\nexport interface ReplyTarget {\n tenantId: string\n conversationId: string\n messageId: string\n senderOpenDingTalkId: string\n}\n\nexport interface NormalizedEvent {\n $schema: 'dingtalk-agent/event@1'\n id: string\n idSource: 'source' \| 'derived'\n kind: EventKind\n occurredAt: string \| null\n source: { adapter: string; type: string; subscribeId: string }\n tenant: { id: string }\n actor: {\n id: string\n openDingTalkId: string\n userId: string\n displayName: string\n }\n conversation: { id: string; type: string }\n message: { id: string; text: string; threadId: string; rootMessageId: string }\n correlation: Correlation\n replyTarget: ReplyTarget \| null\n}\n\nexport type InvocationMode =\n \| 'direct'\n \| 'dm'\n \| 'mention'\n \| 'ambient'\n \| 'heartbeat'\n \| 'continuation'\n\nexport interface InvocationContext {\n $schema: 'dingtalk-agent/invocation@1'\n mode: InvocationMode\n authority: 'default' \| 'host' \| 'event'\n eventId: string\n sessionKey: string\n occurredAt: string \| null\n actor: NormalizedEvent['actor'] \| null\n target: ReplyTarget \| null\n conversation: NormalizedEvent['conversation'] \| null\n}\n\nexport interface EnrichmentItem {\n status: 'available' \| 'missing' \| 'rejected'\n source: string\n fetchedAt: string \| null\n confidence: number\n truncated: boolean\n reason: string\n data: Record<string, unknown> \| null\n}\n\nexport interface EnrichedInvocation {\n $schema: 'dingtalk-agent/enriched-invocation@1'\n invocation: InvocationContext\n message: { originalText: string; effectiveText: string }\n enrichments: {\n quote: EnrichmentItem\n burst: EnrichmentItem\n identity: EnrichmentItem\n }\n missing: string[]\n hash: string\n}\n\nexport interface ResponseGateSnapshot {\n $schema: 'dingtalk-agent/response-gate@1'\n decision: 'engage' \| 'silent' \| 'inspect'\n reason: string\n hardAllowedActions: ActionKind[]\n softChecks: string[]\n perceptionHash: string\n hash: string\n}\n\nexport interface AgentDefinition {\n $schema: 'dingtalk-agent/agent-definition@1'\n id: string\n source: {\n kind: 'local-folder' \| 'git-checkout' \| 'dingtalk-doc' \| 'workspace'\n uri: string\n revision: string\n }\n body: { path: string; hash: string } \| null\n skills: Array<{\n name: string\n version: string\n source: string\n path: string\n hash: string\n }>\n storage: {\n memory: string\n knowledge: string\n artifacts: string\n state: string\n }\n authority: { dwsProfile: string; expectedUserId: string }\n configuration: Record<string, 'explicit' \| 'context' \| 'environment' \| 'workspace' \| 'convention'>\n status: 'ready' \| 'partial'\n missing: string[]\n hash: string\n}\n\nexport interface CompactEvent {\n $schema: 'dingtalk-agent/trigger@1'\n id: string\n type: EventKind\n contextId: string\n occurredAt: string \| null\n conversationId: string\n messageId: string\n actorId: string\n actorName: string\n text: string\n}\n\nexport interface RuntimeConfig {\n sessionRoot: string\n eventIndexRoot: string\n waitRoot: string\n waitTtlMs: number\n}\n\nexport interface AgentConfig {\n schemaVersion: number\n agent: { name: string; userId: string; ownerId: string }\n dws: { profile: string; expectedUserId: string }\n runtime: RuntimeConfig\n fields: FieldEntry[]\n}\n\nexport interface FieldEntry {\n id: string\n path: string\n default?: boolean\n priority?: number\n}\n\nexport interface FieldDefinition {\n id: string\n name?: string\n description?: string\n match?: Partial<Record<'tenantIds' \| 'conversationIds' \| 'actorIds' \| 'eventKinds', string[]>>\n transport: {\n mode: 'personal-event' \| 'robot-connect'\n egressOwner: 'dingtalk-agent' \| 'connector'\n }\n dws?: Partial<AgentConfig['dws']>\n behavior: { packs: string[] }\n memory?: Record<string, unknown>\n skills?: Record<string, unknown>\n evolution?: Record<string, unknown>\n}\n\nexport interface BehaviorRule {\n eligibility?: string\n defaultAction: ActionKind\n allowedActions: ActionKind[]\n replyPolicy?: string\n [key: string]: unknown\n}\n\nexport interface BehaviorSnapshot {\n $schema: 'dingtalk-agent/behavior-snapshot@1'\n id: string\n version: string\n description: string\n handles: Record<string, BehaviorRule>\n stateMachine: {\n initial: string\n transitions: Record<string, Partial<Record<ActionKind, string>>>\n terminal: string[]\n }\n limits: Partial<Record<'maxAckPerRun' \| 'maxOutwardActionsPerRun' \| 'maxTerminalMessagesPerRun' \| 'maxTextCharacters', number>>\n invariants: string[]\n packs: Array<{ path: string; id: string; version: string; hash: string }>\n hash: string\n}\n\nexport type ResumeContext =\n \| { mode: 'start' }\n \| {\n mode: 'resume' \| 'cancel'\n waitId: string\n waitScopeHash: string\n sourceRunId: string\n sourceActionId: string\n questionText: string\n questionDelivery: Record<string, unknown> \| null\n claimedByEventId: string\n cancelRequested: boolean\n cancelEventId: string\n suppressedInput: boolean\n }\n\nexport interface ActionCounts {\n ack: number\n reply: number\n ask: number\n silence: number\n outward: number\n terminal: number\n}\n\nexport interface SessionRecord {\n $schema: 'dingtalk-agent/session@1'\n id: string\n contextId: string\n fieldId: string\n correlation: Correlation\n correlationScope: string\n createdAt: string\n generation: number\n principal: NormalizedEvent['actor']\n tenant: NormalizedEvent['tenant']\n conversation: NormalizedEvent['conversation']\n definition?: { id: string; hash: string }\n updatedAt?: string\n cancelledAt?: string\n lastCancelEventId?: string\n}\n\nexport interface RunRecord {\n $schema: 'dingtalk-agent/run@1'\n protocol: 'basic-behavior/v1'\n id: string\n contextId: string\n sessionId: string\n fieldId: string\n eventId: string\n eventHash: string\n eventKind: EventKind\n createdAt: string\n updatedAt: string\n sessionGeneration: number\n resume: ResumeContext\n state: string\n status: string\n actionCounts: ActionCounts\n appliedActionIds: string[]\n behavior: { id: string; version: string; hash: string }\n skills: { manifestHash: string; manifestPath: string }\n definition?: { id: string; hash: string; snapshotPath: string }\n invocation?: { mode: InvocationMode; authority: InvocationContext['authority'] }\n perception?: { hash: string }\n responseGate?: { decision: ResponseGateSnapshot['decision']; hash: string }\n [key: string]: unknown\n}\n\nexport interface ActionReceipt {\n $schema: 'dingtalk-agent/action-receipt@1'\n actionId: string\n runId: string\n kind: ActionKind\n completedAt: string\n fromState: string\n toState: string\n outcome: ActionOutcome\n verified: boolean\n verification: string\n duplicate?: boolean\n [key: string]: unknown\n}\n"]}

package/dist/src/upgrade.js CHANGED Viewed

@@ -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, `'"'"'`)}'`;
 }