@downcity/agent 1.1.174 → 1.1.178

package/bin/config/Defaults.d.ts

@@ -1,21 +0,0 @@
-/**
- * Agent 项目默认配置模板模块。
- *
- * 职责说明（中文）
- * - 集中声明初始化新项目时写入的默认 `downcity.json` 结构。
- * - 为创建流程提供一份稳定、最小可运行的默认配置基线。
- *
- * 边界说明（中文）
- * - 这里的默认值只服务“新项目生成”，不参与运行时多层配置合并。
- * - 业务运行过程中若要读取最终配置，应始终走 `Config.ts` 的装配逻辑。
- */
-import type { DowncityConfig } from "../types/config/DowncityConfig.js";
-/**
- * 默认 `downcity.json` 配置。
- *
- * 关键点（中文）
- * - 这是一份“初始化模板”，不是运行时的最终真相来源。
- * - 调用方若只想取某个字段的默认值，也应意识到它可能被用户项目配置覆盖。
- */
-export declare const DEFAULT_DOWNCITY_JSON: DowncityConfig;
-//# sourceMappingURL=Defaults.d.ts.map

package/bin/config/Defaults.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Defaults.d.ts","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,cA2BnC,CAAC"}

package/bin/config/Defaults.js

@@ -1,47 +0,0 @@
-/**
- * Agent 项目默认配置模板模块。
- *
- * 职责说明（中文）
- * - 集中声明初始化新项目时写入的默认 `downcity.json` 结构。
- * - 为创建流程提供一份稳定、最小可运行的默认配置基线。
- *
- * 边界说明（中文）
- * - 这里的默认值只服务“新项目生成”，不参与运行时多层配置合并。
- * - 业务运行过程中若要读取最终配置，应始终走 `Config.ts` 的装配逻辑。
- */
-/**
- * 默认 `downcity.json` 配置。
- *
- * 关键点（中文）
- * - 这是一份“初始化模板”，不是运行时的最终真相来源。
- * - 调用方若只想取某个字段的默认值，也应意识到它可能被用户项目配置覆盖。
- */
-export const DEFAULT_DOWNCITY_JSON = {
-    $schema: "./.downcity/schema/downcity.schema.json",
-    id: "downcity",
-    version: "1.0.0",
-    start: {
-        port: 5314,
-        host: "0.0.0.0",
-    },
-    execution: {
-        type: "api",
-        modelId: "default",
-    },
-    plugins: {
-        chat: {
-            queue: {
-                maxConcurrency: 2,
-                mergeDebounceMs: 600,
-                mergeMaxWaitMs: 2000,
-            },
-            channels: {
-                telegram: {
-                    enabled: false,
-                    channelAccountId: undefined,
-                },
-            },
-        },
-    },
-};
-//# sourceMappingURL=Defaults.js.map

package/bin/config/Defaults.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Defaults.js","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,OAAO,EAAE,yCAAyC;IAClD,EAAE,EAAE,UAAU;IACd,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;KAChB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,SAAS;KACnB;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,GAAG;gBACpB,cAAc,EAAE,IAAI;aACrB;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK;oBACd,gBAAgB,EAAE,SAAS;iBAC5B;aACF;SACF;KACF;CACF,CAAC"}

package/bin/plugin/core/ProjectConfigStore.d.ts

@@ -1,84 +0,0 @@
-/**
- * Plugin 项目配置持久化工具。
- *
- * 关键点（中文）
- * - 新插件体系的用户配置统一写回项目 `downcity.json`。
- * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
- * - 这样既能保证重启后配置仍然生效，也能避免把平台全局配置误写进项目文件。
- */
-import type { DowncityConfig } from "../../types/config/DowncityConfig.js";
-import type { AgentPluginConfigRuntime } from "../../types/agent/AgentRuntimeAssembly.js";
-type PersistableSections = {
-    /**
-     * 插件配置块（可选）。
-     */
-    plugins?: DowncityConfig["plugins"];
-};
-type ProjectPluginConfigCarrier = {
-    /**
-     * 当前项目配置对象。
-     */
-    config: DowncityConfig;
-    /**
-     * plugin 配置持久化能力。
-     */
-    pluginConfig: AgentPluginConfigRuntime;
-};
-/**
- * 从项目配置读取单个 plugin 的原始配置块。
- */
-export declare function readProjectPluginRecord(config: Pick<DowncityConfig, "plugins"> | null | undefined, pluginName: string): Record<string, unknown>;
-/**
- * 从项目配置读取单个 plugin 的启用态。
- *
- * 关键点（中文）
- * - 未显式配置 `enabled: false` 时默认视为启用。
- * - Agent 不按插件名维护“必需插件”例外，避免 Runtime 理解具体业务插件。
- * - 这样可以保持“零配置即可使用”的内建 plugin 体验。
- */
-export declare function readProjectPluginEnabled(params: {
-    /**
-     * 项目配置对象（可选）。
-     */
-    config?: Pick<DowncityConfig, "plugins"> | null;
-    /**
-     * plugin 名称。
-     */
-    pluginName: string;
-}): boolean;
-/**
- * 将单个 plugin 的启用态写回项目配置。
- *
- * 关键点（中文）
- * - 这里只维护 `plugins.<name>.enabled`，不理解插件私有字段语义。
- * - 其余配置字段会原样保留，避免开关动作覆盖插件已有设置。
- */
-export declare function writeProjectPluginEnabled(params: {
-    /**
-     * 目标 plugin 名称。
-     */
-    pluginName: string;
-    /**
-     * 目标启用态。
-     */
-    enabled: boolean;
-    /**
-     * 当前项目配置与持久化能力。
-     */
-    context: ProjectPluginConfigCarrier;
-}): Promise<void>;
-/**
- * 将 plugins 配置块写回项目 `downcity.json`。
- */
-export declare function persistProjectPluginConfig(params: {
-    /**
-     * 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 待持久化的配置块。
-     */
-    sections: PersistableSections;
-}): Promise<string>;
-export {};
-//# sourceMappingURL=ProjectConfigStore.d.ts.map

package/bin/plugin/core/ProjectConfigStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectConfigStore.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/ProjectConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEtF,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC;CACxC,CAAC;AA6BF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1D,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAChD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAKV;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,0BAA0B,CAAC;CACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,mBAAmB,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlB"}

package/bin/plugin/core/ProjectConfigStore.js

@@ -1,89 +0,0 @@
-/**
- * Plugin 项目配置持久化工具。
- *
- * 关键点（中文）
- * - 新插件体系的用户配置统一写回项目 `downcity.json`。
- * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
- * - 这样既能保证重启后配置仍然生效，也能避免把平台全局配置误写进项目文件。
- */
-import fs from "node:fs/promises";
-import path from "node:path";
-function getProjectDowncityJsonPath(projectRoot) {
-    return path.join(path.resolve(projectRoot), "downcity.json");
-}
-async function readProjectDowncityConfig(projectRoot) {
-    const downcityJsonPath = getProjectDowncityJsonPath(projectRoot);
-    const raw = await fs.readFile(downcityJsonPath, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error(`Invalid downcity.json: expected object (${downcityJsonPath})`);
-    }
-    return parsed;
-}
-function readProjectPluginRecordFromConfig(config, pluginName) {
-    const normalizedPluginName = String(pluginName || "").trim();
-    if (!normalizedPluginName)
-        return {};
-    const current = config?.plugins?.[normalizedPluginName];
-    if (!current || typeof current !== "object" || Array.isArray(current)) {
-        return {};
-    }
-    return current;
-}
-/**
- * 从项目配置读取单个 plugin 的原始配置块。
- */
-export function readProjectPluginRecord(config, pluginName) {
-    return readProjectPluginRecordFromConfig(config, pluginName);
-}
-/**
- * 从项目配置读取单个 plugin 的启用态。
- *
- * 关键点（中文）
- * - 未显式配置 `enabled: false` 时默认视为启用。
- * - Agent 不按插件名维护“必需插件”例外，避免 Runtime 理解具体业务插件。
- * - 这样可以保持“零配置即可使用”的内建 plugin 体验。
- */
-export function readProjectPluginEnabled(params) {
-    const normalizedPluginName = String(params.pluginName || "").trim();
-    if (!normalizedPluginName)
-        return false;
-    const current = readProjectPluginRecordFromConfig(params.config, normalizedPluginName);
-    return current.enabled !== false;
-}
-/**
- * 将单个 plugin 的启用态写回项目配置。
- *
- * 关键点（中文）
- * - 这里只维护 `plugins.<name>.enabled`，不理解插件私有字段语义。
- * - 其余配置字段会原样保留，避免开关动作覆盖插件已有设置。
- */
-export async function writeProjectPluginEnabled(params) {
-    const normalizedPluginName = String(params.pluginName || "").trim();
-    if (!normalizedPluginName)
-        return;
-    if (!params.context.config.plugins) {
-        params.context.config.plugins = {};
-    }
-    params.context.config.plugins[normalizedPluginName] = {
-        ...readProjectPluginRecordFromConfig(params.context.config, normalizedPluginName),
-        enabled: params.enabled,
-    };
-    await params.context.pluginConfig.persistProjectPlugins(params.context.config.plugins);
-}
-/**
- * 将 plugins 配置块写回项目 `downcity.json`。
- */
-export async function persistProjectPluginConfig(params) {
-    const downcityJsonPath = getProjectDowncityJsonPath(params.projectRoot);
-    const current = await readProjectDowncityConfig(params.projectRoot);
-    const next = {
-        ...current,
-        ...(params.sections.plugins !== undefined
-            ? { plugins: params.sections.plugins }
-            : {}),
-    };
-    await fs.writeFile(downcityJsonPath, `${JSON.stringify(next, null, 2)}\n`, "utf-8");
-    return downcityJsonPath;
-}
-//# sourceMappingURL=ProjectConfigStore.js.map

package/bin/plugin/core/ProjectConfigStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectConfigStore.js","sourceRoot":"","sources":["../../../src/plugin/core/ProjectConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,SAAS,0BAA0B,CAAC,WAAmB;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IAC1D,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,2CAA2C,gBAAgB,GAAG,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAwB,CAAC;AAClC,CAAC;AAED,SAAS,iCAAiC,CACxC,MAA0D,EAC1D,UAAkB;IAElB,MAAM,oBAAoB,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,oBAAoB;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAkC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA0D,EAC1D,UAAkB;IAElB,OAAO,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MASxC;IACC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,oBAAoB;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,iCAAiC,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACvF,OAAO,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAa/C;IACC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,oBAAoB;QAAE,OAAO;IAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG;QACpD,GAAG,iCAAiC,CAClC,MAAM,CAAC,OAAO,CAAC,MAAM,EACrB,oBAAoB,CACrB;QACD,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IACF,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,qBAAqB,CACrD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAC9B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAShD;IACC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,IAAI,GAAmB;QAC3B,GAAG,OAAO;QACV,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpF,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/src/config/Defaults.ts

@@ -1,49 +0,0 @@
-/**
- * Agent 项目默认配置模板模块。
- *
- * 职责说明（中文）
- * - 集中声明初始化新项目时写入的默认 `downcity.json` 结构。
- * - 为创建流程提供一份稳定、最小可运行的默认配置基线。
- *
- * 边界说明（中文）
- * - 这里的默认值只服务“新项目生成”，不参与运行时多层配置合并。
- * - 业务运行过程中若要读取最终配置，应始终走 `Config.ts` 的装配逻辑。
- */
-
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-
-/**
- * 默认 `downcity.json` 配置。
- *
- * 关键点（中文）
- * - 这是一份“初始化模板”，不是运行时的最终真相来源。
- * - 调用方若只想取某个字段的默认值，也应意识到它可能被用户项目配置覆盖。
- */
-export const DEFAULT_DOWNCITY_JSON: DowncityConfig = {
-  $schema: "./.downcity/schema/downcity.schema.json",
-  id: "downcity",
-  version: "1.0.0",
-  start: {
-    port: 5314,
-    host: "0.0.0.0",
-  },
-  execution: {
-    type: "api",
-    modelId: "default",
-  },
-  plugins: {
-    chat: {
-      queue: {
-        maxConcurrency: 2,
-        mergeDebounceMs: 600,
-        mergeMaxWaitMs: 2000,
-      },
-      channels: {
-        telegram: {
-          enabled: false,
-          channelAccountId: undefined,
-        },
-      },
-    },
-  },
-};

package/src/plugin/core/ProjectConfigStore.ts

@@ -1,155 +0,0 @@
-/**
- * Plugin 项目配置持久化工具。
- *
- * 关键点（中文）
- * - 新插件体系的用户配置统一写回项目 `downcity.json`。
- * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
- * - 这样既能保证重启后配置仍然生效，也能避免把平台全局配置误写进项目文件。
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { AgentPluginConfigRuntime } from "@/types/agent/AgentRuntimeAssembly.js";
-
-type PersistableSections = {
-  /**
-   * 插件配置块（可选）。
-   */
-  plugins?: DowncityConfig["plugins"];
-};
-
-type ProjectPluginConfigCarrier = {
-  /**
-   * 当前项目配置对象。
-   */
-  config: DowncityConfig;
-  /**
-   * plugin 配置持久化能力。
-   */
-  pluginConfig: AgentPluginConfigRuntime;
-};
-
-function getProjectDowncityJsonPath(projectRoot: string): string {
-  return path.join(path.resolve(projectRoot), "downcity.json");
-}
-
-async function readProjectDowncityConfig(projectRoot: string): Promise<DowncityConfig> {
-  const downcityJsonPath = getProjectDowncityJsonPath(projectRoot);
-  const raw = await fs.readFile(downcityJsonPath, "utf-8");
-  const parsed = JSON.parse(raw) as unknown;
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`Invalid downcity.json: expected object (${downcityJsonPath})`);
-  }
-  return parsed as DowncityConfig;
-}
-
-function readProjectPluginRecordFromConfig(
-  config: Pick<DowncityConfig, "plugins"> | null | undefined,
-  pluginName: string,
-): Record<string, unknown> {
-  const normalizedPluginName = String(pluginName || "").trim();
-  if (!normalizedPluginName) return {};
-  const current = config?.plugins?.[normalizedPluginName];
-  if (!current || typeof current !== "object" || Array.isArray(current)) {
-    return {};
-  }
-  return current as Record<string, unknown>;
-}
-
-/**
- * 从项目配置读取单个 plugin 的原始配置块。
- */
-export function readProjectPluginRecord(
-  config: Pick<DowncityConfig, "plugins"> | null | undefined,
-  pluginName: string,
-): Record<string, unknown> {
-  return readProjectPluginRecordFromConfig(config, pluginName);
-}
-
-/**
- * 从项目配置读取单个 plugin 的启用态。
- *
- * 关键点（中文）
- * - 未显式配置 `enabled: false` 时默认视为启用。
- * - Agent 不按插件名维护“必需插件”例外，避免 Runtime 理解具体业务插件。
- * - 这样可以保持“零配置即可使用”的内建 plugin 体验。
- */
-export function readProjectPluginEnabled(params: {
-  /**
-   * 项目配置对象（可选）。
-   */
-  config?: Pick<DowncityConfig, "plugins"> | null;
-  /**
-   * plugin 名称。
-   */
-  pluginName: string;
-}): boolean {
-  const normalizedPluginName = String(params.pluginName || "").trim();
-  if (!normalizedPluginName) return false;
-  const current = readProjectPluginRecordFromConfig(params.config, normalizedPluginName);
-  return current.enabled !== false;
-}
-
-/**
- * 将单个 plugin 的启用态写回项目配置。
- *
- * 关键点（中文）
- * - 这里只维护 `plugins.<name>.enabled`，不理解插件私有字段语义。
- * - 其余配置字段会原样保留，避免开关动作覆盖插件已有设置。
- */
-export async function writeProjectPluginEnabled(params: {
-  /**
-   * 目标 plugin 名称。
-   */
-  pluginName: string;
-  /**
-   * 目标启用态。
-   */
-  enabled: boolean;
-  /**
-   * 当前项目配置与持久化能力。
-   */
-  context: ProjectPluginConfigCarrier;
-}): Promise<void> {
-  const normalizedPluginName = String(params.pluginName || "").trim();
-  if (!normalizedPluginName) return;
-  if (!params.context.config.plugins) {
-    params.context.config.plugins = {};
-  }
-  params.context.config.plugins[normalizedPluginName] = {
-    ...readProjectPluginRecordFromConfig(
-      params.context.config,
-      normalizedPluginName,
-    ),
-    enabled: params.enabled,
-  };
-  await params.context.pluginConfig.persistProjectPlugins(
-    params.context.config.plugins,
-  );
-}
-
-/**
- * 将 plugins 配置块写回项目 `downcity.json`。
- */
-export async function persistProjectPluginConfig(params: {
-  /**
-   * 项目根目录。
-   */
-  projectRoot: string;
-  /**
-   * 待持久化的配置块。
-   */
-  sections: PersistableSections;
-}): Promise<string> {
-  const downcityJsonPath = getProjectDowncityJsonPath(params.projectRoot);
-  const current = await readProjectDowncityConfig(params.projectRoot);
-  const next: DowncityConfig = {
-    ...current,
-    ...(params.sections.plugins !== undefined
-      ? { plugins: params.sections.plugins }
-      : {}),
-  };
-  await fs.writeFile(downcityJsonPath, `${JSON.stringify(next, null, 2)}\n`, "utf-8");
-  return downcityJsonPath;
-}