XieZongChen/dsh-md-notes 预览 preview

XieZongChen/dsh-md-notes

DeepSeek Harness(DSH)的笔记插件。它提供完整的MD笔记管理器和MD笔记编辑器,让您能快速将对话内容捕捉到笔记中。通过同步到Git仓库,可以维护和管理笔记。

Project Overview项目介绍

This is a native third-party markdown notes plugin built exclusively for DeepSeek Harness (DSH). It adds a full-featured notes manager and editor directly into the DSH interface, letting users capture conversation content into notes with a single click. It also supports syncing all notes to a personal Git repository for backup, version control, and cross-device access. Once installed, it adds a dedicated notes entry to the DSH sidebar, supports cross-workspace note search, and lets users reference existing notes directly in chat conversations by typing @. It automatically injects referenced note content into the model context when you send a chat message.

This plugin is built for DSH web users who prefer local, file-based notes instead of cloud or database solutions. A common workflow starts with capturing a conversation to a new note with one click, then editing the markdown file in any external editor, and finally syncing changes back to the Git remote. It includes a write mutex that locks writes to the same note across multiple sessions, preventing edit conflicts and keeping all instances in sync. It also supports right-sidebar preview of opened notes, full-text search across all workspaces, and localized UI for both English and Chinese.

This plugin is released under the open-source MIT license, and it does not include any telemetry or external data collection. The only optional outbound network call is a check for npm package updates, which can be fully disabled in the plugin settings. Because DSH evolves quickly, this plugin does not guarantee backward compatibility, and it only targets stable DSH releases. If you do not see changes after installing or upgrading the plugin, you will need to restart the DSH web process to clear cached layer and client metadata.

这是一个专为 DeepSeek Harness (DSH) 开发的原生第三方笔记管理插件,提供完整的 Markdown 笔记管理器和编辑器,支持用户快速将 DSH 对话内容捕获保存到笔记中,还可通过同步到 Git 仓库来管理和备份笔记。插件安装后会在 DSH 侧边栏添加笔记入口,支持一键创建笔记,也可在对话中 @ 引用已有笔记。

面向需要本地文件式笔记的 DSH 用户,不需要数据库或云端服务,典型工作流包括一键捕获对话内容生成笔记,在任意编辑器中编辑 Markdown 文件,通过 Git 同步备份。支持全工作空间搜索笔记,右侧边栏预览笔记内容,还支持写入锁避免多会话同时修改同一笔记的冲突。

插件遵循 MIT 许可开源,无遥测和额外外部调用,仅可选检查 npm 版本更新。因 DSH 迭代较快,插件不保证向下兼容,仅适配 DSH 的稳定版发布。安装后若更新不生效,需要重启 DSH 服务清除缓存,笔记文件存储在工作区的 .dsh-notes 目录下。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 16 stars - an early-stage project星标 16,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-md-notes

把 XieZongChen/dsh-md-notes 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-md-notes

dsh-md-notes

中文

DSH third-party plugin (bundle): MD Notes Manager
User Guide · Features · Architecture · Context · AI Conflict · Roadmap · Changelog


Overview

A note-taking plugin for DeepSeek Harness (DSH). It provides a full MD notes manager and MD notes editor, letting you quickly capture conversation content into notes. Notes can be maintained by syncing to a Git repository.

Who it's for: DSH web users who want local, file-based notes (no database, no cloud) — capture a conversation into a note with one click, keep editing the .md anywhere, and back up / sync with a Git repository.

Current features:

  • Sidebar notes entry → full-screen notes manager: per-workspace note list (grouped, collapsible), markdown edit/preview, save, delete (in-page confirm), create with one click.
  • Note search: a search box in the manager's top bar scans every workspace — titles and bodies (space-separated keywords, AND, case-insensitive); results are grouped by workspace with highlighted matched lines, and clicking a hit opens the note in the editor on that line with the keyword selected; each note row also has a "view in sidebar" action (dsh ≥ 0.1.5-rc).
  • Right-sidebar note viewer (dsh ≥ 0.1.5-rc): conversation file links, the file tree, search, and @ chip clicks all open notes rendered as markdown in dsh's right dockable sidebar; interlinks jump to new tabs; local images in the body render inline (editing stays in the manager).
  • Assistant-message action (next to copy) → pick or create a note and append that conversation (user question + answer) to it instantly — the text is captured from the conversation itself, so there's no waiting; section labels are localized (reasoning is not captured — only the final answer).
  • Reference notes in chat (@): type @ to pick notes (cross-workspace included, plugin-logo-led candidate rows); clicking an inserted chip previews the note in the right sidebar; on send the plugin's backend injects each note's content into the model context, so the model can cite it without being asked to read files. Reference lines carry relative paths only, never local absolute paths.
  • Git sync (optional, URL-driven): shared repo mode (one repo for all workspaces, per-workspace folders) or own repos mode (per workspace: URL + branch + subpath). Push = mirror-sync (deletions included), Update = pull with three-way conflict confirmation, auto-pull on open, merge-remote-and-retry. Each workspace shows a Git sync card in the manager: "Synced" / "N unpushed" status, plus a hint when the remote has new commits.
  • Note write mutex: writes to the same note are locked across sessions — the sidebar entry, picker and manager stay in sync until the write finishes.
  • Settings panel (dsh Settings → MD Notes): mode, repo URL/branch/subpath, auto-pull, commit author — with dsh-styled form controls.
  • Theme & i18n: token-based colors (light/dark), UI copy follows dsh's language (Chinese / English), error messages localized.
  • Update notifications: a yellow "Update available" tag appears when a newer npm version exists.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev DSH-Mobile 下一个 Next agent-guard →