@downcity/plugins 1.0.57 → 1.0.60

package/bin/skill/types/{ClaudeSkill.js → SkillDefinition.js}

@@ -1,5 +1,5 @@
 /**
- * Claude Code-compatible skill 模型。
+ * Skill 定义模型。
  *
  * 关键点（中文）
  * - skill 最小单元目录为 `<root>/<skill-id>/SKILL.md`。
@@ -7,4 +7,4 @@
  * - 该类型为 skill plugin、CLI 与内部辅助模块的共享事实源。
  */
 export {};
-//# sourceMappingURL=ClaudeSkill.js.map
+//# sourceMappingURL=SkillDefinition.js.map

package/bin/skill/types/SkillDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDefinition.js","sourceRoot":"","sources":["../../../src/skill/types/SkillDefinition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/skill/types/SkillPlugin.d.ts

@@ -6,7 +6,7 @@
  * - constructor options 是 skill plugin 的唯一行为配置入口。
  * - 该文件只描述插件协议，不承载发现、安装或 system 组装逻辑。
  */
-import type { ClaudeSkill } from "../../skill/types/ClaudeSkill.js";
+import type { SkillDefinition } from "../../skill/types/SkillDefinition.js";
 import type { SkillRootSource } from "../../skill/types/SkillRoot.js";
 /**
  * skill plugin action 名称常量。
@@ -71,7 +71,7 @@ export type SkillPluginLookupPayload = {
 /**
  * skill 忽略规则。
  */
-export type SkillPluginIgnoreRule = string | RegExp | ((skill: ClaudeSkill) => boolean);
+export type SkillPluginIgnoreRule = string | RegExp | ((skill: SkillDefinition) => boolean);
 /**
  * SkillPlugin 构造参数。
  */

package/bin/skill/types/SkillPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SkillPlugin.d.ts","sourceRoot":"","sources":["../../../src/skill/types/SkillPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC"}
+{"version":3,"file":"SkillPlugin.d.ts","sourceRoot":"","sources":["../../../src/skill/types/SkillPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC"}

package/bin/web/Plugin.js

@@ -119,7 +119,7 @@ export class WebPlugin extends BasePlugin {
                         .option("--target <target>", "web-access、agent-browser 或 all")
                         .option("--scope <scope>", "安装位置：user 或 project")
                         .option("-y, --yes", "跳过确认（默认 true）", true)
-                        .option("--agent <agent>", "skill installer 目标 agent", "claude-code");
+                        .option("--agent <agent>", "skill installer 目标 agent");
                 },
                 mapInput({ opts }) {
                     return {

package/bin/web/Plugin.js.map

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

package/bin/web/runtime/Install.js

@@ -148,7 +148,7 @@ export async function installWebPluginTargets(params) {
     const target = resolve_install_target(payload.target);
     const scope = resolve_install_scope(payload.scope);
     const yes = read_boolean(payload.yes) ?? true;
-    const agent = read_string(payload.agent) || "claude-code";
+    const agent = read_string(payload.agent);
     const targets = target === "all" ? ["web-access", "agent-browser"] : [target];
     const steps = [];
     for (const item of targets) {
@@ -170,7 +170,7 @@ export async function installWebPluginTargets(params) {
     return {
         target,
         scope,
-        agent,
+        ...(agent ? { agent } : {}),
         steps: serialize_steps(steps),
         nextAction: "Use SkillPlugin lookup/list to inspect installed skills, then let the agent choose the concrete web path during task execution.",
     };

package/bin/web/runtime/Install.js.map

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

package/bin/web/types/WebPlugin.d.ts

@@ -50,7 +50,8 @@ export interface WebPluginInstallPayload {
      * skill installer 的目标 agent 名称。
      *
      * 说明（中文）
-     * - 默认使用 `claude-code`，与现有 SkillPlugin 安装行为保持一致。
+     * - 留空时不向底层 skill installer 传递 `--agent`。
+     * - 只有需要显式指定 installer 目标时才传入。
      */
     agent?: string;
     /**

package/bin/web/types/WebPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,eAAe,GAAG,KAAK,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC"}
+{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,eAAe,GAAG,KAAK,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC"}

package/bin/workboard/Plugin.d.ts

@@ -2,15 +2,35 @@
  * 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 type { PluginActions, PluginHttpDefinition } from "@downcity/agent/internal/plugin/types/Plugin.js";
 /**
  * WorkboardPlugin：运行态观测面板插件。
  */
 export declare class WorkboardPlugin extends BasePlugin {
+    /**
+     * 当前 plugin 稳定名称。
+     */
     readonly name = "workboard";
-    constructor();
+    /**
+     * 插件标题。
+     */
+    readonly title = "Workboard Snapshot";
+    /**
+     * 插件说明。
+     */
+    readonly 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。
+     */
+    readonly actions: PluginActions;
+    /**
+     * Workboard HTTP route。
+     */
+    readonly http: PluginHttpDefinition;
 }
 //# sourceMappingURL=Plugin.d.ts.map

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.60",
   "type": "module",
   "description": "Downcity 内建 plugin 集合包",
   "main": "./bin/index.js",
@@ -22,7 +22,7 @@
     "node-cron": "^4.2.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/agent": "^1.1.105"
+    "@downcity/agent": "^1.1.106"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

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";
@@ -17,6 +16,12 @@ import { ContactPlugin } from "@/contact/ContactPlugin.js";
 import { TaskPlugin } from "@/task/TaskPlugin.js";
 import { MemoryPlugin } from "@/memory/MemoryPlugin.js";
 import { ShellPlugin } from "@/shell/ShellPlugin.js";
+import { ImagePlugin } from "@/image/ImagePlugin.js";
+import { AsrPlugin } from "@/asr/Plugin.js";
+import { TtsPlugin } from "@/tts/Plugin.js";
+import type { ImagePluginOptions } from "@/image/types/ImagePlugin.js";
+import type { AsrPluginOptions } from "@/asr/types/AsrPlugin.js";
+import type { TtsPluginOptions } from "@/tts/types/TtsPlugin.js";
 
 /**
  * 内建 plugin class 构造器。
@@ -24,10 +29,11 @@ import { ShellPlugin } from "@/shell/ShellPlugin.js";
 export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new () => T;
 
 /**
- * 全部内建 plugin classes。
+ * 可直接无参创建的内建 plugin classes。
+ *
+ * 关键点（中文）：image / asr / tts 需要宿主注入 City AI 能力，不能放入无参 class 列表。
  */
 export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
-  ChatAuthorizationPlugin,
   SkillPlugin,
   WebPlugin,
   WorkboardPlugin,
@@ -38,9 +44,39 @@ export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
   ShellPlugin,
 ];
 
+/**
+ * 内建 plugin 工厂参数。
+ */
+export interface BuiltinPluginOptions {
+  /**
+   * 图片生成 plugin 的 City AI 能力注入。
+   */
+  image?: ImagePluginOptions;
+
+  /**
+   * 语音转写 plugin 的 City AI 能力注入。
+   */
+  asr?: AsrPluginOptions;
+
+  /**
+   * 文本转语音 plugin 的 City AI 能力注入。
+   */
+  tts?: TtsPluginOptions;
+}
+
 /**
  * 创建完整内建 plugin 实例集合。
  */
-export function createBuiltinPlugins(): BasePlugin[] {
-  return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass());
+export function createBuiltinPlugins(options: BuiltinPluginOptions = {}): BasePlugin[] {
+  const plugins = BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass());
+  if (options.image?.image_create && options.image?.image_result) {
+    plugins.push(new ImagePlugin(options.image));
+  }
+  if (options.asr?.asr) {
+    plugins.push(new AsrPlugin(options.asr));
+  }
+  if (options.tts?.tts) {
+    plugins.push(new TtsPlugin(options.tts));
+  }
+  return plugins;
 }

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 {
   /**