@downcity/city 1.1.1

package/bin/plugin/PluginManager.js

@@ -0,0 +1,62 @@
+/**
+ * PluginManager 单例。
+ *
+ * 关键点（中文）
+ * - `main/plugin/*` 是 plugin 的管理层，不是具体 plugin 实现层。
+ * - plugin hook / resolve / system 注入所依赖的注册与调度统一收口到这里。
+ * - PluginManager 属于 city runtime，不直接反向依赖 agent AgentContext 单例。
+ * - agent 只是通过 AgentContext 调用统一 plugin manager。
+ * - 具体 plugin 实现位于 `src/plugins/*`，CLI plugin 命令则直接走本地命令执行器。
+ */
+import { isPluginEnabled } from "../plugin/Activation.js";
+import { HookRegistry } from "../plugin/HookRegistry.js";
+import { PluginRegistry } from "../plugin/PluginRegistry.js";
+import { registerBuiltinPlugins } from "../plugin/Plugins.js";
+import { getPluginRuntimeContextResolver } from "../runtime/PluginRuntime.js";
+let pluginManager = null;
+/**
+ * 初始化全局 plugin manager。
+ */
+export function initializePluginManager() {
+    if (pluginManager)
+        return pluginManager;
+    const contextResolver = getPluginRuntimeContextResolver();
+    let pluginRegistryRef = null;
+    const hookRegistry = new HookRegistry({
+        contextResolver,
+        pluginEnabledChecker: (pluginName, context) => {
+            const plugin = pluginRegistryRef?.get(pluginName);
+            if (!plugin)
+                return false;
+            return isPluginEnabled({
+                plugin,
+            });
+        },
+    });
+    const registry = new PluginRegistry({
+        contextResolver,
+        hookRegistry,
+    });
+    pluginRegistryRef = registry;
+    registerBuiltinPlugins({
+        pluginRegistry: registry,
+    });
+    pluginManager = registry;
+    return registry;
+}
+/**
+ * 读取全局 plugin manager。
+ */
+export function getPluginManager() {
+    if (!pluginManager) {
+        return initializePluginManager();
+    }
+    return pluginManager;
+}
+/**
+ * 重置全局 plugin manager（测试/重启场景）。
+ */
+export function resetPluginManager() {
+    pluginManager = null;
+}
+//# sourceMappingURL=PluginManager.js.map

package/bin/plugin/PluginManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManager.js","sourceRoot":"","sources":["../../src/plugin/PluginManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,eAAe,GAAG,+BAA+B,EAAE,CAAC;IAC1D,IAAI,iBAAiB,GAA0B,IAAI,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,eAAe;QACf,oBAAoB,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAG,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC1B,OAAO,eAAe,CAAC;gBACrB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,eAAe;QACf,YAAY;KACb,CAAC,CAAC;IACH,iBAAiB,GAAG,QAAQ,CAAC;IAC7B,sBAAsB,CAAC;QACrB,cAAc,EAAE,QAAQ;KACzB,CAAC,CAAC;IACH,aAAa,GAAG,QAAQ,CAAC;IACzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,uBAAuB,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/bin/plugin/PluginRegistry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Plugin 注册表。
+ *
+ * 关键点（中文）
+ * - 统一管理 plugin 注册、可用性检查与显式 action 运行。
+ * - Plugin 自身不维护独立状态机；可用性由 enabled 配置与 plugin 自定义 availability 决定。
+ */
+import type { HookRegistry } from "../plugin/HookRegistry.js";
+import type { Plugin, PluginActionResult, PluginAvailability, PluginView } from "../shared/types/Plugin.js";
+import type { AgentContext } from "../types/agent/AgentContext.js";
+import type { JsonValue } from "../shared/types/Json.js";
+type ContextResolver = () => AgentContext;
+/**
+ * PluginRegistry：plugin 注册与调度实现。
+ */
+export declare class PluginRegistry {
+    private readonly contextResolver;
+    private readonly hookRegistry;
+    private readonly plugins;
+    constructor(params: {
+        contextResolver: ContextResolver;
+        hookRegistry: HookRegistry;
+    });
+    /**
+     * 注册单个 Plugin。
+     */
+    register(plugin: Plugin): void;
+    /**
+     * 运行 pipeline 点。
+     */
+    pipeline<T = JsonValue>(pointName: string, value: T): Promise<T>;
+    /**
+     * 运行 guard 点。
+     */
+    guard<T = JsonValue>(pointName: string, value: T): Promise<void>;
+    /**
+     * 运行 effect 点。
+     */
+    effect<T = JsonValue>(pointName: string, value: T): Promise<void>;
+    /**
+     * 运行 resolve 点。
+     */
+    resolve<TInput = JsonValue, TOutput = JsonValue>(pointName: string, value: TInput): Promise<TOutput>;
+    /**
+     * 获取单个 plugin 定义。
+     */
+    get(pluginName: string): Plugin | null;
+    /**
+     * 列出全部 plugin 概览视图。
+     */
+    list(): PluginView[];
+    /**
+     * 检查 plugin 可用性。
+     */
+    availability(pluginName: string): Promise<PluginAvailability>;
+    /**
+     * 运行 plugin action。
+     */
+    runAction(params: {
+        plugin: string;
+        action: string;
+        payload?: JsonValue;
+    }): Promise<PluginActionResult<JsonValue>>;
+}
+export {};
+//# sourceMappingURL=PluginRegistry.d.ts.map

package/bin/plugin/PluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"","sources":["../../src/plugin/PluginRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,KAAK,eAAe,GAAG,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,MAAM,EAAE;QAClB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B;IAKD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAuC9B;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;OAEG;IACG,OAAO,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EACnD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,IAAI,IAAI,UAAU,EAAE;IA2BpB;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+BnE;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,SAAS,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;CAqD3C"}

package/bin/plugin/PluginRegistry.js

@@ -0,0 +1,184 @@
+/**
+ * Plugin 注册表。
+ *
+ * 关键点（中文）
+ * - 统一管理 plugin 注册、可用性检查与显式 action 运行。
+ * - Plugin 自身不维护独立状态机；可用性由 enabled 配置与 plugin 自定义 availability 决定。
+ */
+import { isPluginEnabled } from "../plugin/Activation.js";
+/**
+ * PluginRegistry：plugin 注册与调度实现。
+ */
+export class PluginRegistry {
+    contextResolver;
+    hookRegistry;
+    plugins = new Map();
+    constructor(params) {
+        this.contextResolver = params.contextResolver;
+        this.hookRegistry = params.hookRegistry;
+    }
+    /**
+     * 注册单个 Plugin。
+     */
+    register(plugin) {
+        const key = String(plugin.name || "").trim();
+        if (!key) {
+            throw new Error("Plugin name is required");
+        }
+        if (this.plugins.has(key)) {
+            throw new Error(`Plugin already registered: ${key}`);
+        }
+        this.plugins.set(key, plugin);
+        for (const [hookName, handlers] of Object.entries(plugin.hooks?.pipeline || {})) {
+            for (const handler of handlers) {
+                this.hookRegistry.pipeline(hookName, key, handler);
+            }
+        }
+        for (const [hookName, handlers] of Object.entries(plugin.hooks?.guard || {})) {
+            for (const handler of handlers) {
+                this.hookRegistry.guard(hookName, key, handler);
+            }
+        }
+        for (const [hookName, handlers] of Object.entries(plugin.hooks?.effect || {})) {
+            for (const handler of handlers) {
+                this.hookRegistry.effect(hookName, key, handler);
+            }
+        }
+        for (const [pointName, handler] of Object.entries(plugin.resolves || {})) {
+            this.hookRegistry.resolve(pointName, key, handler);
+        }
+    }
+    /**
+     * 运行 pipeline 点。
+     */
+    async pipeline(pointName, value) {
+        return this.hookRegistry.pipelineValue(pointName, value);
+    }
+    /**
+     * 运行 guard 点。
+     */
+    async guard(pointName, value) {
+        return this.hookRegistry.guardValue(pointName, value);
+    }
+    /**
+     * 运行 effect 点。
+     */
+    async effect(pointName, value) {
+        return this.hookRegistry.effectValue(pointName, value);
+    }
+    /**
+     * 运行 resolve 点。
+     */
+    async resolve(pointName, value) {
+        return this.hookRegistry.resolveValue(pointName, value);
+    }
+    /**
+     * 获取单个 plugin 定义。
+     */
+    get(pluginName) {
+        return this.plugins.get(String(pluginName || "").trim()) || null;
+    }
+    /**
+     * 列出全部 plugin 概览视图。
+     */
+    list() {
+        return Array.from(this.plugins.values())
+            .map((plugin) => ({
+            name: plugin.name,
+            title: String(plugin.title || plugin.name || "").trim(),
+            description: String(plugin.description || "").trim(),
+            actions: Object.keys(plugin.actions || {}).sort((a, b) => a.localeCompare(b)),
+            pipelines: Object.keys(plugin.hooks?.pipeline || {}).sort((a, b) => a.localeCompare(b)),
+            guards: Object.keys(plugin.hooks?.guard || {}).sort((a, b) => a.localeCompare(b)),
+            effects: Object.keys(plugin.hooks?.effect || {}).sort((a, b) => a.localeCompare(b)),
+            resolves: Object.keys(plugin.resolves || {}).sort((a, b) => a.localeCompare(b)),
+            hasSystem: typeof plugin.system === "function",
+            hasAvailability: typeof plugin.availability === "function",
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * 检查 plugin 可用性。
+     */
+    async availability(pluginName) {
+        const plugin = this.get(pluginName);
+        if (!plugin) {
+            return {
+                enabled: false,
+                available: false,
+                reasons: [`Unknown plugin: ${pluginName}`],
+            };
+        }
+        if (plugin.availability) {
+            return await plugin.availability(this.contextResolver());
+        }
+        const context = this.contextResolver();
+        const enabled = isPluginEnabled({ plugin });
+        if (!enabled) {
+            return {
+                enabled: false,
+                available: false,
+                reasons: [`Plugin "${plugin.name}" is disabled`],
+            };
+        }
+        return {
+            enabled: true,
+            available: true,
+            reasons: [],
+        };
+    }
+    /**
+     * 运行 plugin action。
+     */
+    async runAction(params) {
+        const plugin = this.get(params.plugin);
+        if (!plugin) {
+            return {
+                success: false,
+                error: `Unknown plugin: ${params.plugin}`,
+                message: `Unknown plugin: ${params.plugin}`,
+            };
+        }
+        const actionName = String(params.action || "").trim();
+        if (!actionName) {
+            return {
+                success: false,
+                error: "action is required",
+                message: "action is required",
+            };
+        }
+        const action = plugin.actions?.[actionName];
+        if (!action) {
+            return {
+                success: false,
+                error: `Plugin "${plugin.name}" does not implement action "${actionName}"`,
+                message: `Plugin "${plugin.name}" does not implement action "${actionName}"`,
+            };
+        }
+        const context = this.contextResolver();
+        const enabled = isPluginEnabled({ plugin });
+        if (!enabled && action.allowWhenDisabled !== true) {
+            return {
+                success: false,
+                error: `Plugin "${plugin.name}" is disabled`,
+                message: `Plugin "${plugin.name}" is disabled`,
+            };
+        }
+        try {
+            return await action.execute({
+                context,
+                payload: (params.payload ?? {}),
+                pluginName: plugin.name,
+                actionName,
+            });
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: String(error),
+                message: String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=PluginRegistry.js.map

package/bin/plugin/PluginRegistry.js.map

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

package/bin/plugin/Plugins.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 内建 Plugin 清单（单一事实源）。
+ *
+ * 关键点（中文）
+ * - 统一维护全部内建 plugin，避免 CLI / agent / docs 各自硬编码。
+ * - 同时提供统一注册入口，减少额外跳转层级。
+ */
+import type { PluginRegistry } from "../plugin/PluginRegistry.js";
+import type { Plugin } from "../shared/types/Plugin.js";
+/**
+ * 全部内建 Plugin。
+ */
+export declare const PLUGINS: Plugin[];
+/**
+ * 注册全部内建插件体系对象。
+ */
+export declare function registerBuiltinPlugins(params: {
+    pluginRegistry: PluginRegistry;
+}): void;
+//# sourceMappingURL=Plugins.d.ts.map

package/bin/plugin/Plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugins.d.ts","sourceRoot":"","sources":["../../src/plugin/Plugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAQvD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,EAO3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,IAAI,CAIP"}

package/bin/plugin/Plugins.js

@@ -0,0 +1,33 @@
+/**
+ * 内建 Plugin 清单（单一事实源）。
+ *
+ * 关键点（中文）
+ * - 统一维护全部内建 plugin，避免 CLI / agent / docs 各自硬编码。
+ * - 同时提供统一注册入口，减少额外跳转层级。
+ */
+import { authPlugin } from "../plugins/auth/Plugin.js";
+import { skillPlugin } from "../plugins/skill/Plugin.js";
+import { webPlugin } from "../plugins/web/Plugin.js";
+import { asrPlugin } from "../plugins/asr/Plugin.js";
+import { ttsPlugin } from "../plugins/tts/Plugin.js";
+import { workboardPlugin } from "../plugins/workboard/Plugin.js";
+/**
+ * 全部内建 Plugin。
+ */
+export const PLUGINS = [
+    authPlugin,
+    skillPlugin,
+    webPlugin,
+    asrPlugin,
+    ttsPlugin,
+    workboardPlugin,
+];
+/**
+ * 注册全部内建插件体系对象。
+ */
+export function registerBuiltinPlugins(params) {
+    for (const plugin of PLUGINS) {
+        params.pluginRegistry.register(plugin);
+    }
+}
+//# sourceMappingURL=Plugins.js.map

package/bin/plugin/Plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugins.js","sourceRoot":"","sources":["../../src/plugin/Plugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAa;IAC/B,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,eAAe;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAEtC;IACC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/bin/plugin/ProjectConfigStore.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Plugin 项目配置持久化工具。
+ *
+ * 关键点（中文）
+ * - 新插件体系的用户配置统一写回项目 `downcity.json`。
+ * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
+ * - 这样既能保证重启后配置仍然生效，也能避免把 console 全局配置误写进项目文件。
+ */
+import type { DowncityConfig } from "../shared/types/DowncityConfig.js";
+type PersistableSections = {
+    /**
+     * 插件配置块（可选）。
+     */
+    plugins?: DowncityConfig["plugins"];
+};
+/**
+ * 将 plugins 配置块写回项目 `downcity.json`。
+ */
+export declare function persistProjectPluginConfig(params: {
+    /**
+     * 项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 待持久化的配置块。
+     */
+    sections: PersistableSections;
+}): Promise<string>;
+export {};
+//# sourceMappingURL=ProjectConfigStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectConfigStore.d.ts","sourceRoot":"","sources":["../../src/plugin/ProjectConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAgBF;;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/ProjectConfigStore.js

@@ -0,0 +1,38 @@
+/**
+ * Plugin 项目配置持久化工具。
+ *
+ * 关键点（中文）
+ * - 新插件体系的用户配置统一写回项目 `downcity.json`。
+ * - 这里只负责 `plugins` 配置域，避免把执行期合并态整包落盘。
+ * - 这样既能保证重启后配置仍然生效，也能避免把 console 全局配置误写进项目文件。
+ */
+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;
+}
+/**
+ * 将 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/ProjectConfigStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectConfigStore.js","sourceRoot":"","sources":["../../src/plugin/ProjectConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,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;;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/bin/plugins/asr/Dependency.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ASR Plugin Dependency Helper。
+ *
+ * 关键点（中文）
+ * - ASR 的转写依赖现在内聚在 plugin 内部，不再暴露独立依赖端口心智。
+ * - 这里统一管理检查、安装、配置读写与转写句柄解析。
+ */
+import type { JsonValue } from "../../shared/types/Json.js";
+import type { PluginCommandContext } from "../../shared/types/Plugin.js";
+import type { VoicePluginConfig, VoiceTranscriberConfig, VoiceTranscriberInstallInput, VoiceTranscriberHandle } from "../../shared/types/VoicePlugin.js";
+export interface VoiceDependencyCheckResult {
+    /**
+     * 当前依赖是否可用。
+     */
+    available: boolean;
+    /**
+     * 不可用原因列表。
+     */
+    reasons: string[];
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+export interface VoiceDependencyInstallResult {
+    /**
+     * 安装是否成功。
+     */
+    success: boolean;
+    /**
+     * 人类可读消息（可选）。
+     */
+    message?: string;
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+/**
+ * 读取 ASR 转写依赖配置。
+ */
+export declare function readVoiceTranscriberConfig(context: PluginCommandContext): VoiceTranscriberConfig;
+/**
+ * 写入 ASR 转写依赖配置。
+ */
+export declare function writeVoiceTranscriberConfig(params: {
+    context: PluginCommandContext;
+    value: Partial<VoiceTranscriberConfig>;
+}): Promise<VoicePluginConfig>;
+/**
+ * 检查 ASR 转写依赖可用性。
+ */
+export declare function checkVoiceTranscriber(context: PluginCommandContext): Promise<VoiceDependencyCheckResult>;
+/**
+ * 安装或修复 ASR 转写依赖。
+ */
+export declare function installVoiceTranscriber(params: {
+    context: PluginCommandContext;
+    input?: VoiceTranscriberInstallInput;
+}): Promise<VoiceDependencyInstallResult>;
+/**
+ * 解析 ASR 转写句柄。
+ */
+export declare function resolveVoiceTranscriber(context: PluginCommandContext): Promise<VoiceTranscriberHandle>;
+/**
+ * 执行一次 ASR 转写。
+ */
+export declare function transcribeWithVoiceDependency(params: {
+    context: PluginCommandContext;
+    audioPath: string;
+    language?: string;
+}): Promise<{
+    success: boolean;
+    text?: string;
+    error?: string;
+}>;
+//# sourceMappingURL=Dependency.d.ts.map

package/bin/plugins/asr/Dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../../src/plugins/asr/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAoBvC,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAqCD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,sBAAsB,CAUxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACxC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAe7B;AA4CD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAUrC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAqFxC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/D"}