@musnows/scriverse 0.2.0 → 0.3.1

package/dist/image-metadata.js

@@ -0,0 +1,128 @@
+export class InvalidRasterImageError extends Error {
+    constructor(message = "图片文件无效") {
+        super(message);
+        this.name = "InvalidRasterImageError";
+    }
+}
+function assertDimensions(width, height) {
+    if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1) {
+        throw new InvalidRasterImageError("图片尺寸无效");
+    }
+    if (width > 4096 || height > 4096 || width * height > 16_777_216) {
+        throw new InvalidRasterImageError("图片尺寸不能超过 4096 × 4096 像素");
+    }
+}
+function readPng(bytes) {
+    const signature = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+    if (bytes.length < signature.length || !bytes.subarray(0, signature.length).equals(signature))
+        return null;
+    if (bytes.length < 33 || bytes.readUInt32BE(8) !== 13 || bytes.subarray(12, 16).toString("ascii") !== "IHDR") {
+        throw new InvalidRasterImageError("PNG 文件缺少有效的 IHDR 数据");
+    }
+    const width = bytes.readUInt32BE(16);
+    const height = bytes.readUInt32BE(20);
+    let offset = 8;
+    let hasEndChunk = false;
+    while (offset + 12 <= bytes.length) {
+        const chunkLength = bytes.readUInt32BE(offset);
+        const chunkEnd = offset + 12 + chunkLength;
+        if (chunkEnd > bytes.length)
+            throw new InvalidRasterImageError("PNG 文件结构不完整");
+        const chunkType = bytes.subarray(offset + 4, offset + 8).toString("ascii");
+        if (chunkType === "IEND") {
+            if (chunkLength !== 0)
+                throw new InvalidRasterImageError("PNG 文件的 IEND 数据无效");
+            hasEndChunk = true;
+            break;
+        }
+        offset = chunkEnd;
+    }
+    if (!hasEndChunk)
+        throw new InvalidRasterImageError("PNG 文件缺少结束标记");
+    assertDimensions(width, height);
+    return { mimeType: "image/png", width, height };
+}
+const jpegStartOfFrameMarkers = new Set([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf]);
+function readJpeg(bytes) {
+    if (bytes.length < 3 || bytes[0] !== 0xff || bytes[1] !== 0xd8 || bytes[2] !== 0xff)
+        return null;
+    if (bytes.length < 4 || bytes[bytes.length - 2] !== 0xff || bytes[bytes.length - 1] !== 0xd9) {
+        throw new InvalidRasterImageError("JPEG 文件结构不完整");
+    }
+    let offset = 2;
+    while (offset + 1 < bytes.length) {
+        while (offset < bytes.length && bytes[offset] === 0xff)
+            offset += 1;
+        if (offset >= bytes.length)
+            break;
+        const marker = bytes[offset];
+        offset += 1;
+        if (marker === 0xd8 || marker === 0xd9 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
+            continue;
+        if (offset + 2 > bytes.length)
+            break;
+        const segmentLength = bytes.readUInt16BE(offset);
+        if (segmentLength < 2 || offset + segmentLength > bytes.length) {
+            throw new InvalidRasterImageError("JPEG 文件段长度无效");
+        }
+        if (jpegStartOfFrameMarkers.has(marker)) {
+            if (segmentLength < 7)
+                throw new InvalidRasterImageError("JPEG 尺寸数据无效");
+            const height = bytes.readUInt16BE(offset + 3);
+            const width = bytes.readUInt16BE(offset + 5);
+            assertDimensions(width, height);
+            return { mimeType: "image/jpeg", width, height };
+        }
+        if (marker === 0xda)
+            break;
+        offset += segmentLength;
+    }
+    throw new InvalidRasterImageError("JPEG 文件缺少尺寸数据");
+}
+function readUInt24LE(bytes, offset) {
+    return bytes[offset] | (bytes[offset + 1] << 8) | (bytes[offset + 2] << 16);
+}
+function readWebp(bytes) {
+    if (bytes.length < 12 || bytes.subarray(0, 4).toString("ascii") !== "RIFF" || bytes.subarray(8, 12).toString("ascii") !== "WEBP")
+        return null;
+    const declaredLength = bytes.readUInt32LE(4) + 8;
+    if (declaredLength > bytes.length || declaredLength < 30)
+        throw new InvalidRasterImageError("WebP 文件结构不完整");
+    const chunkType = bytes.subarray(12, 16).toString("ascii");
+    const chunkLength = bytes.readUInt32LE(16);
+    if (20 + chunkLength > declaredLength)
+        throw new InvalidRasterImageError("WebP 图像块不完整");
+    let width;
+    let height;
+    if (chunkType === "VP8X") {
+        if (chunkLength < 10)
+            throw new InvalidRasterImageError("WebP 扩展头无效");
+        width = readUInt24LE(bytes, 24) + 1;
+        height = readUInt24LE(bytes, 27) + 1;
+    }
+    else if (chunkType === "VP8 ") {
+        if (chunkLength < 10 || bytes[23] !== 0x9d || bytes[24] !== 0x01 || bytes[25] !== 0x2a) {
+            throw new InvalidRasterImageError("WebP 有损图像头无效");
+        }
+        width = bytes.readUInt16LE(26) & 0x3fff;
+        height = bytes.readUInt16LE(28) & 0x3fff;
+    }
+    else if (chunkType === "VP8L") {
+        if (chunkLength < 5 || bytes[20] !== 0x2f)
+            throw new InvalidRasterImageError("WebP 无损图像头无效");
+        width = 1 + bytes[21] + ((bytes[22] & 0x3f) << 8);
+        height = 1 + (bytes[22] >> 6) + (bytes[23] << 2) + ((bytes[24] & 0x0f) << 10);
+    }
+    else {
+        throw new InvalidRasterImageError("WebP 文件缺少受支持的图像块");
+    }
+    assertDimensions(width, height);
+    return { mimeType: "image/webp", width, height };
+}
+export function readRasterImageMetadata(bytes) {
+    const metadata = readPng(bytes) ?? readJpeg(bytes) ?? readWebp(bytes);
+    if (!metadata)
+        throw new InvalidRasterImageError("仅支持 PNG、JPEG 或 WebP 图片");
+    return metadata;
+}
+//# sourceMappingURL=image-metadata.js.map

package/dist/image-metadata.js.map

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

package/dist/import-security.js

@@ -0,0 +1,46 @@
+import { AppError } from "./errors.js";
+const strictUtf8Decoder = new TextDecoder("utf-8", { fatal: true });
+export function decodeUtf8ImportedText(value) {
+    try {
+        return strictUtf8Decoder.decode(value);
+    }
+    catch {
+        throw new AppError(415, "INVALID_TEXT_ENCODING", "TXT 文件必须使用 UTF-8 编码，请转换为 UTF-8 后重新上传");
+    }
+}
+function decodeEntitiesForInspection(value) {
+    const decodeCodePoint = (digits, radix) => {
+        const codePoint = Number.parseInt(digits, radix);
+        return Number.isInteger(codePoint) && codePoint >= 0 && codePoint <= 0x10ffff ? String.fromCodePoint(codePoint) : "";
+    };
+    return value
+        .replace(/&#x([0-9a-f]+);?/giu, (_match, digits) => decodeCodePoint(String(digits), 16))
+        .replace(/&#([0-9]+);?/gu, (_match, digits) => decodeCodePoint(String(digits), 10))
+        .replace(/&colon;/giu, ":")
+        .replace(/&(tab|newline);/giu, " ");
+}
+export function inspectImportedPlainText(value) {
+    const normalized = decodeEntitiesForInspection(String(value ?? "").normalize("NFKC").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/gu, ""));
+    const compact = normalized.replace(/\s+/gu, "");
+    const threats = [];
+    if (/<\s*\/?\s*(script|iframe|object|embed|applet|meta|link|base|svg|math)\b/iu.test(normalized))
+        threats.push({ code: "ACTIVE_HTML_TAG" });
+    if (/<[^>]{0,4000}\bon[a-z][\w:-]*\s*=/iu.test(normalized))
+        threats.push({ code: "EVENT_HANDLER" });
+    if (/<[^>]{0,4000}(javascript|vbscript):/iu.test(compact))
+        threats.push({ code: "SCRIPT_URI" });
+    if (/<[^>]{0,4000}\bsrcdoc\s*=/iu.test(normalized) || /<[^>]{0,4000}data:text\/html/iu.test(compact))
+        threats.push({ code: "EMBEDDED_DOCUMENT" });
+    if (/<[^>]{0,4000}\bstyle\s*=[^>]{0,4000}(expression\s*\(|url\s*\(\s*(javascript|vbscript):)/iu.test(normalized))
+        threats.push({ code: "ACTIVE_CSS" });
+    return threats;
+}
+export function assertSafeImportedPlainText(value) {
+    const threats = inspectImportedPlainText(value);
+    if (threats.length) {
+        throw new AppError(422, "UNSAFE_IMPORT_CONTENT", "导入文件包含可能执行脚本的 HTML 内容，已拒绝导入", {
+            threats: threats.map((threat) => threat.code)
+        });
+    }
+}
+//# sourceMappingURL=import-security.js.map

package/dist/import-security.js.map

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

package/dist/logger.js

@@ -0,0 +1,110 @@
+import { createHash } from "node:crypto";
+import { currentRequestContext } from "./request-context.js";
+const levelPriority = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 100
+};
+const sensitiveField = /^(?:authorization|cookie|setcookie|password|passwordconfirmation|currentpassword|newpassword|secret|mastersecret|token|csrftoken|captchaanswer|apikey|credential|session|sessionid|username|displayname|email|account|userid|encryptedkey|keyiv|keytag)$/iu;
+const sensitiveFieldPart = /(?:password|passwd|secret|authorization|cookie|csrf|captchaanswer|apikey|accesstoken|refreshtoken|sessiontoken|encryptedkey)/iu;
+function scrubString(value) {
+    return value
+        .replace(/\b(?:Bearer|Basic)\s+[A-Za-z0-9+/=_\-.]+/giu, (match) => `${match.split(/\s/u)[0]} [REDACTED]`)
+        .replace(/\bscrv_[A-Za-z0-9_-]+\b/gu, "scrv_[REDACTED]")
+        .replace(/\bsk-[A-Za-z0-9_-]{8,}\b/gu, "sk-[REDACTED]")
+        .replace(/([?&](?:api[_-]?key|access[_-]?token|refresh[_-]?token|token|secret|password)=)[^&\s]+/giu, "$1[REDACTED]")
+        .replace(/(https?:\/\/)[^\s/@:]+:[^\s/@]+@/giu, "$1[REDACTED]@")
+        .replace(/("(?:password|secret|token|api[_-]?key|authorization)"\s*:\s*")[^"]*(")/giu, "$1[REDACTED]$2");
+}
+function sanitizeValue(value, key = "", depth = 0, seen = new WeakSet()) {
+    const normalizedKey = key.replace(/[^a-z0-9]/giu, "");
+    if (sensitiveField.test(normalizedKey) || sensitiveFieldPart.test(normalizedKey))
+        return "[REDACTED]";
+    if (value === null || value === undefined || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (typeof value === "bigint")
+        return value.toString();
+    if (typeof value === "string")
+        return scrubString(value).slice(0, 4_000);
+    if (value instanceof Error)
+        return sanitizeError(value);
+    if (Buffer.isBuffer(value))
+        return { type: "Buffer", byteLength: value.byteLength };
+    if (depth >= 6)
+        return "[TRUNCATED]";
+    if (typeof value !== "object")
+        return String(value);
+    if (seen.has(value))
+        return "[CIRCULAR]";
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.slice(0, 100).map((item) => sanitizeValue(item, "", depth + 1, seen));
+    return Object.fromEntries(Object.entries(value).slice(0, 100).map(([entryKey, entryValue]) => [entryKey, sanitizeValue(entryValue, entryKey, depth + 1, seen)]));
+}
+export function sanitizeLogFields(fields) {
+    return sanitizeValue(fields);
+}
+export function sanitizeError(error) {
+    if (!(error instanceof Error))
+        return { message: scrubString(String(error)).slice(0, 4_000) };
+    const candidate = error;
+    return {
+        name: error.name,
+        message: scrubString(error.message).slice(0, 4_000),
+        ...(candidate.code === undefined ? {} : { code: sanitizeValue(candidate.code, "code") }),
+        ...(candidate.status === undefined ? {} : { status: sanitizeValue(candidate.status, "status") }),
+        ...(error.stack ? { stack: scrubString(error.stack).slice(0, 12_000) } : {})
+    };
+}
+export function accountReference(userId) {
+    return `account:${createHash("sha256").update(userId).digest("hex").slice(0, 12)}`;
+}
+export function resolveLogLevel(environment = process.env) {
+    const configured = environment.LOG_LEVEL?.trim().toLocaleLowerCase();
+    if (configured === "debug" || configured === "info" || configured === "warn" || configured === "error" || configured === "silent")
+        return configured;
+    return environment.NODE_ENV === "test" ? "silent" : "info";
+}
+function defaultWrite(_level, record) {
+    // 服务和 CLI 共用日志器，统一写入 stderr，避免污染 CLI 的机器可读 stdout。
+    console.error(JSON.stringify(record));
+}
+export function createLogger(options = {}) {
+    const configuredLevel = options.level ?? resolveLogLevel();
+    const service = options.service ?? "scriverse";
+    const write = options.write ?? defaultWrite;
+    const now = options.now ?? (() => new Date());
+    const emit = (level, event, fields = {}) => {
+        if (levelPriority[level] < levelPriority[configuredLevel])
+            return;
+        const context = currentRequestContext();
+        const record = {
+            timestamp: now().toISOString(),
+            level,
+            service,
+            ...sanitizeLogFields(fields),
+            event,
+            ...(context?.requestId ? { requestId: context.requestId } : {}),
+            ...(context?.actor ? {
+                actorRef: accountReference(context.actor.userId),
+                ...(context.actor.authentication ? { authentication: context.actor.authentication } : {})
+            } : {})
+        };
+        try {
+            write(level, record);
+        }
+        catch {
+            // 日志输出失败不能中断业务请求。
+        }
+    };
+    return {
+        debug: (event, fields) => emit("debug", event, fields),
+        info: (event, fields) => emit("info", event, fields),
+        warn: (event, fields) => emit("warn", event, fields),
+        error: (event, fields) => emit("error", event, fields)
+    };
+}
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/parser.js

@@ -0,0 +1,223 @@
+import { countWords } from "./utils.js";
+const volumePattern = /^\s*(?:第[零一二三四五六七八九十百千万两\d]+卷|卷[零一二三四五六七八九十百千万两\d]+)(?:\s+|[:：]\s*|$)[^\n]*\s*$/u;
+const chapterPattern = /^\s*(?:第[零一二三四五六七八九十百千万两\d]+章(?:[上中下])?|序章|楔子|终章|后记|作者的话)(?:\s+|[:：]\s*|$)[^\n]*\s*$/u;
+const specialVolumePattern = /^\s*(前传|附录)(?:\s+|[:：]\s*|$)([^\n]*)\s*$/u;
+function titleOf(line) {
+    return line.trim().replace(/\s+/gu, " ");
+}
+function kindOf(title) {
+    if (/^前传/u.test(title))
+        return "prequel";
+    if (/^番外/u.test(title))
+        return "extra";
+    if (/^附录/u.test(title))
+        return "appendix";
+    return "main";
+}
+function chapterTypeOf(title) {
+    return /^(?:后记|作者的话)/u.test(title) ? "作者的话" : "正文";
+}
+export function parseNovelText(raw) {
+    const text = raw.replace(/^\uFEFF/u, "").replace(/\r\n?/gu, "\n").trim();
+    const originalLines = text ? text.split("\n") : [];
+    const headingKey = (line) => {
+        const match = line.trim().match(/^(第[零一二三四五六七八九十百千万两\d]+[卷章]|卷[零一二三四五六七八九十百千万两\d]+|序章|楔子|终章|前传|番外|后记|附录)/u);
+        return match?.[1] ?? null;
+    };
+    const ignoredDirectoryLines = new Set();
+    const directoryIndexes = originalLines
+        .map((line, index) => /^\s*目\s*录\s*$/u.test(line) ? index : -1)
+        .filter((index) => index >= 0);
+    for (const directoryIndex of directoryIndexes) {
+        const pageHeadingKeys = new Set();
+        let pageEntryCount = 0;
+        let bodyBoundary = -1;
+        const scanLimit = Math.min(originalLines.length, directoryIndex + 5000);
+        for (let index = directoryIndex + 1; index < scanLimit; index += 1) {
+            const line = originalLines[index] ?? "";
+            const key = headingKey(line);
+            const hasPageNumber = /(?:\t\s*\d+| {2,}\d+)\s*$/u.test(line);
+            if (hasPageNumber) {
+                pageEntryCount += 1;
+                if (key)
+                    pageHeadingKeys.add(key);
+                continue;
+            }
+            if (key && pageEntryCount >= 3 && pageHeadingKeys.size >= 2 && pageHeadingKeys.has(key)) {
+                bodyBoundary = index;
+                break;
+            }
+        }
+        if (bodyBoundary > directoryIndex) {
+            for (let index = directoryIndex; index < bodyBoundary; index += 1)
+                ignoredDirectoryLines.add(index);
+            continue;
+        }
+        let simpleEnd = directoryIndex + 1;
+        const simpleKeys = [];
+        let started = false;
+        while (simpleEnd < originalLines.length) {
+            const line = originalLines[simpleEnd] ?? "";
+            if (!line.trim()) {
+                if (started)
+                    break;
+                simpleEnd += 1;
+                continue;
+            }
+            const key = headingKey(line);
+            if (!key)
+                break;
+            started = true;
+            simpleKeys.push(key);
+            simpleEnd += 1;
+        }
+        const laterKeys = new Set(originalLines.slice(simpleEnd).map(headingKey).filter((value) => Boolean(value)));
+        if (simpleKeys.length >= 2 && simpleKeys.some((key) => laterKeys.has(key))) {
+            for (let index = directoryIndex; index < simpleEnd; index += 1)
+                ignoredDirectoryLines.add(index);
+        }
+    }
+    const lines = originalLines.filter((_line, index) => !ignoredDirectoryLines.has(index));
+    // 卷标题附近必须出现目录或章节，并且同一卷号不能重复，避免把正文中的书名、篇名误当成分卷。
+    const volumeHeadingIndexes = new Set();
+    const seenVolumeKeys = new Set();
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        if (!volumePattern.test(line) && !specialVolumePattern.test(line))
+            continue;
+        const volumeKey = line.trim().match(/^(?:第([零一二三四五六七八九十百千万两\d]+)卷|卷([零一二三四五六七八九十百千万两\d]+))/u)?.slice(1).find(Boolean);
+        if (volumeKey && seenVolumeKeys.has(volumeKey))
+            continue;
+        let nextIndex = index + 1;
+        let meaningfulLineCount = 0;
+        while (nextIndex < lines.length && meaningfulLineCount < 8) {
+            const nextLine = lines[nextIndex] ?? "";
+            nextIndex += 1;
+            if (!nextLine.trim())
+                continue;
+            if (/^\s*目\s*录\s*$/u.test(nextLine) || chapterPattern.test(nextLine)) {
+                volumeHeadingIndexes.add(index);
+                if (volumeKey)
+                    seenVolumeKeys.add(volumeKey);
+                break;
+            }
+            meaningfulLineCount += 1;
+        }
+    }
+    const hasExplicitVolume = volumeHeadingIndexes.size > 0;
+    const warnings = [];
+    const volumes = [];
+    let currentVolume;
+    let currentChapter;
+    let preamble = [];
+    const ensureVolume = () => {
+        if (!currentVolume) {
+            currentVolume = {
+                title: hasExplicitVolume ? "未归属内容" : "正文",
+                kind: "main",
+                source: "default",
+                order: volumes.length,
+                chapters: []
+            };
+            volumes.push(currentVolume);
+        }
+        return currentVolume;
+    };
+    const flushChapter = () => {
+        if (!currentChapter)
+            return;
+        currentChapter.content = currentChapter.content.trim();
+        ensureVolume().chapters.push(currentChapter);
+        currentChapter = undefined;
+    };
+    const flushPreamble = () => {
+        const content = preamble.join("\n").trim();
+        preamble = [];
+        if (!content)
+            return;
+        const volume = ensureVolume();
+        volume.chapters.push({
+            title: volume.chapters.length === 0 ? "卷首" : "未命名章节",
+            content,
+            order: volume.chapters.length,
+            chapterType: "正文"
+        });
+    };
+    for (const [lineIndex, line] of lines.entries()) {
+        if (volumeHeadingIndexes.has(lineIndex)) {
+            flushChapter();
+            flushPreamble();
+            const title = titleOf(line);
+            currentVolume = {
+                title,
+                kind: kindOf(title),
+                source: "explicit",
+                order: volumes.length,
+                chapters: []
+            };
+            volumes.push(currentVolume);
+            continue;
+        }
+        if (chapterPattern.test(line)) {
+            flushChapter();
+            flushPreamble();
+            const volume = ensureVolume();
+            currentChapter = {
+                title: titleOf(line),
+                content: "",
+                order: volume.chapters.length,
+                chapterType: chapterTypeOf(titleOf(line))
+            };
+            continue;
+        }
+        if (currentChapter) {
+            currentChapter.content += `${currentChapter.content ? "\n" : ""}${line}`;
+        }
+        else {
+            preamble.push(line);
+        }
+    }
+    flushChapter();
+    flushPreamble();
+    if (volumes.length === 0) {
+        volumes.push({
+            title: "正文",
+            kind: "main",
+            source: "default",
+            order: 0,
+            chapters: []
+        });
+    }
+    for (const volume of volumes) {
+        volume.chapters.forEach((chapter, index) => {
+            chapter.order = index;
+        });
+    }
+    if (!hasExplicitVolume)
+        warnings.push("未检测到明确卷标题，内容保留在默认卷中");
+    if (ignoredDirectoryLines.size > 0)
+        warnings.push(`已忽略目录中的 ${ignoredDirectoryLines.size} 行导航内容`);
+    if (volumes.some((volume) => volume.title === "未归属内容"))
+        warnings.push("卷标题前存在正文内容，已标记为未归属内容");
+    if (volumes.some((volume) => volume.chapters.length === 0))
+        warnings.push("检测到空卷");
+    return {
+        volumes,
+        warnings,
+        wordCount: countWords(text),
+        paragraphCount: originalLines.filter((line) => line.trim()).length
+    };
+}
+export function applyImportFileHints(parsed, fileName) {
+    if (!/前传/u.test(fileName) || !parsed.volumes.some((volume) => volume.source === "explicit"))
+        return parsed;
+    const leadingDefaultVolume = parsed.volumes.find((volume) => volume.source === "default");
+    if (!leadingDefaultVolume)
+        return parsed;
+    leadingDefaultVolume.title = "前传";
+    leadingDefaultVolume.kind = "prequel";
+    parsed.warnings = parsed.warnings.filter((warning) => warning !== "卷标题前存在正文内容，已标记为未归属内容");
+    parsed.warnings.push("根据文件名将首个未分卷内容识别为前传");
+    return parsed;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/public/ai-context-meter.js

@@ -0,0 +1,10 @@
+export function formatAiContextUsageTooltip(usage) {
+  if (!usage) return "选择可用模型后显示当前上下文用量";
+  const inputTokens = Math.max(0, Math.round(Number(usage.inputTokens) || 0)).toLocaleString("zh-CN");
+  const contextWindow = Math.max(0, Math.round(Number(usage.contextWindow) || 0)).toLocaleString("zh-CN");
+  const contextTokens = Math.max(0, Math.round(Number(usage.contextTokens) || 0)).toLocaleString("zh-CN");
+  const conversationTokens = Math.max(0, Math.round(Number(usage.conversationTokens) || 0)).toLocaleString("zh-CN");
+  const conversationBudget = Math.max(0, Math.round(Number(usage.conversationBudgetTokens) || 0)).toLocaleString("zh-CN");
+  const outputReserve = Math.max(0, Math.round(Number(usage.outputReserveTokens) || 0)).toLocaleString("zh-CN");
+  return `总输入 ${inputTokens} / ${contextWindow} tok · 作品上下文 ${contextTokens} tok · 对话历史 ${conversationTokens} / ${conversationBudget} tok · 输出预留 ${outputReserve} tok`;
+}

package/dist/public/ai-conversation.js

@@ -0,0 +1,3 @@
+export function shouldShowAiQuickActions(hasSentPrompt) {
+  return !Boolean(hasSentPrompt);
+}

package/dist/public/ai-mentions.js

@@ -0,0 +1,55 @@
+export function findAiMention(value, cursor = value.length) {
+  const safeCursor = Math.max(0, Math.min(Number(cursor) || 0, value.length));
+  const match = value.slice(0, safeCursor).match(/@([^@\s]*)$/u);
+  if (!match) return null;
+  return {
+    start: safeCursor - match[0].length,
+    end: safeCursor,
+    query: match[1]
+  };
+}
+
+export function listAiMentionOptions(characters, settings, chapters, query = "", limit = 12) {
+  const keyword = String(query).trim().toLocaleLowerCase("zh-CN");
+  const groups = [
+    characters.map((item) => ({ kind: "character", kindLabel: "角色", id: String(item.id), name: String(item.name) })),
+    settings.map((item) => ({ kind: "setting", kindLabel: "设定", id: String(item.id), name: String(item.title) })),
+    chapters.map((item) => ({
+      kind: "chapter",
+      kindLabel: "章节",
+      id: String(item.id),
+      name: `${String(item.volumeTitle)} / ${String(item.title)}`
+    }))
+  ];
+  const maximum = Math.max(1, Number(limit) || 12);
+  if (keyword) {
+    return groups.flat()
+      .filter((item) => item.name.toLocaleLowerCase("zh-CN").includes(keyword))
+      .slice(0, maximum);
+  }
+  const options = [];
+  for (let index = 0; options.length < maximum && groups.some((group) => group[index]); index += 1) {
+    for (const group of groups) {
+      if (group[index]) options.push(group[index]);
+      if (options.length === maximum) break;
+    }
+  }
+  return options;
+}
+
+export function applyAiMention(value, mention, name) {
+  const token = `@${String(name).trim()}`;
+  const text = `${value.slice(0, mention.start)}${token} ${value.slice(mention.end)}`;
+  return { text, token, cursor: mention.start + token.length + 1 };
+}
+
+export function buildAiReferenceScope(references) {
+  const chapterIds = [...new Set(references.filter((item) => item.kind === "chapter").map((item) => item.id))];
+  const characterIds = [...new Set(references.filter((item) => item.kind === "character").map((item) => item.id))];
+  const settingIds = [...new Set(references.filter((item) => item.kind === "setting").map((item) => item.id))];
+  return {
+    ...(chapterIds.length ? { chapterIds } : {}),
+    ...(characterIds.length ? { characterIds } : {}),
+    ...(settingIds.length ? { settingIds } : {})
+  };
+}