@ggboy123/dsh-paper-reader 1.4.0 → 1.5.0

package/dist/host.js

@@ -6,7 +6,8 @@ import { randomUUID } from 'node:crypto';
 import { basename, join, resolve } from 'node:path';
 import { listPapers, listTopics, resolveDataDir, resolvePaper, resolveUploadTopic, validateEntryBoundary, validateEntryName, } from "./library.js";
 import { ManageError, assertInside, clearTopic, planTopicClear, deletePaper, deleteTopic, isManageError, planPaperDelete, planTopicDelete, realDataDir, renamePaper, renameTopic, resolveTopicDir, validateName, } from "./library-manage.js";
-import { readFormulaIndex } from "./formulas.js";
+import { readFormulaIndex, readTextBlockIndex } from "./formulas.js";
+import { MAX_CHUNKS, MAX_LATEX_CHARS, MAX_TEXT_CHARS, MAX_TOTAL_CHARS, SelectionTranslateError, assembleSource, formulaStatusOf, translateSelection, } from "./translate-selection.js";
 import { MineruError, sanitizeDetail } from "./mineru.js";
 import { readTranscript, transcribePaper, ScannedPdfError, ShortTextError } from "./transcribe.js";
 import { pdfVariantPath, restartTranslation, startTranslation, zhStatus } from "./translate.js";
@@ -347,10 +348,17 @@ export function registerRoutes(ctx, config) {
                 json(res, 400, { error: 'bad asset name' });
                 return;
             }
-            const mime = { '.mjs': 'text/javascript', '.js': 'text/javascript', '.css': 'text/css', '.map': 'application/json' };
+            const mime = { '.mjs': 'text/javascript', '.js': 'text/javascript', '.css': 'text/css', '.map': 'application/json',
+                // 字体（vendored KaTeX 的 woff2 就靠这条；不给对 MIME 时某些浏览器会拒绝 @font-face）
+                '.woff2': 'font/woff2', '.woff': 'font/woff', '.ttf': 'font/ttf' };
             try {
                 const body = await readFile(new URL(name, readerVendorDir));
-                res.writeHead(200, { 'content-type': (mime[name.slice(name.lastIndexOf('.'))] ?? 'application/octet-stream') + '; charset=utf-8', 'content-length': body.length, 'cache-control': 'no-cache' });
+                const ext = name.slice(name.lastIndexOf('.'));
+                const type = mime[ext] ?? 'application/octet-stream';
+                // 只有文本类才追加 charset：给 font/woff2 这类二进制资源加 `; charset=utf-8` 是错的
+                // （实测 font/woff2 被浏览器按未知类型处理的风险；见 test/reader-vendor-http.test.mjs）
+                const texty = type.startsWith('text/') || type === 'application/json';
+                res.writeHead(200, { 'content-type': texty ? type + '; charset=utf-8' : type, 'content-length': body.length, 'cache-control': 'no-cache' });
                 res.end(body);
             }
             catch {
@@ -777,6 +785,102 @@ export function registerRoutes(ctx, config) {
             json(res, 200, await readFormulaIndex(ref));
             return;
         }
+        /* ── 划词翻译（公式保留，契约 docs/selection-translate-requirements.md §3.9）─────
+           客户端只送「按页 + 按 display 归属切好的 chunk」；行内公式的还原（选区文本 ↔ MinerU
+           text 块对齐）在服务端做，所以请求体里**没有任何矩形/bbox/pageSize**。
+           本接口只读（不写盘）⇒ 定位沿用 /api/formulas 的读路径语义，不做写路径边界。
+           API key 只存在于本进程：请求体只有 model（客户端从 /api/zh 拿到的 apiKeyHint 仅用于展示），
+           响应体与错误文案一律不带 key。 */
+        if (sub === '/api/translate-selection' && req.method === 'POST') {
+            const body = (await readBody(req));
+            const bad = (msg, code = 'bad-request') => json(res, 400, { error: msg, code });
+            if (!Array.isArray(body.chunks))
+                return bad('chunks 必须是数组');
+            if (body.chunks.length < 1 || body.chunks.length > MAX_CHUNKS) {
+                return bad(`chunks 数量必须在 1~${MAX_CHUNKS} 之间（收到 ${body.chunks.length}）`, 'too-large');
+            }
+            const chunks = [];
+            let total = 0;
+            for (const raw of body.chunks) {
+                if (typeof raw !== 'object' || raw === null)
+                    return bad('chunks 的每一项必须是对象');
+                const c = raw;
+                const page = c.page;
+                if (typeof page !== 'number' || !Number.isInteger(page) || page < 1)
+                    return bad('chunk.page 必须是 ≥1 的整数');
+                const text = typeof c.text === 'string' ? c.text : '';
+                const latex = typeof c.latex === 'string' ? c.latex : '';
+                if (c.kind === 'formula') {
+                    if (!latex)
+                        return bad('formula chunk 的 latex 不能为空');
+                    if (latex.length > MAX_LATEX_CHARS)
+                        return bad(`latex 超过 ${MAX_LATEX_CHARS} 字符`, 'too-large');
+                    total += latex.length;
+                    chunks.push({ page, kind: 'formula', latex });
+                    continue;
+                }
+                if (c.kind !== 'text')
+                    return bad("chunk.kind 必须为 'text' 或 'formula'");
+                if (text.length > MAX_TEXT_CHARS)
+                    return bad(`text 超过 ${MAX_TEXT_CHARS} 字符`, 'too-large');
+                total += text.length;
+                chunks.push({ page, kind: 'text', text });
+            }
+            if (total === 0)
+                return bad('选区为空');
+            if (total > MAX_TOTAL_CHARS)
+                return bad(`选区总长超过 ${MAX_TOTAL_CHARS} 字符`, 'too-large');
+            let ref;
+            try {
+                const args = {};
+                if (typeof body.path === 'string' && body.path)
+                    args.path = body.path;
+                else {
+                    if (typeof body.topic !== 'string' || typeof body.name !== 'string' || !body.topic || !body.name) {
+                        return bad('必须提供 topic + name（或 path）');
+                    }
+                    args.topic = body.topic;
+                    args.name = body.name;
+                }
+                ref = resolvePaper(dataDir, args);
+            }
+            catch {
+                throw notFound('文献不存在（划词翻译需要先能定位到该文献）');
+            }
+            const { endpoint, source } = await resolveTranslateEndpoint(config.translate);
+            if (source === 'none') {
+                json(res, 503, { error: '未配置翻译端点：在阅读器里点 ⚙ 填写（OpenAI 兼容端点即可）', code: 'no-endpoint' });
+                return;
+            }
+            const index = await readTextBlockIndex(ref);
+            const asm = assembleSource(chunks, index);
+            try {
+                const r = await translateSelection(endpoint, asm.source);
+                json(res, 200, {
+                    translation: r.translation,
+                    model: r.model,
+                    cached: r.cached,
+                    formulaTotal: r.formulaTotal,
+                    formulaKept: r.formulaKept,
+                    formulaLost: r.formulaLost,
+                    formulaApplied: asm.applied,
+                    formulaSkipped: asm.skipped,
+                    formulaStatus: formulaStatusOf(asm),
+                    hasBlockIndex: asm.hasBlockIndex,
+                    ms: r.ms,
+                });
+            }
+            catch (err) {
+                if (!(err instanceof SelectionTranslateError))
+                    throw err;
+                json(res, err.status, {
+                    error: err.message,
+                    code: err.code,
+                    ...(err.upstreamStatus !== null ? { upstreamStatus: err.upstreamStatus } : {}),
+                });
+            }
+            return;
+        }
         // 新建伴读会话（会话N+1）。最新可见会话还是空白草稿时直接复用它——
         // 连点「新建」不再堆积空会话（毫无意义的点击什么都不存）。
         // n 用全量扫描分配（含归档/空白），绝不与磁盘上已有目录撞号。

package/dist/translate-config.js

@@ -117,6 +117,9 @@ export async function testTranslateEndpoint(ep) {
         // Node 的 fetch 把真实原因（ECONNREFUSED / 证书错误 / 超时）塞在 cause 里，
         // 只报 "fetch failed" 对用户毫无帮助
         const cause = err instanceof Error && err.cause instanceof Error ? `: ${err.cause.message}` : '';
-        return { ok: false, detail: (err instanceof Error ? err.message : String(err)) + cause };
+        // ⚠️ t7（t4 评审 R-04 的同类项）：这条 detail 会进响应体、再上屏（设置浮层）。
+        // fetch 抛出的原因串可能带上 baseUrl（含凭据/查询参数）或回显 Authorization ——
+        // 与同函数上面两条分支一样先过 sanitizeDetail；可读原因（ECONNREFUSED 等）不受影响。
+        return { ok: false, detail: sanitizeDetail((err instanceof Error ? err.message : String(err)) + cause, apiKey) };
     }
 }