dsh-paper-slides

Readme

<p align="center"><strong>dsh-paper-slides</strong></p>

# Paper → academic talk, for DeepSeek Harness

English | [中文](README_CN.md)

[![npm](https://img.shields.io/npm/v/dsh-paper-slides?label=npm)](https://www.npmjs.com/package/dsh-paper-slides) [![CI](https://github.com/literaf/dsh-paper-slides/actions/workflows/ci.yml/badge.svg)](https://github.com/literaf/dsh-paper-slides/actions/workflows/ci.yml) [![dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-blue)](https://github.com/topics/dsh-plugin) ![license](https://img.shields.io/badge/license-MIT-green)

Give the agent a DOI and a slot length, get a talk: the **actual full text** read rather than the abstract, the slot budgeted for the venue, the deck built around the figures, and the speaker notes written as the script.

```
"把这篇 10.1038/s41586-021-03819-2 做成 12 分钟的会议报告"
```

## Install

This pack orchestrates; it reads nothing and renders nothing itself. Install all three:

```sh
dsh plugin --profile web add dsh-ai4scholar dsh-slides dsh-paper-slides
dsh web
```

| Package | Supplies |
|---|---|
| [`dsh-ai4scholar`](https://github.com/literaf/dsh-ai4scholar) | The paper — search, full text, figures, citations |
| [`dsh-slides`](https://github.com/literaf/dsh-slides) | Writing the deck to a file |
| **`dsh-paper-slides`** | The arc between them |

With a companion missing, the guidance says so and names the install command rather than routing around it — a talk drafted from a remembered abstract is exactly what this pack exists to prevent.

## What it adds

**`plan_talk`** — the part of "turn a paper into a talk" that is not a judgement call. How long a slot runs, how many slides fit, and which beats a venue expects are conventions, so they are data here rather than improvised per call:

| Venue | Typical | The rule that decides the talk |
|---|---|---|
| `seminar` 组会汇报 | 15 min | The room knows the field. Skip the background; spend it on what you did and what is stuck |
| `conference` 会议报告 | 12 min | One message. Decide the sentence they remember, make every slide serve it |
| `defense` 答辩 | 25 min | The committee weighs whether the contribution is yours and whether you know its limits |
| `proposal` 开题 | 20 min | No results yet, so the talk is judged on feasibility. Spend the slides there |
| `journal-club` 文献汇报 | 20 min | Someone else's paper. The value you add is judgement, not a summary |

The tool returns a slide budget per beat, plus what belongs **on the slide** versus **in the notes**. Beats keep their minimum however short the slot; what is left over goes to the evidence, not the setup.

It also returns the **formats the venue expects**, to be passed straight to `make_slides`. A defense, a conference talk and a proposal panel all end with someone else's machine opening the file, so those ask for `["html", "pptx"]`; a group meeting and a journal club do not, so those stay `["html"]`. Which file a venue wants is a convention too, and getting it wrong means arriving with a deck the room cannot open.

**The `paper-to-talk` skill** — the long procedure: read for the four questions a talk has to answer, decide the one message before drafting, title figure slides with the finding rather than "Figure 3", write the notes as what the presenter says, and check the deck against the plan before claiming it is done.

## The chain

1. **Read the paper.** `read_by_doi` / `read_arxiv_paper` / `read_semantic_paper`, or `search_papers` first when only the title is known. Never a remembered abstract.
2. **Budget.** `plan_talk` with the venue and slot. Before drafting — drafting first and trimming later produces a compressed paper instead of a talk.
3. **Build.** `make_slides` with the filled-in plan and the plan's `delivery.formats` — a self-contained HTML deck, plus an editable `.pptx` where the venue needs one.

## Configuration

The bundle inserts one row (`id: paper-slides`). Override it from your profile's `cordis.patch.yml` (a patch replaces the whole `config`, so restate every key you keep):

```yaml
- id: paper-slides
  config:
    skills: true            # register the paper-to-talk skill
    planTool: true          # register plan_talk
    promptGuidance: true
    promptOrder: 145
```

## Notes

- The skill body is in English. The model carries the procedure out and reports in whatever language the user is writing in.
- Output formats come from `dsh-slides`: a self-contained HTML deck that presents offline and prints to PDF, and an editable `.pptx` with the speaker notes carried over.

## License

MIT