@downcity/plugins 1.0.57 → 1.0.59

package/bin/workboard/Plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAkGhF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,eAAe;;CAM7B"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,iDAAiD,CAAC;AAqBzD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACH,QAAQ,CAAC,IAAI,eAAe;IAE5B;;OAEG;IACH,QAAQ,CAAC,KAAK,wBAAwB;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,qJACgI;IAEpJ;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAY7B;IAEF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CA0BjC;CACH"}

package/bin/workboard/Plugin.js

@@ -2,102 +2,83 @@
  * Workboard Plugin。
  *
  * 关键点（中文）
- * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
- * - 当前同时通过 plugin action 与 HTTP 注入提供快照，供 Town RPC 与 Town HTTP gateway 复用。
+ * - workboard 是 runtime 观测面板插件，负责提供结构化工作快照。
+ * - plugin action 与 HTTP route 共享同一份快照读取逻辑。
+ * - 是否启用由是否注册该 plugin 决定，不再读取项目配置做二次开关。
  */
 import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import { isPluginEnabled } from "@downcity/agent/internal/plugin/core/Activation.js";
 import { getWorkboardSnapshotStore } from "../workboard/runtime/Store.js";
-function createWorkboardPluginDefinition(plugin) {
+/**
+ * 读取 workboard 快照。
+ */
+async function readWorkboardSnapshot(context) {
+    const snapshot = await getWorkboardSnapshotStore({
+        contextResolver: () => context,
+    }).readSnapshot();
     return {
-        name: "workboard",
-        title: "Workboard Snapshot",
-        description: "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.",
-        availability(context) {
-            if (!isPluginEnabled({ plugin, context })) {
+        success: true,
+        snapshot,
+    };
+}
+/**
+ * WorkboardPlugin：运行态观测面板插件。
+ */
+export class WorkboardPlugin extends BasePlugin {
+    /**
+     * 当前 plugin 稳定名称。
+     */
+    name = "workboard";
+    /**
+     * 插件标题。
+     */
+    title = "Workboard Snapshot";
+    /**
+     * 插件说明。
+     */
+    description = "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.";
+    /**
+     * Workboard 对外 action。
+     */
+    actions = {
+        snapshot: {
+            execute: async ({ context }) => {
+                const response = await readWorkboardSnapshot(context);
                 return {
-                    enabled: false,
-                    available: false,
-                    reasons: ["workboard plugin disabled in project config"],
+                    success: true,
+                    data: {
+                        snapshot: response.snapshot,
+                    },
                 };
-            }
-            return {
-                enabled: true,
-                available: true,
-                reasons: [],
-            };
-        },
-        actions: {
-            snapshot: {
-                execute: async ({ context }) => {
-                    const availability = await plugin.availability?.(context);
-                    if (availability && availability.available !== true) {
-                        return {
-                            success: false,
-                            error: availability.reasons.join("; ") || "workboard unavailable",
-                        };
-                    }
-                    const snapshot = await getWorkboardSnapshotStore({
-                        contextResolver: () => context,
-                    }).readSnapshot();
-                    return {
-                        success: true,
-                        data: {
-                            snapshot,
-                        },
-                    };
-                },
             },
         },
-        http: {
-            server: {
-                authPolicies: [
-                    {
-                        path: "/api/workboard/*",
-                        method: "GET",
-                        requireAuth: true,
-                        anyPermissions: ["agent.read"],
-                    },
-                ],
-                register({ app, getContext }) {
-                    app.get("/api/workboard/snapshot", async (c) => {
-                        try {
-                            const availability = await plugin.availability?.(getContext());
-                            if (availability && availability.available !== true) {
-                                return c.json({
-                                    success: false,
-                                    error: availability.reasons.join("; ") || "workboard unavailable",
-                                }, 503);
-                            }
-                            const snapshot = await getWorkboardSnapshotStore({
-                                contextResolver: getContext,
-                            }).readSnapshot();
-                            const payload = {
-                                success: true,
-                                snapshot,
-                            };
-                            return c.json(payload);
-                        }
-                        catch (error) {
-                            return c.json({
-                                success: false,
-                                error: error instanceof Error ? error.message : String(error),
-                            }, 500);
-                        }
-                    });
+    };
+    /**
+     * Workboard HTTP route。
+     */
+    http = {
+        server: {
+            authPolicies: [
+                {
+                    path: "/api/workboard/*",
+                    method: "GET",
+                    requireAuth: true,
+                    anyPermissions: ["agent.read"],
                 },
+            ],
+            register({ app, getContext }) {
+                app.get("/api/workboard/snapshot", async (c) => {
+                    try {
+                        return c.json(await readWorkboardSnapshot(getContext()));
+                    }
+                    catch (error) {
+                        return c.json({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }, 500);
+                    }
+                });
             },
         },
     };
 }
-/**
- * WorkboardPlugin：运行态观测面板插件。
- */
-export class WorkboardPlugin extends BasePlugin {
-    name = "workboard";
-    constructor() {
-        super();
-        Object.assign(this, createWorkboardPluginDefinition(this));
-    }
-}
 //# sourceMappingURL=Plugin.js.map

package/bin/workboard/Plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAOhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC;QAC/C,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO;KAC/B,CAAC,CAAC,YAAY,EAAE,CAAC;IAClB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACM,IAAI,GAAG,WAAW,CAAC;IAE5B;;OAEG;IACM,KAAK,GAAG,oBAAoB,CAAC;IAEtC;;OAEG;IACM,WAAW,GAClB,iJAAiJ,CAAC;IAEpJ;;OAEG;IACM,OAAO,GAAkB;QAChC,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBAC7B,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBACtD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBACJ;iBAC1B,CAAC;YACJ,CAAC;SACF;KACF,CAAC;IAEF;;OAEG;IACM,IAAI,GAAyB;QACpC,MAAM,EAAE;YACN,YAAY,EAAE;gBACZ;oBACE,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,CAAC,YAAY,CAAC;iBAC/B;aACF;YACD,QAAQ,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE;gBAC1B,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;oBAC7C,IAAI,CAAC;wBACH,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,qBAAqB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;oBAC3D,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,CAAC,IAAI,CACX;4BACE,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,EACD,GAAG,CACJ,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;CACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/plugins",
-  "version": "1.0.57",
+  "version": "1.0.59",
   "type": "module",
   "description": "Downcity 内建 plugin 集合包",
   "main": "./bin/index.js",

package/src/BuiltinPlugins.ts

@@ -8,7 +8,6 @@
  */
 
 import type { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import { ChatAuthorizationPlugin } from "@/auth/Plugin.js";
 import { SkillPlugin } from "@/skill/Plugin.js";
 import { WebPlugin } from "@/web/Plugin.js";
 import { WorkboardPlugin } from "@/workboard/Plugin.js";
@@ -27,7 +26,6 @@ export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new () => T;
  * 全部内建 plugin classes。
  */
 export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
-  ChatAuthorizationPlugin,
   SkillPlugin,
   WebPlugin,
   WorkboardPlugin,

package/src/auth/types/AuthPlugin.ts

@@ -1,20 +1,15 @@
 /**
- * ChatAuthorizationPlugin 类型与契约定义。
+ * ChatAuthorization 类型与契约定义。
  *
  * 关键点（中文）
- * - 统一维护聊天授权 plugin 的领域类型、扩展点/action 名称、payload 契约。
- * - 业务层不应散落硬编码字符串，如 `chat.authorizeIncoming`、`set-user-role`。
- * - chat / console / plugin 执行链路都从这里共享同一份边界定义。
+ * - 统一维护 ChatPlugin 内置授权能力的领域类型、扩展点/action 名称、payload 契约。
+ * - 业务层不应散落硬编码字符串，如 `chat.authorizeIncoming`、`authorization-set-user-role`。
+ * - chat / console / plugin action 执行链路都从这里共享同一份边界定义。
  */
 
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
 import { CHAT_PLUGIN_POINTS } from "@/chat/runtime/PluginPoints.js";
 
-/**
- * 聊天授权 plugin 稳定名称。
- */
-export const CHAT_AUTHORIZATION_PLUGIN_NAME = "chat-authorization";
-
 /**
  * 聊天授权支持的渠道目录。
  */
@@ -28,7 +23,7 @@ export type ChatAuthorizationChannel = (typeof CHAT_AUTHORIZATION_CHANNELS)[numb
 /**
  * 聊天授权扩展点名称集合。
  */
-export const CHAT_AUTHORIZATION_PLUGIN_POINTS = {
+export const CHAT_AUTHORIZATION_POINTS = {
   observePrincipal: CHAT_PLUGIN_POINTS.observePrincipal,
   authorizeIncoming: CHAT_PLUGIN_POINTS.authorizeIncoming,
   resolveUserRole: CHAT_PLUGIN_POINTS.resolveUserRole,
@@ -38,10 +33,10 @@ export const CHAT_AUTHORIZATION_PLUGIN_POINTS = {
  * 聊天授权 action 名称集合。
  */
 export const CHAT_AUTHORIZATION_ACTIONS = {
-  snapshot: "snapshot",
-  readConfig: "read-config",
-  writeConfig: "write-config",
-  setUserRole: "set-user-role",
+  snapshot: "authorization-snapshot",
+  readConfig: "authorization-read-config",
+  writeConfig: "authorization-write-config",
+  setUserRole: "authorization-set-user-role",
 } as const;
 
 /**
@@ -463,7 +458,7 @@ export interface ChatAuthorizationStateFile {
 }
 
 /**
- * plugin effect 输入：记录观测主体。
+ * ChatPlugin effect 输入：记录观测主体。
  */
 export interface ChatAuthorizationObservePrincipalPayload {
   /**
@@ -493,7 +488,7 @@ export interface ChatAuthorizationObservePrincipalPayload {
 }
 
 /**
- * plugin effect 输出：记录观测主体结果。
+ * ChatPlugin effect 输出：记录观测主体结果。
  */
 export interface ChatAuthorizationObservePrincipalResult {
   /**
@@ -503,7 +498,7 @@ export interface ChatAuthorizationObservePrincipalResult {
 }
 
 /**
- * plugin resolve 输入：查询用户角色。
+ * ChatPlugin resolve 输入：查询用户角色。
  */
 export interface ChatAuthorizationResolveUserRolePayload {
   /**

package/src/chat/ChatPlugin.ts

@@ -9,29 +9,47 @@
  */
 
 import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type {
+  PluginActions,
+  PluginHooks,
+  PluginResolves,
+} from "@downcity/agent/internal/plugin/types/Plugin.js";
 import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import type { StoredChannelAccount } from "@downcity/agent/internal/types/platform/Store.js";
 import type { ChatQueueWorkerConfig } from "@/chat/types/ChatQueueWorker.js";
 import type {
-  ChatPluginFeishuOptions,
+  ChatChannel,
   ChatPluginOptions,
-  ChatPluginQqOptions,
-  ChatPluginTelegramOptions,
-} from "@/chat/ChatPluginTypes.js";
+} from "@/chat/types/ChatPluginOptions.js";
 import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
+import {
+  FeishuChannel,
+  QqChannel,
+  TelegramChannel,
+} from "@/chat/channels/RuntimeChannel.js";
 import {
   createChatChannelState,
   startChatChannels,
   stopChatChannels,
 } from "./runtime/ChatChannelFacade.js";
-import { getStoredChannelAccountSync } from "./accounts/Store.js";
 import { createChatPluginActions } from "./runtime/ChatPluginActions.js";
+import {
+  createChatAuthorizationActions,
+  createChatAuthorizationHooks,
+  createChatAuthorizationResolves,
+} from "./runtime/ChatAuthorizationRuntime.js";
 import { ChatQueueWorker } from "./runtime/ChatQueueWorker.js";
 import { buildChatPluginSystem } from "./runtime/ChatPluginSystem.js";
 import { ChatQueueStore } from "./runtime/ChatQueueStore.js";
 
+function createDefaultChannels(): ChatChannel[] {
+  return [
+    new TelegramChannel({ enabled: false }),
+    new FeishuChannel({ enabled: false }),
+    new QqChannel({ enabled: false }),
+  ];
+}
+
 /**
  * Chat plugin 类实现。
  */
@@ -69,6 +87,11 @@ export class ChatPlugin extends BasePlugin {
    */
   public readonly options: ChatPluginOptions;
 
+  /**
+   * 当前实例持有的 chat channels。
+   */
+  public readonly channels: ChatChannel[];
+
   /**
    * 当前 plugin 的 system 文本构建器。
    */
@@ -81,6 +104,16 @@ export class ChatPlugin extends BasePlugin {
    */
   readonly actions: PluginActions;
 
+  /**
+   * 当前 plugin 的 hook 定义表。
+   */
+  readonly hooks: PluginHooks;
+
+  /**
+   * 当前 plugin 的 resolve 定义表。
+   */
+  readonly resolves: PluginResolves;
+
   /**
    * 启动当前实例的 queue worker。
    */
@@ -109,9 +142,17 @@ export class ChatPlugin extends BasePlugin {
   constructor(options?: ChatPluginOptions) {
     super();
     this.options = options || {};
-    this.actions = createChatPluginActions({
-      channelState: this.channelState,
-    });
+    this.channels = Array.isArray(this.options.channels)
+      ? [...this.options.channels]
+      : createDefaultChannels();
+    this.actions = {
+      ...createChatPluginActions({
+        channelState: this.channelState,
+      }),
+      ...createChatAuthorizationActions(),
+    };
+    this.hooks = createChatAuthorizationHooks();
+    this.resolves = createChatAuthorizationResolves();
     this.lifecycle = {
       start: async (context) => {
         this.startQueueWorker(context);
@@ -130,18 +171,15 @@ export class ChatPlugin extends BasePlugin {
   getQueueWorkerConfig(
     context: AgentContext,
   ): Partial<ChatQueueWorkerConfig> | undefined {
-    return this.options.queue || context.config.plugins?.chat?.queue;
+    void context;
+    return this.options.queue;
   }
 
   /**
    * 判断指定渠道是否启用。
    */
   isChannelEnabled(context: AgentContext, channel: ChatChannelName): boolean {
-    const explicit = this.getExplicitChannelOptions(channel);
-    if (explicit) {
-      return explicit.enabled !== false;
-    }
-    return context.config.plugins?.chat?.channels?.[channel]?.enabled === true;
+    return this.getChannel(channel)?.isEnabled(context) === true;
   }
 
   /**
@@ -151,13 +189,40 @@ export class ChatPlugin extends BasePlugin {
     context: AgentContext,
     channel: ChatChannelName,
   ): string {
-    const explicit = this.getExplicitChannelOptions(channel);
-    const explicitAccountId = String(explicit?.channelAccountId || "").trim();
-    if (explicitAccountId) return explicitAccountId;
-    const config = context.config.plugins?.chat?.channels?.[channel] as
-      | { channelAccountId?: unknown }
-      | undefined;
-    return String(config?.channelAccountId || "").trim();
+    return String(this.getChannel(channel)?.getChannelAccountId(context) || "").trim();
+  }
+
+  /**
+   * 更新当前实例的渠道运行态配置。
+   *
+   * 关键点（中文）
+   * - chat.open/close/configure 只修改当前 plugin 实例，不写 downcity.json。
+   * - 当前运行态只允许更新 `enabled` 与 `channelAccountId`，密钥仍来自 constructor 或账号池。
+   */
+  applyChannelRuntimePatch(params: {
+    /**
+     * 目标渠道。
+     */
+    channel: ChatChannelName;
+    /**
+     * 是否启用该渠道。
+     */
+    enabled?: boolean;
+    /**
+     * 绑定的账号池记录 ID；传入 null 表示清空绑定。
+     */
+    channelAccountId?: string | null;
+  }): void {
+    const channel = this.getChannel(params.channel);
+    if (!channel) {
+      throw new Error(`Chat channel is not registered: ${params.channel}`);
+    }
+    channel.applyRuntimePatch({
+      ...(typeof params.enabled === "boolean" ? { enabled: params.enabled } : {}),
+      ...(Object.prototype.hasOwnProperty.call(params, "channelAccountId")
+        ? { channelAccountId: params.channelAccountId ?? null }
+        : {}),
+    });
   }
 
   /**
@@ -166,73 +231,11 @@ export class ChatPlugin extends BasePlugin {
   resolveChannelAccount(
     context: AgentContext,
     channel: ChatChannelName,
-  ): StoredChannelAccount | null {
-    const explicit = this.buildExplicitChannelAccount(channel);
-    if (explicit) return explicit;
-    const channelAccountId = this.getChannelAccountId(context, channel);
-    if (!channelAccountId) return null;
-    return getStoredChannelAccountSync(channelAccountId);
+  ) {
+    return this.getChannel(channel)?.getAccount(context) || null;
   }
 
-  private getExplicitChannelOptions(
-    channel: ChatChannelName,
-  ): ChatPluginTelegramOptions | ChatPluginFeishuOptions | ChatPluginQqOptions | undefined {
-    if (channel === "telegram") return this.options.telegram;
-    if (channel === "feishu") return this.options.feishu;
-    return this.options.qq;
-  }
-
-  private buildExplicitChannelAccount(
-    channel: ChatChannelName,
-  ): StoredChannelAccount | null {
-    const now = new Date().toISOString();
-
-    if (channel === "telegram") {
-      const config = this.options.telegram;
-      const botToken = String(config?.botToken || "").trim();
-      if (!botToken) return null;
-      return {
-        id: String(config?.channelAccountId || `chat-sdk-${channel}`).trim(),
-        channel,
-        name: String(config?.name || "telegram").trim() || "telegram",
-        botToken,
-        createdAt: now,
-        updatedAt: now,
-      };
-    }
-
-    if (channel === "feishu") {
-      const config = this.options.feishu;
-      const appId = String(config?.appId || "").trim();
-      const appSecret = String(config?.appSecret || "").trim();
-      if (!appId || !appSecret) return null;
-      return {
-        id: String(config?.channelAccountId || `chat-sdk-${channel}`).trim(),
-        channel,
-        name: String(config?.name || "feishu").trim() || "feishu",
-        appId,
-        appSecret,
-        ...(String(config?.domain || "").trim()
-          ? { domain: String(config?.domain || "").trim() }
-          : {}),
-        createdAt: now,
-        updatedAt: now,
-      };
-    }
-
-    const config = this.options.qq;
-    const appId = String(config?.appId || "").trim();
-    const appSecret = String(config?.appSecret || "").trim();
-    if (!appId || !appSecret) return null;
-    return {
-      id: String(config?.channelAccountId || `chat-sdk-${channel}`).trim(),
-      channel,
-      name: String(config?.name || "qq").trim() || "qq",
-      appId,
-      appSecret,
-      ...(config?.sandbox === true ? { sandbox: true } : {}),
-      createdAt: now,
-      updatedAt: now,
-    };
+  private getChannel(channel: ChatChannelName): ChatChannel | null {
+    return this.channels.find((item) => item.name === channel) || null;
   }
 }

package/src/chat/Index.ts

@@ -2,7 +2,24 @@
  * Chat Plugin 导出入口。
  *
  * 关键点（中文）
- * - Index 只负责导出类实现。
+ * - Index 只负责导出类实现与 channel SDK 对象。
  * - 真正的类实现位于 `ChatPlugin.ts`。
  */
 export { ChatPlugin } from "./ChatPlugin.js";
+export {
+  FeishuChannel,
+  QqChannel,
+  TelegramChannel,
+} from "./channels/RuntimeChannel.js";
+export type {
+  BaseChatChannelOptions,
+  ChatChannelEnv,
+  FeishuChannelOptions,
+  QqChannelOptions,
+  TelegramChannelOptions,
+} from "./channels/RuntimeChannel.js";
+export type {
+  ChatChannel,
+  ChatChannelRuntimePatch,
+  ChatPluginOptions,
+} from "./types/ChatPluginOptions.js";

package/src/chat/channels/Configuration.ts

@@ -27,7 +27,7 @@ export abstract class ChatChannelConfiguration {
   abstract describe(): ChatChannelConfigurationDescriptor;
 
   /**
-   * 返回可通过 `chat.configure` 写入的 downcity.json 字段定义。
+   * 返回可通过 `chat.configure` 更新的运行态字段定义。
    */
   getWritableShipFields(): ChatChannelConfigurationField[] {
     return this.describe().fields.ship.filter((field) => field.writable);