@xdxer/dingtalk-agent 0.1.4-beta.7 → 0.1.4-beta.8

package/README.md

@@ -253,7 +253,6 @@ dingtalk-agent init
 dingtalk-agent prepare --event-file event.json --json
 dingtalk-agent help runtime
 dingtalk-agent help adapters
-dingtalk-agent eval contract
 ```
 
 `listen` 是可选的开发联调 Adapter，不是 Agent 主进程。云端 Driver、Claude Code 插件或本地 DWS 都可以提供事件，并从标准化事件之后复用同一 Session / Run / Action 内核。
@@ -266,7 +265,7 @@ npm run typecheck
 npm run eval:contract
 ```
 
-当前确定性合同包含 **30 个场景**，覆盖：
+当前确定性合同包含 **31 个场景**，覆盖：
 
 - 通过 `npx skills` 委托全局 Skill 安装、发现、重装和卸载；
 - 首次 setup、用户级 PATH、DWS 版本/认证和三端客户端发现；

package/dist/bin/dingtalk-agent.js

@@ -13,10 +13,6 @@ import { join, resolve } from 'node:path';
 import { readFileSync } from 'node:fs';
 import { spawn, spawnSync } from 'node:child_process';
 import * as cfgmod from '../src/config.js';
-import * as kbmod from '../src/kb.js';
-import * as runsmod from '../src/runs.js';
-import * as dutymod from '../src/duty.js';
-import { boot } from '../src/boot.js';
 import { init } from '../src/init.js';
 import { ackDispatch, listPendingDispatches, prepareSession } from '../src/sessions.js';
 import { readEventFile, consumeNdjson, heartbeatEvent } from '../src/driver.js';
@@ -35,47 +31,23 @@ const ROOT = process.env.DTA_ROOT
     ? resolve(process.env.DTA_ROOT)
     : (cfgmod.findRoot(process.cwd()) || process.cwd());
 const HELP = `
-dta（dingtalk-agent）—— Skill-first 的钉钉数字员工行为容器
+dta —— 给 Agent 安装钉钉员工的基础行为和工作环境
 
-  用法: dta <command> [options]
-  完整名称 dingtalk-agent 与 dta 完全等价。
+装好后，Agent 可以：
+  · 判断 @、单聊和群消息是否应该回应
+  · 通过 DWS 回复消息、协作并使用钉钉标准产品
+  · 从本地目录或钉钉文档加载身份、记忆和知识
 
-  首次安装或升级:
-    npm install --global --prefix "$HOME/.local" --registry=https://registry.npmjs.org @xdxer/dingtalk-agent@${PACKAGE_JSON.version}
-    "$HOME/.local/bin/dta" setup --skip-cli-install
-  setup                        用户级安装 CLI、修复 PATH、安装 Skill、检查 DWS
-  upgrade                      自升级 CLI，并重新执行 setup 与完整 doctor
-    [--channel beta|latest] [--version X] [--dry-run] [--force] [--json]
-  doctor                       检查 PATH / Node / DWS / Skill / Agent 客户端
+开始使用：
+  dta setup             首次配置 CLI、DWS 和基础行为 Skill
+  dta bootstrap --json  为当前 Agent 会话加载工作区
 
-  Skill（不要求 Workspace）
-  skill install                安装全局 Basic Behavior（Claude Code + Codex + OpenCode）
-  skill status                 检查版本、漂移和客户端可发现性
-  skill upgrade                通过 npx skills 重装当前包内 Skill
-  skill uninstall              通过 npx skills 卸载全局 Skill
-    通用: [--dry-run] [--json]；安装生命周期委托给 npx skills
+维护环境：
+  dta doctor            检查哪里没装好，并给出修复提示
+  dta upgrade           自升级，再重新检查完整环境
+  dta skill status      查看 Claude Code、Codex、OpenCode 能否发现 Skill
 
-  每个 Agent Session（不要求 init）
-  bootstrap                    发现当前本地 Workspace；不修改项目文件
-    [--storage <uri>]          local-dir:<path> | dingtalk-doc:<node-or-url>
-    [--state-dir <path>]       远端文档只读快照目录
-    [--profile <dws-profile>] [--json]
-
-  可信事件模式（可选；需要一次 init）
-  init [--context-id X]        仅为 Prepared Run 建最小 Workspace
-  prepare --event-file <file|-> 事件 → Session → Run
-  act ack                       对原消息贴「收到」;不代表接单
-  act reply --text "…"          引用回复原消息
-  act ask --text "…"            只问一个真正阻塞的问题
-  act silence [--reason "…"]    不外发,但留下行为回执
-    通用: [--run <path>] [--dry-run] [--json]
-
-  smoke                         极简本地验收（不写钉钉）
-  eval contract / behavior      完整合同或模型行为评测
-
-  help runtime                  事件宿主与 controller 命令
-  help adapters                 可选 DWS listen 适配器
-  help legacy                   查看兼容的本体、KB、值班与进化命令
+接入钉钉事件和可靠外发：dta help runtime
 `;
 const RUNTIME_HELP = `
 dingtalk-agent 可信事件运行时（可选宿主能力）
@@ -98,17 +70,6 @@ dingtalk-agent 可选 Driver / 开发联调适配器
 
 listen 不是 Agent 主入口。Claude Code、DWS 云端或其他宿主都可以直接提供事件。
 `;
-const LEGACY_HELP = `
-dingtalk-agent 兼容命令（不属于 P0 四对象主链）
-
-  boot
-  kb mount|list|sync|search
-  duty --check|--run|--list
-  todo
-  log / feedback / runs / evolve
-
-这些能力继续可用，但新增 Agent 应先安装全局 Skill；只有可信事件宿主才需要 runtime。
-`;
 function fail(msg, code = 1, hint = '') {
     console.error(`错误: ${msg}`);
     if (hint)
@@ -127,10 +88,6 @@ catch (e) {
     fail(message, Number(error?.exitCode) || 2, errorHint(message));
 }
 async function main() {
-    if (cmd === 'help' && sub === 'legacy') {
-        console.log(LEGACY_HELP);
-        return;
-    }
     if (cmd === 'help' && sub === 'runtime') {
         console.log(RUNTIME_HELP);
         return;
@@ -139,6 +96,9 @@ async function main() {
         console.log(ADAPTER_HELP);
         return;
     }
+    if (cmd === 'help' && sub) {
+        fail(`不认识的帮助主题: ${sub}`, 1, '运行 dta --help 回到产品入口；事件宿主可用 dta help runtime。');
+    }
     if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
         console.log(HELP);
         return;
@@ -450,285 +410,8 @@ async function main() {
             process.exitCode = 2;
         return;
     }
-    // ── eval：宿主评测入口；shadow 永不调用 act / DWS。──
-    if (cmd === 'eval') {
-        const script = sub === 'contract'
-            ? join(PACKAGE_ROOT, 'evals', 'run-contract-evals.mjs')
-            : sub === 'shadow'
-                ? join(PACKAGE_ROOT, 'evals', 'runners', 'claude-shadow.mjs')
-                : sub === 'behavior'
-                    ? join(PACKAGE_ROOT, 'evals', 'run-shadow-evals.mjs')
-                    : '';
-        if (!script)
-            fail('eval 的子命令: contract / shadow / behavior');
-        const childEnv = { ...process.env };
-        // 合同评测会创建隔离工作区；继承宿主 DTA_ROOT 会让 Action Gate 错读外层 control store。
-        delete childEnv.DTA_ROOT;
-        const child = spawnSync(process.execPath, [script, ...argv.slice(2)], {
-            cwd: ROOT,
-            env: childEnv,
-            stdio: 'inherit',
-        });
-        if (child.error)
-            throw child.error;
-        if (child.signal)
-            throw new Error(`评测进程被 ${child.signal} 终止`);
-        process.exitCode = child.status ?? 2;
-        return;
-    }
-    if (cmd === 'smoke') {
-        const script = join(PACKAGE_ROOT, 'evals', 'run-contract-evals.mjs');
-        const childEnv = { ...process.env };
-        delete childEnv.DTA_ROOT;
-        const child = spawnSync(process.execPath, [script, '--smoke'], {
-            cwd: ROOT, env: childEnv, stdio: 'inherit',
-        });
-        if (child.error)
-            throw child.error;
-        if (child.signal)
-            throw new Error(`Smoke 被 ${child.signal} 终止`);
-        process.exitCode = child.status ?? 2;
-        return;
-    }
-    // ── kb ──
-    if (cmd === 'kb') {
-        const cfg = cfgmod.must(ROOT);
-        const { values: o } = parseArgs({
-            args: argv.slice(2), allowPositionals: true,
-            options: {
-                name: { type: 'string' }, from: { type: 'string' }, own: { type: 'string' },
-                sync: { type: 'string' }, local: { type: 'string' }, force: { type: 'boolean' },
-            },
-        });
-        if (sub === 'mount') {
-            if (!o.name || !o.from)
-                fail('要 --name 和 --from。源的写法见 --help');
-            kbmod.parseSource(o.from); // 写错了当场炸
-            const own = o.own || kbmod.EXTERNAL;
-            const sync = o.sync || (own === kbmod.OWNED ? kbmod.PUSH : kbmod.PULL);
-            if (own === kbmod.OWNED && sync === kbmod.PULL) {
-                fail('owned 的真值在 Git,不该 pull —— 那会把远端的东西覆盖到本地。\n' +
-                    '  **所有权决定真值方向。** owned → push;external → pull。');
-            }
-            const local = o.local || join('.cache/kb', o.name);
-            cfg.kb = (cfg.kb || []).filter((k) => k.name !== o.name);
-            cfg.kb.push({ name: o.name, from: o.from, own, sync, local });
-            cfgmod.save(ROOT, cfg);
-            console.log(`✅ 挂上「${o.name}」 ${o.from}`);
-            console.log(`   所有权=${own} · 同步=${sync} · 落在 ${local}`);
-            console.log(own === kbmod.OWNED
-                ? '   （真值在 Git,钉钉是暴露层。人在钉钉里改了 → sync 时会【停下来问】,不盲覆盖。）'
-                : '   （真值在钉钉,本地只是【可丢弃的缓存】。过期了 kb search 会警告。）');
-            return;
-        }
-        if (sub === 'list') {
-            if (!cfg.kb?.length)
-                return console.log('一个都没挂。 kb mount --help');
-            for (const kb of cfg.kb) {
-                const s = kbmod.stale(kb);
-                console.log(`  ${s ? '⚠️' : '·'} ${kb.name.padEnd(14)} ${kb.own.padEnd(9)} ${kb.sync.padEnd(5)} ${kb.from}`);
-                console.log(`     落在 ${kb.local}  上次同步 ${kb._syncedAt || '从未'}${s ? '  ← **过期了,不许拿来回答**' : ''}`);
-            }
-            return;
-        }
-        if (sub === 'sync') {
-            const targets = (cfg.kb || []).filter((k) => !o.name || k.name === o.name);
-            if (!targets.length)
-                fail('没有这个知识库。 kb list');
-            for (const kb of targets) {
-                if (kb.sync === kbmod.NONE) {
-                    console.log(`  skip   ${kb.name}（sync=none）`);
-                    continue;
-                }
-                if (kb.sync === kbmod.PULL)
-                    kbmod.pull(kb, ROOT, o.force);
-                else
-                    kbmod.push(kb, ROOT, o.force);
-            }
-            cfgmod.save(ROOT, cfg);
-            return;
-        }
-        if (sub === 'search') {
-            const kw = argv[2];
-            if (!kw)
-                fail('要给关键词。 kb search "<关键词>"');
-            kbmod.search(cfg, ROOT, kw);
-            return;
-        }
-        fail('kb 的子命令: mount / list / sync / search');
-    }
-    // ── boot ──
-    if (cmd === 'boot') {
-        boot(cfgmod.must(ROOT), ROOT);
-        return;
-    }
-    // ── duty ──
-    if (cmd === 'duty') {
-        const cfg = cfgmod.must(ROOT);
-        const { values: o } = parseArgs({
-            args: argv.slice(1), allowPositionals: true,
-            options: { check: { type: 'boolean' }, run: { type: 'string' },
-                list: { type: 'boolean' }, force: { type: 'boolean' } },
-        });
-        const duties = dutymod.loadDuties(cfg, ROOT);
-        if (o.list) {
-            const ks = Object.keys(duties);
-            console.log(ks.length ? ks.join('\n')
-                : '(值班表是空的 —— 母体出厂如此,这是【正确】的。在 .dingtalk-agent/config.json 的 duties 里加。)');
-            return;
-        }
-        if (o.run) {
-            const fn = duties[o.run];
-            if (!fn)
-                fail(`没有这个值班: ${o.run}（有: ${Object.keys(duties).join('、') || '无'}）`);
-            const s = fn();
-            if (s.kind === '交付' && !dutymod.inDeliver() && !o.force) {
-                return console.log(`⏸ 「${o.run}」是外发动作,静默时段顺延,**不打扰第三方**。`);
-            }
-            if (s.done)
-                return console.log(`✅ 「${o.run}」已完成,本拍无需执行。${s.detail}`);
-            console.log(`【${o.run}】该做了。${s.gap}`);
-            console.log(`  剧本: ${s.playbook || '(没写剧本 —— 这个值班不合格)'}`);
-            console.log(`  ⚠️ 送达【回读确认】之后才准记 pass。没送达就写 pass = 自己骗自己。`);
-            return;
-        }
-        // --check（默认）
-        console.log('值班表（**完成状态在数据里,不在记忆里**;幂等,漏拍下一拍自愈）');
-        console.log(`  现在 ${runsmod.now().slice(11, 16)} · ${dutymod.inNight() ? '夜间窗口(重活可跑)' : '白天(重活挂起)'} · 外发窗口${dutymod.inDeliver() ? '开' : '关'}`);
-        const ids = Object.keys(duties);
-        if (!ids.length) {
-            console.log('\n  (值班表是空的 —— 母体出厂如此。)');
-            return;
-        }
-        const todo = [];
-        for (const id of ids) {
-            const s = duties[id]();
-            const mark = s.done ? '✅ 已完成' : (s.due ? '⬜ 待补齐' : '⏸ 不在窗口');
-            console.log(`  ${s.id.padEnd(8)} [${s.kind}] ${mark}  ${s.detail}${s.gap ? '  → ' + s.gap : ''}`);
-            if (!s.done && s.due)
-                todo.push(s.id);
-        }
-        if (todo.length) {
-            console.log(`\n本拍要做: ${todo.map((t) => 'duty --run ' + t).join('、')}`);
-            process.exit(1);
-        }
-        console.log('\n全部补齐,静默即可（**不要为此打扰主人**）');
-        return;
-    }
-    // ── 留痕与进化 ──
-    if (cmd === 'log' || cmd === 'logq') {
-        const { values: o } = parseArgs({
-            args: argv.slice(1),
-            options: { did: { type: 'string' }, asked: { type: 'string' }, kind: { type: 'string' },
-                secs: { type: 'string' }, r: { type: 'string' }, ev: { type: 'string' },
-                ch: { type: 'string' }, issue: { type: 'string' },
-                conv: { type: 'string' }, msg: { type: 'string' } },
-        });
-        if (!o.did)
-            fail('要 --did（我怎么答的）');
-        const t = runsmod.logq(ROOT, {
-            ...o, did: o.did, secs: +(o.secs || 0), r: o.r || 'pass',
-        });
-        console.log(`运行记录已落: runs/${runsmod.today()}.md @${t}`);
-        if (!o.conv)
-            console.log('  ⚠️ 没带 --conv —— 事后【拉不出对话流】,这一条基本没有训练价值。');
-        return;
-    }
-    if (cmd === 'feedback') {
-        const { values: o } = parseArgs({
-            args: argv.slice(1),
-            options: { kind: { type: 'string' }, text: { type: 'string' },
-                conv: { type: 'string' }, at: { type: 'string' } },
-        });
-        if (!o.kind || ![runsmod.FB_OK, runsmod.FB_MORE, runsmod.FB_FIX].includes(o.kind)) {
-            fail('--kind 只能是 认可 / 追问 / 纠正');
-        }
-        const day = runsmod.today();
-        const rows = runsmod.read(ROOT, day);
-        let cand = rows.filter((r) => r.asked);
-        if (o.conv)
-            cand = cand.filter((r) => r.conv === o.conv);
-        if (!cand.length)
-            fail(`今天没有可回填的问答行 —— **是不是答完忘了 logq?**`);
-        const tgt = o.at ? cand.find((r) => r.t === o.at) : cand[cand.length - 1];
-        if (!tgt)
-            fail(`找不到 t=${o.at} 的行`);
-        tgt.fb = o.kind;
-        if (o.text)
-            tgt.fbt = o.text.slice(0, 600);
-        runsmod.write(ROOT, day, rows);
-        console.log(`已回填: ${day} @${tgt.t} → 「${o.kind}」（原问: ${(tgt.asked || '').slice(0, 40)}）`);
-        return;
-    }
-    if (cmd === 'runs') {
-        const { values: o } = parseArgs({
-            args: argv.slice(1),
-            options: { days: { type: 'string' }, conv: { type: 'string' },
-                issue: { type: 'string' }, top: { type: 'string' } },
-        });
-        let rows = runsmod.scan(ROOT, +(o.days || 1));
-        if (o.conv) {
-            rows = rows.filter((r) => r.conv === o.conv);
-            console.log(`【对话流】会话 ${o.conv} · ${rows.length} 条 —— **这就是训练素材**`);
-            for (const r of rows) {
-                console.log(`  ── ${r._day} ${r.t}  issue=${r.issue || '-'}  msg=${r.msg || '-'}`);
-                if (r.asked)
-                    console.log(`     主人: ${r.asked}`);
-                console.log(`     我  : ${r.did}   [${r.r}]`);
-                if (r.fb)
-                    console.log(`     反馈: ${r.fb}${r.fbt ? `  「${r.fbt}」` : ''}`);
-            }
-            if (!rows.length)
-                console.log('  (空 —— 这个会话没留痕。**没留痕 = 这些交互等于没发生过。**)');
-            return;
-        }
-        if (o.issue) {
-            const issue = o.issue;
-            rows = rows.filter((r) => (r.issue || '').startsWith(issue));
-        }
-        console.log(`运行记录 runs/ · ${rows.length} 条`);
-        for (const r of rows.slice(-(+(o.top || 30)))) {
-            console.log(`  ${r._day} ${r.t} [${(r.r || '').padEnd(11)}] ${(r.ch || '').padEnd(6)} ${(r.did || '').slice(0, 30)} ${r.fb ? '← ' + r.fb : ''}`);
-        }
-        return;
-    }
-    if (cmd === 'evolve') {
-        const { values: o } = parseArgs({ args: argv.slice(1), options: { days: { type: 'string' } } });
-        const rows = runsmod.scan(ROOT, +(o.days || 7));
-        const ans = rows.filter((r) => r.asked);
-        const bad = ans.filter((r) => [runsmod.FB_FIX, runsmod.FB_MORE].includes(r.fb || ''));
-        const unk = ans.filter((r) => !r.fb);
-        const failed = rows.filter((r) => ['fail', 'unsupported', 'degraded'].includes(r.r));
-        console.log(`【进化清单】近 ${o.days || 7} 天`);
-        console.log(`  面向主人的回答 ${ans.length} 条 · 被【打回】${bad.length} 条 · 引擎层没答出来 ${failed.length} 条`);
-        if (unk.length)
-            console.log(`  ⚠️ ${unk.length} 条【没收到反馈就结案了】—— 答完没回填,这次交互等于白跑。`);
-        if (bad.length) {
-            console.log('\n── 主人打回的（**直接就是这周该改什么**）──');
-            for (const r of bad) {
-                console.log(`  ${r._day} ${r.t} [${r.fb}]  会话=${r.conv || '-'}`);
-                console.log(`     主人问: ${(r.asked || '').slice(0, 60)}`);
-                console.log(`     我答  : ${(r.did || '').slice(0, 60)}`);
-                console.log(`     他说  : ${r.fbt || '(没记下来)'}`);
-                console.log(`     复盘  : dingtalk-agent runs --conv ${r.conv || '<会话id>'}`);
-            }
-        }
-        if (!bad.length && !failed.length) {
-            console.log('\n  (没有打回,也没有失败 —— 要么真的都对,要么【没人回填反馈】。看上面那行。)');
-        }
-        return;
-    }
-    // ── todo：把待办拉全（心跳收件用）──
-    if (cmd === 'todo') {
-        const dws = await import('../src/dws.js');
-        const all = dws.todosAll('false');
-        console.log(`未完成待办 ${all.length} 条（**已翻页拉全** —— 只看第一页会漏掉循环件）`);
-        for (const t of all)
-            console.log(`  ${t.taskId}  ${(t.subject || '').slice(0, 60)}`);
-        return;
-    }
     fail(`不认识的命令: ${cmd}`, 1, `运行 dta --help 查看全部命令${suggest(cmd, [
-        'setup', 'upgrade', 'doctor', 'skill', 'bootstrap', 'init', 'prepare', 'act', 'smoke', 'eval',
+        'setup', 'upgrade', 'doctor', 'skill', 'bootstrap', 'init', 'prepare', 'run', 'dispatch', 'act',
     ])}`);
 }
 function errorHint(message) {