Preface¶

When reading Markdown documents in DSH, the common practice is to drop the file path or document content directly into the conversation, then rely on prompts to have the model explain, ask questions, or summarize. This approach lacks a stable reading flow: first determine what the reader already knows, then enter the corresponding level, then guide the reading, then check, then settle.

dsh-md-quiz is a web plugin for DeepSeek Harness that turns the reading process of any Markdown document into an actionable “quiz-based reading” flow, providing a sidebar panel and reading area in the DSH Web interface.

What This Is¶

dsh-md-quiz is a plugin designed for the DSH web profile, available at the repository:

https://github.com/MrElysium/dsh-md-quiz

The problem it solves: without being tied to a specific project, it turns .md files in any directory into objects that can be “leveled up” through reading. The plugin registers skills, commands, and file-reading routes with DSH, and provides a quiz-based reading panel and reading area on the web side.

The documentation does not explicitly declare a maintainer / author field; the confirmed repository link points to MrElysium/dsh-md-quiz on GitHub.

Core Capabilities¶

Five-Stage Reading¶

The plugin breaks the reading flow into 5 stages:

diagnose → level → guided reading → checkpoint → settle

In Chinese context, these correspond to: diagnosis, level, guided reading, checkpoint, settle.

Server-Side Registration¶

The plugin registers the following capabilities with DSH:

• md-quiz-read skill
• /mdquiz command
• GET /mdquiz/read?path=… file-reading route

The file-reading route only allows the following extensions, with a file size limit of 512KB:

.md
.markdown
.txt
.rst

Web Interface¶

The plugin provides two main entry points on the web side:

• The “Quiz-based Reading” level-up panel at the bottom of the sidebar, including a stage flow bar, start leveling, test me only, quiz me, settle check-in, and level-up rules.
• The “Reading Area” tab in the conversation area, alongside “Chat” and “Trajectory,” used to display the original Markdown content and automatically recognize level-up messages in the conversation.

Installation and Activation¶

Prerequisites¶

The documentation states that dsh plugin is installed via pnpm, so you need to have the following installed on your machine:

pnpm

Installation¶

The installation commands provided in the README and package.json use a placeholder account:

dsh plugin --profile web add github:<your-account>/dsh-md-quiz
# Restart dsh web and refresh the browser

When installing, you should replace <your-account> with the actual account you use as the installation source. The repository page in the documentation points to MrElysium/dsh-md-quiz, but the repository field in package.json uses <your-account>, and it is not confirmed which real account should replace it in the installation command.

Before installation, it is recommended to review the repository source code, dependencies, and the MIT license.

Verification¶

After restarting dsh web, visit:

http://127.0.0.1:3080/plugins/dsh-md-quiz/client.js

It should return a 200 status.

In the page source, check window.__DSH_BOOT__—it should contain:

dsh-md-quiz

On the interface, you should see:

• The “Quiz-based Reading” panel at the bottom of the sidebar.
• The “Reading Area” tab above the conversation area.
• The /mdquiz command hint visible in the input box.

Typical Usage¶

Start Leveling Up¶

In the “Quiz-based Reading” panel in the sidebar, fill in the document path, then select “Start Leveling Up.”

The plugin will send the following to the current conversation:

Quiz-based reading <path>

It then proceeds through the 5 stages of guided reading. Relative paths are resolved based on the current conversation’s working directory.

Test Me Only¶

After selecting “Test Me Only,” the plugin sends:

Test me only <path>

The effect is that it only generates 3 diagnostic questions, without teaching.

Quiz Me¶

After selecting “Quiz Me,” the plugin sends:

Quiz me <path>

The effect is that it randomly generates questions from the sections already studied.

Settle Check-In¶

After selecting “Settle Check-In,” the plugin sends:

Settle

The effect is that it outputs a settlement box and writes a check-in log.

Reading Area¶

Open the “Reading Area” tab in the conversation area to view the original text of the current document.

The reading area can automatically recognize level-up messages in the conversation, or you can manually enter a path to load a document.

Command Interface¶

You can also use the command interface in the input box:

/mdquiz <path>

This is the command-line entry point and can also initiate the flow.

Applicable Scenarios and Notes¶

This is suitable for scenarios like:

• You want to turn Markdown documents from one-time Q&A into a “diagnose, guide, quiz, settle” flow.
• You want to keep an original document text area in DSH Web rather than just viewing chat messages.
• You need to record reading progress next to the document directory for later review.

Notes:

• The plugin registers DSH skills, commands, and file-reading routes, and runs with the current dsh process permissions. Review the source code, dependencies, and license before installation.
• The file-reading route only supports .md, .markdown, .txt, and .rst, with a file size limit of 512KB.
• Progress is recorded by default at:

<document directory>/.md-quiz-read-progress.md

The documentation states that it records XP, combo, and level, following the same rules as 每日学习协议.md (Daily Learning Protocol).

• This plugin fixes the directory selector to browse, i.e., the in-app browser. To keep the native system directory dialog, you need to delete the 4 lines of the directory selector in cordis.patch.yml.
• Server-side changes require a restart; client-side changes only need a refresh.
• The documentation indicates that the plugin was developed and verified on rc.7.

Links¶

• GitHub: https://github.com/MrElysium/dsh-md-quiz
• Community directory clue (unconfirmed): https://www.skillhub.cn/plugins/MrElysium/dsh-md-quiz