Preface

One of the philosophies of DSH (DeepSeek Harness) is “everything is a plugin,” and many long processes can be broken down into installable, rollback-able, and checkable workflows. For teachers or curriculum organizers, a common problem is: having a batch of textbook PDFs and wanting to turn them into a processable, reviewable, and downloadable teaching blueprint, but handling material parsing, knowledge structuring, chapter design, and draft review involves multiple stages.

dsh-craft-your-textbook is a plugin package for DeepSeek Harness (dsh) designed to convert textbook PDFs into an “AI Teaching Blueprint” through a 6-stage pipeline. Below introduces what it is, what it does, how to install it, and typical usage steps.

What is it

  • Plugin Name: xx-hub/dsh-craft-your-textbook.
  • Maintainer: xx-hub.
  • Positioning: A 6-stage pipeline to convert textbook PDFs into an “AI Teaching Blueprint,” a plugin package for dsh.
  • License: MIT.
  • Entry Point: After installation, enable “Book Creation Mode” in the dsh web interface (web profile).

Core Features

This plugin splits the textbook processing process into several nodes that can be paused, finalized, and rolled back. It is noted to be entirely in Chinese and requires no technical knowledge.

  1. Upload Textbook PDF
    Supports student books, teacher’s manuals, syllabi, handouts, past exam papers, etc. Multiple selections are allowed at once.

  2. AI Probe Material
    The AI probes the uploaded material and generates a source material index, knowledge map, key difficulties, and chapter arrangement.

  3. Key Decision Finalization
    Key schemes such as learning objectives and methods, chapter structure, etc., are made into “finalization checkpoints.” It is noted that the process will not proceed below until finalized.

  4. Generate Best Example Chapter
    First generates a chapter as a template for the whole book. Supports line-by-line comments, comparing with old drafts, and listing word counts per chapter.

  5. Build Chapters
    The remaining chapters are written by the assistant, audited by the assistant, and finally reviewed by the main AI. Supports chapter-by-chapter preview and commenting.

  6. Full Chapter Review
    After all chapters are written, it stops at the “Full Chapter Review” card, allowing the user to check chapter by chapter; only after all are satisfied does it proceed to the final check.

  7. Targeted Modification, Reminding, and Revert
    - Supports targeted modification of finalized historical decisions, with downstream impact prompts. It is noted that it can be one-click rolled back within 10 minutes.
    - Supports reminding or “poking” the AI to alert unfinished or stalled tasks.
    - Supports reverting to the previous decision point. It is noted that old versions are kept read-only.

  8. Demo Flow
    Provides a “Create a demo book to try first” flow; it is noted that this demo flow does not consume model quota.

  9. Delivery
    After passing the final check, deliver <Book Title>.md, along with a “How to use this book” guide and a checklist for implementing style suggestions.

Installation and Enablement

First, confirm the environment: you need DeepSeek Harness (dsh) installed and the web interface (web profile) accessible.

Then run the recommended installation command from the README:

npx dsh-craft-your-textbook

Before first use, two things need to be configured:

  1. Configure LLM Interface
    It is noted that any interface compatible with OpenAI is accepted, for example, the DeepSeek official key.

  2. Configure MinerU Token
    MinerU Token is used for PDF conversion.

After configuration, click “I’m ready, continue”.

Subsequently, open the plugin entry:

  1. Restart dsh.
  2. Open http://127.0.0.1:3080 in the browser.
  3. Create a new session.
  4. Select “Book Creation Mode” in the mode.
  5. Enter the workbench and start a new book.

Typical Usage

Below is a reproducible usage path.

  1. Install Plugin
npx dsh-craft-your-textbook
  1. Open Workbench

After restarting dsh, open:

http://127.0.0.1:3080

Then create a new session and select “Book Creation Mode” in the mode.

  1. Create New Book and Upload Material

Click “+ New Book” in the workbench, fill in the book title and goals.

Then upload the textbook PDFs, and mark the role for each material, e.g., student book, teacher’s manual, syllabus, handout, past exam papers.

Click “Start Conversion” when done.

  1. View Probe Results

The workbench will show the “Probe Results” card.

If satisfied, click “Satisfied, continue design”.

If not satisfied, click “Let AI redo”.

  1. Process Example Chapter

For the generated best example chapter, you can write comments line by line, or click “Compare with Draft N” to see the changes.

If satisfied, click “Satisfied, continue writing whole book”.

  1. Spot Check Build Phase

During the build phase, you can click “Look at this chapter” to preview a specific chapter.

If you think adjustments are needed, click “Write comments” to ask AI to modify and self-check.

  1. Full Chapter Review

After all chapters are written, you will enter the “Full Chapter Review” card.

After checking chapter by chapter, if all are satisfied, click “All passed, deliver” to enter the final check.

  1. Download Product

After passing the final check, click “Download .md”.

Also check the “Your style lines are in place” checklist to confirm the implementation of style suggestions in the final product.

  1. Configure Before Using

If this is your first time, configure the LLM Interface and MinerU Token first, then click “I’m ready, continue”.

Suitable Scenarios and Notes

Suitable for:

  • People who need to organize existing textbook PDFs into a processable, reviewable, downloadable Markdown teaching blueprint.
  • People who want to retain decision-making power on key schemes rather than letting AI run the whole process at once.
  • People who want to use the Chinese interface throughout and, given no technical knowledge is required, try the dsh plugin flow.

Notes:

  • The generated content is for teaching reference; AI may be incorrect, so teachers or parents should verify before use.
  • Book project data is saved in the current session workspace directory; the workspace may be unavailable or old books may be located in ~/.dsh/textbook/projects/.
  • Uninstalling removes the plugin and deletes ~/.dsh/.agent-presets/textbook, but book project data remains in ~/.dsh/textbook/projects.
  • The README mentions you can tell the wizard a budget limit in the chat; it will pause and ask if exceeded.
  • The plugin runs with the current dsh process permissions. Suggest checking source code and license before installing; this package license is MIT.
  • This directory page is just a plugin lead, not to be understood as an official app store; the DSH community directory is an independent site.

Links

  • GitHub: https://github.com/xx-hub/dsh-craft-your-textbook
  • Directory Lead: https://www.skillhub.cn/plugins/xx-hub/dsh-craft-your-textbook
    This link is from the plugin lead and could not be independently verified from the data captured in this session.