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

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 (15) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +223 -53
  3. package/dist/bin/dingtalk-agent.js +81 -3
  4. package/dist/bin/dingtalk-agent.js.map +1 -1
  5. package/dist/src/doctor.js +166 -0
  6. package/dist/src/doctor.js.map +1 -0
  7. package/dist/src/setup.js +101 -0
  8. package/dist/src/setup.js.map +1 -0
  9. package/dist/src/skill-manager.js +15 -0
  10. package/dist/src/skill-manager.js.map +1 -1
  11. package/docs/ARCHITECTURE.md +12 -2
  12. package/docs/INSTALLATION.md +135 -0
  13. package/evals/evals.json +23 -0
  14. package/evals/run-contract-evals.mjs +76 -1
  15. package/package.json +1 -1
package/dist/src/setup.js.map ADDED
@@ -0,0 +1 @@
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 CHANGED
@@ -21,6 +21,7 @@ export function skillStatus(packageRoot, options = {}) {
21
21
  const managed = marker?.manager === MANAGER;
22
22
  const modified = Boolean(managed && installedHash !== marker?.sourceHash);
23
23
  const claude = inspectExposure(paths.claude, paths.canonical);
24
+ const sharedState = canonicalExists ? 'ok' : 'missing';
24
25
  return {
25
26
  $schema: 'dingtalk-agent/skill-status@1',
26
27
  name: GLOBAL_SKILL_NAME,
@@ -34,6 +35,20 @@ export function skillStatus(packageRoot, options = {}) {
34
35
  current: Boolean(managed && !modified && installedHash === bundled.hash),
35
36
  },
36
37
  claude: { path: paths.claude, ...claude },
38
+ clients: [
39
+ {
40
+ name: 'claude-code', label: 'Claude Code', discovery: 'symlink',
41
+ path: paths.claude, state: claude.state,
42
+ },
43
+ {
44
+ name: 'codex', label: 'Codex', discovery: 'shared-agent-skills',
45
+ path: paths.canonical, state: sharedState,
46
+ },
47
+ {
48
+ name: 'opencode', label: 'OpenCode', discovery: 'shared-agent-skills',
49
+ path: paths.canonical, state: sharedState,
50
+ },
51
+ ],
37
52
  legacyCodex: { path: paths.legacyCodex, conflict: pathExists(paths.legacyCodex) },
38
53
  };
39
54
  }
package/dist/src/skill-manager.js.map CHANGED
@@ -1 +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"]}
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 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 CHANGED
@@ -83,7 +83,17 @@ Why：如果把“先澄清”实现成固定追问，信息完整的任务也
83
83
 
84
84
  Claude Tag 官方的线程模型与本项目高度一致：一个 thread 是一项工作的 session；长任务使用 checklist；结果回到原 thread；空闲后沙箱释放，新回复到来时重建沙箱继续。因此持久化的是显式 checkpoint 和外部成果，不是 JavaScript/LLM 隐藏栈。
85
85
 
86
- ## 初始化为什么是可选的
86
+ ## 机器 Setup 与 Workspace Init 为什么分开
87
+
88
+ 机器首次使用从不会依赖全局 PATH 的入口开始：
89
+
90
+ ```bash
91
+ npx --yes @xdxer/dingtalk-agent@beta setup
92
+ ```
93
+
94
+ `setup` 只处理用户级 CLI、PATH、DWS 健康/认证和全局 Skill；它不初始化当前代码仓库。普通 Session 随后直接 `bootstrap`，只有需要长期 Workspace 或 Prepared Run 时才 `init`。三者分开，避免把“机器缺命令”“Agent 缺行为”和“当前目录需要持久状态”混成一个不可恢复的大初始化。
95
+
96
+ ## Workspace 初始化为什么是可选的
87
97
 
88
98
  全局安装一次：
89
99
 
@@ -204,4 +214,4 @@ npm run typecheck
204
214
  npm run eval:contract
205
215
  ```
206
216
 
207
- 26 个确定性场景覆盖两条主链：Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。
217
+ 28 个确定性场景覆盖三条主链：setup/PATH/DWS/多客户端发现、Skill-first 安装/水合，以及 Prepared Run 的 Session、Wait、幂等、目标与回执。
package/docs/INSTALLATION.md ADDED
@@ -0,0 +1,135 @@
1
+ # 安装与首次使用
2
+
3
+ ## 推荐入口
4
+
5
+ 首次使用永远从 `npx` 开始：
6
+
7
+ ```bash
8
+ npx --yes @xdxer/dingtalk-agent@beta setup
9
+ ```
10
+
11
+ Why：npm 全局命令会被链接到 `{prefix}/bin`，但不同 Node 版本管理器可能使用不同 prefix；包已经安装不代表该目录已进入当前 shell 的 PATH。`npx`/`npm exec` 会直接运行指定 npm 包，因此可以先启动安装器，再由安装器修复稳定入口。
12
+
13
+ ## setup 做什么
14
+
15
+ ```text
16
+ npx bootstrap
17
+ → 安装当前版本到 ~/.local/bin
18
+ → 检查并幂等补充 ~/.zshrc / ~/.bashrc PATH
19
+ → 安装 canonical Basic Behavior Skill
20
+ → 暴露给 Claude Code，验证 Codex/OpenCode 共享发现
21
+ → 检查 DWS 版本和认证
22
+ → 给出唯一下一条命令
23
+ ```
24
+
25
+ 默认不会初始化当前代码仓库，也不会创建 Workspace。`init` 只属于需要持久身份或 Prepared Run 的场景。
26
+
27
+ ### PATH
28
+
29
+ CLI 固定安装到用户级 prefix：
30
+
31
+ ```text
32
+ ~/.local/bin/dingtalk-agent
33
+ ~/.local/bin/dta
34
+ ```
35
+
36
+ 如果 `~/.local/bin` 不在 PATH，setup 会向当前 shell 对应的 `~/.zshrc` 或 `~/.bashrc` 追加一个带标记的受管区块，不会覆盖已有配置。子进程不能修改父 shell 的环境，所以当前终端还需要执行 setup 输出的命令，或打开新终端：
37
+
38
+ ```bash
39
+ export PATH="$HOME/.local/bin:$PATH"
40
+ ```
41
+
42
+ 不希望修改 shell 配置时：
43
+
44
+ ```bash
45
+ npx --yes @xdxer/dingtalk-agent@beta setup --no-shell-write
46
+ ```
47
+
48
+ ### DWS
49
+
50
+ `doctor` 分开检查：
51
+
52
+ 1. `dws` 是否在 PATH；
53
+ 2. `dws version --format json` 是否可运行且版本不低于 1.0.15；
54
+ 3. `dws auth status --format json` 是否已认证且 token 有效。
55
+
56
+ 常见修复：
57
+
58
+ ```bash
59
+ dws doctor
60
+ dws upgrade
61
+ dws auth login
62
+ ```
63
+
64
+ 这些都是诊断或认证动作；setup 不会替用户发送消息、写文档或创建待办。
65
+
66
+ ## Skill 安装策略
67
+
68
+ `dingtalk-agent skill install` 使用一份 canonical copy，避免 npm cache 清理或包升级导致软链接断裂：
69
+
70
+ | 客户端 | 发现方式 | 路径 |
71
+ |---|---|---|
72
+ | Claude Code | 相对 symlink | `~/.claude/skills/dingtalk-basic-behavior` |
73
+ | Codex | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
74
+ | OpenCode | shared Agent Skills | `~/.agents/skills/dingtalk-basic-behavior` |
75
+
76
+ 安装器不会覆盖陌生同名目录，也不会静默覆盖用户对受管 Skill 的本地修改。检查和升级：
77
+
78
+ ```bash
79
+ dingtalk-agent skill status
80
+ dingtalk-agent skill upgrade
81
+ ```
82
+
83
+ OpenCode 官方同时支持 `.opencode/skills`、`.claude/skills` 和 `.agents/skills`，所以不需要再复制第三份内容。
84
+
85
+ ## 使用 npx skills
86
+
87
+ 项目结构符合 Agent Skills 规范，因此也可以使用开放生态的安装器：
88
+
89
+ ```bash
90
+ # 有仓库权限
91
+ npx skills add D1-2004/dingtalk-agent \
92
+ --skill dingtalk-basic-behavior --global --yes \
93
+ --agent claude-code --agent codex --agent opencode
94
+
95
+ # 本地 checkout
96
+ npx skills add ./skills/dingtalk-basic-behavior \
97
+ --global --yes --agent claude-code --agent codex --agent opencode
98
+ ```
99
+
100
+ 两种管理器不要交叉覆盖同一个安装。`dingtalk-agent` 发现 canonical 目录不归自己管理时会 fail closed；此时继续使用 `npx skills update/remove` 管理即可。
101
+
102
+ ## 初始化的三个层级
103
+
104
+ ```text
105
+ setup 机器级，一次：CLI、PATH、DWS、全局 Skill
106
+ bootstrap Session 级，按需：发现本地/远端身份、记忆和知识
107
+ init Workspace 级，可选：只为长期 Workspace / Prepared Run 创建最小 manifest
108
+ ```
109
+
110
+ 普通 Claude Code、Codex 或 OpenCode 会话：
111
+
112
+ ```bash
113
+ dingtalk-agent bootstrap --json
114
+ ```
115
+
116
+ 需要可信钉钉事件、Session/Run/Wait/Receipt 时才执行：
117
+
118
+ ```bash
119
+ dingtalk-agent init
120
+ dingtalk-agent prepare --event-file event.json --json
121
+ ```
122
+
123
+ ## Doctor 退出码
124
+
125
+ - `0`：PATH、DWS、认证和 Skill 均 ready；
126
+ - `2`：至少一个必要条件不满足，同时输出确定的修复命令；
127
+ - `--json`：输出 `dingtalk-agent/doctor@1`，供安装器、CI 或宿主解析。
128
+
129
+ ## 设计依据
130
+
131
+ - [npm Folders](https://docs.npmjs.com/files/folders.html/)：Unix 全局 executable 被链接到 `{prefix}/bin`；
132
+ - [Claude Code Skills](https://code.claude.com/docs/en/slash-commands)：个人 Skill 使用 `~/.claude/skills/<name>/SKILL.md`；
133
+ - [OpenCode Agent Skills](https://opencode.ai/docs/skills)：同时发现 `~/.config/opencode/skills`、`~/.claude/skills` 和 `~/.agents/skills`；
134
+ - [OpenAI Skills](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)：Codex 支持遵循开放 Agent Skills 标准的 Skill；
135
+ - [skills CLI](https://github.com/vercel-labs/skills)：`npx skills add` 支持 Claude Code、Codex、OpenCode 和本地/Git source。
package/evals/evals.json CHANGED
@@ -288,6 +288,29 @@
288
288
  "没有 Prepared Run 时 act reply fail closed",
289
289
  "失败不会偷偷初始化 Workspace"
290
290
  ]
291
+ },
292
+ {
293
+ "id": 27,
294
+ "prompt": "在一个全新 HOME、空 PATH 中通过绝对 Node 路径运行 dingtalk-agent doctor。",
295
+ "expected_output": "doctor 不崩溃，分别指出 CLI PATH、DWS 和认证缺失，并给出 npx setup 与 dws auth login 的确定修复命令。",
296
+ "files": [],
297
+ "expectations": [
298
+ "PATH 缺少 CLI 时 doctor 返回 not ready",
299
+ "DWS 缺失与认证不可检查被分别报告",
300
+ "诊断包含可复制执行的 npx setup 和 DWS 登录步骤"
301
+ ]
302
+ },
303
+ {
304
+ "id": 28,
305
+ "prompt": "在隔离 HOME 中通过本地 npm 包执行一次 setup，PATH 里只有 npm 与 fake DWS。",
306
+ "expected_output": "setup 把 CLI 安装到 ~/.local/bin，幂等写入 shell PATH，安装 canonical Skill，并让 Claude Code、Codex、OpenCode 与 DWS 检查全部 ready。",
307
+ "files": [],
308
+ "expectations": [
309
+ "用户级 CLI 被安装且可执行 --version",
310
+ "shell rc 只追加受管的 ~/.local/bin PATH 块",
311
+ "canonical Skill 与 Claude exposure 安装成功，三个 Agent 客户端均可发现",
312
+ "DWS 版本和认证检查通过，setup 最终 ready"
313
+ ]
291
314
  }
292
315
  ]
293
316
  }
package/evals/run-contract-evals.mjs CHANGED
@@ -42,6 +42,7 @@ const cases = [
42
42
  evalWorkspaceAuthority, evalSessionSkillBinding,
43
43
  evalGlobalSkillInstall, evalBootstrapLocal, evalBootstrapRemote, evalOptionalInit,
44
44
  evalManagedSkillLifecycle, evalRemoteStorageTypeGate, evalDirectActGate,
45
+ evalDoctorMissingDependencies, evalFirstRunSetup,
45
46
  ]
46
47
  const benchmarkRuns = []
47
48
  for (let i = 0; i < cases.length; i++) {
@@ -117,6 +118,7 @@ if (process.argv.includes('--smoke')) {
117
118
  } else {
118
119
  console.log(JSON.stringify({ results: RESULTS, passRate: mean, evals: benchmarkRuns.length }, null, 2))
119
120
  }
121
+ if (mean !== 1) process.exitCode = 1
120
122
 
121
123
  function evalMentioned() {
122
124
  const { root, cfg } = workspace()
@@ -952,6 +954,77 @@ function evalDirectActGate() {
952
954
  }
953
955
  }
954
956
 
957
+ function evalDoctorMissingDependencies() {
958
+ const home = mkdtempSync(join(tmpdir(), 'dta-doctor-missing-home-'))
959
+ const cwd = mkdtempSync(join(tmpdir(), 'dta-doctor-missing-cwd-'))
960
+ WORKSPACES.push(home, cwd)
961
+ const run = spawnSync(process.execPath, [CLI, 'doctor', '--json'], {
962
+ cwd,
963
+ env: { ...process.env, HOME: home, PATH: '' },
964
+ encoding: 'utf8',
965
+ })
966
+ const out = JSON.parse(run.stdout)
967
+ const byId = Object.fromEntries(out.checks.map((check) => [check.id, check]))
968
+ return {
969
+ output: { status: run.status, report: out }, toolCalls: 1, steps: 3,
970
+ checks: [
971
+ check(run.status === 2 && out.ready === false && byId.cli.level === 'fail',
972
+ `status=${run.status}; ready=${out.ready}; cli=${byId.cli.level}`),
973
+ check(byId.dws.level === 'fail' && byId['dws-auth'].level === 'fail',
974
+ `dws=${byId.dws.level}; auth=${byId['dws-auth'].level}`),
975
+ check(out.nextSteps.some((step) => step.includes('npx --yes')) &&
976
+ out.nextSteps.some((step) => step.includes('dws auth login')),
977
+ JSON.stringify(out.nextSteps)),
978
+ ],
979
+ }
980
+ }
981
+
982
+ function evalFirstRunSetup() {
983
+ const home = mkdtempSync(join(tmpdir(), 'dta-setup-home-'))
984
+ const cwd = mkdtempSync(join(tmpdir(), 'dta-setup-cwd-'))
985
+ WORKSPACES.push(home, cwd)
986
+ const fakeBin = enableFakeDws(cwd)
987
+ const env = {
988
+ ...process.env,
989
+ HOME: home,
990
+ SHELL: '/bin/zsh',
991
+ PATH: `${fakeBin}:${process.env.PATH || ''}`,
992
+ DTA_SETUP_PACKAGE_SOURCE: ROOT,
993
+ }
994
+ const run = spawnSync(process.execPath, [CLI, 'setup', '--json'], {
995
+ cwd, env, encoding: 'utf8', timeout: 120_000,
996
+ })
997
+ const out = run.stdout ? JSON.parse(run.stdout) : null
998
+ const executable = join(home, '.local', 'bin', 'dingtalk-agent')
999
+ const version = existsSync(executable)
1000
+ ? spawnSync(executable, ['--version'], { env, encoding: 'utf8' })
1001
+ : { status: -1, stdout: '' }
1002
+ const rc = existsSync(join(home, '.zshrc')) ? readFileSync(join(home, '.zshrc'), 'utf8') : ''
1003
+ const canonical = join(home, '.agents', 'skills', 'dingtalk-basic-behavior')
1004
+ const claude = join(home, '.claude', 'skills', 'dingtalk-basic-behavior')
1005
+ return {
1006
+ output: {
1007
+ status: run.status, stderr: run.stderr.trim(), report: out,
1008
+ executable, version: String(version.stdout || '').trim(), rc,
1009
+ },
1010
+ toolCalls: 1, steps: 6,
1011
+ checks: [
1012
+ check(run.status === 0 && existsSync(executable) && version.status === 0,
1013
+ `status=${run.status}; executable=${existsSync(executable)}; version=${version.status}`),
1014
+ check(out?.shell.updated === true && rc.includes('dingtalk-agent PATH') &&
1015
+ rc.includes('$HOME/.local/bin'),
1016
+ `updated=${out?.shell.updated}; rc=${JSON.stringify(rc)}`),
1017
+ check(existsSync(join(canonical, 'SKILL.md')) && lstatSync(claude).isSymbolicLink() &&
1018
+ out?.skill.clients.every((client) => client.state === 'ok'),
1019
+ `canonical=${existsSync(canonical)}; clients=${JSON.stringify(out?.skill.clients)}`),
1020
+ check(out?.doctor.ready === true &&
1021
+ out.doctor.checks.find((check) => check.id === 'dws')?.level === 'pass' &&
1022
+ out.doctor.checks.find((check) => check.id === 'dws-auth')?.level === 'pass',
1023
+ `ready=${out?.doctor.ready}; checks=${JSON.stringify(out?.doctor.checks)}`),
1024
+ ],
1025
+ }
1026
+ }
1027
+
955
1028
  function dmEvent(eventId, messageId, actor, text, extra = {}) {
956
1029
  return {
957
1030
  event_corp_id: extra.tenantId || 'tenant-wait-eval',
@@ -977,10 +1050,12 @@ function enableFakeDws(root) {
977
1050
 
978
1051
  const bin = join(root, '.fake-bin')
979
1052
  mkdirSync(bin, { recursive: true })
980
- const script = join(bin, 'dws')
1053
+ const script = join(bin, 'dws')
981
1054
  writeFileSync(script, `#!/usr/bin/env node
982
1055
  const a = process.argv.slice(2)
983
1056
  let data = {}
1057
+ if (a[0] === 'version') { console.log(JSON.stringify({ version: 'v1.0.99-test' })); process.exit(0) }
1058
+ 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) }
984
1059
  if (a.includes('get-self')) data = { userId: 'agent-eval' }
985
1060
  else if (a.includes('doc') && a.includes('read')) data = { markdown: '# Remote Memory\\n\\n来自钉钉文档。' }
986
1061
  else if (a.includes('doc') && a.includes('info')) data = { contentType: 'ALIDOC', extension: process.env.DTA_FAKE_DOC_EXTENSION || 'adoc', nodeType: 'file' }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xdxer/dingtalk-agent",
3
- "version": "0.1.2",
3
+ "version": "0.1.4-beta.0",
4
4
  "description": "钉钉数字员工的 Skill-first 行为范式：全局 Skill 决策，CLI 固定事务边界，Workspace 按需。",
5
5
  "keywords": [
6
6
  "dingtalk",