evolclaw 3.0.0 → 3.1.1

package/dist/paths.js

@@ -36,15 +36,13 @@ export function resolvePaths() {
         readySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         selfHealLog: path.join(root, 'logs', 'self-heal.md'),
         socket: resolveInstanceSocketPath(root),
-        // ── 新结构（evolclaw-home-directory.md）────────────────
+        // ── 新结构（evolclaw-directory-design.md）────────────────
         defaultsConfig: path.join(root, 'agents', 'defaults.json'),
-        kitsDir: path.join(root, 'kits'),
-        kitsAunDir: path.join(root, 'kits', 'aun'),
-        kitsChannelsDir: path.join(root, 'kits', 'channels'),
-        kitsEvolclawDir: path.join(root, 'kits', 'evolclaw'),
-        kitsTemplatesDir: path.join(root, 'kits', 'templates'),
+        processConfig: path.join(root, 'config.json'),
+        eckDir: path.join(root, 'eck'),
         instanceReadySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         instanceSocket: resolveInstanceSocketPath(root),
+        aidLogsDir: path.join(root, 'logs', 'aids'),
     };
 }
 // ── per-agent 路径（参数化，不进 resolvePaths() 的固定 map）──
@@ -57,8 +55,15 @@ export function agentConfig(aid) {
 export function agentPersonalDir(aid) {
     return path.join(agentDir(aid), 'personal');
 }
+export function agentRelationsDir(aid) {
+    return path.join(agentDir(aid), 'relations');
+}
+/** @deprecated Use agentRelationsDir instead */
 export function agentIdentitiesDir(aid) {
-    return path.join(agentDir(aid), 'identities');
+    return agentRelationsDir(aid);
+}
+export function agentIndexDir(aid) {
+    return path.join(agentDir(aid), 'index');
 }
 export function agentVenuesDir(aid) {
     return path.join(agentDir(aid), 'venues');
@@ -86,44 +91,30 @@ export function ensureDataDirs() {
     const p = resolvePaths();
     fs.mkdirSync(p.dataDir, { recursive: true });
     fs.mkdirSync(p.logs, { recursive: true });
+    fs.mkdirSync(p.aidLogsDir, { recursive: true });
     fs.mkdirSync(p.agentsDir, { recursive: true });
     fs.mkdirSync(p.sessionsDir, { recursive: true });
     fs.mkdirSync(p.instanceDir, { recursive: true });
     fs.mkdirSync(p.outboxDir, { recursive: true });
-    fs.mkdirSync(p.kitsDir, { recursive: true });
+    fs.mkdirSync(p.eckDir, { recursive: true });
+    fs.mkdirSync(eckDebugDir(), { recursive: true });
 }
-/**
- * 首次启动或升级时，把包内 kits/ 复制到 EVOLCLAW_HOME/kits/。
- * 策略：如果目标 kits/ 为空或包版本更新，整体覆盖。
- */
-export function syncKitsFromPackage() {
-    const p = resolvePaths();
-    const srcKits = path.join(getPackageRoot(), 'kits');
-    if (!fs.existsSync(srcKits))
-        return;
-    const destKits = p.kitsDir;
-    // 包内自用场景：EVOLCLAW_HOME 等于包根（开发仓 / 用户家目录恰好是安装目录），
-    // src === dest 会让 cpSync 抛 ERR_FS_CP_EINVAL。直接跳过同步。
-    if (path.resolve(srcKits) === path.resolve(destKits))
-        return;
-    // 用 .kits-version 文件跟踪已安装的版本
-    const versionFile = path.join(destKits, '.kits-version');
-    const pkgJsonPath = path.join(getPackageRoot(), 'package.json');
-    let pkgVersion = '0.0.0';
-    try {
-        pkgVersion = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8')).version || '0.0.0';
-    }
-    catch { }
-    let installedVersion = '';
-    try {
-        installedVersion = fs.readFileSync(versionFile, 'utf-8').trim();
-    }
-    catch { }
-    if (installedVersion === pkgVersion)
-        return;
-    // 递归复制（覆盖）
-    fs.cpSync(srcKits, destKits, { recursive: true, force: true });
-    fs.writeFileSync(versionFile, pkgVersion, 'utf-8');
+// ── kits 路径（始终从包内读取，不复制到 EVOLCLAW_HOME）──
+export function kitsDir() {
+    return path.join(getPackageRoot(), 'kits');
+}
+export function kitsRulesDir() {
+    return path.join(getPackageRoot(), 'kits', 'rules');
+}
+export function kitsDocsDir() {
+    return path.join(getPackageRoot(), 'kits', 'docs');
+}
+export function kitsTemplatesDir() {
+    return path.join(getPackageRoot(), 'kits', 'templates');
+}
+// ── 调试输出 ──
+export function eckDebugDir() {
+    return path.join(resolveRoot(), 'data', 'eck-debug');
 }
 export function getPackageRoot() {
     // import.meta.dirname is available in Node.js 21.2+ and always returns

package/dist/utils/aid-lifecycle-log.js

@@ -0,0 +1,33 @@
+import fs from 'fs';
+import path from 'path';
+import { resolvePaths } from '../paths.js';
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+function logPath(aid) {
+    const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
+    return path.join(resolvePaths().aidLogsDir, `${aidName}.jsonl`);
+}
+export function appendAidLifecycle(event) {
+    const filePath = logPath(event.aid);
+    ensureDir(path.dirname(filePath));
+    fs.appendFileSync(filePath, JSON.stringify(event) + '\n');
+}
+export function readAidLifecycle(aid, lastN = 50) {
+    const filePath = logPath(aid);
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const events = [];
+        for (const line of lines.slice(-lastN)) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        return events;
+    }
+    catch {
+        return [];
+    }
+}

package/dist/utils/atomic-write.js

@@ -77,3 +77,13 @@ export function ensureDir(dirPath) {
         fs.mkdirSync(dirPath, { recursive: true });
     }
 }
+/**
+ * Simple atomic write for plain-text files (ECK runtime files).
+ * Uses write-tmp-then-rename (no hot-backup needed for these files).
+ */
+export function atomicWriteText(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = filePath + '.tmp.' + process.pid;
+    fs.writeFileSync(tmp, content, 'utf-8');
+    fs.renameSync(tmp, filePath);
+}

package/dist/utils/cross-platform.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { execFileSync, execFile, spawn } from 'child_process';
+import { execFileSync, execFile, spawn, spawnSync } from 'child_process';
 import { promisify } from 'util';
 import fs from 'fs';
 const execFileAsync = promisify(execFile);
@@ -33,7 +33,7 @@ export function isProcessRunning(pid) {
 export function killProcess(pid, force = false) {
     if (isWindows && force) {
         try {
-            execFileSync('taskkill', ['/PID', String(pid), '/F']);
+            spawnSync('taskkill', ['/PID', String(pid), '/F'], { windowsHide: true });
         }
         catch { }
     }
@@ -51,7 +51,8 @@ export function killProcess(pid, force = false) {
 export function findProcesses(pattern) {
     try {
         if (isWindows) {
-            const output = execFileSync('wmic', ['process', 'where', `CommandLine like '%${pattern}%'`, 'get', 'ProcessId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `CommandLine like '%${pattern}%'`, 'get', 'ProcessId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const output = result.stdout || '';
             return output.split('\n')
                 .map(line => parseInt(line.trim(), 10))
                 .filter(pid => !isNaN(pid) && pid !== process.pid);
@@ -68,8 +69,8 @@ export function findProcesses(pattern) {
 export function getProcessInfo(pid) {
     try {
         if (isWindows) {
-            // Use wmic on Windows
-            const output = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'WorkingSetSize,CreationDate'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'WorkingSetSize,CreationDate'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const output = result.stdout || '';
             const lines = output.trim().split('\n').filter(l => l.trim());
             if (lines.length >= 2) {
                 const parts = lines[1].trim().split(/\s+/);
@@ -109,19 +110,27 @@ function formatUptime(totalSeconds) {
 /**
  * Cross-platform command existence check.
  */
+const _commandExistsCache = new Map();
 export function commandExists(cmd) {
+    const cached = _commandExistsCache.get(cmd);
+    if (cached !== undefined)
+        return cached;
+    let exists = false;
     try {
         if (isWindows) {
-            execFileSync('where', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+            const r = spawnSync('where', [cmd], { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
+            exists = r.status === 0;
         }
         else {
             execFileSync('which', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+            exists = true;
         }
-        return true;
     }
     catch {
-        return false;
+        exists = false;
     }
+    _commandExistsCache.set(cmd, exists);
+    return exists;
 }
 /**
  * Cross-platform live log tailing (replaces tail -f).

package/dist/utils/error-utils.js

@@ -73,7 +73,14 @@ let _rules = [];
 let _lastMtime = 0;
 function getDictPath() {
     if (!_dictPath) {
-        _dictPath = path.join(resolvePaths().dataDir, 'error-dict.json');
+        const userDict = path.join(resolvePaths().dataDir, 'error-dict.json');
+        if (fs.existsSync(userDict)) {
+            _dictPath = userDict;
+        }
+        else {
+            // Bundled default: src/utils/ → src/data/ (dev) or dist/utils/ → dist/data/ (prod)
+            _dictPath = path.resolve(import.meta.dirname, '..', 'data', 'error-dict.json');
+        }
     }
     return _dictPath;
 }
@@ -199,7 +206,8 @@ export function classifyError(error) {
     }
     // 内置兜底规则（结构性、稳定的错误模式）
     if (msg.includes('context_length_exceeded') || msg.includes('context_compact_failed')
-        || msg.includes('context limit')) {
+        || msg.includes('context limit') || msg.includes('input is too long')
+        || msg.includes('上下文过长')) {
         return ErrorType.CONTEXT_TOO_LONG;
     }
     if (msg.includes('401') || msg.includes('authentication_error')) {
@@ -237,27 +245,29 @@ export function isRetryableError(error) {
         return true;
     return false;
 }
-export function getErrorMessage(error, terminalReason) {
+export function getErrorMessage(error, terminalReason, includeEmoji = true) {
     // terminalReason 提供更精确的错误提示（SDK 0.2.100+）
     if (terminalReason) {
+        const prefix = includeEmoji ? '❌ ' : '';
+        const warnPrefix = includeEmoji ? '⚠️ ' : '';
         switch (terminalReason) {
             case 'max_turns':
-                return '❌ 任务达到最大轮次限制，请简化需求或分步执行';
+                return `${prefix}任务达到最大轮次限制，请简化需求或分步执行`;
             case 'prompt_too_long':
-                return '⚠️ 输入过长，请精简提问或使用 /compact 压缩上下文';
+                return `${warnPrefix}输入过长，请精简提问或使用 /compact 压缩上下文`;
             case 'rapid_refill_breaker':
-                return '⚠️ API 限流中，请稍后重试';
+                return `${warnPrefix}API 限流中，请稍后重试`;
             case 'context_compact_failed':
-                return '⚠️ 上下文过长，自动压缩失败，请手动输入 /compact 重试';
+                return `${warnPrefix}上下文过长，自动压缩失败，请手动输入 /compact 重试`;
             case 'model_error':
-                return '❌ 模型服务异常，请稍后重试';
+                return `${prefix}模型服务异常，请稍后重试`;
             case 'tool_error':
-                return '❌ 工具执行失败，请检查操作或重试';
+                return `${prefix}工具执行失败，请检查操作或重试`;
             case 'permission_denied':
-                return '❌ 权限被拒绝，操作已取消';
+                return `${prefix}权限被拒绝，操作已取消`;
             case 'aborted_streaming':
             case 'aborted_tools':
-                return '❌ 任务已中断';
+                return `${prefix}任务已中断`;
         }
     }
     // 回退到原有的错误消息匹配逻辑
@@ -267,15 +277,17 @@ export function getErrorMessage(error, terminalReason) {
     if (rule?.message)
         return rule.message;
     // 内置兜底规则（结构性错误）
+    const warnPrefix = includeEmoji ? '⚠️ ' : '';
+    const errPrefix = includeEmoji ? '❌ ' : '';
     if (msg.includes('CONTEXT_COMPACT_FAILED') || msg.includes('context_length_exceeded')
         || msg.includes('Context limit')) {
-        return '⚠️ 上下文过长，自动压缩失败，请手动输入 /compact 重试';
+        return `${warnPrefix}上下文过长，自动压缩失败，请手动输入 /compact 重试`;
     }
     if (msg.includes('401') || msg.includes('authentication_error')) {
-        return '❌ API Key 无效，请检查密钥配置。使用 /status 查看当前配置';
+        return `${errPrefix}API Key 无效，请检查密钥配置。使用 /status 查看当前配置`;
     }
     if (msg.includes('timeout')) {
-        return '⚠️ 请求超时，请重试';
+        return `${warnPrefix}请求超时，请重试`;
     }
-    return '❌ 处理消息时出错，请稍后重试';
+    return `${errPrefix}处理消息时出错，请稍后重试`;
 }

package/dist/utils/instance-registry.js

@@ -10,7 +10,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { execFileSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { resolvePaths } from '../paths.js';
 import { isProcessRunning, killProcess, isWindows, findProcesses } from './cross-platform.js';
 import { getProcessStartTime, startTimeMatches } from './process-introspect.js';
@@ -389,7 +389,8 @@ export function killOrphans(orphans) {
 function readCmdline(pid) {
     if (isWindows) {
         try {
-            const out = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CommandLine', '/value'], { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] });
+            const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CommandLine', '/value'], { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const out = result.stdout || '';
             const m = out.match(/CommandLine=([^\r\n]+)/);
             return m ? m[1].trim() : '';
         }
@@ -401,13 +402,13 @@ function readCmdline(pid) {
         return fs.readFileSync(`/proc/${pid}/cmdline`, 'utf-8').replace(/\0/g, ' ').trim();
     }
     catch {
-        // macOS / 权限不足
         try {
-            return execFileSync('ps', ['-p', String(pid), '-o', 'args='], {
+            const result = spawnSync('ps', ['-p', String(pid), '-o', 'args='], {
                 encoding: 'utf-8',
                 timeout: 3000,
                 stdio: ['pipe', 'pipe', 'pipe'],
-            }).trim();
+            });
+            return result.stdout?.trim() || '';
         }
         catch {
             return '';

package/dist/utils/log-writer.js

@@ -207,7 +207,8 @@ export class LogWriter {
                 continue;
             const full = path.join(logDir, name);
             try {
-                if (fs.statSync(full).mtimeMs < cutoff)
+                const st = fs.lstatSync(full);
+                if (st.isSymbolicLink() || st.mtimeMs < cutoff)
                     fs.unlinkSync(full);
             }
             catch { }

package/dist/utils/logger.js

@@ -22,6 +22,10 @@ const messageWriter = config.messageLog
 const eventWriter = config.eventLog
     ? new LogWriter({ baseName: 'events', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } })
     : null;
+// 渠道入站日志：记录从渠道收到的原始消息
+const channelInWriter = new LogWriter({ baseName: 'channel-in', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } });
+// 渠道出站日志：记录发往渠道的所有消息
+const channelOutWriter = new LogWriter({ baseName: 'channel-out', logDir: LOG_DIR, rotation: 'hourly', retention: { hours: 12 } });
 function shouldLog(level) {
     return (LEVELS[level] ?? 1) >= (LEVELS[currentLevel] ?? 1);
 }
@@ -63,5 +67,11 @@ export const logger = {
         if (!eventWriter)
             return;
         eventWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
+    },
+    channelIn: (data) => {
+        channelInWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
+    },
+    channelOut: (data) => {
+        channelOutWriter.write(JSON.stringify({ ts: localTimestamp(), ...data }));
     }
 };

package/dist/utils/npm-ops.js

@@ -83,12 +83,12 @@ export function getLocalVersion() {
     return pkg.version;
 }
 /**
- * 查询 npm registry 上 evolclaw 的最新版本。
+ * 查询 npm registry 上指定包的最新版本。
  * 超时 15 秒，失败返回 null。
  */
-export function checkLatestVersion() {
+export function checkLatestVersion(pkg = 'evolclaw') {
     return new Promise((resolve) => {
-        execFile('npm', ['view', 'evolclaw', 'version'], { timeout: 15000 }, (err, stdout) => {
+        execFile('npm', ['view', pkg, 'version'], { timeout: 15000 }, (err, stdout) => {
             if (err) {
                 resolve(null);
                 return;
@@ -129,3 +129,35 @@ export async function tryUpgrade() {
     }
     return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
 }
+/**
+ * AUN SDK 升级流程：检查 → 比较 → 安装
+ * 仅在 SDK 已安装时检查升级，未安装则跳过。
+ */
+export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
+    if (isLinkedInstall()) {
+        return { status: 'skipped' };
+    }
+    const installed = resolveAunCoreSdkPkg();
+    if (!installed) {
+        return { status: 'skipped' }; // SDK not installed, skip
+    }
+    const localVer = installed.version;
+    const remoteVer = await checkLatestVersion(AUN_CORE_SDK_PKG);
+    if (!remoteVer) {
+        return { status: 'skipped', error: 'Failed to check remote version' };
+    }
+    if (compareVersions(localVer, remoteVer) >= 0) {
+        return { status: 'no-update', from: localVer };
+    }
+    let lastError;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            await npmInstallGlobal(`${AUN_CORE_SDK_PKG}@latest`);
+            return { status: 'upgraded', from: localVer, to: remoteVer };
+        }
+        catch (e) {
+            lastError = e.stderr || e.message || String(e);
+        }
+    }
+    return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
+}

package/dist/utils/process-introspect.js

@@ -7,7 +7,7 @@
  * killing the wrong process).
  */
 import fs from 'fs';
-import { execFileSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { isWindows } from './cross-platform.js';
 const isMacOS = process.platform === 'darwin';
 /** 容差：2 秒（覆盖 macOS 秒级精度 + 时钟漂移） */
@@ -39,8 +39,6 @@ export function startTimeMatches(recorded, actual) {
 }
 // ── Linux ──
 function getStartTimeLinux(pid) {
-    // /proc/<pid>/stat 第 22 字段：starttime（jiffies since boot）
-    // 注意 comm 字段（第 2 字段）含括号，可能包含空格，从最后一个 ')' 之后切
     let stat;
     try {
         stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf-8');
@@ -50,7 +48,6 @@ function getStartTimeLinux(pid) {
     }
     const tail = stat.slice(stat.lastIndexOf(')') + 2);
     const fields = tail.split(' ');
-    // tail 从第 3 字段（state）开始，第 22 字段索引为 22 - 3 = 19
     const starttimeJiffies = parseInt(fields[19], 10);
     if (isNaN(starttimeJiffies))
         return null;
@@ -63,62 +60,44 @@ function getStartTimeLinux(pid) {
     }
     if (isNaN(uptimeSec))
         return null;
-    // CLK_TCK 在绝大多数 Linux 系统是 100
     const clkTck = 100;
     const bootTimeMs = Date.now() - uptimeSec * 1000;
     return bootTimeMs + (starttimeJiffies / clkTck) * 1000;
 }
 // ── macOS ──
 function getStartTimeMacOS(pid) {
-    let out;
-    try {
-        out = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
-            encoding: 'utf-8',
-            timeout: 5000,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-    }
-    catch {
-        return null;
-    }
+    const result = spawnSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+        encoding: 'utf-8',
+        timeout: 5000,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    const out = result.stdout?.trim();
     if (!out)
         return null;
-    // 输出格式："Fri May 16 08:00:00 2026"
     const t = Date.parse(out);
     return isNaN(t) ? null : t;
 }
 // ── Windows ──
 function getStartTimeWindows(pid) {
-    // 优先 PowerShell Get-CimInstance（现代）
     const fromPwsh = winPowerShellCreationDate(pid);
     if (fromPwsh !== null)
         return fromPwsh;
-    // 降级 wmic
     return winWmicCreationDate(pid);
 }
 function winPowerShellCreationDate(pid) {
-    let out;
-    try {
-        out = execFileSync('powershell', [
-            '-NoProfile',
-            '-Command',
-            `(Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}').CreationDate`,
-        ], { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-    }
-    catch {
+    const result = spawnSync('powershell', [
+        '-NoProfile',
+        '-Command',
+        `(Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}').CreationDate`,
+    ], { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    const out = result.stdout?.trim();
+    if (!out)
         return null;
-    }
     return parseCimDate(out);
 }
 function winWmicCreationDate(pid) {
-    let out;
-    try {
-        out = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CreationDate', '/value'], { encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] });
-    }
-    catch {
-        return null;
-    }
-    // wmic 输出 "CreationDate=20260516080000.000000+480"
+    const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CreationDate', '/value'], { encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    const out = result.stdout || '';
     const m = out.match(/CreationDate=([^\r\n]+)/);
     if (!m)
         return null;
@@ -138,7 +117,6 @@ export function parseCimDate(s) {
     const tzMin = parseInt(tz, 10);
     if (isNaN(tzMin))
         return null;
-    // CIM 的时间是"本地时区时间"，要换成 UTC：UTC = local - offset
     const localUtcMs = Date.UTC(+y, +mo - 1, +d, +h, +mi, +sec, Math.floor(+us / 1000));
     return localUtcMs - tzMin * 60 * 1000;
 }