备忘待办 nin2c/dsh-plugin-memo

dsh-plugin-memo（备忘）

一个轻量的笔记与待办面板插件，用于 DeepSeek Harness (DSH) Web UI。所有数据都保存在你本机——不用账号、不同步、不联网。

DSH Web UI 的「备忘」插件：侧栏一个入口，面板顶部一个 sheet 页签切换 待办 / 备忘。数据全部保存在本机，可直接阅读和备份。

功能

- 待办分栏：左「工作」、右「个人」，各自输入后回车添加。
- 已完成单独成区：每栏下半部分是「已完成」，新完成的排最上面、显示完成时间，灰色文字不划线，一眼能看清。
- 拖拽排序：按住待办行拖动即可在栏内调整顺序（上半区/下半区各自排序），顺序持久化；拖动时有插入指示线。
- 行内编辑：直接点待办文字就地修改，回车或点别处保存，Esc 取消；没有多余的编辑按钮。
- 多窗口备忘：左侧 2×2 四个窗口 + 右侧一个完整大窗口，可同时记多处内容。
- 自动保存：备忘边写边存（600ms 防抖），失焦 / 切页签 / 关页面立即落盘；标题旁显示「保存中… / 已自动保存 · 时间」。
- 跟随 DSH 主题：只用 --dsw-alias-* 主题 token，浅色/深色自动适配；中英文文案走 ctx.locale。
- 本地优先：单文件 JSON 存储，串行写入 + 原子替换，文件损坏自动备份。

安装

插件是纯 JavaScript 包，无构建步骤、无第三方运行时依赖。

方式一：从 GitHub 安装（推荐）

在 DSH 里让助手执行 plugin_manager 的 install_bundle，目标填：

github:nin2c/dsh-plugin-memo

或在终端（选择合适的 profile，desktop / web）：

dsh plugin --profile desktop add github:nin2c/dsh-plugin-memo

然后重启 DSH（或让插件经理热加载）。安装后在左侧栏会出现「备忘」图标。

方式二：从本地目录安装

git clone https://github.com/nin2c/dsh-plugin-memo.git

再用 plugin_manager 的 install_bundle 指向该目录（本地目录会以 link: 方式安装）。

方式三：手动放进 profile

把本包加入 profile 的依赖与 dsh.profile.bundles，由 DSH 的 bundle 层加载。

使用

- 打开：左侧栏（Plugins / Schedules 同一条）点 📝 图标。
- 待办：输入 → 回车添加；勾选完成；点文字改内容；拖拽换位置；每栏可单独「清空已完成」。
- 备忘：直接在五个窗口里写，自动保存。
- 数据：$DSH_HOME/plugin-data/notes-todo/data.json（默认 ~/.dsh/plugin-data/notes-todo/data.json）。

数据目录名 notes-todo 是历史命名，包名已改为 dsh-plugin-memo，升级不会丢数据。

数据格式

{
"version": 2,
"todos": [
{ "id": "t_…", "text": "…", "done": false, "category": "work", "createdAt": "…", "doneAt": null } ],
"memos": {
"topLeft": "…", "topRight": "…", "bottomLeft": "…", "bottomRight": "…", "main": "…"
},
"updatedAt": "…"
}

category 为 work 或 personal；数组顺序即待办显示顺序。旧版数据（v1 的 notes 列表、无分类待办、三窗口备忘）会在读取时自动迁移。

宿主 API

插件在宿主注册同源 HTTP 路由 /notes-todo（由 webServer 提供）：

| 方法 | 路径 | 说明 |
| GET | /notes-todo/api/ping | 版本、数据文件路径、计数 |
| GET | /notes-todo/api/state | { ok, todos, memos, updatedAt } |
| POST | /notes-todo/api/mutate | 一次原子操作，返回完整新状态 |
| POST | /notes-todo/api/client-log | 面板崩溃上报 |

mutate 的 op：todo.add / todo.update / todo.toggle / todo.move / todo.delete / todo.clearCompleted / memo.set。操作只在插件自己的 Host 与页面之间使用。

兼容性

- 面向 DSH 的 Web UI（Desktop / Web profile），使用官方插槽（sidebar.panellist、main）与 webServer 路由，不依赖 DSH 内部私有包。
- 在 DSH 0.2.1-rc.2（Desktop profile）上开发与验证。
- 客户端只用 require('react') 与主题 token；宿主只使用 Node 内置模块，因此不需要构建。

开发

语法检查
npm run check

- index.js — 宿主半：webServer 前缀路由 + JSON 存储 + 数据迁移。
- client.js — Web 半：插槽注册、React 面板、拖拽与行内编辑、自动保存。
- cordis.patch.yml — 插入 memo 插件行。
- locale/{en,zh}.json、icon.svg — 插件管理页的标题、描述与图标。

源码是手写的可读 JavaScript，没有压缩产物；改完重新加载插件（或重启 DSH）即可生效。

隐私

- 不联网、不收集数据、无遥测。
- 所有内容只写入本机 $DSH_HOME/plugin-data/notes-todo/ 下的 JSON 文件。

License

MIT © 2026 nin2c