dsh-plugin-md-outline

🇨🇳 中文  |  🇺🇸 English

一个最小但实用的 DeepSeek Harness 插件，给 harness 增加 md_outline 工具。 它用来梳理和检查 Markdown 文档结构：输出嵌套标题树，并给出手工很难查、长文档里极易出错的结构警告 （书稿、skill 集、规格文档都适用）。

话题标签：dsh-plugin —— 给 GitHub 仓库加上这个 topic，生态就能发现它 （见下方发布 dsh-plugin 话题一节）。

它能做什么

检查项	为什么有用
标题树（H1–H6，带行号）	一眼看清长文档结构、方便导航与审计。
标题层级跳级（如 H1 → H3）	抓出文档层级断裂。
重复标题文本	标记会破坏锚点/目录的意外重复。
缺少 H1 / 多个 H1	强制要求单一文档标题。
未闭合的代码围栏	长文档最经典的坑——一段围栏没闭合会让后面整篇都变成"代码"。代码块内的标题会被正确忽略。

效果预览

终端运行 node examples/run.mjs 的真实输出（覆盖全部 5 个示例文档： clean、跳级、重复标题、多 H1、未闭合围栏）：

错误长什么样 — examples/level-skip.md

左边是你写出来的原始文档，右边是 md_outline 的检测报告。 第 3 行 H1 → H3 的跳级被精确定位，并给出原因。

重新生成：python3 docs/gen_screenshot.py（会写出 docs/screenshot.png）。

安装

一键安装（任何机器、任何 profile 都可用）：

dsh plugin add https://github.com/d-ouyang/dsh-plugin-md-outline.git
dsh --profile demo --dump-config | grep -i md-outline   # 确认插件层已加入

需要 dsh CLI（DeepSeek Harness）。本插件是纯 ESM JavaScript，无需构建步骤、也不会触发 allowBuilds 提示，可直接从 git 仓库安装。

也支持本地目录安装：

dsh plugin --profile demo add /path/to/dsh-plugin-md-outline

卸载：

dsh plugin remove dsh-plugin-md-outline

使用

在 Web UI（或任何支持工具的表面）里直接让模型：