前言¶
在 DSH 的插件式工作流里，临时想法经常卡在“记下来”和“真正处理”之间。dsh-localnote 针对这个环节做了固定：先在浏览器浮窗里随手记录，再设置到期时间；到点后，插件可以只提醒，也可以由一次性 agent 把灵感展开成结果并回写。下面介绍它的定位、安装和可用命令。
这是什么¶
dsh-localnote 是一个 DSH host 端插件，维护者为 253071608，许可证为 MIT。它安装在 web 配置档中，提供浏览器浮窗记录、本地持久化、REST 接口、定时扫描和一次性 agent 执行。适合需要把“以后再说”变成可追踪任务的人。
核心功能¶
- 随手记录：右上角浮窗新建一条灵感，一条包含标题、详情和截图图片；详情支持粘贴。
- 定时回访：给任意灵感设置到期时间和到点动作，到点由插件自动接管。
- 到点执行：AI 可把灵感展开为理解、要点拆解、下一步可执行动作，并回写结果。
- 仅提醒：到点只弹通知，不消耗模型。
- 双通道提醒：页面浮窗 toast 与后台系统通知；localStorage 去重，避免刷新后重复提醒。
- 状态可见：列表实时显示倒计时、已执行、出错状态；详情页查看任务执行报告。
- host 端能力：提供 REST 路由、定时扫描、一次性 agent 执行和本地持久化。
安装与启用¶
先克隆代码，再进入 DSH checkout 根目录安装。dsh 不是全局命令，必须在 DSH checkout 根目录运行 pnpm dsh。
# 1. 克隆代码（把 <仓库地址> 换成实际仓库地址）
git clone <仓库地址> /path/to/dsh-localnote
# 2. 本地安装（dsh 会把本地目录作为依赖装进 ~/.dsh/profiles/web/ 并加进 bundles）
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-localnote
安装后，插件会装入 web 配置档。如果改动了 host 端 index.js，需要重启 DSH。
典型用法¶
经过上面的步骤并启动 DSH 后，可以先查询灵感列表：
curl http://127.0.0.1:3080/dsh-localnote/notes
新建一条灵感：
curl -X POST http://127.0.0.1:3080/dsh-localnote/notes \
-H 'content-type: application/json' \
-d '{"text":"你好"}'
查看统计：
curl http://127.0.0.1:3080/dsh-localnote/stats
设置或取消定时时，调用以下路由：
PATCH /dsh-localnote/notes/schedule
参数包括时间、动作和模型。执行到点任务时，任务执行需要 {{cwd}} 有效；插件已内置当前用户家目录。
卸载插件：
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web remove /path/to/dsh-localnote
卸载只影响插件装载，不会删除数据。灵感保存在 ~/.localnote/state.json，图片保存在 ~/.localnote/images/。如需彻底清除数据：
rm -rf ~/.localnote
适用场景与注意¶
适合这类场景：
- 在浏览器中产生临时想法，希望先记录再处理；
- 到点只提醒，不消耗模型；
- 到点由 AI 生成结构化结果，并回写到灵感条目；
- 需要本地文件保存，并通过简单 REST 接口查看或调试。
使用前注意：
- 插件以当前 dsh 进程权限运行，会写入
~/.dsh/profiles/web/与~/.localnote；安装前应检查源码与 MIT 许可证。 - 定时扫描每 30 秒检查到期灵感，触发一次后标记
fired，以避免重复。 - 到点执行会走一次性 agent；仅提醒模式不消耗模型。
- 目录页和 GitHub 链接属于插件线索，仓库地址在不同资料中可能有差异，使用前请核对实际仓库。
结尾¶
dsh-localnote 提供了一个本地、可追踪的延后处理入口：记录、定时、提醒或执行，最后回写结果。适合放进 DSH 日常流程里，处理那些“现在不展开，但后面必须想清楚”的灵感。
相关链接（均来自插件线索）：
