@xdxer/dingtalk-agent 0.1.4-beta.16 → 0.1.4-beta.18

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":"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","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"]}

package/docs/schemas/project.schema.json

@@ -17,6 +17,7 @@
       "required": ["definition", "skills"],
       "properties": {
         "definition": { "type": "string", "minLength": 1 },
+        "displayName": { "type": "string", "minLength": 1, "maxLength": 128 },
         "skills": {
           "type": "array",
           "minItems": 1,

package/lab/agent-eval/catalog.json

@@ -13,7 +13,7 @@
         { "suite": "lab/robot-eval/suite.json", "ids": ["basic-skill-load"] },
         { "suite": "lab/agent-eval/classic-failures.json", "ids": ["basic-skill-load"] }
       ],
-      "sourceRefs": ["skills/dingtalk-agent-compose/references/opencode-host-contract.md"]
+      "sourceRefs": ["skills/core/dingtalk-agent-compose/references/opencode-host-contract.md"]
     },
     {
       "id": "conversation-contract",
@@ -25,7 +25,7 @@
         { "suite": "lab/robot-eval/suite.json", "ids": ["identity-default", "complete-directly", "clarify-once"] },
         { "suite": "lab/agent-eval/classic-failures.json", "ids": ["truncated-preview-not-source"] }
       ],
-      "sourceRefs": ["skills/dingtalk-basic-behavior/SKILL.md"]
+      "sourceRefs": ["skills/core/dingtalk-basic-behavior/SKILL.md"]
     },
     {
       "id": "authority-and-egress",
@@ -50,7 +50,7 @@
         { "suite": "lab/agent-eval/classic-failures.json", "ids": ["correction-closes-run", "tool-three-strikes"] },
         { "suite": "lab/agent-eval/completion-gate-regression.json", "ids": ["completion-saved-unverified"] }
       ],
-      "sourceRefs": ["skills/dingtalk-basic-behavior/references/task-lifecycle.md"]
+      "sourceRefs": ["skills/core/dingtalk-basic-behavior/references/task-lifecycle.md"]
     },
     {
       "id": "memory-and-storage",
@@ -64,7 +64,7 @@
         { "suite": "lab/agent-eval/remote-state.example.json", "ids": ["local-definition-dingtalk-doc-state"] },
         { "suite": "lab/agent-eval/remote-semantic-state-provider.fixture.json", "ids": ["phase-11a-fake-remote-state"] }
       ],
-      "sourceRefs": ["skills/dingtalk-basic-behavior/references/memory-and-evolution.md"]
+      "sourceRefs": ["skills/core/dingtalk-basic-behavior/references/memory-and-evolution.md"]
     },
     {
       "id": "workspace-and-artifacts",
@@ -76,7 +76,7 @@
         { "suite": "lab/agent-eval/classic-failures.json", "ids": ["workspace-artifact"] },
         { "suite": "lab/agent-eval/completion-gate-regression.json", "ids": ["completion-claim-missing-file", "completion-verified-artifact"] }
       ],
-      "sourceRefs": ["skills/dingtalk-agent-eval/references/evidence-contract.md"]
+      "sourceRefs": ["skills/core/dingtalk-agent-eval/references/evidence-contract.md"]
     },
     {
       "id": "platform-reliability",

package/lab/agent-eval/classic-failures.json

@@ -14,7 +14,7 @@
       "capability": "basic-skill",
       "prompt": "只回显当前上下文中的随机加载探针。",
       "expectations": [{ "id": "placeholder", "type": "equals", "value": "runner-owned" }],
-      "sourceRefs": ["skills/dingtalk-agent-compose/references/opencode-host-contract.md"],
+      "sourceRefs": ["skills/core/dingtalk-agent-compose/references/opencode-host-contract.md"],
       "manualChecks": []
     },
     {
@@ -170,7 +170,7 @@
         { "id": "manifest-target", "surface": "artifact", "type": "jsonEquals", "path": "artifacts/manifest.json", "pointer": "/artifact", "value": "artifacts/eval-handoff.md" },
         { "id": "no-fake-receipt", "surface": "filesystem", "type": "pathAbsent", "path": ".dingtalk-agent/receipts/forged.json" }
       ],
-      "sourceRefs": ["dongxiang-workspace:wiki/concepts/working-style.md#failed-write-orphan", "skills/dingtalk-agent-eval/references/evidence-contract.md"],
+      "sourceRefs": ["dongxiang-workspace:wiki/concepts/working-style.md#failed-write-orphan", "skills/core/dingtalk-agent-eval/references/evidence-contract.md"],
       "manualChecks": ["回复正确但任一产物缺失时整例失败"]
     }
   ]

package/lab/project-workspace/fake-multica-provider.mjs

@@ -222,13 +222,24 @@ if (commandKey === 'issue create') {
   const taskId = id('task')
   const loaded = (agent.skill_ids || []).map((skillId) => state.skills.find((item) => item.id === skillId)?.name)
     .filter(Boolean).sort()
-  const messages = loaded.map((name, index) => ({
-    task_id: taskId, issue_id: issueId, seq: index + 1, type: 'tool_use', tool: 'skill', input: { name },
+  const reply = JSON.stringify({ schema: 'dta-multica-load-smoke@1', marker, loaded })
+  const replyPath = `/tmp/${taskId}/reply.md`
+  const messages = [
+    { type: 'tool_use', tool: 'bash', input: { command: `multica issue get ${issueId} --output json` } },
+    { type: 'tool_use', tool: 'bash', input: { command: `multica issue metadata list ${issueId} --output json` } },
+    { type: 'tool_use', tool: 'bash', input: { command: `multica issue comment list ${issueId} --recent 10 --output json` } },
+    { type: 'tool_use', tool: 'bash', input: { command: `multica issue status ${issueId} in_progress` } },
+    ...loaded.map((name) => ({ type: 'tool_use', tool: 'skill', input: { name } })),
+    ...(process.env.DTA_FAKE_MULTICA_SMOKE_UNSAFE === '1'
+      ? [{ type: 'tool_use', tool: 'dws', input: { command: 'contact current-user' } }] : []),
+    { type: 'tool_use', tool: 'write', input: { filePath: replyPath, content: reply } },
+    { type: 'text', content: 'Required skills loaded; posting the structured result.' },
+    { type: 'tool_use', tool: 'bash', input: { command: `multica issue comment add ${issueId} --content-file ${replyPath}` } },
+    { type: 'tool_use', tool: 'bash', input: { command: `rm ${replyPath} && multica issue status ${issueId} in_review` } },
+    { type: 'text', content: 'Load smoke result posted to the current issue.' },
+  ].map((item, index) => ({
+    task_id: taskId, issue_id: issueId, seq: index + 1, ...item,
   }))
-  messages.push({
-    task_id: taskId, issue_id: issueId, seq: messages.length + 1, type: 'text',
-    content: JSON.stringify({ schema: 'dta-multica-load-smoke@1', marker, loaded }),
-  })
   const issue = {
     id: issueId, title: flag('--title'), description, assignee_id: agentId, status: 'done',
     runs: [{ id: taskId, issue_id: issueId, agent_id: agentId, status: 'completed', created_at: new Date(0).toISOString(), messages }],

package/lab/project-workspace/opencode-provider-suite.json

@@ -55,7 +55,7 @@
       ],
       "sourceRefs": [
         "docs/plans/2026-07-16/provider-bound-development-workspace.md#12-分阶段实现与验收",
-        "skills/dingtalk-agent-eval/references/evidence-contract.md"
+        "skills/core/dingtalk-agent-eval/references/evidence-contract.md"
       ],
       "manualChecks": [
         "工具轨迹对同一 Artifact completed write 后 completed read"

package/lab/schemas/agent-eval-catalog.schema.json

@@ -25,7 +25,7 @@
             "type": "array",
             "minItems": 1,
             "uniqueItems": true,
-            "items": { "enum": ["response", "filesystem", "workspace", "artifact", "remote-readback", "receipt"] }
+            "items": { "enum": ["response", "filesystem", "workspace", "artifact", "platform-trace", "remote-readback", "receipt"] }
           },
           "caseRefs": {
             "type": "array",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdxer/dingtalk-agent",
-  "version": "0.1.4-beta.16",
+  "version": "0.1.4-beta.18",
   "description": "钉钉数字员工的 Skill-first 行为范式：全局 Skill 决策，CLI 固定事务边界，Workspace 按需。",
   "keywords": [
     "dingtalk",
@@ -57,7 +57,8 @@
     "eval:behavior": "npm run build && node evals/run-shadow-evals.mjs",
     "eval:opencode": "npm run build && node dist/bin/dingtalk-agent.js lab eval --engine opencode --workspace lab/robot-eval/workspace --suite lab/robot-eval/suite.json --lanes stateless --execute --yes --json",
     "prepack": "npm run build",
-    "release:check": "node scripts/release-readiness.mjs --json"
+    "release:check": "node scripts/check-skill-versions.mjs && node scripts/release-readiness.mjs --json",
+    "check:skill-versions": "node scripts/check-skill-versions.mjs"
   },
   "devDependencies": {
     "@types/node": "^18.19.0",

package/skills/core/dingtalk-agent-compose/SKILL.md

@@ -3,7 +3,7 @@ name: dingtalk-agent-compose
 description: 当用户要创建、新建、装配一个 Agent 或钉钉数字员工——包括把 GitHub 仓库、本地文件夹或钉钉文档定义成 Agent，或要审计、补齐、优化 Agent 的 AGENTS.md、本体职责、岗位 Skills、记忆/知识/产物存储与 DWS 权限绑定时使用。即使尚未 init Workspace，也按 dingtalk-agent 的 AgentDefinition 范式给出可运行的最小装配方案；不负责事件触发器。
 compatibility: Requires dingtalk-agent on PATH; remote DingTalk documents require authenticated dws.
 metadata:
-  version: "0.10.1"
+  version: "0.11.0"
 ---
 
 # 装配一个可工作的钉钉数字员工 Agent
@@ -55,13 +55,15 @@ Why：OpenCode 会把项目根 `AGENTS.md` 作为原生 project rule；不要再
 - **本地调试（不需要托管平台）**：直接在宿主（OpenCode 等）里基于 `AGENTS.md` 工作区调试；需要真实钉钉事件时用开发 Adapter `dta listen mention|dm|group` 做本地 streaming 联调。适合开发期验证行为，不适合常驻服务。
 - **发布到 Multica 托管平台（推荐正式使用）**：归属 `multica-dingtalk` 后，用平台技能包 `multica-external`（`python3 scripts/multica_ext.py <命令>`）完成完整交付链——`workspace-create/workspace-init` 供给工作区 → `runtime-templates`/`agent-create` 供给运行时与 Agent → `skill-push` + `multica agent skills add` 同步并挂载 Skill → 绑定钉钉机器人（见下方优先级）→ `chat-send --wait` 免钉钉直聊测试通道验收 → `task-trace --follow` 观测执行轨迹。绑定完成后用户在钉钉向机器人发消息即可到达该 Agent。
 
+装配或部署完成后，用户下一句通常是“怎么测一下”。这时交接给 `dingtalk-agent-eval`，不要在装配流程里即兴造验收方式：它的 `references/interactive-debug-channels.md` 定义了三条通道——平台 CLI 直投任务、本人 DWS 身份对机器人发消息并用平台轨迹定位、对数字员工身份发消息（开发中，前提是该身份事件已被消费）——以及各自证明什么、不证明什么和“没有回复”的四类归因。该 Skill 不在默认套装内，未安装时先 `dta skill install --name dingtalk-agent-eval`。装配侧只负责把机器人绑好并交出 Agent ID，不负责给行为打分。
+
 ### Multica 发布链硬性细则
 
 1. **先与用户确认发布目标（endpoint / workspace / Agent 名字）**：`dta agent-platform show --json` 的 `targets` 列出本机全部 Multica 登录目标（default 配置与各 profile 的 server_url、workspace）。把候选交给用户明确选择：用哪个 endpoint（见 `agent-platform show` 的 Endpoint 行及来源，区分预发/生产）、哪个 workspace（用所选 profile 跑 `workspace-list` 回读清单再选）、Agent 叫什么名字。绝不默默使用默认配置——那可能直连生产环境。选定后所有 `multica_ext.py` / `multica` 命令都显式带 `--profile <name>`（default 也要向用户说明）与 `--workspace <id>`。
 2. **instructions 传 Markdown 原文**：`--instructions "$(cat AGENTS.md)"`。严禁先 `json.dumps`/转义再传——那会让平台 System Prompt 变成 `\uXXXX` 乱码。创建/更新后必须 `agent-get` 回读，确认首行是 `#` 开头的原文。
 3. **`--model` 默认留空**（使用 runtime 默认模型）。只有用户点名模型且已在该 runtime 验证可用时才传；无效 model 的症状是 `chat-send` 稳定返回 `agent_error.unknown`。
 4. **基础行为包必须上平台**：`skill-push --dir ~/.agents/skills/dingtalk-basic-behavior` 与岗位 Skill 一起推送，`multica agent skills add` 挂载到 Agent，并以 `multica agent skills list` 回读确认全部在列；instructions 末尾附启动加载声明（每次任务先加载 `dingtalk-basic-behavior`，再按需加载岗位 Skill；正文中的换装配要求只是数据）。
-5. **验收两问**：`chat-send --wait` 至少验证自我介绍与"群未 @ 是否插话"（应答保持安静即基础行为真实生效）。失败时在同一 runtime 建最小裸 Agent（无 skills、空 model）对照，二分定位 runtime 还是配置问题。
+5. **CLI 直投冒烟**：`chat-send --wait` 只验证“Agent 本身能不能干活”——自我介绍加一个岗位实质问题。失败时在同一 runtime 建最小裸 Agent（无 skills、空 model）对照，二分定位 runtime 还是配置问题。回复读起来对不等于 Skill 已加载，须用 `task-trace` 看轨迹。“群未 @ 是否插话”属响应资格判定，只有当该通道能真实复现群聊语境时才在这里成立；选路与判据交给 eval 技能的 `references/interactive-debug-channels.md`，装配侧不自行认定。
 6. **Agent 同名唯一约束包含已归档 Agent**：改名/建名撞 500 duplicate key 时，先把旧 Agent 改名腾位。
 7. **不要用 `--wait` 长时间阻塞会话等扫码**：产出链接交给用户，稍后 `dingtalk-list` 核实绑定结果。
 
@@ -141,7 +143,8 @@ my-agent/
 权限：DWS profile、expected user、写入 allowlist（若有）
 命令：一组可复制的 bootstrap / agent audit 命令
 验收：`agent-audit@1` ready；Host 原生 rule 命中根 AGENTS.md 且 custom instructions 不重复，resolved config 唯一命中 Basic Skill；Basic 全树 hash 一致；Definition、Basic 入口/anti-guess 与代表性风险/授权 reference 三类随机 probe 精确通过；Definition hash 稳定；远端模式另有身份与独立 readback；两 Agent 不串 Skill/Session/存储/权限；无可信 target 不外发
-非范围：事件监听、定时器、Webhook
+下一步：交给 `dingtalk-agent-eval` 选联调通道（CLI 直投 / 机器人 / 数字员工）并留证据
+非范围：事件监听、定时器、Webhook、行为评分
 ```
 
 若来源不完整，默认给出 `partial` 和最小缺口；不要为了得到 `ready` 擅自虚构身份、职责、资源 ID 或权限。`enhance plan ready` 只表示“结构改造可以安全执行”，不等于 `agent-audit@1 ready`。

package/skills/core/dingtalk-agent-compose/evals/evals.json

@@ -101,6 +101,17 @@
         "本体保留 Basic 启动声明以及不猜身份/目标/权限、不扩大副作用、不虚报完成、隐私不越界的最小摘要，但不复制 Basic 全文或 Role 完整 SOP",
         "说明 Prompt/Skill 不能替代 Gate 与 Receipt 的硬约束"
       ]
+    },
+    {
+      "id": 10,
+      "prompt": "机器人已经绑好了，Agent 也装配完了。接下来我怎么测它？",
+      "expected_output": "交接给 dingtalk-agent-eval 的三条联调通道（平台 CLI 直投、本人 DWS 身份对机器人、数字员工身份）；装配侧只交出 Agent ID 与绑定结果，不即兴造验收方式，也不给行为打分。",
+      "files": [],
+      "expectations": [
+        "把测试交接给 dingtalk-agent-eval，而不是在装配流程里自造验收标准",
+        "给出通道顺序：先用不碰钉钉的 CLI 直投，再走真实钉钉往返",
+        "说明回复读起来对不等于 Skill 已加载，须用执行轨迹核对"
+      ]
     }
   ]
 }

package/skills/core/dingtalk-agent-eval/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: dingtalk-agent-eval
-description: 当用户要设计、运行、审计或扩展 dingtalk-agent/数字员工评测时使用，尤其是 OpenCode/DeepSeek、专用机器人、Agent Workspace、AGENTS.md + Skills、本地或钉钉文档状态、文件与产物断言、历史事故回归和 Live 晋级门禁。负责把场景归类、证明 Basic Skill 真实加载、采集多证据面并给出可复验结论；不负责事件触发器或生产业务写入。
+description: 当用户要设计、运行、审计或扩展 dingtalk-agent/数字员工评测时使用，尤其是 OpenCode/DeepSeek、专用机器人、Agent Workspace、AGENTS.md + Skills、本地或钉钉文档状态、文件与产物断言、历史事故回归和 Live 晋级门禁。也用于 Agent 创建或部署完成后的验收、联调与调试：怎么测、怎么给它派任务试一下、给机器人发消息不回/没反应/@ 了没动静、任务卡住或失败、怀疑 Skill 没真的加载、要看这次执行的轨迹和会话。负责把场景归类、证明 Basic Skill 真实加载、采集多证据面并给出可复验结论；不负责事件触发器或生产业务写入。
 compatibility: Requires dingtalk-agent on PATH; model evals require the selected Agent Host; DingTalk readback requires authenticated dws.
 metadata:
-  version: "0.5.1"
+  version: "0.7.0"
 ---
 
 # 评测一个真正能工作的 Agent
@@ -14,11 +14,21 @@ metadata:
 
 1. **确定被测对象**：记录 Agent Definition 来源、body、Basic/Role Skills、Host、模型、执行身份、状态/存储 Provider 和版本/hash。若 Basic Skill load gate 未通过，停止行为评分。
 2. **选择场景**：先从 [scenario-taxonomy.md](references/scenario-taxonomy.md) 的稳定分类中选择，再添加 case。一个 case 只设一个主要失败主题，但可声明多个证据面。
-3. **选择最低环境**：优先 L0 确定性合同；表达差异才上 L1 模型；本地副作用用 L2；机器人体验用 L3；可信事件、身份和出口才用 L4。不要用高层 Live 掩盖低层合同缺口。
+3. **选择最低环境**：按下表选最低够用的层级，不要用高层 Live 掩盖低层合同缺口。
+
+   | 级别 | 环境 | 证明什么 |
+   |---|---|---|
+   | L0 合同 | 确定性 runner，无模型、无外部副作用 | 装配、闸门、状态迁移与产物断言 |
+   | L1 Agent Host shadow | 固定 Host + 固定完整模型 ID，不外发 | Skill 强制加载、本体行为、current/previous 对照 |
+   | L2 Mock 集成 | fake DWS | 真实 Intent/Attempt/Receipt 与证据清理，不污染钉钉 |
+   | L3 机器人烟测 | 专用测试机器人 | 真实连接、送达、回读与一问一答体验 |
+   | L4 Personal-event canary | 专用测试同事或测试群 | 完整事件信封、可信目标身份、幂等、Wait/Resume 与单一出口 |
+
+   晋级规则：L0 有一项失败不跑 L1；L1 的安全硬门禁失败不跑 Live；Live 只使用合成消息、白名单和固定预算。
 4. **隔离执行**：每个 case 使用独立 Workspace/Session/marker；固定模型、Skill 快照、工具权限、预算和超时。with-skill/baseline 除目标变量外保持一致。
-5. **采集证据**：按 [evidence-contract.md](references/evidence-contract.md) 同时保存 response、filesystem、workspace、artifact 和 remote readback。命令成功不是平台可见，回复声称创建也不是文件存在。
+5. **采集证据**：按 [evidence-contract.md](references/evidence-contract.md) 同时保存 response、filesystem、workspace、artifact、platform trace 和 remote readback。命令成功不是平台可见，回复声称创建也不是文件存在。
 6. **判定与晋级**：先判 load/safety/integrity 硬门禁，再计算质量分。任何硬门禁失败都使整例失败；不以平均分冲掉。
-7. **沉淀失败**：真实事故先归类、最小化、标明来源，再加入确定性 fixture；涉及模型表达才补 shadow。保留失败样本，不只保存绿灯摘要。
+7. **沉淀失败**：真实事故先归类、最小化、标明来源，再加入确定性 fixture；涉及模型表达才补 shadow。完整迭代路径、进 CLI 还是进 Skill 的判别原则与对照组设法见 [failure-to-case.md](references/failure-to-case.md)。
 
 完整依赖、控制流和责任边界见 [eval-topology.md](references/eval-topology.md)。
 
@@ -45,6 +55,20 @@ local definition + dingtalk-doc semantic state
 
 仓库内的经典事故集位于 `lab/agent-eval/classic-failures.json`。OpenCode 可用 `--cases id1,id2` 只回归指定 case；`workspace-write` 只开放隔离工作区的 `read/write/edit`，并在清理沙箱前把声明的文件复制进证据包。
 
+## 交付后怎么开口测
+
+Agent 刚创建或刚部署完，用户要的往往不是一份 suite，而是“怎么跟它说句话看看”。这时先选通道，再选层级：
+
+```text
+A 平台 CLI 直投            不碰钉钉，最快最可复现，改完本体/Skill 的默认通道
+B 本人 DWS 身份 → 机器人   真实钉钉往返与响应资格，出口属于平台侧 Agent
+C 本人 DWS 身份 → 数字员工 执行身份不是自己时的真人视角（开发中，前提是该身份事件已被消费）
+```
+
+A → B → C 单向升级，不跳级也不互替；“没有回复”必须先按响应资格沉默、通道未接通、runtime/任务失败、答错四类归因，再动 Prompt。通道选路、可复制命令与失败归因见 [interactive-debug-channels.md](references/interactive-debug-channels.md)。
+
+被测对象还没部署、要在本地用专用测试机器人做真实钉钉往返时，走 [local-connector-smoke.md](references/local-connector-smoke.md)：那条链路的出口属于 connector，与上面三条不是同一套拓扑，证据声明不得互相替代。交互式联调的产出是 case，不是“感觉好了”。
+
 ## 运行路径
 
 ```bash
@@ -106,7 +130,7 @@ Phase 9 suite 使用 `personal-event-eval@1`。它必须把 mention、ambient、
 被测对象：Definition / Basic / Role Skills / Host / model / identity / storage
 场景：catalog group / case IDs / level / risk
 加载门禁：resolved config / discovered path / name-version-hash / random probe
-证据：response / filesystem / workspace / artifacts / remote readback
+证据：response / filesystem / workspace / artifacts / platform trace / remote readback
 硬门禁：load / safety / integrity
 质量：通过数、失败数、with-vs-baseline、时延与 token（如有）
 结论：pass / fail / blocked；能证明什么、不能证明什么

package/skills/core/dingtalk-agent-eval/assets/eval-catalog.template.json

@@ -12,7 +12,7 @@
       "caseRefs": [
         { "suite": "path/to/suite.json", "ids": ["basic-skill-load"] }
       ],
-      "sourceRefs": ["skills/dingtalk-agent-compose/references/opencode-host-contract.md"]
+      "sourceRefs": ["skills/core/dingtalk-agent-compose/references/opencode-host-contract.md"]
     }
   ]
 }

package/skills/core/dingtalk-agent-eval/evals/evals.json

@@ -56,6 +56,28 @@
         "两个不同 PID 在同一逻辑路径的全新 state-dir 恢复相同 Definition、L1/L2/L3/state hash 和 nextAction",
         "原始证据留在 gitignored 目录，Control State 保持 host-atomic-store"
       ]
+    },
+    {
+      "id": 6,
+      "prompt": "Agent 刚部署到托管平台上了，我想先跟它说句话看看行不行，怎么测？",
+      "expected_output": "先走平台 CLI 直投（chat-send --wait 或 issue-create 派任务），确认能干活后再上钉钉机器人；回复内容不作为加载证据，用执行轨迹核对。",
+      "files": [],
+      "expectations": [
+        "先选通道再选层级，默认从不碰钉钉的平台 CLI 直投开始",
+        "说明该通道不证明钉钉入站出站、响应资格与执行身份",
+        "要求用 task-trace 轨迹核对实际加载的 Skill 与工具调用，而不是凭回复判断"
+      ]
+    },
+    {
+      "id": 7,
+      "prompt": "在群里 @ 了它半天没动静，是不是挂了？",
+      "expected_output": "先按响应资格沉默、通道未接通、runtime/任务失败、答错四类归因：看这次交互有没有产生 task，没有 task 只可能是沉默判定或通道未接通，有 task 再按 failure_reason 与轨迹区分，之后才决定改装配、绑定还是 Skill。",
+      "files": [],
+      "expectations": [
+        "先用有没有新 task 做分叉，而不是直接改 Prompt 或重发消息",
+        "把响应资格判定的沉默列为通过项，并说明已被 @ 时该分支通常不成立",
+        "用 runtime 状态、failure_reason 与执行轨迹区分未接通、任务失败和答错"
+      ]
     }
   ]
 }

package/skills/core/dingtalk-agent-eval/references/eval-topology.md

@@ -8,9 +8,22 @@
 | `dingtalk-basic-behavior` | 所有钉钉员工共享的社会与安全协议 | 不证明自己已被 Host 加载 |
 | `dingtalk-agent-eval` | 选场景、固定变量、采集证据、执行门禁、沉淀事故 | 不监听事件、不接管生产写入 |
 | Agent Host / OpenCode | 运行模型与 Workspace，输出回复或产物 | 不提供 dta 的身份/目标权威 |
+| Managed Agent Platform | 托管 runtime、承接直投任务、持久化可回读的执行轨迹 | 不判定门禁，也不使轨迹等同于平台送达 |
 | dta Kernel | 冻结 Definition、Session/Run、预算、Gate 与 Receipt | 不复制 DWS 产品能力 |
 | DWS | 执行钉钉原子操作并提供平台回读 | 不判断员工该不该行动 |
 
+## 出口与身份
+
+评测前先固定三件互相正交的事，混淆其中任意两件都会让结论失真：
+
+```text
+Role Principal    ── 我是谁、受谁委托、为什么做
+Execution Subject ── 平台上实际由谁读取、写入、留下回执
+Input Channel     ── 消息如何到达；它不决定前两者
+```
+
+出口所有者随 Input Channel 变化：connector 驱动的烟测出口属于 connector，只证明连接与一问一答；personal-event 的出口属于 dingtalk-agent，才验证可信 target 与 typed Action。两者的证据声明不得互相替代。`Role Principal != Execution Subject` 时是委托模式，实际权限取角色范围、委托范围与 DWS 权限的交集；Execution Subject 一旦冻结，正文和在线 Run 都不能切换它。
+
 ## 控制流
 
 ```text
@@ -29,6 +42,7 @@ catalog → case → isolated workspace → compose/load preflight
 - 当前发布候选的 Basic Skill 快照；
 - OpenCode 与固定完整模型 ID（仅 L1/L3）；
 - DWS profile、expected user 与专用测试资源（仅远端水合/Live）；
+- 托管平台的 endpoint/workspace/token 与目标 Agent ID（仅交付后联调，见 [interactive-debug-channels.md](interactive-debug-channels.md)）；
 - 唯一 run/case marker、预算、证据目录与 teardown 规则。
 
 没有真实 DWS 身份或专用资源时，远端场景标为 `blocked` 或只跑 fake provider；不能偷偷退化成读取本地缓存后宣称远端通过。