dsh-thesis 1.0.1 → 2.0.1

package/lib/commands.js

@@ -1,60 +0,0 @@
-/**
- * 斜杠命令的聚合层。
- *
- * `/thesis-defense` 同时覆盖**答辩幻灯**与**代码演练**两块能力，因此它的注册
- * 放在装配层：`ppt/` 与 `codewalk/` 各自导出处理器，由本文件按子命令调度，
- * 两个模块之间没有反向依赖（见 DESIGN.md 的分层规则）。
- *
- * 命令只做薄封装：解析输入 → 交给对应模块的纯逻辑入口，因此命令行为与工具完全一致。
- *
- * @module dsh-thesis/commands
- */
-import { CODEWALK_COMMAND_HINT, handleCodewalkCommand } from "./codewalk/commands.js";
-import { handlePptCommand, PPT_COMMAND_DESCRIPTION, PPT_COMMAND_HINT, PPT_SUBCOMMANDS } from "./ppt/commands.js";
-/** 答辩命令两侧的子命令集合（仅用于错误提示）。 */
-export const DEFENSE_COMMAND_HINT = `${PPT_COMMAND_HINT} | ${CODEWALK_COMMAND_HINT}`;
-/**
- * 注册 `/thesis-defense`：答辩幻灯 + 代码演练。
- *
- * 幻灯侧子命令：`prepare`（= outline）/ `convert` / `check` / `guide`；
- * 代码演练侧子命令：`new` / `status` / `check`。`check` 两侧同名，按是否给出
- * 里程碑参数区分——幻灯侧的 check 不接受位置参数。
- *
- * headless/ACP 组合没有命令面时静默跳过。
- */
-export function registerDefenseCommand(ctx, options, deps = {}) {
-    const commands = ctx.get('commands');
-    if (commands === undefined)
-        return;
-    commands.register({
-        name: 'thesis-defense',
-        description: `答辩准备：幻灯与演练。${PPT_COMMAND_DESCRIPTION}；代码演练：new <原始项目路径> | status | check [里程碑]`,
-        input: { hint: DEFENSE_COMMAND_HINT },
-        handler: async (invocation) => {
-            return await dispatchDefenseCommand(ctx, options, invocation, deps);
-        },
-    });
-}
-/** 按子命令把一次 `/thesis-defense` 调用分派到幻灯侧或代码演练侧。 */
-export async function dispatchDefenseCommand(ctx, options, invocation, deps = {}) {
-    const tokens = invocation.rawInput.trim().split(/\s+/).filter(token => token !== '');
-    const sub = (tokens[0] ?? 'prepare').toLowerCase();
-    if (PPT_SUBCOMMANDS.includes(sub)) {
-        return await handlePptCommand(ctx.fs, options, invocation, deps);
-    }
-    if (sub === 'new' || sub === 'status' || (sub === 'check' && tokens.length > 1)) {
-        const engine = ctx.get('paperCodeWalkthrough');
-        if (engine === undefined) {
-            return { kind: 'error', text: '代码演练引擎未装配：请确认插件配置里 codeWalkthrough 已启用。' };
-        }
-        return await handleCodewalkCommand(ctx, engine, invocation);
-    }
-    if (sub === 'check') {
-        // 无里程碑参数的 check 属于幻灯侧质量检查。
-        return await handlePptCommand(ctx.fs, options, invocation, deps);
-    }
-    return {
-        kind: 'error',
-        text: `未知子命令「${sub}」。可用：${DEFENSE_COMMAND_HINT}`,
-    };
-}

package/lib/dedup/commands.d.ts

@@ -1,21 +0,0 @@
-/**
- * 斜杠命令：`/thesis-originality`。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case），与 `/thesis-check` 等同一套写法。
- * 命令只是 `thesis_originality` 工具的薄封装：把命令行输入解析成 `DedupArgs` 后交给 `runDedup`，
- * 因此行为与工具**完全一致**，不存在"命令和工具两条逻辑"的漂移。
- *
- * @module dsh-thesis/dedup
- */
-import type { FileSystem } from '@deepseek-ai/dsh-fs';
-import type { SimilarityOptions } from '../config.ts';
-import { type DedupArgs } from './index.ts';
-/**
- * 解析 `/thesis-originality` 的输入。
- *
- * 支持：`scan|verify|report`、位置参数（语料路径）、`--chapter <章节>`、
- * `--baseline <报告路径>`、`--rate <重复率>`、`--system <检测系统名>`。
- */
-export declare function parseDedupCommandInput(rawInput: string): DedupArgs;
-/** 构造 `/thesis-originality` 命令定义。 */
-export declare function dedupCommand(fs: FileSystem, similarity: SimilarityOptions): unknown;

package/lib/dedup/commands.js

@@ -1,93 +0,0 @@
-/**
- * 斜杠命令：`/thesis-originality`。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case），与 `/thesis-check` 等同一套写法。
- * 命令只是 `thesis_originality` 工具的薄封装：把命令行输入解析成 `DedupArgs` 后交给 `runDedup`，
- * 因此行为与工具**完全一致**，不存在"命令和工具两条逻辑"的漂移。
- *
- * @module dsh-thesis/dedup
- */
-import { runDedup } from "./index.js";
-const ACTIONS = ['scan', 'verify', 'report'];
-async function safe(work) {
-    try {
-        return { kind: 'success', text: await work() };
-    }
-    catch (error) {
-        return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
-    }
-}
-/**
- * 解析 `/thesis-originality` 的输入。
- *
- * 支持：`scan|verify|report`、位置参数（语料路径）、`--chapter <章节>`、
- * `--baseline <报告路径>`、`--rate <重复率>`、`--system <检测系统名>`。
- */
-export function parseDedupCommandInput(rawInput) {
-    const tokens = rawInput.trim().split(/\s+/).filter(token => token !== '');
-    let action = 'scan';
-    const paths = [];
-    let chapter;
-    let baseline;
-    let detectedRate;
-    let detectedSystem;
-    for (let index = 0; index < tokens.length; index += 1) {
-        const token = tokens[index];
-        const lowered = token.toLowerCase();
-        if (ACTIONS.includes(lowered)) {
-            action = lowered;
-            continue;
-        }
-        if (lowered === '--chapter' || lowered === '-c') {
-            chapter = tokens[++index];
-            if (chapter === undefined)
-                throw new Error('--chapter 后面要跟章节名，如 --chapter 01-绪论');
-            continue;
-        }
-        if (lowered === '--baseline' || lowered === '-b') {
-            baseline = tokens[++index];
-            if (baseline === undefined)
-                throw new Error('--baseline 后面要跟报告路径');
-            continue;
-        }
-        if (lowered === '--rate' || lowered === '-r') {
-            const raw = tokens[++index];
-            const rate = raw === undefined ? Number.NaN : Number.parseFloat(raw);
-            if (!Number.isFinite(rate))
-                throw new Error('--rate 后面要跟数字，如 --rate 12 或 --rate 0.12');
-            detectedRate = rate;
-            continue;
-        }
-        if (lowered === '--system' || lowered === '-s') {
-            detectedSystem = tokens[++index];
-            if (detectedSystem === undefined)
-                throw new Error('--system 后面要跟检测系统名，如 --system 知网');
-            continue;
-        }
-        if (token.startsWith('-'))
-            throw new Error(`无法识别的选项「${token}」`);
-        paths.push(token);
-    }
-    return {
-        action,
-        ...(paths.length > 0 ? { corpus: paths.join(',') } : {}),
-        ...(chapter !== undefined ? { chapter } : {}),
-        ...(baseline !== undefined ? { baseline } : {}),
-        ...(detectedRate !== undefined ? { detected_rate: detectedRate } : {}),
-        ...(detectedSystem !== undefined ? { detected_system: detectedSystem } : {}),
-    };
-}
-/** 构造 `/thesis-originality` 命令定义。 */
-export function dedupCommand(fs, similarity) {
-    return {
-        name: 'thesis-originality',
-        description: '原创性自查：本地相似度扫描（scan）/ 复测降幅（verify）/ 汇总并回填学校检测结果（report）；不接入收费查重系统',
-        input: { hint: 'scan | verify | report [语料路径] [--chapter 01-绪论] [--rate 12] [--system 知网]' },
-        async handler(invocation) {
-            return await safe(async () => {
-                const args = parseDedupCommandInput(invocation.rawInput);
-                return await runDedup(fs, invocation.agent.session.header.cwd, args, similarity, invocation.signal);
-            });
-        },
-    };
-}

package/lib/ingest/commands.d.ts

@@ -1,23 +0,0 @@
-/**
- * 斜杠命令：`/thesis-ingest`。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case），与 `/thesis-check` 等同一套写法。
- * 命令只是 `thesis_ingest` 工具的薄封装：把命令行输入解析成 `IngestArgs` 后交给 `runIngest`，
- * 因此行为与工具**完全一致**。
- *
- * @module dsh-thesis/ingest
- */
-import type { FileSystem } from '@deepseek-ai/dsh-fs';
-import type { IngestOptions } from '../config.ts';
-import { type IngestArgs } from './index.ts';
-/**
- * 解析 `/thesis-ingest` 的输入。
- *
- * 用法：`/thesis-ingest <绝对路径> [--glob docx,pdf] [--dry]`
- * - `<绝对路径>`：文件或目录（目录递归；源码目录会产出代码结构摘要）
- * - `--glob`：后缀过滤，逗号分隔
- * - `--dry`：只读不落盘（不写材料清单与摘要文件）
- */
-export declare function parseIngestCommandInput(rawInput: string): IngestArgs;
-/** 构造 `/thesis-ingest` 命令定义。 */
-export declare function ingestCommand(fs: FileSystem, options: IngestOptions): unknown;

package/lib/ingest/commands.js

@@ -1,74 +0,0 @@
-/**
- * 斜杠命令：`/thesis-ingest`。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case），与 `/thesis-check` 等同一套写法。
- * 命令只是 `thesis_ingest` 工具的薄封装：把命令行输入解析成 `IngestArgs` 后交给 `runIngest`，
- * 因此行为与工具**完全一致**。
- *
- * @module dsh-thesis/ingest
- */
-import { diskIO, renderOutcome, runIngest } from "./index.js";
-async function safe(work) {
-    try {
-        return { kind: 'success', text: await work() };
-    }
-    catch (error) {
-        return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
-    }
-}
-/**
- * 解析 `/thesis-ingest` 的输入。
- *
- * 用法：`/thesis-ingest <绝对路径> [--glob docx,pdf] [--dry]`
- * - `<绝对路径>`：文件或目录（目录递归；源码目录会产出代码结构摘要）
- * - `--glob`：后缀过滤，逗号分隔
- * - `--dry`：只读不落盘（不写材料清单与摘要文件）
- */
-export function parseIngestCommandInput(rawInput) {
-    const tokens = rawInput.trim().split(/\s+/).filter(token => token !== '');
-    let path;
-    let glob;
-    let write = true;
-    for (let index = 0; index < tokens.length; index += 1) {
-        const token = tokens[index];
-        const lowered = token.toLowerCase();
-        if (lowered === '--glob' || lowered === '-g') {
-            glob = tokens[++index];
-            if (glob === undefined)
-                throw new Error('--glob 后面要跟后缀列表，如 --glob docx,pdf');
-            continue;
-        }
-        if (lowered === '--dry' || lowered === '--no-write') {
-            write = false;
-            continue;
-        }
-        if (token.startsWith('-'))
-            throw new Error(`无法识别的选项「${token}」`);
-        if (path !== undefined)
-            throw new Error(`只能指定一个路径（多余的是「${token}」）`);
-        path = token;
-    }
-    if (path === undefined) {
-        throw new Error('用法：/thesis-ingest <绝对路径> [--glob docx,pdf] [--dry]');
-    }
-    return {
-        path,
-        ...(glob !== undefined ? { glob } : {}),
-        ...(write ? {} : { write: false }),
-    };
-}
-/** 构造 `/thesis-ingest` 命令定义。 */
-export function ingestCommand(fs, options) {
-    return {
-        name: 'thesis-ingest',
-        description: '摄取材料：docx/xlsx/pptx/pdf/md/csv/bib + 源码目录 → 文本与代码结构摘要，写 00-管理/材料清单.md',
-        input: { hint: '<绝对路径> [--glob docx,pdf] [--dry]' },
-        async handler(invocation) {
-            return await safe(async () => {
-                const args = parseIngestCommandInput(invocation.rawInput);
-                const outcome = await runIngest(fs, diskIO, args, invocation.agent.session.header.cwd, options, invocation.signal);
-                return renderOutcome(outcome, options.maxChars);
-            });
-        },
-    };
-}

package/lib/paper/commands.d.ts

@@ -1,13 +0,0 @@
-/**
- * 斜杠命令：/thesis-status 与 /thesis-decide。
- *
- * 注：DSH 命令名只允许 [a-z][a-z0-9_-]*，因此使用 kebab-case
- * （DESIGN.md 中的 /thesis:status 在此修正为 /thesis-status）。
- * 其余命令（/thesis-lit、/thesis-check、/thesis-build）随 M2/M4 工具一并注册。
- */
-import type { FileSystem } from '@deepseek-ai/dsh-fs';
-export declare function statusCommand(fs: FileSystem): unknown;
-export declare function decideCommand(fs: FileSystem): unknown;
-export declare function litCommand(fs: FileSystem): unknown;
-export declare function checkCommand(fs: FileSystem): unknown;
-export declare function buildCommand(fs: FileSystem): unknown;

package/lib/paper/commands.js

@@ -1,84 +0,0 @@
-/**
- * 斜杠命令：/thesis-status 与 /thesis-decide。
- *
- * 注：DSH 命令名只允许 [a-z][a-z0-9_-]*，因此使用 kebab-case
- * （DESIGN.md 中的 /thesis:status 在此修正为 /thesis-status）。
- * 其余命令（/thesis-lit、/thesis-check、/thesis-build）随 M2/M4 工具一并注册。
- */
-import { writeFile } from 'node:fs/promises';
-import { runDecision } from "./tools/decision.js";
-import { runLitSearch } from "./tools/lit.js";
-import { runProgress } from "./tools/progress.js";
-import { buildSummary, runBuild } from "./tools/build.js";
-import { runCheck } from "./tools/check.js";
-function cwdOf(invocation) {
-    return invocation.agent.session.header.cwd;
-}
-async function safe(work) {
-    try {
-        return { kind: 'success', text: await work() };
-    }
-    catch (error) {
-        return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
-    }
-}
-export function statusCommand(fs) {
-    return {
-        name: 'thesis-status',
-        description: '查看毕业设计进度台账：当前阶段、人工关卡、任务状态',
-        async handler(invocation) {
-            return await safe(async () => runProgress(fs, { action: 'report' }, cwdOf(invocation), invocation.signal));
-        },
-    };
-}
-export function decideCommand(fs) {
-    return {
-        name: 'thesis-decide',
-        description: '记录一条关键决定（内容/理由/备选），写入决定日志',
-        input: { hint: '决定内容' },
-        async handler(invocation) {
-            const content = invocation.rawInput.trim();
-            if (content === '') {
-                return { kind: 'error', text: '用法：/thesis-decide <决定内容>。内容不能为空。' };
-            }
-            return await safe(async () => runDecision(fs, { content }, cwdOf(invocation), invocation.signal));
-        },
-    };
-}
-export function litCommand(fs) {
-    return {
-        name: 'thesis-lit',
-        description: '从真实学术数据库检索文献（结果写入检索缓存与审计记录）',
-        input: { hint: '检索关键词' },
-        async handler(invocation) {
-            const query = invocation.rawInput.trim();
-            if (query === '') {
-                return { kind: 'error', text: '用法：/thesis-lit <关键词>。例如 /thesis-lit 目标检测 小目标' };
-            }
-            return await safe(async () => runLitSearch(fs, { query, limit: 5 }, cwdOf(invocation), invocation.signal, fetch));
-        },
-    };
-}
-export function checkCommand(fs) {
-    return {
-        name: 'thesis-check',
-        description: '全文综合检查：引用/字数/图表/术语/模板，报告写入 08-合规/',
-        async handler(invocation) {
-            return await safe(async () => runCheck(fs, cwdOf(invocation), invocation.signal));
-        },
-    };
-}
-export function buildCommand(fs) {
-    return {
-        name: 'thesis-build',
-        description: '构建论文.docx（优先 pandoc + 学校模板，否则内置过渡引擎）',
-        async handler(invocation) {
-            return await safe(async () => {
-                const outcome = await runBuild(fs, {}, cwdOf(invocation), invocation.signal, async (absPath, data) => {
-                    await writeFile(absPath, data);
-                });
-                return buildSummary(outcome);
-            });
-        },
-    };
-}

package/lib/ppt/commands.d.ts

@@ -1,28 +0,0 @@
-/**
- * 斜杠命令 `/thesis-defense` 的**幻灯侧**输入解析。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case）。命令注册本身在
- * 装配层（`src/index.ts`）完成：`/thesis-defense` 同时覆盖答辩幻灯与代码演练，
- * 由装配层聚合两侧的处理器——这样 `ppt/` 与 `codewalk/` 之间没有反向依赖。
- *
- * @module dsh-thesis/ppt
- */
-import type { CommandInvocation, CommandResult } from '@deepseek-ai/dsh-commands';
-import type { FileSystem } from '@deepseek-ai/dsh-fs';
-import type { PptOptions } from '../config.ts';
-import { type PptArgs, type PptDeps } from './actions.ts';
-/** 幻灯侧的子命令（与代码演练侧区分）。 */
-export declare const PPT_SUBCOMMANDS: readonly string[];
-/** 把 `/thesis-defense <输入>` 的幻灯侧部分解析成工具参数。 */
-export declare function parsePptCommandInput(rawInput: string): PptArgs;
-/**
- * 幻灯侧的命令处理器（由装配层在 `/thesis-defense` 下调度）。
- *
- * `rawInput` 仍是命令名之后的全部输入；本函数只关心幻灯侧子命令。
- */
-export declare function handlePptCommand(fs: FileSystem, options: {
-    ppt: PptOptions;
-}, invocation: CommandInvocation, deps?: PptDeps): Promise<CommandResult>;
-/** 命令的展示元信息（装配层注册时使用）。 */
-export declare const PPT_COMMAND_DESCRIPTION = "\u7B54\u8FA9\u5E7B\u706F\uFF1A\u751F\u6210 Marp Markdown\uFF08prepare/outline\uFF09/ \u6267\u884C\u5916\u90E8\u8F6C\u6362\uFF08convert\uFF09/ \u8D28\u91CF\u68C0\u67E5\uFF08check\uFF09/ \u8F6C\u6362\u6307\u5F15\uFF08guide\uFF09";
-export declare const PPT_COMMAND_HINT = "prepare | convert | check | guide [\u9875\u6570] [undergrad|master] [force]";

package/lib/ppt/commands.js

@@ -1,71 +0,0 @@
-/**
- * 斜杠命令 `/thesis-defense` 的**幻灯侧**输入解析。
- *
- * 命令名遵循 DSH 的 `[a-z][a-z0-9_-]*` 约束（kebab-case）。命令注册本身在
- * 装配层（`src/index.ts`）完成：`/thesis-defense` 同时覆盖答辩幻灯与代码演练，
- * 由装配层聚合两侧的处理器——这样 `ppt/` 与 `codewalk/` 之间没有反向依赖。
- *
- * @module dsh-thesis/ppt
- */
-import { runPptAction } from "./actions.js";
-async function safe(work) {
-    try {
-        return { kind: 'success', text: await work() };
-    }
-    catch (error) {
-        return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
-    }
-}
-/** 幻灯侧的子命令（与代码演练侧区分）。 */
-export const PPT_SUBCOMMANDS = ['prepare', 'convert', 'check', 'guide'];
-/** 把 `/thesis-defense <输入>` 的幻灯侧部分解析成工具参数。 */
-export function parsePptCommandInput(rawInput) {
-    const tokens = rawInput.trim().split(/\s+/).filter(t => t !== '');
-    let action = 'outline';
-    let pages;
-    let audience;
-    let force = false;
-    for (const token of tokens) {
-        const lowered = token.toLowerCase();
-        if (lowered === 'prepare' || lowered === 'outline' || lowered === 'convert' || lowered === 'check' || lowered === 'guide') {
-            action = lowered === 'prepare' ? 'outline' : lowered;
-            continue;
-        }
-        if (lowered === 'undergrad' || lowered === 'master') {
-            audience = lowered;
-            continue;
-        }
-        if (lowered === 'force' || lowered === '--force' || lowered === '-f') {
-            force = true;
-            continue;
-        }
-        const number = Number.parseInt(token, 10);
-        if (Number.isFinite(number)) {
-            pages = number;
-            continue;
-        }
-        throw new Error(`无法识别的参数「${token}」。用法：/thesis-defense prepare [页数] [undergrad|master] [force]`
-            + ' | convert | check | guide | new <原始项目路径> | status | check [里程碑]');
-    }
-    return {
-        action,
-        ...(pages !== undefined ? { pages } : {}),
-        ...(audience !== undefined ? { audience } : {}),
-        ...(force ? { force: true } : {}),
-    };
-}
-/**
- * 幻灯侧的命令处理器（由装配层在 `/thesis-defense` 下调度）。
- *
- * `rawInput` 仍是命令名之后的全部输入；本函数只关心幻灯侧子命令。
- */
-export async function handlePptCommand(fs, options, invocation, deps = {}) {
-    return await safe(async () => {
-        const args = parsePptCommandInput(invocation.rawInput);
-        const outcome = await runPptAction(fs, invocation.agent.session.header.cwd, args, options, invocation.signal, deps);
-        return outcome.text;
-    });
-}
-/** 命令的展示元信息（装配层注册时使用）。 */
-export const PPT_COMMAND_DESCRIPTION = '答辩幻灯：生成 Marp Markdown（prepare/outline）/ 执行外部转换（convert）/ 质量检查（check）/ 转换指引（guide）';
-export const PPT_COMMAND_HINT = 'prepare | convert | check | guide [页数] [undergrad|master] [force]';