@jingyi0605/codingns 0.9.0 → 0.9.5

package/dist/server/modules/workspace/affairs-library-service.js

@@ -12,6 +12,7 @@ import { isIncludedHiddenPath, normalizeIncludedHiddenPaths, SUPPORTED_INDEX_EXT
 import { writeAffairsLibraryDebugLog } from "./affairs-library-debug-log.js";
 import { AFFAIRS_LIBRARY_DEBUG_EVENTS, AFFAIRS_LIBRARY_INDEX_DIRTY_REASONS, AFFAIRS_LIBRARY_RECONCILE_REASONS, AFFAIRS_LIBRARY_RECONCILE_SCOPES, AFFAIRS_LIBRARY_RECONCILE_STATUSES } from "./affairs-library-refresh-contract.js";
 import { getSharedTaskHelperPool } from "../tasks/task-helper-pool.js";
+export const AFFAIRS_GLOBAL_WORKSPACE_ID = "affairs-global";
 const DEFAULT_CONFIG_RELATIVE_PATH = ".ai-index/doc-semantic-index.config.json";
 const INDEX_DIR_RELATIVE_PATH = ".ai-index";
 const EXPORT_DIR_RELATIVE_PATH = ".ai-index/exports";
@@ -38,6 +39,32 @@ const SNAPSHOT_CACHE_SCHEMA_VERSION = 2;
 const HOT_DIRECTORY_CACHE_TTL_MS = 10 * 60 * 1000;
 const HOT_DIRECTORY_MAX_PER_WORKSPACE = 3;
 const LIVE_DIRECTORY_SYNC_SCAN_MAX_DOCUMENTS = 200;
+function parseDashboardStateJson(value) {
+    const raw = value?.trim();
+    if (!raw) {
+        return {};
+    }
+    try {
+        return normalizeDashboardStatePayload(JSON.parse(raw));
+    }
+    catch {
+        return {};
+    }
+}
+function normalizeDashboardStatePayload(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "事务工作台配置必须是对象",
+            field: "dashboardState"
+        });
+    }
+    return {
+        ...value,
+        workspaceId: AFFAIRS_GLOBAL_WORKSPACE_ID
+    };
+}
 export class AffairsLibraryService {
     workspaceService;
     workspaceNavigationStateRepository;
@@ -60,8 +87,8 @@ export class AffairsLibraryService {
         this.syncLightweightReconcileTimers();
     }
     getGlobalBinding(userId) {
-        const setting = this.resolveLibrarySetting(userId, null);
-        return this.buildBindingFromSetting(setting, null);
+        const setting = this.resolveLibrarySetting(userId, AFFAIRS_GLOBAL_WORKSPACE_ID);
+        return this.buildBindingFromSetting(setting, AFFAIRS_GLOBAL_WORKSPACE_ID);
     }
     getBinding(workspaceId, userId) {
         const setting = this.resolveLibrarySetting(userId, workspaceId);
@@ -71,21 +98,20 @@ export class AffairsLibraryService {
         const normalizedRootDir = this.normalizeAndValidateBindingRootDir(rootDir);
         const timestamp = nowIso();
         const currentSetting = this.resolveLibrarySetting(userId, null);
-        const workspaceId = this.resolvePreferredWorkspaceId(currentSetting?.lastWorkspaceId ?? null);
+        const workspaceId = AFFAIRS_GLOBAL_WORKSPACE_ID;
         const nextSetting = this.upsertLibrarySetting({
             userId,
             rootDir: normalizedRootDir,
             enabled: true,
             favoritesJson: currentSetting?.favoritesJson ?? "[]",
             lastWorkspaceId: workspaceId ?? currentSetting?.lastWorkspaceId ?? null,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? timestamp,
             updatedAt: timestamp
         });
         this.syncLightweightReconcileTimers();
-        if (workspaceId) {
-            this.scheduleAutoRefresh(workspaceId, "binding_saved");
-        }
-        return this.buildBindingFromSetting(nextSetting, null);
+        this.scheduleAutoRefresh(workspaceId, "binding_saved");
+        return this.buildBindingFromSetting(nextSetting, AFFAIRS_GLOBAL_WORKSPACE_ID);
     }
     setGlobalEnabled(userId, enabled) {
         const currentSetting = this.resolveLibrarySetting(userId, null);
@@ -100,39 +126,61 @@ export class AffairsLibraryService {
         if (enabled) {
             this.assertLibraryRootDir(rootDir);
         }
-        const workspaceId = this.resolvePreferredWorkspaceId(currentSetting?.lastWorkspaceId ?? null);
+        const workspaceId = AFFAIRS_GLOBAL_WORKSPACE_ID;
         const nextSetting = this.upsertLibrarySetting({
             userId,
             rootDir,
             enabled,
             favoritesJson: currentSetting?.favoritesJson ?? "[]",
             lastWorkspaceId: workspaceId ?? currentSetting?.lastWorkspaceId ?? null,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? nowIso(),
             updatedAt: nowIso()
         });
         this.syncLightweightReconcileTimers();
-        if (enabled && workspaceId) {
+        if (enabled) {
             this.scheduleAutoRefresh(workspaceId, "library_enabled");
         }
-        return this.buildBindingFromSetting(nextSetting, null);
+        return this.buildBindingFromSetting(nextSetting, AFFAIRS_GLOBAL_WORKSPACE_ID);
     }
     updateGlobalFavorites(userId, favorites) {
         const currentSetting = this.resolveLibrarySetting(userId, null);
         const normalizedFavorites = this.normalizeFavorites(favorites);
-        const workspaceId = this.resolvePreferredWorkspaceId(currentSetting?.lastWorkspaceId ?? null);
+        const workspaceId = AFFAIRS_GLOBAL_WORKSPACE_ID;
         const nextSetting = this.upsertLibrarySetting({
             userId,
             rootDir: currentSetting?.rootDir ?? null,
             enabled: currentSetting?.enabled ?? false,
             favoritesJson: JSON.stringify(normalizedFavorites),
             lastWorkspaceId: workspaceId ?? currentSetting?.lastWorkspaceId ?? null,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? nowIso(),
             updatedAt: nowIso()
         });
         return normalizedFavorites;
     }
+    getGlobalDashboardState(userId) {
+        const currentSetting = this.resolveLibrarySetting(userId, null);
+        return parseDashboardStateJson(currentSetting?.dashboardStateJson);
+    }
+    updateGlobalDashboardState(userId, dashboardState) {
+        const normalizedState = normalizeDashboardStatePayload(dashboardState);
+        const currentSetting = this.resolveLibrarySetting(userId, null);
+        const timestamp = nowIso();
+        this.upsertLibrarySetting({
+            userId,
+            rootDir: currentSetting?.rootDir ?? null,
+            enabled: currentSetting?.enabled ?? false,
+            favoritesJson: currentSetting?.favoritesJson ?? "[]",
+            lastWorkspaceId: AFFAIRS_GLOBAL_WORKSPACE_ID,
+            dashboardStateJson: JSON.stringify(normalizedState),
+            createdAt: currentSetting?.createdAt ?? timestamp,
+            updatedAt: timestamp
+        });
+        return normalizedState;
+    }
     saveBinding(workspaceId, userId, rootDir) {
-        this.workspaceService.getWorkspaceOrThrow(workspaceId);
+        this.assertWorkspaceIdCanUseLegacyAffairsRoute(workspaceId);
         const normalizedRootDir = this.normalizeAndValidateBindingRootDir(rootDir);
         const timestamp = nowIso();
         const currentSetting = this.resolveLibrarySetting(userId, workspaceId);
@@ -142,6 +190,7 @@ export class AffairsLibraryService {
             enabled: true,
             favoritesJson: currentSetting?.favoritesJson ?? "[]",
             lastWorkspaceId: workspaceId,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? timestamp,
             updatedAt: timestamp
         });
@@ -150,7 +199,7 @@ export class AffairsLibraryService {
         return this.buildBindingFromSetting(nextSetting, workspaceId);
     }
     setEnabled(workspaceId, userId, enabled) {
-        this.workspaceService.getWorkspaceOrThrow(workspaceId);
+        this.assertWorkspaceIdCanUseLegacyAffairsRoute(workspaceId);
         const currentSetting = this.resolveLibrarySetting(userId, workspaceId);
         const rootDir = currentSetting?.rootDir?.trim() ?? "";
         if (!rootDir) {
@@ -169,6 +218,7 @@ export class AffairsLibraryService {
             enabled,
             favoritesJson: currentSetting?.favoritesJson ?? "[]",
             lastWorkspaceId: workspaceId,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? nowIso(),
             updatedAt: nowIso()
         });
@@ -308,6 +358,7 @@ export class AffairsLibraryService {
         if (!binding || !binding.enabled) {
             return {
                 total: 0,
+                visibleEntryTotal: 0,
                 offset: 0,
                 limit: normalizePositiveInt(input.limit, 120, 400),
                 items: [],
@@ -320,12 +371,14 @@ export class AffairsLibraryService {
         const browseMode = input.browseMode === "tag" ? "tag" : "folder";
         const offset = Math.max(0, normalizePositiveInt(input.offset, 0, Number.MAX_SAFE_INTEGER));
         const limit = normalizePositiveInt(input.limit, 120, 400);
+        const normalizedKeyword = normalizeDocumentSearchKeyword(input.keyword);
         const indexStatus = this.readIndexStatus(workspaceId, binding);
         const selectedFavorite = favorites.find((item) => buildFavoriteNodeId(item.kind, item.path) === (input.selectedFavoriteId?.trim() ?? "")) ?? null;
         const normalizedSelectedTagPaths = normalizeSelectedTagPaths(input.selectedTagPaths);
         if (browseMode === "folder") {
             return this.listLiveFolderDocuments(workspaceId, binding.rootDir, favorites, exportData, selectedFavorite, {
                 selectedFolderPath: input.selectedFolderPath,
+                keyword: normalizedKeyword,
                 offset,
                 limit,
                 indexStatus
@@ -334,6 +387,7 @@ export class AffairsLibraryService {
         if (!exportData) {
             return {
                 total: 0,
+                visibleEntryTotal: 0,
                 offset,
                 limit,
                 items: [],
@@ -342,6 +396,9 @@ export class AffairsLibraryService {
             };
         }
         const filtered = exportData.documents.filter((document) => {
+            if (!matchesDocumentKeyword(document, normalizedKeyword)) {
+                return false;
+            }
             if (browseMode === "tag") {
                 const tagPaths = selectedFavorite?.kind === "tag"
                     ? [selectedFavorite.path]
@@ -366,6 +423,7 @@ export class AffairsLibraryService {
         });
         return {
             total: filtered.length,
+            visibleEntryTotal: filtered.length,
             offset,
             limit,
             items,
@@ -409,7 +467,7 @@ export class AffairsLibraryService {
             ? fallbackResult.source
             : directoryResult.source;
         if (!liveScanDecision.avoidSyncScan) {
-            this.updateHotDirectoryCache(workspaceId, rootDir, normalizedDirectoryPath, items, directoryResult.source, {
+            this.updateHotDirectoryCache(workspaceId, rootDir, normalizedDirectoryPath, items, directoryResult.childDirectoryCount, directoryResult.source, {
                 preserveStatus: directoryStatus.state === "running" || directoryStatus.state === "queued"
                     || directoryStatus.state === "queue_timeout",
                 generatedAt: directoryResult.generatedAt,
@@ -436,6 +494,7 @@ export class AffairsLibraryService {
         else {
             const fallbackEntry = this.getOrCreateHotDirectoryEntry(workspaceId, rootDir, normalizedDirectoryPath);
             fallbackEntry.items = directoryResult.items;
+            fallbackEntry.childDirectoryCount = directoryResult.childDirectoryCount;
             fallbackEntry.source = directoryResult.source;
             fallbackEntry.generatedAt = directoryResult.generatedAt;
             fallbackEntry.filesystemObservedAt = directoryResult.filesystemObservedAt;
@@ -455,7 +514,12 @@ export class AffairsLibraryService {
             && directoryStatus.state !== "queued") {
             this.scheduleDirectoryHintRefresh(workspaceId, normalizedDirectoryPath, "large_directory_live_scan");
         }
-        const resultItems = items.slice(input.offset, input.offset + input.limit);
+        const keyword = input.keyword?.trim() ?? "";
+        const filteredItems = keyword
+            ? items.filter((item) => matchesDocumentKeyword(item, keyword))
+            : items;
+        const resultItems = filteredItems.slice(input.offset, input.offset + input.limit);
+        const visibleEntryTotal = directoryResult.childDirectoryCount + filteredItems.length;
         writeAffairsLibraryDebugLog({
             event: "folder_list_served",
             processRole: "host",
@@ -473,7 +537,9 @@ export class AffairsLibraryService {
                 generatedAt: directoryResult.generatedAt,
                 filesystemObservedAt: directoryResult.filesystemObservedAt,
                 estimatedDocumentCount: liveScanDecision.estimatedDocumentCount,
-                total: items.length,
+                total: filteredItems.length,
+                visibleEntryTotal,
+                childDirectoryCount: directoryResult.childDirectoryCount,
                 returned: resultItems.length,
                 offset: input.offset,
                 limit: input.limit,
@@ -481,7 +547,8 @@ export class AffairsLibraryService {
             }
         });
         return {
-            total: items.length,
+            total: filteredItems.length,
+            visibleEntryTotal,
             offset: input.offset,
             limit: input.limit,
             items: resultItems,
@@ -574,6 +641,7 @@ export class AffairsLibraryService {
         if (cached && cached.items.length > 0) {
             return {
                 items: cached.items,
+                childDirectoryCount: cached.childDirectoryCount,
                 source: staleReason ? "stale_fallback" : cached.source,
                 generatedAt: cached.generatedAt,
                 filesystemObservedAt: cached.filesystemObservedAt,
@@ -598,6 +666,7 @@ export class AffairsLibraryService {
         }));
         return {
             items,
+            childDirectoryCount: countDirectChildFoldersFromSnapshot(normalizedFolderPath, exportData),
             source: directoryStatus?.source ?? "snapshot",
             generatedAt: exportData?.generatedAt ?? directoryStatus?.generatedAt ?? null,
             filesystemObservedAt: directoryStatus?.filesystemObservedAt ?? null,
@@ -633,7 +702,7 @@ export class AffairsLibraryService {
         });
     }
     updateFavorites(workspaceId, userId, favorites) {
-        this.workspaceService.getWorkspaceOrThrow(workspaceId);
+        this.assertWorkspaceIdCanUseLegacyAffairsRoute(workspaceId);
         const currentSetting = this.resolveLibrarySetting(userId, workspaceId);
         const normalizedFavorites = this.normalizeFavorites(favorites);
         const nextSetting = this.upsertLibrarySetting({
@@ -642,6 +711,7 @@ export class AffairsLibraryService {
             enabled: currentSetting?.enabled ?? false,
             favoritesJson: JSON.stringify(normalizedFavorites),
             lastWorkspaceId: workspaceId,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? nowIso(),
             updatedAt: nowIso()
         });
@@ -1581,6 +1651,7 @@ export class AffairsLibraryService {
             rootDir,
             directoryPath: normalizedDirectoryPath,
             items: [],
+            childDirectoryCount: 0,
             updatedAtMs: 0,
             source: "snapshot",
             dirty: true,
@@ -1598,10 +1669,11 @@ export class AffairsLibraryService {
         this.hotDirectoryCache.set(cacheKey, entry);
         return entry;
     }
-    updateHotDirectoryCache(workspaceId, rootDir, directoryPath, items, source, options = {}) {
+    updateHotDirectoryCache(workspaceId, rootDir, directoryPath, items, childDirectoryCount, source, options = {}) {
         const entry = this.getOrCreateHotDirectoryEntry(workspaceId, rootDir, directoryPath);
         entry.rootDir = rootDir;
         entry.items = items;
+        entry.childDirectoryCount = childDirectoryCount;
         entry.updatedAtMs = Date.now();
         entry.source = source;
         entry.lastRefreshRequestedAt = options.requestedAt ?? entry.lastRefreshRequestedAt;
@@ -1721,6 +1793,7 @@ export class AffairsLibraryService {
             refreshedAt: completedAt,
             source: liveResult.source,
             itemCount: liveResult.items.length,
+            childDirectoryCount: liveResult.childDirectoryCount,
             changedPaths,
             items: liveResult.items,
             generatedAt: liveResult.generatedAt,
@@ -1742,7 +1815,7 @@ export class AffairsLibraryService {
             status: "queued"
         });
         void handle.promise.then((result) => {
-            this.updateHotDirectoryCache(workspaceId, meta.rootDir, meta.directoryPath, result.items, result.source, {
+            this.updateHotDirectoryCache(workspaceId, meta.rootDir, meta.directoryPath, result.items, result.childDirectoryCount, result.source, {
                 requestedAt: this.getOrCreateHotDirectoryEntry(workspaceId, meta.rootDir, meta.directoryPath).lastRefreshRequestedAt,
                 completedAt: result.refreshedAt,
                 errorSummary: null,
@@ -2735,7 +2808,9 @@ export class AffairsLibraryService {
         }
         const config = this.readConfig(rootDir);
         return {
-            workspaceId: setting?.lastWorkspaceId ?? fallbackWorkspaceId,
+            workspaceId: fallbackWorkspaceId === AFFAIRS_GLOBAL_WORKSPACE_ID
+                ? AFFAIRS_GLOBAL_WORKSPACE_ID
+                : setting?.lastWorkspaceId ?? fallbackWorkspaceId,
             rootDir,
             enabled: setting?.enabled === true,
             mirrorRoot: config.mirrorRoot,
@@ -2786,7 +2861,8 @@ export class AffairsLibraryService {
             rootDir: legacyRootDir,
             enabled: legacy?.affairsLibraryEnabled === true,
             favoritesJson: legacy?.affairsLibraryFavoritesJson ?? "[]",
-            lastWorkspaceId: legacy?.workspaceId ?? (workspaceScope || null),
+            lastWorkspaceId: AFFAIRS_GLOBAL_WORKSPACE_ID,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? legacy?.updatedAt ?? nowIso(),
             updatedAt: legacy?.updatedAt ?? nowIso()
         });
@@ -2798,7 +2874,8 @@ export class AffairsLibraryService {
             rootDir: record.rootDir?.trim() || null,
             enabled: record.enabled === true,
             favoritesJson: record.favoritesJson ?? null,
-            lastWorkspaceId: record.lastWorkspaceId?.trim() || null,
+            lastWorkspaceId: this.normalizeAffairsWorkspaceId(record.lastWorkspaceId),
+            dashboardStateJson: record.dashboardStateJson?.trim() || "{}",
             createdAt: record.createdAt,
             updatedAt: record.updatedAt
         });
@@ -2807,7 +2884,7 @@ export class AffairsLibraryService {
         if (typeof this.userAffairsLibrarySettingRepository.listEnabled === "function") {
             return this.userAffairsLibrarySettingRepository
                 .listEnabled()
-                .filter((item) => Boolean(item.lastWorkspaceId?.trim() && item.rootDir?.trim()));
+                .filter((item) => Boolean(item.rootDir?.trim()));
         }
         return this.workspaceNavigationStateRepository
             .listEnabledAffairsLibraries()
@@ -2816,19 +2893,26 @@ export class AffairsLibraryService {
             rootDir: item.affairsLibraryRootPath ?? null,
             enabled: item.affairsLibraryEnabled === true,
             favoritesJson: item.affairsLibraryFavoritesJson ?? null,
-            lastWorkspaceId: item.workspaceId,
+            lastWorkspaceId: AFFAIRS_GLOBAL_WORKSPACE_ID,
+            dashboardStateJson: "{}",
             createdAt: item.updatedAt,
             updatedAt: item.updatedAt
         }))
-            .filter((item) => Boolean(item.lastWorkspaceId?.trim() && item.rootDir?.trim()));
+            .filter((item) => Boolean(item.rootDir?.trim()));
     }
     findEnabledBindingByWorkspaceId(workspaceId) {
-        const normalizedWorkspaceId = workspaceId.trim();
-        if (!normalizedWorkspaceId) {
-            return null;
-        }
+        const normalizedWorkspaceId = this.normalizeAffairsWorkspaceId(workspaceId);
         if (typeof this.userAffairsLibrarySettingRepository.findEnabledByWorkspaceId === "function") {
-            return this.userAffairsLibrarySettingRepository.findEnabledByWorkspaceId(normalizedWorkspaceId);
+            const direct = this.userAffairsLibrarySettingRepository.findEnabledByWorkspaceId(normalizedWorkspaceId);
+            if (direct) {
+                return direct;
+            }
+            if (normalizedWorkspaceId === AFFAIRS_GLOBAL_WORKSPACE_ID && typeof this.userAffairsLibrarySettingRepository.listEnabled === "function") {
+                return this.userAffairsLibrarySettingRepository
+                    .listEnabled()
+                    .find((item) => item.rootDir?.trim() && item.enabled === true) ?? null;
+            }
+            return null;
         }
         const legacy = this.workspaceNavigationStateRepository.findAnyEnabledAffairsLibraryByWorkspaceId(normalizedWorkspaceId);
         if (!legacy?.affairsLibraryRootPath?.trim()) {
@@ -2840,10 +2924,21 @@ export class AffairsLibraryService {
             enabled: legacy.affairsLibraryEnabled === true,
             favoritesJson: legacy.affairsLibraryFavoritesJson ?? null,
             lastWorkspaceId: legacy.workspaceId,
+            dashboardStateJson: "{}",
             createdAt: legacy.updatedAt,
             updatedAt: legacy.updatedAt
         };
     }
+    normalizeAffairsWorkspaceId(workspaceId) {
+        return workspaceId?.trim() || AFFAIRS_GLOBAL_WORKSPACE_ID;
+    }
+    assertWorkspaceIdCanUseLegacyAffairsRoute(workspaceId) {
+        const normalizedWorkspaceId = workspaceId.trim();
+        if (!normalizedWorkspaceId || normalizedWorkspaceId === AFFAIRS_GLOBAL_WORKSPACE_ID) {
+            return;
+        }
+        this.workspaceService.getWorkspaceOrThrow(normalizedWorkspaceId);
+    }
     normalizeAndValidateBindingRootDir(rootDir) {
         const normalizedRootDir = rootDir.trim();
         if (!normalizedRootDir) {
@@ -2882,17 +2977,7 @@ export class AffairsLibraryService {
         }));
     }
     resolvePreferredWorkspaceId(preferredWorkspaceId) {
-        const normalizedPreferredWorkspaceId = preferredWorkspaceId?.trim() ?? "";
-        if (normalizedPreferredWorkspaceId) {
-            try {
-                this.workspaceService.getWorkspaceOrThrow(normalizedPreferredWorkspaceId);
-                return normalizedPreferredWorkspaceId;
-            }
-            catch {
-                // 旧的随机 workspaceId 已经失效时，直接降级到当前仍可见的工作区。
-            }
-        }
-        return this.workspaceService.list()[0]?.id ?? null;
+        return this.normalizeAffairsWorkspaceId(preferredWorkspaceId);
     }
     ensureLibraryEnabled(binding) {
         if (binding.enabled) {
@@ -3209,6 +3294,21 @@ function shouldForceFullRebuild(reason) {
         || normalizedReason.includes(AFFAIRS_LIBRARY_INDEX_DIRTY_REASONS.missingExportStatus)
         || normalizedReason.includes(AFFAIRS_LIBRARY_INDEX_DIRTY_REASONS.missingExportManifest);
 }
+function normalizeDocumentSearchKeyword(value) {
+    return value?.trim().toLowerCase() ?? "";
+}
+function matchesDocumentKeyword(document, normalizedKeyword) {
+    if (!normalizedKeyword) {
+        return true;
+    }
+    return [
+        document.title,
+        document.path,
+        document.summary,
+        ...document.tags,
+        ...document.derivedTags
+    ].some((value) => value?.toLowerCase().includes(normalizedKeyword));
+}
 function matchesFavorite(favorite, documentPath, directTags, derivedTags) {
     if (favorite.kind === "folder") {
         const normalizedPath = favorite.path === "." ? "" : favorite.path.replace(/\/+$/g, "");
@@ -3331,6 +3431,44 @@ function readAffairsLibraryConfigSafe(rootDir) {
         folderOpenBehavior: normalizeFolderOpenBehavior(payload.folderOpenBehavior)
     };
 }
+function countDirectChildFoldersFromSnapshot(normalizedFolderPath, exportData) {
+    if (!exportData) {
+        return 0;
+    }
+    const normalizedCurrentPath = normalizeFolderPath(normalizedFolderPath);
+    return exportData.folders.filter((folder) => normalizeFolderPath(folder.parentPath) === normalizedCurrentPath).length;
+}
+function countVisibleDirectChildDirectories(targetDir, normalizedFolderPath, includedHiddenPaths) {
+    if (!fs.existsSync(targetDir)) {
+        return 0;
+    }
+    let stats = null;
+    try {
+        stats = fs.statSync(targetDir);
+    }
+    catch {
+        stats = null;
+    }
+    if (!stats?.isDirectory()) {
+        return 0;
+    }
+    let count = 0;
+    for (const entry of fs.readdirSync(targetDir, { withFileTypes: true })) {
+        if (!entry.isDirectory() || entry.isSymbolicLink()) {
+            continue;
+        }
+        const relativePath = normalizedFolderPath ? `${normalizedFolderPath}/${entry.name}` : entry.name;
+        if (relativePath === '.ai-index' || relativePath.startsWith('.ai-index/')) {
+            continue;
+        }
+        if ((entry.name.startsWith('.') || hasHiddenPathSegment(relativePath))
+            && !isIncludedHiddenPath(relativePath, includedHiddenPaths)) {
+            continue;
+        }
+        count += 1;
+    }
+    return count;
+}
 function buildAffairsFolderDocumentsFromFilesystem(rootDir, normalizedFolderPath, exportData, config, supportedExtensions = new Set(SUPPORTED_INDEX_EXTENSION_LIST)) {
     const targetDir = normalizedFolderPath
         ? path.resolve(rootDir, normalizedFolderPath)
@@ -3405,6 +3543,7 @@ function buildAffairsFolderDocumentsFromFilesystem(rootDir, normalizedFolderPath
     }
     return {
         items: [...documentMap.values()],
+        childDirectoryCount: countVisibleDirectChildDirectories(targetDir, normalizedFolderPath, config.includedHiddenPaths),
         source: hasLiveData && hasSnapshotData
             ? "mixed"
             : hasLiveData
@@ -3426,6 +3565,7 @@ export async function runAffairsLibraryDirectoryHintInHelper(input) {
         refreshedAt: nowIso(),
         source: result.source,
         itemCount: result.items.length,
+        childDirectoryCount: result.childDirectoryCount,
         changedPaths: result.items.map((item) => item.path).sort((left, right) => left.localeCompare(right, "zh-CN")),
         items: result.items,
         generatedAt: result.generatedAt,