@downcity/agent 1.1.7 → 1.1.10

package/src/service/builtins/chat/ChatService.ts

@@ -10,11 +10,11 @@
 
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
-import type { ServiceActions } from "@/shared/types/Service.js";
+import type { ServiceActions } from "@/service/types/Service.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { ChatChannelState } from "@/shared/types/ChatRuntime.js";
-import type { StoredChannelAccount } from "@/shared/types/Store.js";
-import type { ChatQueueWorkerConfig } from "@/shared/types/ChatQueueWorker.js";
+import type { ChatChannelState } from "@/service/builtins/chat/types/ChatRuntime.js";
+import type { StoredChannelAccount } from "@/host/types/Store.js";
+import type { ChatQueueWorkerConfig } from "@/service/builtins/chat/types/ChatQueueWorker.js";
 import type {
   ChatServiceFeishuOptions,
   ChatServiceOptions,

package/src/service/builtins/chat/ChatServiceTypes.ts

@@ -8,8 +8,8 @@
  */
 
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { ChatQueueWorkerConfig } from "@/shared/types/ChatQueueWorker.js";
-import type { StoredChannelAccount } from "@/shared/types/Store.js";
+import type { ChatQueueWorkerConfig } from "@/service/builtins/chat/types/ChatQueueWorker.js";
+import type { StoredChannelAccount } from "@/host/types/Store.js";
 import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
 
 /**

package/src/service/builtins/chat/PROMPT.direct.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/builtins/chat/PROMPT.direct.ts.txt
+const TEXT_MODULE_CONTENT = "# Chat Service 使用说明\n\n## 用户可见回复规则\n\n- 当前模式下，直接输出，即会发送消息给到用户对应的channel\n\n## 输出协议\n\n- 需要普通回复时，直接输出文本即可。文本顶部可用 frontmatter metadata (optional)，字段语义与 `city chat send` 保持一致：\n\n- `delay` / `delayMs`：延迟发送毫秒数。\n- `time` / `sendAt` / `sendAtMs`：定时发送时间。\n- `reply`：是否使用 reply 语义发送。\n- `messageId`：目标 `message_id`（群聊推荐）。\n- `react`：发送表情反应。\n  - 单个字符串：`react: \"👍\"`\n  - 或对象/数组：`emoji/big`\n  - 设置 `messageId` 时，`react` 会优先复用该消息作为目标消息。\n- 附件使用 `<file type=\"...\">path</file>`（支持 `document/photo/voice/audio/video`）。\n- 附件路径必须是项目内可访问的相对路径。多附件可输出多个 `<file>` 标签。\n\n### 示例\n\n```text\n---\nreply: true\nmessageId: \"128\"\nreact:\n  - emoji: \"✅\"\n---\n这是今天的报告。\n<file type=\"document\">reports/daily.md</file>\n```\n\n### 协议约束\n\n- frontmatter 必须位于文本最开头（`---` 包裹）。\n- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。\n\n## 跨协议/跨平台操作\n\n- 当任务需要跨会话、跨平台或复杂路由，必须使用 `city chat send` / `city chat react`。\n- metadata 只适用于当前会话内的 direct 出站，不要拿 metadata 做跨 chat 路由。\n- 如果需要跨 chat 发送，或者不清楚怎么发送，直接先调用 `city chat --help` 查看方法。\n- 如不确定参数或正文协议，先自行调用：\n  - `city chat --help`\n  - `city chat send --help`\n  - `city chat react --help`\n\n## 入站消息结构（仅供内部理解）\n\n- 每条入队用户消息包含 `<info>...</info>` 元信息块 + 用户正文。\n- `<info>` 仅保留 user/request 元信息，例如 `user_id`、`username`、`message_id`、`permissions`、`received_at`。\n- 当前 chat 路由环境（例如 `channel`、`session_id`、`chat_key`、`chat_id`）会通过 system prompt 单独注入，不再混在 `<info>` 里。\n- `<info>` 不要原样回传给用户。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/service/builtins/chat/accounts/ChannelAccountService.ts

@@ -8,8 +8,8 @@
  */
 
 import crypto from "node:crypto";
-import { PlatformStore } from "@/shared/utils/store/index.js";
-import type { StoredChannelAccountChannel } from "@/shared/types/Store.js";
+import type { AgentPlatformRuntime } from "@/host/types/AgentHost.js";
+import type { StoredChannelAccountChannel } from "@/host/types/Store.js";
 import { resolveChatChannelBotInfo } from "@/service/builtins/chat/channels/BotInfoProvider.js";
 import type {
   ChatChannelAccountCreateInput,
@@ -69,6 +69,12 @@ function pickFirstNonEmpty(inputs: unknown[]): string {
  * ChatChannelAccountService。
  */
 export class ChatChannelAccountService {
+  private readonly platform: AgentPlatformRuntime;
+
+  constructor(platform: AgentPlatformRuntime) {
+    this.platform = platform;
+  }
+
   /**
    * 生成唯一 channel account id。
    *
@@ -82,18 +88,13 @@ export class ChatChannelAccountService {
   }): Promise<string> {
     const seed = normalizeChannelAccountIdToken(params.seed || "");
     const prefix = `${params.channel}-${seed}`.slice(0, 36);
-    const store = new PlatformStore();
-    try {
-      for (let index = 0; index < 8; index += 1) {
-        const suffix = crypto.randomBytes(3).toString("hex");
-        const candidate = `${prefix}-${suffix}`.slice(0, 64);
-        const existing = await store.getChannelAccount(candidate);
-        if (!existing) return candidate;
-      }
-      return `${params.channel}-${Date.now().toString(36)}`;
-    } finally {
-      store.close();
+    for (let index = 0; index < 8; index += 1) {
+      const suffix = crypto.randomBytes(3).toString("hex");
+      const candidate = `${prefix}-${suffix}`.slice(0, 64);
+      const existing = this.platform.getChannelAccount(candidate);
+      if (!existing) return candidate;
     }
+    return `${params.channel}-${Date.now().toString(36)}`;
   }
 
   /**
@@ -205,32 +206,13 @@ export class ChatChannelAccountService {
    * 列出账户池（脱敏）。
    */
   async list(): Promise<ChatChannelAccountListResult> {
-    const store = new PlatformStore();
-    try {
-      const rows = await store.listChannelAccounts();
-      return {
-        items: rows.map((item) => ({
-          id: item.id,
-          channel: item.channel,
-          name: item.name,
-          identity: item.identity,
-          owner: item.owner,
-          creator: item.creator,
-          domain: item.domain,
-          sandbox: item.sandbox === true,
-          hasBotToken: !!String(item.botToken || "").trim(),
-          hasAppId: !!String(item.appId || "").trim(),
-          hasAppSecret: !!String(item.appSecret || "").trim(),
-          botTokenMasked: item.botToken ? maskSecret(item.botToken) : undefined,
-          appIdMasked: item.appId ? maskSecret(item.appId) : undefined,
-          appSecretMasked: item.appSecret ? maskSecret(item.appSecret) : undefined,
-          createdAt: item.createdAt,
-          updatedAt: item.updatedAt,
-        })),
-      };
-    } finally {
-      store.close();
+    const list = this.platform.listChannelAccounts;
+    if (!list) {
+      throw new Error("Channel account listing is not available in this runtime");
     }
+    return {
+      items: await list(),
+    };
   }
 
   /**
@@ -254,9 +236,7 @@ export class ChatChannelAccountService {
       throw new Error("appSecret and clearAppSecret cannot be used together");
     }
 
-    const store = new PlatformStore();
-    try {
-      const current = await store.getChannelAccount(id);
+    const current = this.platform.getChannelAccount(id);
       const nextBotToken = input.clearBotToken
         ? undefined
         : input.botToken !== undefined
@@ -282,36 +262,36 @@ export class ChatChannelAccountService {
         ? normalizeOptionalText(input.creator)
         : current?.creator;
 
-      await store.upsertChannelAccount({
-        id,
-        channel,
-        name,
-        identity: nextIdentity,
-        owner: nextOwner,
-        creator: nextCreator,
-        botToken: nextBotToken,
-        appId: nextAppId,
-        appSecret: nextAppSecret,
-        domain: normalizeOptionalText(input.domain),
-        sandbox: input.sandbox === true,
-      });
-      return { id };
-    } finally {
-      store.close();
+    const updateChannelAccount = this.platform.updateChannelAccount;
+    if (!updateChannelAccount) {
+      throw new Error("Channel account update is not available in this runtime");
     }
+    await updateChannelAccount({
+      id,
+      channel,
+      name,
+      identity: nextIdentity,
+      owner: nextOwner,
+      creator: nextCreator,
+      botToken: nextBotToken,
+      appId: nextAppId,
+      appSecret: nextAppSecret,
+      domain: normalizeOptionalText(input.domain),
+      sandbox: input.sandbox === true,
+    });
+    return { id };
   }
 
   /**
    * 删除账号。
    */
-  remove(idInput: string): void {
+  async remove(idInput: string): Promise<void> {
     const id = String(idInput || "").trim();
     if (!id) throw new Error("channel account id cannot be empty");
-    const store = new PlatformStore();
-    try {
-      store.removeChannelAccount(id);
-    } finally {
-      store.close();
+    const removeChannelAccount = this.platform.removeChannelAccount;
+    if (!removeChannelAccount) {
+      throw new Error("Channel account removal is not available in this runtime");
     }
+    await removeChannelAccount(id);
   }
 }

package/src/service/builtins/chat/channels/BaseChatChannel.ts

@@ -14,7 +14,7 @@ import type {
   ChatDispatchSendActionParams,
   ChatDispatcher,
 } from "@/service/builtins/chat/types/ChatDispatcher.js";
-import type { Logger } from "@shared/utils/logger/Logger.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import { resolveChatQueueStore } from "@/service/builtins/chat/runtime/ChatQueue.js";
 import { deleteChatSessionById } from "@/service/builtins/chat/runtime/ChatSessionDelete.js";

package/src/service/builtins/chat/channels/BaseChatChannelQueue.ts

@@ -16,7 +16,7 @@ import {
 } from "@/service/builtins/chat/runtime/EnqueueDispatch.js";
 import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type { IncomingChatMessage } from "./BaseChatChannel.js";
 import {
   appendInboundChannelHistory,

package/src/service/builtins/chat/channels/BaseChatChannelSupport.ts

@@ -7,9 +7,9 @@
  */
 
 import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
-import type { Logger } from "@shared/utils/logger/Logger.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 import {
   resolveSessionIdByChatTarget,
   resolveOrCreateSessionIdByChatTarget,

package/src/service/builtins/chat/channels/feishu/Feishu.ts

@@ -15,7 +15,7 @@ import type {
   ChannelSendTextParams,
 } from "@/service/builtins/chat/channels/BaseChatChannel.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type { ChatChannelTestResult } from "@/service/builtins/chat/types/ChannelStatus.js";
 import type { ParsedFeishuAttachmentCommand } from "@/service/builtins/chat/types/FeishuAttachment.js";
 import type { InboundReplyContext } from "@/service/builtins/chat/types/ReplyContext.js";
@@ -23,7 +23,7 @@ import type {
   FeishuConfig,
   FeishuMessageEvent,
   FeishuMessagePayloadType,
-} from "@/shared/types/FeishuChannel.js";
+} from "@/service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import { parseFeishuAttachments } from "./Shared.js";
 import { parseFeishuInboundMessage } from "./InboundAttachment.js";
 import {

package/src/service/builtins/chat/channels/feishu/FeishuInbound.ts

@@ -6,7 +6,7 @@
  * - 不依赖 Feishu SDK client，也不承担授权/入队/回复职责。
  */
 
-import type { FeishuMessageEvent, FeishuSenderIdentity } from "@/shared/types/FeishuChannel.js";
+import type { FeishuMessageEvent, FeishuSenderIdentity } from "@/service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 
 /**
  * 抽取发送者主身份。

package/src/service/builtins/chat/channels/feishu/FeishuPlatformClient.ts

@@ -14,7 +14,7 @@ import type {
   FeishuDownloadedAttachment,
   FeishuMessageEvent,
   FeishuMessagePayloadType,
-} from "@/shared/types/FeishuChannel.js";
+} from "@/service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import type { ChatChannelTestResult } from "@/service/builtins/chat/types/ChannelStatus.js";
 import type { ParsedFeishuAttachmentCommand } from "@/service/builtins/chat/types/FeishuAttachment.js";
 import type { FeishuIncomingAttachmentDescriptor } from "@/service/builtins/chat/types/FeishuInboundAttachment.js";

package/src/service/builtins/chat/channels/feishu/FeishuPlatformLookup.ts

@@ -9,10 +9,10 @@
 import * as Lark from "@larksuiteoapi/node-sdk";
 import fs from "fs-extra";
 import path from "path";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type {
   FeishuDownloadedAttachment,
-} from "@/shared/types/FeishuChannel.js";
+} from "@/service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import type { FeishuIncomingAttachmentDescriptor } from "@/service/builtins/chat/types/FeishuInboundAttachment.js";
 import type { InboundReplyContext } from "@/service/builtins/chat/types/ReplyContext.js";
 import { buildFeishuInboundCacheFileName } from "./InboundAttachment.js";

package/src/service/builtins/chat/channels/feishu/FeishuPlatformMessaging.ts

@@ -11,7 +11,7 @@ import fs from "fs-extra";
 import path from "path";
 import type {
   FeishuMessagePayloadType,
-} from "@/shared/types/FeishuChannel.js";
+} from "@/service/builtins/chat/channels/feishu/types/FeishuChannel.js";
 import type { ParsedFeishuAttachmentCommand } from "@/service/builtins/chat/types/FeishuAttachment.js";
 
 /**

package/src/service/builtins/chat/channels/feishu/PROMPT.direct.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/builtins/chat/channels/feishu/PROMPT.direct.ts.txt
+const TEXT_MODULE_CONTENT = "# Feishu Channel\n\n## 使用约束\n\n- 你的直接输出自动发送到当前飞书会话。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/service/builtins/chat/channels/qq/PROMPT.direct.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/service/builtins/chat/channels/qq/PROMPT.direct.ts.txt
+const TEXT_MODULE_CONTENT = "# QQ Adapter 使用说明（direct 模式）\n\n## 能力范围\n- 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。\n- 入站消息会由 chat service 映射到内部 `sessionId`（随机分配并持久化）。\n\n## 使用约束\n- 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。\n- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨会话发送请使用 `city chat send --chat-key ...`，不要在 direct metadata 中写 `chatKey`。\n- 群聊消息默认全量接入，不需要 `@` 触发。\n- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/service/builtins/chat/channels/qq/QQ.ts

@@ -33,10 +33,10 @@ import type {
   ChannelSendTextParams,
 } from "@/service/builtins/chat/channels/BaseChatChannel.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type { ChatChannelTestResult } from "@/service/builtins/chat/types/ChannelStatus.js";
-import type { QQConfig, QQMessageData } from "@/shared/types/QqChannel.js";
-import { EventType } from "@/shared/types/QqChannel.js";
+import type { QQConfig, QQMessageData } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
+import { EventType } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 
 /**
  * QQ 平台适配器。

package/src/service/builtins/chat/channels/qq/QQEventCapture.ts

@@ -8,8 +8,8 @@
 
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import type { Logger } from "@shared/utils/logger/Logger.js";
-import type { QQEventCaptureConfig, QQEventCaptureMode, QQGatewayPayload } from "@/shared/types/QqChannel.js";
+import type { Logger } from "@/utils/logger/Logger.js";
+import type { QQEventCaptureConfig, QQEventCaptureMode, QQGatewayPayload } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 
 /**
  * 读取 QQ 原始事件捕获配置。

package/src/service/builtins/chat/channels/qq/QQGatewayAuth.ts

@@ -6,9 +6,9 @@
  * - `QQGatewayClient` 只负责编排状态，不再直接内嵌所有 OpenAPI 请求细节。
  */
 
-import type { Logger } from "@shared/utils/logger/Logger.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import type { ChatChannelTestResult } from "@/service/builtins/chat/types/ChannelStatus.js";
-import type { QqGatewayRuntimeStatus } from "@/shared/types/QqChannel.js";
+import type { QqGatewayRuntimeStatus } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 
 /**
  * Access Token 获取结果。

package/src/service/builtins/chat/channels/qq/QQGatewayClient.ts

@@ -8,15 +8,15 @@
  */
 
 import WebSocket, { type RawData } from "ws";
-import type { Logger } from "@shared/utils/logger/Logger.js";
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { Logger } from "@/utils/logger/Logger.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type {
   QQEventCaptureConfig,
   QQGatewayPayload,
   QqDispatchHandler,
   QqGatewayRuntimeStatus,
-} from "@/shared/types/QqChannel.js";
-import { EventType, OpCode } from "@/shared/types/QqChannel.js";
+} from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
+import { EventType, OpCode } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 import { captureQqWsPayload } from "./QQEventCapture.js";
 import {
   fetchQqAccessToken,

package/src/service/builtins/chat/channels/qq/QQGatewaySend.ts

@@ -6,8 +6,8 @@
  * - `QQGatewayClient` 只保留发送入口与状态持有，不再直接展开长流程。
  */
 
-import type { Logger } from "@shared/utils/logger/Logger.js";
-import type { QQSendMessageBody } from "@/shared/types/QqChannel.js";
+import type { Logger } from "@/utils/logger/Logger.js";
+import type { QQSendMessageBody } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 import {
   isRetryableQqSendFailure,
   resolveQqApiErrorText,

package/src/service/builtins/chat/channels/qq/QQGatewaySupport.ts

@@ -7,12 +7,12 @@
  */
 
 import type { RawData } from "ws";
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
-import type { QQGatewayPayload, QqGatewayRuntimeStatus } from "@/shared/types/QqChannel.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
+import type { QQGatewayPayload, QqGatewayRuntimeStatus } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 import type {
   QqGatewayHeartbeatState,
   QqGatewayRuntimeStatusInput,
-} from "@/shared/types/QqGatewaySupport.js";
+} from "@/service/builtins/chat/channels/qq/types/QqGatewaySupport.js";
 
 /**
  * WebSocket OPEN 对应的 readyState 数值。

package/src/service/builtins/chat/channels/qq/QQInbound.ts

@@ -7,9 +7,9 @@
  * - 具体“授权、入队、执行、回发”仍由 QQBot 负责编排。
  */
 
-import type { JsonObject } from "@/shared/types/Json.js";
+import type { JsonObject } from "@/utils/types/Json.js";
 import type { QqIncomingAttachment } from "@/service/builtins/chat/types/QqVoice.js";
-import type { QqActorIdentity, QQAuthor, QQMessageData } from "@/shared/types/QqChannel.js";
+import type { QqActorIdentity, QQAuthor, QQMessageData } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 import { extractQqIncomingAttachments } from "./VoiceInput.js";
 
 /**

package/src/service/builtins/chat/channels/qq/QQInboundDedupe.ts

@@ -9,7 +9,7 @@
 
 import fs from "fs-extra";
 import path from "node:path";
-import type { Logger } from "@shared/utils/logger/Logger.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import type { QqInboundDedupeSnapshotV1 } from "@/service/builtins/chat/types/QqInboundDedupe.js";
 
 /**

package/src/service/builtins/chat/channels/qq/QQSendSupport.ts

@@ -6,7 +6,7 @@
  * - `QQGatewayClient` 只调用这些函数，不再内嵌大段重试细节。
  */
 
-import type { JsonObject, JsonValue } from "@/shared/types/Json.js";
+import type { JsonObject, JsonValue } from "@/utils/types/Json.js";
 
 /**
  * 解析 QQ API 业务错误文本。

package/src/service/builtins/chat/channels/qq/QQSupport.ts

@@ -8,8 +8,8 @@
 
 import { buildChatInboundText, augmentChatInboundInput } from "@/service/builtins/chat/runtime/InboundAugment.js";
 import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { JsonObject } from "@/shared/types/Json.js";
-import type { QQMessageData, QQReadyUser } from "@/shared/types/QqChannel.js";
+import type { JsonObject } from "@/utils/types/Json.js";
+import type { QQMessageData, QQReadyUser } from "@/service/builtins/chat/channels/qq/types/QqChannel.js";
 import type { QqIncomingAttachment } from "@/service/builtins/chat/types/QqVoice.js";
 import { resolveQqAttachmentLocalPath } from "./VoiceInput.js";
 

package/src/service/builtins/chat/channels/qq/VoiceInput.ts

@@ -5,7 +5,7 @@ import type {
   QqInboundAttachmentKind,
   QqRawInboundAttachment,
 } from "@/service/builtins/chat/types/QqVoice.js";
-import type { Logger } from "@shared/utils/logger/Logger.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 
 /**
  * QQ 入站附件候选字段（宽松结构）。