@jingyi0605/codingns 0.8.5 → 0.9.5

package/dist/server/modules/workspace/affairs-library-controller.d.ts

@@ -0,0 +1,125 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { OnlyOfficeIntegrationService } from "../office/onlyoffice-integration-service.js";
+import type { AffairsLibraryFavoriteRecord, AffairsLibraryOperationType, AffairsLibraryService } from "./affairs-library-service.js";
+import type { AffairsLibraryPreviewLinkService } from "./affairs-library-preview-link-service.js";
+interface WorkspaceParams {
+    workspaceId: string;
+}
+interface SaveAffairsLibraryBindingBody {
+    rootDir?: string;
+}
+interface SaveAffairsLibraryConfigBody {
+    mirrorRoot?: string | null;
+    allowedExtensions?: string[];
+    includedHiddenPaths?: string[];
+    folderOpenBehavior?: "single_click" | "double_click";
+}
+interface SetAffairsLibraryEnabledBody {
+    enabled?: boolean;
+}
+interface RequestAffairsLibraryRefreshBody {
+    reason?: string;
+    targetPath?: string;
+}
+interface UpdateAffairsLibraryFavoritesBody {
+    favorites?: AffairsLibraryFavoriteRecord[];
+}
+interface UpdateAffairsDashboardStateBody {
+    dashboardState?: unknown;
+}
+interface ListAffairsLibraryDocumentsQuery {
+    browseMode?: string;
+    selectedFolderPath?: string;
+    selectedTagPath?: string;
+    selectedTagPaths?: string;
+    selectedFavoriteId?: string;
+    keyword?: string;
+    offset?: string;
+    limit?: string;
+}
+interface ListAffairsLibraryFilesQuery {
+    path?: string;
+    limit?: string;
+}
+interface AffairsLibraryPreviewQuery {
+    path?: string;
+    displayMode?: string;
+}
+interface AffairsLibraryOperationBody {
+    opType?: AffairsLibraryOperationType;
+    srcPath?: string;
+    dstPath?: string | null;
+    content?: string | null;
+    expectedVersion?: string | null;
+}
+export declare class AffairsLibraryController {
+    private readonly affairsLibraryService;
+    private readonly affairsLibraryPreviewLinkService;
+    private readonly onlyOfficeIntegrationService;
+    private readonly onBindingChanged?;
+    constructor(affairsLibraryService: AffairsLibraryService, affairsLibraryPreviewLinkService: AffairsLibraryPreviewLinkService, onlyOfficeIntegrationService: OnlyOfficeIntegrationService, onBindingChanged?: ((workspaceId: string | null) => void) | undefined);
+    readonly getGlobalBinding: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly saveGlobalBinding: (request: FastifyRequest<{
+        Body: SaveAffairsLibraryBindingBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly setGlobalEnabled: (request: FastifyRequest<{
+        Body: SetAffairsLibraryEnabledBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateGlobalFavorites: (request: FastifyRequest<{
+        Body: UpdateAffairsLibraryFavoritesBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getGlobalDashboardState: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly updateGlobalDashboardState: (request: FastifyRequest<{
+        Body: UpdateAffairsDashboardStateBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getBinding: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly saveBinding: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: SaveAffairsLibraryBindingBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly setEnabled: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: SetAffairsLibraryEnabledBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getSnapshot: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getConfig: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly saveConfig: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: SaveAffairsLibraryConfigBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly requestRefresh: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: RequestAffairsLibraryRefreshBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateFavorites: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: UpdateAffairsLibraryFavoritesBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listDocuments: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Querystring: ListAffairsLibraryDocumentsQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listFiles: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Querystring: ListAffairsLibraryFilesQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewDocument: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Querystring: AffairsLibraryPreviewQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly downloadFile: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Querystring: AffairsLibraryPreviewQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly operateFile: (request: FastifyRequest<{
+        Params: WorkspaceParams;
+        Body: AffairsLibraryOperationBody;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};

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

@@ -0,0 +1,175 @@
+import { requireUserId } from "../preferences/common.js";
+import { writeAffairsLibraryDebugLog } from "./affairs-library-debug-log.js";
+export class AffairsLibraryController {
+    affairsLibraryService;
+    affairsLibraryPreviewLinkService;
+    onlyOfficeIntegrationService;
+    onBindingChanged;
+    constructor(affairsLibraryService, affairsLibraryPreviewLinkService, onlyOfficeIntegrationService, onBindingChanged) {
+        this.affairsLibraryService = affairsLibraryService;
+        this.affairsLibraryPreviewLinkService = affairsLibraryPreviewLinkService;
+        this.onlyOfficeIntegrationService = onlyOfficeIntegrationService;
+        this.onBindingChanged = onBindingChanged;
+    }
+    getGlobalBinding = async (request, reply) => {
+        reply.send(this.affairsLibraryService.getGlobalBinding(requireUserId(request)));
+    };
+    saveGlobalBinding = async (request, reply) => {
+        const binding = this.affairsLibraryService.saveGlobalBinding(requireUserId(request), request.body.rootDir?.trim() ?? "");
+        this.onBindingChanged?.(binding.workspaceId);
+        reply.send(binding);
+    };
+    setGlobalEnabled = async (request, reply) => {
+        const binding = this.affairsLibraryService.setGlobalEnabled(requireUserId(request), request.body.enabled === true);
+        this.onBindingChanged?.(binding.workspaceId);
+        reply.send(binding);
+    };
+    updateGlobalFavorites = async (request, reply) => {
+        reply.send({
+            items: this.affairsLibraryService.updateGlobalFavorites(requireUserId(request), Array.isArray(request.body.favorites) ? request.body.favorites : [])
+        });
+    };
+    getGlobalDashboardState = async (request, reply) => {
+        reply.send({
+            dashboardState: this.affairsLibraryService.getGlobalDashboardState(requireUserId(request))
+        });
+    };
+    updateGlobalDashboardState = async (request, reply) => {
+        reply.send({
+            dashboardState: this.affairsLibraryService.updateGlobalDashboardState(requireUserId(request), request.body.dashboardState ?? {})
+        });
+    };
+    getBinding = async (request, reply) => {
+        reply.send(this.affairsLibraryService.getBinding(request.params.workspaceId, requireUserId(request)));
+    };
+    saveBinding = async (request, reply) => {
+        const binding = this.affairsLibraryService.saveBinding(request.params.workspaceId, requireUserId(request), request.body.rootDir?.trim() ?? "");
+        this.onBindingChanged?.(request.params.workspaceId);
+        reply.send(binding);
+    };
+    setEnabled = async (request, reply) => {
+        const binding = this.affairsLibraryService.setEnabled(request.params.workspaceId, requireUserId(request), request.body.enabled === true);
+        this.onBindingChanged?.(request.params.workspaceId);
+        reply.send(binding);
+    };
+    getSnapshot = async (request, reply) => {
+        reply.send(this.affairsLibraryService.getSnapshot(request.params.workspaceId, requireUserId(request)));
+    };
+    getConfig = async (request, reply) => {
+        reply.send(this.affairsLibraryService.getConfig(request.params.workspaceId, requireUserId(request)));
+    };
+    saveConfig = async (request, reply) => {
+        reply.send(this.affairsLibraryService.saveConfig(request.params.workspaceId, requireUserId(request), {
+            mirrorRoot: request.body.mirrorRoot ?? null,
+            allowedExtensions: Array.isArray(request.body.allowedExtensions) ? request.body.allowedExtensions : [],
+            includedHiddenPaths: Array.isArray(request.body.includedHiddenPaths) ? request.body.includedHiddenPaths : [],
+            folderOpenBehavior: request.body.folderOpenBehavior === "single_click" ? "single_click" : "double_click"
+        }));
+    };
+    requestRefresh = async (request, reply) => {
+        const targetPath = request.body.targetPath?.trim() ?? "";
+        if (targetPath) {
+            writeAffairsLibraryDebugLog({
+                event: "directory_hint_requested",
+                processRole: "host",
+                workspaceId: request.params.workspaceId,
+                source: "affairs_library.controller",
+                reason: request.body.reason?.trim() ?? "directory_hint",
+                targetPath,
+                status: "received"
+            });
+            reply.send(this.affairsLibraryService.requestRefreshHint(request.params.workspaceId, requireUserId(request), request.body.reason?.trim() ?? "directory_hint", targetPath));
+            return;
+        }
+        writeAffairsLibraryDebugLog({
+            event: "manual_refresh_requested",
+            processRole: "host",
+            workspaceId: request.params.workspaceId,
+            source: "affairs_library.controller",
+            reason: request.body.reason?.trim() ?? "manual_refresh",
+            status: "received"
+        });
+        reply.send(this.affairsLibraryService.requestRefresh(request.params.workspaceId, requireUserId(request), request.body.reason?.trim() ?? "manual_refresh"));
+    };
+    updateFavorites = async (request, reply) => {
+        reply.send({
+            items: this.affairsLibraryService.updateFavorites(request.params.workspaceId, requireUserId(request), Array.isArray(request.body.favorites) ? request.body.favorites : [])
+        });
+    };
+    listDocuments = async (request, reply) => {
+        reply.send(this.affairsLibraryService.listDocuments(request.params.workspaceId, requireUserId(request), {
+            browseMode: request.query.browseMode === "tag" ? "tag" : "folder",
+            selectedFolderPath: request.query.selectedFolderPath?.trim() ?? null,
+            selectedTagPath: request.query.selectedTagPath?.trim() ?? null,
+            selectedTagPaths: request.query.selectedTagPaths
+                ?.split(",")
+                .map((item) => item.trim())
+                .filter((item) => item.length > 0) ?? null,
+            selectedFavoriteId: request.query.selectedFavoriteId?.trim() ?? null,
+            keyword: request.query.keyword?.trim() ?? null,
+            offset: request.query.offset ? Number(request.query.offset) : undefined,
+            limit: request.query.limit ? Number(request.query.limit) : undefined
+        }));
+    };
+    listFiles = async (request, reply) => {
+        reply.send({
+            items: this.affairsLibraryService.listFiles(request.params.workspaceId, requireUserId(request), request.query.path?.trim() ?? null, request.query.limit ? Number(request.query.limit) : undefined)
+        });
+    };
+    previewDocument = async (request, reply) => {
+        const workspaceId = request.params.workspaceId;
+        const userId = requireUserId(request);
+        const username = request.auth?.user.username ?? userId;
+        const filePath = request.query.path ?? "";
+        const preview = this.affairsLibraryService.previewDocument(workspaceId, userId, filePath);
+        if (preview.supported && (preview.kind === "html" || preview.kind === "image" || preview.kind === "pdf")) {
+            const previewLink = this.affairsLibraryPreviewLinkService.createLink(workspaceId, userId, filePath);
+            preview.previewPath = previewLink.previewPath;
+            preview.previewUrl = buildAbsolutePreviewUrl(request, previewLink.previewPath);
+        }
+        if (preview.supported && preview.kind === "office") {
+            preview.onlyOffice = this.onlyOfficeIntegrationService.buildAffairsPreview({
+                workspaceId,
+                userId,
+                username,
+                filePath,
+                version: preview.version,
+                editable: true,
+                displayMode: normalizeOnlyOfficeDisplayMode(request.query.displayMode)
+            });
+            preview.previewUrl = preview.onlyOffice.documentUrl;
+        }
+        reply.send(preview);
+    };
+    downloadFile = async (request, reply) => {
+        reply.send(this.affairsLibraryService.downloadFile(request.params.workspaceId, requireUserId(request), request.query.path ?? ""));
+    };
+    operateFile = async (request, reply) => {
+        reply.send(this.affairsLibraryService.operateFile(request.params.workspaceId, requireUserId(request), {
+            opType: request.body.opType ?? "delete",
+            srcPath: request.body.srcPath?.trim(),
+            dstPath: request.body.dstPath?.trim() ?? null,
+            content: typeof request.body.content === "string" ? request.body.content : null,
+            expectedVersion: typeof request.body.expectedVersion === "string" ? request.body.expectedVersion : null
+        }));
+    };
+}
+function normalizeOnlyOfficeDisplayMode(value) {
+    return value === "reading" ? "reading" : "default";
+}
+function buildAbsolutePreviewUrl(request, previewPath) {
+    const protocol = resolveRequestProtocol(request);
+    const host = resolveRequestHost(request);
+    return new URL(previewPath, `${protocol}://${host}/`).toString();
+}
+function resolveRequestProtocol(request) {
+    return (request.headers["x-forwarded-proto"]?.split(",")[0]?.trim()
+        || request.protocol
+        || "http");
+}
+function resolveRequestHost(request) {
+    return (request.headers["x-forwarded-host"]?.split(",")[0]?.trim()
+        || request.headers.host
+        || "127.0.0.1");
+}
+//# sourceMappingURL=affairs-library-controller.js.map

package/dist/server/modules/workspace/affairs-library-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affairs-library-controller.js","sourceRoot":"","sources":["../../../../src/modules/workspace/affairs-library-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/workspace/affairs-library-debug-log.d.ts

@@ -0,0 +1,23 @@
+export interface AffairsLibraryDebugPayload {
+    event: string;
+    processRole?: "host" | "helper";
+    workspaceId?: string | null;
+    rootDir?: string | null;
+    taskType?: string | null;
+    taskId?: string | null;
+    command?: string | null;
+    source?: string | null;
+    reason?: string | null;
+    targetPath?: string | null;
+    watchKind?: string | null;
+    eventType?: string | null;
+    message?: string | null;
+    durationMs?: number | null;
+    deduped?: boolean | null;
+    status?: string | null;
+    resultSummary?: Record<string, unknown> | null;
+    details?: Record<string, unknown> | null;
+}
+export declare function writeAffairsLibraryDebugLog(payload: AffairsLibraryDebugPayload): void;
+export declare function getAffairsLibraryDebugLogPath(rootDir?: string | null): string | null;
+export declare function isAffairsLibraryDebugEnabled(rootDir?: string | null): boolean;

package/dist/server/modules/workspace/affairs-library-debug-log.js

@@ -0,0 +1,107 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadRuntimeConfig } from "../affairs-indexer/core/src/config/load-runtime-config.js";
+const DEFAULT_LOG_FILE_NAME = "affairs-library-debug.log";
+const LOG_DIR_ENV_KEY = "CODINGNS_AFFAIRS_DEBUG_LOG_DIR";
+const LOG_LEVEL_ENV_KEY = "DOC_SEMANTIC_INDEX_LOG_LEVEL";
+let ensuredLogDir = null;
+const debugEnabledCache = new Map();
+export function writeAffairsLibraryDebugLog(payload) {
+    const logDir = resolveAffairsLibraryDebugLogDir(payload.rootDir);
+    if (!logDir) {
+        return;
+    }
+    try {
+        if (ensuredLogDir !== logDir) {
+            mkdirSync(logDir, { recursive: true });
+            ensuredLogDir = logDir;
+        }
+        const filePath = path.join(logDir, DEFAULT_LOG_FILE_NAME);
+        const entry = {
+            ts: new Date().toISOString(),
+            pid: process.pid,
+            processRole: payload.processRole ?? "host",
+            logType: "affairs_library_debug",
+            event: payload.event,
+            workspaceId: normalizeString(payload.workspaceId),
+            rootDir: normalizeString(payload.rootDir),
+            taskType: normalizeString(payload.taskType),
+            taskId: normalizeString(payload.taskId),
+            command: normalizeString(payload.command),
+            source: normalizeString(payload.source),
+            reason: normalizeString(payload.reason),
+            targetPath: normalizeString(payload.targetPath),
+            watchKind: normalizeString(payload.watchKind),
+            eventType: normalizeString(payload.eventType),
+            message: normalizeString(payload.message),
+            durationMs: typeof payload.durationMs === "number" ? payload.durationMs : null,
+            deduped: typeof payload.deduped === "boolean" ? payload.deduped : null,
+            status: normalizeString(payload.status),
+            resultSummary: payload.resultSummary ?? null,
+            details: payload.details ?? null,
+        };
+        appendFileSync(filePath, `${JSON.stringify(entry)}\n`, "utf8");
+    }
+    catch {
+        // 调试日志写失败不能反向打断主链路。
+    }
+}
+export function getAffairsLibraryDebugLogPath(rootDir) {
+    const logDir = resolveAffairsLibraryDebugLogDir(rootDir);
+    return logDir ? path.join(logDir, DEFAULT_LOG_FILE_NAME) : null;
+}
+export function isAffairsLibraryDebugEnabled(rootDir) {
+    if (process.env[LOG_LEVEL_ENV_KEY]?.trim() === "debug") {
+        return true;
+    }
+    const normalizedRootDir = normalizeString(rootDir);
+    if (!normalizedRootDir) {
+        return false;
+    }
+    const cached = debugEnabledCache.get(normalizedRootDir);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let enabled = false;
+    try {
+        enabled = loadRuntimeConfig(normalizedRootDir, {
+            args: {
+                rootDir: normalizedRootDir,
+                "root-dir": normalizedRootDir,
+            },
+            env: process.env,
+        }).logLevel === "debug";
+    }
+    catch {
+        enabled = false;
+    }
+    debugEnabledCache.set(normalizedRootDir, enabled);
+    return enabled;
+}
+function resolveAffairsLibraryDebugLogDir(rootDir) {
+    if (!isAffairsLibraryDebugEnabled(rootDir)) {
+        return null;
+    }
+    const explicitDir = process.env[LOG_DIR_ENV_KEY]?.trim();
+    if (explicitDir) {
+        return path.resolve(explicitDir);
+    }
+    if (process.env.NODE_ENV === "test") {
+        return null;
+    }
+    return path.resolve(resolveWorkspaceRepoRoot(), "tmp", "logs");
+}
+function normalizeString(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : null;
+}
+function resolveWorkspaceRepoRoot() {
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    const appRootCandidate = path.resolve(moduleDir, "..", "..", "..");
+    const appRootDir = path.basename(appRootCandidate) === ".build"
+        ? path.dirname(appRootCandidate)
+        : appRootCandidate;
+    return path.resolve(appRootDir, "..", "..");
+}
+//# sourceMappingURL=affairs-library-debug-log.js.map

package/dist/server/modules/workspace/affairs-library-debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affairs-library-debug-log.js","sourceRoot":"","sources":["../../../../src/modules/workspace/affairs-library-debug-log.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/workspace/affairs-library-dirty-watch-service.d.ts

@@ -0,0 +1,52 @@
+export interface AffairsLibraryWatchDirtyEvent {
+    kind: "index" | "config" | "audit";
+    reason: string;
+    targetPath?: string;
+}
+interface AffairsLibraryDirtyWatchLogger {
+    info(bindings: Record<string, unknown>, message: string): void;
+    warn(bindings: Record<string, unknown>, message: string): void;
+}
+interface AffairsLibraryWatchBinding {
+    workspaceId: string | null;
+    rootDir: string | null;
+    enabled: boolean;
+}
+/**
+ * 外部文件自动刷新服务。
+ *
+ * 这一版不再用 chokidar 递归盯整棵资料库，改成每个资料库根目录只挂一个
+ * `fs.watch(..., { recursive: true })`。这样句柄数量跟“资料库数量”相关，
+ * 不再跟目录树规模线性增长。
+ *
+ * 规则：
+ * - 配置文件：继续走专用链路
+ * - 普通文档：走 targeted refresh
+ * - 常见临时文件：直接忽略
+ * - 再补一层低频周期刷新，给外部 watcher 漏事件兜底
+ */
+export declare class AffairsLibraryDirtyWatchService {
+    private readonly listEnabledBindings;
+    private readonly getEnabledBindingByWorkspaceId;
+    private readonly onWorkspaceDirty;
+    private readonly logger;
+    private readonly watchersByWorkspace;
+    private readonly debounceTimers;
+    private readonly pendingDirtyStateByWorkspace;
+    constructor(listEnabledBindings: () => AffairsLibraryWatchBinding[], getEnabledBindingByWorkspaceId: (workspaceId: string) => AffairsLibraryWatchBinding | null, onWorkspaceDirty: (workspaceId: string, event: AffairsLibraryWatchDirtyEvent) => void, logger: AffairsLibraryDirtyWatchLogger);
+    syncAll(): void;
+    syncWorkspace(workspaceId: string): void;
+    dispose(): void;
+    private ensureWorkspaceWatch;
+    private stopWorkspaceWatch;
+    private handleFsWatchEvent;
+    private scheduleWorkspaceRefresh;
+    private flushWorkspaceDirtyState;
+    private shouldIgnorePath;
+    private detectMissingIndexArtifactReason;
+    private resolveEffectiveTargetPath;
+    private normalizeRelativePath;
+    private readIncludedHiddenPaths;
+    private getOrCreatePendingDirtyState;
+}
+export {};