fff122/dsh-research-notes
A small local note-taking plugin for DeepSeek Harness. It gives an Agent four tools for saving, listing, searching, and exporting research notes.
catalog 简介 / catalog descriptioncatalog description：A lightweight research notes plugin for DeepSeek Harness
安装Install
dsh plugin --profile web add github:fff122/dsh-research-notes把 fff122/dsh-research-notes 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-research-notes
A small local note-taking plugin for DeepSeek Harness. It gives an Agent four tools for saving, listing, searching, and exporting research notes.
The plugin stores human-readable Markdown files under .dsh/research-notes/ in the current workspace. It does not need a database, external API, browser permission, or network service.
Quick install
Requirements
You need:
- Node.js 22 or newer
pnpm- DeepSeek Harness with support for JavaScript or TypeScript plugins
Step 1: Download and build
Copy and run these commands:
git clone https://github.com/fff122/dsh-research-notes.git
cd dsh-research-notes
pnpm install
pnpm build
Step 2: Create the Harness plugin configuration
Run this command in the plugin directory:
cat > research-notes.patch.yml <<EOF
- insert:
- id: dsh-research-notes
name: '$PWD/dist/src/index.js'
EOF
The generated path is absolute, which is required by the Harness patch loader.
Step 3: Start Harness with the plugin
If Harness is available as a command, run:
dsh web --patch "$PWD/research-notes.patch.yml"
If it is not installed as a command, run:
npx @deepseek-ai/dsh web --patch "$PWD/research-notes.patch.yml"
Open the Harness Web UI shown by the command. The Agent can now use the four research-note tools.
Other DeepSeek Harness plugins
The following plugins are maintained in separate public repositories:
| Plugin | Repository |
|---|---|
dsh-task-checklist |
fff122/dsh-task-checklist |
dsh-prompt-presets |
fff122/dsh-prompt-presets |
dsh-agent-arcade |
fff122/dsh-agent-arcade |
Verify the installation
Ask the Agent to save a note, for example:
保存一条研究笔记：标题是 DeepSeek Harness，正文是这是一次安装测试，标签是 test。
The note should appear under:
.dsh/research-notes/notes/
You can also ask the Agent to list, search, or export the note. If the tools do not appear, check that the patch file points to dist/src/index.js and that pnpm build completed successfully.
Available tools
| Tool | Purpose |
|---|---|
research_note_save |
Save a note with an optional source URL and tags. |
research_note_list |
List notes, optionally filtered by tag. |
research_note_search |
Search note titles, bodies, sources, and tags. |
research_note_export |
Export selected notes or all notes to a Markdown research pack. |
One-copy installation
After cloning the repository, the following block installs, builds, configures, and starts the plugin:
set -e
git clone https://github.com/fff122/dsh-research-notes.git
cd dsh-research-notes
pnpm install
pnpm build
cat > research-notes.patch.yml <<EOF
- insert:
- id: dsh-research-notes
name: '$PWD/dist/src/index.js'
EOF
npx @deepseek-ai/dsh web --patch "$PWD/research-notes.patch.yml"
Where notes are stored
.dsh/research-notes/
notes/<note-id>.md
index.json
exports/research-notes-<timestamp>.md
The Markdown files are the source of truth. They can be opened, edited, copied, or backed up by hand. The plugin only writes below the current workspace's .dsh/research-notes/ directory.
Updating the plugin
From the cloned directory, run:
git pull
pnpm install
pnpm build
Then restart Harness with the same patch command.
Troubleshooting
pnpm: command not found means that pnpm is not installed. Install pnpm using the official pnpm installation guide, then repeat the commands.
The tools do not appear usually means that Harness was started without the patch file, or that the patch file still points to the wrong path. Run pwd inside the cloned directory and confirm that the patch points to the resulting absolute path followed by /dist/src/index.js.
The build fails means that the local Node.js or pnpm version may not meet the requirements, or that dependencies were not installed. Run node --version, then run pnpm install again.
Development
The repository uses strict TypeScript and Vitest. Before committing changes, run the complete quality gate:
pnpm format:check
pnpm typecheck
pnpm test
pnpm build
The source is intentionally split into small modules so that another developer can understand and modify it:
src/
index.ts # Harness entry point and tool registration
schema.ts # Input validation and shared data types
note-format.ts # Human-readable Markdown serialization
note-store.ts # Filesystem persistence and search
path-policy.ts # Workspace boundary and path safety
test/
schema.test.ts
note-format.test.ts
note-store.test.ts
No release or GitHub publication should happen until formatting, type checking, tests, and the production build all pass. The repository is public and tagged with the dsh-plugin GitHub topic.
For the plugin model and patch overlay format, see the official DeepSeek Harness plugin guide.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…