@downcity/plugins 1.0.216 → 1.0.236

package/src/chat/runtime/ChatActionExecution.ts

@@ -9,8 +9,8 @@
 
 import path from "node:path";
 import type { JsonObject } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
-import type { PluginRunContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
+import type { PluginExecutionContext } from "@downcity/agent";
 import type {
   ChatDeleteActionPayload,
   ChatHistoryActionPayload,
@@ -45,21 +45,21 @@ import {
  * 执行 `chat.history_clear` action。
  */
 export async function execute_chat_history_clear_action(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatHistoryClearActionPayload;
 }) {
-  const session_id = String(params.payload.sessionId || "").trim();
+  const session_id = String(params.payload.session_id || "").trim();
   if (!session_id) {
     return {
       success: false,
-      error: "Missing sessionId",
+      error: "Missing session_id",
     };
   }
-  const cleared = await clear_chat_history(params.context.rootPath, session_id);
+  const cleared = await clear_chat_history(params.context.workspace_path, session_id);
   return {
     success: true,
     data: {
-      sessionId: session_id,
+      session_id: session_id,
       cleared,
     },
   };
@@ -76,15 +76,15 @@ function toChatHistoryView(events: ChatHistoryEventV1[]): JsonObject[] {
  * 执行 `chat.context` action。
  */
 export async function executeChatContextAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatSessionActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
-    run_context: params.run_context,
-    ...(params.payload.chatKey ? { chatKey: params.payload.chatKey } : {}),
-    ...(params.payload.sessionId ? { sessionId: params.payload.sessionId } : {}),
+    execution_context: params.execution_context,
+    ...(params.payload.chat_key ? { chat_key: params.payload.chat_key } : {}),
+    ...(params.payload.session_id ? { session_id: params.payload.session_id } : {}),
   });
   return {
     success: true,
@@ -98,7 +98,7 @@ export async function executeChatContextAction(params: {
  * 执行 `chat.list` action。
  */
 export async function executeChatListAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatListActionPayload;
 }) {
   const rawChannel = String(params.payload.channel || "").trim();
@@ -124,7 +124,7 @@ export async function executeChatListAction(params: {
     .filter((route) => {
       if (!qLower) return true;
       return (
-        matches(route.sessionId) ||
+        matches(route.session_id) ||
         matches(route.chatId) ||
         matches(route.chatTitle) ||
         matches(route.actorName) ||
@@ -135,8 +135,8 @@ export async function executeChatListAction(params: {
 
   const total = filtered.length;
   const chats: ChatListItemV1[] = filtered.slice(0, limit).map((route) => ({
-    chatKey: route.sessionId,
-    sessionId: route.sessionId,
+    chat_key: route.session_id,
+    session_id: route.session_id,
     channel: route.channel,
     chatId: route.chatId,
     ...(route.targetType ? { targetType: route.targetType } : {}),
@@ -144,15 +144,15 @@ export async function executeChatListAction(params: {
     ...(route.chatTitle ? { chatTitle: route.chatTitle } : {}),
     ...(route.actorName ? { actorName: route.actorName } : {}),
     ...(route.actorId ? { actorId: route.actorId } : {}),
-    updatedAt: route.updatedAt,
-    isoUpdatedAt: new Date(route.updatedAt).toISOString(),
+    updated_at: route.updated_at,
+    isoUpdatedAt: new Date(route.updated_at).toISOString(),
   }));
 
   return {
     success: true,
     data: {
-      metaUpdatedAt: meta.updatedAt,
-      metaIsoUpdatedAt: new Date(meta.updatedAt).toISOString(),
+      metaUpdatedAt: meta.updated_at,
+      metaIsoUpdatedAt: new Date(meta.updated_at).toISOString(),
       total,
       count: chats.length,
       chats,
@@ -164,55 +164,55 @@ export async function executeChatListAction(params: {
  * 执行 `chat.info` action。
  */
 export async function executeChatInfoAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatInfoActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
-  const explicitSessionId = String(params.payload.sessionId || "").trim();
-  const explicitChatKey = String(params.payload.chatKey || "").trim();
+  const explicitSessionId = String(params.payload.session_id || "").trim();
+  const explicitChatKey = String(params.payload.chat_key || "").trim();
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
-    run_context: params.run_context,
-    ...(explicitSessionId ? { sessionId: explicitSessionId } : {}),
-    ...(explicitChatKey ? { chatKey: explicitChatKey } : {}),
+    execution_context: params.execution_context,
+    ...(explicitSessionId ? { session_id: explicitSessionId } : {}),
+    ...(explicitChatKey ? { chat_key: explicitChatKey } : {}),
   });
 
-  const sessionId = String(explicitSessionId || snapshot.sessionId || "").trim();
-  const chatKey = String(explicitChatKey || snapshot.chatKey || sessionId || "").trim();
-  if (!sessionId) {
+  const session_id = String(explicitSessionId || snapshot.session_id || "").trim();
+  const chat_key = String(explicitChatKey || snapshot.chat_key || session_id || "").trim();
+  if (!session_id) {
     return {
       success: false,
       error:
-        "Missing sessionId. Provide --session-id/--chat-key or ensure DC_SESSION_ID/DC_CTX_CHAT_KEY is injected.",
+        "Missing session_id. Provide --session-id/--chat-key or ensure DC_SESSION_ID/DC_CTX_CHAT_KEY is injected.",
     };
   }
 
   const route = await readChatMetaBySessionId({
     context: params.context,
-    sessionId,
+    session_id,
   });
 
   const toPosixRelativePath = (absPath: string): string =>
-    path.relative(params.context.rootPath, absPath).split(path.sep).join("/");
+    path.relative(params.context.workspace_path, absPath).split(path.sep).join("/");
 
   const channelMetaPath = toPosixRelativePath(
-    get_chat_channel_meta_path(params.context.rootPath),
+    get_chat_channel_meta_path(params.context.workspace_path),
   );
   const chatDirPath = toPosixRelativePath(
-    get_chat_session_dir_path(params.context.rootPath, sessionId),
+    get_chat_session_dir_path(params.context.workspace_path, session_id),
   );
   const historyPath = toPosixRelativePath(
-    get_chat_history_path(params.context.rootPath, sessionId),
+    get_chat_history_path(params.context.workspace_path, session_id),
   );
 
   return {
     success: true,
     data: {
-      sessionId,
-      chatKey,
+      session_id,
+      chat_key,
       context: snapshot,
       route,
-      ...(route ? { routeIsoUpdatedAt: new Date(route.updatedAt).toISOString() } : {}),
+      ...(route ? { routeIsoUpdatedAt: new Date(route.updated_at).toISOString() } : {}),
       paths: {
         channelMetaPath,
         chatDirPath,
@@ -226,40 +226,40 @@ export async function executeChatInfoAction(params: {
  * 执行 `chat.history` action。
  */
 export async function executeChatHistoryAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatHistoryActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
   const payload = params.payload;
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
-    run_context: params.run_context,
-    ...(payload.chatKey ? { chatKey: payload.chatKey } : {}),
-    ...(payload.sessionId ? { sessionId: payload.sessionId } : {}),
+    execution_context: params.execution_context,
+    ...(payload.chat_key ? { chat_key: payload.chat_key } : {}),
+    ...(payload.session_id ? { session_id: payload.session_id } : {}),
   });
-  const explicitSessionId = String(payload.sessionId || "").trim();
-  const explicitChatKey = String(payload.chatKey || "").trim();
-  const sessionId = String(
-    explicitSessionId || explicitChatKey || snapshot.sessionId || "",
+  const explicitSessionId = String(payload.session_id || "").trim();
+  const explicitChatKey = String(payload.chat_key || "").trim();
+  const session_id = String(
+    explicitSessionId || explicitChatKey || snapshot.session_id || "",
   ).trim();
-  if (!sessionId) {
+  if (!session_id) {
     return {
       success: false,
       error:
-        "Missing sessionId. Provide --session-id/--chat-key or ensure DC_SESSION_ID is injected.",
+        "Missing session_id. Provide --session-id/--chat-key or ensure DC_SESSION_ID is injected.",
     };
   }
 
   const historyResult = await readChatHistory({
     context: params.context,
-    sessionId,
+    session_id,
     limit: payload.limit,
     direction: payload.direction || "all",
     beforeTs: payload.beforeTs,
     afterTs: payload.afterTs,
   });
   const historyPath = historyResult.historyPath
-    .replace(`${params.context.rootPath}/`, "")
+    .replace(`${params.context.workspace_path}/`, "")
     .split("\\")
     .join("/");
 
@@ -278,39 +278,39 @@ export async function executeChatHistoryAction(params: {
  * 执行 `chat.send` action。
  */
 export async function executeChatSendAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatSendActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
-  const chatKey = resolveChatKey({
-    chatKey: params.payload.chatKey,
+  const chat_key = resolveChatKey({
+    chat_key: params.payload.chat_key,
     context: params.context,
-    run_context: params.run_context,
+    execution_context: params.execution_context,
   });
-  if (!chatKey) {
+  if (!chat_key) {
     return {
       success: false,
-      error: "Missing chatKey",
+      error: "Missing chat_key",
     };
   }
 
   const shouldScheduleInBackground =
-    typeof params.payload.delayMs === "number" ||
-    typeof params.payload.sendAtMs === "number";
+    typeof params.payload.delay_ms === "number" ||
+    typeof params.payload.send_at_ms === "number";
   const result = await sendChatTextByChatKey({
     context: params.context,
-    chatKey,
+    chat_key,
     text: String(params.payload.text || ""),
-    delayMs: params.payload.delayMs,
-    sendAtMs: params.payload.sendAtMs,
+    delay_ms: params.payload.delay_ms,
+    send_at_ms: params.payload.send_at_ms,
     // 关键点（中文）：plugin runtime action 面向 CLI/API，定时或延迟发送应立即返回，
     // 由 runtime 在后台内存中继续等待并到点投递，避免 HTTP 请求长时间挂起。
     ...(shouldScheduleInBackground ? { nonBlockingDelay: true } : {}),
-    replyToMessage: params.payload.replyToMessage === true,
-    ...(typeof params.payload.messageId === "string" && params.payload.messageId.trim()
-      ? { messageId: params.payload.messageId.trim() }
+    reply_to_message: params.payload.reply_to_message === true,
+    ...(typeof params.payload.message_id === "string" && params.payload.message_id.trim()
+      ? { message_id: params.payload.message_id.trim() }
       : {}),
-    run_context: params.run_context,
+    execution_context: params.execution_context,
   });
   if (!result.success) {
     return {
@@ -321,7 +321,7 @@ export async function executeChatSendAction(params: {
   return {
     success: true,
     data: {
-      chatKey: result.chatKey || chatKey,
+      chat_key: result.chat_key || chat_key,
     },
   };
 }
@@ -330,28 +330,28 @@ export async function executeChatSendAction(params: {
  * 执行 `chat.react` action。
  */
 export async function executeChatReactAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatReactActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
-  const chatKey = resolveChatKey({
-    chatKey: params.payload.chatKey,
+  const chat_key = resolveChatKey({
+    chat_key: params.payload.chat_key,
     context: params.context,
-    run_context: params.run_context,
+    execution_context: params.execution_context,
   });
-  if (!chatKey) {
+  if (!chat_key) {
     return {
       success: false,
-      error: "Missing chatKey",
+      error: "Missing chat_key",
     };
   }
 
-  const messageId = String(params.payload.messageId || "").trim() || undefined;
+  const message_id = String(params.payload.message_id || "").trim() || undefined;
   const result = await sendChatActionByChatKey({
     context: params.context,
-    chatKey,
+    chat_key,
     action: "react",
-    messageId,
+    message_id,
     reactionEmoji: params.payload.emoji,
     reactionIsBig: params.payload.big === true,
   });
@@ -364,8 +364,8 @@ export async function executeChatReactAction(params: {
   return {
     success: true,
     data: {
-      chatKey: result.chatKey || chatKey,
-      ...(messageId ? { messageId } : {}),
+      chat_key: result.chat_key || chat_key,
+      ...(message_id ? { message_id } : {}),
       ...(typeof params.payload.emoji === "string" && params.payload.emoji.trim()
         ? { emoji: params.payload.emoji.trim() }
         : {}),
@@ -378,15 +378,15 @@ export async function executeChatReactAction(params: {
  * 执行 `chat.delete` action。
  */
 export async function executeChatDeleteAction(params: {
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatDeleteActionPayload;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }) {
   const result = await deleteChatByChatKey({
     context: params.context,
-    run_context: params.run_context,
-    ...(params.payload.chatKey ? { chatKey: params.payload.chatKey } : {}),
-    ...(params.payload.sessionId ? { sessionId: params.payload.sessionId } : {}),
+    execution_context: params.execution_context,
+    ...(params.payload.chat_key ? { chat_key: params.payload.chat_key } : {}),
+    ...(params.payload.session_id ? { session_id: params.payload.session_id } : {}),
   });
   if (!result.success) {
     return {
@@ -397,7 +397,7 @@ export async function executeChatDeleteAction(params: {
   return {
     success: true,
     data: {
-      sessionId: result.sessionId || null,
+      session_id: result.session_id || null,
       deleted: result.deleted === true,
       removedMeta: result.removedMeta === true,
       removedChatDir: result.removedChatDir === true,

package/src/chat/runtime/ChatActionInput.ts

@@ -56,19 +56,19 @@ export function mapChatListCommandInput(
 export function mapChatInfoCommandInput(
   input: PluginActionCommandInput,
 ): ChatInfoActionPayload {
-  const chatKey = getStringOpt(input.opts, "chatKey");
-  const sessionId = getStringOpt(input.opts, "sessionId");
+  const chat_key = getStringOpt(input.opts, "chat_key");
+  const session_id = getStringOpt(input.opts, "session_id");
   return {
-    ...(chatKey ? { chatKey } : {}),
-    ...(sessionId ? { sessionId } : {}),
+    ...(chat_key ? { chat_key } : {}),
+    ...(session_id ? { session_id } : {}),
   };
 }
 
 export function mapChatHistoryCommandInput(
   input: PluginActionCommandInput,
 ): ChatHistoryActionPayload {
-  const chatKey = getStringOpt(input.opts, "chatKey");
-  const sessionId = getStringOpt(input.opts, "sessionId");
+  const chat_key = getStringOpt(input.opts, "chat_key");
+  const session_id = getStringOpt(input.opts, "session_id");
   const direction = readHistoryDirectionOrThrow(
     getStringOpt(input.opts, "direction"),
   );
@@ -92,8 +92,8 @@ export function mapChatHistoryCommandInput(
   }
 
   return {
-    ...(chatKey ? { chatKey } : {}),
-    ...(sessionId ? { sessionId } : {}),
+    ...(chat_key ? { chat_key } : {}),
+    ...(session_id ? { session_id } : {}),
     ...(typeof limit === "number" ? { limit } : {}),
     ...(direction ? { direction } : {}),
     ...(typeof beforeTs === "number" ? { beforeTs } : {}),
@@ -104,22 +104,22 @@ export function mapChatHistoryCommandInput(
 export function mapChatReactCommandInput(
   input: PluginActionCommandInput,
 ): ChatReactActionPayload {
-  const chatKey = resolveChatKey({
-    chatKey: getStringOpt(input.opts, "chatKey"),
+  const chat_key = resolveChatKey({
+    chat_key: getStringOpt(input.opts, "chat_key"),
   });
-  if (!chatKey) {
+  if (!chat_key) {
     throw new Error(
-      "Missing chatKey. Provide --chat-key or ensure DC_CTX_CHAT_KEY is injected in current shell context.",
+      "Missing chat_key. Provide --chat-key or ensure DC_CTX_CHAT_KEY is injected in current shell context.",
     );
   }
 
   const emoji = getStringOpt(input.opts, "emoji");
-  const messageId = getStringOpt(input.opts, "messageId");
+  const message_id = getStringOpt(input.opts, "message_id");
   const big = getBooleanOpt(input.opts, "big");
   return {
-    chatKey,
+    chat_key,
     ...(emoji ? { emoji } : {}),
-    ...(messageId ? { messageId } : {}),
+    ...(message_id ? { message_id } : {}),
     ...(big ? { big: true } : {}),
   };
 }
@@ -127,10 +127,10 @@ export function mapChatReactCommandInput(
 export function mapChatDeleteCommandInput(
   input: PluginActionCommandInput,
 ): ChatDeleteActionPayload {
-  const chatKey = getStringOpt(input.opts, "chatKey");
-  const sessionId = getStringOpt(input.opts, "sessionId");
+  const chat_key = getStringOpt(input.opts, "chat_key");
+  const session_id = getStringOpt(input.opts, "session_id");
   return {
-    ...(chatKey ? { chatKey } : {}),
-    ...(sessionId ? { sessionId } : {}),
+    ...(chat_key ? { chat_key } : {}),
+    ...(session_id ? { session_id } : {}),
   };
 }

package/src/chat/runtime/ChatChannelActions.ts

@@ -7,7 +7,7 @@
  * - 对外只暴露 action 级入口，供 ChatPluginActions 装配使用。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
 import type {
   ChatReconnectActionPayload,
@@ -30,7 +30,7 @@ import {
  */
 export async function executeChatStatusAction(params: {
   state: ChatChannelState;
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatStatusActionPayload;
 }) {
   const channels = resolveTargetChannels(params.payload.channel);
@@ -50,7 +50,7 @@ export async function executeChatStatusAction(params: {
  */
 export async function executeChatTestAction(params: {
   state: ChatChannelState;
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatTestActionPayload;
 }) {
   const channels = resolveTargetChannels(params.payload.channel);
@@ -104,7 +104,7 @@ export async function executeChatTestAction(params: {
  */
 export async function executeChatReconnectAction(params: {
   state: ChatChannelState;
-  context: AgentContext;
+  context: PluginContext;
   payload: ChatReconnectActionPayload;
 }) {
   const targets = resolveTargetChannels(params.payload.channel);

package/src/chat/runtime/ChatChannelConfig.ts

@@ -7,14 +7,14 @@
  */
 
 import type { JsonObject } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
-import type { StoredChannelAccount } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
+import type { ChatRuntimeAccount } from "@/chat/types/ChatRuntimeAccount.js";
 import type {
   ChatChannelName,
   ChatChannelStateSnapshot,
 } from "@/chat/types/ChannelStatus.js";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import { getChatChannelConfiguration } from "@/chat/channels/ConfigurationRegistry.js";
+import { get_chat_plugin_resource_json_schema } from "@/chat/config/ChatPluginConfig.js";
 import {
   getChatChannelBot,
   isChatChannelEnabled,
@@ -35,31 +35,31 @@ function toJsonObject(input: unknown): JsonObject {
  * - 字段命名与 Agent 全局配置保持一致，便于前端直接映射编辑。
  */
 export function buildChatChannelConfigSummary(
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatChannelName,
-  accountInput?: StoredChannelAccount | null,
+  accountInput?: ChatRuntimeAccount | null,
 ): Record<string, string | number | boolean | null> {
   const account = accountInput ?? resolveChannelAccount(context, channel);
-  const channelAccountId = resolveChannelAccountId(context, channel);
+  const resource_id = resolveChannelAccountId(context, channel);
   const configured = isChannelAccountConfigured(channel, account);
   if (channel === "telegram") {
     return {
       enabled: isChatChannelEnabled(context, channel),
-      channelAccountId: channelAccountId || null,
-      channelAccountConfigured: configured,
+      resource_id: resource_id || null,
+      resource_configured: configured,
     };
   }
   if (channel === "feishu") {
     return {
       enabled: isChatChannelEnabled(context, channel),
-      channelAccountId: channelAccountId || null,
-      channelAccountConfigured: configured,
+      resource_id: resource_id || null,
+      resource_configured: configured,
     };
   }
   return {
     enabled: isChatChannelEnabled(context, channel),
-    channelAccountId: channelAccountId || null,
-    channelAccountConfigured: configured,
+    resource_id: resource_id || null,
+    resource_configured: configured,
   };
 }
 
@@ -68,7 +68,7 @@ export function buildChatChannelConfigSummary(
  */
 export function getChatChannelStatus(
   state: ChatChannelState,
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatChannelName,
 ): ChatChannelStateSnapshot {
   const enabled = isChatChannelEnabled(context, channel);
@@ -97,7 +97,7 @@ export function getChatChannelStatus(
     detail: {
       ...(runtime?.detail || {}),
       config: buildChatChannelConfigSummary(context, channel, channelAccount),
-      configuration: toJsonObject(getChatChannelConfiguration(channel).describe()),
+      resource_schema: toJsonObject(get_chat_plugin_resource_json_schema(channel)),
     },
   };
 }

package/src/chat/runtime/ChatChannelCore.ts

@@ -7,25 +7,24 @@
  * - 目标是让 chat platform 子模块共享同一套最小公共基元。
  */
 
-import type { AgentContext } from "@downcity/agent";
-import type { StoredChannelAccount } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
+import type { ChatRuntimeAccount } from "@/chat/types/ChatRuntimeAccount.js";
 import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import { getStoredChannelAccountSync } from "@/chat/accounts/Store.js";
 
 const CHAT_CHANNEL_NAMES: ChatChannelName[] = ["telegram", "feishu", "qq"];
 
 export type ChatRuntimeBindings = {
-  getChannelAccountId?(context: AgentContext, channel: ChatChannelName): string;
+  getResourceId?(context: PluginContext, channel: ChatChannelName): string;
   resolveChannelAccount?(
-    context: AgentContext,
+    context: PluginContext,
     channel: ChatChannelName,
-  ): StoredChannelAccount | null;
-  isChannelEnabled?(context: AgentContext, channel: ChatChannelName): boolean;
+  ): ChatRuntimeAccount | null;
+  isChannelEnabled?(context: PluginContext, channel: ChatChannelName): boolean;
 };
 
 export function resolveChatPluginBindings(
-  context: AgentContext,
+  context: PluginContext,
 ): ChatRuntimeBindings | null {
   const candidate = context.plugins.get("chat") as
     | ChatRuntimeBindings
@@ -72,11 +71,11 @@ export function resolveTargetChannels(channel?: ChatChannelName): ChatChannelNam
  * 读取渠道绑定的 bot account id。
  */
 export function resolveChannelAccountId(
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatChannelName,
 ): string {
   const plugin = resolveChatPluginBindings(context);
-  const explicit = String(plugin?.getChannelAccountId?.(context, channel) || "").trim();
+  const explicit = String(plugin?.getResourceId?.(context, channel) || "").trim();
   if (explicit) return explicit;
   return "";
 }
@@ -85,24 +84,16 @@ export function resolveChannelAccountId(
  * 解析渠道 account。
  *
  * 关键点（中文）
- * - 优先使用 ChatPlugin 实例上的显式解析逻辑。
- * - 若实例只提供 channelAccountId，再从默认全局账号池读取对应账号。
+ * - 账号只通过 ChatPlugin 实例解析，Plugin Core 不访问宿主全局路径或数据库。
  * - 不从项目文件隐式推断运行时账号。
  */
 export function resolveChannelAccount(
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatChannelName,
-): StoredChannelAccount | null {
+): ChatRuntimeAccount | null {
   const plugin = resolveChatPluginBindings(context);
   const explicit = plugin?.resolveChannelAccount?.(context, channel);
-  if (explicit) return explicit;
-  const channelAccountId = resolveChannelAccountId(context, channel);
-  const account = channelAccountId
-    ? getStoredChannelAccountSync(channelAccountId)
-    : null;
-  if (!account) return null;
-  if (account.channel !== channel) return null;
-  return account;
+  return explicit?.channel === channel ? explicit : null;
 }
 
 /**
@@ -110,20 +101,20 @@ export function resolveChannelAccount(
  */
 export function isChannelAccountConfigured(
   channel: ChatChannelName,
-  account: StoredChannelAccount | null,
+  account: ChatRuntimeAccount | null,
 ): boolean {
   if (!account) return false;
   if (channel === "telegram") {
-    return !!String(account.botToken || "").trim();
+    return !!String(account.bot_token || "").trim();
   }
-  return !!String(account.appId || "").trim() && !!String(account.appSecret || "").trim();
+  return !!String(account.app_id || "").trim() && !!String(account.app_secret || "").trim();
 }
 
 /**
  * 判断指定渠道当前是否启用。
  */
 export function isChatChannelEnabled(
-  context: AgentContext,
+  context: PluginContext,
   channel: ChatChannelName,
 ): boolean {
   const plugin = resolveChatPluginBindings(context);