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

package/dist/bin/dingtalk-agent.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
 // dingtalk-agent —— 钉钉数字员工的标准范式（TypeScript source）。
 //
-//   CLI   = 拦   标准动作：可程序化、可强制、可验证。撞上去没得商量。
 //   Skill = 劝   判断：只有 LLM 能做的（该不该答、话题归属、怎么写点评）。
-//   本体  = 记   它是谁 + 它知道什么。git clone 就带走。
+//   CLI   = 拦   标准动作：可程序化、可强制、可验证。撞上去没得商量。
+//   DWS   = 做   真正的钉钉产品能力；本文件只在需要冻结事务边界时包一层。
 //
-// **分界线：凡是能程序化的，收进 CLI；凡是需要判断的，留在 Skill。**
+// 本体（AGENTS.md + Role Skills）负责"它是谁、它知道什么"，git clone 就带走；
+// 它是被上面三者加载和校验的对象，不是第四个执行者。
 //
+// **分界线：凡是能程序化的，收进 CLI；凡是需要判断的，留在 Skill。**
 // 因为：文档会被漏读、误读、自我说服；**撞到闸门上就没得商量。**
+//
+// 完整架构见 docs/ARCHITECTURE.md。
 import { parseArgs } from 'node:util';
 import { join, relative, resolve } from 'node:path';
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
@@ -38,7 +42,8 @@ import { upgradeAgent } from '../src/upgrade.js';
 import { checkpointTask, showTaskCheckpoint } from '../src/memory/task-checkpoints.js';
 import { upsertOperationalMemory } from '../src/memory/operational.js';
 import { proposeMemoryCandidate, publishMemoryCandidate, reviewMemoryCandidate, showMemoryCandidate, } from '../src/memory/candidates.js';
-import { installGlobalSkill, skillStatus, uninstallGlobalSkill, upgradeGlobalSkill, } from '../src/skill-manager.js';
+import { installBundledSkills, installGlobalSkill, skillStatus, skillSuiteStatus, uninstallBundledSkills, uninstallGlobalSkill, upgradeBundledSkills, upgradeGlobalSkill, } from '../src/skill-manager.js';
+import { agentPlatformReadiness, MANAGED_AGENT_PLATFORMS, multicaTargets, platformDocPath, platformSkillForRole, requireSupportedAgentPlatform, resolveAgentPlatform, resolveEndpoint, statusLabel as platformStatusLabel, useAgentPlatform, } from '../src/agent-platform.js';
 const PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
 const PACKAGE_JSON = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
 // ROOT = **你的工作区**（当前目录），不是包所在的目录。
@@ -56,16 +61,16 @@ dta —— 给 Agent 安装钉钉员工的基础行为和工作环境
   · 从本地目录或钉钉文档加载身份、记忆和知识
 
 开始使用：
-  dta setup             首次配置 CLI、DWS 和基础行为 Skill
+  dta setup             首次配置 CLI、DWS 和内置 Skill（基础行为 + Agent 装配 + 交付后评测）
   dta bootstrap --json  为当前 Agent 会话加载工作区
   dta agent enhance / audit  安全增强已有仓库，再审计定义、存储与 Skill 真加载
   dta info / dta workspace doctor <name>  查看 Project 并只读诊断 Workspace
-  dta deploy ... / dta promote ...  预览 Multica 受控部署或已验版本晋级
+  dta agent-platform use <platform> → dta deploy / dta promote  声明平台归属并装平台技能包，再受控部署与晋级
 
 维护环境：
   dta doctor            检查哪里没装好，并给出修复提示
   dta upgrade           自升级，再重新检查完整环境
-  dta skill status      查看 Claude Code、Codex、OpenCode 能否发现 Skill
+  dta skill status      查看内置 Skill 的版本状态与三个客户端能否发现（可加 name 只查一个）
 
 接入钉钉事件和可靠外发：dta help runtime
 `;
@@ -232,6 +237,8 @@ async function main() {
         return;
     }
     if (cmd === 'deploy') {
+        const platformForDeploy = requireSupportedAgentPlatform('deploy', PROJECT_START);
+        disclosePlatformSkill(platformForDeploy, 'deploy');
         const { values: o, positionals } = parseArgs({
             args: argv.slice(1), allowPositionals: true,
             options: {
@@ -307,6 +314,8 @@ async function main() {
         return;
     }
     if (cmd === 'promote') {
+        const platformForPromote = requireSupportedAgentPlatform('promote', PROJECT_START);
+        disclosePlatformSkill(platformForPromote, 'deploy');
         const { values: o, positionals } = parseArgs({
             args: argv.slice(1), allowPositionals: true,
             options: {
@@ -366,6 +375,8 @@ async function main() {
         return;
     }
     if (cmd === 'observe') {
+        const platformForObserve = requireSupportedAgentPlatform('observe', PROJECT_START);
+        disclosePlatformSkill(platformForObserve, 'deploy');
         const { values: o, positionals } = parseArgs({
             args: argv.slice(1), allowPositionals: true,
             options: {
@@ -676,28 +687,112 @@ async function main() {
             allowPositionals: true,
             options: {
                 name: { type: 'string' }, 'dry-run': { type: 'boolean' }, json: { type: 'boolean' },
+                'allow-downgrade': { type: 'boolean' },
             },
         });
         if (positionals.length > 1)
             fail('skill 最多接受一个 Skill name');
-        const options = { dryRun: o['dry-run'], name: o.name || positionals[0] };
+        const name = o.name || positionals[0];
+        const dryRun = Boolean(o['dry-run']);
+        const allowDowngrade = Boolean(o['allow-downgrade']);
         let out;
-        if (sub === 'install')
-            out = installGlobalSkill(PACKAGE_ROOT, options);
-        else if (sub === 'status')
-            out = skillStatus(PACKAGE_ROOT, options);
-        else if (sub === 'upgrade')
-            out = upgradeGlobalSkill(PACKAGE_ROOT, options);
-        else if (sub === 'uninstall')
-            out = uninstallGlobalSkill(PACKAGE_ROOT, options);
-        else
+        if (sub === 'install') {
+            out = name
+                ? installGlobalSkill(PACKAGE_ROOT, { dryRun, name, allowDowngrade })
+                : installBundledSkills(PACKAGE_ROOT, { dryRun, allowDowngrade });
+        }
+        else if (sub === 'status') {
+            out = name ? skillStatus(PACKAGE_ROOT, { dryRun, name }) : skillSuiteStatus(PACKAGE_ROOT, { dryRun });
+        }
+        else if (sub === 'upgrade') {
+            out = name
+                ? upgradeGlobalSkill(PACKAGE_ROOT, { dryRun, name, allowDowngrade })
+                : upgradeBundledSkills(PACKAGE_ROOT, { dryRun, allowDowngrade });
+        }
+        else if (sub === 'uninstall') {
+            out = name
+                ? uninstallGlobalSkill(PACKAGE_ROOT, { dryRun, name })
+                : uninstallBundledSkills(PACKAGE_ROOT, { dryRun });
+        }
+        else {
             fail(`不认识的 skill 子命令: ${sub || '(缺失)'}`, 1, `可用命令: dta skill install | status | upgrade | uninstall${suggest(sub || '', ['install', 'status', 'upgrade', 'uninstall'], 'dta skill')}`);
+        }
         if (o.json)
             console.log(JSON.stringify(out, null, 2));
+        else if ('skills' in out)
+            for (const item of out.skills)
+                printSkillStatus(item, sub, dryRun);
         else
-            printSkillStatus(out, sub, Boolean(o['dry-run']));
+            printSkillStatus(out, sub, dryRun);
         return;
     }
+    // ── agent-platform：工作区归属的 managed agent platform；平台工具包按选择惰性安装。──
+    if (cmd === 'agent-platform') {
+        const { values: o, positionals } = parseArgs({
+            args: argv.slice(2),
+            allowPositionals: true,
+            options: { json: { type: 'boolean' }, 'no-install': { type: 'boolean' } },
+        });
+        if (sub === 'list') {
+            if (positionals.length)
+                fail('agent-platform list 不接受位置参数');
+            const out = { $schema: 'dingtalk-agent/agent-platform-list@1', platforms: MANAGED_AGENT_PLATFORMS };
+            if (o.json)
+                console.log(JSON.stringify(out, null, 2));
+            else
+                for (const platform of MANAGED_AGENT_PLATFORMS)
+                    printAgentPlatform(platform);
+            return;
+        }
+        if (sub === 'show') {
+            if (positionals.length)
+                fail('agent-platform show 不接受位置参数');
+            const out = resolveAgentPlatform(PROJECT_START);
+            const readiness = out.definition ? agentPlatformReadiness(out.definition.name, process.env, undefined, PROJECT_START) : [];
+            const targets = out.definition?.name === 'multica-dingtalk' ? multicaTargets() : [];
+            const endpoint = out.definition ? resolveEndpoint(out.definition.name, PROJECT_START) : null;
+            const doc = out.definition ? platformDocPath(PACKAGE_ROOT, out.definition.name) : null;
+            if (o.json)
+                console.log(JSON.stringify({ ...out, endpoint, readiness, targets, doc }, null, 2));
+            else {
+                printAgentPlatformResolution(out);
+                printEndpoint(endpoint);
+                printAgentPlatformReadiness(readiness);
+                printMulticaTargets(targets);
+                printPlatformDoc(out.definition?.name);
+            }
+            return;
+        }
+        if (sub === 'use') {
+            if (positionals.length !== 1)
+                fail('agent-platform use 需要且只接受一个 platform name');
+            const out = useAgentPlatform(PROJECT_START, positionals[0], {
+                packageRoot: PACKAGE_ROOT, installSkills: !o['no-install'],
+            });
+            const readiness = out.definition ? agentPlatformReadiness(out.definition.name, process.env, undefined, PROJECT_START) : [];
+            const targets = out.definition?.name === 'multica-dingtalk' ? multicaTargets() : [];
+            const endpoint = out.definition ? resolveEndpoint(out.definition.name, PROJECT_START) : null;
+            const doc = out.definition ? platformDocPath(PACKAGE_ROOT, out.definition.name) : null;
+            if (o.json)
+                console.log(JSON.stringify({ ...out, endpoint, readiness, targets, doc }, null, 2));
+            else {
+                console.log(`✅ 工作区已归属 ${out.definition?.label}（写入 ${out.written}）`);
+                for (const install of out.skillInstalls)
+                    printSkillStatus(install, 'install', false);
+                if (!out.skillInstalls.length) {
+                    console.log(out.definition?.skills.length
+                        ? `   已跳过平台技能包安装（--no-install）：${out.definition.skills.map((item) => item.name).join(', ')}`
+                        : '   该平台无需额外技能包。');
+                }
+                printEndpoint(endpoint);
+                printAgentPlatformReadiness(readiness);
+                printMulticaTargets(targets);
+                printPlatformDoc(out.definition?.name);
+            }
+            return;
+        }
+        fail(`不认识的 agent-platform 子命令: ${sub || '(缺失)'}`, 1, `可用命令: dta agent-platform list | show | use <platform>${suggest(sub || '', ['list', 'show', 'use'], 'dta agent-platform')}`);
+    }
     // ── bootstrap：当前 Agent Session 按需发现/拉取语义上下文。──
     if (cmd === 'bootstrap') {
         const { values: o } = parseArgs({
@@ -1241,7 +1336,8 @@ async function main() {
         return;
     }
     fail(`不认识的命令: ${cmd}`, 1, `运行 dta --help 查看全部命令${suggest(cmd, [
-        'setup', 'upgrade', 'doctor', 'skill', 'bootstrap', 'init', 'prepare', 'run', 'dispatch', 'task', 'memory', 'act',
+        'setup', 'upgrade', 'doctor', 'skill', 'agent-platform', 'bootstrap', 'init', 'prepare', 'run', 'dispatch', 'task', 'memory', 'act',
+        'lab', 'listen', 'deploy', 'promote', 'observe',
         'agent',
         'info', 'workspace',
     ])}`);
@@ -1373,14 +1469,84 @@ function printAgentEnhance(out) {
         console.log(`   backup=${out.backupRoot}`);
     console.log(`   audit=${out.audit.status}  missing=${out.audit.missing.join(', ') || '-'}`);
 }
+function printAgentPlatform(platform) {
+    console.log(`${platform.status === 'supported' ? '✅' : '⏳'} ${platform.name} · ${platform.label} · ${platformStatusLabel(platform.status)}`);
+    console.log(`   ${platform.description}`);
+    for (const skill of platform.skills)
+        console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
+    if (platform.commands.length)
+        console.log(`   平台命令: ${platform.commands.map((item) => `dta ${item}`).join(' · ')}`);
+}
+function printAgentPlatformResolution(out) {
+    if (!out.platform) {
+        console.log('⚠️ 当前工作区未声明 managed agent platform');
+        console.log('   运行 `dta agent-platform use multica-dingtalk`，或设置 DTA_AGENT_PLATFORM 环境变量。');
+        return;
+    }
+    const known = out.definition;
+    console.log(`${known ? '✅' : '❌'} 当前 platform: ${out.platform}${known ? ` · ${known.label} · ${platformStatusLabel(known.status)}` : '（未知）'}`);
+    console.log(`   来源: ${out.source}${out.file ? ` · ${out.file}` : ''}`);
+    for (const skill of known?.skills || [])
+        console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
+}
+// 披露：dta 层平台命令关联到平台内确切的 Skill（诊断信息走 stderr，不污染 --json stdout）。
+function disclosePlatformSkill(resolution, role) {
+    const skillName = resolution.definition ? platformSkillForRole(resolution.definition.name, role) : null;
+    if (skillName)
+        console.error(`提示: 平台 ${resolution.definition.name} 的该命令方法学由 Skill ${skillName} 承载`);
+}
+function printEndpoint(endpoint) {
+    if (!endpoint)
+        return;
+    if (endpoint.source === 'ambiguous') {
+        console.log(`   Endpoint: 多个已登录目标未选定（${endpoint.candidates.join(' / ')}）——` +
+            `用 ${endpoint.envVar} 或指定 profile 明确选择`);
+        return;
+    }
+    if (!endpoint.endpoint) {
+        console.log(`   Endpoint: 未解析——设 ${endpoint.envVar} 或登录 multica 后生效`);
+        return;
+    }
+    const mark = endpoint.confirmed ? '✅' : '⚠️';
+    const note = endpoint.confirmed ? '' : '（建议/未确认，deploy 前需显式确认是预发还是生产）';
+    console.log(`   ${mark} Endpoint: ${endpoint.endpoint} · 来源: ${endpoint.source}${note}`);
+    console.log(`   （切换：设 ${endpoint.envVar}=<url>、写 dingtalk-agent.json#multicaEndpoint、或登录对应 profile；无需改代码）`);
+}
+function printPlatformDoc(platformName) {
+    if (!platformName)
+        return;
+    const path = platformDocPath(PACKAGE_ROOT, platformName);
+    if (path)
+        console.log(`   平台说明: ${path}\n   （切换到该平台后请阅读，了解各技能用途与交付链）`);
+}
+function printMulticaTargets(targets) {
+    if (!targets.length)
+        return;
+    console.log('   本机 Multica 登录目标（发布前必须与用户确认 endpoint 与 workspace）:');
+    for (const target of targets) {
+        console.log(`     - profile=${target.profile} · ${target.serverUrl}${target.workspaceId ? ` · workspace=${target.workspaceId}` : ''}`);
+    }
+}
+function printAgentPlatformReadiness(checks) {
+    for (const check of checks) {
+        console.log(`   ${check.ok ? '✅' : '⚠️'} ${check.summary}`);
+        if (check.hint)
+            console.log(`      ${check.hint}`);
+    }
+}
 function printSkillStatus(out, action, dryRun) {
     const prefix = dryRun ? 'DRY-RUN' : '✅';
     const verb = action === 'status' ? '全局 Skill 状态' : `skill ${action}`;
     console.log(`${prefix} ${verb}: ${out.name}`);
     console.log(`   manager=${out.manager}  bundled=${out.bundled.skillVersion || '-'}`);
     console.log(`   canonical=${out.canonical.path}`);
-    console.log(`   installed=${out.canonical.exists}  installedVersion=${out.canonical.installedVersion || '-'}  ` +
-        `current=${out.canonical.current}`);
+    console.log(`   installed=${out.canonical.exists}  ` +
+        `${out.canonical.installedVersion || '—'} → ${out.bundled.skillVersion}  ` +
+        `state=${out.canonical.state}`);
+    if (out.operation?.after) {
+        console.log(`   ${out.operation.before.installedVersion || '—'}(${out.operation.before.state})` +
+            ` → ${out.operation.after.installedVersion}(${out.operation.after.state})`);
+    }
     if (out.operation)
         console.log(`   delegated: ${out.operation.command}`);
     for (const client of out.clients) {
@@ -1400,12 +1566,32 @@ function printDoctor(out) {
         if (check.fix)
             console.log(`   修复: ${check.fix}`);
     }
+    if (out.hosts.length) {
+        // Host 面回答"本地能在哪跑"，不改变上面的 ready 结论。
+        console.log('\n本机 Coding Agent:');
+        const width = Math.max(...out.hosts.map((host) => displayWidth(host.label)));
+        for (const host of out.hosts) {
+            const label = host.label + ' '.repeat(width - displayWidth(host.label));
+            const where = host.cli.found
+                ? [host.cli.path, host.cli.version].filter(Boolean).join('  ')
+                : `未找到 ${host.cli.command}`;
+            console.log(`  ${host.cli.found ? '✅' : '❌'} ${label}  ${where}`);
+            console.log(`     Skill 可见性: ${host.skillExposure.exists ? '已暴露' : '未暴露'} · ${host.skillExposureRoot}`);
+        }
+    }
     if (out.nextSteps.length) {
         console.log('\n下一步:');
         for (const step of out.nextSteps)
             console.log(`  ${step}`);
     }
 }
+/** 全角字符按两列计宽，避免中英混排的 Host 列表错位。 */
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text)
+        width += /[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹯＀-｠￠-￦]/.test(char) ? 2 : 1;
+    return width;
+}
 function printProjectInfo(out) {
     console.log(`dingtalk-agent Project · ${out.project.name}`);
     console.log(`   root=${out.root}`);