dsh-thesis 2.0.2 → 2.1.1

package/lib/paper/tools/build.js

@@ -11,9 +11,11 @@
  */
 import * as nodePath from 'node:path';
 import { readFile, rm, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { describeFailure, spawnCommand } from "../../shared/spawn.js";
 import { buildDocx } from "../lib/docx.js";
+import { readImageInfo } from "../lib/image.js";
 import { CHAPTER_META, isWrittenChapter } from "../lib/layout.js";
 import { parseLedger } from "../lib/ledger.js";
 import { findThesisRoot } from "../lib/project.js";
@@ -43,6 +45,72 @@ function pandocAvailable() {
 const PROBE_TIMEOUT_MS = 10_000;
 /** 单次 pandoc 转换的超时（毫秒）：大型论文 + 模板可能慢，但必须有上限。 */
 const CONVERT_TIMEOUT_MS = 120_000;
+/** 章节里的图片引用：`![图题](路径)`，路径可写成 `<带空格的路径>`。 */
+const IMAGE_REF = /!\[([^\]]*)\]\(\s*(?:<([^>]+)>|([^)\s]+))(?:\s+"[^"]*")?\s*\)/g;
+/**
+ * 把图片引用解析成磁盘路径：先按章节文件所在目录（Markdown 的常规语义），
+ * 再按论文仓库根（学生把路径写成 `06-论文/assets/图/x.png` 时也能用）。
+ */
+function resolveChapterImage(src, chapterAbs, root) {
+    const decoded = src.includes('%') ? decodeURI(src) : src;
+    const candidates = nodePath.isAbsolute(decoded)
+        ? [decoded]
+        : [nodePath.resolve(nodePath.dirname(chapterAbs), decoded), nodePath.resolve(root, decoded)];
+    return candidates.find(candidate => existsSync(candidate));
+}
+/** 读一张图；只接受 PNG/JPEG，其它格式如实报「不能嵌入」。 */
+async function loadImage(absPath) {
+    try {
+        const data = new Uint8Array(await readFile(absPath));
+        const info = readImageInfo(data);
+        if (info === undefined)
+            return undefined;
+        return { data, width: info.width, height: info.height, format: info.format };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 把一章正文里的图片引用统一改写成**绝对路径**，并把图片字节收集起来。
+ *
+ * 为什么要改写成绝对路径：pandoc 的临时 Markdown 在系统临时目录里生成，
+ * 相对路径到那里必然解析不到；内置引擎则按绝对路径查 {@link DocxImage}。
+ * 找不到的图片不静默丢弃——保留原引用并记一条问题，构建说明与工具返回值都会带上。
+ */
+async function prepareChapterImages(text, chapterAbs, chapterRel, root, images, problems) {
+    const matches = [...text.matchAll(IMAGE_REF)];
+    if (matches.length === 0)
+        return text;
+    let out = '';
+    let cursor = 0;
+    for (const match of matches) {
+        const whole = match[0];
+        const alt = match[1] ?? '';
+        const src = match[2] ?? match[3] ?? '';
+        out += text.slice(cursor, match.index);
+        cursor = match.index + whole.length;
+        const abs = resolveChapterImage(src, chapterAbs, root);
+        if (abs === undefined) {
+            problems.push(`${chapterRel}：图片不存在 ${src}`);
+            out += whole;
+            continue;
+        }
+        // 用正斜杠写进 Markdown：pandoc 在 Windows 上也认；反斜杠会被当成 Markdown 转义符。
+        const key = abs.replace(/\\/g, '/');
+        if (!images.has(key)) {
+            const image = await loadImage(abs);
+            if (image === undefined) {
+                problems.push(`${chapterRel}：不是可嵌入的 PNG/JPEG（${src}），已按原样保留`);
+                out += whole;
+                continue;
+            }
+            images.set(key, image);
+        }
+        out += `![${alt}](<${key}>)`;
+    }
+    return out + text.slice(cursor);
+}
 export async function runBuild(fs, args, cwd, signal, writeBinary) {
     const root = await findThesisRoot(fs, cwd, signal);
     if (root === null)
@@ -55,14 +123,17 @@ export async function runBuild(fs, args, cwd, signal, writeBinary) {
     const chapterParts = [];
     const included = [];
     const missing = [];
+    const images = new Map();
+    const imageProblems = [];
     for (const [index, meta] of CHAPTER_META.entries()) {
-        const text = await readOptional(fs, nodePath.join(root, '06-论文/章节', `${meta.file}.md`), signal);
+        const chapterAbs = nodePath.join(root, '06-论文/章节', `${meta.file}.md`);
+        const text = await readOptional(fs, chapterAbs, signal);
         if (text === undefined || !isWrittenChapter(text, index + 1, meta)) {
             missing.push(meta.file);
             continue;
         }
         included.push(meta.file);
-        chapterParts.push(text);
+        chapterParts.push(await prepareChapterImages(text, chapterAbs, meta.file, root, images, imageProblems));
     }
     if (included.length === 0)
         throw new Error('没有任何已撰写章节（06-论文/章节/*.md 均为空）。');
@@ -97,7 +168,7 @@ export async function runBuild(fs, args, cwd, signal, writeBinary) {
     const docxPath = nodePath.join(root, OUT_DIR, '论文.docx');
     let docxBytes;
     if (engine === 'internal') {
-        docxBytes = buildDocx({ title, markdown });
+        docxBytes = buildDocx({ title, markdown, images });
     }
     else {
         // pandoc：合并内容写临时文件后转换
@@ -145,11 +216,13 @@ export async function runBuild(fs, args, cwd, signal, writeBinary) {
         `- 学校模板：${template ?? '未发现（请将学校模板放入 06-论文/assets/学校模板/ 后重建）'}`,
         `- 收录章节：${included.join('、') || '无'}`,
         `- 未收录章节（空或缺失）：${missing.join('、') || '无'}`,
+        `- 插图：${images.size} 张已嵌入${imageProblems.length > 0 ? `，${imageProblems.length} 处有问题（见下）` : ''}`,
+        ...(imageProblems.length > 0 ? ['', '图片问题：', ...imageProblems.map(problem => `- ${problem}`)] : []),
         `- 产物：论文.docx${pdfPath !== undefined ? '、论文.pdf' : ''}`,
         '',
     ].join('\n');
     await fs.writeText(await fs.resolve(nodePath.join(root, OUT_DIR, '构建说明.md'), { signal }), note, undefined, signal);
-    return { docxPath, ...(pdfPath !== undefined ? { pdfPath } : {}), engine, template, chapters: included, missing };
+    return { docxPath, ...(pdfPath !== undefined ? { pdfPath } : {}), engine, template, chapters: included, missing, images: images.size, imageProblems };
 }
 export function buildSummary(outcome) {
     const lines = [
@@ -159,6 +232,8 @@ export function buildSummary(outcome) {
         `- 学校模板：${outcome.template ?? '未发现'}`,
         `- 收录章节：${outcome.chapters.join('、')}`,
         ...(outcome.missing.length > 0 ? [`- 未收录（空/缺失）：${outcome.missing.join('、')}`] : []),
+        `- 插图：${outcome.images} 张已嵌入${outcome.imageProblems.length > 0 ? `；${outcome.imageProblems.length} 处需处理（见构建说明）` : ''}`,
+        ...outcome.imageProblems.map(problem => `  · ${problem}`),
         '',
         '打开 论文.docx 检查排版；构建细节见 06-论文/产出/构建说明.md。',
     ];

package/lib/paper/tools/lit-verify.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 文献核验与导入：thesis_lit_verify / thesis_lit_import。
+ *
+ * 两个工具解决同一个问题：**候选文献从哪来**与**凭什么敢写进论文**不能混为一谈。
+ * - `thesis_lit_verify`：核验（单条或整份导出文件），只出结论，不改 refs.bib；
+ * - `thesis_lit_import`：先把导出文件逐条核验，**只有核验通过的**才进 refs.bib，
+ *   未通过的写进 08-合规/文献核验报告.md 并逐条说明原因。
+ *
+ * 失败即拒（fail closed）：网络不通 → `unchecked` → 不入库。
+ */
+import type { FileSystem } from '@deepseek-ai/dsh-fs';
+import type { FetchLike, LitRecord } from '../lib/lit-api.ts';
+export interface LitVerifyArgs {
+    doi?: string;
+    title?: string;
+    authors?: string[];
+    year?: number;
+    venue?: string;
+    /** 导出文件路径（.bib/.ris/.csv），给了就批量核验整个文件。 */
+    path?: string;
+    /** 核验通过后是否顺手收录进 refs.bib，默认 false（核验工具只出结论）。 */
+    save?: boolean;
+}
+export interface LitImportArgs {
+    path: string;
+    source?: string;
+    limit?: number;
+    /** 默认 true：核验通过的直接入库。设 false 只核验。 */
+    save?: boolean;
+}
+declare const REPORT_TABLE_HEAD = "| \u65E5\u671F | \u52A8\u4F5C | \u6765\u6E90 | \u5BF9\u8C61 | \u6761\u6570 | \u7ED3\u8BBA |\n|---|---|---|---|---|---|";
+export declare function runLitVerify(fs: FileSystem, args: LitVerifyArgs, cwd: string | undefined, signal: AbortSignal | undefined, fetchImpl: FetchLike): Promise<string>;
+export declare function runLitImport(fs: FileSystem, args: LitImportArgs, cwd: string | undefined, signal: AbortSignal | undefined, fetchImpl: FetchLike): Promise<string>;
+export { REPORT_TABLE_HEAD };
+export type { LitRecord };

package/lib/paper/tools/lit-verify.js

@@ -0,0 +1,193 @@
+/**
+ * 文献核验与导入：thesis_lit_verify / thesis_lit_import。
+ *
+ * 两个工具解决同一个问题：**候选文献从哪来**与**凭什么敢写进论文**不能混为一谈。
+ * - `thesis_lit_verify`：核验（单条或整份导出文件），只出结论，不改 refs.bib；
+ * - `thesis_lit_import`：先把导出文件逐条核验，**只有核验通过的**才进 refs.bib，
+ *   未通过的写进 08-合规/文献核验报告.md 并逐条说明原因。
+ *
+ * 失败即拒（fail closed）：网络不通 → `unchecked` → 不入库。
+ */
+import * as nodePath from 'node:path';
+import { describeReadFailure, isMissingError } from "../../shared/fs-errors.js";
+import { loadCache, mergeRecords, saveCache, appendLitRecord } from "../lib/lit-cache.js";
+import { parseRefs } from "../lib/lit-refs.js";
+import { renderOutcome, renderVerifyReport, summarizeOutcomes, VERIFY_REPORT_HEADER, VERIFY_REPORT_REL, verifyAll, } from "../lib/lit-verify.js";
+import { findThesisRoot } from "../lib/project.js";
+import { runLitSave } from "./lit.js";
+const REPORT_TABLE_HEAD = '| 日期 | 动作 | 来源 | 对象 | 条数 | 结论 |\n|---|---|---|---|---|---|';
+async function thesisRoot(fs, cwd, signal) {
+    const root = await findThesisRoot(fs, cwd, signal);
+    if (root === null) {
+        throw new Error('未找到论文工作区（向上查找 00-管理/进度台账.md 失败）。请先 thesis_init，或在论文仓库目录内操作。');
+    }
+    return root;
+}
+function formatDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+async function readLocalFile(fs, root, target, signal) {
+    const absolute = nodePath.isAbsolute(target) ? target : nodePath.join(root, target);
+    try {
+        const text = await fs.readText(await fs.resolve(absolute, { signal }), signal);
+        return { name: nodePath.basename(absolute), text };
+    }
+    catch (error) {
+        if (isMissingError(error)) {
+            throw new Error(`找不到导出文件：${absolute}\n` +
+                `请先在 Undermind / Elicit / Consensus / Zotero 里导出为 .bib 或 .ris，放到论文仓库里再传路径。`);
+        }
+        throw new Error(describeReadFailure('文献导出文件', absolute, error, signal));
+    }
+}
+function inferSource(fileName) {
+    const text = fileName.toLowerCase();
+    if (text.includes('undermind'))
+        return 'undermind';
+    if (text.includes('elicit'))
+        return 'elicit';
+    if (text.includes('consensus'))
+        return 'consensus';
+    if (text.includes('zotero'))
+        return 'zotero';
+    if (text.includes('scholar'))
+        return 'google-scholar';
+    return 'file';
+}
+/** 追加核验报告（保留历史：每次核验一个 `## 日期` 小节）。 */
+async function appendVerifyReport(fs, root, section, signal) {
+    const path = nodePath.join(root, VERIFY_REPORT_REL);
+    let existing;
+    try {
+        existing = await fs.readText(await fs.resolve(path, { signal }), signal);
+    }
+    catch (error) {
+        if (!isMissingError(error))
+            throw new Error(describeReadFailure('文献核验报告', path, error, signal));
+        existing = VERIFY_REPORT_HEADER;
+    }
+    const head = existing.trim() === '' ? VERIFY_REPORT_HEADER : existing.trimEnd();
+    await fs.writeText(await fs.resolve(path, { signal }), `${head}\n\n${section}\n`, undefined, signal);
+    return path;
+}
+function verifyRow(date, source, title, status, note) {
+    return `| ${date} | 核验 | ${source} | ${title.replaceAll('|', '\\|').slice(0, 80)} | 1 | ${status}：${note.replaceAll('|', '\\|')} |`;
+}
+function candidateFromArgs(args) {
+    const title = (args.title ?? '').trim();
+    const doi = (args.doi ?? '').trim();
+    if (title === '' && doi === '') {
+        throw new Error('请给 title 或 doi（单条核验），或用 path 指定导出的 .bib/.ris/.csv（批量核验）。');
+    }
+    return {
+        title: title === '' ? `（仅凭 DOI 核验）${doi}` : title,
+        authors: args.authors ?? [],
+        year: args.year ?? null,
+        venue: args.venue ?? '',
+        ...(doi !== '' ? { doi } : {}),
+        source: 'manual',
+    };
+}
+async function reportAndSave(fs, root, outcomes, label, save, signal) {
+    const date = formatDate();
+    const section = renderVerifyReport(date, outcomes, label);
+    const reportPath = await appendVerifyReport(fs, root, section, signal);
+    for (const outcome of outcomes) {
+        await appendLitRecord(fs, root, verifyRow(date, outcome.candidate.source, outcome.candidate.title, outcome.status, outcome.message), signal);
+    }
+    let savedText = '';
+    if (save) {
+        const records = outcomes.flatMap(o => (o.status === 'verified' && o.record !== undefined ? [o.record] : []));
+        if (records.length > 0) {
+            const cache = mergeRecords(await loadCache(fs, root, signal), records);
+            await saveCache(fs, root, cache, signal);
+            savedText = await runLitSave(fs, { ids: records.map(r => r.id) }, root, signal);
+        }
+        else {
+            savedText = '没有核验通过的条目，未写入 refs.bib。';
+        }
+    }
+    return { reportPath, savedText };
+}
+function renderOutcomes(outcomes, maxDetail = 8) {
+    const lines = [];
+    const passed = outcomes.filter(o => o.status === 'verified');
+    const failed = outcomes.filter(o => o.status !== 'verified');
+    if (passed.length > 0) {
+        lines.push('### 核验通过', '');
+        for (const outcome of passed.slice(0, maxDetail))
+            lines.push(renderOutcome(outcome), '');
+    }
+    if (failed.length > 0) {
+        lines.push('### 未通过（禁止写入 refs.bib，须换文献或人工核对原文）', '');
+        for (const outcome of failed.slice(0, 20))
+            lines.push(renderOutcome(outcome), '');
+        if (failed.length > 20)
+            lines.push(`（还有 ${failed.length - 20} 条未显示，见核验报告。）`, '');
+    }
+    return lines.join('\n');
+}
+export async function runLitVerify(fs, args, cwd, signal, fetchImpl) {
+    const root = await thesisRoot(fs, cwd, signal);
+    let candidates;
+    let label;
+    if (args.path !== undefined && args.path.trim() !== '') {
+        const file = await readLocalFile(fs, root, args.path.trim(), signal);
+        const parsed = parseRefs(file.name, file.text, inferSource(file.name));
+        if (parsed.candidates.length === 0)
+            throw new Error(`${file.name} 里没有解析出任何文献条目（格式：${parsed.format}）。`);
+        candidates = parsed.candidates;
+        label = `${file.name}（${parsed.format}，${parsed.candidates.length} 条）`;
+    }
+    else {
+        candidates = [candidateFromArgs(args)];
+        label = '单条核验';
+    }
+    const outcomes = await verifyAll(fetchImpl, candidates, signal);
+    const { reportPath, savedText } = await reportAndSave(fs, root, outcomes, label, args.save === true, signal);
+    const lines = [`核验完成：${label}`, summarizeOutcomes(outcomes), '', renderOutcomes(outcomes)];
+    if (savedText !== '')
+        lines.push('### 入库结果', '', savedText, '');
+    lines.push(`报告：${nodePath.relative(root, reportPath).split(nodePath.sep).join('/')}`);
+    if (!args.save) {
+        lines.push('下一步：确认结论后，用 thesis_lit_import 把整份导出文件入库（只收核验通过的），或 thesis_lit_verify 带 save: true 收录本条。');
+    }
+    return lines.join('\n');
+}
+export async function runLitImport(fs, args, cwd, signal, fetchImpl) {
+    if (args.path === undefined || args.path.trim() === '') {
+        throw new Error('path 必填：Undermind / Elicit / Consensus / Zotero 导出的 .bib / .ris / .csv 路径。');
+    }
+    const root = await thesisRoot(fs, cwd, signal);
+    const file = await readLocalFile(fs, root, args.path.trim(), signal);
+    const source = args.source ?? inferSource(file.name);
+    const parsed = parseRefs(file.name, file.text, source);
+    if (parsed.candidates.length === 0)
+        throw new Error(`${file.name} 里没有解析出任何文献条目（格式：${parsed.format}）。`);
+    const limited = args.limit !== undefined && args.limit > 0 ? parsed.candidates.slice(0, args.limit) : parsed.candidates;
+    const outcomes = await verifyAll(fetchImpl, limited, signal);
+    const save = args.save !== false;
+    const { reportPath, savedText } = await reportAndSave(fs, root, outcomes, `${file.name}（${parsed.format}，来源 ${source}）`, save, signal);
+    const lines = [];
+    lines.push(`导入 ${file.name}：解析 ${parsed.candidates.length} 条，本次核验 ${limited.length} 条（格式 ${parsed.format}，来源 ${source}）。`);
+    if (parsed.warnings.length > 0) {
+        lines.push('', '解析警告：');
+        for (const warning of parsed.warnings.slice(0, 10))
+            lines.push(`- ${warning}`);
+    }
+    lines.push('', summarizeOutcomes(outcomes), '');
+    if (save) {
+        lines.push('### 入库结果', '', savedText, '');
+    }
+    else {
+        lines.push('（save: false：只核验未入库。）', '');
+    }
+    lines.push(renderOutcomes(outcomes));
+    lines.push(`报告：${nodePath.relative(root, reportPath).split(nodePath.sep).join('/')}`);
+    const verified = outcomes.filter(o => o.status === 'verified');
+    if (verified.length > 0) {
+        lines.push('', '下一步：对核验通过的文献用 thesis_lit_note 生成阅读笔记；未通过的不要改写引用，换用 thesis_lit_search 另找一篇。');
+    }
+    return lines.join('\n');
+}
+export { REPORT_TABLE_HEAD };

package/lib/ppt/check.js

@@ -10,6 +10,7 @@
 import * as nodePath from 'node:path';
 import { MAX_BULLETS_PER_SLIDE, MAX_BULLET_CHARS, MAX_TITLE_CHARS, MIN_BULLETS_PER_SLIDE, audienceProfile } from "./outline.js";
 import { parseMarp } from "./marp.js";
+import { designIssues, parseDeckPages } from "./design.js";
 /** 每页预计时长的允许区间（分钟）。 */
 export const DURATION_MIN_MINUTES = 8;
 export const DURATION_MAX_MINUTES = 12;
@@ -67,6 +68,10 @@ export function checkDeck(markdown, options) {
     else if (pages > 0 && minMinutes < DURATION_MIN_MINUTES) {
         push('time-under', 'warn', '全文', `预计时长 ${minMinutes}-${maxMinutes} 分钟，短于 ${DURATION_MIN_MINUTES} 分钟；老师一般要求讲满，建议把要点讲透或补一页实现细节。`);
     }
+    // 9. 版面设计（借鉴歸藏设计瑞士风的口径）：版面单调 / 要点过多 / 连续无图 / 缺封面结尾
+    for (const issue of designIssues(parseDeckPages(markdown))) {
+        push(issue.code, issue.level, issue.where, issue.message);
+    }
     const errors = issues.filter(i => i.level === 'error').length;
     const warnings = issues.filter(i => i.level === 'warn').length;
     return {

package/lib/ppt/design.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 答辩幻灯的版面设计系统（借鉴「歸藏设计」瑞士风的核心，重新实现，不引其代码）。
+ *
+ * 为什么放进插件：幻灯丑几乎从不是"配色没调好"，而是**版面单调 + 层级缺失**——
+ * 11 页里 9 页都是「标题 + ▪ 列表」，观众看不到任何视觉锚点。这类问题可以确定性地
+ * 检查出来，不该靠每次重新叮嘱。
+ *
+ * 本模块只做三件事：
+ * 1. `DESIGN`：把版心、字号、色彩写成常量（生成器与检查器共用同一套口径）；
+ * 2. `parseDeckPages`：从 Markdown 里读出每页的版面类型（`<!-- _class: xxx -->`）；
+ * 3. `designIssues`：确定性规则——版面单调、要点过多、连续无图、缺封面/结尾页。
+ */
+/** 16:9 画布与版心（英寸）。生成脚本与检查器都以这里为准。 */
+export declare const DESIGN: {
+    readonly canvas: {
+        readonly width: 13.333;
+        readonly height: 7.5;
+    };
+    readonly margin: {
+        readonly left: 0.95;
+        readonly right: 0.95;
+        readonly top: 0.34;
+        readonly bottom: 0.55;
+    };
+    /** 字号（pt）：kicker / 标题 / 正文 / 数字。层级只有四档，不许逐页乱调。 */
+    readonly type: {
+        readonly kicker: 10.5;
+        readonly title: 32;
+        readonly lead: 21;
+        readonly body: 15;
+        readonly small: 15;
+        readonly tiny: 11.5;
+        readonly stat: 54;
+    };
+    /** 纸色 + 墨色 + 单一强调色（克莱因蓝）。不用纯白纯黑。 */
+    readonly color: {
+        readonly paper: "#FAFAF8";
+        readonly ink: "#141414";
+        readonly ink2: "#5A5A56";
+        readonly hairline: "#D9D6CC";
+        readonly card: "#F0EEE8";
+        readonly accent: "#002FA7";
+    };
+    /** 一页最多几条要点；再多就不是幻灯而是说明书。 */
+    readonly rules: {
+        readonly maxBullets: 4;
+        readonly maxBulletChars: 30;
+        readonly maxTitleChars: 20;
+        readonly minVisualPages: 2;
+        readonly maxSameLayoutRatio: 0.6;
+    };
+};
+/**
+ * 版面类型。名字即契约：`<!-- _class: compare -->` 会渲染成左右对照版，
+ * 而不是又一段项目符号。
+ */
+export declare const DECK_LAYOUTS: readonly ["cover", "agenda", "compare", "rows", "steps", "cards", "figure", "columns", "stats", "closing"];
+export type DeckLayout = (typeof DECK_LAYOUTS)[number];
+export interface DeckPage {
+    /** 从 1 开始。 */
+    readonly index: number;
+    /** 缺省为 `bullets`（没有任何 `_class` 的纯要点页）。 */
+    readonly layout: DeckLayout | 'bullets';
+    readonly title: string;
+    readonly bullets: readonly string[];
+    /** 本页有几个 `[panel]` 分栏（≥2 时要点按栏均分，不按页计）。 */
+    readonly panels: number;
+    readonly hasNotes: boolean;
+}
+export interface DesignIssue {
+    readonly code: string;
+    readonly level: 'error' | 'warn';
+    readonly where: string;
+    readonly message: string;
+}
+/** 把 Marp Markdown 切成页，读出每页的版面类型与要点数。 */
+export declare function parseDeckPages(markdown: string): DeckPage[];
+/**
+ * 确定性版式检查。返回空数组表示"版面不单调、每页都讲得清"。
+ *
+ * 刻意只查**可机器判定**的事：版面分布、要点数量、连续无图、封面结尾。
+ * 配色好不好看、话术顺不顺，仍然要人看。
+ */
+export declare function designIssues(pages: readonly DeckPage[]): DesignIssue[];
+/** 中文按字计、西文按 0.5 字计——幻灯上的长度用"视觉字数"衡量才准。 */
+export declare function cjkLen(text: string): number;