plugin-build-guide-block 1.1.5 → 1.1.7

package/dist/server/collections/ai-build-guide-spaces.js

@@ -89,6 +89,26 @@ var ai_build_guide_spaces_default = (0, import_database.defineCollection)({
       name: "buildPhase",
       defaultValue: "idle"
     },
+    {
+      type: "string",
+      name: "buildRunId"
+    },
+    {
+      type: "date",
+      name: "buildQueuedAt"
+    },
+    {
+      type: "date",
+      name: "buildStartedAt"
+    },
+    {
+      type: "date",
+      name: "buildHeartbeatAt"
+    },
+    {
+      type: "string",
+      name: "buildWorkerId"
+    },
     {
       type: "integer",
       name: "pageCount",

package/dist/server/plugin.js

@@ -46,6 +46,7 @@ class PluginBuildGuideBlockServer extends import_server.Plugin {
     await this.db.import({
       directory: (0, import_path.resolve)(__dirname, "collections")
     });
+    await this.ensureSchema();
     this.app.resourceManager.registerActionHandlers({
       "aiBuildGuideSpaces:build": import_build.build,
       "aiBuildGuideSpaces:getHtml": import_getHtml.getHtml,
@@ -66,36 +67,29 @@ class PluginBuildGuideBlockServer extends import_server.Plugin {
         "aiBuildGuidePages:get"
       ]
     });
+    (0, import_build.registerBuildGuideQueue)(this.app);
     this.app.on("afterStart", async () => {
       try {
-        const repo = this.db.getRepository("aiBuildGuideSpaces");
-        await repo.update({
-          filter: { status: "building" },
-          values: {
-            status: "error",
-            buildPhase: "error",
-            buildLog: "Build interrupted by server restart"
-          }
-        });
-        const pageRepo = this.db.getRepository("aiBuildGuidePages");
-        await pageRepo.update({
-          filter: { status: "building" },
-          values: {
-            status: "error",
-            buildLog: "Build interrupted by server restart"
-          }
-        });
+        await (0, import_build.recoverInterruptedBuilds)(this.app);
       } catch (err) {
-        this.app.logger.warn("[plugin-build-guide-block] Failed to recover stale builds", err);
+        this.app.logger.warn("[plugin-build-guide-block] Failed to recover interrupted builds", err);
       }
     });
+    this.app.on("beforeStop", () => {
+      (0, import_build.unregisterBuildGuideQueue)(this.app);
+    });
+    this.app.on("beforeDestroy", () => {
+      (0, import_build.unregisterBuildGuideQueue)(this.app);
+    });
     this.registerAITools();
   }
   registerAITools() {
     var _a;
     const toolsManager = (_a = this.app.aiManager) == null ? void 0 : _a.toolsManager;
     if (!toolsManager) {
-      this.app.logger.warn("[plugin-build-guide-block] aiManager.toolsManager is not available; skipping tool registration");
+      this.app.logger.warn(
+        "[plugin-build-guide-block] aiManager.toolsManager is not available; skipping tool registration"
+      );
       return;
     }
     const tools = [import_tools.searchBuildGuidesTool];
@@ -168,9 +162,17 @@ class PluginBuildGuideBlockServer extends import_server.Plugin {
   }
   async afterEnable() {
   }
+  async beforeDisable() {
+    (0, import_build.unregisterBuildGuideQueue)(this.app);
+  }
   async afterDisable() {
+    (0, import_build.unregisterBuildGuideQueue)(this.app);
+  }
+  async beforeUnload() {
+    (0, import_build.unregisterBuildGuideQueue)(this.app);
   }
   async remove() {
+    (0, import_build.unregisterBuildGuideQueue)(this.app);
   }
 }
 var plugin_default = PluginBuildGuideBlockServer;

package/dist/server/tools/search-guides.js

@@ -30,6 +30,10 @@ __export(search_guides_exports, {
 });
 module.exports = __toCommonJS(search_guides_exports);
 var import_zod = require("zod");
+function getValue(record, key) {
+  var _a;
+  return ((_a = record == null ? void 0 : record.get) == null ? void 0 : _a.call(record, key)) ?? (record == null ? void 0 : record[key]);
+}
 var search_guides_default = {
   groupName: "plugin-build-guide",
   tool: {
@@ -38,57 +42,61 @@ var search_guides_default = {
     description: "Search for available user guides, documentation, or read a specific guide page. Use this to help users find information in the build guide block.",
     execution: "backend",
     schema: import_zod.z.object({
-      action: import_zod.z.enum(["list_spaces", "search_pages", "read_page"]).describe("The action to perform: list_spaces (find available guide books), search_pages (search for pages across all or specific spaces), read_page (read the full content of a specific page)"),
+      action: import_zod.z.enum(["list_spaces", "search_pages", "read_page"]).describe(
+        "The action to perform: list_spaces (find available guide books), search_pages (search for pages across all or specific spaces), read_page (read the full content of a specific page)"
+      ),
       query: import_zod.z.string().optional().describe("Search keyword for finding spaces or pages. Required for search_pages."),
       pageId: import_zod.z.string().optional().describe("The ID of the page to read. Required for read_page.")
     }),
     invoke: async (args, ctx) => {
-      var _a;
       const { action, query, pageId } = args;
       const { db } = ctx.app;
       const spaceRepo = db.getRepository("aiBuildGuideSpaces");
       const pageRepo = db.getRepository("aiBuildGuidePages");
       try {
         if (action === "list_spaces") {
+          const filter = { status: "completed" };
+          if (query) {
+            filter.title = { $iLike: `%${query}%` };
+          }
           const spaces = await spaceRepo.find({
-            filter: query ? { title: { $iLike: `%${query}%` } } : {},
+            filter,
             fields: ["id", "title", "chapterGuidance", "pageCount"],
             limit: 20
           });
           return {
             status: "success",
             content: spaces.map((s) => ({
-              id: s.id,
-              title: s.title,
-              description: s.chapterGuidance,
-              pageCount: s.pageCount
+              id: getValue(s, "id"),
+              title: getValue(s, "title"),
+              description: getValue(s, "chapterGuidance"),
+              pageCount: getValue(s, "pageCount")
             }))
           };
         }
         if (action === "search_pages") {
+          const filter = { status: "completed" };
+          if (query) {
+            filter.$or = [
+              { title: { $iLike: `%${query}%` } },
+              { goal: { $iLike: `%${query}%` } },
+              { generatedMarkdown: { $iLike: `%${query}%` } }
+            ];
+          }
           const pages = await pageRepo.find({
-            filter: query ? {
-              $or: [
-                { title: { $iLike: `%${query}%` } },
-                { goal: { $iLike: `%${query}%` } },
-                { generatedMarkdown: { $iLike: `%${query}%` } }
-              ]
-            } : {},
+            filter,
             fields: ["id", "title", "slug", "goal", "spaceId"],
             limit: 10,
-            appends: ["space(id,title)"]
+            appends: ["space(id,title,status)"]
           });
           return {
             status: "success",
-            content: pages.map((p) => {
-              var _a2;
-              return {
-                id: p.id,
-                title: p.title,
-                goal: p.goal,
-                spaceName: (_a2 = p.space) == null ? void 0 : _a2.title
-              };
-            })
+            content: pages.filter((p) => getValue(getValue(p, "space"), "status") === "completed").map((p) => ({
+              id: getValue(p, "id"),
+              title: getValue(p, "title"),
+              goal: getValue(p, "goal"),
+              spaceName: getValue(getValue(p, "space"), "title")
+            }))
           };
         }
         if (action === "read_page") {
@@ -96,19 +104,22 @@ var search_guides_default = {
             return { status: "error", content: "pageId is required for read_page action" };
           }
           const page = await pageRepo.findById(pageId, {
-            appends: ["space(id,title)"]
+            appends: ["space(id,title,status)"]
           });
           if (!page) {
             return { status: "error", content: `Page with ID ${pageId} not found.` };
           }
+          if (getValue(page, "status") !== "completed" || getValue(getValue(page, "space"), "status") !== "completed") {
+            return { status: "error", content: `Page with ID ${pageId} is not completed.` };
+          }
           return {
             status: "success",
             content: {
-              id: page.id,
-              title: page.title,
-              spaceName: (_a = page.space) == null ? void 0 : _a.title,
-              goal: page.goal,
-              markdown: page.generatedMarkdown
+              id: getValue(page, "id"),
+              title: getValue(page, "title"),
+              spaceName: getValue(getValue(page, "space"), "title"),
+              goal: getValue(page, "goal"),
+              markdown: getValue(page, "generatedMarkdown")
             }
           };
         }

package/package.json

@@ -5,7 +5,7 @@
   "displayName.zh-CN": "构建指南区块",
   "description": "Generate user guides, tutorials and help books from documents using AI, then render the result as a block (HTML or Markdown).",
   "description.vi-VN": "Tạo hướng dẫn người dùng, tutorial và help book từ tài liệu bằng AI, hiển thị kết quả dưới dạng block (HTML hoặc Markdown).",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "license": "Apache-2.0",
   "keywords": [
     "ai",
@@ -21,7 +21,9 @@
     "client.js",
     "server.js",
     "client.d.ts",
-    "server.d.ts"
+    "server.d.ts",
+    "client-v2.js",
+    "client-v2.d.ts"
   ],
   "dependencies": {
     "dompurify": "^3.1.2",
@@ -40,7 +42,9 @@
     "@nocobase/plugin-ai": "2.x",
     "@nocobase/plugin-file-manager": "2.x",
     "@langchain/core": "*",
-    "axios": "*"
+    "axios": "*",
+    "@nocobase/client-v2": "2.x",
+    "@nocobase/flow-engine": "2.x"
   },
   "nocobase": {
     "supportedVersions": [

package/src/client/components/BuildButton.tsx

@@ -5,7 +5,8 @@ import { PlayCircleOutlined } from '@ant-design/icons';
 import { useTranslation } from 'react-i18next';
 
 const POLL_INTERVAL_MS = 3000;
-const MAX_POLL_COUNT = 100; // ~5 minutes max
+const STILL_RUNNING_AFTER_MS = 5 * 60 * 1000;
+const SLOW_POLL_INTERVAL_MS = 10000;
 
 export const BuildButton = () => {
   const [loading, setLoading] = useState(false);
@@ -14,11 +15,11 @@ export const BuildButton = () => {
   const { t } = useTranslation();
   const record = useCollectionRecordData();
   const { refresh } = useDataBlockRequest();
-  const timerRef = useRef<ReturnType<typeof setInterval> | null>(null);
+  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   const stopPolling = useCallback(() => {
     if (timerRef.current) {
-      clearInterval(timerRef.current);
+      clearTimeout(timerRef.current);
       timerRef.current = null;
     }
     setLoading(false);
@@ -36,14 +37,13 @@ export const BuildButton = () => {
       });
       message.success(t('Build started'));
 
-      // Poll until status leaves "building"
-      let pollCount = 0;
-      timerRef.current = setInterval(async () => {
-        pollCount++;
+      const startedAt = Date.now();
+      let stillRunningNotified = false;
+      const poll = async () => {
         try {
           const res = await api.resource('aiBuildGuideSpaces').get({ filterByTk: record.id });
           const status = res?.data?.data?.status;
-          if (status !== 'building' || pollCount >= MAX_POLL_COUNT) {
+          if (status !== 'building') {
             stopPolling();
             refresh?.();
             if (status === 'completed') {
@@ -51,12 +51,23 @@ export const BuildButton = () => {
             } else if (status === 'error') {
               message.error(t('Build failed'));
             }
+            return;
           }
+
+          const elapsed = Date.now() - startedAt;
+          if (elapsed >= STILL_RUNNING_AFTER_MS && !stillRunningNotified) {
+            stillRunningNotified = true;
+            message.info(t('Build is still running'));
+          }
+          const nextPollDelay = elapsed >= STILL_RUNNING_AFTER_MS ? SLOW_POLL_INTERVAL_MS : POLL_INTERVAL_MS;
+          timerRef.current = setTimeout(poll, nextPollDelay);
         } catch {
           stopPolling();
           refresh?.();
         }
-      }, POLL_INTERVAL_MS);
+      };
+
+      timerRef.current = setTimeout(poll, POLL_INTERVAL_MS);
     } catch (err: any) {
       console.error(err);
       message.error(err?.response?.data?.error?.message || t('Build failed'));

package/src/client-v2/plugin.tsx

@@ -0,0 +1,24 @@
+import { Plugin, Application } from '@nocobase/client-v2';
+import React from 'react';
+
+export class PluginBuildGuideBlockClient extends Plugin<Record<string, never>, Application> {
+  async load() {
+    this.pluginSettingsManager.addMenuItem({
+      key: 'ai-build-guide',
+      title: this.t('Build Guide Block'),
+      icon: 'ReadOutlined',
+      aclSnippet: 'pm.ai-build-guide',
+    });
+
+    this.pluginSettingsManager.addPageTabItem({
+      menuKey: 'ai-build-guide',
+      key: 'index',
+      title: this.t('Build Guide Block'),
+      
+      componentLoader: () => import('../client/UserGuideManager').then(m => ({ default: m.UserGuideManager })),
+    });
+
+  }
+}
+
+export default PluginBuildGuideBlockClient;