前言¶
在 DeepSeek Harness（DSH）的对话过程中，需求往往在中间发生变化。此时需要在几秒钟内捕获上下文，稍后能快速检索，并保持上下文连续性。dsh-memo 专为这种“当下记录，日后查找”的需求设计。
是什么¶
dsh-memo 是一个为 DeepSeek Harness 提供的备忘录/草稿插件。它提供侧边栏入口，支持快速捕获，使用本地 SQLite 存储，能够同步到私有 GitHub 仓库，并支持图片与截图。
安装与启用¶
在安装前，请确保环境满足以下条件：
- DeepSeek Harness 版本为 0.2.0-rc.2 或更高
- 捆绑的 Node.js 版本为 22.5 或更高（
node:sqlite的最低要求）
使用官方命令安装：
dsh plugin --profile <your-profile> add @adamcjm/dsh-memo
安装完成后重启 DeepSeek Harness，侧边栏底部会出现 Memo 图标。
核心功能¶
侧边栏与快速捕获¶
插件在侧边栏底部设置入口，带有未读徽章。点击后打开面板，顶部常驻输入框支持拖动调整大小。
- 保存：输入内容后按
Enter保存。 - 图片支持：支持
⌘V粘贴截图、拖拽图片或通过文件选择器（支持⌘/⇧多选）添加。图片以 SHA-256 哈希命名存储，重复粘贴同一图片仅占用一份空间。 - 编辑：卡片支持内联编辑，可直接修改正文、图片和标签。
标签与排序¶
- 自动标签：在正文中输入
#tag格式的内容，保存后自动创建标签。标签名在空格或标点处结束，无固定白名单。 - 置顶：点击卡片上的置顶按钮，置顶笔记会排在列表最前，显示标记和左侧强调条。
- 拖拽排序：在同一天组内，可拖动卡片调整顺序。排序结果会写入源文件并随 GitHub 同步。
- 日期排序：通过右侧的排序按钮切换“降序（今日在前）”或“升序（最早在前）”。
搜索与同步¶
- 搜索：支持 CJK 字符串搜索，以及
#tag、source:、after:、before:、has:image、is:open等限定符。例如has:image可筛选包含图片的笔记。 - 本地存储：使用
node:sqlite，无外部依赖，无需编译原生模块。 - GitHub 同步：文本层支持自动推送到私有仓库（30 秒防抖），同时每日生成 SQLite 快照。
使用示例¶
捕获需求变更¶
打开侧边栏 Memo 面板，输入以下内容并按 Enter：
Mr. Zhang wants a WeChat QR login entry on the login page; prototype due next Wednesday #requirement-change #login
系统会自动提取 #requirement-change 和 #login 作为标签。
添加截图¶
截取屏幕后，在输入框中按下 ⌘V，图片会自动嵌入笔记。
重新排序¶
在某一天的内容中，按住卡片拖动到新位置，松手即可保存新的顺序。
注意事项¶
- 桌面版 Profile：桌面版 profile 仅限手动配置，CLI 拒绝写入该 profile。如需在桌面版安装，需手动编辑
~/.dsh/profiles/desktop/package.json并安装依赖。 - 依赖：无第三方运行时依赖。
- 许可证：MIT 许可证。
结语¶
dsh-memo 提供了轻量级的侧边栏记录能力，通过本地 SQLite 和 GitHub 同步保证了数据的持久性与可访问性。适合需要在对话中快速记录灵感、需求变更或碎片信息的开发者使用。
