memo-notebook
按工作区记录未完成任务：自动捕获排队/执行中的用户指令，持久化到磁盘，一键恢复重发。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:SeanWang114514/dsh-memo-notebook#c0789e9cf4804766f6ab2b8cbca798d05b54fc6cMemo Notebook 以 memo-notebook 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
按工作区记录未完成任务：自动捕获排队/执行中的用户指令，持久化到磁盘，支持插队打断与一键按原状态恢复重发。为 DeepSeek Harness (dsh) 打造的备忘录/待办插件。
为什么需要它？在长会话里，任务排队、被打断、恢复是家常便饭。memo-notebook 把「我让助手做什么、做到哪了、被打断前是什么状态」变成一个可见、可点、可恢复的面板——再也不怕切换会话或重启 web 后丢失上下文。
| 功能 | 说明 |
|---|---|
| 🪝 自动捕获 | 发给助手的新指令自动进入备忘录，排队 → 进行中 状态自动流转 |
| ⚡ 插队打断 | 新消息插入时，旧任务自动标记为「打断」，并记录原状态（previousStatus） |
| 🔄 一键恢复 | 恢复按钮按原状态恢复：原排队 → 回排队；原进行中/提问 → 恢复 running 并继续执行 |
| ✅ 划线完成 | 「一键完成」将任务划线下沉（不删除，保留记录）；「一键删除」才真正移除 |
| 🗂 状态分类 | 全部 / 排队 / 正在进行 / 提问 / 失败 / 打断 / 已完成（失败与错误合并） |
| 🧹 自动完成 | agent 正常结束时任务自动标记「已完成」划线，手动完成与自动完成区分 |
| 📌 窗口置顶 | 浮动面板固定在侧栏之上、设置窗口之下；标题栏可拖动，位置持久化保存 |
| 💾 同步持久化 | 每次变更立即写盘（同步写入），停止/重启 web 不丢数据 |
| 🌏 UTF-8 存储 | 避免 Windows 控制台编码导致的乱码问题 |
dsh plugin --profile web add SeanWang114514/dsh-memo-notebook
# 将插件目录链接到 web profile 的 node_modules
mklink /J "%USERPROFILE%\.dsh\profiles\web\node_modules\memo-notebook" "%USERPROFILE%\.dsh\memo-notebook"
安装后需重启 dsh web 使 Host 端生效；Client 端刷新页面（Ctrl+F5）即可。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/memo/list | 列出全部条目 |
| GET | /api/memo/events | SSE 实时推送状态变化 |
| POST | /api/memo/add | 新增条目 {text} |
| POST | /api/memo/complete | 标记完成（划线保留）{id} |
| POST | /api/memo/remove | 删除条目 {id} |
| POST | /api/memo/resume | 恢复条目到原状态并继续执行 {id} |
| POST | /api/memo/batch-complete | 批量完成 {ids} |
| POST | /api/memo/batch-remove | 批量删除 {ids} |
| POST | /api/memo/batch-resume | 批量恢复 {ids} |
# 新增
curl -X POST http://127.0.0.1:3080/api/memo/add \
-H "Content-Type: application/json" \
-d '{"text": "帮我写周报"}'
# 恢复
curl -X POST http://127.0.0.1:3080/api/memo/resume \
-H "Content-Type: application/json" \
-d '{"id": "mtbmk094-nhgxutw7"}'
cordis.patch.yml 中通过 stateFile 指定持久化文件：
- insert:
- id: memo-notebook
name: memo-notebook
config:
stateFile: !!js dshHomePath('memo-notebook/state.json')
默认存储于 ~/.dsh/memo-notebook/state.json（UTF-8，每次操作同步写入）。
用户发消息 ──► queued（排队）
│ agent 开始执行
▼
running（进行中）
│ 新消息插队 / agent 空闲
▼
interrupted（打断，记录 previousStatus）
│ 点「恢复」
▼
回到 previousStatus（queued 或 running）
│ agent 正常完成
▼
completed（已完成，划线保留）
| 状态 | 徽章颜色 | 说明 |
|---|---|---|
| queued | 蓝色 | 排队等待执行 |
| running | 绿色 | 正在执行 |
| asking | 橙色 | 向用户提问中 |
| failed | 红色 | 执行失败（含错误） |
| interrupted | 紫色 | 被新消息打断（记录原状态） |
| completed | 灰色 | 已完成（划线） |
memo-notebook/
├── lib/
│ ├── index.mjs # Host: API + 事件捕获 + 状态流转 + 持久化
│ └── client.js # Client: 侧栏按钮 + 浮动面板 UI
├── cordis.patch.yml # dsh 插件挂载配置
├── package.json # 插件元数据（dsh.bundle manifest）
├── screenshots.json # 市场截图声明
├── shot-panel.png # 面板截图
└── README.md
agent/inbox/inserted（新指令入队）、agent/status（状态流转）、tools/result（工具执行结果）事件，驱动状态机writeFileSync，每次变更立即落盘，杜绝进程被杀时数据丢失/api/memo/events 实时推送状态变化，多标签页同步MIT License — 自由使用、修改、分发。