@xdxer/dingtalk-agent 0.1.0 → 0.1.2

package/dist/src/kb.js

@@ -0,0 +1,240 @@
+// 知识库挂载与同步（TypeScript source）。
+//
+// ════════════════════════════════════════════════════════════════════
+// 【核心判断】所有权决定真值方向。
+// ════════════════════════════════════════════════════════════════════
+//
+//                owned（我的本体）           external（别人维护的）
+//   真值在        **Git**（本地）             **钉钉**（远端）
+//   同步方向      push  本地 → 钉钉           pull  钉钉 → 本地
+//   为什么        给人看（人机同源）           给我 grep（快、能看上下文）
+//   冲突了        远端被人改过 → **停**       远端赢，本地缓存可丢弃
+//   落在          ontology/（入 Git）         .cache/kb/<name>/（gitignore）
+//
+// 这就是「Git 内核 × 钉钉暴露层」：**Git 是常量层，钉钉是可替换的暴露层。**
+//
+// ════════════════════════════════════════════════════════════════════
+// 【三个硬约束】—— 全是踩出来的
+// ════════════════════════════════════════════════════════════════════
+//
+// 1. **绝不双向自动 merge。** 一个方向是真值，另一个是投影。
+//    自动合并两个都在变的东西 = 灾难，而且是【静默】灾难。
+//
+// 2. **重排版不是漂移。** 判据是「剥掉 markdown 符号后的文字流」，不是行级 diff。
+//    用行级 diff → 每次 sync 都误报 → **你就会开始无脑 --force，真漂移也一起覆盖掉。**
+//
+// 3. **缓存不新鲜就不许用（fail-closed）。** external KB 是快照。
+//    **拿着过期快照回答，比说「我不知道」危险得多。**
+import { mkdirSync, writeFileSync, readFileSync, existsSync, statSync } from 'node:fs';
+import { readdirSync } from 'node:fs';
+import { join, dirname, relative, basename } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import * as dws from './dws.js';
+export const OWNED = 'owned', EXTERNAL = 'external';
+export const PULL = 'pull', PUSH = 'push', NONE = 'none';
+/** external 缓存超过这么久就算过期。过期 → kb search 会警告并要求先 sync。 */
+export const STALE_HOURS = 24;
+const now = () => new Date(Date.now() + 8 * 3600e3).toISOString().replace('Z', '+08:00').slice(0, 19);
+class DriftError extends Error {
+    exitCode = 1;
+}
+/** dingtalk:doc:<folderId> · dingtalk:wiki:<spaceId> · local:<path> */
+export function parseSource(s) {
+    let m = /^dingtalk:(doc|wiki):(.+)$/.exec(s);
+    if (m)
+        return { kind: m[1], id: m[2] };
+    m = /^local:(.+)$/.exec(s);
+    if (m)
+        return { kind: 'local', id: m[1].replace(/^~/, process.env.HOME || '~') };
+    throw new Error(`挂载源写错了: ${s}\n` +
+        `  支持三种:\n` +
+        `    dingtalk:doc:<folderId>    文档文件夹（最常见 —— 很多组织根本没建"知识库"）\n` +
+        `    dingtalk:wiki:<spaceId>    钉钉知识库空间\n` +
+        `    local:<路径>               本地目录（只读挂载，比如另一个仓库的 wiki/）`);
+}
+// ════════════════ pull：钉钉 → 本地缓存 ════════════════
+function walkDoc(folder, prefix = '') {
+    const out = [];
+    for (const n of dws.nodes(dws.run(['doc', 'list', '--folder', folder, '--page-size', '50']))) {
+        const name = n.name || '', nid = n.nodeId;
+        if (n.nodeType === 'folder') {
+            out.push(...walkDoc(nid, join(prefix, name)));
+            continue;
+        }
+        if (n.contentType && n.contentType !== 'ALIDOC')
+            continue; // 二进制附件不是知识
+        out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),
+            nid, mtime: n.updateTime || 0 });
+    }
+    return out;
+}
+function walkWiki(space, folder = '', prefix = '') {
+    const args = ['wiki', 'node', 'list', '--workspace', space, '--limit', '50'];
+    if (folder)
+        args.push('--folder', folder);
+    const out = [];
+    for (const n of dws.nodes(dws.run(args))) {
+        const name = n.name || '', nid = n.nodeId;
+        if (n.nodeType === 'folder' || n.hasChildren)
+            out.push(...walkWiki(space, nid, join(prefix, name)));
+        out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),
+            nid, mtime: n.updateTime || 0 });
+    }
+    return out;
+}
+/** 钉钉 → 本地缓存。**远端赢**（external 的真值在远端）。增量靠 updateTime。 */
+export function pull(kb, root, force = false) {
+    const { kind, id } = parseSource(kb.from);
+    if (kind === 'local') {
+        console.log(`  local  ${kb.name}  就在本地，不用同步`);
+        return;
+    }
+    const dest = join(root, kb.local);
+    const items = kind === 'doc' ? walkDoc(id) : walkWiki(id);
+    if (!items.length) {
+        throw new Error(`「${kb.name}」远端一个节点都没有 —— **不许当成【这个知识库是空的】。**\n` +
+            `  可能是: ID 写错 / 没权限 / 它真的空。先用 dws 手工确认再说。`);
+    }
+    kb._state ??= {};
+    let pulled = 0, skipped = 0;
+    for (const { rel, nid, mtime } of items) {
+        const p = join(dest, rel);
+        if (!force && kb._state[nid]?.mtime === mtime && existsSync(p)) {
+            skipped++;
+            continue;
+        }
+        const md = dws.readDoc(nid);
+        mkdirSync(dirname(p), { recursive: true });
+        // 头三行钉住来源 —— **没有指针的知识，用的时候不敢信。**
+        writeFileSync(p, `<!-- 来自钉钉 · 只读缓存 · 不要在这里改，改了下次 sync 会被覆盖 -->\n` +
+            `<!-- nodeId: ${nid} -->\n<!-- 拉取: ${now()} -->\n\n${md}`);
+        kb._state[nid] = { rel, mtime };
+        pulled++;
+    }
+    kb._syncedAt = now();
+    console.log(`  pull   ${kb.name.padEnd(14)} 拉了 ${pulled} 篇 · 没变 ${skipped} 篇`);
+}
+// ════════════════ push：本地 → 钉钉（人机同源）════════════════
+function walkLocal(dir, base = dir) {
+    const out = [];
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const p = join(dir, e.name);
+        if (e.isDirectory()) {
+            out.push(...walkLocal(p, base));
+            continue;
+        }
+        if (e.name.endsWith('.md'))
+            out.push({ path: p, rel: relative(base, p) });
+    }
+    return out;
+}
+/**
+ * 本地 → 钉钉。**Git 赢**（owned 的真值在 Git）。
+ *
+ * ⚠️ **推之前先查漂移** —— 远端被人改过就【停下来问】，绝不盲覆盖。
+ *    人在钉钉里改了东西，说明他有话要说。**盲覆盖 = 把人的意见删了。**
+ */
+export function push(kb, root, force = false) {
+    const { kind, id } = parseSource(kb.from);
+    if (kind !== 'doc') {
+        throw new Error('push 目前只支持 dingtalk:doc:<folderId>（文档文件夹）。\n' +
+            '  知识库空间的写入面还没验过 —— **不许假装支持。**');
+    }
+    const src = join(root, kb.local);
+    if (!existsSync(src))
+        throw new Error(`本地目录不存在: ${src}`);
+    kb._state ??= {};
+    const drift = [];
+    let pushed = 0, unchanged = 0;
+    for (const { path, rel } of walkLocal(src)) {
+        const body = readFileSync(path, 'utf8');
+        let nid = Object.keys(kb._state).find((k) => kb._state[k].rel === rel);
+        if (!nid) {
+            nid = String(dws.createDoc(id, basename(rel), path) || '');
+            if (!nid)
+                throw new Error(`创建 ${rel} 后没有返回 nodeId`);
+            kb._state[nid] = { rel, pushedWords: dws.words(body) };
+            pushed++;
+            console.log(`    + 新建 ${rel}`);
+            continue;
+        }
+        const remote = dws.readDoc(nid);
+        if (dws.same(remote, body)) {
+            unchanged++;
+            continue;
+        }
+        // 远端 ≠ 我上次推上去的 → **有人在钉钉里改过**
+        const last = kb._state[nid].pushedWords;
+        if (last && dws.words(remote) !== last && !force) {
+            drift.push({ rel, nid });
+            continue;
+        }
+        dws.updateDoc(nid, path);
+        if (!dws.same(dws.readDoc(nid), body)) {
+            throw new Error(`推了 ${rel} 但回读不一致 —— **写操作报错≠失败，回读定成败。**`);
+        }
+        kb._state[nid].pushedWords = dws.words(body);
+        pushed++;
+        console.log(`    ↑ 更新 ${rel}`);
+    }
+    if (drift.length) {
+        console.log(`\n  ⚠️ **远端被人改过**，默认拒绝覆盖（${drift.length} 篇）:`);
+        for (const { rel, nid } of drift)
+            console.log(`      ${rel}   nodeId=${nid}`);
+        console.log(`  人在钉钉里改了东西，说明他有话要说。**先去看一眼**，别盲覆盖。`);
+        console.log(`  确认要覆盖: dingtalk-agent kb sync --name ${kb.name} --force`);
+        throw new DriftError('有漂移，拒绝覆盖');
+    }
+    kb._syncedAt = now();
+    console.log(`  push   ${kb.name.padEnd(14)} 推了 ${pushed} 篇 · 一致 ${unchanged} 篇`);
+}
+// ════════════════ search：跨所有挂载点 ════════════════
+export function stale(kb) {
+    if (kb.own !== EXTERNAL || kb.sync === NONE)
+        return false;
+    if (!kb._syncedAt)
+        return true;
+    const age = (Date.now() - Date.parse(kb._syncedAt)) / 3600e3;
+    return age > STALE_HOURS;
+}
+/**
+ * 跨所有挂载的 KB 搜。**本地 grep 为主** —— 快、确定、能看到上下文。
+ *
+ * fail-closed：不新鲜的缓存会【警告】。
+ * **拿着过期快照回答，比说「我不知道」危险得多。**
+ */
+export function search(cfg, root, kw, top = 20) {
+    const hits = [];
+    const warned = [];
+    for (const kb of cfg.kb || []) {
+        const base = kb.local.startsWith('/') ? kb.local : join(root, kb.local);
+        if (!existsSync(base))
+            continue;
+        if (stale(kb))
+            warned.push(kb.name);
+        const r = spawnSync('grep', ['-ril', '--include=*.md', kw, base], { encoding: 'utf8' });
+        for (const p of (r.stdout || '').split('\n').filter(Boolean)) {
+            const ctx = spawnSync('grep', ['-i', '-n', '-m', '2', kw, p], { encoding: 'utf8' }).stdout || '';
+            hits.push({ kb: kb.name, file: relative(root, p), ctx: ctx.trim() });
+        }
+    }
+    if (warned.length) {
+        console.log(`⚠️ 这些知识库的缓存【超过 ${STALE_HOURS} 小时没同步】了: ${warned.join('、')}`);
+        console.log(`   **拿着过期快照回答，比说「我不知道」危险得多。**`);
+        console.log(`   先跑: dingtalk-agent kb sync\n`);
+    }
+    if (!hits.length) {
+        console.log(`没搜到「${kw}」。`);
+        console.log(`**搜不到就说搜不到 —— 不要编。** 挂了哪些库: dingtalk-agent kb list`);
+        return [];
+    }
+    console.log(`命中 ${hits.length} 处:`);
+    for (const h of hits.slice(0, top)) {
+        console.log(`\n── [${h.kb}] ${h.file}`);
+        for (const l of h.ctx.split('\n').slice(0, 2))
+            console.log(`     ${l.slice(0, 110)}`);
+    }
+    console.log(`\n**别只看这几行就作答** —— 打开命中的那一页读完再说。`);
+    return hits;
+}
+//# sourceMappingURL=kb.js.map

package/dist/src/kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.js","sourceRoot":"","sources":["../../src/kb.ts"],"names":[],"mappings":"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","sourcesContent":["// 知识库挂载与同步（TypeScript source）。\n//\n// ════════════════════════════════════════════════════════════════════\n// 【核心判断】所有权决定真值方向。\n// ════════════════════════════════════════════════════════════════════\n//\n//                owned（我的本体）           external（别人维护的）\n//   真值在        **Git**（本地）             **钉钉**（远端）\n//   同步方向      push  本地 → 钉钉           pull  钉钉 → 本地\n//   为什么        给人看（人机同源）           给我 grep（快、能看上下文）\n//   冲突了        远端被人改过 → **停**       远端赢，本地缓存可丢弃\n//   落在          ontology/（入 Git）         .cache/kb/<name>/（gitignore）\n//\n// 这就是「Git 内核 × 钉钉暴露层」：**Git 是常量层，钉钉是可替换的暴露层。**\n//\n// ════════════════════════════════════════════════════════════════════\n// 【三个硬约束】—— 全是踩出来的\n// ════════════════════════════════════════════════════════════════════\n//\n// 1. **绝不双向自动 merge。** 一个方向是真值，另一个是投影。\n//    自动合并两个都在变的东西 = 灾难，而且是【静默】灾难。\n//\n// 2. **重排版不是漂移。** 判据是「剥掉 markdown 符号后的文字流」，不是行级 diff。\n//    用行级 diff → 每次 sync 都误报 → **你就会开始无脑 --force，真漂移也一起覆盖掉。**\n//\n// 3. **缓存不新鲜就不许用（fail-closed）。** external KB 是快照。\n//    **拿着过期快照回答，比说「我不知道」危险得多。**\n\nimport { mkdirSync, writeFileSync, readFileSync, existsSync, statSync } from 'node:fs'\nimport { readdirSync } from 'node:fs'\nimport { join, dirname, relative, basename } from 'node:path'\nimport { spawnSync } from 'node:child_process'\nimport * as dws from './dws.js'\n\nexport const OWNED = 'owned', EXTERNAL = 'external'\nexport const PULL = 'pull', PUSH = 'push', NONE = 'none'\n\n/** external 缓存超过这么久就算过期。过期 → kb search 会警告并要求先 sync。 */\nexport const STALE_HOURS = 24\n\nconst now = () => new Date(Date.now() + 8 * 3600e3).toISOString().replace('Z', '+08:00').slice(0, 19)\n\ninterface RemoteItem { rel: string; nid: string; mtime: string | number }\ninterface LocalItem { path: string; rel: string }\ninterface SearchHit { kb: string; file: string; ctx: string }\n\nclass DriftError extends Error {\n  exitCode = 1\n}\n\n/** dingtalk:doc:<folderId> · dingtalk:wiki:<spaceId> · local:<path> */\nexport function parseSource(s): { kind: 'doc' | 'wiki' | 'local'; id: string } {\n  let m = /^dingtalk:(doc|wiki):(.+)$/.exec(s)\n  if (m) return { kind: m[1] as 'doc' | 'wiki', id: m[2] }\n  m = /^local:(.+)$/.exec(s)\n  if (m) return { kind: 'local', id: m[1].replace(/^~/, process.env.HOME || '~') }\n  throw new Error(\n    `挂载源写错了: ${s}\\n` +\n    `  支持三种:\\n` +\n    `    dingtalk:doc:<folderId>    文档文件夹（最常见 —— 很多组织根本没建\"知识库\"）\\n` +\n    `    dingtalk:wiki:<spaceId>    钉钉知识库空间\\n` +\n    `    local:<路径>               本地目录（只读挂载，比如另一个仓库的 wiki/）`)\n}\n\n// ════════════════ pull：钉钉 → 本地缓存 ════════════════\nfunction walkDoc(folder, prefix = ''): RemoteItem[] {\n  const out: RemoteItem[] = []\n  for (const n of dws.nodes(dws.run(['doc', 'list', '--folder', folder, '--page-size', '50']))) {\n    const name = n.name || '', nid = n.nodeId\n    if (n.nodeType === 'folder') { out.push(...walkDoc(nid, join(prefix, name))); continue }\n    if (n.contentType && n.contentType !== 'ALIDOC') continue      // 二进制附件不是知识\n    out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),\n               nid, mtime: n.updateTime || 0 })\n  }\n  return out\n}\n\nfunction walkWiki(space, folder = '', prefix = ''): RemoteItem[] {\n  const args = ['wiki', 'node', 'list', '--workspace', space, '--limit', '50']\n  if (folder) args.push('--folder', folder)\n  const out: RemoteItem[] = []\n  for (const n of dws.nodes(dws.run(args))) {\n    const name = n.name || '', nid = n.nodeId\n    if (n.nodeType === 'folder' || n.hasChildren) out.push(...walkWiki(space, nid, join(prefix, name)))\n    out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),\n               nid, mtime: n.updateTime || 0 })\n  }\n  return out\n}\n\n/** 钉钉 → 本地缓存。**远端赢**（external 的真值在远端）。增量靠 updateTime。 */\nexport function pull(kb, root, force = false) {\n  const { kind, id } = parseSource(kb.from)\n  if (kind === 'local') { console.log(`  local  ${kb.name}  就在本地，不用同步`); return }\n\n  const dest = join(root, kb.local)\n  const items = kind === 'doc' ? walkDoc(id) : walkWiki(id)\n  if (!items.length) {\n    throw new Error(\n      `「${kb.name}」远端一个节点都没有 —— **不许当成【这个知识库是空的】。**\\n` +\n      `  可能是: ID 写错 / 没权限 / 它真的空。先用 dws 手工确认再说。`)\n  }\n  kb._state ??= {}\n  let pulled = 0, skipped = 0\n  for (const { rel, nid, mtime } of items) {\n    const p = join(dest, rel)\n    if (!force && kb._state[nid]?.mtime === mtime && existsSync(p)) { skipped++; continue }\n    const md = dws.readDoc(nid)\n    mkdirSync(dirname(p), { recursive: true })\n    // 头三行钉住来源 —— **没有指针的知识，用的时候不敢信。**\n    writeFileSync(p,\n      `<!-- 来自钉钉 · 只读缓存 · 不要在这里改，改了下次 sync 会被覆盖 -->\\n` +\n      `<!-- nodeId: ${nid} -->\\n<!-- 拉取: ${now()} -->\\n\\n${md}`)\n    kb._state[nid] = { rel, mtime }\n    pulled++\n  }\n  kb._syncedAt = now()\n  console.log(`  pull   ${kb.name.padEnd(14)} 拉了 ${pulled} 篇 · 没变 ${skipped} 篇`)\n}\n\n// ════════════════ push：本地 → 钉钉（人机同源）════════════════\nfunction walkLocal(dir, base = dir): LocalItem[] {\n  const out: LocalItem[] = []\n  for (const e of readdirSync(dir, { withFileTypes: true })) {\n    const p = join(dir, e.name)\n    if (e.isDirectory()) { out.push(...walkLocal(p, base)); continue }\n    if (e.name.endsWith('.md')) out.push({ path: p, rel: relative(base, p) })\n  }\n  return out\n}\n\n/**\n * 本地 → 钉钉。**Git 赢**（owned 的真值在 Git）。\n *\n * ⚠️ **推之前先查漂移** —— 远端被人改过就【停下来问】，绝不盲覆盖。\n *    人在钉钉里改了东西，说明他有话要说。**盲覆盖 = 把人的意见删了。**\n */\nexport function push(kb, root, force = false) {\n  const { kind, id } = parseSource(kb.from)\n  if (kind !== 'doc') {\n    throw new Error('push 目前只支持 dingtalk:doc:<folderId>（文档文件夹）。\\n' +\n                    '  知识库空间的写入面还没验过 —— **不许假装支持。**')\n  }\n  const src = join(root, kb.local)\n  if (!existsSync(src)) throw new Error(`本地目录不存在: ${src}`)\n\n  kb._state ??= {}\n  const drift: Array<{ rel: string; nid: string }> = []\n  let pushed = 0, unchanged = 0\n\n  for (const { path, rel } of walkLocal(src)) {\n    const body = readFileSync(path, 'utf8')\n    let nid = Object.keys(kb._state).find((k) => kb._state[k].rel === rel)\n    if (!nid) {\n      nid = String(dws.createDoc(id, basename(rel), path) || '')\n      if (!nid) throw new Error(`创建 ${rel} 后没有返回 nodeId`)\n      kb._state[nid] = { rel, pushedWords: dws.words(body) }\n      pushed++; console.log(`    + 新建 ${rel}`); continue\n    }\n    const remote = dws.readDoc(nid)\n    if (dws.same(remote, body)) { unchanged++; continue }\n\n    // 远端 ≠ 我上次推上去的 → **有人在钉钉里改过**\n    const last = kb._state[nid].pushedWords\n    if (last && dws.words(remote) !== last && !force) { drift.push({ rel, nid }); continue }\n\n    dws.updateDoc(nid, path)\n    if (!dws.same(dws.readDoc(nid), body)) {\n      throw new Error(`推了 ${rel} 但回读不一致 —— **写操作报错≠失败，回读定成败。**`)\n    }\n    kb._state[nid].pushedWords = dws.words(body)\n    pushed++; console.log(`    ↑ 更新 ${rel}`)\n  }\n\n  if (drift.length) {\n    console.log(`\\n  ⚠️ **远端被人改过**，默认拒绝覆盖（${drift.length} 篇）:`)\n    for (const { rel, nid } of drift) console.log(`      ${rel}   nodeId=${nid}`)\n    console.log(`  人在钉钉里改了东西，说明他有话要说。**先去看一眼**，别盲覆盖。`)\n    console.log(`  确认要覆盖: dingtalk-agent kb sync --name ${kb.name} --force`)\n    throw new DriftError('有漂移，拒绝覆盖')\n  }\n  kb._syncedAt = now()\n  console.log(`  push   ${kb.name.padEnd(14)} 推了 ${pushed} 篇 · 一致 ${unchanged} 篇`)\n}\n\n// ════════════════ search：跨所有挂载点 ════════════════\nexport function stale(kb) {\n  if (kb.own !== EXTERNAL || kb.sync === NONE) return false\n  if (!kb._syncedAt) return true\n  const age = (Date.now() - Date.parse(kb._syncedAt)) / 3600e3\n  return age > STALE_HOURS\n}\n\n/**\n * 跨所有挂载的 KB 搜。**本地 grep 为主** —— 快、确定、能看到上下文。\n *\n * fail-closed：不新鲜的缓存会【警告】。\n * **拿着过期快照回答，比说「我不知道」危险得多。**\n */\nexport function search(cfg, root, kw, top = 20) {\n  const hits: SearchHit[] = []\n  const warned: string[] = []\n  for (const kb of cfg.kb || []) {\n    const base = kb.local.startsWith('/') ? kb.local : join(root, kb.local)\n    if (!existsSync(base)) continue\n    if (stale(kb)) warned.push(kb.name)\n    const r = spawnSync('grep', ['-ril', '--include=*.md', kw, base], { encoding: 'utf8' })\n    for (const p of (r.stdout || '').split('\\n').filter(Boolean)) {\n      const ctx = spawnSync('grep', ['-i', '-n', '-m', '2', kw, p], { encoding: 'utf8' }).stdout || ''\n      hits.push({ kb: kb.name, file: relative(root, p), ctx: ctx.trim() })\n    }\n  }\n\n  if (warned.length) {\n    console.log(`⚠️ 这些知识库的缓存【超过 ${STALE_HOURS} 小时没同步】了: ${warned.join('、')}`)\n    console.log(`   **拿着过期快照回答，比说「我不知道」危险得多。**`)\n    console.log(`   先跑: dingtalk-agent kb sync\\n`)\n  }\n  if (!hits.length) {\n    console.log(`没搜到「${kw}」。`)\n    console.log(`**搜不到就说搜不到 —— 不要编。** 挂了哪些库: dingtalk-agent kb list`)\n    return []\n  }\n  console.log(`命中 ${hits.length} 处:`)\n  for (const h of hits.slice(0, top)) {\n    console.log(`\\n── [${h.kb}] ${h.file}`)\n    for (const l of h.ctx.split('\\n').slice(0, 2)) console.log(`     ${l.slice(0, 110)}`)\n  }\n  console.log(`\\n**别只看这几行就作答** —— 打开命中的那一页读完再说。`)\n  return hits\n}\n"]}

package/dist/src/package-root.js

@@ -0,0 +1,17 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * 源码位于 src|bin，编译产物位于 dist/src|dist/bin。
+ * 资源仍发布在包根，所以不能用固定的 dirname 层数猜包根。
+ */
+export function resolvePackageRoot(metaUrl) {
+    let candidate = resolve(dirname(fileURLToPath(metaUrl)), '..');
+    for (let depth = 0; depth < 2; depth += 1) {
+        if (existsSync(resolve(candidate, 'package.json')))
+            return candidate;
+        candidate = resolve(candidate, '..');
+    }
+    throw new Error(`无法从 ${metaUrl} 定位 @xdxer/dingtalk-agent 包根`);
+}
+//# sourceMappingURL=package-root.js.map

package/dist/src/package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.js","sourceRoot":"","sources":["../../src/package-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC9D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACpE,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,OAAO,OAAO,8BAA8B,CAAC,CAAA;AAC/D,CAAC","sourcesContent":["import { existsSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/**\n * 源码位于 src|bin，编译产物位于 dist/src|dist/bin。\n * 资源仍发布在包根，所以不能用固定的 dirname 层数猜包根。\n */\nexport function resolvePackageRoot(metaUrl: string): string {\n  let candidate = resolve(dirname(fileURLToPath(metaUrl)), '..')\n  for (let depth = 0; depth < 2; depth += 1) {\n    if (existsSync(resolve(candidate, 'package.json'))) return candidate\n    candidate = resolve(candidate, '..')\n  }\n  throw new Error(`无法从 ${metaUrl} 定位 @xdxer/dingtalk-agent 包根`)\n}\n"]}

package/dist/src/runs.js

@@ -0,0 +1,79 @@
+// 留痕与集中进化 —— runs/YYYY-MM-DD.md，一天一档 jsonl（TypeScript source）。
+//
+// 每行钉住【三个硬 ID】—— 出问题才反查得到：
+//   issue → 平台派单 id，翻得出整个运行过程
+//   conv  → 会话 id，**filter 得出整条对话流（这就是训练素材）**
+//   msg   → 触发消息 id，定位到那一句
+// **缺了这三个，记录就只是一堆"我做了什么"，出了问题什么也追不到。**
+//
+// r  = 【引擎层】成败（跑通没有）
+// fb = 【用户层】成败（主人认不认）
+// **两者必须分开** —— 引擎跑通 ≠ 答对 ≠ 主人满意。
+// 只看 r，你会看到一片绿，然后什么也进化不了。
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+export const FB_OK = '认可', FB_MORE = '追问', FB_FIX = '纠正';
+const MARKER = 'AGENT_RUN_LOG_V1';
+const cst = (d = new Date()) => new Date(d.getTime() + 8 * 3600e3);
+export const today = () => cst().toISOString().slice(0, 10);
+export const now = () => cst().toISOString().replace('Z', '+08:00').slice(0, 19);
+export const todayZero = () => today() + 'T00:00:00+08:00';
+/** 【今晚跑过没有】= 数据水位 ≥ 今天 00:00。纯【数据派生】——
+ *  不记状态、不建标记文件、不看会话记忆。重启/换实例/漏拍都不受影响。 */
+export const ranTonight = (wm) => Boolean(wm) && String(wm) >= todayZero();
+const file = (root, day) => join(root, 'runs', `${day}.md`);
+export function read(root, day) {
+    const p = file(root, day);
+    if (!existsSync(p))
+        return [];
+    const out = [];
+    for (const line of readFileSync(p, 'utf8').split('\n')) {
+        const s = line.trim();
+        if (!s.startsWith('{'))
+            continue;
+        try {
+            out.push(JSON.parse(s));
+        }
+        catch {
+            console.error(`  ⚠️ 运行记录有坏行，跳过但【不当成空】: ${s.slice(0, 60)}`);
+        }
+    }
+    return out;
+}
+export function write(root, day, rows) {
+    mkdirSync(join(root, 'runs'), { recursive: true });
+    const body = rows.map((r) => JSON.stringify(r)).join('\n');
+    writeFileSync(file(root, day), `${MARKER} · ${day}\n\n\`\`\`jsonl\n${body}\n\`\`\`\n`);
+}
+/** 追加一行 + 回读校验。**写了没落上 = 这次没发生过，要说出来。** */
+export function append(root, row) {
+    const day = today();
+    const rows = read(root, day);
+    rows.push(row);
+    write(root, day, rows);
+    const ok = read(root, day).some((r) => r.t === row.t && r.did === row.did);
+    if (!ok)
+        console.error('  ⚠️ 运行记录写后回读不到 —— 动作照常，但【留痕失败】');
+    return ok ? row.t : '';
+}
+export function scan(root, days = 1) {
+    const out = [];
+    for (let i = 0; i < Math.max(1, days); i++) {
+        const d = new Date(Date.now() - i * 86400e3);
+        const day = cst(d).toISOString().slice(0, 10);
+        for (const r of read(root, day))
+            out.push({ ...r, _day: day });
+    }
+    return out.sort((a, b) => (a._day + a.t).localeCompare(b._day + b.t));
+}
+export function logq(root, { did, kind = '问答', secs = 0, r = 'pass', ev = '', ch = '钉钉单聊', asked = '', issue = '', conv = '', msg = '' }) {
+    const row = {
+        t: now().slice(11, 19), ch, kind, did: String(did).slice(0, 300), secs: +secs, r,
+    };
+    for (const [k, v] of [['asked', asked], ['issue', issue], ['conv', conv], ['msg', msg], ['ev', ev]]) {
+        if (v)
+            row[k] = String(v).slice(0, 600);
+    }
+    return append(root, row);
+}
+//# sourceMappingURL=runs.js.map

package/dist/src/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/runs.ts"],"names":[],"mappings":"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","sourcesContent":["// 留痕与集中进化 —— runs/YYYY-MM-DD.md，一天一档 jsonl（TypeScript source）。\n//\n// 每行钉住【三个硬 ID】—— 出问题才反查得到：\n//   issue → 平台派单 id，翻得出整个运行过程\n//   conv  → 会话 id，**filter 得出整条对话流（这就是训练素材）**\n//   msg   → 触发消息 id，定位到那一句\n// **缺了这三个，记录就只是一堆\"我做了什么\"，出了问题什么也追不到。**\n//\n// r  = 【引擎层】成败（跑通没有）\n// fb = 【用户层】成败（主人认不认）\n// **两者必须分开** —— 引擎跑通 ≠ 答对 ≠ 主人满意。\n// 只看 r，你会看到一片绿，然后什么也进化不了。\nimport { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs'\nimport { join } from 'node:path'\n\nexport const FB_OK = '认可', FB_MORE = '追问', FB_FIX = '纠正'\nconst MARKER = 'AGENT_RUN_LOG_V1'\n\nexport interface RunLogRecord {\n  t: string\n  did: string\n  r: string\n  _day?: string\n  asked?: string\n  kind?: string\n  secs?: number\n  ev?: string\n  ch?: string\n  issue?: string\n  conv?: string\n  msg?: string\n  fb?: string\n  fbt?: string\n  [key: string]: unknown\n}\n\nconst cst = (d = new Date()) => new Date(d.getTime() + 8 * 3600e3)\nexport const today = () => cst().toISOString().slice(0, 10)\nexport const now = () => cst().toISOString().replace('Z', '+08:00').slice(0, 19)\nexport const todayZero = () => today() + 'T00:00:00+08:00'\n\n/** 【今晚跑过没有】= 数据水位 ≥ 今天 00:00。纯【数据派生】——\n *  不记状态、不建标记文件、不看会话记忆。重启/换实例/漏拍都不受影响。 */\nexport const ranTonight = (wm) => Boolean(wm) && String(wm) >= todayZero()\n\nconst file = (root, day) => join(root, 'runs', `${day}.md`)\n\nexport function read(root, day): RunLogRecord[] {\n  const p = file(root, day)\n  if (!existsSync(p)) return []\n  const out: RunLogRecord[] = []\n  for (const line of readFileSync(p, 'utf8').split('\\n')) {\n    const s = line.trim()\n    if (!s.startsWith('{')) continue\n    try { out.push(JSON.parse(s) as RunLogRecord) }\n    catch { console.error(`  ⚠️ 运行记录有坏行，跳过但【不当成空】: ${s.slice(0, 60)}`) }\n  }\n  return out\n}\n\nexport function write(root, day, rows: RunLogRecord[]) {\n  mkdirSync(join(root, 'runs'), { recursive: true })\n  const body = rows.map((r) => JSON.stringify(r)).join('\\n')\n  writeFileSync(file(root, day), `${MARKER} · ${day}\\n\\n\\`\\`\\`jsonl\\n${body}\\n\\`\\`\\`\\n`)\n}\n\n/** 追加一行 + 回读校验。**写了没落上 = 这次没发生过，要说出来。** */\nexport function append(root, row: RunLogRecord) {\n  const day = today()\n  const rows = read(root, day)\n  rows.push(row)\n  write(root, day, rows)\n  const ok = read(root, day).some((r) => r.t === row.t && r.did === row.did)\n  if (!ok) console.error('  ⚠️ 运行记录写后回读不到 —— 动作照常，但【留痕失败】')\n  return ok ? row.t : ''\n}\n\nexport function scan(root, days = 1): RunLogRecord[] {\n  const out: RunLogRecord[] = []\n  for (let i = 0; i < Math.max(1, days); i++) {\n    const d = new Date(Date.now() - i * 86400e3)\n    const day = cst(d).toISOString().slice(0, 10)\n    for (const r of read(root, day)) out.push({ ...r, _day: day })\n  }\n  return out.sort((a, b) => (a._day + a.t).localeCompare(b._day + b.t))\n}\n\nexport function logq(root, { did, kind = '问答', secs = 0, r = 'pass', ev = '',\n                            ch = '钉钉单聊', asked = '', issue = '', conv = '', msg = '' }): string {\n  const row: RunLogRecord = {\n    t: now().slice(11, 19), ch, kind, did: String(did).slice(0, 300), secs: +secs, r,\n  }\n  for (const [k, v] of [['asked', asked], ['issue', issue], ['conv', conv], ['msg', msg], ['ev', ev]]) {\n    if (v) row[k] = String(v).slice(0, 600)\n  }\n  return append(root, row)\n}\n"]}