dsh-thesis 1.0.1 → 2.0.2

package/lib/gates/messages.d.ts

@@ -1,8 +1,10 @@
 /**
  * 闸门注入消息与决策理由的模板。
  *
- * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`：
- * - `plugin` 是生产者标识（GUI 用它做行首标签，也用于防重入识别"这已经是闸门消息"）；
+ * 注入消息的 source 采用 `{ kind: 'plugin:dsh-thesis', form: 'instructions' }`：
+ * - `kind` 是生产者自有标识。v4 会话格式禁止共享兜底 kind `plugin`，否则写会话日志
+ *   时直接抛 `format v4 message requires a producer-owned source kind`（见
+ *   `shared/message-source.ts`）；
  * - `form` 声明这条上下文的语义形态（当前契约的取值域：instructions / catalog /
  *   snapshot / notice / relay / recall）；
  * - **不带 `sections`**：`sections` 只属于 `snapshot` 形态（见
@@ -16,12 +18,11 @@
  * @module dsh-thesis/gates/messages
  */
 import type { UserMessage } from '@deepseek-ai/dsh-llm';
-/** 插件标识：注入消息 source.plugin 的值。 */
-export declare const PLUGIN_ID = "dsh-thesis";
+/** 插件标识：注入消息 source 的命名来源。 */
+export { PLUGIN_ID } from '../shared/message-source.ts';
 /** 注入消息的 source 基础形状（form 由调用方补充）。 */
 export declare const PLUGIN_SOURCE: {
-    readonly kind: "plugin";
-    readonly plugin: "dsh-thesis";
+    readonly kind: "plugin:dsh-thesis";
 };
 /**
  * 写作意图闸门注入给模型的指令。

package/lib/gates/messages.js

@@ -1,8 +1,10 @@
 /**
  * 闸门注入消息与决策理由的模板。
  *
- * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`：
- * - `plugin` 是生产者标识（GUI 用它做行首标签，也用于防重入识别"这已经是闸门消息"）；
+ * 注入消息的 source 采用 `{ kind: 'plugin:dsh-thesis', form: 'instructions' }`：
+ * - `kind` 是生产者自有标识。v4 会话格式禁止共享兜底 kind `plugin`，否则写会话日志
+ *   时直接抛 `format v4 message requires a producer-owned source kind`（见
+ *   `shared/message-source.ts`）；
  * - `form` 声明这条上下文的语义形态（当前契约的取值域：instructions / catalog /
  *   snapshot / notice / relay / recall）；
  * - **不带 `sections`**：`sections` 只属于 `snapshot` 形态（见
@@ -16,10 +18,11 @@
  * @module dsh-thesis/gates/messages
  */
 import { randomUUID } from 'node:crypto';
-/** 插件标识：注入消息 source.plugin 的值。 */
-export const PLUGIN_ID = 'dsh-thesis';
+import { THESIS_SOURCE } from "../shared/message-source.js";
+/** 插件标识：注入消息 source 的命名来源。 */
+export { PLUGIN_ID } from "../shared/message-source.js";
 /** 注入消息的 source 基础形状（form 由调用方补充）。 */
-export const PLUGIN_SOURCE = { kind: 'plugin', plugin: PLUGIN_ID };
+export const PLUGIN_SOURCE = THESIS_SOURCE;
 /**
  * 写作意图闸门注入给模型的指令。
  *

package/lib/index.d.ts

@@ -2,7 +2,8 @@
  * dsh-thesis：论文与答辩全流程助手（DeepSeek Harness 单一插件）。
  *
  * 本文件是**唯一装配层**：把各能力挂到同一个插件 fiber 上，对外只有一行
- * `dsh plugin add dsh-thesis`、一个 Config、一套技能。
+ * `dsh plugin add dsh-thesis`、一个 Config、一套技能。**没有斜杠命令**：
+ * 插件在论文工作区里自己把流程推起来（开头一道选择题 + 关卡拍板）。
  *
  * | 目录 | 职责 |
  * |---|---|
@@ -14,6 +15,7 @@
  * | `memory/` | 跨会话事实：学校规范、导师要求、写作偏好（学生不必直接调用） |
  * | `codewalk/` | 代码演练：把 AI 写的系统拆成答辩讲得清的模块 |
  * | `gates/` | 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门 |
+ * | `autopilot/` | 自动驾驶：开头一道选择题 + 建目标自动续轮 + 关卡拍板（无斜杠命令） |
  * | `shared/` | 工具胶水、工具定义器、文本与文件系统错误工具 |
  *
  * **一个领域模型**：材料 → 要求 → 九阶段 → 论文与答辩。学生的工具清单里

package/lib/index.js

@@ -2,7 +2,8 @@
  * dsh-thesis：论文与答辩全流程助手（DeepSeek Harness 单一插件）。
  *
  * 本文件是**唯一装配层**：把各能力挂到同一个插件 fiber 上，对外只有一行
- * `dsh plugin add dsh-thesis`、一个 Config、一套技能。
+ * `dsh plugin add dsh-thesis`、一个 Config、一套技能。**没有斜杠命令**：
+ * 插件在论文工作区里自己把流程推起来（开头一道选择题 + 关卡拍板）。
  *
  * | 目录 | 职责 |
  * |---|---|
@@ -14,6 +15,7 @@
  * | `memory/` | 跨会话事实：学校规范、导师要求、写作偏好（学生不必直接调用） |
  * | `codewalk/` | 代码演练：把 AI 写的系统拆成答辩讲得清的模块 |
  * | `gates/` | 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门 |
+ * | `autopilot/` | 自动驾驶：开头一道选择题 + 建目标自动续轮 + 关卡拍板（无斜杠命令） |
  * | `shared/` | 工具胶水、工具定义器、文本与文件系统错误工具 |
  *
  * **一个领域模型**：材料 → 要求 → 九阶段 → 论文与答辩。学生的工具清单里
@@ -22,8 +24,8 @@
  * @module dsh-thesis
  */
 import { fileURLToPath } from 'node:url';
+import { installAutopilot } from "./autopilot/index.js";
 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";
@@ -36,7 +38,7 @@ 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 const inject = ['tools', 'fs'];
 export { Config };
 export { PAPER_DEFAULTS, resolveConfig } from "./config.js";
 /** 随包发布的技能目录（`thesis_init` 复制到论文仓库 `.dsh/skills/`）。 */
@@ -55,20 +57,21 @@ export function apply(ctx, config = {}) {
     registerFacts(ctx, resolved.memoryPath);
     // 事实回灌：相关时自动把已确认的稳定事实放回上下文（不相关则完全静默）。
     installFactRecall(ctx, resolved.recall);
-    // 论文工作区：11 个工具 + 5 个命令。
+    // 论文工作区：11 个工具。
     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 });
+    // 自动驾驶：论文工作区里开口就问一次意图 → 建目标自动续轮；关卡由人拍板。
+    // 不提供任何斜杠命令：人只在「开头选一次」与「过关卡」两处出现。
+    installAutopilot(ctx, { ...resolved.autopilot, specRel: resolved.intake.specRel });
     // 闸门：写作意图闸门 + 不可逆操作闸门 + 意图规格闸门。
     installWritingGate(ctx, resolved.gates);
     installDangerousGate(ctx, resolved.gates);

package/lib/ingest/index.d.ts

@@ -175,5 +175,5 @@ export interface RegisterIngestOptions {
     /** 摄取配置（`maxBytes`/`maxChars`，来自 `src/config.ts`）。 */
     readonly ingest: IngestOptions;
 }
-/** 注册 `thesis_ingest`（同步注册，走仓库统一的 `definePaperTool`；斜杠命令见 `commands.ts`）。 */
+/** 注册 `thesis_ingest`（同步注册，走仓库统一的 `definePaperTool`；本插件不提供斜杠命令）。 */
 export declare function registerIngest(ctx: Context, options: RegisterIngestOptions): void;

package/lib/ingest/index.js

@@ -14,7 +14,6 @@ import { readdir, readFile, stat } from 'node:fs/promises';
 import * as nodePath from 'node:path';
 import { findThesisRoot } from "../paper/lib/project.js";
 import { bulletList, definePaperTool, sessionCwd, textOutput } from "../shared/index.js";
-import { ingestCommand } from "./commands.js";
 import { codeLanguageOf, detectTechStack, isManifestFile, renderProjectSummary, summarizeSource, } from "./code.js";
 import { extractDocx } from "./docx.js";
 import { extractPdf } from "./pdf.js";
@@ -615,7 +614,7 @@ export function renderOutcome(outcome, maxChars) {
         return text;
     return `${text.slice(0, Math.max(0, maxChars - 20))}\n…（清单过长已截断）`;
 }
-/** 注册 `thesis_ingest`（同步注册，走仓库统一的 `definePaperTool`；斜杠命令见 `commands.ts`）。 */
+/** 注册 `thesis_ingest`（同步注册，走仓库统一的 `definePaperTool`；本插件不提供斜杠命令）。 */
 export function registerIngest(ctx, options) {
     ctx.tools.register(definePaperTool({
         name: 'thesis_ingest',
@@ -636,5 +635,4 @@ export function registerIngest(ctx, options) {
             return renderOutcome(outcome, options.ingest.maxChars);
         },
     }));
-    ctx.commands.register(ingestCommand(ctx.fs, options.ingest));
 }

package/lib/intake/gate-rules.d.ts

@@ -52,7 +52,6 @@ export declare function makeIntakeGateMessage(status: SpecStatus, specRel: strin
     }>;
     source: {
         kind: string;
-        plugin: string;
-        form: string;
+        form: 'instructions';
     };
 };

package/lib/intake/gate-rules.js

@@ -10,6 +10,7 @@
  *
  * @module dsh-thesis/intake/gate-rules
  */
+import { THESIS_SOURCE } from "../shared/message-source.js";
 /** 「要开始写正文/开题报告」的意图模式（中英文）。 */
 const WRITING_INTENT_PATTERNS = [
     // 中文：写/生成/起草 + 论文/正文/章节/开题/中期
@@ -114,8 +115,7 @@ export function makeIntakeGateMessage(status, specRel, id) {
         role: 'user',
         content: [{ type: 'text', text }],
         source: {
-            kind: 'plugin',
-            plugin: 'dsh-thesis',
+            ...THESIS_SOURCE,
             form: 'instructions',
         },
     };

package/lib/intake/index.d.ts

@@ -57,20 +57,3 @@ export interface IntakeExecLike {
         };
     };
 }
-/** 命令返回值（宿主 `CommandResult` 的形状）。 */
-export interface IntakeCommandResult {
-    readonly kind: 'success' | 'error';
-    readonly text?: string;
-}
-/** 把 `/thesis-intake` 的一行输入翻译成追问动作。 */
-export declare function parseCommandInput(raw: string): IntakeArgs;
-/**
- * 注册命令 `/thesis-intake`（命令名只允许 `[a-z][a-z0-9_-]*`）。
- *
- * 用法：`/thesis-intake` 取下一个问题；`/thesis-intake status|spec|done|start`；
- * `/thesis-intake answer school.name XX大学`；`/thesis-intake skip ref.samples 暂时没有`。
- * `ctx.commands` 不可用（未装配命令服务的宿主）时静默跳过，不影响工具能力。
- */
-export declare function registerIntakeCommand(ctx: Context, options: {
-    intake: IntakeSubOptions;
-}): boolean;

package/lib/intake/index.js

@@ -414,55 +414,4 @@ export function registerIntake(ctx, options) {
             return await definition.execute(rawArgs, exec);
         },
     }));
-    registerIntakeCommand(ctx, options);
-}
-/** 把 `/thesis-intake` 的一行输入翻译成追问动作。 */
-export function parseCommandInput(raw) {
-    const text = raw.trim();
-    if (text === '')
-        return { action: 'ask' };
-    const [head, ...rest] = text.split(/\s+/);
-    switch (head) {
-        case 'start':
-        case 'ask':
-        case 'status':
-        case 'spec':
-        case 'done':
-            return { action: head };
-        case 'answer': {
-            const [id, ...words] = rest;
-            return { action: 'answer', question_id: id ?? '', answer: words.join(' ') };
-        }
-        case 'skip': {
-            const [id, ...words] = rest;
-            return { action: 'skip', question_id: id ?? '', reason: words.join(' ') };
-        }
-        default:
-            // 不认识的第一个词：当作问题 id 的简写，等价于 answer（模型/人最常这么用）。
-            return { action: 'answer', question_id: head ?? '', answer: rest.join(' ') };
-    }
-}
-/**
- * 注册命令 `/thesis-intake`（命令名只允许 `[a-z][a-z0-9_-]*`）。
- *
- * 用法：`/thesis-intake` 取下一个问题；`/thesis-intake status|spec|done|start`；
- * `/thesis-intake answer school.name XX大学`；`/thesis-intake skip ref.samples 暂时没有`。
- * `ctx.commands` 不可用（未装配命令服务的宿主）时静默跳过，不影响工具能力。
- */
-export function registerIntakeCommand(ctx, options) {
-    const commands = ctx.commands;
-    if (commands === undefined || typeof commands.register !== 'function')
-        return false;
-    commands.register({
-        name: 'thesis-intake',
-        description: '逐题追问：材料到手后把模糊要求变成意图规格（一次一个问题）',
-        input: { hint: 'answer <问题id> <答案>｜skip <问题id> <理由>｜status｜spec｜done（缺省取下一个问题）' },
-        async handler(invocation) {
-            const args = parseCommandInput(invocation.rawInput ?? '');
-            const text = await runIntake(ctx.fs, options.intake, args, sessionCwd(invocation), invocation.signal);
-            // 工具层已经把失败写成可读中文，这里统一按 success 返回（命令不做二次包装）。
-            return { kind: 'success', text };
-        },
-    });
-    return true;
 }

package/lib/intake/questions.d.ts

@@ -23,7 +23,7 @@ import type { IntakeState } from './state.ts';
  * 没有工具兑现的产出物，测试立刻变红——这样「问了一堆用不上的要求」无法退化。
  */
 export type IntakeAffect = '格式检查' | '引用规范' | '字数分配' | '写作规范' | '原创性' | '答案PPT' | '答辩问答' | '文献检索';
-/** 每个产出物由哪些工具兑现（工具名是契约，见 DESIGN.md §5）。 */
+/** 每个产出物由哪些工具兑现（工具名是契约，见 docs/design.md §5）。 */
 export declare const AFFECT_TOOLS: Readonly<Record<IntakeAffect, readonly string[]>>;
 /** 轻校验结果：`ok:false` + `note` 表示「记录但标注问题」，不阻断对话。 */
 export interface AnswerCheck {

package/lib/intake/questions.js

@@ -14,7 +14,7 @@
  *
  * @module dsh-thesis/intake
  */
-/** 每个产出物由哪些工具兑现（工具名是契约，见 DESIGN.md §5）。 */
+/** 每个产出物由哪些工具兑现（工具名是契约，见 docs/design.md §5）。 */
 export const AFFECT_TOOLS = {
     格式检查: ['thesis_check'],
     引用规范: ['thesis_lit_search', 'thesis_lit_save', 'thesis_lit_note', 'thesis_check'],

package/lib/memory/recall.d.ts

@@ -53,8 +53,7 @@ export declare function makeRecallMessage(entries: readonly MemoryEntry[], maxCh
     }>;
     source: {
         kind: string;
-        plugin: string;
-        form: string;
+        form: 'snapshot';
         sections: Array<{
             name: string;
             text: string;

package/lib/memory/recall.js

@@ -17,6 +17,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { textOfBlocks } from "../shared/text.js";
+import { THESIS_SOURCE } from "../shared/message-source.js";
 /** 出厂默认值（与 `PAPER_DEFAULTS.recall` 保持一致，单一来源见 `src/config.ts`）。 */
 export const RECALL_DEFAULTS = { maxEntries: 4, maxChars: 600, minKeywordLength: 2 };
 /** 停用词（中英混合，只去最吵的一批；不求语言学完备）。 */
@@ -111,8 +112,7 @@ export function makeRecallMessage(entries, maxChars) {
         role: 'user',
         content: [{ type: 'text', text }],
         source: {
-            kind: 'plugin',
-            plugin: 'dsh-thesis',
+            ...THESIS_SOURCE,
             form: 'snapshot',
             sections: [{ name: '已确认事实', text }],
         },

package/lib/paper/lib/layout.d.ts

@@ -1,5 +1,5 @@
 /**
- * 论文工作区布局与全部模板文件内容（DESIGN.md §5 的落地）。
+ * 论文工作区布局与全部模板文件内容（docs/design.md §5 的落地）。
  *
  * thesis_init 按此生成目录树；模板内容与技能包（plugin/skills/）保持一致。
  * 本模块只依赖 Node 内置能力。

package/lib/paper/lib/layout.js

@@ -1,5 +1,5 @@
 /**
- * 论文工作区布局与全部模板文件内容（DESIGN.md §5 的落地）。
+ * 论文工作区布局与全部模板文件内容（docs/design.md §5 的落地）。
  *
  * thesis_init 按此生成目录树；模板内容与技能包（plugin/skills/）保持一致。
  * 本模块只依赖 Node 内置能力。
@@ -186,7 +186,7 @@ ${HEADER_NOTE}
 ${HEADER_NOTE}
 
 > 每个关键决定的留痕：内容、理由、备选。答辩时它是"我为什么这么写"的证据。
-> 由 \`thesis_decide\` 工具或 /thesis-decide 命令追加。
+> 由 \`thesis_decide\` 工具或 /thesis decide 命令追加。
 
 （暂无决定）
 `,

package/lib/paper/lib/ledger.d.ts

@@ -1,7 +1,7 @@
 /**
  * 进度台账、时间线、决定日志的数据模型与读写逻辑。
  *
- * 设计要点（见 DESIGN.md §5）：
+ * 设计要点（见 docs/design.md §5）：
  * - 台账的机器真相是一个 JSON 状态块，藏在 Markdown 的 `<!-- thesis:state -->`
  *   HTML 注释里；表格等人类可读部分由 renderLedger 每次重绘，两者永不失步。
  * - 关卡闸门（G1/G2/G3/G4）在工具层强制执行，不是"靠 AI 自觉"：

package/lib/paper/lib/ledger.js

@@ -1,7 +1,7 @@
 /**
  * 进度台账、时间线、决定日志的数据模型与读写逻辑。
  *
- * 设计要点（见 DESIGN.md §5）：
+ * 设计要点（见 docs/design.md §5）：
  * - 台账的机器真相是一个 JSON 状态块，藏在 Markdown 的 `<!-- thesis:state -->`
  *   HTML 注释里；表格等人类可读部分由 renderLedger 每次重绘，两者永不失步。
  * - 关卡闸门（G1/G2/G3/G4）在工具层强制执行，不是"靠 AI 自觉"：

package/lib/paper/register.d.ts

@@ -1,8 +1,8 @@
 /**
- * 论文工作区的工具与命令装配：台账、关卡、文献、评审、检查、构建、答辩素材。
+ * 论文工作区的工具装配：台账、关卡、文献、评审、检查、构建、答辩素材。
  *
  * 纯业务逻辑在 `paper/tools/*.ts` 与 `paper/lib/*.ts`（零 cordis 依赖、可独立
- * 测试）；本文件只做 `defineTool` / 命令注册的胶水。
+ * 测试）；本文件只做 `defineTool` 的胶水。
  *
  * @module dsh-thesis/paper
  */

package/lib/paper/register.js

@@ -1,13 +1,12 @@
 /**
- * 论文工作区的工具与命令装配：台账、关卡、文献、评审、检查、构建、答辩素材。
+ * 论文工作区的工具装配：台账、关卡、文献、评审、检查、构建、答辩素材。
  *
  * 纯业务逻辑在 `paper/tools/*.ts` 与 `paper/lib/*.ts`（零 cordis 依赖、可独立
- * 测试）；本文件只做 `defineTool` / 命令注册的胶水。
+ * 测试）；本文件只做 `defineTool` 的胶水。
  *
  * @module dsh-thesis/paper
  */
 import { definePaperTool, sessionCwd, textOutput, writeBinary } from "../shared/index.js";
-import { buildCommand, checkCommand, decideCommand, litCommand, statusCommand } from "./commands.js";
 import { initSummary, runInit } from "./tools/init.js";
 import { runProgress } from "./tools/progress.js";
 import { runDecision } from "./tools/decision.js";
@@ -175,9 +174,4 @@ export function registerPaper(ctx, options) {
             return await runDefensePrep(ctx.fs, sessionCwd(exec), exec.signal);
         },
     }));
-    ctx.commands.register(statusCommand(ctx.fs));
-    ctx.commands.register(decideCommand(ctx.fs));
-    ctx.commands.register(litCommand(ctx.fs));
-    ctx.commands.register(checkCommand(ctx.fs));
-    ctx.commands.register(buildCommand(ctx.fs));
 }

package/lib/paper/tools/decision.js

@@ -10,7 +10,7 @@ import { DECISION_REL, findThesisRoot } from "../lib/project.js";
 const DECISION_HEADER = `# 决定日志
 
 > 每个关键决定的留痕：内容、理由、备选。答辩时它是"我为什么这么写"的证据。
-> 由 thesis_decide 工具或 /thesis-decide 命令追加。
+> 由 thesis_decide 工具或 /thesis decide 命令追加。
 
 `;
 function deriveTitle(content) {

package/lib/paper/tools/init.d.ts

@@ -1,5 +1,5 @@
 /**
- * thesis_init：一键生成论文工作区（DESIGN.md §5 目录结构 + 技能包 + git 初始化）。
+ * thesis_init：一键生成论文工作区（docs/design.md §5 目录结构 + 技能包 + git 初始化）。
  *
  * 校验规则：
  * - root 必须是绝对路径；

package/lib/paper/tools/init.js

@@ -1,5 +1,5 @@
 /**
- * thesis_init：一键生成论文工作区（DESIGN.md §5 目录结构 + 技能包 + git 初始化）。
+ * thesis_init：一键生成论文工作区（docs/design.md §5 目录结构 + 技能包 + git 初始化）。
  *
  * 校验规则：
  * - root 必须是绝对路径；

package/lib/ppt/index.d.ts

@@ -24,11 +24,10 @@ export { checkDeck, renderCheckReport, verifyAnchors } from './check.ts';
 export type { CheckResult, SlideIssue } from './check.ts';
 export { runPptAction, runOutline, runCheckAction, runConvertAction, runGuideAction, planFromInputs, PPT_RELS } from './actions.ts';
 export type { PptArgs, PptDeps, PptActionResult, DeckCheck } from './actions.ts';
-export { handlePptCommand, parsePptCommandInput } from './commands.ts';
 /** `thesis_slides` 的工具描述（中文，面向模型与用户）。 */
 export declare const PPT_TOOL_DESCRIPTION: string;
 /**
- * 注册 `thesis_slides` 工具与 `/thesis-defense` 命令。
+ * 注册 `thesis_slides` 工具。
  *
  * 二进制例外（与 `thesis_build` 一致，文档化）：pptx 由外部命令直接写在目标路径，
  * `ctx.fs` 无二进制写入能力，故落盘钩子用 node:fs（{@link writeBinary}）；

package/lib/ppt/index.js

@@ -18,14 +18,13 @@ export { renderMarp, parseMarp, parseFrontmatter, findUnsafeMarkdown, sanitizeTh
 export { detectEngines, convert, conversionGuide, renderConversionNotes, guideCommands } from "./convert.js";
 export { checkDeck, renderCheckReport, verifyAnchors } from "./check.js";
 export { runPptAction, runOutline, runCheckAction, runConvertAction, runGuideAction, planFromInputs, PPT_RELS } from "./actions.js";
-export { handlePptCommand, parsePptCommandInput } from "./commands.js";
 /** `thesis_slides` 的工具描述（中文，面向模型与用户）。 */
 export const PPT_TOOL_DESCRIPTION = '答辩幻灯（Markdown 为准，pptx 交给外部工具）：outline 依据 07-答辩/答辩素材.md 生成 Marp 兼容的 07-答辩/PPT.md（10-12 页骨架、每页 3-6 条要点、讲稿注释、证据锚点；默认不覆盖已有文件，force 时先备份）；' +
     'convert 探测 marp / npx marp-cli / pandoc 并执行转换产出 07-答辩/PPT.pptx（失败抛错并给出确切命令，绝不假装成功）；' +
     'check 做确定性质量检查（页数/要点数/字数/讲稿/锚点/待补充标记/预计时长 8-12 分钟）并逐条定位；guide 只输出转换指引。' +
     '无论成败都写 07-答辩/PPT转换说明.md（探测结果 + 命令 + 退出码 + 输出摘要）。';
 /**
- * 注册 `thesis_slides` 工具与 `/thesis-defense` 命令。
+ * 注册 `thesis_slides` 工具。
  *
  * 二进制例外（与 `thesis_build` 一致，文档化）：pptx 由外部命令直接写在目标路径，
  * `ctx.fs` 无二进制写入能力，故落盘钩子用 node:fs（{@link writeBinary}）；

package/lib/shared/define-tool.d.ts

@@ -16,7 +16,7 @@
  *   并提供同样的"参数违规 → `INVALID_ARGS`"行为。
  *
  * 编译结果的一致性由两件事兜底：① `tests/shared-define-tool.test.ts` 逐例断言
- * 编译产物；② `scripts/host-smoke.mjs` 在真实 DSH 宿主上注册并执行工具（见 README「开发」）。
+ * 编译产物；② `scripts/host-smoke.ts` 在真实 DSH 宿主上注册并执行工具（见 README「开发」）。
  *
  * @module dsh-thesis/shared/define-tool
  */

package/lib/shared/define-tool.js

@@ -16,7 +16,7 @@
  *   并提供同样的"参数违规 → `INVALID_ARGS`"行为。
  *
  * 编译结果的一致性由两件事兜底：① `tests/shared-define-tool.test.ts` 逐例断言
- * 编译产物；② `scripts/host-smoke.mjs` 在真实 DSH 宿主上注册并执行工具（见 README「开发」）。
+ * 编译产物；② `scripts/host-smoke.ts` 在真实 DSH 宿主上注册并执行工具（见 README「开发」）。
  *
  * @module dsh-thesis/shared/define-tool
  */

package/lib/shared/message-source.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 注入消息的 source 约定。
+ *
+ * 宿主从 v4 会话格式起要求消息 source 是**生产者自有的 kind**：共享兜底值
+ * `plugin` 会被直接拒写，错误是 `format v4 message requires a producer-owned
+ * source kind`，而且发生在写会话日志时——整条会话都起不来。2.0.1 发布后真踩过。
+ *
+ * 第三方插件的规范形态是 `plugin:<包名>`：宿主的 v3→v4 迁移器给未知生产者生成的
+ * 就是这个值（`@deepseek-ai/dsh-session-format-v3-to-v4` 里的 `producerKind`），
+ * 因此旧会话迁移后与新消息同源同 kind，前端不会把同一类上下文认成两种东西。
+ *
+ * @module dsh-thesis/shared/message-source
+ */
+/** 插件标识（与 package.json 的 name 一致）。 */
+export declare const PLUGIN_ID = "dsh-thesis";
+/** 生产者自有 kind。**不要改回 `plugin`**，否则 v4 会话写不进去。 */
+export declare const THESIS_SOURCE_KIND = "plugin:dsh-thesis";
+/** 注入消息 source 的基础形状（`form`/`sections` 由调用方补充）。 */
+export declare const THESIS_SOURCE: {
+    readonly kind: "plugin:dsh-thesis";
+};

package/lib/shared/message-source.js

@@ -0,0 +1,19 @@
+/**
+ * 注入消息的 source 约定。
+ *
+ * 宿主从 v4 会话格式起要求消息 source 是**生产者自有的 kind**：共享兜底值
+ * `plugin` 会被直接拒写，错误是 `format v4 message requires a producer-owned
+ * source kind`，而且发生在写会话日志时——整条会话都起不来。2.0.1 发布后真踩过。
+ *
+ * 第三方插件的规范形态是 `plugin:<包名>`：宿主的 v3→v4 迁移器给未知生产者生成的
+ * 就是这个值（`@deepseek-ai/dsh-session-format-v3-to-v4` 里的 `producerKind`），
+ * 因此旧会话迁移后与新消息同源同 kind，前端不会把同一类上下文认成两种东西。
+ *
+ * @module dsh-thesis/shared/message-source
+ */
+/** 插件标识（与 package.json 的 name 一致）。 */
+export const PLUGIN_ID = 'dsh-thesis';
+/** 生产者自有 kind。**不要改回 `plugin`**，否则 v4 会话写不进去。 */
+export const THESIS_SOURCE_KIND = `plugin:${PLUGIN_ID}`;
+/** 注入消息 source 的基础形状（`form`/`sections` 由调用方补充）。 */
+export const THESIS_SOURCE = { kind: THESIS_SOURCE_KIND };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-thesis",
-  "version": "1.0.1",
+  "version": "2.0.2",
   "description": "论文与答辩全流程助手（DeepSeek Harness 插件）：材料摄取 → 逐题追问 → 文献检索 → 逐章写作与评审 → 原创性自查与合规 → Word/答辩幻灯生产，全流程留痕，并跨会话记住学校规范与导师要求。",
   "type": "module",
   "main": "lib/index.js",
@@ -15,19 +15,18 @@
     "skills",
     "cordis.patch.yml",
     "README.md",
-    "DESIGN.md",
     "NOTICE.md",
-    "docs/host-api.md"
+    "docs"
   ],
   "license": "MIT",
-  "author": "Paloma966",
+  "author": "booondenz",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Paloma966/dsh-thesis.git"
+    "url": "git+https://github.com/booondenz/dsh-thesis.git"
   },
-  "homepage": "https://github.com/Paloma966/dsh-thesis#readme",
+  "homepage": "https://github.com/booondenz/dsh-thesis#readme",
   "bugs": {
-    "url": "https://github.com/Paloma966/dsh-thesis/issues"
+    "url": "https://github.com/booondenz/dsh-thesis/issues"
   },
   "keywords": [
     "dsh",
@@ -49,19 +48,20 @@
     }
   },
   "scripts": {
-    "clean": "node scripts/clean.mjs",
+    "clean": "node scripts/clean.ts",
     "build": "npm run clean && tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.test.json",
+    "typecheck:scripts": "tsc -p tsconfig.scripts.json",
     "test": "node --test tests/",
-    "test:sandbox": "node --test --test-isolation=none \"tests/**/*.test.ts\" \"tests/**/*.test.mjs\"",
-    "test:e2e": "node tests/e2e/paper-full-flow.mjs",
-    "test:bench": "node tests/e2e/paper-full-flow.mjs",
-    "test:net": "node tests/e2e/paper-lit-real.mjs",
-    "test:host": "node scripts/host-smoke.mjs && node .host-smoke/app/run.mjs",
-    "test:host-load": "node scripts/host-verify.mjs",
-    "audit": "node scripts/audit-surface.mjs",
-    "verify": "npm run build && npm run typecheck && npm run test:sandbox && npm run audit && npm run test:e2e",
-    "prepublishOnly": "node scripts/prepublish-guard.mjs"
+    "test:sandbox": "node --test --test-isolation=none \"tests/**/*.test.ts\"",
+    "test:e2e": "node tests/e2e/paper-full-flow.ts",
+    "test:bench": "node tests/e2e/paper-full-flow.ts",
+    "test:net": "node tests/e2e/paper-lit-real.ts",
+    "test:host": "node scripts/host-smoke.ts && node .host-smoke/app/run.ts",
+    "test:host-load": "node scripts/host-verify.ts",
+    "audit": "node scripts/audit-surface.ts",
+    "verify": "npm run build && npm run typecheck && npm run typecheck:scripts && npm run test:sandbox && npm run audit && npm run test:e2e",
+    "prepublishOnly": "node scripts/prepublish-guard.ts"
   },
   "engines": {
     "node": ">=22.16",

package/skills/code-walkthrough/SKILL.md

@@ -40,7 +40,7 @@ defense_code_next            # 2. 取当前里程碑：todo 列表 + 验证门 +
    ├─ defense_code_update action=ask_question     # 3. 提一个追问
    ├─ 学生回答 → 你对照 expected 评分 → action=assess_answer passed=true/false
    ├─ 学生卡住 → action=give_hint（一次一条，不要一次给完）
-   └─ /thesis-defense check <里程碑>              # 4. 真跑验证门
+   └─ defense_code_update action=check_gate <里程碑>   # 4. 真跑验证门
    ↓
 全部问题通过 + 验证门为绿 → 里程碑 verified
    ↓
@@ -50,9 +50,11 @@ defense_code_update action=advance_phase      # 5. 直到 complete
 ## 第一次使用：建立演练
 
 ```
-/thesis-defense new <你的项目绝对路径> [--lang go] [--level beginner|intermediate|advanced] [--module 子模块]
+defense_code_update action=new  path=<你的项目绝对路径>  lang=go  level=beginner  module=子模块
 ```
 
+（本插件没有斜杠命令：所有动作都由你调 `defense_code_*` 工具完成。）
+
 然后由你（AI）分析项目并把结构登记成 todo 与里程碑：
 
 - `defense_code_update action=upsert_todo`：一个可动手的小任务（读数据模型、实现某个 CRUD、接一个接口）。
@@ -86,7 +88,7 @@ defense_code_update action=advance_phase      # 5. 直到 complete
 |---|---|
 | 论文怎么组织、章节怎么验收 | `thesis-writing` / `thesis-pipeline` |
 | 答辩幻灯结构与问题库 | `thesis-defense` |
-| **把系统搞懂、被追问到能自证** | **本技能**（配 `defense_code_*` 三个工具与 `/thesis-defense` 命令） |
+| **把系统搞懂、被追问到能自证** | **本技能**（配 `defense_code_*` 三个工具） |
 
 ## 完成的标准