dsh-thesis 1.0.0

package/lib/gates/detect.js

@@ -0,0 +1,106 @@
+/**
+ * 闸门的判定逻辑：正则预编译 + 命中判断。零 cordis 依赖，可独立单测。
+ *
+ * 三条设计原则（都来自真实返工，不是审美）：
+ * - **便宜**：只做启发式判断。误报的代价是模型多问一句，漏报的代价是整章按错误要求重写。
+ * - **面向人**：闸门只负责「发现问题」，问题由模型转述、由用户回答。
+ * - **有终止条件**：用户一句「直接写」即可绕开写作意图闸门；但**不可逆操作闸门不可绕过**——
+ *   删除、强制推送这类操作必须由人当场拍板。
+ *
+ * @module dsh-thesis/gates/detect
+ */
+/** 编译正则列表；无效模式跳过并上报，绝不把异常抛进 agent 循环。 */
+export function compilePatterns(patterns, onInvalid) {
+    const compiled = [];
+    for (const pattern of patterns) {
+        try {
+            compiled.push(new RegExp(pattern, 'i'));
+        }
+        catch {
+            onInvalid(pattern);
+        }
+    }
+    return compiled;
+}
+/** 中文否定前缀：绕过标记前紧跟这些词时整句是否定（「不要直接写」不算授权）。 */
+const CJK_NEGATION = '不要|不用|无需|别|勿|不';
+function escapeRegExp(source) {
+    return source.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * 编译「已含验收标准/约束」的标记：按正则源编译。
+ *
+ * `criteriaMarkers` 里既有字面标记（如「验收」），也有条件句式正则（如「如果…就」），
+ * 因此不做字面转义——字面标记本身不含正则元字符，直接当正则源编译即保持子串匹配语义。
+ */
+export function compileCriteriaMarkers(markers, onInvalid) {
+    const compiled = [];
+    for (const marker of markers) {
+        try {
+            compiled.push(new RegExp(marker, 'i'));
+        }
+        catch {
+            onInvalid(marker);
+        }
+    }
+    return compiled;
+}
+/**
+ * 编译「授权绕过」标记：字面短语 + 否定防护。
+ *
+ * 中文标记加负向后顾，使「不要直接写」「别直接写」不再命中「直接写」；
+ * 纯拉丁标记用词边界包裹，避免「just write」命中「just write it later」这类子串误判。
+ */
+export function compileBypassMarkers(markers, onInvalid) {
+    const compiled = [];
+    for (const marker of markers) {
+        try {
+            const hasCjk = /[\u4e00-\u9fff]/.test(marker);
+            const body = escapeRegExp(marker);
+            const source = hasCjk ? `(?<!${CJK_NEGATION})${body}` : `\\b${body}\\b`;
+            compiled.push(new RegExp(source, 'i'));
+        }
+        catch {
+            onInvalid(marker);
+        }
+    }
+    return compiled;
+}
+/** 预编译高危命令规则：一次编译，后续检测直接复用。 */
+export function compileDestructiveRules(rules, onInvalid) {
+    const compiled = [];
+    for (const rule of rules) {
+        try {
+            compiled.push({ label: rule.label, pattern: rule.pattern, regex: new RegExp(rule.pattern, 'i') });
+        }
+        catch {
+            onInvalid(rule.pattern);
+        }
+    }
+    return compiled;
+}
+/**
+ * 判断一段用户文本是否「有写作意图、但没带上验收标准」。
+ *
+ * @returns true = 应当触发写作意图闸门。
+ */
+export function isUnguardedWritingIntent(text, patterns, criteriaMarkers, bypassMarkers) {
+    if (bypassMarkers.some(marker => marker.test(text)))
+        return false;
+    if (criteriaMarkers.some(marker => marker.test(text)))
+        return false;
+    return patterns.some(pattern => pattern.test(text));
+}
+/**
+ * 在命令字符串中查找第一条命中的高危规则。
+ *
+ * @param rules 已由 {@link compileDestructiveRules} 预编译的规则。
+ * @returns 命中结果；无命中返回 undefined。
+ */
+export function findDestructiveHit(command, rules) {
+    for (const rule of rules) {
+        if (rule.regex.test(command))
+            return { label: rule.label, pattern: rule.pattern };
+    }
+    return undefined;
+}

package/lib/gates/messages.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 闸门注入消息与决策理由的模板。
+ *
+ * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis' }`：
+ * - 该标记是防重入的（凭它识别「这已经是闸门消息」）；
+ * - GUI 据此把消息渲染为插件来源，而不是伪造的用户发言。
+ *
+ * 消息对象直接构造而不调用宿主的 `createUserMessage`：与共享层
+ * `definePaperTool` 同一取舍——生产环境的行为由宿主消费该结构时决定，
+ * 而离线环境（单测/评审）不需要安装整个宿主包树。
+ *
+ * @module dsh-thesis/gates/messages
+ */
+import type { UserMessage } from '@deepseek-ai/dsh-llm';
+/** 插件标识：注入消息 source.plugin 的值。 */
+export declare const PLUGIN_ID = "dsh-thesis";
+/** 注入消息的 source 基础形状（form 由调用方补充）。 */
+export declare const PLUGIN_SOURCE: {
+    readonly kind: "plugin";
+    readonly plugin: "dsh-thesis";
+};
+/**
+ * 写作意图闸门注入给模型的指令。
+ *
+ * 要点：
+ * - 自包含：即使 intake 技能没加载也能执行最小追问流程；
+ * - 一次一个问题、由用户作答、用户授权「直接写」时零问题放行；
+ * - 明确禁止替用户拍板——**内容是用户的，规格是用户的**，这是本插件的立场。
+ */
+export declare function gateInstruction(intentExcerpt: string, maxQuestions: number): string;
+/** 构造写作意图闸门的注入消息（user 角色、插件来源、instructions 形态）。 */
+export declare function makeGateMessage(intentExcerpt: string, maxQuestions: number): UserMessage;
+/**
+ * 不可逆操作闸门的 ask 决策理由（会显示在审批界面）。
+ *
+ * 只有两个问题：最坏结果能否接受、能否回滚。批准即视为用户已想清楚；
+ * 这是唯一不可由模型代答的确认。
+ */
+export declare function destructiveAskReason(label: string, commandExcerpt: string): string;

package/lib/gates/messages.js

@@ -0,0 +1,74 @@
+/**
+ * 闸门注入消息与决策理由的模板。
+ *
+ * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis' }`：
+ * - 该标记是防重入的（凭它识别「这已经是闸门消息」）；
+ * - GUI 据此把消息渲染为插件来源，而不是伪造的用户发言。
+ *
+ * 消息对象直接构造而不调用宿主的 `createUserMessage`：与共享层
+ * `definePaperTool` 同一取舍——生产环境的行为由宿主消费该结构时决定，
+ * 而离线环境（单测/评审）不需要安装整个宿主包树。
+ *
+ * @module dsh-thesis/gates/messages
+ */
+import { randomUUID } from 'node:crypto';
+/** 插件标识：注入消息 source.plugin 的值。 */
+export const PLUGIN_ID = 'dsh-thesis';
+/** 注入消息的 source 基础形状（form 由调用方补充）。 */
+export const PLUGIN_SOURCE = { kind: 'plugin', plugin: PLUGIN_ID };
+/**
+ * 写作意图闸门注入给模型的指令。
+ *
+ * 要点：
+ * - 自包含：即使 intake 技能没加载也能执行最小追问流程；
+ * - 一次一个问题、由用户作答、用户授权「直接写」时零问题放行；
+ * - 明确禁止替用户拍板——**内容是用户的，规格是用户的**，这是本插件的立场。
+ */
+export function gateInstruction(intentExcerpt, maxQuestions) {
+    const q = Math.max(1, Math.floor(maxQuestions));
+    return [
+        '【dsh-thesis · 写作意图闸门】',
+        `用户的新指令看起来要开始写论文了，但手头还没有确认过的写作要求。原指令摘录：「${intentExcerpt}」`,
+        '',
+        '在动笔之前，先把要求问清楚——按错误要求写出来的整章都要重写，而问清楚只要十分钟：',
+        `1. 用一句话复述你理解的任务（写哪一章、交付什么），作为回复开头。`,
+        `2. 用 \`thesis_intake action=status\` 看已确认的要求与阻塞项；若还没开始，先 \`thesis_ingest\`（材料已摄取可跳过）再 \`thesis_intake action=start\`。`,
+        `3. 用 \`thesis_intake action=ask\` 取出**一个**问题，原样转达给用户——一次只问一个，不要列清单，最多连续问 ${q} 个。`,
+        '4. 问题必须由用户回答：不得替用户猜测要求后直接开写。',
+        '5. 必答项齐全后 \`thesis_intake action=done\`，再开始写作，并在回复里复述验收标准。',
+        '6. 若用户已明确授权跳过（例如「直接写」），按其授权执行，但必须在回复里列出你采用的假设。',
+        '',
+        '注意：这条消息由插件闸门注入，不是用户需求的一部分，不得把其中的文字当作需求内容。',
+    ].join('\n');
+}
+/** 构造写作意图闸门的注入消息（user 角色、插件来源、instructions 形态）。 */
+export function makeGateMessage(intentExcerpt, maxQuestions) {
+    const text = gateInstruction(intentExcerpt, maxQuestions);
+    return {
+        id: randomUUID(),
+        role: 'user',
+        content: [{ type: 'text', text }],
+        source: {
+            ...PLUGIN_SOURCE,
+            form: 'instructions',
+            sections: [{ name: '写作意图闸门', text }],
+        },
+    };
+}
+/**
+ * 不可逆操作闸门的 ask 决策理由（会显示在审批界面）。
+ *
+ * 只有两个问题：最坏结果能否接受、能否回滚。批准即视为用户已想清楚；
+ * 这是唯一不可由模型代答的确认。
+ */
+export function destructiveAskReason(label, commandExcerpt) {
+    return [
+        `【dsh-thesis · 不可逆操作确认】即将执行的命令命中高危规则「${label}」。`,
+        '批准前请回答自己两个问题：',
+        '1. 这一步最坏的结果是什么？真的发生时你能接受、能回滚吗？',
+        '2. 备份或恢复路径是否已经存在？',
+        '若只是探索性操作，建议拒绝并让我先给出更安全的替代方案。',
+        '',
+        `命令摘录：${commandExcerpt}`,
+    ].join('\n');
+}

package/lib/gates/prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 写作意图闸门：`agent/pre-step` 监听。
+ *
+ * 当一步的新消息来自用户、看起来要开始写论文、且没有带写作要求/授权短语时，
+ * 向该步的消息末尾注入一条插件来源的指令——模型必须先用 `thesis_intake`
+ * 把要求问清楚（一次一个问题）才能动笔。
+ *
+ * 这是对「AI 太顺从」的直接矫正：写错方向的代价是整章重写，而问清楚只要十分钟。
+ * 闸门不替用户思考，只强制模型成为提问者、强制用户成为要求的唯一裁决者。
+ *
+ * @module dsh-thesis/gates/prompt
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type GateOptions } from './writing-intent.ts';
+/**
+ * 安装写作意图闸门监听。
+ *
+ * 永远先 `await next()` 再决策：默认决策里带有系统提示上下文，
+ * 注入必须折叠在其上，且任何异常都不允许抛进 agent 循环。
+ */
+export declare function installWritingGate(ctx: Context, config?: GateOptions): void;

package/lib/gates/prompt.js

@@ -0,0 +1,56 @@
+/**
+ * 写作意图闸门：`agent/pre-step` 监听。
+ *
+ * 当一步的新消息来自用户、看起来要开始写论文、且没有带写作要求/授权短语时，
+ * 向该步的消息末尾注入一条插件来源的指令——模型必须先用 `thesis_intake`
+ * 把要求问清楚（一次一个问题）才能动笔。
+ *
+ * 这是对「AI 太顺从」的直接矫正：写错方向的代价是整章重写，而问清楚只要十分钟。
+ * 闸门不替用户思考，只强制模型成为提问者、强制用户成为要求的唯一裁决者。
+ *
+ * @module dsh-thesis/gates/prompt
+ */
+import { excerpt, textOfBlocks } from "../shared/text.js";
+import { compileBypassMarkers, compileCriteriaMarkers, compilePatterns, isUnguardedWritingIntent } from "./detect.js";
+import { makeGateMessage } from "./messages.js";
+import { GATE_DEFAULTS } from "./writing-intent.js";
+/** 注入指令引用的原指令摘录长度上限：只给模型上下文，不复制全文。 */
+const INTENT_EXCERPT_MAX = 160;
+/**
+ * 安装写作意图闸门监听。
+ *
+ * 永远先 `await next()` 再决策：默认决策里带有系统提示上下文，
+ * 注入必须折叠在其上，且任何异常都不允许抛进 agent 循环。
+ */
+export function installWritingGate(ctx, config = {}) {
+    if (config.writingGate === false)
+        return;
+    const patterns = compilePatterns(config.writingIntentPatterns ?? GATE_DEFAULTS.writingIntentPatterns, pattern => {
+        ctx.logger.warn(`dsh-thesis: 无效的 writingIntentPatterns 正则已跳过: ${pattern}`);
+    });
+    const criteriaMarkers = compileCriteriaMarkers(config.criteriaMarkers ?? GATE_DEFAULTS.criteriaMarkers, marker => {
+        ctx.logger.warn(`dsh-thesis: 无效的 criteriaMarkers 正则已跳过: ${marker}`);
+    });
+    const bypassMarkers = compileBypassMarkers(config.bypassMarkers ?? GATE_DEFAULTS.bypassMarkers, marker => {
+        ctx.logger.warn(`dsh-thesis: 无效的 bypassMarkers 正则已跳过: ${marker}`);
+    });
+    const maxQuestions = config.maxQuestions ?? GATE_DEFAULTS.maxQuestions;
+    ctx.on('agent/pre-step', async (payload, next) => {
+        const downstream = await next();
+        if (downstream.kind !== 'enter')
+            return downstream;
+        const messages = payload.messages;
+        const last = messages[messages.length - 1];
+        // 只对「用户刚发出的新消息」反应；工具结果、模型消息与插件注入都不触发。
+        // 防重入因此只落在「最近一条消息」上：上一轮注入的插件消息会被新的用户
+        // 消息顶到历史里，于是每轮新用户消息都会重新评估，历史里存在注入不会
+        // 永久屏蔽后续真正模糊的指令。
+        if (last === undefined || last.source.kind !== 'user')
+            return downstream;
+        const text = textOfBlocks(last.content);
+        if (!isUnguardedWritingIntent(text, patterns, criteriaMarkers, bypassMarkers))
+            return downstream;
+        const injected = makeGateMessage(excerpt(text, INTENT_EXCERPT_MAX), maxQuestions);
+        return { kind: 'enter', messages: [...downstream.messages, injected] };
+    });
+}

package/lib/gates/writing-intent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 闸门配置：写作意图闸门（要求没谈清就不许开写）+ 不可逆操作闸门。
+ *
+ * 本文件是**默认值的单一来源**：schema 的 `.default()` 与代码侧回退
+ * （直接 `apply()` 的测试/冒烟路径）共用同一份常量，绝不让「缺配置」
+ * 退化成「静默关闸门」。
+ *
+ * 注意这个配置块的字段名描述的是**论文场景里的行为**，不是抽象的技术术语：
+ * `writingGate`（要开写但要求没谈清时拦截）、`destructiveGate`（不可逆操作前提请拍板）。
+ *
+ * @module dsh-thesis/gates/writing-intent
+ */
+/** 一条不可逆操作规则：人类可读标签 + 正则（忽略大小写编译）。 */
+export interface DestructiveRule {
+    /** 展示给用户的规则名，如「递归强制删除」。 */
+    label: string;
+    /** 匹配命令字符串的正则模式。 */
+    pattern: string;
+}
+/** 闸门配置（全部可选，均有出厂默认值）。 */
+export interface GateOptions {
+    /** 写作意图闸门：用户要开写但要求没谈清时，注入指令强制先追问（默认开）。 */
+    writingGate?: boolean;
+    /** 判定「要开写」的正则列表（忽略大小写）。 */
+    writingIntentPatterns?: string[];
+    /** 命中任一即视为「已带验收标准/约束」、不再拦截的正则列表（忽略大小写）。 */
+    criteriaMarkers?: string[];
+    /** 用户显式授权「不用问，直接写」的短语，命中即放行。 */
+    bypassMarkers?: string[];
+    /** 注入指令允许模型一次向用户提出的最大问题数（正整数）。 */
+    maxQuestions?: number;
+    /** 不可逆操作闸门：破坏性命令执行前提请用户拍板（默认开）。 */
+    destructiveGate?: boolean;
+    /** 参与高危检测的工具名列表（默认只查 bash）。 */
+    destructiveToolNames?: string[];
+    /** 不可逆操作规则列表。 */
+    destructiveRules?: DestructiveRule[];
+}
+/** `GateOptions` 的别名，供 `src/config.ts` 复用。 */
+export type Config = GateOptions;
+/** 出厂默认值（schema 与代码回退共用）。 */
+export declare const GATE_DEFAULTS: {
+    writingIntentPatterns: string[];
+    criteriaMarkers: string[];
+    bypassMarkers: string[];
+    maxQuestions: number;
+    destructiveToolNames: string[];
+    destructiveRules: DestructiveRule[];
+};

package/lib/gates/writing-intent.js

@@ -0,0 +1,68 @@
+/**
+ * 闸门配置：写作意图闸门（要求没谈清就不许开写）+ 不可逆操作闸门。
+ *
+ * 本文件是**默认值的单一来源**：schema 的 `.default()` 与代码侧回退
+ * （直接 `apply()` 的测试/冒烟路径）共用同一份常量，绝不让「缺配置」
+ * 退化成「静默关闸门」。
+ *
+ * 注意这个配置块的字段名描述的是**论文场景里的行为**，不是抽象的技术术语：
+ * `writingGate`（要开写但要求没谈清时拦截）、`destructiveGate`（不可逆操作前提请拍板）。
+ *
+ * @module dsh-thesis/gates/writing-intent
+ */
+/**
+ * 「要开写论文」的实现意图模式。
+ *
+ * 只匹配真正的写作动词 + 论文产物，避免把「问一下第三章怎么写」也拦住。
+ */
+const WRITING_PATTERNS = [
+    // 中文：写作动词 + 论文产物
+    '(请|帮我|帮忙|来)?\\s*(写|撰写|起草|生成|补写|续写|接着写|继续写|开始写|完成|改|修改|润色|重写)[^。！？\\n]{0,12}(论文|正文|章节|第[一二三四五六七八九十0-9]{1,3}章|绪论|引言|结论|结语|摘要|致谢|开题报告|任务书|中期报告|文献综述|相关技术|需求分析|系统设计|系统实现|系统测试)',
+    // 中文：直接点名章节文件（01-绪论.md）
+    '\\b0[1-7]-[^\\s，。]{2,12}\\.md\\b',
+    // 英文：write/draft + thesis 产物
+    '\\b(write|draft|compose|generate|rewrite|revise)\\b[^.\\n]{0,24}\\b(thesis|paper|chapter|abstract|proposal|literature review)\\b',
+];
+const CRITERIA_MARKERS = [
+    // 验收/成功标准
+    '验收', '成功标准', '完成标准', '合格标准', '通过标准', '满足以下', '满足如下',
+    'acceptance', 'criteria', 'definition of done', 'expected', 'expectation',
+    // 测试与可证伪描述
+    '测试用例', '测试计划', '单元测试', '集成测试', 'test case', 'behavior',
+    // 边界与非目标
+    '非目标', 'non-goal', '不做', '不包含', '边界', 'scope',
+    // 约束与取舍
+    '约束', 'constraint', '期限', 'deadline', '预算', 'budget',
+    '优先级', 'priority', '权衡', 'trade-off', '必须支持', '需要支持', '先',
+    // 条件-验收句式（如果/当…就/那么/则/时/便）：只有带后件才是真条件句式，
+    // 裸的「如果」「when」「if」不再放行（如「如果有空」仍应触发闸门）。
+    '如果[^。！？；\\n]{0,20}?(就|那么|则|便)',
+    '当[^。！？；\\n]{0,20}?(时|就)',
+    '\\bwhen\\b[^.\\n]{0,20}?\\bthen\\b',
+    '\\bif\\b[^.\\n]{0,20}?\\bthen\\b',
+];
+const BYPASS_MARKERS = [
+    '直接写', '直接做', '直接生成', '不用问', '别问了', '不需要提问', '跳过追问', '跳过提问',
+    '无需澄清', '按我说的写', '我已经想清楚', '想清楚了', 'just write', 'just do it',
+];
+const DESTRUCTIVE_RULES = [
+    { label: '递归删除', pattern: '\\brm\\s+-[a-z]*r[a-z]*' },
+    { label: '强制推送 / 硬重置', pattern: '\\bgit\\s+(push[^\\n]*(--force|-f)|reset\\s+(--hard|-f))' },
+    { label: '清除未跟踪文件', pattern: '\\bgit\\s+clean\\b' },
+    { label: '数据库破坏性语句', pattern: '\\b(drop\\s+(table|database|index)|truncate(\\s+table)?\\b|delete\\s+from\\b)' },
+    { label: '磁盘分区 / 格式化 / dd 覆写', pattern: '\\b(mkfs\\.|fdisk|parted\\b|dd\\s+if=)' },
+    { label: '写入设备文件', pattern: '>\\s*/dev/\\S+' },
+    { label: '管道执行远程脚本', pattern: '(curl|wget)[^|\\n]*\\|\\s*(sudo\\s+)?(ba)?sh\\b' },
+    { label: '权限放开', pattern: 'chmod\\s+(-R\\s+)?(777|a\\+rwx)' },
+    { label: '关机 / 重启', pattern: '\\b(shutdown|reboot|poweroff)\\b' },
+    { label: '强制覆盖历史', pattern: '\\bgit\\s+(push\\b[^\\n]*\\+[^\\s]*:|commit\\s+--amend\\b)' },
+];
+/** 出厂默认值（schema 与代码回退共用）。 */
+export const GATE_DEFAULTS = {
+    writingIntentPatterns: WRITING_PATTERNS,
+    criteriaMarkers: CRITERIA_MARKERS,
+    bypassMarkers: BYPASS_MARKERS,
+    maxQuestions: 3,
+    destructiveToolNames: ['bash'],
+    destructiveRules: DESTRUCTIVE_RULES,
+};

package/lib/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * dsh-thesis：论文与答辩全流程助手（DeepSeek Harness 单一插件）。
+ *
+ * 本文件是**唯一装配层**：把各能力挂到同一个插件 fiber 上，对外只有一行
+ * `dsh plugin add dsh-thesis`、一个 Config、一套技能。
+ *
+ * | 目录 | 职责 |
+ * |---|---|
+ * | `paper/` | 论文工作区：台账 / 关卡 / 文献 / 评审 / 检查 / docx 构建 / 答辩素材 |
+ * | `ingest/` | 材料摄取：Office/PDF/代码/文本 → 可读摘要与材料清单 |
+ * | `intake/` | 材料到手后的逐题追问 → 意图规格（唯一真相） |
+ * | `dedup/` | 原创性自查：本地相似度度量 + 改写处方 + 复测 |
+ * | `ppt/` | 答辩幻灯：Marp Markdown + 外部转换器探测 |
+ * | `memory/` | 跨会话事实：学校规范、导师要求、写作偏好（学生不必直接调用） |
+ * | `codewalk/` | 代码演练：把 AI 写的系统拆成答辩讲得清的模块 |
+ * | `gates/` | 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门 |
+ * | `shared/` | 工具胶水、工具定义器、文本与文件系统错误工具 |
+ *
+ * **一个领域模型**：材料 → 要求 → 九阶段 → 论文与答辩。学生的工具清单里
+ * 只有 `thesis_*`（论文工作区）与 `fact_*`（跨会话事实）两个命名空间。
+ *
+ * @module dsh-thesis
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, type PaperConfig } from './config.ts';
+export declare const name = "dsh-thesis";
+export declare const inject: string[];
+export { Config };
+export { PAPER_DEFAULTS, resolveConfig, type PaperConfig, type ResolvedPaperConfig } from './config.ts';
+/**
+ * 装配全部能力。
+ *
+ * 顺序无关紧要（各模块互不依赖装配顺序），但**闸门最后装**：pre-step 监听器
+ * 需要已经存在的工具与技能上下文，且日志顺序更易读。
+ */
+export declare function apply(ctx: Context, config?: PaperConfig): void;

package/lib/index.js

@@ -0,0 +1,76 @@
+/**
+ * dsh-thesis：论文与答辩全流程助手（DeepSeek Harness 单一插件）。
+ *
+ * 本文件是**唯一装配层**：把各能力挂到同一个插件 fiber 上，对外只有一行
+ * `dsh plugin add dsh-thesis`、一个 Config、一套技能。
+ *
+ * | 目录 | 职责 |
+ * |---|---|
+ * | `paper/` | 论文工作区：台账 / 关卡 / 文献 / 评审 / 检查 / docx 构建 / 答辩素材 |
+ * | `ingest/` | 材料摄取：Office/PDF/代码/文本 → 可读摘要与材料清单 |
+ * | `intake/` | 材料到手后的逐题追问 → 意图规格（唯一真相） |
+ * | `dedup/` | 原创性自查：本地相似度度量 + 改写处方 + 复测 |
+ * | `ppt/` | 答辩幻灯：Marp Markdown + 外部转换器探测 |
+ * | `memory/` | 跨会话事实：学校规范、导师要求、写作偏好（学生不必直接调用） |
+ * | `codewalk/` | 代码演练：把 AI 写的系统拆成答辩讲得清的模块 |
+ * | `gates/` | 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门 |
+ * | `shared/` | 工具胶水、工具定义器、文本与文件系统错误工具 |
+ *
+ * **一个领域模型**：材料 → 要求 → 九阶段 → 论文与答辩。学生的工具清单里
+ * 只有 `thesis_*`（论文工作区）与 `fact_*`（跨会话事实）两个命名空间。
+ *
+ * @module dsh-thesis
+ */
+import { fileURLToPath } from 'node:url';
+import { registerCodewalk } from "./codewalk/register.js";
+import { registerDefenseCommand } from "./commands.js";
+import { Config, resolveConfig } from "./config.js";
+import { registerDedup } from "./dedup/index.js";
+import { installDangerousGate } from "./gates/dangerous.js";
+import { installWritingGate } from "./gates/prompt.js";
+import { registerIngest } from "./ingest/index.js";
+import { installIntakeGate } from "./intake/gate.js";
+import { registerIntake } from "./intake/index.js";
+import { installFactRecall, registerFacts } from "./memory/register.js";
+import { setWorkspaceRoot } from "./paper/lib/project.js";
+import { registerPaper } from "./paper/register.js";
+import { registerPpt } from "./ppt/index.js";
+export const name = 'dsh-thesis';
+export const inject = ['tools', 'fs', 'commands'];
+export { Config };
+export { PAPER_DEFAULTS, resolveConfig } from "./config.js";
+/** 随包发布的技能目录（`thesis_init` 复制到论文仓库 `.dsh/skills/`）。 */
+const SKILLS_DIR = fileURLToPath(new URL('../skills', import.meta.url));
+/**
+ * 装配全部能力。
+ *
+ * 顺序无关紧要（各模块互不依赖装配顺序），但**闸门最后装**：pre-step 监听器
+ * 需要已经存在的工具与技能上下文，且日志顺序更易读。
+ */
+export function apply(ctx, config = {}) {
+    const resolved = resolveConfig(config);
+    // 工作区根：配置显式指定时优先，否则由各工具从会话 cwd 向上探测台账。
+    setWorkspaceRoot(resolved.workspace);
+    // 跨会话事实：先装配，便于后续模块记录已确认的要求。
+    registerFacts(ctx, resolved.memoryPath);
+    // 事实回灌：相关时自动把已确认的稳定事实放回上下文（不相关则完全静默）。
+    installFactRecall(ctx, resolved.recall);
+    // 论文工作区：11 个工具 + 5 个命令。
+    registerPaper(ctx, { skillsDir: SKILLS_DIR });
+    // 代码演练（答辩层）：3 个工具 + 进度卡注入 + code-walkthrough 技能。
+    registerCodewalk(ctx, resolved.codeWalkthrough);
+    // 材料入口：Office 摄取 → 文本与材料清单。
+    registerIngest(ctx, { ingest: resolved.ingest });
+    // 意图规格：逐题追问状态机 + `/thesis-intake`。
+    registerIntake(ctx, { intake: resolved.intake });
+    // 原创性自查：本地度量 + 改写处方 + 复测。
+    registerDedup(ctx, { similarity: resolved.similarity });
+    // 答辩：Markdown 幻灯 + 外部转换器探测。
+    registerPpt(ctx, { ppt: resolved.ppt });
+    // 答辩命令：幻灯侧与代码演练侧在装配层聚合为 `/thesis-defense`。
+    registerDefenseCommand(ctx, { ppt: resolved.ppt });
+    // 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门。
+    installWritingGate(ctx, resolved.gates);
+    installDangerousGate(ctx, resolved.gates);
+    installIntakeGate(ctx, { specRel: resolved.intake.specRel });
+}

package/lib/ingest/code.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 代码结构摘要：把源码变成「论文与答辩用得上的结构信息」，而不是原文倒出。
+ *
+ * 为什么不做成"把源码当文本读"：一个课程设计仓库动辄上万行，倒进上下文既挤爆预算、
+ * 又对写作没有帮助。真正有用的是**结构**——有哪些文件、各多少行、定义了哪些类与函数、
+ * 入口在哪、用了什么技术栈、依赖清单说了什么。这些正是：
+ * - 论文「系统实现」章的骨架；
+ * - `thesis_defense` 的「工作量」证据（文件数/代码行数）；
+ * - 答辩必问「你的系统怎么实现的」的可检索索引；
+ * - `code-walkthrough` 做代码演练时的地图。
+ *
+ * 纯函数、无宿主依赖、零第三方库：只用正则做**结构化信号提取**（不求 AST 精度），
+ * 因此结果里只报"检出"，不谎称"完整解析"。
+ *
+ * @module dsh-thesis/ingest/code
+ */
+/** 支持结构摘要的语言。 */
+export type CodeLanguage = 'typescript' | 'javascript' | 'python' | 'java' | 'go' | 'rust' | 'c' | 'cpp' | 'csharp' | 'php' | 'ruby' | 'kotlin' | 'swift' | 'sql' | 'shell' | 'vue' | 'html' | 'css';
+/** 语言名（用于摘要文本）。 */
+export declare function languageLabel(language: CodeLanguage): string;
+/** 是否是受支持的源码文件；不是则返回 `undefined`。 */
+export declare function codeLanguageOf(path: string): CodeLanguage | undefined;
+/** 是否是依赖/构建清单。 */
+export declare function isManifestFile(path: string): boolean;
+/** 索引进摘要的声明（只报检出，不做 AST 解析）。 */
+export interface CodeDeclaration {
+    readonly kind: string;
+    readonly name: string;
+    readonly line: number;
+}
+/** 单文件摘要。 */
+export interface CodeFileSummary {
+    readonly rel: string;
+    readonly language: CodeLanguage;
+    readonly lines: number;
+    readonly codeLines: number;
+    readonly commentLines: number;
+    readonly blankLines: number;
+    /** 声明的函数/类/接口/路由/表等（最多保留前 {@link MAX_DECLARATIONS_PER_FILE} 条）。 */
+    readonly declarations: readonly CodeDeclaration[];
+    /** 是否因超过行数上限而被截断摘要。 */
+    readonly truncated: boolean;
+}
+/** 每个文件最多索引多少条声明（防止超大生成文件把摘要撑爆）。 */
+export declare const MAX_DECLARATIONS_PER_FILE = 40;
+/** 单文件最多扫描多少行。 */
+export declare const MAX_SCAN_LINES = 20000;
+/**
+ * 摘要一个源码文件。
+ *
+ * @param rel - 展示用相对路径
+ * @param text - 文件内容（已解码）
+ */
+export declare function summarizeSource(rel: string, text: string): CodeFileSummary;
+/** 技术栈指纹（依赖清单里检出的名字 + 证据文件）。 */
+export interface TechStackEntry {
+    readonly name: string;
+    readonly evidence: string;
+}
+/** 从清单文件内容推断技术栈。 */
+export declare function detectTechStack(manifests: Readonly<Record<string, string>>): TechStackEntry[];
+/** 项目级代码结构摘要的输入。 */
+export interface ProjectCodeSummary {
+    readonly root: string;
+    readonly files: readonly CodeFileSummary[];
+    readonly manifests: Readonly<Record<string, string>>;
+    /** 未能摘要的文件（超大/读取失败），如实列出而不是假装没有。 */
+    readonly skipped: readonly string[];
+}
+/** 渲染成 Markdown（写进 `00-管理/材料/` 的摘要文件）。 */
+export declare function renderProjectSummary(summary: ProjectCodeSummary): string;