前言¶

在 DeepSeek Harness 桌面端开发或使用时，需要一个稳定、私密的笔记环境，用于记录设计思路、整理技术方案或记录日常备忘。现有方案往往依赖云端服务或需要额外配置环境，本地存储的 Markdown 笔记工具又难以与 DSH 深度集成。

DSH Markdown Notes 是一个独立的 Markdown 笔记插件，直接在 DSH 桌面端侧栏打开，所有笔记保存在本地文件系统，与 DSH 工作区共用同一套笔记目录，不依赖模型调用或网络服务。

功能概览¶

插件提供完整的阅读、编辑和文档管理能力，同时支持丰富的 Markdown 语法渲染和拖拽导入等便捷操作。

阅读与编辑¶

• 阅读/编辑/并排模式：默认展示排版后的文章；顶栏一键切换「阅读 / 编辑 / 并排」，Ctrl+E 在阅读和上次的编辑布局之间切换；并排模式下双向同步滚动。
• 文档大纲：阅读和并排时可用，点击跳转，滚动时高亮当前章节。宽屏时常驻在正文右侧；窗口较窄或并排时变成右边缘的刻度条，悬停展开完整大纲，点击刻度直接跳转。

预览主题¶

提供三套预览排版，只改变显示样式，不修改文件：

• 默认：清爽界面风格，提示块带图标，引用、分割线和高亮经过精修。
• 书刊：米色纸张底、衬线正文与标题、居中标题、段首缩进、首字下沉、楷体引用、三线表，图片下方显示说明。
• 公众号：居中标题、主题色色块的二级标题、两端对齐、窗口式代码块，图片下方显示说明，便于预览文章的发布效果。

文档管理¶

• 多级文件夹树：支持创建、重命名、移动、删除笔记和文件夹，拖拽笔记到文件夹上即可移动。
• 标题即时筛选：侧栏筛选框输入标题，按 Enter 打开第一条，Esc 清除。
• 右键与悬停操作：文件夹和笔记支持悬停快捷按钮与右键菜单，操作结果以顶部提示显示。
• 另存为副本：重命名、移动到…、另存为副本、删除等操作均可对当前笔记进行。

自动保存与快捷键¶

• 停止输入约 450 ms 后自动保存。
• 离开编辑区、切换文档或点击「完成」时保存。
• 支持 Ctrl+S / ⌘S 手动保存。
• 文件被其他编辑器修改时，插件会提示冲突并保留草稿，可使用「草稿另存为」。

丰富的 Markdown 支持¶

• 代码高亮、表格、任务列表、脚注、数学公式、Mermaid 流程图、AntV 信息图、注音和提示框。
• KaTeX 渲染数学公式，Mermaid 渲染流程图和饼图等图表。
• > [!TIP] 等警告块，以及 ::: tip、::: theorem 等容器。

拖拽导入与目录迁移¶

• 拖拽导入：将 .md / .markdown 文件拖入页面，复制导入并打开；拖到某个文件夹上时导入到该文件夹；同名文档自动添加 (2) 等后缀。
• 目录迁移：在界面中更换保存目录，自动搬迁笔记，迁移成功后删除空的旧文件夹。

其他能力¶

• 资源管理器：从侧栏「…」菜单直接打开当前笔记目录。
• 按需加载：未打开笔记时仅加载轻量入口，编辑器和图表库在使用时加载。

插件不注册 Agent 工具，不读取聊天记录，不请求模型，没有同步、附件管理或版本历史。

安装与启用¶

1. 从 Releases 下载 dsh-markdown-notes-0.5.4.tgz，无需解压。
2. 打开 DSH 主界面左侧「插件」，点击右上角「添加插件」。
3. 粘贴下载包的完整本地路径，例如：

   D:\Plugins\dsh-markdown-notes-0.5.4.tgz

4. 按提示安装、启用；如果提示需要重启，重启 DSH。
5. 从左侧「笔记」进入。

插件安装包通过 engines.dsh 声明兼容 DSH 0.2 系列（^0.2.0-rc.2）。如果更新的 DSH 拒绝安装，请先核对兼容性。

典型用法¶

创建与管理笔记¶

• 在侧栏顶部「＋」按钮在当前选中的文件夹中新建笔记并进入编辑。
• 单击笔记打开阅读，顶栏「阅读 / 编辑 / 并排」切换模式。
• 点击顶部的笔记名称可以改名，点击前面的文件夹路径可在侧栏中定位。

切换主题¶

• 顶栏「主题」切换预览排版，选择保存在本机。
• 主题只改变预览显示，不修改 Markdown 文件。
• 图片的替代文字在书刊和公众号主题中显示为图片说明。

导入 Markdown¶

• 将 UTF-8 编码的 .md / .markdown 文件拖到笔记页面，或选择侧栏「…」→「导入 Markdown…」。
• 拖到侧栏中的某个文件夹上时导入该文件夹。
• 每批最多 20 篇、合计 20 MB，单篇最大 2 MB。

更换保存位置¶

1. 在侧栏「…」→「保存位置…」中选择文件夹或输入绝对路径。
2. 点击「迁移并使用」：
   - 保存当前草稿，检查新旧目录和同名冲突。
   - 保持子目录结构，复制普通 .md 笔记与初始化标记，并重建空文件夹。
   - 保存新路径，再清理已成功迁移的旧文件。
   - 清理迁移后的空文件夹。
3. 新路径保存在 $DSH_HOME/plugin-data/dsh-markdown-notes/settings.json。

适用场景与注意¶

• 适合需要本地存储、离线访问、与 DSH 工作流深度集成的 Markdown 笔记场景。
• 插件以当前 DSH 进程权限运行，安装前建议检查插件源码与许可证（MIT License）。
• 插件目前面向 DSH 0.2 系列（^0.2.0-rc.2）开发，在 0.2.0-rc.2 上验证过；其他版本尚未验证。
• 超过 12 万字符的文档暂停自动预览，超过 8,000 字符或 180 行的图表需手动绘制，超过 32,000 字符仅展示源码。

总结¶

DSH Markdown Notes 提供了一个轻量、本地化的 Markdown 笔记环境，支持丰富的 Markdown 语法、三套预览主题、拖拽导入和目录迁移等实用功能。所有笔记保存在本地文件系统，不依赖云端服务或模型调用，适合在 DSH 桌面端进行技术文档记录、设计笔记整理或日常备忘。

插件目录页：https://www.skillhub.cn/plugins/Wanyi424/dsh-markdown-notes
GitHub：https://github.com/Wanyi424/dsh-markdown-notes