使用 config、actions、hooks、system text、availability、lifecycle 与可选 runtime HTTP routes 构建自定义 plugin

自定义 Plugin

如果你要加的东西主要是：

一组 actions
一组 hooks
一层 system text
一个生命周期拥有的 runtime 边界
一组 runtime HTTP routes

那自定义 plugin 通常就是合适的扩展点。

当前公开入口

@downcity/agent 已经公开了：

plugin 类型与契约
BasePlugin 基类
本地 Agent 的 plugins: [...] 组装入口

内建 plugin class 由 @downcity/plugins 导出。

最小骨架

import { BasePlugin, type PluginActions } from "@downcity/agent";

export class NotesPlugin extends BasePlugin {
  readonly name = "notes";
  readonly title = "Notes Helper";
  readonly description = "Adds note-related actions and prompt guidance.";

  readonly actions: PluginActions = {
    status: {
      execute: async ({ context }) => {
        return {
          success: true,
          data: {
            rootPath: context.rootPath,
          },
        };
      },
    },
  };
}

挂到本地 Agent 上

import { Agent, BasePlugin, type PluginActions } from "@downcity/agent";

class NotesPlugin extends BasePlugin {
  readonly name = "notes";
  readonly title = "Notes Helper";
  readonly description = "Adds note-related actions and runtime guidance.";

  readonly actions: PluginActions = {
    status: {
      allowWhenDisabled: true,
      execute: async ({ context }) => ({
        success: true,
        data: {
          rootPath: context.rootPath,
        },
      }),
    },
  };
}

const agent = new Agent({
  id: "repo-helper",
  path: "/path/to/project",
  tools: {},
  plugins: [new NotesPlugin()],
});