@xdxer/dingtalk-agent 0.1.2 → 0.1.4-beta.1

package/dist/src/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/setup.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'\nimport { delimiter, join } from 'node:path'\nimport { homedir } from 'node:os'\nimport { spawnSync } from 'node:child_process'\n\nimport { doctor, findExecutable, type DoctorReport } from './doctor.js'\nimport {\n  installGlobalSkill, skillStatus, upgradeGlobalSkill, type GlobalSkillStatus,\n} from './skill-manager.js'\n\nconst PATH_MARKER_START = '# >>> dingtalk-agent PATH >>>'\nconst PATH_MARKER_END = '# <<< dingtalk-agent PATH <<<'\n\nexport interface SetupOptions {\n  home?: string\n  env?: NodeJS.ProcessEnv\n  prefix?: string\n  dryRun?: boolean\n  writeShell?: boolean\n  skipCliInstall?: boolean\n}\n\nexport interface SetupResult {\n  $schema: 'dingtalk-agent/setup@1'\n  dryRun: boolean\n  cli: {\n    installed: boolean\n    skipped: boolean\n    prefix: string\n    binDir: string\n    executable: string\n    packageSpec: string\n  }\n  shell: {\n    pathReady: boolean\n    rcFile: string\n    updated: boolean\n    activateCommand: string\n  }\n  skill: GlobalSkillStatus\n  doctor: DoctorReport\n  nextCommand: string\n}\n\nexport function setup(packageRoot: string, options: SetupOptions = {}): SetupResult {\n  const home = options.home || homedir()\n  const env = { ...(options.env || process.env) }\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' ? 'dingtalk-agent.cmd' : 'dingtalk-agent')\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const packageSpec = env.DTA_SETUP_PACKAGE_SOURCE || `${pkg.name}@${pkg.version}`\n  const npm = findExecutable(process.platform === 'win32' ? 'npm.cmd' : 'npm', env) || 'npm'\n  const installedVersion = existsSync(executable)\n    ? readInstalledVersion(executable, env)\n    : ''\n  const alreadyCurrent = installedVersion === String(pkg.version || '')\n\n  if (!options.dryRun && !options.skipCliInstall && !alreadyCurrent) {\n    mkdirSync(prefix, { recursive: true })\n    const run = spawnSync(npm, [\n      'install', '--global', '--prefix', prefix, '--registry', 'https://registry.npmjs.org', packageSpec,\n    ], { encoding: 'utf8', env, timeout: 120_000 })\n    if (run.status !== 0 || run.error) {\n      throw new Error(\n        `CLI 用户级安装失败: ${run.error?.message || String(run.stderr || run.stdout).trim() || `退出码 ${run.status}`}`,\n      )\n    }\n    if (!existsSync(executable)) throw new Error(`npm 安装完成但没有生成 CLI: ${executable}`)\n  }\n\n  const shell = ensureShellPath(home, binDir, env, {\n    dryRun: Boolean(options.dryRun),\n    writeShell: options.writeShell !== false,\n  })\n  const effectiveEnv = {\n    ...env,\n    PATH: [binDir, env.PATH || ''].filter(Boolean).join(delimiter),\n  }\n  const beforeSkill = skillStatus(packageRoot, { home })\n  const skill = options.dryRun\n    ? beforeSkill\n    : beforeSkill.canonical.exists && beforeSkill.canonical.managed &&\n        !beforeSkill.canonical.modified && !beforeSkill.canonical.current\n      ? upgradeGlobalSkill(packageRoot, { home })\n      : installGlobalSkill(packageRoot, { home })\n  const report = doctor(packageRoot, { home, env: effectiveEnv })\n  return {\n    $schema: 'dingtalk-agent/setup@1',\n    dryRun: Boolean(options.dryRun),\n    cli: {\n      installed: !options.dryRun && !options.skipCliInstall && existsSync(executable),\n      skipped: Boolean(options.skipCliInstall || alreadyCurrent),\n      prefix,\n      binDir,\n      executable,\n      packageSpec,\n    },\n    shell,\n    skill,\n    doctor: report,\n    nextCommand: report.ready ? 'dingtalk-agent bootstrap --json' : 'dingtalk-agent doctor',\n  }\n}\n\nfunction ensureShellPath(\n  home: string,\n  binDir: string,\n  env: NodeJS.ProcessEnv,\n  options: { dryRun: boolean; writeShell: boolean },\n) {\n  const current = (env.PATH || '').split(delimiter).filter(Boolean)\n  const pathReady = current.includes(binDir)\n  const shell = env.SHELL || ''\n  const rcFile = shell.endsWith('/zsh')\n    ? join(home, '.zshrc')\n    : shell.endsWith('/bash')\n      ? join(home, '.bashrc')\n      : ''\n  const isDefaultBin = binDir === join(home, '.local', 'bin')\n  const activateCommand = isDefaultBin\n    ? 'export PATH=\"$HOME/.local/bin:$PATH\"'\n    : `export PATH=${shellQuote(binDir)}:\"$PATH\"`\n  let updated = false\n  if (!pathReady && options.writeShell && rcFile) {\n    const before = existsSync(rcFile) ? readFileSync(rcFile, 'utf8') : ''\n    if (!before.includes(PATH_MARKER_START) && !options.dryRun) {\n      const pathLine = isDefaultBin\n        ? 'export PATH=\"$HOME/.local/bin:$PATH\"'\n        : `export PATH=${shellQuote(binDir)}:\"$PATH\"`\n      const block = `${before && !before.endsWith('\\n') ? '\\n' : ''}${PATH_MARKER_START}\\n` +\n        `${pathLine}\\n${PATH_MARKER_END}\\n`\n      appendFileSync(rcFile, block)\n      updated = true\n    }\n  }\n  return { pathReady, rcFile, updated, activateCommand }\n}\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\"'\"'`)}'`\n}\n\nfunction readInstalledVersion(executable: string, env: NodeJS.ProcessEnv): string {\n  const run = spawnSync(executable, ['--version'], { encoding: 'utf8', env, timeout: 8_000 })\n  return run.status === 0 ? String(run.stdout || '').trim() : ''\n}\n"]}

package/dist/src/skill-manager.js

@@ -21,6 +21,7 @@ export function skillStatus(packageRoot, options = {}) {
     const managed = marker?.manager === MANAGER;
     const modified = Boolean(managed && installedHash !== marker?.sourceHash);
     const claude = inspectExposure(paths.claude, paths.canonical);
+    const sharedState = canonicalExists ? 'ok' : 'missing';
     return {
         $schema: 'dingtalk-agent/skill-status@1',
         name: GLOBAL_SKILL_NAME,
@@ -34,6 +35,20 @@ export function skillStatus(packageRoot, options = {}) {
             current: Boolean(managed && !modified && installedHash === bundled.hash),
         },
         claude: { path: paths.claude, ...claude },
+        clients: [
+            {
+                name: 'claude-code', label: 'Claude Code', discovery: 'symlink',
+                path: paths.claude, state: claude.state,
+            },
+            {
+                name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',
+                path: paths.canonical, state: sharedState,
+            },
+            {
+                name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',
+                path: paths.canonical, state: sharedState,
+            },
+        ],
         legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// 全局 Skill 生命周期：一个 canonical copy，按 Agent 客户端暴露。\n//\n// canonical: ~/.agents/skills/dingtalk-basic-behavior\n// Claude:    ~/.claude/skills/dingtalk-basic-behavior -> canonical\n//\n// 不链接 npm/node_modules：包升级、卸载或 npx cache 清理都不应让 Skill 断掉。\n\nimport {\n  cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync,\n  readdirSync, renameSync, rmSync, symlinkSync, writeFileSync,\n} from 'node:fs'\nimport { createHash, randomUUID } from 'node:crypto'\nimport { homedir } from 'node:os'\nimport { dirname, join, relative, resolve } from 'node:path'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\nconst MARKER = '.dingtalk-agent-install.json'\nconst MANAGER = '@xdxer/dingtalk-agent'\n\ninterface InstallMarker {\n  $schema: 'dingtalk-agent/managed-skill@1'\n  manager: typeof MANAGER\n  packageVersion: string\n  skillVersion: string\n  sourceHash: string\n  installedAt: string\n  exposure: { claude: 'symlink' }\n}\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  discardLocalChanges?: boolean\n}\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@1'\n  name: string\n  bundled: { path: string; packageVersion: string; skillVersion: string; hash: string }\n  canonical: {\n    path: string\n    exists: boolean\n    managed: boolean\n    installedHash: string\n    modified: boolean\n    current: boolean\n  }\n  claude: { path: string; state: 'ok' | 'missing' | 'conflict'; target: string }\n  legacyCodex: { path: string; conflict: boolean }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const paths = globalPaths(packageRoot, options.home)\n  const bundled = bundledInfo(packageRoot)\n  const marker = readMarker(paths.canonical)\n  const canonicalExists = pathExists(paths.canonical)\n  const canonicalDirectory = canonicalExists && lstatSync(paths.canonical).isDirectory()\n  const installedHash = canonicalDirectory ? hashDirectory(paths.canonical) : ''\n  const managed = marker?.manager === MANAGER\n  const modified = Boolean(managed && installedHash !== marker?.sourceHash)\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  return {\n    $schema: 'dingtalk-agent/skill-status@1',\n    name: GLOBAL_SKILL_NAME,\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      managed,\n      installedHash,\n      modified,\n      current: Boolean(managed && !modified && installedHash === bundled.hash),\n    },\n    claude: { path: paths.claude, ...claude },\n    legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (before.canonical.exists) {\n    if (!before.canonical.managed) {\n      throw new Error(`全局 Skill 同名目录不归 dingtalk-agent 管理，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (before.canonical.modified) {\n      throw new Error(`全局 Skill 有本地修改，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (!before.canonical.current) {\n      throw new Error('已安装版本不是当前内置版本；请运行 `dingtalk-agent skill upgrade`')\n    }\n    ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n    return options.dryRun ? before : skillStatus(packageRoot, options)\n  }\n\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun) {\n    installCanonical(packageRoot, before.canonical.path)\n    ensureClaudeExposure(before.canonical.path, before.claude.path, false)\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return installGlobalSkill(packageRoot, options)\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝接管: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun && !before.canonical.current) {\n    replaceCanonical(packageRoot, before.canonical.path)\n  }\n  ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return before\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝删除: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (!options.dryRun) {\n    if (before.claude.state === 'ok') rmSync(before.claude.path)\n    rmSync(before.canonical.path, { recursive: true, force: true })\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nfunction globalPaths(packageRoot: string, home = homedir()) {\n  return {\n    source: join(packageRoot, 'skills', GLOBAL_SKILL_NAME),\n    canonical: join(home, '.agents', 'skills', GLOBAL_SKILL_NAME),\n    claude: join(home, '.claude', 'skills', GLOBAL_SKILL_NAME),\n    legacyCodex: join(home, '.codex', 'skills', GLOBAL_SKILL_NAME),\n  }\n}\n\nfunction bundledInfo(packageRoot: string) {\n  const paths = globalPaths(packageRoot)\n  validateSkill(paths.source)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(paths.source, 'SKILL.md'), 'utf8'))\n  return {\n    path: paths.source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n    hash: hashDirectory(paths.source),\n  }\n}\n\nfunction installCanonical(packageRoot: string, destination: string): void {\n  const source = globalPaths(packageRoot).source\n  const bundled = bundledInfo(packageRoot)\n  const parent = dirname(destination)\n  mkdirSync(parent, { recursive: true })\n  const stage = join(parent, `.${GLOBAL_SKILL_NAME}.stage.${process.pid}.${randomUUID()}`)\n  try {\n    cpSync(source, stage, { recursive: true, errorOnExist: true, force: false })\n    writeFileSync(join(stage, MARKER), JSON.stringify(markerFor(bundled), null, 2) + '\\n', { flag: 'wx' })\n    validateSkill(stage)\n    if (hashDirectory(stage) !== bundled.hash) throw new Error('Skill staging hash 与内置版本不一致')\n    renameSync(stage, destination)\n  } finally {\n    rmSync(stage, { recursive: true, force: true })\n  }\n}\n\nfunction replaceCanonical(packageRoot: string, destination: string): void {\n  const parent = dirname(destination)\n  const backup = join(parent, `.${GLOBAL_SKILL_NAME}.backup.${process.pid}.${randomUUID()}`)\n  const stageDestination = join(parent, `.${GLOBAL_SKILL_NAME}.next.${process.pid}.${randomUUID()}`)\n  installCanonical(packageRoot, stageDestination)\n  renameSync(destination, backup)\n  try {\n    renameSync(stageDestination, destination)\n    rmSync(backup, { recursive: true, force: true })\n  } catch (error) {\n    if (!existsSync(destination) && existsSync(backup)) renameSync(backup, destination)\n    throw error\n  } finally {\n    rmSync(stageDestination, { recursive: true, force: true })\n  }\n}\n\nfunction ensureClaudeExposure(canonical: string, exposure: string, dryRun = false): void {\n  const state = inspectExposure(exposure, canonical)\n  if (state.state === 'ok') return\n  if (state.state === 'conflict') throw new Error(`Claude Skill 路径已有陌生内容: ${exposure}`)\n  if (dryRun) return\n  mkdirSync(dirname(exposure), { recursive: true })\n  const target = relative(dirname(exposure), canonical) || '.'\n  try {\n    symlinkSync(target, exposure, 'dir')\n  } catch (error) {\n    throw new Error(\n      `无法为 Claude Code 创建 Skill symlink: ${String(error.message || error)}；` +\n      '请检查 ~/.claude/skills 的写权限',\n    )\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  const target = resolve(dirname(exposure), raw)\n  return target === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction markerFor(bundled: ReturnType<typeof bundledInfo>): InstallMarker {\n  return {\n    $schema: 'dingtalk-agent/managed-skill@1',\n    manager: MANAGER,\n    packageVersion: bundled.packageVersion,\n    skillVersion: bundled.skillVersion,\n    sourceHash: bundled.hash,\n    installedAt: new Date().toISOString(),\n    exposure: { claude: 'symlink' },\n  }\n}\n\nfunction readMarker(skillRoot: string): InstallMarker | null {\n  const path = join(skillRoot, MARKER)\n  if (!existsSync(path)) return null\n  try {\n    const value = JSON.parse(readFileSync(path, 'utf8'))\n    return value?.$schema === 'dingtalk-agent/managed-skill@1' ? value : null\n  } catch { return null }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction validateSkill(root: string): void {\n  if (!existsSync(root) || !lstatSync(root).isDirectory()) {\n    throw new Error(`内置 Skill 不存在: ${root}`)\n  }\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 !== GLOBAL_SKILL_NAME) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${GLOBAL_SKILL_NAME} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\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 hashDirectory(root: string): string {\n  const hash = createHash('sha256')\n  for (const path of walk(root)) {\n    const rel = relative(root, path).split('\\\\').join('/')\n    if (rel === MARKER) continue\n    hash.update(rel).update('\\0').update(readFileSync(path)).update('\\0')\n  }\n  return hash.digest('hex')\n}\n\nfunction walk(root: string): string[] {\n  const out: string[] = []\n  for (const name of readdirSync(root).sort()) {\n    const path = join(root, name)\n    const stat = lstatSync(path)\n    if (stat.isSymbolicLink()) throw new Error(`Skill 内不允许符号链接: ${path}`)\n    if (stat.isDirectory()) out.push(...walk(path))\n    else if (stat.isFile()) out.push(path)\n  }\n  return out\n}\n"]}
+{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/skill-manager.ts"],"names":[],"mappings":"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","sourcesContent":["// 全局 Skill 生命周期：一个 canonical copy，按 Agent 客户端暴露。\n//\n// canonical: ~/.agents/skills/dingtalk-basic-behavior\n// Claude:    ~/.claude/skills/dingtalk-basic-behavior -> canonical\n//\n// 不链接 npm/node_modules：包升级、卸载或 npx cache 清理都不应让 Skill 断掉。\n\nimport {\n  cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync,\n  readdirSync, renameSync, rmSync, symlinkSync, writeFileSync,\n} from 'node:fs'\nimport { createHash, randomUUID } from 'node:crypto'\nimport { homedir } from 'node:os'\nimport { dirname, join, relative, resolve } from 'node:path'\n\nexport const GLOBAL_SKILL_NAME = 'dingtalk-basic-behavior'\nconst MARKER = '.dingtalk-agent-install.json'\nconst MANAGER = '@xdxer/dingtalk-agent'\n\ninterface InstallMarker {\n  $schema: 'dingtalk-agent/managed-skill@1'\n  manager: typeof MANAGER\n  packageVersion: string\n  skillVersion: string\n  sourceHash: string\n  installedAt: string\n  exposure: { claude: 'symlink' }\n}\n\nexport interface SkillManagerOptions {\n  home?: string\n  dryRun?: boolean\n  discardLocalChanges?: boolean\n}\n\nexport interface GlobalSkillStatus {\n  $schema: 'dingtalk-agent/skill-status@1'\n  name: string\n  bundled: { path: string; packageVersion: string; skillVersion: string; hash: string }\n  canonical: {\n    path: string\n    exists: boolean\n    managed: boolean\n    installedHash: string\n    modified: boolean\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  legacyCodex: { path: string; conflict: boolean }\n}\n\nexport function skillStatus(packageRoot: string, options: SkillManagerOptions = {}): GlobalSkillStatus {\n  const paths = globalPaths(packageRoot, options.home)\n  const bundled = bundledInfo(packageRoot)\n  const marker = readMarker(paths.canonical)\n  const canonicalExists = pathExists(paths.canonical)\n  const canonicalDirectory = canonicalExists && lstatSync(paths.canonical).isDirectory()\n  const installedHash = canonicalDirectory ? hashDirectory(paths.canonical) : ''\n  const managed = marker?.manager === MANAGER\n  const modified = Boolean(managed && installedHash !== marker?.sourceHash)\n  const claude = inspectExposure(paths.claude, paths.canonical)\n  const sharedState = canonicalExists ? 'ok' : 'missing'\n  return {\n    $schema: 'dingtalk-agent/skill-status@1',\n    name: GLOBAL_SKILL_NAME,\n    bundled,\n    canonical: {\n      path: paths.canonical,\n      exists: canonicalExists,\n      managed,\n      installedHash,\n      modified,\n      current: Boolean(managed && !modified && installedHash === bundled.hash),\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    legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },\n  }\n}\n\nexport function installGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (before.canonical.exists) {\n    if (!before.canonical.managed) {\n      throw new Error(`全局 Skill 同名目录不归 dingtalk-agent 管理，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (before.canonical.modified) {\n      throw new Error(`全局 Skill 有本地修改，拒绝覆盖: ${before.canonical.path}`)\n    }\n    if (!before.canonical.current) {\n      throw new Error('已安装版本不是当前内置版本；请运行 `dingtalk-agent skill upgrade`')\n    }\n    ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n    return options.dryRun ? before : skillStatus(packageRoot, options)\n  }\n\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun) {\n    installCanonical(packageRoot, before.canonical.path)\n    ensureClaudeExposure(before.canonical.path, before.claude.path, false)\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function upgradeGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return installGlobalSkill(packageRoot, options)\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝接管: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (before.claude.state === 'conflict') {\n    throw new Error(`Claude Skill 路径已有陌生内容，拒绝覆盖: ${before.claude.path}`)\n  }\n  if (!options.dryRun && !before.canonical.current) {\n    replaceCanonical(packageRoot, before.canonical.path)\n  }\n  ensureClaudeExposure(before.canonical.path, before.claude.path, options.dryRun)\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nexport function uninstallGlobalSkill(\n  packageRoot: string,\n  options: SkillManagerOptions = {},\n): GlobalSkillStatus {\n  const before = skillStatus(packageRoot, options)\n  if (!before.canonical.exists) return before\n  if (!before.canonical.managed) {\n    throw new Error(`全局 Skill 不归 dingtalk-agent 管理，拒绝删除: ${before.canonical.path}`)\n  }\n  if (before.canonical.modified && !options.discardLocalChanges) {\n    throw new Error(\n      '全局 Skill 有本地修改；先保存改动，或显式使用 `--discard-local-changes` 放弃修改',\n    )\n  }\n  if (!options.dryRun) {\n    if (before.claude.state === 'ok') rmSync(before.claude.path)\n    rmSync(before.canonical.path, { recursive: true, force: true })\n  }\n  return options.dryRun ? before : skillStatus(packageRoot, options)\n}\n\nfunction globalPaths(packageRoot: string, home = homedir()) {\n  return {\n    source: join(packageRoot, 'skills', GLOBAL_SKILL_NAME),\n    canonical: join(home, '.agents', 'skills', GLOBAL_SKILL_NAME),\n    claude: join(home, '.claude', 'skills', GLOBAL_SKILL_NAME),\n    legacyCodex: join(home, '.codex', 'skills', GLOBAL_SKILL_NAME),\n  }\n}\n\nfunction bundledInfo(packageRoot: string) {\n  const paths = globalPaths(packageRoot)\n  validateSkill(paths.source)\n  const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))\n  const frontmatter = parseSkillFrontmatter(readFileSync(join(paths.source, 'SKILL.md'), 'utf8'))\n  return {\n    path: paths.source,\n    packageVersion: String(pkg.version || ''),\n    skillVersion: frontmatter.version,\n    hash: hashDirectory(paths.source),\n  }\n}\n\nfunction installCanonical(packageRoot: string, destination: string): void {\n  const source = globalPaths(packageRoot).source\n  const bundled = bundledInfo(packageRoot)\n  const parent = dirname(destination)\n  mkdirSync(parent, { recursive: true })\n  const stage = join(parent, `.${GLOBAL_SKILL_NAME}.stage.${process.pid}.${randomUUID()}`)\n  try {\n    cpSync(source, stage, { recursive: true, errorOnExist: true, force: false })\n    writeFileSync(join(stage, MARKER), JSON.stringify(markerFor(bundled), null, 2) + '\\n', { flag: 'wx' })\n    validateSkill(stage)\n    if (hashDirectory(stage) !== bundled.hash) throw new Error('Skill staging hash 与内置版本不一致')\n    renameSync(stage, destination)\n  } finally {\n    rmSync(stage, { recursive: true, force: true })\n  }\n}\n\nfunction replaceCanonical(packageRoot: string, destination: string): void {\n  const parent = dirname(destination)\n  const backup = join(parent, `.${GLOBAL_SKILL_NAME}.backup.${process.pid}.${randomUUID()}`)\n  const stageDestination = join(parent, `.${GLOBAL_SKILL_NAME}.next.${process.pid}.${randomUUID()}`)\n  installCanonical(packageRoot, stageDestination)\n  renameSync(destination, backup)\n  try {\n    renameSync(stageDestination, destination)\n    rmSync(backup, { recursive: true, force: true })\n  } catch (error) {\n    if (!existsSync(destination) && existsSync(backup)) renameSync(backup, destination)\n    throw error\n  } finally {\n    rmSync(stageDestination, { recursive: true, force: true })\n  }\n}\n\nfunction ensureClaudeExposure(canonical: string, exposure: string, dryRun = false): void {\n  const state = inspectExposure(exposure, canonical)\n  if (state.state === 'ok') return\n  if (state.state === 'conflict') throw new Error(`Claude Skill 路径已有陌生内容: ${exposure}`)\n  if (dryRun) return\n  mkdirSync(dirname(exposure), { recursive: true })\n  const target = relative(dirname(exposure), canonical) || '.'\n  try {\n    symlinkSync(target, exposure, 'dir')\n  } catch (error) {\n    throw new Error(\n      `无法为 Claude Code 创建 Skill symlink: ${String(error.message || error)}；` +\n      '请检查 ~/.claude/skills 的写权限',\n    )\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  const target = resolve(dirname(exposure), raw)\n  return target === resolve(canonical)\n    ? { state: 'ok', target: raw }\n    : { state: 'conflict', target: raw }\n}\n\nfunction markerFor(bundled: ReturnType<typeof bundledInfo>): InstallMarker {\n  return {\n    $schema: 'dingtalk-agent/managed-skill@1',\n    manager: MANAGER,\n    packageVersion: bundled.packageVersion,\n    skillVersion: bundled.skillVersion,\n    sourceHash: bundled.hash,\n    installedAt: new Date().toISOString(),\n    exposure: { claude: 'symlink' },\n  }\n}\n\nfunction readMarker(skillRoot: string): InstallMarker | null {\n  const path = join(skillRoot, MARKER)\n  if (!existsSync(path)) return null\n  try {\n    const value = JSON.parse(readFileSync(path, 'utf8'))\n    return value?.$schema === 'dingtalk-agent/managed-skill@1' ? value : null\n  } catch { return null }\n}\n\nfunction pathExists(path: string): boolean {\n  try { lstatSync(path); return true } catch { return false }\n}\n\nfunction validateSkill(root: string): void {\n  if (!existsSync(root) || !lstatSync(root).isDirectory()) {\n    throw new Error(`内置 Skill 不存在: ${root}`)\n  }\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 !== GLOBAL_SKILL_NAME) {\n    throw new Error(`Skill name=${metadata.name} 与目录名 ${GLOBAL_SKILL_NAME} 不一致`)\n  }\n  if (!metadata.description) throw new Error('Skill frontmatter 缺少 description')\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 hashDirectory(root: string): string {\n  const hash = createHash('sha256')\n  for (const path of walk(root)) {\n    const rel = relative(root, path).split('\\\\').join('/')\n    if (rel === MARKER) continue\n    hash.update(rel).update('\\0').update(readFileSync(path)).update('\\0')\n  }\n  return hash.digest('hex')\n}\n\nfunction walk(root: string): string[] {\n  const out: string[] = []\n  for (const name of readdirSync(root).sort()) {\n    const path = join(root, name)\n    const stat = lstatSync(path)\n    if (stat.isSymbolicLink()) throw new Error(`Skill 内不允许符号链接: ${path}`)\n    if (stat.isDirectory()) out.push(...walk(path))\n    else if (stat.isFile()) out.push(path)\n  }\n  return out\n}\n"]}

package/docs/ARCHITECTURE.md

@@ -83,7 +83,17 @@ Why：如果把“先澄清”实现成固定追问，信息完整的任务也
 
 Claude Tag 官方的线程模型与本项目高度一致：一个 thread 是一项工作的 session；长任务使用 checklist；结果回到原 thread；空闲后沙箱释放，新回复到来时重建沙箱继续。因此持久化的是显式 checkpoint 和外部成果，不是 JavaScript/LLM 隐藏栈。
 
-## 初始化为什么是可选的
+## 机器 Setup 与 Workspace Init 为什么分开
+
+机器首次使用从不会依赖全局 PATH 的入口开始：
+
+```bash
+npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup
+```
+
+`setup` 只处理用户级 CLI、PATH、DWS 健康/认证和全局 Skill；它不初始化当前代码仓库。普通 Session 随后直接 `bootstrap`，只有需要长期 Workspace 或 Prepared Run 时才 `init`。三者分开，避免把“机器缺命令”“Agent 缺行为”和“当前目录需要持久状态”混成一个不可恢复的大初始化。
+
+## Workspace 初始化为什么是可选的
 
 全局安装一次：
 
@@ -204,4 +214,4 @@ npm run typecheck
 npm run eval:contract
 ```
 
-26 个确定性场景覆盖两条主链：Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。
+28 个确定性场景覆盖三条主链：setup/PATH/DWS/多客户端发现、Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。

package/docs/INSTALLATION.md

@@ -0,0 +1,135 @@
+# 安装与首次使用
+
+## 推荐入口
+
+首次使用永远从 `npx` 开始：
+
+```bash
+npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup
+```
+
+Why：npm 全局命令会被链接到 `{prefix}/bin`，但不同 Node 版本管理器可能使用不同 prefix；包已经安装不代表该目录已进入当前 shell 的 PATH。`npx`/`npm exec` 会直接运行指定 npm 包，因此可以先启动安装器，再由安装器修复稳定入口。
+
+## setup 做什么
+
+```text
+npx bootstrap
+  → 安装当前版本到 ~/.local/bin
+  → 检查并幂等补充 ~/.zshrc / ~/.bashrc PATH
+  → 安装 canonical Basic Behavior Skill
+  → 暴露给 Claude Code，验证 Codex/OpenCode 共享发现
+  → 检查 DWS 版本和认证
+  → 给出唯一下一条命令
+```
+
+默认不会初始化当前代码仓库，也不会创建 Workspace。`init` 只属于需要持久身份或 Prepared Run 的场景。
+
+### PATH
+
+CLI 固定安装到用户级 prefix：
+
+```text
+~/.local/bin/dingtalk-agent
+~/.local/bin/dta
+```
+
+如果 `~/.local/bin` 不在 PATH，setup 会向当前 shell 对应的 `~/.zshrc` 或 `~/.bashrc` 追加一个带标记的受管区块，不会覆盖已有配置。子进程不能修改父 shell 的环境，所以当前终端还需要执行 setup 输出的命令，或打开新终端：
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+不希望修改 shell 配置时：
+
+```bash
+npx --yes --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@beta setup --no-shell-write
+```
+
+### DWS
+
+`doctor` 分开检查：
+
+1. `dws` 是否在 PATH；
+2. `dws version --format json` 是否可运行且版本不低于 1.0.15；
+3. `dws auth status --format json` 是否已认证且 token 有效。
+
+常见修复：
+
+```bash
+dws doctor
+dws upgrade
+dws auth login
+```
+
+这些都是诊断或认证动作；setup 不会替用户发送消息、写文档或创建待办。
+
+## Skill 安装策略
+
+`dingtalk-agent skill install` 使用一份 canonical copy，避免 npm cache 清理或包升级导致软链接断裂：
+
+| 客户端 | 发现方式 | 路径 |
+|---|---|---|
+| Claude Code | 相对 symlink | `~/.claude/skills/dingtalk-basic-behavior` |
+| Codex | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
+| OpenCode | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
+
+安装器不会覆盖陌生同名目录，也不会静默覆盖用户对受管 Skill 的本地修改。检查和升级：
+
+```bash
+dingtalk-agent skill status
+dingtalk-agent skill upgrade
+```
+
+OpenCode 官方同时支持 `.opencode/skills`、`.claude/skills` 和 `.agents/skills`，所以不需要再复制第三份内容。
+
+## 使用 npx skills
+
+项目结构符合 Agent Skills 规范，因此也可以使用开放生态的安装器：
+
+```bash
+# 有仓库权限
+npx skills add D1-2004/dingtalk-agent \
+  --skill dingtalk-basic-behavior --global --yes \
+  --agent claude-code --agent codex --agent opencode
+
+# 本地 checkout
+npx skills add ./skills/dingtalk-basic-behavior \
+  --global --yes --agent claude-code --agent codex --agent opencode
+```
+
+两种管理器不要交叉覆盖同一个安装。`dingtalk-agent` 发现 canonical 目录不归自己管理时会 fail closed；此时继续使用 `npx skills update/remove` 管理即可。
+
+## 初始化的三个层级
+
+```text
+setup      机器级，一次：CLI、PATH、DWS、全局 Skill
+bootstrap  Session 级，按需：发现本地/远端身份、记忆和知识
+init       Workspace 级，可选：只为长期 Workspace / Prepared Run 创建最小 manifest
+```
+
+普通 Claude Code、Codex 或 OpenCode 会话：
+
+```bash
+dingtalk-agent bootstrap --json
+```
+
+需要可信钉钉事件、Session/Run/Wait/Receipt 时才执行：
+
+```bash
+dingtalk-agent init
+dingtalk-agent prepare --event-file event.json --json
+```
+
+## Doctor 退出码
+
+- `0`：PATH、DWS、认证和 Skill 均 ready；
+- `2`：至少一个必要条件不满足，同时输出确定的修复命令；
+- `--json`：输出 `dingtalk-agent/doctor@1`，供安装器、CI 或宿主解析。
+
+## 设计依据
+
+- [npm Folders](https://docs.npmjs.com/files/folders.html/)：Unix 全局 executable 被链接到 `{prefix}/bin`；
+- [Claude Code Skills](https://code.claude.com/docs/en/slash-commands)：个人 Skill 使用 `~/.claude/skills/<name>/SKILL.md`；
+- [OpenCode Agent Skills](https://opencode.ai/docs/skills)：同时发现 `~/.config/opencode/skills`、`~/.claude/skills` 和 `~/.agents/skills`；
+- [OpenAI Skills](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)：Codex 支持遵循开放 Agent Skills 标准的 Skill；
+- [skills CLI](https://github.com/vercel-labs/skills)：`npx skills add` 支持 Claude Code、Codex、OpenCode 和本地/Git source。

package/evals/evals.json

@@ -288,6 +288,29 @@
         "没有 Prepared Run 时 act reply fail closed",
         "失败不会偷偷初始化 Workspace"
       ]
+    },
+    {
+      "id": 27,
+      "prompt": "在一个全新 HOME、空 PATH 中通过绝对 Node 路径运行 dingtalk-agent doctor。",
+      "expected_output": "doctor 不崩溃，分别指出 CLI PATH、DWS 和认证缺失，并给出 npx setup 与 dws auth login 的确定修复命令。",
+      "files": [],
+      "expectations": [
+        "PATH 缺少 CLI 时 doctor 返回 not ready",
+        "DWS 缺失与认证不可检查被分别报告",
+        "诊断包含可复制执行的 npx setup 和 DWS 登录步骤"
+      ]
+    },
+    {
+      "id": 28,
+      "prompt": "在隔离 HOME 中通过本地 npm 包执行一次 setup，PATH 里只有 npm 与 fake DWS。",
+      "expected_output": "setup 把 CLI 安装到 ~/.local/bin，幂等写入 shell PATH，安装 canonical Skill，并让 Claude Code、Codex、OpenCode 与 DWS 检查全部 ready。",
+      "files": [],
+      "expectations": [
+        "用户级 CLI 被安装且可执行 --version",
+        "shell rc 只追加受管的 ~/.local/bin PATH 块",
+        "canonical Skill 与 Claude exposure 安装成功，三个 Agent 客户端均可发现",
+        "DWS 版本和认证检查通过，setup 最终 ready"
+      ]
     }
   ]
 }

package/evals/run-contract-evals.mjs

@@ -42,6 +42,7 @@ const cases = [
   evalWorkspaceAuthority, evalSessionSkillBinding,
   evalGlobalSkillInstall, evalBootstrapLocal, evalBootstrapRemote, evalOptionalInit,
   evalManagedSkillLifecycle, evalRemoteStorageTypeGate, evalDirectActGate,
+  evalDoctorMissingDependencies, evalFirstRunSetup,
 ]
 const benchmarkRuns = []
 for (let i = 0; i < cases.length; i++) {
@@ -117,6 +118,7 @@ if (process.argv.includes('--smoke')) {
 } else {
   console.log(JSON.stringify({ results: RESULTS, passRate: mean, evals: benchmarkRuns.length }, null, 2))
 }
+if (mean !== 1) process.exitCode = 1
 
 function evalMentioned() {
   const { root, cfg } = workspace()
@@ -952,6 +954,77 @@ function evalDirectActGate() {
   }
 }
 
+function evalDoctorMissingDependencies() {
+  const home = mkdtempSync(join(tmpdir(), 'dta-doctor-missing-home-'))
+  const cwd = mkdtempSync(join(tmpdir(), 'dta-doctor-missing-cwd-'))
+  WORKSPACES.push(home, cwd)
+  const run = spawnSync(process.execPath, [CLI, 'doctor', '--json'], {
+    cwd,
+    env: { ...process.env, HOME: home, PATH: '' },
+    encoding: 'utf8',
+  })
+  const out = JSON.parse(run.stdout)
+  const byId = Object.fromEntries(out.checks.map((check) => [check.id, check]))
+  return {
+    output: { status: run.status, report: out }, toolCalls: 1, steps: 3,
+    checks: [
+      check(run.status === 2 && out.ready === false && byId.cli.level === 'fail',
+        `status=${run.status}; ready=${out.ready}; cli=${byId.cli.level}`),
+      check(byId.dws.level === 'fail' && byId['dws-auth'].level === 'fail',
+        `dws=${byId.dws.level}; auth=${byId['dws-auth'].level}`),
+      check(out.nextSteps.some((step) => step.includes('npx --yes')) &&
+        out.nextSteps.some((step) => step.includes('dws auth login')),
+      JSON.stringify(out.nextSteps)),
+    ],
+  }
+}
+
+function evalFirstRunSetup() {
+  const home = mkdtempSync(join(tmpdir(), 'dta-setup-home-'))
+  const cwd = mkdtempSync(join(tmpdir(), 'dta-setup-cwd-'))
+  WORKSPACES.push(home, cwd)
+  const fakeBin = enableFakeDws(cwd)
+  const env = {
+    ...process.env,
+    HOME: home,
+    SHELL: '/bin/zsh',
+    PATH: `${fakeBin}:${process.env.PATH || ''}`,
+    DTA_SETUP_PACKAGE_SOURCE: ROOT,
+  }
+  const run = spawnSync(process.execPath, [CLI, 'setup', '--json'], {
+    cwd, env, encoding: 'utf8', timeout: 120_000,
+  })
+  const out = run.stdout ? JSON.parse(run.stdout) : null
+  const executable = join(home, '.local', 'bin', 'dingtalk-agent')
+  const version = existsSync(executable)
+    ? spawnSync(executable, ['--version'], { env, encoding: 'utf8' })
+    : { status: -1, stdout: '' }
+  const rc = existsSync(join(home, '.zshrc')) ? readFileSync(join(home, '.zshrc'), 'utf8') : ''
+  const canonical = join(home, '.agents', 'skills', 'dingtalk-basic-behavior')
+  const claude = join(home, '.claude', 'skills', 'dingtalk-basic-behavior')
+  return {
+    output: {
+      status: run.status, stderr: run.stderr.trim(), report: out,
+      executable, version: String(version.stdout || '').trim(), rc,
+    },
+    toolCalls: 1, steps: 6,
+    checks: [
+      check(run.status === 0 && existsSync(executable) && version.status === 0,
+        `status=${run.status}; executable=${existsSync(executable)}; version=${version.status}`),
+      check(out?.shell.updated === true && rc.includes('dingtalk-agent PATH') &&
+        rc.includes('$HOME/.local/bin'),
+      `updated=${out?.shell.updated}; rc=${JSON.stringify(rc)}`),
+      check(existsSync(join(canonical, 'SKILL.md')) && lstatSync(claude).isSymbolicLink() &&
+        out?.skill.clients.every((client) => client.state === 'ok'),
+      `canonical=${existsSync(canonical)}; clients=${JSON.stringify(out?.skill.clients)}`),
+      check(out?.doctor.ready === true &&
+        out.doctor.checks.find((check) => check.id === 'dws')?.level === 'pass' &&
+        out.doctor.checks.find((check) => check.id === 'dws-auth')?.level === 'pass',
+      `ready=${out?.doctor.ready}; checks=${JSON.stringify(out?.doctor.checks)}`),
+    ],
+  }
+}
+
 function dmEvent(eventId, messageId, actor, text, extra = {}) {
   return {
     event_corp_id: extra.tenantId || 'tenant-wait-eval',
@@ -977,10 +1050,12 @@ function enableFakeDws(root) {
 
   const bin = join(root, '.fake-bin')
   mkdirSync(bin, { recursive: true })
-  const script = join(bin, 'dws')
+const script = join(bin, 'dws')
   writeFileSync(script, `#!/usr/bin/env node
 const a = process.argv.slice(2)
 let data = {}
+if (a[0] === 'version') { console.log(JSON.stringify({ version: 'v1.0.99-test' })); process.exit(0) }
+if (a[0] === 'auth' && a[1] === 'status') { console.log(JSON.stringify({ authenticated: true, token_valid: true, corp_name: 'Test Corp', user_name: 'Test User' })); process.exit(0) }
 if (a.includes('get-self')) data = { userId: 'agent-eval' }
 else if (a.includes('doc') && a.includes('read')) data = { markdown: '# Remote Memory\\n\\n来自钉钉文档。' }
 else if (a.includes('doc') && a.includes('info')) data = { contentType: 'ALIDOC', extension: process.env.DTA_FAKE_DOC_EXTENSION || 'adoc', nodeType: 'file' }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdxer/dingtalk-agent",
-  "version": "0.1.2",
+  "version": "0.1.4-beta.1",
   "description": "钉钉数字员工的 Skill-first 行为范式：全局 Skill 决策，CLI 固定事务边界，Workspace 按需。",
   "keywords": [
     "dingtalk",