灵感笔记 (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 配置档，把 /path/to/dsh-localnote 换成你 clone 出来的目录：
# 1. 克隆代码
git clone <仓库地址> /path/to/dsh-localnote
# 2. 本地安装（dsh 会把本地目录作为依赖装进 ~/.dsh/profiles/web/ 并加进 bundles）
dsh plugin --profile web add /path/to/dsh-localnote
改动 host 端 index.js 需重启 DSH。
卸载
# 从 web 配置档移除（路径换成你 clone 出来的目录）
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。
