Preface

In DSH’s plugin-based workflow, temporary ideas often get stuck between “jotting down” and “actually processing”. dsh-localnote fixes this gap: first record casually in a browser popup, then set an expiration time; once the due time arrives, the plugin can simply remind, or have a one-time agent expand the idea into a result and write it back. Below introduces its positioning, installation, and available commands.

What is it

dsh-localnote is a DSH host-side plugin, maintained by 253071608, with an MIT license. It is installed in the web configuration file, providing browser popup recording, local persistence, REST interfaces, scheduled scanning, and one-time agent execution. It is suitable for people who need to turn “later” into a trackable task.

Core Features

  • Quick Record: Create a new idea in the top-right floating window; includes title, details, and screenshot; details support pasting.
  • Scheduled Visit: Set expiration time and action for any idea; the plugin takes over automatically when the due time arrives.
  • Point Execution: AI can expand the idea into understanding, key point breakdown, and next executable actions, and write back the results.
  • Remind Only: Only pop up a notification at the due time without consuming model resources.
  • Dual-Channel Reminder: Page toast and background system notification; localStorage deduplication to avoid repeated reminders after refresh.
  • Status Visibility: List displays countdown, executed, and error status in real-time; view task execution report on the details page.
  • Host Capabilities: Provides REST routes, scheduled scanning, one-time agent execution, and local persistence.

Install and Enable

First clone the code, then install it in the DSH checkout root directory. dsh is not a global command; it must be run as pnpm dsh in the DSH checkout root directory.

# 1. Clone code (replace <repository_address> with the actual repository address)
git clone <repository_address> /path/to/dsh-localnote

# 2. Local install (dsh will install the local directory as a dependency into ~/.dsh/profiles/web/ and add it to bundles)
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-localnote

After installation, the plugin is loaded into the web configuration file. If you modify the host index.js, you need to restart DSH.

Typical Usage

After the above steps and starting DSH, you can first query the idea list:

curl http://127.0.0.1:3080/dsh-localnote/notes

Create a new idea:

curl -X POST http://127.0.0.1:3080/dsh-localnote/notes \
  -H 'content-type: application/json' \
  -d '{"text":"你好"}'

View statistics:

curl http://127.0.0.1:3080/dsh-localnote/stats

When setting or canceling the schedule, call the following route:

PATCH /dsh-localnote/notes/schedule

Parameters include time, action, and model. When executing a due task, {{cwd}} must be valid; the plugin has the current user’s home directory built-in.

Uninstall plugin:

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web remove /path/to/dsh-localnote

Uninstallation only affects plugin loading and will not delete data. Ideas are saved in ~/.localnote/state.json, images in ~/.localnote/images/. If you need to clear data completely:

rm -rf ~/.localnote

Scenarios and Notes

Suitable for scenarios:

  • Generating temporary ideas in the browser and wanting to record them first before processing;
  • Reminding only at the due time without consuming model resources;
  • AI generates structured results at the due time and writes them back to the idea entry;
  • Need local file storage and access/view/debug via simple REST interfaces.

Notes before use:

  • The plugin runs with the current dsh process permissions and will write to ~/.dsh/profiles/web/ and ~/.localnote; please check the source code and MIT license before installation.
  • Scheduled scanning checks for due ideas every 30 seconds; after triggering once, it marks them as fired to avoid duplicates.
  • Point execution uses a one-time agent; remind-only mode does not consume the model.
  • Directory page and GitHub links are plugin clues; the repository address may vary across different sources, please verify the actual repository before use.

Conclusion

dsh-localnote provides a local, trackable entry point for delayed processing: record, schedule, remind, or execute, and finally write back the results. It fits into DSH’s daily workflow to handle those ideas that “aren’t expanded now but must be thought through later.”

Related Links (all from plugin clues):