@downcity/agent 1.1.1

package/bin/shared/utils/logger/FormatShared.js

@@ -0,0 +1,215 @@
+/**
+ * LLM 请求/响应日志格式化的共享基础能力。
+ *
+ * 关键点（中文）
+ * - 这里只放与 provider 无关的 JSON/文本抽取能力。
+ * - 请求侧和响应侧各自的业务规则放到独立模块，避免继续堆成单文件巨石。
+ */
+function isJsonObjectLike(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isJsonObject(value) {
+    return isJsonObjectLike(value);
+}
+export function getStringField(objectValue, field) {
+    const value = objectValue[field];
+    return typeof value === "string" ? value : undefined;
+}
+export function getObjectField(objectValue, field) {
+    const value = objectValue[field];
+    return isJsonObjectLike(value) ? value : undefined;
+}
+export function getArrayField(objectValue, field) {
+    const value = objectValue[field];
+    return Array.isArray(value) ? value : undefined;
+}
+export function safeJsonParse(input) {
+    if (typeof input !== "string")
+        return null;
+    const trimmed = input.trim();
+    if (!trimmed)
+        return null;
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("["))
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return isJsonObjectLike(parsed) || Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + `…(truncated, ${text.length} chars total)`;
+}
+export function stringifyCompact(value, maxChars) {
+    try {
+        return truncate(JSON.stringify(value), maxChars);
+    }
+    catch {
+        return truncate(String(value), maxChars);
+    }
+}
+export function toInlineLogValue(value, maxChars) {
+    return truncate(String(value || ""), maxChars).replace(/\r?\n/g, "\\n");
+}
+export function formatLogField(key, value) {
+    return `[${key}] ${value}`;
+}
+function normalizeAttrKey(input) {
+    return String(input || "")
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_]/g, "_");
+}
+function normalizeAttrValue(input) {
+    return String(input || "")
+        .trim()
+        .replace(/\s+/g, "_")
+        .replace(/[\]\[]/g, "");
+}
+export function pushLabeledTextBlock(out, label, text, maxChars, attrs) {
+    // 关键点（中文）：日志按“每条消息一段”输出，段内换行转义为字面量 `\n`，保证紧凑且可分段。
+    const normalized = truncate(String(text || "-"), maxChars)
+        .replace(/\r\n/g, "\n")
+        .replace(/\n/g, "\\n");
+    const headLabel = Array.isArray(attrs) && attrs.length > 0 ? `${label} ${attrs.join(" ")}` : label;
+    out.push(formatLogField(headLabel, normalized || "-"));
+}
+export function parseInfoBlockText(value) {
+    const normalized = String(value || "").replace(/\r\n/g, "\n").trim();
+    if (!normalized.startsWith("<info>\n"))
+        return null;
+    const matched = normalized.match(/^<info>\n([\s\S]*?)\n<\/info>(?:\n\n([\s\S]*))?$/);
+    if (!matched)
+        return null;
+    const info = {};
+    for (const rawLine of String(matched[1] || "").split("\n")) {
+        const line = String(rawLine || "").trim();
+        const index = line.indexOf(":");
+        if (index <= 0)
+            continue;
+        const key = normalizeAttrKey(line.slice(0, index));
+        const fieldValue = normalizeAttrValue(line.slice(index + 1));
+        if (!key || !fieldValue)
+            continue;
+        info[key] = fieldValue;
+    }
+    return {
+        info,
+        body: String(matched[2] || "").trim(),
+    };
+}
+export function buildInfoAttrs(info) {
+    const preferredOrder = [
+        "message_id",
+        "user_id",
+        "username",
+        "role_id",
+        "permissions",
+        "received_at",
+        "user_timezone",
+        "channel",
+        "session_id",
+        "context_id",
+        "chat_key",
+        "chat_id",
+        "chat_type",
+        "thread_id",
+    ];
+    const attrs = [];
+    for (const key of preferredOrder) {
+        const value = String(info[key] || "").trim();
+        if (!value || value === "unknown" || value === "none")
+            continue;
+        attrs.push(`${key}=${value}`);
+    }
+    for (const [key, raw] of Object.entries(info)) {
+        if (preferredOrder.includes(key))
+            continue;
+        const value = String(raw || "").trim();
+        if (!value)
+            continue;
+        attrs.push(`${key}=${value}`);
+    }
+    return attrs;
+}
+export function contentToText(content, maxChars) {
+    if (typeof content === "string")
+        return truncate(content, maxChars);
+    if (Array.isArray(content)) {
+        const parts = content
+            .map((part) => {
+            if (!isJsonObjectLike(part))
+                return "";
+            const partType = getStringField(part, "type");
+            // 关键点（中文）：OpenAI Responses 在 assistant 历史里常见 `output_text`，必须纳入日志提取，否则会显示为 `-`。
+            if (partType === "text" ||
+                partType === "input_text" ||
+                partType === "output_text") {
+                return String(getStringField(part, "text") ?? "");
+            }
+            // 关键点（中文）：tool 事件由请求侧单独输出为 [tool]/[tool_result]，这里不混入文本。
+            if (partType === "tool-approval-request" ||
+                partType === "tool-call" ||
+                partType === "tool-result" ||
+                partType === "tool-error") {
+                return "";
+            }
+            return "";
+        })
+            .filter(Boolean)
+            .join("\n");
+        return truncate(parts, maxChars);
+    }
+    if (isJsonObjectLike(content))
+        return stringifyCompact(content, maxChars);
+    return truncate(String(content ?? ""), maxChars);
+}
+export function parsePossibleJsonObject(value) {
+    if (isJsonObjectLike(value))
+        return value;
+    if (typeof value !== "string")
+        return undefined;
+    const parsed = safeJsonParse(value);
+    return isJsonObjectLike(parsed) ? parsed : undefined;
+}
+export function extractFunctionCallExecCommandCmd(message) {
+    const itemType = getStringField(message, "type");
+    if (itemType !== "function_call")
+        return undefined;
+    const name = getStringField(message, "name");
+    if (name !== "shell_start" && name !== "shell_exec")
+        return undefined;
+    const argsObj = parsePossibleJsonObject(message.arguments);
+    if (!argsObj)
+        return undefined;
+    return getStringField(argsObj, "cmd");
+}
+export function extractMessages(payload) {
+    const messages = getArrayField(payload, "messages");
+    if (Array.isArray(messages)) {
+        return messages.filter((item) => isJsonObjectLike(item));
+    }
+    const input = getArrayField(payload, "input");
+    if (Array.isArray(input)) {
+        return input.filter((item) => isJsonObjectLike(item));
+    }
+    return null;
+}
+export function extractSystemForLog(payload) {
+    if (!payload)
+        return undefined;
+    const system = payload.system;
+    if (typeof system === "string" && system.trim())
+        return system;
+    // 关键点（中文）：OpenAI Responses 请求把 system prompt 放在 `instructions` 字段。
+    const instructions = getStringField(payload, "instructions");
+    if (typeof instructions === "string" && instructions.trim()) {
+        return instructions;
+    }
+    return system;
+}
+//# sourceMappingURL=FormatShared.js.map

package/bin/shared/utils/logger/FormatShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatShared.js","sourceRoot":"","sources":["../../../../src/shared/utils/logger/FormatShared.ts"],"names":[],"mappings":"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"}

package/bin/shared/utils/logger/Logger.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 统一日志实现（控制台 + JSONL 落盘）。
+ *
+ * 关键点（中文）
+ * - 支持按项目根目录动态绑定日志目录。
+ * - 结构化字段写入 JSONL，便于后续检索与审计。
+ */
+import type { JsonObject } from "../../../shared/types/Json.js";
+type LogDetails = {
+    [key: string]: JsonObject[keyof JsonObject] | undefined;
+};
+/**
+ * Unified runtime logger for Downcity.
+ *
+ * Design goals:
+ * - Provide a single logger interface usable by both:
+ *   - system/runtime components (server, scheduler, tool executor, etc.)
+ *   - agent/LLM execution (LLM request/response logging expects `logger.log(...)`)
+ * - Persist logs as JSONL to `.downcity/logs/<YYYY-MM-DD>.jsonl` (one line per entry).
+ * - Keep console output human-friendly, but make disk logs machine-friendly.
+ *
+ * Notes:
+ * - `log(level, ...)` is async because it may write to disk.
+ * - Convenience methods (`info/warn/...`) are sync and fire-and-forget.
+ * - A small in-memory ring buffer is kept for debugging, but persistence is append-only.
+ */
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    type: "info" | "warn" | "error" | "debug" | "action";
+    message: string;
+    details?: JsonObject;
+    duration?: number;
+    /** Back-compat: kept for older code that expects a `level` field. */
+    level?: string;
+}
+/**
+ * Logger：项目级日志器。
+ *
+ * 关键职责（中文）
+ * - 控制台可读输出（开发期）
+ * - JSONL 持久化输出（排障 / 审计）
+ */
+export declare class Logger {
+    private logs;
+    private logLevel;
+    private writeChain;
+    private readonly maxInMemoryEntries;
+    private projectRoot;
+    constructor(logLevel?: string);
+    /**
+     * 绑定进程级 projectRoot。
+     *
+     * 关键点（中文）
+     * - 我们约束“一个进程只服务一个 projectRoot”。
+     * - Logger 作为单例存在，但落盘目录必须在启动入口初始化后才能确定。
+     * - 未绑定 projectRoot 时，只打印到 console，不写入 `.downcity/logs/*`。
+     */
+    bindProjectRoot(projectRoot: string): void;
+    /**
+     * Generic async logger used by agent / LLM logging.
+     * Accepts `info|warn|error|debug|action` (case-insensitive).
+     */
+    log(level: string, message: string, details?: LogDetails): Promise<void>;
+    info(message: string, details?: LogDetails): void;
+    warn(message: string, details?: LogDetails): void;
+    error(message: string, details?: LogDetails): void;
+    debug(message: string, details?: LogDetails): void;
+    action(message: string, details?: LogDetails): void;
+    private normalizeType;
+    /**
+     * 写入策略（中文）
+     * - 先写内存与控制台，再串行追加到 JSONL，避免并发写乱序。
+     */
+    private emit;
+    private printLog;
+    /**
+     * 落盘算法（中文）
+     * - 日志按自然日分片：`.downcity/logs/YYYY-MM-DD.jsonl`。
+     * - 每条日志一行 JSON，便于 grep / 流式消费。
+     */
+    private saveToFile;
+    private generateId;
+    saveAllLogs(): Promise<void>;
+    getLogs(): LogEntry[];
+    getLogsByType(type: LogEntry["type"]): LogEntry[];
+    getRecentLogs(count?: number): LogEntry[];
+    clearLogs(): void;
+}
+export declare const logger: Logger;
+/**
+ * 获取统一 logger。
+ *
+ * 说明（中文）
+ * - 当前实现是“进程级单例 logger”（落盘路径依赖 runtime root）。
+ * - 参数保留是为了兼容上层调用习惯：有些代码会传入 projectRoot / logLevel。
+ * - 若未来需要“多实例 logger”，可以在这里集中改，不影响调用方。
+ */
+export declare function getLogger(_projectRoot?: string, _logLevel?: string): Logger;
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/bin/shared/utils/logger/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,KAAK,UAAU,GAAG;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;CACzD,CAAC;AA+IF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,WAAW,CAAuB;gBAE9B,QAAQ,GAAE,MAAe;IAIrC;;;;;;;OAOG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK1C;;;OAGG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC;IAKhB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,OAAO,CAAC,aAAa;IAWrB;;;OAGG;YACW,IAAI;IA2BlB,OAAO,CAAC,QAAQ;IA2BhB;;;;OAIG;YACW,UAAU;IAWxB,OAAO,CAAC,UAAU;IAIZ,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,IAAI,QAAQ,EAAE;IAIrB,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,EAAE;IAIjD,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAI7C,SAAS,IAAI,IAAI;CAGlB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/bin/shared/utils/logger/Logger.js

@@ -0,0 +1,308 @@
+/**
+ * 统一日志实现（控制台 + JSONL 落盘）。
+ *
+ * 关键点（中文）
+ * - 支持按项目根目录动态绑定日志目录。
+ * - 结构化字段写入 JSONL，便于后续检索与审计。
+ */
+import fs from "fs-extra";
+import path from "path";
+import { getLogsDirPath } from "../../../config/Paths.js";
+import { getTimestamp } from "../../utils/Time.js";
+const ANSI_RESET = "\x1b[0m";
+const ANSI_BOLD = "\x1b[1m";
+const TASK_BRACKET_COLOR = "\x1b[95m"; // bright magenta
+const ALLOWED_MESSAGE_LABELS = new Set([
+    "main",
+    "system",
+    "user",
+    "assistant",
+    "tool",
+    "tool_result",
+    "agent",
+]);
+const FIXED_BRACKET_COLORS = {
+    INFO: "\x1b[36m", // cyan
+    WARN: "\x1b[33m", // yellow
+    ERROR: "\x1b[31m", // red
+    DEBUG: "\x1b[90m", // gray
+    ACTION: "\x1b[96m", // bright cyan
+    SYSTEM: "\x1b[90m", // gray
+    USER: "\x1b[33m", // yellow
+    ASSISTANT: "\x1b[32m", // green
+    TOOL: "\x1b[95m", // bright magenta
+    TOOL_RESULT: "\x1b[34m", // blue
+    AGENT: "\x1b[36m", // cyan
+    MAIN: "\x1b[90m", // gray
+};
+const BRACKET_COLOR_PALETTE = [
+    "\x1b[36m", // cyan
+    "\x1b[32m", // green
+    "\x1b[35m", // magenta
+    "\x1b[34m", // blue
+    "\x1b[33m", // yellow
+    "\x1b[96m", // bright cyan
+];
+function normalizeLogDetails(details) {
+    if (!details)
+        return undefined;
+    const normalized = {};
+    for (const [key, value] of Object.entries(details)) {
+        if (value !== undefined) {
+            normalized[key] = value;
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function hashText(input) {
+    let hash = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
+    }
+    return hash;
+}
+function colorizeBracketedPrefix(label) {
+    const normalized = String(label || "").trim().toUpperCase();
+    const baseLabel = normalized.split(/[.\s]+/)[0].replace(/[^A-Z0-9_]/g, "");
+    // 关键点（中文）：task 日志标签使用固定高可见色，避免随机色导致辨识度不稳定。
+    if (normalized === "TASK") {
+        return `${TASK_BRACKET_COLOR}[${label}]${ANSI_RESET}`;
+    }
+    const fixedColor = FIXED_BRACKET_COLORS[normalized] || FIXED_BRACKET_COLORS[baseLabel];
+    if (fixedColor) {
+        return `${fixedColor}[${label}]${ANSI_RESET}`;
+    }
+    const color = BRACKET_COLOR_PALETTE[hashText(label) % BRACKET_COLOR_PALETTE.length];
+    return `${color}[${label}]${ANSI_RESET}`;
+}
+function colorizeMessageBracketPrefixes(message) {
+    // 关键点（中文）：紧凑单行展示时，给消息中的标签 token 着色，正文保持原样。
+    return String(message || "").replace(/\[([^\]\n]+)\]/g, (full, label) => {
+        const normalized = String(label || "").trim();
+        const base = normalized
+            .toUpperCase()
+            .split(/[.\s:]+/)[0]
+            .replace(/[^A-Z0-9_]/g, "");
+        if (!base || !/[A-Z]/.test(base))
+            return full;
+        return colorizeBracketedPrefix(normalized);
+    });
+}
+/**
+ * 压缩日志为“可分段的紧凑展示”。
+ *
+ * 关键点（中文）
+ * - 段内换行转义为字面量 `\n`，避免一条消息占多行。
+ * - 段与段之间保留真实换行，确保不同 message 可清晰区分。
+ */
+function compactMessageForConsole(message) {
+    const normalized = String(message || "").replace(/\r\n/g, "\n");
+    const blocks = normalized
+        .split(/\n{2,}/)
+        .map((block) => String(block || "").replace(/\n/g, "\\n").trim())
+        .filter(Boolean);
+    if (blocks.length === 0)
+        return "";
+    return blocks.join("\n");
+}
+function normalizeToAllowedMessageLabels(message) {
+    const normalizedLines = [];
+    let activeLabel = null;
+    for (const rawLine of String(message || "").split("\n")) {
+        const line = String(rawLine || "");
+        const trimmed = line.trim();
+        if (!trimmed) {
+            normalizedLines.push("");
+            continue;
+        }
+        const matched = trimmed.match(/^\[([^\]]+)\]\s*:?\s*(.*)$/);
+        if (matched) {
+            const rawLabel = String(matched[1] || "").trim();
+            const lowerLabel = rawLabel.toLowerCase();
+            const labelToken = lowerLabel.split(/\s+/)[0] || "";
+            const baseLabel = labelToken.split(".")[0];
+            const content = String(matched[2] || "").trim();
+            if (ALLOWED_MESSAGE_LABELS.has(baseLabel)) {
+                activeLabel = baseLabel;
+                const attrsRaw = rawLabel.slice(labelToken.length).trim();
+                const normalizedLabel = attrsRaw ? `${baseLabel} ${attrsRaw}` : baseLabel;
+                normalizedLines.push(`[${normalizedLabel}]${content ? ` ${content}` : ""}`);
+            }
+            else {
+                activeLabel = "main";
+                normalizedLines.push(`[main] ${content || trimmed}`);
+            }
+            continue;
+        }
+        if (activeLabel) {
+            // 关键点（中文）：同一消息块的续行不重复打标签。
+            normalizedLines.push(line);
+            continue;
+        }
+        normalizedLines.push(`[main] ${trimmed}`);
+    }
+    if (normalizedLines.length === 0)
+        return "[main] -";
+    return normalizedLines.join("\n");
+}
+/**
+ * Logger：项目级日志器。
+ *
+ * 关键职责（中文）
+ * - 控制台可读输出（开发期）
+ * - JSONL 持久化输出（排障 / 审计）
+ */
+export class Logger {
+    logs = [];
+    logLevel = "info";
+    writeChain = Promise.resolve();
+    maxInMemoryEntries = 2000;
+    projectRoot = null;
+    constructor(logLevel = "info") {
+        this.logLevel = logLevel;
+    }
+    /**
+     * 绑定进程级 projectRoot。
+     *
+     * 关键点（中文）
+     * - 我们约束“一个进程只服务一个 projectRoot”。
+     * - Logger 作为单例存在，但落盘目录必须在启动入口初始化后才能确定。
+     * - 未绑定 projectRoot 时，只打印到 console，不写入 `.downcity/logs/*`。
+     */
+    bindProjectRoot(projectRoot) {
+        const root = String(projectRoot || "").trim();
+        this.projectRoot = root || null;
+    }
+    /**
+     * Generic async logger used by agent / LLM logging.
+     * Accepts `info|warn|error|debug|action` (case-insensitive).
+     */
+    async log(level, message, details) {
+        const type = this.normalizeType(level);
+        await this.emit(type, message, details);
+    }
+    info(message, details) {
+        void this.emit("info", message, details);
+    }
+    warn(message, details) {
+        void this.emit("warn", message, details);
+    }
+    error(message, details) {
+        void this.emit("error", message, details);
+    }
+    debug(message, details) {
+        void this.emit("debug", message, details);
+    }
+    action(message, details) {
+        void this.emit("action", message, details);
+    }
+    normalizeType(level) {
+        const s = String(level || "")
+            .trim()
+            .toLowerCase();
+        if (s === "warn" || s === "warning")
+            return "warn";
+        if (s === "error" || s === "err")
+            return "error";
+        if (s === "debug" || s === "trace")
+            return "debug";
+        if (s === "action")
+            return "action";
+        return "info";
+    }
+    /**
+     * 写入策略（中文）
+     * - 先写内存与控制台，再串行追加到 JSONL，避免并发写乱序。
+     */
+    async emit(type, message, details) {
+        const entry = {
+            id: this.generateId(),
+            timestamp: getTimestamp(),
+            type,
+            message: normalizeToAllowedMessageLabels(message),
+            details: normalizeLogDetails(details),
+            level: type,
+        };
+        this.logs.push(entry);
+        if (this.logs.length > this.maxInMemoryEntries) {
+            this.logs.splice(0, this.logs.length - this.maxInMemoryEntries);
+        }
+        this.printLog(entry);
+        this.writeChain = this.writeChain
+            .catch(() => { })
+            .then(() => this.saveToFile(entry))
+            .catch(() => { });
+        await this.writeChain;
+    }
+    printLog(entry) {
+        // 关键点（中文）：控制台输出不展示前置时间戳，减少聊天链路日志噪音。
+        // 时间信息仍保存在 JSONL 落盘字段 `timestamp` 中。
+        const compactBody = compactMessageForConsole(entry.message);
+        const body = colorizeMessageBracketPrefixes(compactBody);
+        const message = body;
+        switch (entry.type) {
+            case "error":
+                console.error(message);
+                break;
+            case "warn":
+                console.warn(message);
+                break;
+            case "debug":
+                if (this.logLevel === "debug") {
+                    console.log(message);
+                }
+                break;
+            case "action":
+                console.log(message);
+                break;
+            default:
+                console.log(message);
+        }
+    }
+    /**
+     * 落盘算法（中文）
+     * - 日志按自然日分片：`.downcity/logs/YYYY-MM-DD.jsonl`。
+     * - 每条日志一行 JSON，便于 grep / 流式消费。
+     */
+    async saveToFile(entry) {
+        if (!this.projectRoot)
+            return;
+        const logsDir = getLogsDirPath(this.projectRoot);
+        const date = String(entry.timestamp || "").slice(0, 10) || new Date().toISOString().slice(0, 10);
+        const logFile = path.join(logsDir, `${date}.jsonl`);
+        const logLine = JSON.stringify(entry) + "\n";
+        await fs.ensureDir(logsDir);
+        await fs.appendFile(logFile, logLine);
+    }
+    generateId() {
+        return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+    }
+    async saveAllLogs() {
+        await this.writeChain.catch(() => { });
+    }
+    getLogs() {
+        return this.logs;
+    }
+    getLogsByType(type) {
+        return this.logs.filter((log) => log.type === type);
+    }
+    getRecentLogs(count = 10) {
+        return this.logs.slice(-count);
+    }
+    clearLogs() {
+        this.logs = [];
+    }
+}
+export const logger = new Logger();
+/**
+ * 获取统一 logger。
+ *
+ * 说明（中文）
+ * - 当前实现是“进程级单例 logger”（落盘路径依赖 runtime root）。
+ * - 参数保留是为了兼容上层调用习惯：有些代码会传入 projectRoot / logLevel。
+ * - 若未来需要“多实例 logger”，可以在这里集中改，不影响调用方。
+ */
+export function getLogger(_projectRoot, _logLevel) {
+    return logger;
+}
+//# sourceMappingURL=Logger.js.map

package/bin/shared/utils/logger/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../../../src/shared/utils/logger/Logger.ts"],"names":[],"mappings":"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"}

package/bin/shared/utils/storage/index.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "../../../shared/types/Json.js";
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function saveJson(filePath: string, data: JsonValue | object): Promise<void>;
+export declare function loadJson<T>(filePath: string): Promise<T | null>;
+//# sourceMappingURL=index.d.ts.map

package/bin/shared/utils/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/storage/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKrE"}