253071608/dsh-localnote

灵感笔记 (dsh-localnote)

把“以后再说”的灵感，准时摆到你面前：随手记下，到点由 AI 自动替你把它想透、做透，回来只看结果。

一个常驻浏览器的灵感 / 待办浮窗插件：随手记灵感，给它设一个“回访时间”，到点由 AI 自动执行并回写结果，或仅提醒你回来处理。不用一直盯着屏幕。

功能

- 随手记录：右上角浮窗随手记灵感，一条 = 标题 + 详情 + 截图图片（详情里直接 Ctrl/Cmd+V 粘贴）。
- 定时回访：给任意灵感设置「到期时间 + 到点动作」，到点由插件自动接管，不用你守着。
- 任务执行：到点由 AI 把灵感自动展开成结构化成果（理解 → 要点拆解 → 下一步可执行动作），结果直接回写给这条灵感，回来查看即可；可指定模型或使用默认模型。
- 仅提醒：到点只弹通知提醒你回来处理，不消耗模型。
- 不遗漏：页面浮窗 toast + 后台系统通知双通道，到点提醒不丢；localStorage 去重，刷新页面不重复提醒。
- 可见状态：列表实时显示倒计时 / 已执行 / 出错过错状态，详情页查看任务执行报告。

架构

一个 DSH host 端插件： host 持有真实状态 + REST 数据接口 + 定时扫描 + agent 执行。

dsh-localnote/
├── package.json        # 声明 dsh.bundle(补丁层)
├── cordis.patch.yml    # 把本插件作为一条 loader 配置项插入
├── index.js            # host 端（Node）：持久化状态 + REST 增删改查 + 定时扫描 + agent 执行
└── README.md           # 本说明

host 端 index.js

一个 Cordis 插件，inject: ['webServer', 'timer', 'agents']：

- REST 路由（ctx.webServer.register）：

| 方法 | 路径 | 作用 |
|------|------|------|
| GET  | /dsh-localnote/notes | 列出所有灵感 |
| POST | /dsh-localnote/notes | 新建（标题 + 可选详情） |
| PATCH| /dsh-localnote/notes | 更新标题/详情 |
| PATCH| /dsh-localnote/notes/toggle | 切换完成态 |
| DELETE | /dsh-localnote/notes | 删除 |
| POST | /dsh-localnote/notes/images | 上传图片 |
| DELETE | /dsh-localnote/notes/images | 删除图片 |
| GET  | /dsh-localnote/images/:file | 读取图片 |
| GET  | /dsh-localnote/stats | 统计 |
| PATCH| /dsh-localnote/notes/schedule | 设置/取消定时（时间 + 动作 + 模型） |
| GET  | /dsh-localnote/models | 可用模型列表 |

- 定时扫描：ctx.interval 每 30s 检查到期灵感，fireDue 触发一次后标记 fired，避免重复。
- 任务执行：到点用 ctx.agents.create 开一个一次性 agent 执行任务（走完整 agent 通道，可正常出文），执行完显式 dispose 释放；未指定模型时回退 agentDefaultModel 的默认模型。结果写回 note.result。

- 持久化：~/.localnote/state.json（灵感元数据 + schedule/result），图片存 ~/.localnote/images/。

安装

本地安装到 web 配置档。dsh 不是全局命令：它定义在 DSH checkout 根目录的 package.json（scripts.dsh）里，所以必须先进入 DSH checkout 根目录再运行 pnpm dsh。把下面 /path/to/deepseek-harness 换成你 DSH checkout 的目录、/path/to/dsh-localnote 换成你 clone 出来的目录：

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

改动 host 端 index.js 需重启 DSH。

卸载

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

卸载只影响插件装载，不会删除你的数据（灵感仍保存在 ~/.localnote/state.json 与 ~/.localnote/images/）。想彻底清数据，删除这两个位置即可（rm -rf ~/.localnote）。

验证

- host 接口：
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          # {"total":1,"done":0,"open":1}

常见问题

- 任务执行结果为空 / “模型未返回内容”：确认定时设置里选了模型或用默认模型；agent 执行需要 {{cwd}} 有效（插件已内置当前用户家目录）。若仍未出文，看详情里的 log 与 error。