@jingyi0605/codingns 0.1.0

package/dist/server/modules/file/file-access-guard.js

@@ -0,0 +1,99 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError, isAppError } from "../../shared/errors/app-error.js";
+import { normalizeRelativePath, resolveWorkspacePath } from "./path-normalizer.js";
+export class FileAccessGuard {
+    workspaceService;
+    logger;
+    constructor(workspaceService, logger) {
+        this.workspaceService = workspaceService;
+        this.logger = logger;
+    }
+    resolvePath(workspaceId, requestedPath, options = {}) {
+        const workspace = this.workspaceService.getWorkspaceOrThrow(workspaceId);
+        const workspaceRealPath = fs.realpathSync.native(workspace.path);
+        let relativePath = "";
+        try {
+            relativePath = normalizeRelativePath(requestedPath, options.allowRoot ?? false);
+        }
+        catch (error) {
+            if (isAppError(error) && error.errorCode === "PATH_TRAVERSAL_BLOCKED") {
+                this.logger.warn({
+                    workspaceId,
+                    path: requestedPath
+                }, "检测到路径穿越请求");
+            }
+            throw error;
+        }
+        const absolutePath = resolveWorkspacePath(workspace.path, relativePath);
+        const exists = fs.existsSync(absolutePath);
+        let stats = null;
+        if (exists) {
+            const targetRealPath = fs.realpathSync.native(absolutePath);
+            this.ensureInsideWorkspace(workspaceRealPath, targetRealPath, workspaceId, requestedPath);
+            stats = fs.statSync(absolutePath);
+        }
+        else {
+            if (options.mustExist ?? true) {
+                throw new AppError({
+                    statusCode: 404,
+                    errorCode: "FILE_NOT_FOUND",
+                    detail: "指定文件不存在",
+                    field: "path"
+                });
+            }
+            const parentPath = path.dirname(absolutePath);
+            if (!fs.existsSync(parentPath)) {
+                throw new AppError({
+                    statusCode: 400,
+                    errorCode: "PARENT_DIRECTORY_NOT_FOUND",
+                    detail: "目标目录不存在",
+                    field: "path"
+                });
+            }
+            const parentRealPath = fs.realpathSync.native(parentPath);
+            this.ensureInsideWorkspace(workspaceRealPath, parentRealPath, workspaceId, requestedPath);
+        }
+        if (stats && options.kind === "file" && !stats.isFile()) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "NOT_A_FILE",
+                detail: "指定路径不是文件",
+                field: "path"
+            });
+        }
+        if (stats && options.kind === "directory" && !stats.isDirectory()) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "NOT_A_DIRECTORY",
+                detail: "指定路径不是目录",
+                field: "path"
+            });
+        }
+        return {
+            workspace,
+            workspaceRealPath,
+            relativePath,
+            absolutePath,
+            exists,
+            stats
+        };
+    }
+    ensureInsideWorkspace(workspaceRealPath, targetRealPath, workspaceId, requestedPath) {
+        const relative = path.relative(workspaceRealPath, targetRealPath);
+        if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+            this.logger.warn({
+                workspaceId,
+                path: requestedPath,
+                targetRealPath
+            }, "检测到工作区越界访问");
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "PATH_OUT_OF_WORKSPACE",
+                detail: "文件路径超出工作区边界",
+                field: "path"
+            });
+        }
+    }
+}
+//# sourceMappingURL=file-access-guard.js.map

package/dist/server/modules/file/file-access-guard.js.map

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

package/dist/server/modules/file/file-constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MAX_TEXT_FILE_BYTES: number;
+export declare const MAX_PREVIEW_FILE_BYTES: number;
+export declare const DEFAULT_TREE_LIMIT = 200;
+export declare const DEFAULT_SEARCH_PAGE = 1;
+export declare const DEFAULT_SEARCH_PAGE_SIZE = 20;
+export declare const MAX_SEARCH_PAGE_SIZE = 100;

package/dist/server/modules/file/file-constants.js

@@ -0,0 +1,7 @@
+export const MAX_TEXT_FILE_BYTES = 256 * 1024;
+export const MAX_PREVIEW_FILE_BYTES = 512 * 1024;
+export const DEFAULT_TREE_LIMIT = 200;
+export const DEFAULT_SEARCH_PAGE = 1;
+export const DEFAULT_SEARCH_PAGE_SIZE = 20;
+export const MAX_SEARCH_PAGE_SIZE = 100;
+//# sourceMappingURL=file-constants.js.map

package/dist/server/modules/file/file-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-constants.js","sourceRoot":"","sources":["../../../../src/modules/file/file-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC"}

package/dist/server/modules/file/file-content-service.d.ts

@@ -0,0 +1,65 @@
+import type { FileSnapshot } from "../../types/domain.js";
+import type { FileContextBindingRepository } from "../../storage/repositories/file-context-binding-repository.js";
+import type { RecentFileService } from "./recent-file-service.js";
+import type { FileAccessGuard } from "./file-access-guard.js";
+import { FileVersionChecker } from "./file-version-checker.js";
+export type FileOperationType = "create_file" | "create_directory" | "delete" | "rename" | "move";
+interface ReadFileOptions {
+    recordRecent?: boolean;
+}
+interface SaveFileInput {
+    workspaceId: string;
+    path: string;
+    content: string;
+    expectedVersion?: string;
+    userId: string;
+}
+interface UploadFileInput {
+    workspaceId: string;
+    path: string;
+    contentBase64: string;
+    userId: string;
+}
+interface DownloadFileResult {
+    workspaceId: string;
+    path: string;
+    fileName: string;
+    contentBase64: string;
+    size: number;
+    updatedAt: string;
+}
+interface FileOperationInput {
+    workspaceId: string;
+    opType: FileOperationType;
+    srcPath?: string;
+    dstPath?: string;
+    content?: string;
+}
+export declare class FileContentService {
+    private readonly fileAccessGuard;
+    private readonly recentFileService;
+    private readonly fileContextBindingRepository;
+    private readonly fileVersionChecker;
+    constructor(fileAccessGuard: FileAccessGuard, recentFileService: RecentFileService, fileContextBindingRepository: FileContextBindingRepository, fileVersionChecker: FileVersionChecker);
+    readFile(workspaceId: string, requestedPath: string, userId: string, options?: ReadFileOptions): FileSnapshot;
+    saveFile(input: SaveFileInput): FileSnapshot;
+    uploadFile(input: UploadFileInput): {
+        workspaceId: string;
+        path: string;
+        size: number;
+        updatedAt: string;
+    };
+    downloadFile(workspaceId: string, requestedPath: string, userId: string): DownloadFileResult;
+    operate(input: FileOperationInput): {
+        success: true;
+        opType: FileOperationType;
+    };
+    private createFile;
+    private createDirectory;
+    private deletePath;
+    private movePath;
+    private readSnapshot;
+    private ensureEditableTextBuffer;
+    private ensureWritableContent;
+}
+export {};

package/dist/server/modules/file/file-content-service.js

@@ -0,0 +1,239 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+import { MAX_TEXT_FILE_BYTES } from "./file-constants.js";
+export class FileContentService {
+    fileAccessGuard;
+    recentFileService;
+    fileContextBindingRepository;
+    fileVersionChecker;
+    constructor(fileAccessGuard, recentFileService, fileContextBindingRepository, fileVersionChecker) {
+        this.fileAccessGuard = fileAccessGuard;
+        this.recentFileService = recentFileService;
+        this.fileContextBindingRepository = fileContextBindingRepository;
+        this.fileVersionChecker = fileVersionChecker;
+    }
+    readFile(workspaceId, requestedPath, userId, options = {}) {
+        const resolved = this.fileAccessGuard.resolvePath(workspaceId, requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const snapshot = this.readSnapshot(resolved);
+        if (options.recordRecent ?? true) {
+            this.recentFileService.recordOpened(workspaceId, userId, snapshot.path);
+        }
+        return snapshot;
+    }
+    saveFile(input) {
+        const resolved = this.fileAccessGuard.resolvePath(input.workspaceId, input.path, {
+            mustExist: true,
+            kind: "file"
+        });
+        const currentBuffer = fs.readFileSync(resolved.absolutePath);
+        const currentVersion = this.fileVersionChecker.create(currentBuffer, fs.statSync(resolved.absolutePath));
+        this.ensureEditableTextBuffer(currentBuffer);
+        this.fileVersionChecker.ensure(input.expectedVersion, currentVersion.version);
+        const nextBuffer = Buffer.from(input.content, "utf8");
+        this.ensureWritableContent(nextBuffer);
+        fs.writeFileSync(resolved.absolutePath, nextBuffer);
+        const snapshot = this.readSnapshot(this.fileAccessGuard.resolvePath(input.workspaceId, input.path, {
+            mustExist: true,
+            kind: "file"
+        }));
+        this.recentFileService.recordOpened(input.workspaceId, input.userId, snapshot.path);
+        return snapshot;
+    }
+    uploadFile(input) {
+        const resolved = this.fileAccessGuard.resolvePath(input.workspaceId, input.path, {
+            mustExist: false
+        });
+        if (resolved.exists) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "FILE_ALREADY_EXISTS",
+                detail: "目标文件已存在",
+                field: "path"
+            });
+        }
+        const buffer = Buffer.from(input.contentBase64, "base64");
+        fs.writeFileSync(resolved.absolutePath, buffer);
+        const stats = fs.statSync(resolved.absolutePath);
+        this.recentFileService.recordOpened(input.workspaceId, input.userId, resolved.relativePath);
+        return {
+            workspaceId: resolved.workspace.id,
+            path: resolved.relativePath,
+            size: buffer.byteLength,
+            updatedAt: stats.mtime.toISOString()
+        };
+    }
+    downloadFile(workspaceId, requestedPath, userId) {
+        const resolved = this.fileAccessGuard.resolvePath(workspaceId, requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const buffer = fs.readFileSync(resolved.absolutePath);
+        const stats = fs.statSync(resolved.absolutePath);
+        this.recentFileService.recordOpened(workspaceId, userId, resolved.relativePath);
+        return {
+            workspaceId: resolved.workspace.id,
+            path: resolved.relativePath,
+            fileName: path.basename(resolved.relativePath) || resolved.relativePath,
+            contentBase64: buffer.toString("base64"),
+            size: buffer.byteLength,
+            updatedAt: stats.mtime.toISOString()
+        };
+    }
+    operate(input) {
+        switch (input.opType) {
+            case "create_file":
+                this.createFile(input.workspaceId, input.dstPath, input.content ?? "");
+                break;
+            case "create_directory":
+                this.createDirectory(input.workspaceId, input.dstPath);
+                break;
+            case "delete":
+                this.deletePath(input.workspaceId, input.srcPath);
+                break;
+            case "rename":
+            case "move":
+                this.movePath(input.workspaceId, input.srcPath, input.dstPath);
+                break;
+            default:
+                throw new AppError({
+                    statusCode: 400,
+                    errorCode: "INVALID_FILE_OPERATION",
+                    detail: "不支持的文件操作类型",
+                    field: "opType"
+                });
+        }
+        return {
+            success: true,
+            opType: input.opType
+        };
+    }
+    createFile(workspaceId, targetPath, content) {
+        const resolved = this.fileAccessGuard.resolvePath(workspaceId, targetPath, {
+            mustExist: false
+        });
+        if (resolved.exists) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "FILE_ALREADY_EXISTS",
+                detail: "目标文件已存在",
+                field: "dstPath"
+            });
+        }
+        const buffer = Buffer.from(content, "utf8");
+        this.ensureWritableContent(buffer);
+        fs.writeFileSync(resolved.absolutePath, buffer);
+    }
+    createDirectory(workspaceId, targetPath) {
+        const resolved = this.fileAccessGuard.resolvePath(workspaceId, targetPath, {
+            mustExist: false
+        });
+        if (resolved.exists) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "FILE_ALREADY_EXISTS",
+                detail: "目标目录已存在",
+                field: "dstPath"
+            });
+        }
+        fs.mkdirSync(resolved.absolutePath);
+    }
+    deletePath(workspaceId, sourcePath) {
+        const resolved = this.fileAccessGuard.resolvePath(workspaceId, sourcePath, {
+            mustExist: true,
+            kind: "any"
+        });
+        if (resolved.stats?.isDirectory()) {
+            fs.rmSync(resolved.absolutePath, { recursive: true, force: false });
+        }
+        else {
+            fs.rmSync(resolved.absolutePath, { force: false });
+        }
+        this.recentFileService.deleteByPath(workspaceId, resolved.relativePath);
+        this.fileContextBindingRepository.deleteByPath(workspaceId, resolved.relativePath);
+    }
+    movePath(workspaceId, sourcePath, targetPath) {
+        const source = this.fileAccessGuard.resolvePath(workspaceId, sourcePath, {
+            mustExist: true,
+            kind: "any"
+        });
+        const target = this.fileAccessGuard.resolvePath(workspaceId, targetPath, {
+            mustExist: false,
+            kind: "any"
+        });
+        if (target.exists) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "FILE_ALREADY_EXISTS",
+                detail: "目标路径已存在",
+                field: "dstPath"
+            });
+        }
+        if (source.relativePath === target.relativePath) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_FILE_OPERATION",
+                detail: "源路径和目标路径不能相同",
+                field: "dstPath"
+            });
+        }
+        fs.renameSync(source.absolutePath, target.absolutePath);
+        try {
+            this.recentFileService.renamePath(workspaceId, source.relativePath, target.relativePath);
+            this.fileContextBindingRepository.renamePath(workspaceId, source.relativePath, target.relativePath);
+        }
+        catch (error) {
+            fs.renameSync(target.absolutePath, source.absolutePath);
+            throw error;
+        }
+    }
+    readSnapshot(resolved) {
+        const buffer = fs.readFileSync(resolved.absolutePath);
+        this.ensureEditableTextBuffer(buffer);
+        const version = this.fileVersionChecker.create(buffer, fs.statSync(resolved.absolutePath));
+        return {
+            workspaceId: resolved.workspace.id,
+            path: resolved.relativePath,
+            content: buffer.toString("utf8"),
+            encoding: "utf-8",
+            version: version.version,
+            size: version.size,
+            updatedAt: version.updatedAt
+        };
+    }
+    ensureEditableTextBuffer(buffer) {
+        if (buffer.byteLength > MAX_TEXT_FILE_BYTES) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "FILE_TOO_LARGE",
+                detail: "文件过大，本轮只支持轻量文本编辑",
+                field: "path"
+            });
+        }
+        if (isBinaryBuffer(buffer)) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "BINARY_FILE_NOT_SUPPORTED",
+                detail: "二进制文件暂不支持直接编辑",
+                field: "path"
+            });
+        }
+    }
+    ensureWritableContent(buffer) {
+        if (buffer.byteLength > MAX_TEXT_FILE_BYTES) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_CONTENT",
+                detail: "保存内容超出当前轻量编辑大小限制",
+                field: "content"
+            });
+        }
+    }
+}
+function isBinaryBuffer(buffer) {
+    return buffer.includes(0);
+}
+//# sourceMappingURL=file-content-service.js.map

package/dist/server/modules/file/file-content-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-content-service.js","sourceRoot":"","sources":["../../../../src/modules/file/file-content-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAI5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA0C1D,MAAM,OAAO,kBAAkB;IAEV;IACA;IACA;IACA;IAJnB,YACmB,eAAgC,EAChC,iBAAoC,EACpC,4BAA0D,EAC1D,kBAAsC;QAHtC,oBAAe,GAAf,eAAe,CAAiB;QAChC,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,iCAA4B,GAA5B,4BAA4B,CAA8B;QAC1D,uBAAkB,GAAlB,kBAAkB,CAAoB;IACtD,CAAC;IAEJ,QAAQ,CACN,WAAmB,EACnB,aAAqB,EACrB,MAAc,EACd,UAA2B,EAAE;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,EAAE;YAC5E,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;YAC/E,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QAEzG,IAAI,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAE9E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAChC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;YAC9D,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,MAAM;SACb,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEpF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,UAAU,CAAC,KAAsB;QAM/B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;YAC/E,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,qBAAqB;gBAChC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAE5F,OAAO;YACL,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE;YAClC,IAAI,EAAE,QAAQ,CAAC,YAAY;YAC3B,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;SACrC,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,WAAmB,EAAE,aAAqB,EAAE,MAAc;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,EAAE;YAC5E,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEjD,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEhF,OAAO;YACL,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE;YAClC,IAAI,EAAE,QAAQ,CAAC,YAAY;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,YAAY;YACvE,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACxC,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;SACrC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAyB;QAC/B,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,aAAa;gBAChB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBACvE,MAAM;YACR,KAAK,kBAAkB;gBACrB,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvD,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,MAAM;gBACT,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC/D,MAAM;YACR;gBACE,MAAM,IAAI,QAAQ,CAAC;oBACjB,UAAU,EAAE,GAAG;oBACf,SAAS,EAAE,wBAAwB;oBACnC,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,QAAQ;iBAChB,CAAC,CAAC;QACP,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,WAAmB,EAAE,UAA8B,EAAE,OAAe;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE;YACzE,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,qBAAqB;gBAChC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACnC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAEO,eAAe,CAAC,WAAmB,EAAE,UAA8B;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE;YACzE,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,qBAAqB;gBAChC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAEO,UAAU,CAAC,WAAmB,EAAE,UAA8B;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE;YACzE,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;YAClC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxE,IAAI,CAAC,4BAA4B,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACrF,CAAC;IAEO,QAAQ,CACd,WAAmB,EACnB,UAA8B,EAC9B,UAA8B;QAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE;YACvE,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE;YACvE,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,qBAAqB;gBAChC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,wBAAwB;gBACnC,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACzF,IAAI,CAAC,4BAA4B,CAAC,UAAU,CAC1C,WAAW,EACX,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,YAAY,CACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAA+B;QAClD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEtD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QAE3F,OAAO;YACL,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE;YAClC,IAAI,EAAE,QAAQ,CAAC,YAAY;YAC3B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAChC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACJ,CAAC;IAEO,wBAAwB,CAAC,MAAc;QAC7C,IAAI,MAAM,CAAC,UAAU,GAAG,mBAAmB,EAAE,CAAC;YAC5C,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,gBAAgB;gBAC3B,MAAM,EAAE,kBAAkB;gBAC1B,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,2BAA2B;gBACtC,MAAM,EAAE,eAAe;gBACvB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,MAAc;QAC1C,IAAI,MAAM,CAAC,UAAU,GAAG,mBAAmB,EAAE,CAAC;YAC5C,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,iBAAiB;gBAC5B,MAAM,EAAE,kBAAkB;gBAC1B,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC"}

package/dist/server/modules/file/file-context-controller.d.ts

@@ -0,0 +1,29 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { FileContentService } from "./file-content-service.js";
+import type { FileContextService } from "./file-context-service.js";
+interface SessionParams {
+    sessionId: string;
+    bindingId?: string;
+}
+interface AttachFileContextBody {
+    workspaceId?: string;
+    path?: string;
+    rangeStart?: number;
+    rangeEnd?: number;
+}
+export declare class FileContextController {
+    private readonly fileContentService;
+    private readonly fileContextService;
+    constructor(fileContentService: FileContentService, fileContextService: FileContextService);
+    readonly attach: (request: FastifyRequest<{
+        Params: SessionParams;
+        Body: AttachFileContextBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly list: (request: FastifyRequest<{
+        Params: SessionParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly detach: (request: FastifyRequest<{
+        Params: SessionParams;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};

package/dist/server/modules/file/file-context-controller.js

@@ -0,0 +1,52 @@
+import { AppError } from "../../shared/errors/app-error.js";
+export class FileContextController {
+    fileContentService;
+    fileContextService;
+    constructor(fileContentService, fileContextService) {
+        this.fileContentService = fileContentService;
+        this.fileContextService = fileContextService;
+    }
+    attach = async (request, reply) => {
+        const workspaceId = request.body.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "挂载文件管理必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        const userId = requireUserId(request);
+        const snapshot = this.fileContentService.readFile(workspaceId, request.body.path?.trim() ?? "", userId, {
+            recordRecent: false
+        });
+        reply.status(201).send(await this.fileContextService.attach({
+            sessionId: request.params.sessionId,
+            workspaceId,
+            snapshot,
+            userId,
+            rangeStart: request.body.rangeStart,
+            rangeEnd: request.body.rangeEnd
+        }));
+    };
+    list = async (request, reply) => {
+        reply.send({
+            items: await this.fileContextService.list(request.params.sessionId, requireUserId(request))
+        });
+    };
+    detach = async (request, reply) => {
+        reply.send(await this.fileContextService.detach(request.params.sessionId, request.params.bindingId ?? "", requireUserId(request)));
+    };
+}
+function requireUserId(request) {
+    const userId = request.auth?.user.userId;
+    if (!userId) {
+        throw new AppError({
+            statusCode: 401,
+            errorCode: "UNAUTHORIZED",
+            detail: "当前请求缺少有效登录态"
+        });
+    }
+    return userId;
+}
+//# sourceMappingURL=file-context-controller.js.map

package/dist/server/modules/file/file-context-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-context-controller.js","sourceRoot":"","sources":["../../../../src/modules/file/file-context-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAgB5D,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,kBAAsC,EACtC,kBAAsC;QADtC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IACtD,CAAC;IAEK,MAAM,GAAG,KAAK,EACrB,OAA+E,EAC/E,KAAmB,EACJ,EAAE;QACjB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;QAErD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,wBAAwB;gBAChC,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAC/C,WAAW,EACX,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAC/B,MAAM,EACN;YACE,YAAY,EAAE,KAAK;SACpB,CACF,CAAC;QAEF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CACpB,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;YACnC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACnC,WAAW;YACX,QAAQ;YACR,MAAM;YACN,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;YACnC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;SAChC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;IAEO,IAAI,GAAG,KAAK,EACnB,OAAkD,EAClD,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;SAC5F,CAAC,CAAC;IACL,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAAkD,EAClD,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAClC,OAAO,CAAC,MAAM,CAAC,SAAS,EACxB,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAC9B,aAAa,CAAC,OAAO,CAAC,CACvB,CACF,CAAC;IACJ,CAAC,CAAC;CACH;AAED,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC;YACjB,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/modules/file/file-context-service.d.ts

@@ -0,0 +1,22 @@
+import type { FileContextBinding, FileSnapshot } from "../../types/domain.js";
+import type { FileContextBindingRepository } from "../../storage/repositories/file-context-binding-repository.js";
+import type { SessionHistoryService } from "../sessions/session-history-service.js";
+interface AttachFileContextInput {
+    sessionId: string;
+    workspaceId: string;
+    snapshot: FileSnapshot;
+    userId: string;
+    rangeStart?: number;
+    rangeEnd?: number;
+}
+export declare class FileContextService {
+    private readonly sessionHistoryService;
+    private readonly fileContextBindingRepository;
+    constructor(sessionHistoryService: SessionHistoryService, fileContextBindingRepository: FileContextBindingRepository);
+    attach(input: AttachFileContextInput): Promise<FileContextBinding>;
+    list(sessionId: string, userId: string): Promise<FileContextBinding[]>;
+    detach(sessionId: string, bindingId: string, userId: string): Promise<{
+        success: true;
+    }>;
+}
+export {};

package/dist/server/modules/file/file-context-service.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+import { hashContent } from "../../shared/utils/hash.js";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class FileContextService {
+    sessionHistoryService;
+    fileContextBindingRepository;
+    constructor(sessionHistoryService, fileContextBindingRepository) {
+        this.sessionHistoryService = sessionHistoryService;
+        this.fileContextBindingRepository = fileContextBindingRepository;
+    }
+    async attach(input) {
+        const session = this.sessionHistoryService.getSession(input.sessionId, input.userId);
+        if (session.workspaceId !== input.workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "SESSION_WORKSPACE_MISMATCH",
+                detail: "会话和工作区不匹配，不能附加该文件管理",
+                field: "workspaceId"
+            });
+        }
+        const normalizedRange = normalizeRange(input.snapshot.content, input.rangeStart, input.rangeEnd);
+        const contentForHash = normalizedRange
+            ? selectContentRange(input.snapshot.content, normalizedRange.rangeStart, normalizedRange.rangeEnd)
+            : input.snapshot.content;
+        return this.fileContextBindingRepository.create({
+            id: createId(),
+            sessionId: input.sessionId,
+            workspaceId: input.workspaceId,
+            path: input.snapshot.path,
+            displayName: path.posix.basename(input.snapshot.path),
+            selected: true,
+            pinned: false,
+            rangeStart: normalizedRange?.rangeStart ?? null,
+            rangeEnd: normalizedRange?.rangeEnd ?? null,
+            contentHash: hashContent(contentForHash),
+            fileVersion: input.snapshot.version,
+            attachedBy: input.userId,
+            attachedAt: nowIso()
+        });
+    }
+    async list(sessionId, userId) {
+        this.sessionHistoryService.getSession(sessionId, userId);
+        return this.fileContextBindingRepository.listBySession(sessionId);
+    }
+    async detach(sessionId, bindingId, userId) {
+        this.sessionHistoryService.getSession(sessionId, userId);
+        const binding = this.fileContextBindingRepository.findById(bindingId);
+        if (!binding || binding.sessionId !== sessionId) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "CONTEXT_BINDING_NOT_FOUND",
+                detail: "指定文件管理绑定不存在"
+            });
+        }
+        this.fileContextBindingRepository.delete(bindingId);
+        return {
+            success: true
+        };
+    }
+}
+function normalizeRange(content, rangeStart, rangeEnd) {
+    if (rangeStart == null && rangeEnd == null) {
+        return null;
+    }
+    if (rangeStart == null || rangeEnd == null) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_RANGE",
+            detail: "片段范围必须同时提供起始行和结束行",
+            field: "rangeStart"
+        });
+    }
+    const lines = content.split(/\r?\n/);
+    if (rangeStart < 1 || rangeEnd < rangeStart || rangeEnd > lines.length) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_RANGE",
+            detail: "文件片段范围不合法",
+            field: "rangeStart"
+        });
+    }
+    return { rangeStart, rangeEnd };
+}
+function selectContentRange(content, rangeStart, rangeEnd) {
+    const lines = content.split(/\r?\n/);
+    return lines.slice(rangeStart - 1, rangeEnd).join("\n");
+}
+//# sourceMappingURL=file-context-service.js.map

package/dist/server/modules/file/file-context-service.js.map

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