dsh-thesis 1.0.0

package/lib/dedup/report.js

@@ -0,0 +1,309 @@
+/**
+ * 降重报告的渲染：分级、行号、命中来源、原文片段、处方、全文加权重复率估算，
+ * 以及可回填的「学校检测结果」区块。
+ *
+ * 报告口径（必须与文字一起出现，不得省去）：
+ * - 本地相似度是**字符串重合度估算**，算法为 shingle 指纹 + 包含率，
+ *   只在用户给定的参考语料内比较，**不等于**知网/维普等系统的重复率；
+ * - 本插件不接入任何收费查重系统（无账号、也不应接入）；学校结果是权威口径，
+ *   用户自行送检后可把重复率回填进本报告，用于对齐两套口径的差距。
+ *
+ * @module dsh-thesis/dedup
+ */
+import { planRewrite, renderPlan } from "./rewrite.js";
+const EXCERPT_LIMIT = 120;
+/** 估算口径说明（单一来源，Markdown 与结构化对象共用）。 */
+export const ALGORITHM_NOTE = '字符 4-gram shingle 指纹 + 段内包含率（containment）；只在给定参考语料内比较字符串重合，'
+    + '不含语义改写、不含跨语言、不含图片/公式。因此本报告的"重复率"是**估算值**，'
+    + '与知网/维普等系统的口径、语料、算法都不同，绝不等同于学校检测结果。';
+/** 边界说明（写入报告，避免误用）。 */
+export const BOUNDARY_NOTES = [
+    '本工具**不接入**知网、维普、万方等收费查重系统：既没有账号授权，也不应绕过其授权接入。',
+    '本地估算只覆盖"用户给定的参考语料"——语料之外的来源不会被发现，语料越全越接近真实风险。',
+    '本地估算识别不了同义替换、语序调整、翻译改写等"洗稿"手段，指标低不等于绝对安全。',
+    '学校检测结果是权威口径；请把自行送检得到的重复率回填到本报告，用于对齐两套口径的差距。',
+];
+function clip(text, max) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length <= max ? flat : `${flat.slice(0, max)}…`;
+}
+/**
+ * 全文加权重复率估计（口径明确、可复现）：
+ * `Σ(命中段落归一化字符数 × 该段最佳命中得分) / 全文参与比对的字符总数`。
+ * 分母包含**未命中段落**（按 0 计入），因此该值是保守估计（不会低报）。
+ */
+export function weightedRateOf(scanResult) {
+    if (scanResult.totalChars === 0)
+        return 0;
+    let weighted = 0;
+    for (const item of scanResult.items) {
+        weighted += item.segment.doc.chars.length * item.best.score;
+    }
+    return weighted / scanResult.totalChars;
+}
+function levelOf(score, threshold) {
+    if (score >= threshold)
+        return 'high';
+    if (score >= threshold * 0.6)
+        return 'medium';
+    return 'low';
+}
+/** 结构化报告对象即「报告的结构化形态」。 */
+export function buildReport(scanResult, options) {
+    const sources = new Set();
+    const risks = [];
+    for (const item of scanResult.items) {
+        const level = levelOf(item.best.score, options.threshold);
+        if (level === 'low')
+            continue;
+        sources.add(item.best.label);
+        const plan = planRewrite(item);
+        risks.push({
+            level,
+            chapter: item.segment.chapter,
+            file: item.segment.file,
+            lineStart: item.segment.lineStart,
+            lineEnd: item.segment.lineEnd,
+            score: item.best.score,
+            source: item.best.label,
+            excerpt: clip(item.segment.raw, EXCERPT_LIMIT),
+            matches: item.best.spans.map(span => ({
+                lineStart: span.lineStart,
+                lineEnd: span.lineEnd,
+                text: clip(span.text, EXCERPT_LIMIT),
+            })),
+            plan,
+            text: item.segment.raw,
+        });
+    }
+    risks.sort((a, b) => b.score - a.score
+        || (a.chapter < b.chapter ? -1 : a.chapter > b.chapter ? 1 : 0)
+        || a.lineStart - b.lineStart);
+    const report = {
+        summary: {
+            paragraphCount: scanResult.paragraphCount,
+            matchedCount: scanResult.matchedCount,
+            high: scanResult.high,
+            medium: scanResult.medium,
+            low: scanResult.low,
+            sourceCount: sources.size,
+            weightedRate: weightedRateOf(scanResult),
+        },
+        risks,
+        algorithm: ALGORITHM_NOTE,
+        generatedAt: (options.now ?? new Date()).toISOString(),
+        boundaries: [...BOUNDARY_NOTES],
+    };
+    if (options.detected !== undefined) {
+        return { ...report, detected: normalizeDetected(options.detected) };
+    }
+    return report;
+}
+function normalizeDetected(detected) {
+    const rate = detected.rate > 1 ? detected.rate / 100 : detected.rate;
+    const normalized = { rate: Math.max(0, Math.min(1, rate)) };
+    const withSystem = detected.system === undefined ? normalized : { ...normalized, system: detected.system };
+    return detected.date === undefined ? withSystem : { ...withSystem, date: detected.date };
+}
+export function levelLabel(level) {
+    if (level === 'high')
+        return '高';
+    if (level === 'medium')
+        return '中';
+    return '低';
+}
+/** 渲染 Markdown 报告。 */
+export function renderReport(report, options) {
+    const lines = [];
+    const summary = report.summary;
+    lines.push('# 降重报告（本地相似度度量）');
+    lines.push('');
+    lines.push(`> 工具：thesis_originality；生成时间：${report.generatedAt}`);
+    lines.push(`> 参数：shingle=${options.shingle}，threshold=${options.threshold}，minChars=${options.minChars}`);
+    if (options.corpusLabels !== undefined && options.corpusLabels.length > 0) {
+        lines.push(`> 参考语料：${options.corpusLabels.join('、')}`);
+    }
+    lines.push('');
+    lines.push('## 0 边界声明（先读这一段）');
+    lines.push('');
+    for (const note of report.boundaries)
+        lines.push(`- ${note}`);
+    lines.push('');
+    lines.push('## 1 汇总');
+    lines.push('');
+    lines.push(`- 正文段落：${summary.paragraphCount} 段（跳过标题/代码块/公式行/参考文献/表格与短段落）`);
+    lines.push(`- 有命中段落：${summary.matchedCount} 段；高风险 ${summary.high} 段，中风险 ${summary.medium} 段，低风险 ${summary.low} 段`);
+    lines.push(`- 命中来源：${summary.sourceCount} 个`);
+    lines.push(`- 全文加权重复率**估算｜**：${(summary.weightedRate * 100).toFixed(1)}%`);
+    lines.push('');
+    lines.push(`估算口径：${report.algorithm}`);
+    lines.push('');
+    lines.push('## 2 Top 风险段落');
+    lines.push('');
+    const top = report.risks.slice(0, 5);
+    if (top.length === 0) {
+        lines.push('无中/高风险段落。注意：指标低不等于绝对安全，见第 0 节边界声明。');
+    }
+    else {
+        lines.push('| # | 分级 | 章节 | 行号 | 得分 | 命中来源 |');
+        lines.push('|---|---|---|---|---|---|');
+        top.forEach((risk, index) => {
+            lines.push(`| ${index + 1} | ${levelLabel(risk.level)} | ${risk.chapter} | ${risk.lineStart}-${risk.lineEnd} | ${(risk.score * 100).toFixed(1)}% | ${risk.source} |`);
+        });
+        lines.push('');
+        for (const risk of top)
+            lines.push(`${risk.excerpt}`, '');
+    }
+    lines.push('## 3 高风险段落与改写处方');
+    lines.push('');
+    const high = report.risks.filter(risk => risk.level === 'high');
+    if (high.length === 0) {
+        lines.push('无高风险段落（≥ 阈值的段落）。中风险段落见第 4 节。');
+    }
+    for (const risk of high) {
+        lines.push(`**原文（${risk.chapter} 第 ${risk.lineStart}-${risk.lineEnd} 行，${risk.file}）**`);
+        lines.push('');
+        lines.push(`> ${risk.excerpt}`);
+        lines.push('');
+        lines.push(renderPlan(risk.plan));
+    }
+    lines.push('## 4 中风险段落（逐条判断后改写）');
+    lines.push('');
+    const medium = report.risks.filter(risk => risk.level === 'medium');
+    if (medium.length === 0) {
+        lines.push('无中风险段落。');
+        lines.push('');
+    }
+    else {
+        lines.push('| 章节 | 行号 | 得分 | 命中来源 | 命中片段 |');
+        lines.push('|---|---|---|---|---|');
+        for (const risk of medium) {
+            const span = risk.matches[0];
+            lines.push(`| ${risk.chapter} | ${risk.lineStart}-${risk.lineEnd} | ${(risk.score * 100).toFixed(1)}% | ${risk.source} | ${span === undefined ? '（碎片化重合）' : clip(span.text, 40)} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## 5 学校检测结果（用户自行送检后回填）');
+    lines.push('');
+    if (report.detected === undefined) {
+        lines.push('- 学校/检测系统名称：________');
+        lines.push('- 送检日期：________');
+        lines.push('- 检测重复率：________%');
+        lines.push('- 与本地估算的差距说明：________');
+        lines.push('');
+        lines.push('回填方式：把上述数字作为 `thesis_originality` 的 `detected_rate` 重新执行 `report`，本区块会自动填好。');
+    }
+    else {
+        const detected = report.detected;
+        const gap = detected.rate - summary.weightedRate;
+        lines.push(`- 检测系统：${detected.system ?? '（未填写）'}`);
+        lines.push(`- 送检日期：${detected.date ?? '（未填写）'}`);
+        lines.push(`- 检测重复率：${(detected.rate * 100).toFixed(1)}%（权威口径）`);
+        lines.push(`- 本地估算：${(summary.weightedRate * 100).toFixed(1)}%`);
+        lines.push(`- 差距：${gap >= 0 ? '+' : ''}${(gap * 100).toFixed(1)} 个百分点（本地${gap >= 0 ? '偏低' : '偏高'}）`);
+        lines.push('');
+        lines.push('差距常见原因：本地语料不含学校比对库；同义改写/翻译改写无法被字符串指纹发现。'
+            + '若学校结果明显更高，请扩充参考语料（把可能的来源文本放进语料目录）并重跑 scan。');
+    }
+    lines.push('');
+    lines.push('## 6 下一步建议');
+    lines.push('');
+    lines.push('1. 先处理高风险段落：按处方改结构（拆句、换语序、主被动），保留全部数字与引用。');
+    lines.push('2. 命中来源若为文献笔记，改为直接引用 + `[n]` 标注，不要改写成自己的话。');
+    lines.push('3. 改写完成后执行 `thesis_originality` `verify`，用本次报告作 `baseline` 复测降幅。');
+    lines.push('4. 送检后把真实重复率回填（`detected_rate`），对齐本地估算与学校口径。');
+    lines.push('');
+    return lines.join('\n');
+}
+/** 从 baseline 报告（Markdown）解析出汇总指标；解析失败返回 null。 */
+export function parseBaseline(markdown) {
+    const paragraph = /正文段落：(\d+)\s*段/.exec(markdown);
+    const matched = /有命中段落：(\d+)\s*段/.exec(markdown);
+    const high = /高风险\s*(\d+)\s*段/.exec(markdown);
+    const medium = /中风险\s*(\d+)\s*段/.exec(markdown);
+    const rate = /全文加权重复率\*\*估算｜\*\*：([0-9.]+)%/.exec(markdown);
+    if (paragraph === null || matched === null || rate === null)
+        return null;
+    return {
+        paragraphCount: Number(paragraph[1]),
+        matchedCount: Number(matched[1]),
+        high: high === null ? 0 : Number(high[1]),
+        medium: medium === null ? 0 : Number(medium[1]),
+        weightedRate: Number(rate[1]) / 100,
+    };
+}
+/** 计算复测降幅（正数 = 下降）。 */
+export function verifyDelta(baseline, current) {
+    const rateDrop = baseline.weightedRate - current.weightedRate;
+    const rateDropRatio = baseline.weightedRate === 0 ? 0 : rateDrop / baseline.weightedRate;
+    let verdict;
+    if (current.high > 0) {
+        verdict = `仍有 ${current.high} 段高风险：继续按处方改写后再次 verify。`;
+    }
+    else if (rateDrop <= 0 && baseline.weightedRate > 0) {
+        verdict = '加权重复率未下降：本次改写没有改变指纹重合（常见原因是只换同义词），请改结构后复测。';
+    }
+    else if (rateDropRatio >= 0.5) {
+        verdict = '降幅达标（≥50%）：保持当前写法，进入下一轮自查（AI 味 + 引用检查）。';
+    }
+    else {
+        verdict = '降幅有限：优先处理剩余中风险段落，或把命中来源改为直接引用。';
+    }
+    return {
+        baseline,
+        current,
+        rateDrop,
+        rateDropRatio,
+        highDrop: baseline.high - current.high,
+        mediumDrop: baseline.medium - current.medium,
+        verdict,
+    };
+}
+/** 渲染复测报告（降重报告-复测.md）。 */
+export function renderVerifyReport(delta, options, riskSource) {
+    const lines = [];
+    lines.push('# 降重复测报告');
+    lines.push('');
+    lines.push(`> 工具：thesis_originality verify；生成时间：${riskSource.generatedAt}`);
+    lines.push(`> 参数：shingle=${options.shingle}，threshold=${options.threshold}，minChars=${options.minChars}`);
+    lines.push('');
+    lines.push('## 1 降幅');
+    lines.push('');
+    lines.push('| 指标 | 上次（baseline） | 本次（复测） | 变化 |');
+    lines.push('|---|---|---|---|');
+    lines.push(`| 正文段落 | ${delta.baseline.paragraphCount} | ${delta.current.paragraphCount} | ${signed(delta.current.paragraphCount - delta.baseline.paragraphCount)} |`);
+    lines.push(`| 有命中段落 | ${delta.baseline.matchedCount} | ${delta.current.matchedCount} | ${signed(delta.current.matchedCount - delta.baseline.matchedCount)} |`);
+    lines.push(`| 高风险段落 | ${delta.baseline.high} | ${delta.current.high} | ${signed(-delta.highDrop)} |`);
+    lines.push(`| 中风险段落 | ${delta.baseline.medium} | ${delta.current.medium} | ${signed(-delta.mediumDrop)} |`);
+    lines.push(`| 加权重复率估算 | ${(delta.baseline.weightedRate * 100).toFixed(1)}% | ${(delta.current.weightedRate * 100).toFixed(1)}% | ${signed(-delta.rateDrop * 100)} 个百分点 |`);
+    lines.push('');
+    lines.push(`- 加权重复率降幅：**${(delta.rateDrop * 100).toFixed(1)} 个百分点**（相对降幅 ${(delta.rateDropRatio * 100).toFixed(1)}%）`);
+    lines.push(`- 结论：${delta.verdict}`);
+    lines.push('');
+    lines.push(`口径：${riskSource.algorithm}`);
+    lines.push('');
+    lines.push('## 2 仍中/高风险段落');
+    lines.push('');
+    const remaining = riskSource.risks.filter(risk => risk.level !== 'low');
+    if (remaining.length === 0) {
+        lines.push('无。');
+    }
+    else {
+        lines.push('| 分级 | 章节 | 行号 | 得分 | 命中来源 |');
+        lines.push('|---|---|---|---|---|');
+        for (const risk of remaining) {
+            lines.push(`| ${levelLabel(risk.level)} | ${risk.chapter} | ${risk.lineStart}-${risk.lineEnd} | ${(risk.score * 100).toFixed(1)}% | ${risk.source} |`);
+        }
+    }
+    lines.push('');
+    lines.push('## 3 边界声明');
+    lines.push('');
+    for (const note of riskSource.boundaries)
+        lines.push(`- ${note}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function signed(value) {
+    const rounded = Math.round(value * 10) / 10;
+    return `${rounded > 0 ? '+' : ''}${rounded}`;
+}

package/lib/dedup/rewrite.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 降重的「改写处方」：确定性规则，不调用 LLM。
+ *
+ * 对每个高风险段落产出结构化处方：
+ * 1. **必须保留的要素** —— 数字与单位、引用标记 `[n]`、代码标识符、双引号术语。
+ *    降重绝不能靠改数据、改术语、删引用来实现。
+ * 2. **可替换的句式** —— 逐句给出候选结构：拆短长句、主被动转换、并列改递进、
+ *    删除冗余连接词、调整语序（保留全部要素、只动结构）。
+ * 3. **引用化位置** —— 来源是文献笔记/他人段落时，提示改为直接引用 + 标注。
+ * 4. **禁止事项** —— 不得为了降重改动数据与结论，不得改动专业术语与引文。
+ *
+ * @module dsh-thesis/dedup
+ */
+import type { RiskItem } from './similarity.ts';
+/** 必须原样保留的要素。 */
+export interface ProtectedElement {
+    /** `number` 数字与单位 | `citation` 引用标记 | `code` 代码标识符 | `term` 双引号术语。 */
+    readonly kind: 'number' | 'citation' | 'code' | 'term';
+    readonly text: string;
+    /** 在归一化段文本中的起始下标。 */
+    readonly index: number;
+}
+/** 一条句式改写候选。 */
+export interface RewriteSuggestion {
+    /** `split` 拆短 | `voice` 转换 | `connector` 改递进 | `delete` 删冗余 | `reorder` 调整语序。 */
+    readonly kind: 'split' | 'voice' | 'connector' | 'delete' | 'reorder';
+    readonly target: string;
+    readonly detail: string;
+}
+/** 引用化建议（命中来源不是自己原创时）。 */
+export interface CitationSuggestion {
+    readonly needed: boolean;
+    readonly source: string;
+    readonly detail: string;
+}
+/** 命中片段（原文坐标，供用户定位）。 */
+export interface MatchExcerpt {
+    readonly length: number;
+    readonly text: string;
+    readonly lineStart: number;
+    readonly lineEnd: number;
+}
+export interface RewritePlan {
+    /** 章节/文件标识。 */
+    readonly chapter: string;
+    readonly lineStart: number;
+    readonly lineEnd: number;
+    readonly score: number;
+    readonly source: string;
+    /** 命中片段（原文坐标）。 */
+    readonly matches: readonly MatchExcerpt[];
+    /** 必须保留的要素（去重后按出现顺序）。 */
+    readonly mustKeep: readonly ProtectedElement[];
+    /** 可替换的句式。 */
+    readonly suggestions: readonly RewriteSuggestion[];
+    readonly citation: CitationSuggestion;
+    /** 禁止事项（含数据/结论红线）。 */
+    readonly forbidden: readonly string[];
+    /** 改写锚点：先换结构再换词，改完用 thesis_originality verify 复测。 */
+    readonly anchors: readonly string[];
+}
+/** 识别必须保留的要素（数字/单位、引用标记、代码标识符、双引号术语）。 */
+export declare function protectedElements(text: string): ProtectedElement[];
+/** 逐句生成候选句式（确定性；不调用 LLM，也不做同义词替换）。 */
+export declare function sentenceSuggestions(rawText: string): RewriteSuggestion[];
+/** 单个高风险段落 → 改写处方。 */
+export declare function planRewrite(risk: RiskItem): RewritePlan;
+/** 处方对象 → Markdown 片段。 */
+export declare function renderPlan(plan: RewritePlan): string;
+/** 批量渲染处方（报告用）。 */
+export declare function renderPlans(plans: readonly RewritePlan[]): string[];

package/lib/dedup/rewrite.js

@@ -0,0 +1,228 @@
+/**
+ * 降重的「改写处方」：确定性规则，不调用 LLM。
+ *
+ * 对每个高风险段落产出结构化处方：
+ * 1. **必须保留的要素** —— 数字与单位、引用标记 `[n]`、代码标识符、双引号术语。
+ *    降重绝不能靠改数据、改术语、删引用来实现。
+ * 2. **可替换的句式** —— 逐句给出候选结构：拆短长句、主被动转换、并列改递进、
+ *    删除冗余连接词、调整语序（保留全部要素、只动结构）。
+ * 3. **引用化位置** —— 来源是文献笔记/他人段落时，提示改为直接引用 + 标注。
+ * 4. **禁止事项** —— 不得为了降重改动数据与结论，不得改动专业术语与引文。
+ *
+ * @module dsh-thesis/dedup
+ */
+const FORBIDDEN = [
+    '不得为了降重改动任何数据、单位、图号、表号或测试结果（改动即学术不端）',
+    '不得为了降重改动结论、删减论证或删除必要引用',
+    '不得改动专业术语、专有名词与文献引文（引文另有规范，不能"改写"）',
+    '不得删除引用标注 [n] 或把引文改写成自己的话而不标注',
+    '不得用同义词回填（同义词替换不改变指纹重合，且会破坏术语一致性）',
+];
+const ANCHORS = [
+    '先改结构（拆句/换语序/换主被动），再改措辞——结构变了，指标才会真正下降',
+    '改写后跑 thesis_originality verify，用 baseline 对比降幅，别凭感觉判断',
+    '命中片段若来自文献笔记，改为"直接引用 + [n] 标注"比改写更安全',
+];
+function pushUnique(list, element) {
+    if (list.some(item => item.text === element.text))
+        return;
+    list.push(element);
+}
+/** 识别必须保留的要素（数字/单位、引用标记、代码标识符、双引号术语）。 */
+export function protectedElements(text) {
+    const found = [];
+    for (const m of text.matchAll(/[0-9]+(?:\.[0-9]+)*(?:%|‰|[万亿千百]?[年月日个次条项分秒人台例篇倍种]|[a-zA-Z]{1,8})?/g)) {
+        pushUnique(found, { kind: 'number', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/\[\d+(?:\s*[-,]\s*\d+)*\]/g)) {
+        pushUnique(found, { kind: 'citation', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/`[^`\n]{1,40}`/g)) {
+        pushUnique(found, { kind: 'code', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/\b[A-Za-z][A-Za-z0-9]*_[A-Za-z0-9_]+\b/g)) {
+        pushUnique(found, { kind: 'code', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/[a-z]+[A-Z][A-Za-z0-9]*/g)) {
+        pushUnique(found, { kind: 'code', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/[A-Za-z][A-Za-z0-9]*\(\)/g)) {
+        pushUnique(found, { kind: 'code', text: m[0], index: m.index ?? 0 });
+    }
+    for (const m of text.matchAll(/[""]([^""\n]{2,30})[""]/g)) {
+        pushUnique(found, { kind: 'term', text: m[1], index: (m.index ?? 0) + 1 });
+    }
+    return found.sort((a, b) => a.index - b.index);
+}
+const SPLIT_MARKERS = ['；', ';', '，而', ',而', '，同时', '，并且', '，进而', '，从而'];
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max)}…`;
+}
+/** 逐句生成候选句式（确定性；不调用 LLM，也不做同义词替换）。 */
+export function sentenceSuggestions(rawText) {
+    const suggestions = [];
+    const sentences = rawText
+        .split(/(?<=[。！？!?])|(?<=\.\s)/)
+        .map(s => s.trim())
+        .filter(s => s.length > 0);
+    for (const sentence of sentences) {
+        const marker = SPLIT_MARKERS.find(m => sentence.includes(m));
+        if (sentence.length >= 40 || marker !== undefined) {
+            suggestions.push({
+                kind: 'split',
+                target: clip(sentence, 40),
+                detail: '拆成 2-3 句：每句只留一个主谓结构，中间用"因此/其中/在此基础上"衔接，句间加主语。',
+            });
+        }
+        const passive = /被[^，。；]{1,20}(用于|采用|实现|提出|设计|完成)/.exec(sentence);
+        if (passive !== null) {
+            suggestions.push({
+                kind: 'voice',
+                target: passive[0],
+                detail: '主被动转换：把施动者提到句首（"本文采用…"/"系统通过…实现…"），去掉"被"字结构。',
+            });
+        }
+        const parallel = /不仅[^，。]{1,40}而且/.exec(sentence) ?? /既[^，。]{1,40}又/.exec(sentence);
+        if (parallel !== null) {
+            suggestions.push({
+                kind: 'connector',
+                target: parallel[0],
+                detail: '并列改递进：改成"在…基础上进一步…"，让两个分句体现推进关系而不是简单罗列。',
+            });
+        }
+        if (marker !== undefined) {
+            suggestions.push({
+                kind: 'connector',
+                target: marker,
+                detail: '长并列常靠连接词堆叠；改成短句 + 分号或句号，删掉可推断的连接词。',
+            });
+        }
+        for (const filler of ['综上所述', '总而言之', '值得注意的是', '众所周知', '不难发现', '显而易见', '在当今', '近年来']) {
+            if (sentence.includes(filler)) {
+                suggestions.push({
+                    kind: 'delete',
+                    target: filler,
+                    detail: '删除该冗余连接词；套话既不加分也不降重，只会被判定为模板化表达。',
+                });
+            }
+        }
+        const lead = /^(基于|针对|随着|通过)[^，。]{1,24}[，,]/.exec(sentence);
+        if (lead !== null) {
+            suggestions.push({
+                kind: 'reorder',
+                target: lead[0],
+                detail: '调整语序：把结论或对象提到句首（"…（对象）在…（条件）下表现为…"），避免全段同一开头。',
+            });
+        }
+    }
+    if (suggestions.length === 0) {
+        suggestions.push({
+            kind: 'reorder',
+            target: clip(rawText, 40),
+            detail: '本段无长句/被动/套话特征，按"结论先行 + 证据后置"重排语序，并补一个具体锚点（数字/图表/案例）。',
+        });
+    }
+    return suggestions;
+}
+function isExternal(label) {
+    return /文献|笔记|refs\.bib|\.bib|paper|arxiv|知网|万方|维普|他人|references/i.test(label);
+}
+function citationAdvice(label) {
+    if (isExternal(label)) {
+        return {
+            needed: true,
+            source: label,
+            detail: `命中来源「${label}」属于文献笔记/外部材料：应改为直接引用（引号 + 逐字照录）并在句末标注 [n]，而不是把别人的话改写成自己的表述。`,
+        };
+    }
+    return {
+        needed: false,
+        source: label,
+        detail: `命中来源「${label}」在本文内部：正常做法是改写这段并交叉引用（"如第 x 节所述"）或删除重复表述，不必再加引用标注。`,
+    };
+}
+function toExcerpts(spans) {
+    return spans.map(span => ({
+        length: span.length,
+        text: span.text,
+        lineStart: span.lineStart,
+        lineEnd: span.lineEnd,
+    }));
+}
+/** 单个高风险段落 → 改写处方。 */
+export function planRewrite(risk) {
+    const rawText = risk.segment.raw;
+    const citation = citationAdvice(risk.best.label);
+    return {
+        chapter: risk.segment.chapter,
+        lineStart: risk.segment.lineStart,
+        lineEnd: risk.segment.lineEnd,
+        score: risk.best.score,
+        source: risk.best.label,
+        matches: toExcerpts(risk.best.spans),
+        mustKeep: protectedElements(rawText),
+        suggestions: sentenceSuggestions(rawText),
+        citation,
+        forbidden: [...FORBIDDEN],
+        anchors: [...ANCHORS],
+    };
+}
+/** 处方对象 → Markdown 片段。 */
+export function renderPlan(plan) {
+    const lines = [];
+    lines.push(`### ${plan.chapter} 第 ${plan.lineStart}-${plan.lineEnd} 行（相似度 ${(plan.score * 100).toFixed(1)}%）`);
+    lines.push('');
+    lines.push(`- 命中来源：${plan.source}`);
+    if (plan.matches.length === 0) {
+        lines.push('- 命中片段：（碎片化重合，无连续长片段）');
+    }
+    else {
+        lines.push(`- 命中片段（连续重合 ${plan.matches[0].length} 字起）：`);
+        for (const match of plan.matches) {
+            lines.push(`  - 第 ${match.lineStart}-${match.lineEnd} 行：${clip(match.text.replace(/\n/g, ' '), 120)}`);
+        }
+    }
+    lines.push('');
+    if (plan.mustKeep.length === 0) {
+        lines.push('**必须保留**：本段未检出数字/引用/代码标识符；专业术语与专有名词仍须原样保留。');
+    }
+    else {
+        lines.push('**必须保留（改写时不得改动）**：');
+        for (const element of plan.mustKeep) {
+            const label = element.kind === 'number' ? '数字/单位' : element.kind === 'citation' ? '引用标记' : element.kind === 'code' ? '代码标识符' : '术语';
+            lines.push(`- [${label}] \`${element.text}\``);
+        }
+    }
+    lines.push('');
+    lines.push('**可替换的句式**：');
+    for (const suggestion of plan.suggestions) {
+        lines.push(`- （${suggestionKindLabel(suggestion.kind)}）\`${suggestion.target}\` → ${suggestion.detail}`);
+    }
+    lines.push('');
+    lines.push(`**引用化位置**：${plan.citation.needed ? '需要' : '不需要'}。${plan.citation.detail}`);
+    lines.push('');
+    lines.push('**禁止事项**：');
+    for (const item of plan.forbidden)
+        lines.push(`- ${item}`);
+    lines.push('');
+    lines.push('**改写锚点**：');
+    for (const item of plan.anchors)
+        lines.push(`- ${item}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function suggestionKindLabel(kind) {
+    if (kind === 'split')
+        return '拆短长句';
+    if (kind === 'voice')
+        return '主被动转换';
+    if (kind === 'connector')
+        return '并列改递进/删连接词';
+    if (kind === 'delete')
+        return '删冗余连接词';
+    return '调整语序';
+}
+/** 批量渲染处方（报告用）。 */
+export function renderPlans(plans) {
+    return plans.map(plan => renderPlan(plan));
+}