dsh-thesis 1.0.0 → 2.0.1

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/lib/lit-cache.js

@@ -57,13 +57,13 @@ export function mergeRecords(cache, records) {
         next[record.id] = record;
     return { version: 1, records: next };
 }
-const RECORD_HEADER = `# 文献检索记录
-
-> 每次检索留痕：哪个库、什么关键词、命中多少、收录哪些。
-> 这是"零假文献"的审计证据。
-
-| 日期 | 动作 | 数据库 | 关键词/文献 | 命中 | 备注 |
-|---|---|---|---|---|---|
+const RECORD_HEADER = `# 文献检索记录
+
+> 每次检索留痕：哪个库、什么关键词、命中多少、收录哪些。
+> 这是"零假文献"的审计证据。
+
+| 日期 | 动作 | 数据库 | 关键词/文献 | 命中 | 备注 |
+|---|---|---|---|---|---|
 `;
 export async function appendLitRecord(fs, root, row, signal) {
     const path = nodePath.join(root, LIT_RECORD_REL);

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

@@ -7,11 +7,11 @@ import * as nodePath from 'node:path';
 import { describeReadFailure, isMissingError } from "../../shared/fs-errors.js";
 import { appendDecision, countDecisions } from "../lib/ledger.js";
 import { DECISION_REL, findThesisRoot } from "../lib/project.js";
-const DECISION_HEADER = `# 决定日志
-
-> 每个关键决定的留痕：内容、理由、备选。答辩时它是"我为什么这么写"的证据。
-> 由 thesis_decide 工具或 /thesis-decide 命令追加。
-
+const DECISION_HEADER = `# 决定日志
+
+> 每个关键决定的留痕：内容、理由、备选。答辩时它是"我为什么这么写"的证据。
+> 由 thesis_decide 工具或 /thesis decide 命令追加。
+
 `;
 function deriveTitle(content) {
     const firstLine = content.split('\n')[0].trim();

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/paper/tools/lit.js

@@ -12,10 +12,10 @@ import { searchLiterature, LIT_SOURCES, } from "../lib/lit-api.js";
 import { appendLitRecord, loadCache, mergeRecords, NOTES_DIR_REL, REFS_BIB_REL, saveCache, saveRow, searchRow, } from "../lib/lit-cache.js";
 import { bibKeyFor, buildBibtex, dedupeKey, parseBibDois, parseBibKeys } from "../lib/bibtex.js";
 import { findThesisRoot } from "../lib/project.js";
-const BIB_HEADER = `% 文献库（BibTeX）。
-% 红线：本文件只收录真实检索到的文献（由 thesis_lit_search/save 写入）。
-% 每条必须含 DOI 或 URL。引用格式遵循 GB/T 7714-2015（顺序编码制）。
-
+const BIB_HEADER = `% 文献库（BibTeX）。
+% 红线：本文件只收录真实检索到的文献（由 thesis_lit_search/save 写入）。
+% 每条必须含 DOI 或 URL。引用格式遵循 GB/T 7714-2015（顺序编码制）。
+
 `;
 async function thesisRoot(fs, cwd, signal) {
     const root = await findThesisRoot(fs, cwd, signal);
@@ -129,34 +129,34 @@ function noteTemplate(record, bibKey) {
         meta.push(`URL：${record.url}`);
     if (record.citationCount !== undefined)
         meta.push(`被引 ${record.citationCount} 次`);
-    return `# ${record.title}（${authorText}，${record.year ?? '年份未知'}，${record.venue || '出处未知'}）
-
-> ${meta.join('；')}
-> 笔记模板见技能 thesis-literature；写论文时从这里取"可用引用句"。
-
-## 这篇解决什么问题
-
-（待补）
-
-## 方法/技术要点（3-5 条，用自己的话）
-
-（待补）
-
-## 实验与结论（数据集/指标/结果）
-
-（待补）
-
-## 与我课题的关系
-
-（待补：借鉴什么 / 对比什么 / 差异在哪）
-
-## 可用引用句
-
-（待补：1-2 句，注明放哪一章）
-
-## 摘要（原始）
-
-${record.abstract ?? '（检索记录无摘要；请从原文自行摘录）'}
+    return `# ${record.title}（${authorText}，${record.year ?? '年份未知'}，${record.venue || '出处未知'}）
+
+> ${meta.join('；')}
+> 笔记模板见技能 thesis-literature；写论文时从这里取"可用引用句"。
+
+## 这篇解决什么问题
+
+（待补）
+
+## 方法/技术要点（3-5 条，用自己的话）
+
+（待补）
+
+## 实验与结论（数据集/指标/结果）
+
+（待补）
+
+## 与我课题的关系
+
+（待补：借鉴什么 / 对比什么 / 差异在哪）
+
+## 可用引用句
+
+（待补：1-2 句，注明放哪一章）
+
+## 摘要（原始）
+
+${record.abstract ?? '（检索记录无摘要；请从原文自行摘录）'}
 `;
 }
 /** 从 refs.bib 中按 key 提取最小记录（供 note 在缓存缺失时使用）。 */

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-thesis",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "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,31 +48,37 @@
     }
   },
   "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"
+    "node": ">=22.16",
+    "dsh": ">=0.2.0-rc.2 <0.3.0-0"
   },
   "peerDependencies": {
     "@deepseek-ai/schemastery": "^3.18.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "^0.1.0"
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.3.0-0"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/schemastery": "^3.18.2",

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_*` 三个工具） |
 
 ## 完成的标准
 

package/skills/thesis-defense/SKILL.md

@@ -74,7 +74,7 @@ thesis_slides convert      → 探测 marp / npx marp-cli / pandoc；有则产
 thesis_slides guide        → 只输出转换指引，不执行
 ```
 
-等价斜杠命令：`/thesis-defense prepare [页数] [undergrad|master] [force]`、`convert`、`check`、`guide`。
+本插件没有斜杠命令：幻灯侧全部通过 `thesis_slides` 工具驱动（`action` 取 `outline` / `convert` / `check` / `guide`）。
 
 硬约束（`check` 会逐条查）：每页要点 3-6 条、单条 ≤ 30 字、每页必须有讲稿与证据锚点、
 不得出现"待补充/TODO"、预计时长 8-12 分钟（每页 40-60 秒）。

package/skills/thesis-pipeline/SKILL.md

@@ -77,7 +77,7 @@ description: 计算机类本科毕业设计全流程总纲。任何涉及论文
 - 答辩前要讲清自己的系统：加载 `code-walkthrough`
 - 写作要求被质疑、导师口径模糊：加载 `thesis-inquiry`
 
-## 插件工具地图（dsh-thesis 全集：21 个工具 / 9 个命令）
+## 插件工具地图（dsh-thesis 全集：21 个工具 / 1 条命令 9 个动词）
 
 命名空间规则：`thesis_*` 操作论文工作区里的东西；`fact_*` 操作跨会话的稳定事实；
 `defense_code_*` 是答辩层的代码演练。
@@ -91,9 +91,9 @@ description: 计算机类本科毕业设计全流程总纲。任何涉及论文
 | 写作 | `thesis_review` / `thesis_check` / `thesis_build` | 逐章评审 → 全文一致性检查 → Word 构建 |
 | 合规 | `thesis_stylecheck` / `thesis_originality` | 写作风格自查（AI 味）/ 原创性本地度量与复测 |
 | 答辩 | `thesis_defense` / `thesis_slides` | 答辩素材与问题库 / 幻灯 Markdown 与 pptx 转换 |
-| 答辩 | `defense_code_status` / `defense_code_next` / `defense_code_update` | 代码演练：把系统拆成讲得清的模块（`/thesis-defense` 命令） |
+| 答辩 | `defense_code_status` / `defense_code_next` / `defense_code_update` | 代码演练：把系统拆成讲得清的模块 |
 | 事实 | `fact_search` / `fact_remember` / `fact_context` | 跨会话事实（学校规范、导师要求、写作偏好） |
-| 命令 | `/thesis-status` `/thesis-decide` `/thesis-lit` `/thesis-check` `/thesis-build` `/thesis-ingest` `/thesis-intake` `/thesis-originality` `/thesis-defense` | 上述工具的斜杠入口 |
+| 入口 | 无斜杠命令 | 本插件不提供命令行：在论文工作区开口说话，插件问一道选择题后自己推进；过 G1-G4 时由人拍板 |
 
 ## 会话入口顺序（新会话照这个走）
 

package/lib/codewalk/commands.d.ts

@@ -1,23 +0,0 @@
-/**
- * 人类可用的 `/thesis-defense` 命令：`new`、`status`、`check`。
- *
- * 只有在组合了命令适配器时才通过 `ctx.commands` 注册（交互式部署）；纯 headless
- * 与仅 ACP 的组合没有命令注册表，直接跳过这一层表面。命令面的结果直接渲染，
- * 不进入模型历史。
- *
- * @module dsh-thesis/codewalk
- */
-import type { Context } from '@deepseek-ai/cordis';
-import { AiLearningEngine } from './engine.ts';
-import type { CommandInvocationShape, CommandResultShape } from './host-types.ts';
-/** 代码演练侧的子命令（与幻灯侧区分）。 */
-export declare const CODEWALK_SUBCOMMANDS: readonly string[];
-/** 命令的展示元信息（装配层注册 `/thesis-defense` 时使用）。 */
-export declare const CODEWALK_COMMAND_HINT = "new <\u539F\u59CB\u9879\u76EE\u8DEF\u5F84> [--lang go] [--level beginner] [--module pkg] | status | check [\u91CC\u7A0B\u7891]";
-/**
- * 代码演练侧的命令处理器（由装配层在 `/thesis-defense` 下调度）。
- *
- * `rawInput` 是命令名之后的全部输入；本函数只认代码演练侧的子命令
- * （`new` / `status` / `check`），其余一律交回装配层。
- */
-export declare function handleCodewalkCommand(ctx: Context, engine: AiLearningEngine, invocation: CommandInvocationShape): Promise<CommandResultShape>;

package/lib/codewalk/commands.js

@@ -1,168 +0,0 @@
-/**
- * 人类可用的 `/thesis-defense` 命令：`new`、`status`、`check`。
- *
- * 只有在组合了命令适配器时才通过 `ctx.commands` 注册（交互式部署）；纯 headless
- * 与仅 ACP 的组合没有命令注册表，直接跳过这一层表面。命令面的结果直接渲染，
- * 不进入模型历史。
- *
- * @module dsh-thesis/codewalk
- */
-import { AiLearningEngine } from "./engine.js";
-import { isLearningError } from "./errors.js";
-import { runMilestoneGate } from "./gate.js";
-const DEFAULT_LANGUAGE = 'go';
-const LEVELS = ['beginner', 'intermediate', 'advanced'];
-/** 会话没有工作目录时的统一答复。 */
-const NO_WORKSPACE = {
-    kind: 'error',
-    text: '本次会话没有工作目录，无法定位代码演练状态。请在论文工作区目录里打开会话。',
-};
-/** 代码演练侧的子命令（与幻灯侧区分）。 */
-export const CODEWALK_SUBCOMMANDS = ['new', 'status', 'check'];
-/** 命令的展示元信息（装配层注册 `/thesis-defense` 时使用）。 */
-export const CODEWALK_COMMAND_HINT = 'new <原始项目路径> [--lang go] [--level beginner] [--module pkg] | status | check [里程碑]';
-/**
- * 代码演练侧的命令处理器（由装配层在 `/thesis-defense` 下调度）。
- *
- * `rawInput` 是命令名之后的全部输入；本函数只认代码演练侧的子命令
- * （`new` / `status` / `check`），其余一律交回装配层。
- */
-export async function handleCodewalkCommand(ctx, engine, invocation) {
-    try {
-        const tokens = invocation.rawInput.trim().split(/\s+/);
-        const sub = tokens[0] ?? '';
-        const args = tokens.slice(1);
-        if (sub === 'new')
-            return await handleNew(engine, invocation, args);
-        if (sub === 'status')
-            return await handleStatus(engine, invocation);
-        if (sub === 'check')
-            return await handleCheck(ctx, engine, invocation, args);
-        return { kind: 'error', text: `未知子命令 "${sub}"；代码演练侧应为 new | status | check` };
-    }
-    catch (error) {
-        if (isLearningError(error))
-            return { kind: 'error', text: error.message };
-        const message = error instanceof Error ? error.message : String(error);
-        return { kind: 'error', text: `内部错误：${message}` };
-    }
-}
-function parseNewArgs(args) {
-    const options = { language: DEFAULT_LANGUAGE, level: 'beginner' };
-    const positional = [];
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === '--lang' || arg === '--level' || arg === '--module') {
-            const value = args[index + 1];
-            if (value === undefined)
-                continue;
-            if (arg === '--lang')
-                options.language = value;
-            else if (arg === '--level')
-                options.level = value;
-            else
-                options.module = value;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith('--lang='))
-            options.language = arg.slice('--lang='.length);
-        else if (arg.startsWith('--level='))
-            options.level = arg.slice('--level='.length);
-        else if (arg.startsWith('--module='))
-            options.module = arg.slice('--module='.length);
-        else
-            positional.push(arg);
-    }
-    const first = positional[0];
-    if (first !== undefined)
-        options.path = first;
-    return options;
-}
-async function handleNew(engine, invocation, args) {
-    const options = parseNewArgs(args);
-    if (options.path === undefined) {
-        return {
-            kind: 'error',
-            text: '用法：/thesis-defense new <原始项目路径> [--lang go] [--level beginner] [--module pkg]',
-        };
-    }
-    if (!LEVELS.includes(options.level)) {
-        return { kind: 'error', text: `非法的 level "${options.level}"；应为 ${LEVELS.join(' | ')}` };
-    }
-    const cwd = invocation.agent.session.header.cwd;
-    if (cwd === undefined || cwd === '')
-        return NO_WORKSPACE;
-    const state = await engine.create(cwd, {
-        origin: { path: options.path, language: options.language },
-        scope: { level: options.level, ...(options.module !== undefined ? { module: options.module } : {}) },
-    });
-    return {
-        kind: 'success',
-        text: `已为 ${options.path} 创建代码演练（${options.language}，${options.level}）。\n` +
-            `${engine.describe(state)}\n` +
-            `下一步：让 AI 分析该项目，用 defense_code_update 工具登记 todo 与里程碑。`,
-    };
-}
-async function handleStatus(engine, invocation) {
-    const cwd = invocation.agent.session.header.cwd;
-    if (cwd === undefined || cwd === '')
-        return NO_WORKSPACE;
-    const state = await engine.load(cwd);
-    if (state === undefined) {
-        return { kind: 'error', text: `${cwd} 下没有代码演练状态；请先执行 "/thesis-defense new <原始项目路径>"` };
-    }
-    return { kind: 'success', text: engine.describe(state) };
-}
-async function handleCheck(ctx, engine, invocation, args) {
-    const cwd = invocation.agent.session.header.cwd;
-    if (cwd === undefined || cwd === '')
-        return NO_WORKSPACE;
-    const state = await engine.load(cwd);
-    if (state === undefined) {
-        return { kind: 'error', text: `${cwd} 下没有代码演练状态；请先执行 "/thesis-defense new <原始项目路径>"` };
-    }
-    const milestone = pickMilestone(state.milestones, args[0]);
-    if (milestone === undefined) {
-        return {
-            kind: 'error',
-            text: args[0] === undefined
-                ? '当前没有 in_progress 或 failed 的里程碑，没有可检查的对象'
-                : `未知里程碑 "${args[0]}"`,
-        };
-    }
-    if (milestone.status === 'failed')
-        engine.retryMilestone(state, milestone.id);
-    const settled = await runMilestoneGate(ctx, engine, cwd, state, milestone, invocation.signal, invocation.agent.session);
-    if (settled.interrupted) {
-        return { kind: 'error', text: `验证门 "${settled.command.join(' ')}" 被中断；该里程碑已标记为 failed` };
-    }
-    if (settled.outcome.kind === 'failed') {
-        return {
-            kind: 'error',
-            text: `验证门 "${settled.command.join(' ')}" 失败，退出码 ${settled.exitCode}；该里程碑已标记为 failed。\n` +
-                (settled.stderr.trim() === '' ? `stdout 末尾：\n${settled.stdout}` : `stderr 末尾：\n${settled.stderr}`),
-        };
-    }
-    if (settled.outcome.kind === 'pending-questions') {
-        return {
-            kind: 'success',
-            text: `验证门 "${settled.command.join(' ')}" 通过，但仍有 ${milestone.questions.filter((question) => question.status !== 'passed').length} 个问题未通过。\n` +
-                '让 AI 把追问做完；当验证门为绿且全部问题通过时，该里程碑才算 verified。',
-        };
-    }
-    const next = state.milestones.find((entry) => entry.status === 'in_progress');
-    const complete = state.phase === 'complete';
-    return {
-        kind: 'success',
-        text: `验证门 "${settled.command.join(' ')}" 通过 —— 里程碑 "${milestone.id}" 已验证。\n` +
-            (complete ? '全部里程碑已验证：本次代码演练完成。' : `下一个里程碑：${next?.title ?? '无'}。`),
-    };
-}
-function pickMilestone(milestones, requestedId) {
-    if (requestedId !== undefined) {
-        return milestones.find((milestone) => milestone.id === requestedId);
-    }
-    return (milestones.find((milestone) => milestone.status === 'in_progress') ??
-        milestones.find((milestone) => milestone.status === 'failed'));
-}

package/lib/commands.d.ts

@@ -1,33 +0,0 @@
-/**
- * 斜杠命令的聚合层。
- *
- * `/thesis-defense` 同时覆盖**答辩幻灯**与**代码演练**两块能力，因此它的注册
- * 放在装配层：`ppt/` 与 `codewalk/` 各自导出处理器，由本文件按子命令调度，
- * 两个模块之间没有反向依赖（见 DESIGN.md 的分层规则）。
- *
- * 命令只做薄封装：解析输入 → 交给对应模块的纯逻辑入口，因此命令行为与工具完全一致。
- *
- * @module dsh-thesis/commands
- */
-import type { CommandInvocation, CommandResult } from '@deepseek-ai/dsh-commands';
-import type { Context } from '@deepseek-ai/cordis';
-import type { PptOptions } from './config.ts';
-import type { PptDeps } from './ppt/actions.ts';
-/** 答辩命令两侧的子命令集合（仅用于错误提示）。 */
-export declare const DEFENSE_COMMAND_HINT = "prepare | convert | check | guide [\u9875\u6570] [undergrad|master] [force] | new <\u539F\u59CB\u9879\u76EE\u8DEF\u5F84> [--lang go] [--level beginner] [--module pkg] | status | check [\u91CC\u7A0B\u7891]";
-/**
- * 注册 `/thesis-defense`：答辩幻灯 + 代码演练。
- *
- * 幻灯侧子命令：`prepare`（= outline）/ `convert` / `check` / `guide`；
- * 代码演练侧子命令：`new` / `status` / `check`。`check` 两侧同名，按是否给出
- * 里程碑参数区分——幻灯侧的 check 不接受位置参数。
- *
- * headless/ACP 组合没有命令面时静默跳过。
- */
-export declare function registerDefenseCommand(ctx: Context, options: {
-    ppt: PptOptions;
-}, deps?: PptDeps): void;
-/** 按子命令把一次 `/thesis-defense` 调用分派到幻灯侧或代码演练侧。 */
-export declare function dispatchDefenseCommand(ctx: Context, options: {
-    ppt: PptOptions;
-}, invocation: CommandInvocation, deps?: PptDeps): Promise<CommandResult>;