@bbki.ng/site 5.7.0 → 5.8.1

package/src/plugins/blog/services/BlogUIService.ts

@@ -0,0 +1,120 @@
+import type React from 'react';
+
+import { IMiddlewareEntry, ISlotEntry } from '#/core/plugin-system/registry';
+import { createEventBus } from '#/core/utils/eventBus';
+import { IComPropsRegisteredToSlot } from '#/types/slots';
+
+import { BlogDataHookPoint, BlogSlotName, IBlogUIService } from './IBlogUIService';
+
+type RegistryEvents = {
+  'blog:slots:changed': void;
+  'blog:middleware:changed': BlogDataHookPoint;
+};
+
+export class BlogUIService implements IBlogUIService {
+  private static instance: BlogUIService;
+
+  private constructor() {}
+
+  private slots = new Map<BlogSlotName, Array<ISlotEntry>>();
+  private middlewares = new Map<BlogDataHookPoint, IMiddlewareEntry<unknown>[]>();
+
+  private bus = createEventBus<RegistryEvents>();
+
+  static getInstance(): BlogUIService {
+    if (!BlogUIService.instance) {
+      BlogUIService.instance = new BlogUIService();
+    }
+    return BlogUIService.instance;
+  }
+
+  subscribeSlotChange(listener: () => void) {
+    return this.bus.on('blog:slots:changed', listener);
+  }
+
+  subscribeMiddlewareChange(listener: (hookPoint: BlogDataHookPoint) => void) {
+    return this.bus.on('blog:middleware:changed', listener);
+  }
+
+  registerMiddleware: <S>(
+    hookPoint: BlogDataHookPoint,
+    fn: (data: S) => S | Promise<S>,
+    pluginId: string,
+    weight?: number
+  ) => void = <S>(
+    hookPoint: BlogDataHookPoint,
+    fn: (data: S) => S | Promise<S>,
+    pluginId: string,
+    weight = 0
+  ) => {
+    const existing = this.middlewares.get(hookPoint) || [];
+
+    const newEntry: IMiddlewareEntry<S> = {
+      id: `${pluginId}-${hookPoint}-middleware`,
+      pluginId,
+      fn,
+      weight,
+    };
+
+    const updated = [...existing, newEntry as IMiddlewareEntry<unknown>].sort(
+      (a, b) => (b.weight || 0) - (a.weight || 0)
+    );
+    this.middlewares.set(hookPoint, updated);
+
+    this.bus.emit('blog:middleware:changed', hookPoint);
+  };
+
+  registerSlot: (
+    slotName: BlogSlotName,
+    component: React.ComponentType<{ data: unknown }>,
+    pluginId: string,
+    weight?: number
+  ) => void = (slotName, component, pluginId, weight = 0) => {
+    const existing = this.slots.get(slotName) || [];
+    const newEntry: ISlotEntry = {
+      id: `${pluginId}-${slotName}-slot`,
+      pluginId,
+      component,
+      weight,
+    };
+
+    const updated = [...existing, newEntry].sort((a, b) => (b.weight || 0) - (a.weight || 0));
+    this.slots.set(slotName, updated);
+
+    this.bus.emit('blog:slots:changed', undefined);
+  };
+
+  unregisterAllByPluginId: (pluginId: string) => void = pluginId => {
+    // 移除中间件
+    this.middlewares.forEach((entries, hookPoint) => {
+      const filtered = entries.filter(entry => entry.pluginId !== pluginId);
+      if (filtered.length !== entries.length) {
+        this.middlewares.set(hookPoint, filtered);
+        this.bus.emit('blog:middleware:changed', hookPoint);
+      }
+    });
+
+    // 移除插槽组件
+    this.slots.forEach((entries, slotName) => {
+      const filtered = entries.filter(entry => entry.pluginId !== pluginId);
+      if (filtered.length !== entries.length) {
+        this.slots.set(slotName, filtered);
+      }
+    });
+
+    this.bus.emit('blog:slots:changed', undefined);
+  };
+
+  getComponents(slotName: BlogSlotName): React.ComponentType<IComPropsRegisteredToSlot>[] {
+    return (this.slots.get(slotName) || []).map(entry => entry.component);
+  }
+
+  async runMiddlewares<T>(point: BlogDataHookPoint, data: T): Promise<T> {
+    const fns = (this.middlewares.get(point) || []).map(entry => entry.fn);
+    let result = data;
+    for (const fn of fns) {
+      result = (await fn(result)) as T;
+    }
+    return result;
+  }
+}

package/src/plugins/blog/services/IBlogUIService.ts

@@ -0,0 +1,31 @@
+import type React from 'react';
+
+import { type IBaseUIService } from '#/core/shared-service/contract/IUIService';
+
+declare module '#/core/shared-service/service-registry' {
+  interface ServiceIdentifierMap {
+    'blog:uiService': IBlogUIService;
+  }
+}
+
+export type BlogSlotName = 'blog:articleActionRow' | 'blog:articleTitle';
+
+export type BlogDataHookPoint =
+  | 'blog:filterPosts'
+  | 'blog:transformPostContent'
+  | 'blog:transformTitleList';
+
+export interface IBlogUIService extends IBaseUIService<BlogSlotName, BlogDataHookPoint> {
+  registerMiddleware: <S>(
+    hookPoint: BlogDataHookPoint,
+    fn: (data: S) => S | Promise<S>,
+    pluginId: string,
+    weight?: number
+  ) => void;
+  registerSlot: (
+    slotName: BlogSlotName,
+    component: React.ComponentType<{ data: unknown }>,
+    pluginId: string,
+    weight?: number
+  ) => void;
+}

package/src/plugins/extra-cd/index.ts

@@ -1,4 +1,4 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
 import { TitleListItem } from '#/types/posts';
@@ -7,7 +7,18 @@ class ExtraCd extends BBPlugin {
   id: PluginID = 'extra-cd';
 
   override onInstall = async (ctx: IHostContext): Promise<void> => {
-    ctx.api.registerMiddleware('transformTitleList', this.transformTitleList, this.id, 10);
+    const blogUIService = ctx.service.get('blog:uiService');
+    if (!blogUIService) {
+      console.error('Blog UI service not found. ExtraCd installation failed.');
+      return;
+    }
+
+    blogUIService.registerMiddleware(
+      'blog:transformTitleList',
+      this.transformTitleList,
+      this.id,
+      10
+    );
   };
 
   private transformTitleList = (titleList: Array<TitleListItem>) => {

package/src/plugins/extra-entry/index.ts

@@ -1,7 +1,6 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
-import { buildEntryCreator } from '#/utils';
 
 import { ExtendedRoutesPage } from './components/page';
 
@@ -9,8 +8,13 @@ export class ExtraEntryPlugin extends BBPlugin {
   id: PluginID = 'extra-entry';
 
   override onInstall = async (ctx: IHostContext): Promise<void> => {
-    const entryCreator = buildEntryCreator(ctx);
-    entryCreator(
+    const systemUIService = ctx.service.get('core:uiService');
+    if (!systemUIService) {
+      console.warn(`[${this.id}] core:uiService not found, cannot register entry`);
+      return;
+    }
+
+    systemUIService.registerPluginEntry(
       {
         pageComponent: ExtendedRoutesPage,
         path: '/hello',

package/src/plugins/fx/index.ts

@@ -1,4 +1,4 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
 
@@ -9,14 +9,27 @@ class FxPlugin extends BBPlugin {
   id: PluginID = 'fx';
 
   override onInstall = async (ctx: IHostContext) => {
-    ctx.api.registerSlot(
+    const coreService = ctx.service.get('core:baseService');
+
+    if (!coreService) {
+      console.error('Core service not found. FxPlugin installation failed.');
+      return;
+    }
+
+    const systemUIService = ctx.service.get('core:uiService');
+    if (!systemUIService) {
+      console.error('UI service not found. FxPlugin installation failed.');
+      return;
+    }
+
+    systemUIService.registerSlot(
       'pageFooter',
       FxContext.withCtx(
         {
-          versionHash: await ctx.api.getVersionHash(),
-          deviceId: (await ctx.api.getDeviceId()).id,
+          versionHash: await coreService.getVersionHash(),
+          deviceId: (await coreService.getDeviceId())?.id,
           subscribeToLoading: listener => {
-            return ctx.api.onLoadingChanged(listener);
+            return coreService.subscribeLoadingChange(listener);
           },
         },
         FxCom

package/src/plugins/notification/components/index.tsx

@@ -0,0 +1,18 @@
+import React, { FC } from 'react';
+import { Toaster } from 'sonner';
+
+import { IComPropsRegisteredToSlot } from '#/types/slots';
+
+export const NotifyComp: FC<IComPropsRegisteredToSlot> = _ => {
+  return (
+    <Toaster
+      position="bottom-center"
+      toastOptions={{
+        style: {
+          borderRadius: 0,
+          border: 'none',
+        },
+      }}
+    />
+  );
+};

package/src/plugins/notification/index.ts

@@ -0,0 +1,26 @@
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
+import { IHostContext } from '#/types/hostApi';
+import { PluginID } from '#/types/plugin';
+
+import { NotifyComp } from './components';
+import { NotificationService } from './services/NotificationService';
+
+export class NotificationPlugin extends BBPlugin {
+  id: PluginID = 'notification' as const;
+
+  private _serviceRegistry?: IHostContext['service'];
+
+  override onInstall = async (ctx: IHostContext) => {
+    this._serviceRegistry = ctx.service;
+    this._serviceRegistry.register('notification', NotificationService.getInstance());
+
+    const coreUIService = ctx.service.get('core:uiService');
+    coreUIService.registerSlot('pageFooter', NotifyComp, this.id);
+  };
+
+  override onDestroy = () => {
+    this._serviceRegistry?.unregister('notification');
+  };
+}
+
+export default new NotificationPlugin();

package/src/plugins/notification/services/INotificationService.ts

@@ -0,0 +1,19 @@
+declare module '#/core/shared-service/service-registry' {
+  interface ServiceIdentifierMap {
+    notification: INotificationService;
+  }
+}
+
+export type NotificationType = 'toast' | 'banner' | 'modal';
+
+export interface INotificationOptions {
+  type?: NotificationType;
+  level?: 'info' | 'success' | 'warning' | 'error';
+  message: string;
+  duration?: number; // 持续时间，单位为毫秒，默认为4000ms
+}
+
+export interface INotificationService {
+  notify: (options: INotificationOptions) => string;
+  dismiss: (id: string) => void;
+}

package/src/plugins/notification/services/NotificationService.ts

@@ -0,0 +1,28 @@
+import { toast } from 'sonner';
+
+import { INotificationOptions, INotificationService } from './INotificationService';
+
+export class NotificationService implements INotificationService {
+  private static instance: NotificationService;
+
+  private constructor() {}
+
+  static getInstance(): NotificationService {
+    if (!NotificationService.instance) {
+      NotificationService.instance = new NotificationService();
+    }
+    return NotificationService.instance;
+  }
+
+  notify(options: INotificationOptions): string {
+    const id = toast(options.message, {
+      duration: options.duration || 3000,
+    });
+
+    return id as string;
+  }
+
+  dismiss(id: string): void {
+    toast.dismiss(id);
+  }
+}

package/src/plugins/now/hooks/use_streaming.ts

@@ -74,7 +74,9 @@ export function useStreaming(options: UseStreamingOptions = {}) {
     });
   }, []);
 
-  nowCtx.setLoading(isLoading);
+  useEffect(() => {
+    nowCtx.setLoading(isLoading);
+  }, [nowCtx, isLoading]);
 
   return {
     streaming: data?.data ?? [],

package/src/plugins/now/index.ts

@@ -1,7 +1,6 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
-import { buildEntryCreator } from '#/utils';
 
 import { pageNow } from './components';
 import { NowCtx } from './context';
@@ -10,19 +9,31 @@ export class NowPlugin extends BBPlugin {
   id: PluginID = 'now';
 
   override onInstall = async (ctx: IHostContext): Promise<void> => {
-    const nowEntryCreator = buildEntryCreator(ctx);
+    const systemUIService = ctx.service.get('core:uiService');
+    if (!systemUIService) {
+      console.warn(`[${this.id}] core:uiService not found, cannot register entry`);
+      return;
+    }
     const { withCtx } = NowCtx;
 
-    nowEntryCreator(
+    const coreService = ctx.service.get('core:baseService');
+
+    if (!coreService) {
+      console.error('Core service not found. NowPlugin installation failed.');
+      return;
+    }
+
+    systemUIService.registerPluginEntry(
       {
         path: '/now',
         label: 'cd ./now',
         pageComponent: withCtx(
           {
             setLoading: loading => {
-              ctx.api.setLoading('now', loading);
+              // ctx.api.setLoading('now', loading);
+              coreService.setLoading('now', loading);
             },
-            fetch: ctx.api.fetch,
+            fetch: coreService.fetch, // 直接使用 coreService 的 fetch 方法
           },
           pageNow
         ),

package/src/plugins/sticker/const.ts

@@ -5,7 +5,7 @@ export const STICKERS: IStickerConfig[] = [
     id: 'copilot',
     imageUrl: '/stickers/copilot.svg',
     rotation: 20,
-    maxWidth: 100,
+    maxWidth: 60,
     aspectRatio: '505/410',
     xOffset: 0,
     yOffset: 0,
@@ -41,7 +41,7 @@ export const STICKERS: IStickerConfig[] = [
     id: 'vite',
     imageUrl: '/stickers/vitejs.svg',
     rotation: -5,
-    maxHeight: 180,
+    maxWidth: 30,
     aspectRatio: '512/512',
     xOffset: 100,
     yOffset: -30,

package/src/plugins/sticker/index.ts

@@ -1,4 +1,4 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
 
@@ -9,8 +9,17 @@ class Sticker extends BBPlugin {
   id: PluginID = 'sticker';
 
   private createPluginCtx = async (ctx: IHostContext): Promise<IStickerCtx> => {
+    const coreService = ctx.service.get('core:baseService');
+
+    if (!coreService) {
+      console.error('Core service not found. StickerPlugin installation failed.');
+      return {
+        deviceId: '',
+      };
+    }
+
     return {
-      deviceId: (await ctx.api.getDeviceId()).id,
+      deviceId: (await coreService.getDeviceId()).id,
     };
   };
 
@@ -21,7 +30,13 @@ class Sticker extends BBPlugin {
 
     const Sticker = withCtx(pluginCtx, StickerCom);
 
-    ctx.api.registerSlot('leftCol', Sticker, this.id);
+    const systemUIService = ctx.service.get('core:uiService');
+    if (!systemUIService) {
+      console.error('UI service not found. StickerPlugin installation failed.');
+      return;
+    }
+
+    systemUIService.registerSlot('leftCol', Sticker, this.id);
   };
 }
 

package/src/plugins/store/components/storePage.tsx

@@ -6,6 +6,7 @@ import { IComPropsRegisteredToSlot } from '#/types/slots';
 import { IPluginStoreEntry, PluginID } from '#/types/plugin';
 
 import { StoreCtx } from '../context';
+import { pluginDepDescForHuman } from '../utils';
 
 // 空状态展示
 const EmptyState = () => (
@@ -25,7 +26,8 @@ const ErrorState = ({ error, onRetry }: { error: Error; onRetry: () => void }) =
 );
 
 export const StorePage = (_: IComPropsRegisteredToSlot) => {
-  const { list, setLoading, isInstalled, install, uninstall } = StoreCtx.useCtx();
+  const { list, setLoading, isInstalled, install, uninstall, get, notificationService } =
+    StoreCtx.useCtx();
   const [plugins, setPlugins] = useState<Array<IPluginStoreEntry>>([]);
   const [error, setError] = useState<Error | null>(null);
 
@@ -75,15 +77,25 @@ export const StorePage = (_: IComPropsRegisteredToSlot) => {
       setError(null);
 
       try {
-        await install(id);
-        await refreshList();
+        const success = await install(id);
+        if (success) {
+          await refreshList();
+        } else {
+          notificationService.notify({
+            level: 'error',
+            message: `安装插件失败，依赖缺失或其他错误`,
+          });
+        }
       } catch (err) {
-        setError(err instanceof Error ? err : new Error('安装失败'));
+        notificationService.notify({
+          level: 'error',
+          message: `安装插件失败: ${err instanceof Error ? err.message : String(err)}`,
+        });
       } finally {
         setLoading(false);
       }
     },
-    [install, refreshList, setLoading]
+    [install, refreshList, setLoading, notificationService]
   );
 
   const handleUninstall = useCallback(
@@ -125,7 +137,14 @@ export const StorePage = (_: IComPropsRegisteredToSlot) => {
       return (
         <>
           <Table.Cell>{plugin.name}</Table.Cell>
-          <Table.Cell>{plugin.description}</Table.Cell>
+          <Table.Cell>
+            {plugin.description}
+            {plugin.dependencies && plugin.dependencies.length > 0 && (
+              <div className="mt-4 text-xs text-content-secondary">
+                {pluginDepDescForHuman(plugin, get)}
+              </div>
+            )}
+          </Table.Cell>
           <Table.Cell style={{ textAlign: 'right' }}>
             {pluginInstalled ? (
               <Button
@@ -144,7 +163,7 @@ export const StorePage = (_: IComPropsRegisteredToSlot) => {
         </>
       );
     },
-    [plugins, isInstalled, handleInstall, handleUninstall]
+    [plugins, isInstalled, get, handleUninstall, handleInstall]
   );
 
   if (error) {

package/src/plugins/store/context/index.ts

@@ -1,12 +1,15 @@
 import { createPluginCtx } from '#/core/context';
+import { NotificationService } from '#/plugins/notification/services/NotificationService';
 import { IPluginStoreEntry, PluginID } from '#/types/plugin';
 
 export interface IStoreCtx {
-  install: (pid: PluginID) => Promise<void>;
+  install: (pid: PluginID) => Promise<boolean>;
   uninstall: (pid: PluginID) => Promise<void>;
   isInstalled: (pid: PluginID) => boolean;
   list: () => Promise<Array<IPluginStoreEntry>> | Array<IPluginStoreEntry>;
+  get: (pid: PluginID) => IPluginStoreEntry | undefined;
   setLoading: (loading: boolean) => void;
+  notificationService: NotificationService | Record<string, never>;
 }
 
 export const StoreCtx = createPluginCtx<IStoreCtx>();

package/src/plugins/store/index.ts

@@ -1,7 +1,6 @@
-import { BBPlugin } from '#/core/bbplugin';
+import { BBPlugin } from '#/core/plugin-system/bbplugin';
 import { IHostContext } from '#/types/hostApi';
 import { PluginID } from '#/types/plugin';
-import { buildEntryCreator } from '#/utils';
 
 import { StorePage } from './components/storePage';
 import { StoreCtx } from './context';
@@ -9,24 +8,37 @@ import { StoreCtx } from './context';
 export class StorePlugin extends BBPlugin {
   id: PluginID = 'store';
   override onInstall = async (ctx: IHostContext): Promise<void> => {
-    const entryCreator = buildEntryCreator(ctx);
-    entryCreator(
+    const coreService = ctx.service.get('core:baseService');
+    if (!coreService) {
+      console.error('Core service not found. StorePlugin installation failed.');
+      return;
+    }
+
+    const systemUIService = ctx.service.get('core:uiService');
+    if (!systemUIService) {
+      console.error('UI service not found. StorePlugin installation failed.');
+      return;
+    }
+
+    systemUIService.registerPluginEntry(
       {
         path: '/store',
         label: 'cd ./store',
         pageComponent: StoreCtx.withCtx(
           {
-            install: ctx.store?.installPlugin || (async () => {}),
+            install: ctx.store?.installPlugin || (async () => false),
             uninstall: ctx.store?.disablePlugin || (async () => {}),
             isInstalled: ctx.store?.isPluginInstalled || ((_: PluginID) => false),
+            get: ctx.store?.getPlugin || ((_: PluginID) => undefined),
             list: async () => {
-              ctx.api.setLoading('store', true);
+              coreService.setLoading('store', true);
               const all = Array.from((await ctx.store?.getAllPlugins()) || []);
-              ctx.api.setLoading('store', false);
+              coreService.setLoading('store', false);
               return all.filter(({ id }) => id !== this.id);
             },
+            notificationService: ctx.service.get('notification'),
             setLoading: (loading: boolean) => {
-              ctx.api.setLoading('store', loading);
+              coreService.setLoading('store', loading);
             },
           },
           StorePage

package/src/plugins/store/utils/index.ts

@@ -0,0 +1,26 @@
+import { IPluginStoreEntry, PluginID } from '#/types/plugin';
+
+export const pluginDepDescForHuman = (
+  plugin: IPluginStoreEntry,
+  infoGetter: (id: PluginID) => IPluginStoreEntry | undefined
+): string => {
+  if (!plugin.dependencies || plugin.dependencies.length === 0) {
+    return '';
+  }
+
+  const desc =
+    plugin.dependencies && plugin.dependencies.length > 0
+      ? plugin.dependencies
+          .map(dep => {
+            const depPlugin = infoGetter(dep);
+            return depPlugin ? depPlugin.name : dep;
+          })
+          .join(', ')
+      : '';
+
+  if (!desc) {
+    return '';
+  }
+
+  return `需要先安装${desc}。`;
+};