@jingyi0605/codingns 0.9.0 → 0.9.6

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,12 +396,17 @@ 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]
-                    : normalizedSelectedTagPaths.length > 0
-                        ? normalizedSelectedTagPaths
-                        : (input.selectedTagPath?.trim() ? [input.selectedTagPath.trim()] : []);
+                const tagPaths = selectedFavorite?.kind === "tag_filter"
+                    ? normalizeSelectedTagPaths(selectedFavorite.tagPaths ?? selectedFavorite.path.split("|"))
+                    : selectedFavorite?.kind === "tag"
+                        ? [selectedFavorite.path]
+                        : normalizedSelectedTagPaths.length > 0
+                            ? normalizedSelectedTagPaths
+                            : (input.selectedTagPath?.trim() ? [input.selectedTagPath.trim()] : []);
                 return tagPaths.length === 0 || tagPaths.every((tagPath) => matchesTagPath(document, tagPath));
             }
             const folderPath = selectedFavorite?.kind === "folder"
@@ -366,6 +425,7 @@ export class AffairsLibraryService {
         });
         return {
             total: filtered.length,
+            visibleEntryTotal: filtered.length,
             offset,
             limit,
             items,
@@ -409,7 +469,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 +496,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 +516,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 +539,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 +549,8 @@ export class AffairsLibraryService {
             }
         });
         return {
-            total: items.length,
+            total: filteredItems.length,
+            visibleEntryTotal,
             offset: input.offset,
             limit: input.limit,
             items: resultItems,
@@ -574,6 +643,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 +668,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 +704,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 +713,7 @@ export class AffairsLibraryService {
             enabled: currentSetting?.enabled ?? false,
             favoritesJson: JSON.stringify(normalizedFavorites),
             lastWorkspaceId: workspaceId,
+            dashboardStateJson: currentSetting?.dashboardStateJson ?? "{}",
             createdAt: currentSetting?.createdAt ?? nowIso(),
             updatedAt: nowIso()
         });
@@ -832,13 +904,18 @@ export class AffairsLibraryService {
             };
         }
         if (opType === "delete") {
+            const refreshTargetPath = source.stats?.isDirectory()
+                ? source.relativePath
+                : getParentFolderPath(source.relativePath);
+            const deletedPath = source.relativePath;
             if (source.stats?.isDirectory()) {
                 fs.rmSync(source.absolutePath, { recursive: true, force: false });
             }
             else {
                 fs.rmSync(source.absolutePath, { force: false });
             }
-            this.afterFileMutation(workspaceId, source.rootDir, `library_delete:${source.relativePath}`, source.relativePath);
+            this.removePathFromHotDirectoryCache(workspaceId, source.rootDir, deletedPath);
+            this.afterFileMutation(workspaceId, source.rootDir, `library_delete:${source.relativePath}`, source.relativePath, { refreshTargetPath });
             return {
                 success: true,
                 opType,
@@ -974,9 +1051,9 @@ export class AffairsLibraryService {
             });
         }
     }
-    afterFileMutation(workspaceId, rootDir, reason, targetPath) {
+    afterFileMutation(workspaceId, rootDir, reason, targetPath, options = {}) {
         this.invalidateExportCache(rootDir);
-        this.scheduleAutoRefresh(workspaceId, reason, normalizeMutationRefreshTarget(targetPath) ?? undefined);
+        this.scheduleAutoRefresh(workspaceId, reason, normalizeMutationRefreshTarget(options.refreshTargetPath ?? targetPath) ?? undefined);
     }
     requestRefresh(workspaceId, userId, reason) {
         const binding = this.requireBinding(workspaceId, userId);
@@ -1086,7 +1163,9 @@ export class AffairsLibraryService {
         if (relativePath === ".ai-index" || relativePath.startsWith(".ai-index/")) {
             return;
         }
-        const targetPath = normalizeMutationRefreshTarget(relativePath);
+        const targetPath = normalizeMutationRefreshTarget(input.kind === "delete"
+            ? getParentFolderPath(relativePath)
+            : relativePath);
         if (!targetPath) {
             return;
         }
@@ -1581,6 +1660,7 @@ export class AffairsLibraryService {
             rootDir,
             directoryPath: normalizedDirectoryPath,
             items: [],
+            childDirectoryCount: 0,
             updatedAtMs: 0,
             source: "snapshot",
             dirty: true,
@@ -1598,10 +1678,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;
@@ -1635,6 +1716,38 @@ export class AffairsLibraryService {
         entry.staleReason = null;
         this.ensureDirectoryWindow(workspaceId, rootDir, directoryPath);
     }
+    removePathFromHotDirectoryCache(workspaceId, rootDir, targetPath) {
+        const normalizedTargetPath = normalizeMutationRefreshTarget(targetPath);
+        if (!normalizedTargetPath) {
+            return;
+        }
+        const deletedDirectoryPath = normalizeFolderPath(normalizedTargetPath);
+        const parentDirectoryPath = normalizeFolderPath(getParentFolderPath(normalizedTargetPath));
+        for (const entry of this.hotDirectoryCache.values()) {
+            if (entry.workspaceId !== workspaceId || entry.rootDir !== rootDir) {
+                continue;
+            }
+            const normalizedEntryDirectoryPath = normalizeFolderPath(entry.directoryPath);
+            const beforeCount = entry.items.length;
+            entry.items = entry.items.filter((item) => {
+                const itemPath = normalizeMutationRefreshTarget(item.path);
+                if (!itemPath) {
+                    return false;
+                }
+                return itemPath !== normalizedTargetPath && !itemPath.startsWith(`${normalizedTargetPath}/`);
+            });
+            if (beforeCount !== entry.items.length
+                || normalizedEntryDirectoryPath === parentDirectoryPath
+                || normalizedEntryDirectoryPath === deletedDirectoryPath
+                || normalizedEntryDirectoryPath.startsWith(`${deletedDirectoryPath}/`)) {
+                entry.dirty = true;
+                entry.status = entry.status === "running" ? "running" : "idle";
+                entry.pendingHintReasons.add(`library_delete:${normalizedTargetPath}`);
+                entry.lastHintAt = nowIso();
+                entry.staleReason = null;
+            }
+        }
+    }
     ensureDirectoryWindow(workspaceId, rootDir, directoryPath) {
         const entry = this.getOrCreateHotDirectoryEntry(workspaceId, rootDir, directoryPath);
         entry.updatedAtMs = Math.max(entry.updatedAtMs, Date.now());
@@ -1721,6 +1834,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 +1856,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,
@@ -1804,11 +1918,14 @@ export class AffairsLibraryService {
             }
             return parsed
                 .filter((item) => Boolean(item) && typeof item === "object")
-                .filter((item) => (item.kind === "folder" || item.kind === "tag") && typeof item.path === "string" && item.path.trim())
+                .filter((item) => isAffairsLibraryFavoriteKind(item.kind) && typeof item.path === "string" && item.path.trim())
                 .map((item) => ({
                 kind: item.kind,
                 path: item.path.trim(),
-                label: typeof item.label === "string" && item.label.trim() ? item.label.trim() : item.path.trim()
+                label: typeof item.label === "string" && item.label.trim() ? item.label.trim() : item.path.trim(),
+                ...(item.kind === "tag_filter"
+                    ? { tagPaths: normalizeSelectedTagPaths(Array.isArray(item.tagPaths) ? item.tagPaths : item.path.split("|")) }
+                    : {})
             }));
         }
         catch {
@@ -2735,7 +2852,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 +2905,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 +2918,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 +2928,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 +2937,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 +2968,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) {
@@ -2874,25 +3013,18 @@ export class AffairsLibraryService {
     }
     normalizeFavorites(favorites) {
         return favorites
-            .filter((item) => item && (item.kind === "folder" || item.kind === "tag") && item.path.trim())
+            .filter((item) => item && isAffairsLibraryFavoriteKind(item.kind) && item.path.trim())
             .map((item) => ({
             kind: item.kind,
             path: item.path.trim(),
-            label: item.label.trim() || item.path.trim()
+            label: item.label.trim() || item.path.trim(),
+            ...(item.kind === "tag_filter"
+                ? { tagPaths: normalizeSelectedTagPaths(item.tagPaths ?? item.path.split("|")) }
+                : {})
         }));
     }
     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) {
@@ -3113,7 +3245,7 @@ function resolveAffairsLibraryRelativePath(rootDir, absolutePath) {
     return relativePath;
 }
 function normalizeMutationRefreshTarget(relativePath) {
-    const normalizedPath = relativePath.trim().replace(/^\.\/+/, "").replace(/\/+$/, "");
+    const normalizedPath = relativePath?.trim().replace(/^\.\/+/, "").replace(/\/+$/, "") ?? "";
     return normalizedPath || null;
 }
 function normalizeHintTargetPath(targetPath) {
@@ -3209,16 +3341,38 @@ 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, "");
         return !normalizedPath || documentPath === normalizedPath || documentPath.startsWith(`${normalizedPath}/`);
     }
+    if (favorite.kind === "tag_filter") {
+        const tagPaths = normalizeSelectedTagPaths(favorite.tagPaths ?? favorite.path.split("|"));
+        return tagPaths.length > 0 && tagPaths.every((tagPath) => ([...directTags, ...derivedTags].some((tag) => tag === tagPath || tag.startsWith(`${tagPath}/`))));
+    }
     return [...directTags, ...derivedTags].some((tag) => tag === favorite.path || tag.startsWith(`${favorite.path}/`));
 }
 function buildFavoriteNodeId(kind, pathValue) {
     return `library:favorite:${kind}:${pathValue}`;
 }
+function isAffairsLibraryFavoriteKind(kind) {
+    return kind === "folder" || kind === "tag" || kind === "tag_filter";
+}
 function matchesTagPath(document, tagPath) {
     const normalizedTagPath = tagPath.trim();
     if (!normalizedTagPath) {
@@ -3331,6 +3485,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)
@@ -3339,6 +3531,16 @@ function buildAffairsFolderDocumentsFromFilesystem(rootDir, normalizedFolderPath
     const documentMap = new Map();
     let hasSnapshotData = false;
     let hasLiveData = false;
+    let targetStats = null;
+    if (fs.existsSync(targetDir)) {
+        try {
+            targetStats = fs.statSync(targetDir);
+        }
+        catch {
+            targetStats = null;
+        }
+    }
+    const canVerifyLiveFiles = targetStats?.isDirectory() === true;
     for (const document of exportData?.documents ?? []) {
         if (!matchesDirectFolder(document.path, normalizedFolderPath)) {
             continue;
@@ -3351,6 +3553,9 @@ function buildAffairsFolderDocumentsFromFilesystem(rootDir, normalizedFolderPath
             continue;
         }
         const stat = readAffairsLibraryStatsSafe(rootDir, document.path);
+        if (canVerifyLiveFiles && !stat?.isFile()) {
+            continue;
+        }
         documentMap.set(document.path, {
             ...document,
             createdAt: document.createdAt ?? toIsoOrNull(stat?.birthtime),
@@ -3360,51 +3565,43 @@ function buildAffairsFolderDocumentsFromFilesystem(rootDir, normalizedFolderPath
         });
         hasSnapshotData = true;
     }
-    if (fs.existsSync(targetDir)) {
-        let targetStats = null;
-        try {
-            targetStats = fs.statSync(targetDir);
-        }
-        catch {
-            targetStats = null;
-        }
-        if (targetStats?.isDirectory()) {
-            for (const entry of fs.readdirSync(targetDir, { withFileTypes: true })) {
-                const relativePath = normalizedFolderPath ? `${normalizedFolderPath}/${entry.name}` : entry.name;
-                if ((entry.name.startsWith(".") || hasHiddenPathSegment(relativePath))
-                    && !isIncludedHiddenPath(relativePath, config.includedHiddenPaths)) {
-                    continue;
-                }
-                if (!entry.isFile()) {
-                    continue;
-                }
-                const extension = path.extname(entry.name).toLowerCase();
-                if (!supportedExtensions.has(extension)) {
-                    continue;
-                }
-                if (configuredExtensions.size > 0 && !configuredExtensions.has(extension)) {
-                    continue;
-                }
-                const stat = readAffairsLibraryStatsSafe(rootDir, relativePath);
-                const exported = documentMap.get(relativePath);
-                documentMap.set(relativePath, {
-                    documentId: exported?.documentId ?? relativePath,
-                    path: relativePath,
-                    title: exported?.title?.trim() || path.basename(entry.name, extension) || entry.name,
-                    summary: exported?.summary ?? "",
-                    updatedAt: stat?.mtime.toISOString() ?? exported?.updatedAt ?? "",
-                    createdAt: toIsoOrNull(stat?.birthtime) ?? exported?.createdAt ?? null,
-                    sizeBytes: stat?.size ?? exported?.sizeBytes ?? null,
-                    tags: exported?.tags ?? [],
-                    derivedTags: exported?.derivedTags ?? [],
-                    isFavorite: false
-                });
-                hasLiveData = true;
+    if (targetStats?.isDirectory()) {
+        for (const entry of fs.readdirSync(targetDir, { withFileTypes: true })) {
+            const relativePath = normalizedFolderPath ? `${normalizedFolderPath}/${entry.name}` : entry.name;
+            if ((entry.name.startsWith(".") || hasHiddenPathSegment(relativePath))
+                && !isIncludedHiddenPath(relativePath, config.includedHiddenPaths)) {
+                continue;
             }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const extension = path.extname(entry.name).toLowerCase();
+            if (!supportedExtensions.has(extension)) {
+                continue;
+            }
+            if (configuredExtensions.size > 0 && !configuredExtensions.has(extension)) {
+                continue;
+            }
+            const stat = readAffairsLibraryStatsSafe(rootDir, relativePath);
+            const exported = documentMap.get(relativePath);
+            documentMap.set(relativePath, {
+                documentId: exported?.documentId ?? relativePath,
+                path: relativePath,
+                title: exported?.title?.trim() || path.basename(entry.name, extension) || entry.name,
+                summary: exported?.summary ?? "",
+                updatedAt: stat?.mtime.toISOString() ?? exported?.updatedAt ?? "",
+                createdAt: toIsoOrNull(stat?.birthtime) ?? exported?.createdAt ?? null,
+                sizeBytes: stat?.size ?? exported?.sizeBytes ?? null,
+                tags: exported?.tags ?? [],
+                derivedTags: exported?.derivedTags ?? [],
+                isFavorite: false
+            });
+            hasLiveData = true;
         }
     }
     return {
         items: [...documentMap.values()],
+        childDirectoryCount: countVisibleDirectChildDirectories(targetDir, normalizedFolderPath, config.includedHiddenPaths),
         source: hasLiveData && hasSnapshotData
             ? "mixed"
             : hasLiveData
@@ -3426,6 +3623,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,