dsh-thesis 1.0.0

package/lib/paper/lib/check.js

@@ -0,0 +1,215 @@
+/**
+ * 全文综合检查（thesis_check 的核心），五项确定性检查：
+ * 1. 引用双向一致：文中引用 ↔ refs.bib（顺序编码制下编号=条目顺序）
+ * 2. 字数统计：每章 CJK 字数 vs 目标区间 + 全文合计
+ * 3. 图/表编号：每章章号与连续性（复用 review 的检查器）
+ * 4. 术语定义先于使用：缩写（ABBR）第一次出现必须在定义"全称（ABBR）"之后
+ * 5. 学校模板探测：assets/学校模板 有无模板文件
+ */
+import { parseBibKeysOrdered } from "./bibtex.js";
+import { chapterMetaFor, CHAPTER_META } from "./layout.js";
+import { checkNumberedObjects } from "./review.js";
+// ---------------------------------------------------------------------------
+// 1. 引用双向一致
+// ---------------------------------------------------------------------------
+function citedNumbersIn(text) {
+    const numbers = new Set();
+    for (const m of text.matchAll(/\[(\d+(?:[-,，]\d+)*)\]/g)) {
+        for (const part of m[1].split(/[,，]/)) {
+            const range = /^(\d+)-(\d+)$/.exec(part);
+            if (range !== null) {
+                for (let n = Number(range[1]); n <= Number(range[2]); n += 1)
+                    numbers.add(n);
+            }
+            else if (/^\d+$/.test(part)) {
+                numbers.add(Number(part));
+            }
+        }
+    }
+    return [...numbers].sort((a, b) => a - b);
+}
+function checkCitationsGlobal(input) {
+    const lines = [];
+    const allCited = new Set();
+    const byChapter = new Map();
+    for (const chapter of input.chapters) {
+        const cited = citedNumbersIn(chapter.text);
+        byChapter.set(chapter.name, cited);
+        for (const n of cited)
+            allCited.add(n);
+    }
+    const bibKeys = parseBibKeysOrdered(input.bibText);
+    const bibCount = bibKeys.length;
+    if (bibCount === 0 && allCited.size > 0) {
+        lines.push(`✗ refs.bib 为空（0 条），但正文引用了 [${[...allCited].join('、')}]。请先经 thesis_lit_search/save 收录文献。`);
+        return { id: 'citations', title: '引用双向一致', ok: false, lines };
+    }
+    if (bibCount === 0) {
+        lines.push('⚠ 文献库为空。绪论与相关技术章写作前，请先用 thesis_lit_search 检索真实文献。');
+        return { id: 'citations', title: '引用双向一致', ok: false, lines };
+    }
+    const citedList = [...allCited].sort((a, b) => a - b);
+    const max = citedList[citedList.length - 1] ?? 0;
+    const outOfRange = citedList.filter(n => n > bibCount);
+    if (outOfRange.length > 0) {
+        lines.push(`✗ 引用编号超出文献库：${outOfRange.map(n => `[${n}]`).join('、')}（refs.bib 共 ${bibCount} 条）。`);
+    }
+    // 未被引用的条目（躺尸文献）
+    const uncited = Array.from({ length: bibCount }, (_v, i) => i + 1).filter(n => !allCited.has(n));
+    if (uncited.length > 0) {
+        const keys = uncited.map(n => bibKeys[n - 1] ?? `#${n}`).join('、');
+        lines.push(`⚠ 文献库中 ${uncited.length} 条从未被正文引用：${keys}。要么在正文补引，要么从 refs.bib 删除。`);
+    }
+    // 引用编号不连续（有 [3] 无 [2]）
+    for (let n = 1; n <= max; n += 1) {
+        if (!allCited.has(n)) {
+            lines.push(`⚠ 引用编号不连续：缺 [${n}]（顺序编码制下编号应与文献表顺序一致）。`);
+            break;
+        }
+    }
+    // 章级概览
+    const chapterStats = input.chapters.map(c => `${c.name}: [${(byChapter.get(c.name) ?? []).join('、') || '无'}]`).join('；');
+    lines.push(`章级引用：${chapterStats}。`);
+    if (lines.length === 1) {
+        lines.unshift(`✓ 正文引用与 refs.bib（${bibCount} 条）双向一致：${citedList.length === 0 ? '正文暂无引用' : `引用编号 ${citedList.join('、')} 均有对应条目`}。`);
+    }
+    return { id: 'citations', title: '引用双向一致', ok: outOfRange.length === 0 && bibCount > 0, lines };
+}
+// ---------------------------------------------------------------------------
+// 2. 字数统计
+// ---------------------------------------------------------------------------
+function checkWordCountsGlobal(input) {
+    const lines = [];
+    let total = 0;
+    let problems = 0;
+    for (const chapter of input.chapters) {
+        const located = chapterMetaFor(chapter.name);
+        const count = (chapter.text.match(/[\u4e00-\u9fff]/g) ?? []).length;
+        total += count;
+        const rangeMatch = located === undefined ? null : /(\d+)\s*[-–]\s*(\d+)/.exec(located.meta.words);
+        if (rangeMatch === null) {
+            lines.push(`- ${chapter.name}：${count} 字（目标未知）`);
+            continue;
+        }
+        const min = Number(rangeMatch[1]);
+        const max = Number(rangeMatch[2]);
+        const ok = count >= min && count <= max;
+        if (!ok)
+            problems += 1;
+        lines.push(`- ${chapter.name}：${count} 字 / 目标 ${min}-${max} ${ok ? '✓' : `✗（${count < min ? `差 ${min - count}` : `超 ${count - max}`}）`}`);
+    }
+    lines.push(`- 全文合计：${total} 字（常见本科要求 1.5-2 万，以学校文件为准）`);
+    return { id: 'words', title: '字数统计', ok: problems === 0, lines };
+}
+// ---------------------------------------------------------------------------
+// 3. 图/表编号（全文逐章）
+// ---------------------------------------------------------------------------
+function checkFiguresGlobal(input) {
+    const lines = [];
+    let problems = 0;
+    for (const chapter of input.chapters) {
+        for (const kind of ['图', '表']) {
+            const finding = checkNumberedObjects(chapter.text, chapter.no, kind);
+            if (!finding.ok) {
+                problems += 1;
+                lines.push(`✗ ${chapter.name} ${finding.detail}`);
+            }
+        }
+    }
+    if (problems === 0)
+        lines.push('✓ 各章图/表编号章号正确、序号连续（无图表的章不计）。');
+    return { id: 'figures', title: '图/表编号', ok: problems === 0, lines };
+}
+// ---------------------------------------------------------------------------
+// 4. 术语定义先于使用
+// ---------------------------------------------------------------------------
+const DEF_RE = /[\u4e00-\u9fff]{2,20}（([A-Z]{2,10})）/g;
+function checkTerminology(input) {
+    const lines = [];
+    // 第一遍：记录每个缩写的首次定义章。
+    const definedAt = new Map();
+    input.chapters.forEach((chapter, idx) => {
+        for (const m of chapter.text.matchAll(DEF_RE)) {
+            const abbr = m[1];
+            if (!definedAt.has(abbr))
+                definedAt.set(abbr, idx);
+        }
+    });
+    // 第二遍：在"去掉定义点"的文本里找使用，出现在定义章之前 → 违规。
+    const problems = new Map();
+    input.chapters.forEach((chapter, idx) => {
+        const scanText = chapter.text.replace(/（[A-Z]{2,10}）/g, '（）');
+        for (const abbr of definedAt.keys()) {
+            const defIdx = definedAt.get(abbr);
+            if (idx >= defIdx)
+                continue;
+            const re = new RegExp(`(^|[^A-Za-z\u4e00-\u9fff])${abbr}([^A-Za-z\u4e00-\u9fff]|$)`, 'g');
+            if (re.test(scanText)) {
+                problems.set(abbr, defIdx);
+            }
+        }
+    });
+    if (problems.size === 0) {
+        lines.push(definedAt.size === 0
+            ? '✓ 未发现缩写术语定义（如使用缩写，请按"全称（缩写）"首次定义）。'
+            : `✓ 已定义的 ${definedAt.size} 个缩写（${[...definedAt.keys()].join('、')}）均未在定义前使用。`);
+        return { id: 'terms', title: '术语定义先于使用', ok: true, lines };
+    }
+    for (const [abbr, defIdx] of problems) {
+        lines.push(`✗ ${abbr} 在第 ${defIdx + 1} 章才定义，但更早章节已使用。缩写首次出现时应写"全称（${abbr}）"。`);
+    }
+    return { id: 'terms', title: '术语定义先于使用', ok: false, lines };
+}
+// ---------------------------------------------------------------------------
+// 5. 学校模板探测
+// ---------------------------------------------------------------------------
+function checkTemplate(templateFiles) {
+    const hasTemplate = templateFiles.some(f => /\.(docx?|dotx?)$/i.test(f));
+    if (hasTemplate) {
+        return {
+            id: 'template',
+            title: '学校模板',
+            ok: true,
+            lines: [`✓ 发现学校模板文件：${templateFiles.filter(f => /\.(docx?|dotx?)$/i.test(f)).join('、')}。thesis_build 将优先使用。`],
+        };
+    }
+    return {
+        id: 'template',
+        title: '学校模板',
+        ok: false,
+        lines: [
+            '⚠ 06-论文/assets/学校模板/ 中未发现模板文件（.doc/.docx）。',
+            '  thesis_build 将使用内置过渡模板并显式标注"非学校模板"。',
+            '  提交前请从教务处/学院获取模板放入该目录后重建。',
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// 汇总
+// ---------------------------------------------------------------------------
+export function runGlobalCheck(input) {
+    const sections = [
+        checkCitationsGlobal(input),
+        checkWordCountsGlobal(input),
+        checkFiguresGlobal(input),
+        checkTerminology(input),
+        checkTemplate(input.templateFiles),
+    ];
+    return { sections, allOk: sections.every(s => s.ok) };
+}
+export function renderCheckReport(report) {
+    const lines = [];
+    for (const section of report.sections) {
+        lines.push(`## ${section.title}`);
+        lines.push('');
+        for (const line of section.lines)
+            lines.push(line);
+        lines.push('');
+    }
+    const failed = report.sections.filter(s => !s.ok).length;
+    lines.push(report.allOk
+        ? '结论：全部检查通过。剩余风险项（重复率、AI 检测）请按 08-合规/自查报告.md 流程自查。'
+        : `结论：${failed} 个检查项需处理。修复后重跑 thesis_check。`);
+    return lines.join('\n');
+}
+export { CHAPTER_META };

package/lib/paper/lib/defense.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 答辩准备（thesis_defense 的核心）。
+ *
+ * 工具做"机器可提取"的部分：从论文工作区提取答辩素材（课题、章节概览、
+ * 技术选型、关键决定、测试数据、git 工作量），生成：
+ * - 07-答辩/答辩素材.md —— 素材摘要（答辩讲稿的事实底座）
+ * - 07-答辩/预答辩问题库.md —— 六类必问问题模板 + 证据锚点
+ *
+ * 问题的具体化与模拟问答由 AI（结合模型能力与素材）和用户共同完成，
+ * 流程见技能 thesis-defense。
+ */
+export interface ChapterDigest {
+    readonly name: string;
+    readonly no: number;
+    readonly title: string;
+    readonly cjk: number;
+    readonly headings: readonly string[];
+    readonly citations: number;
+}
+export declare function extractHeadings(text: string): string[];
+/** 提取技术选型表（03-设计/技术选型论证.md 的表格行）。 */
+export declare function extractTechChoices(text: string): string[][];
+/** 提取决定日志条目标题。 */
+export declare function extractDecisionTitles(log: string): string[];
+/** 统计测试计划用例数（TC-x 行）。 */
+export declare function countTestCases(plan: string): number;
+export interface GitStats {
+    readonly commits: number;
+    readonly firstCommit?: string;
+    readonly lastCommit?: string;
+    readonly ok: boolean;
+    readonly error?: string;
+}
+export type GitRunner = (root: string) => GitStats;
+/** 默认实现：真实运行 git（子进程）。测试注入替身。 */
+export declare const spawnGitStats: GitRunner;
+export interface DefenseInput {
+    readonly title: string;
+    readonly chapters: readonly ChapterDigest[];
+    readonly techChoices: readonly (readonly string[])[];
+    readonly decisions: readonly string[];
+    readonly testCases: number;
+    readonly resultFiles: readonly string[];
+    readonly bibCount: number;
+    readonly git: GitStats;
+}
+export declare function renderDefenseMaterials(input: DefenseInput, now?: Date): string;
+export declare function renderQuestionBank(title: string, now?: Date): string;

package/lib/paper/lib/defense.js

@@ -0,0 +1,220 @@
+/**
+ * 答辩准备（thesis_defense 的核心）。
+ *
+ * 工具做"机器可提取"的部分：从论文工作区提取答辩素材（课题、章节概览、
+ * 技术选型、关键决定、测试数据、git 工作量），生成：
+ * - 07-答辩/答辩素材.md —— 素材摘要（答辩讲稿的事实底座）
+ * - 07-答辩/预答辩问题库.md —— 六类必问问题模板 + 证据锚点
+ *
+ * 问题的具体化与模拟问答由 AI（结合模型能力与素材）和用户共同完成，
+ * 流程见技能 thesis-defense。
+ */
+import { spawnSync } from 'node:child_process';
+export function extractHeadings(text) {
+    return text.split('\n').map(l => l.trim()).filter(l => /^#{1,3}\s/.test(l)).map(l => l.replace(/^#{1,3}\s+/, ''));
+}
+function countCitations(text) {
+    const numbers = new Set();
+    for (const m of text.matchAll(/\[(\d+(?:[-,，]\d+)*)\]/g)) {
+        for (const part of m[1].split(/[,，]/)) {
+            const range = /^(\d+)-(\d+)$/.exec(part);
+            if (range !== null) {
+                for (let n = Number(range[1]); n <= Number(range[2]); n += 1)
+                    numbers.add(n);
+            }
+            else if (/^\d+$/.test(part)) {
+                numbers.add(Number(part));
+            }
+        }
+    }
+    return numbers.size;
+}
+/** 提取技术选型表（03-设计/技术选型论证.md 的表格行）。 */
+export function extractTechChoices(text) {
+    const rows = [];
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('|') || !trimmed.endsWith('|'))
+            continue;
+        const cells = trimmed.slice(1, -1).split('|').map(c => c.trim());
+        const isSeparator = cells.every(c => /^:?-{2,}:?$/.test(c));
+        const isHeader = cells.some(c => /选型项|选择|理由/.test(c));
+        if (isSeparator || isHeader || cells.every(c => c === ''))
+            continue;
+        rows.push(cells);
+    }
+    return rows;
+}
+/** 提取决定日志条目标题。 */
+export function extractDecisionTitles(log) {
+    const titles = [];
+    for (const m of log.matchAll(/^## (\d{4}-\d{2}-\d{2}) · (.+)$/gm)) {
+        titles.push(`${m[1]} ${m[2]}`);
+    }
+    return titles;
+}
+/** 统计测试计划用例数（TC-x 行）。 */
+export function countTestCases(plan) {
+    return (plan.match(/^\|\s*TC-\d+/gm) ?? []).length;
+}
+/** 默认实现：真实运行 git（子进程）。测试注入替身。 */
+export const spawnGitStats = (root) => {
+    try {
+        const count = spawnSync('git', ['-C', root, 'rev-list', '--count', 'HEAD'], { encoding: 'utf8' });
+        if (count.status !== 0)
+            return { commits: 0, ok: false, error: (count.stderr ?? '').trim() };
+        const first = spawnSync('git', ['-C', root, 'log', '--reverse', '--format=%cs', 'HEAD'], { encoding: 'utf8' });
+        const last = spawnSync('git', ['-C', root, 'log', '-1', '--format=%cs', 'HEAD'], { encoding: 'utf8' });
+        const firstDate = (first.stdout ?? '').trim().split('\n')[0] ?? '';
+        return {
+            commits: Number.parseInt((count.stdout ?? '').trim(), 10) || 0,
+            ...(firstDate !== '' ? { firstCommit: firstDate } : {}),
+            ...((last.stdout ?? '').trim() !== '' ? { lastCommit: (last.stdout ?? '').trim() } : {}),
+            ok: true,
+        };
+    }
+    catch (error) {
+        return { commits: 0, ok: false, error: String(error) };
+    }
+};
+export function renderDefenseMaterials(input, now = new Date()) {
+    const lines = [];
+    lines.push('# 答辩素材');
+    lines.push('');
+    lines.push(`> 由 thesis_defense 自动提取；时间：${now.toISOString()}`);
+    lines.push('> 这是答辩讲稿的事实底座——PPT 每页内容、问答答案都以这里的材料为准。');
+    lines.push('');
+    lines.push(`## 课题`);
+    lines.push('');
+    lines.push(input.title);
+    lines.push('');
+    lines.push('## 章节概览');
+    lines.push('');
+    for (const chapter of input.chapters) {
+        lines.push(`### 第 ${chapter.no} 章 ${chapter.title}（${chapter.cjk} 字，引用 ${chapter.citations} 处）`);
+        lines.push('');
+        for (const heading of chapter.headings)
+            lines.push(`- ${heading}`);
+        lines.push('');
+    }
+    lines.push('## 技术选型（答辩必问"为什么"）');
+    lines.push('');
+    if (input.techChoices.length === 0) {
+        lines.push('（03-设计/技术选型论证.md 尚无选型记录）');
+    }
+    else {
+        for (const row of input.techChoices)
+            lines.push(`- ${row[0] ?? '?'}：${row[1] ?? '?'}（理由：${row[2] ?? '未填'}；备选：${row[3] ?? '未填'}）`);
+    }
+    lines.push('');
+    lines.push('## 关键决定（决定日志）');
+    lines.push('');
+    if (input.decisions.length === 0)
+        lines.push('（暂无记录——答辩前把关键决策补录进决定日志）');
+    for (const title of input.decisions)
+        lines.push(`- ${title}`);
+    lines.push('');
+    lines.push('## 测试与数据');
+    lines.push('');
+    lines.push(`- 测试用例：${input.testCases} 个（05-实验测试/测试计划.md）`);
+    lines.push(`- 结果文件：${input.resultFiles.length === 0 ? '（尚无真实结果文件——红线：所有答辩数据必须真实可复现）' : input.resultFiles.join('、')}`);
+    lines.push('');
+    lines.push('## 工作量（git）');
+    lines.push('');
+    if (!input.git.ok) {
+        lines.push(`（git 统计不可用：${input.git.error ?? '未知原因'}）`);
+    }
+    else {
+        lines.push(`- 提交：${input.git.commits} 次`);
+        if (input.git.firstCommit !== undefined && input.git.lastCommit !== undefined) {
+            lines.push(`- 跨度：${input.git.firstCommit} ~ ${input.git.lastCommit}`);
+        }
+    }
+    lines.push('');
+    lines.push('## 文献');
+    lines.push('');
+    lines.push(`refs.bib 收录 ${input.bibCount} 条（全部真实检索，审计记录见 02-文献/检索记录.md）`);
+    lines.push('');
+    return lines.join('\n');
+}
+const QUESTION_CATEGORIES = [
+    {
+        name: '一、实现细节（必问，老师会逐模块追问）',
+        anchor: '04-实现 代码 + 05-实验测试/结果 截图',
+        questions: [
+            '<核心模块>具体怎么实现的？核心流程从头讲一遍。',
+            '系统有哪些关键模块/数据表？数据在它们之间怎么流转？',
+            '开发中遇到的最难的问题是什么？怎么定位和解决的？',
+            '如果并发量/数据量扩大 10 倍，你的设计哪里会先出问题？',
+        ],
+    },
+    {
+        name: '二、技术选型（答辩高频"为什么"）',
+        anchor: '03-设计/技术选型论证.md + 决定日志',
+        questions: [
+            '为什么选 <技术 A> 而不是 <备选 B>？',
+            '<技术 A> 的缺点是什么？你在设计里怎么缓解的？',
+            '如果现在换成 <备选 B>，需要改动哪些部分？',
+        ],
+    },
+    {
+        name: '三、需求与背景',
+        anchor: '03-设计/需求分析.md（FR/NFR 编号）',
+        questions: [
+            '这个系统的需求是怎么来的？谁在用、解决什么实际问题？',
+            '哪条功能需求最难实现？为什么？',
+            '你的系统与现有同类系统/方案相比，差异和亮点是什么？',
+        ],
+    },
+    {
+        name: '四、工作量与过程（诚实原则）',
+        anchor: 'git 提交记录 + 决定日志 + 时间线',
+        questions: [
+            '哪些部分是你独立完成的？开发花了多久？',
+            'AI 辅助了哪些环节？你自己做的关键决策有哪些？',
+            '中期检查之后方案有没有调整？为什么调整？',
+        ],
+    },
+    {
+        name: '五、数据可信',
+        anchor: '05-实验测试/测试计划.md + 结果/（须可复现）',
+        questions: [
+            '测试数据是怎么得到的？能现场演示/复现吗？',
+            '性能指标用什么工具测的？测试环境是什么？',
+            '有没有失败过的用例？后来怎么处理的？',
+        ],
+    },
+    {
+        name: '六、不足与展望',
+        anchor: '07-总结与展望.md + 绪论 1.3 本文主要工作',
+        questions: [
+            '你觉得这个系统哪里做得不够好？',
+            '如果重新做一次，你会怎么改进？',
+            '后续如果要继续做，方向是什么？',
+        ],
+    },
+];
+export function renderQuestionBank(title, now = new Date()) {
+    const lines = [];
+    lines.push('# 预答辩问题库');
+    lines.push('');
+    lines.push(`> 课题：${title}；由 thesis_defense 生成骨架；时间：${now.toISOString()}`);
+    lines.push('> 使用方法：AI 依据《答辩素材》把 <> 占位替换为你的系统实际名称，生成 15-20 个具体问题；');
+    lines.push('> 你逐题回答并记录要点；答不上的回对应材料补学。演练流程见技能 thesis-defense。');
+    lines.push('');
+    for (const category of QUESTION_CATEGORIES) {
+        lines.push(`## ${category.name}`);
+        lines.push('');
+        lines.push(`证据锚点：${category.anchor}`);
+        lines.push('');
+        for (const question of category.questions) {
+            lines.push(`- [ ] ${question}`);
+        }
+        lines.push('');
+    }
+    lines.push('## 我的回答记录');
+    lines.push('');
+    lines.push('（每题回答后把要点记在这里；至少完整演练 2 轮，第 2 轮随机抽题）');
+    lines.push('');
+    return lines.join('\n');
+}

package/lib/paper/lib/docx.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 零依赖 .docx 生成：Markdown-lite → WordprocessingML。
+ *
+ * 覆盖论文写作实际用到的 Markdown 子集：
+ * - 标题 # / ## / ###（H1 每章另起一页）
+ * - 段落、粗体 **text**、行内代码 `code`、链接 [text](url)
+ * - 无序列表 - item、表格 | a | b |
+ * - G2 清单 - [ ] / - [x] 保持为列表项文本
+ *
+ * 中文排版：正文宋体 + Times New Roman、1.5 倍行距；标题黑体。
+ * 这是内置过渡引擎；机器装有 pandoc 时 thesis_build 优先走 pandoc。
+ */
+type Block = {
+    readonly kind: 'h1' | 'h2' | 'h3';
+    readonly text: string;
+} | {
+    readonly kind: 'p';
+    readonly text: string;
+} | {
+    readonly kind: 'bullet';
+    readonly text: string;
+} | {
+    readonly kind: 'table';
+    readonly rows: readonly (readonly string[])[];
+};
+export declare function parseMarkdownBlocks(markdown: string): Block[];
+export interface DocxOptions {
+    readonly title: string;
+    readonly markdown: string;
+}
+/**
+ * 生成完整 .docx 字节。title 渲染为封面页；markdown 为正文（章节合并内容）。
+ */
+export declare function buildDocx(opts: DocxOptions): Uint8Array;
+export {};