dsh-lesson-outline

Readme

# dsh-lesson-outline

**教学课件大纲生成工具插件**（DeepSeek Harness `dsh-plugin`）

输入主题 + 章节数 + 学员水平 → 输出结构化课件大纲 JSON。纯逻辑实现，不调用外部 API、不烧 token。

## 功能

`lesson_outline` 工具：给模型一个确定性的"课件大纲脚手架"——模型输入 `topic`（主题）、`sections`（章节数 1-8，默认 3）、`level`（beginner/intermediate/advanced，默认 beginner），工具返回规范化大纲 JSON（含每节标题/要点/时长/教学活动），模型基于它展开完整课件内容。

## 安装（dsh bundle 方式）

```sh
# 在 dsh 环境
dsh plugin --profile <name> add dsh-lesson-outline
```

或在 profile 的 `cordis.patch.yml` 添加：

```yaml
- insert:
    - id: dsh-lesson-outline
      name: 'dsh-lesson-outline'
```

## 开发

```sh
npm install
npm run build       # tsc 编译到 lib/
npm test            # node:test 单元测试（tsx 运行）
```

## 输出示例

输入：`{ topic: "Python 正则表达式入门", sections: 3, level: "beginner" }`

```json
{
  "topic": "Python 正则表达式入门",
  "level": "beginner",
  "totalDurationMin": 45,
  "sections": [
    { "title": "第 1 节", "keyPoints": ["..."], "durationMin": 15, "activity": "讲解 + 演示" },
    { "title": "第 2 节", "keyPoints": ["..."], "durationMin": 15, "activity": "练习 + 讨论" },
    { "title": "第 3 节", "keyPoints": ["..."], "durationMin": 15, "activity": "讲解 + 演示" }
  ],
  "summary": "《Python 正则表达式入门》课件大纲（beginner 级，3 节，约 45 分钟）"
}
```

## License

MIT