dsh-md-notes: A Local Markdown Note-taking Plugin for DeepSeek Harness
xiezongchen/dsh-md-notes
A DSH plugin to save conversations as local Markdown notes with editing and management.
Easily save and edit conversation content in the DeepSeek Harness web interface, stored as plain-text Markdown files without a database or cloud.
dsh plugin --profile web add github:xiezongchen/dsh-md-notes- Category
- Sessions & Messages
- Platform
- DSH-Plugin
- Author
- xiezongchen
- Distribution
- Plugin
dsh-md-notes Key Features
dsh-md-notes Repository
dsh-md-notes Repo Summary
dsh-md-notes is a note-taking plugin (DSH plugin) for DeepSeek Harness, developed by XieZongChen under the MIT license. It solves the problem that DSH web users cannot easily save conversation content: it adds an "MD Notes" entry to the sidebar and an "Add to note" action next to every assistant reply, letting you capture conversations into local plain-text .md files that remain editable anywhere. Core capabilities include: a sidebar notes manager (list + edit/preview), an assistant-message action (append conversation to a note), plain-file storage (no database, no cloud), and UI language that follows DSH's setting (Chinese/English).
What core features does the dsh-md-notes DSH plugin support?
- Sidebar notes entry: click the notes icon at the bottom (above Settings) to create, edit, and preview notes.
- Assistant-message action: next to the copy button on any assistant reply, click the notes icon, pick a target note (or create one on the spot), and the user question + answer are appended as a timestamped section.
- Plain
.mdfile storage: notes are saved by default in<cwd>/.dsh-notes/, directly editable in any editor. - Language adaptation: UI copy follows DSH's language setting (Chinese/English).
How do I install dsh-md-notes?
Prerequisites: dsh CLI installed, target profile is web. Install command:
dsh plugin --profile web add github:xiezongchen/dsh-md-notes
After installation, restart dsh web (bundle layer and client package metadata are cached in the process). Upgrade and uninstall commands are dsh plugin --profile web update dsh-md-notes and dsh plugin --profile web remove dsh-md-notes, also requiring a restart.
How do I configure dsh-md-notes?
All options are plugin Config keys, overridable in the profile's cordis.patch.yml (a patch replaces the whole config of the row):
- id: md-notes
config:
root: '/abs/path/to/notes' # notes directory; default <cwd>/.dsh-notes
route: '/plugins/md-notes' # HTTP API prefix; default is fine
root specifies the notes storage directory (.md files + meta.json), route is the HTTP API prefix served by the plugin, which also hosts the icon at <route>/icon.svg. There are no environment variables and no secrets in this plugin's configuration.
Which DeepSeek Harness versions and platforms are compatible with dsh-md-notes?
Plugin version 0.2.0, requires the dsh CLI (with the plugin subcommand) and the web profile. Last verified on 2026-08-16 against the deepseek-harness mainline checkout (dsh CLI 0.1.0-rc.x era). The plugin is not pinned to a specific mainline commit; pin the plugin version at install time if you need a fixed combination. Runtime dependencies (@deepseek-ai/*, react) are declared as optional peer dependencies and resolve from the dsh installation.
What are the permissions and data storage of dsh-md-notes?
- Filesystem: reads and writes notes as plain
.mdfiles (plus ameta.jsontitle/updated-time sidecar) under the configuredrootdirectory. Nothing else is touched. - Network: a loopback HTTP API (browser ↔ local dsh server) and the icon endpoint; no external network requests.