前言¶
在 DeepSeek Harness（DSH）里和模型长对话时，常见做法是另开编辑器或文档，把要反复粘贴的提示词、片段说明、待办要点放在旁边。窗口一多，切换成本变高；纯靠聊天记录检索也不适合当「个人素材库」用。社区插件 dsh-side-memo（维护者 r48n34）把备忘面板嵌进 DSH 界面：右侧栏或可切换的浮层，与 Session 同屏，支持标签、图片、收藏、拖入输入框，以及把对话或单条提问存成备忘。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-side-memo 是面向 DeepSeek Harness 的轻量客户端插件：可开关的右侧备忘面板（Side Memo）。在 npm 上包名为 dsh-side-memo，当前版本 1.3.0，许可证 MIT。README 将其归类为 UI & Experience；在 SkillHub 目录中属于客户端类插件。
Host 侧 apply() 为空，不暴露面向智能体的工具，也不读取 Host 数据；备忘与图片保存在本机浏览器（localStorage / IndexedDB），无网络访问、无外部服务。插件以当前 DSH 进程及你安装的插件包为准运行，安装前建议在 GitHub 查看源码与 LICENSE。
核心功能¶
以下能力均来自项目 README 与 package.json 描述，可按需选用。
备忘与组织
- 在聊天旁打开备忘列表，或在尚未创建 Session 前通过浮层抽屉使用同一套 UI。
- 标题下可加标签；支持搜索、按标签筛选或「按标签分组」。
- 星标收藏会置顶；一键复制备忘正文。
内容与图片
- 支持纯文本；可粘贴、拖入或通过按钮插入内联图片。
- 选中图片后出现变换框：拖手柄缩放，方向键微调（默认步进 8 px），
Shift+方向键只改单轴；Shift+拖动手柄可自由变形，Alt+拖动从中心缩放；双击或重置按钮恢复原始显示尺寸（不改变存储的原图，只改展示大小）。
与对话联动
- 编写消息时，将列表中的备忘拖到聊天输入框，文本插入光标处（可撤销的单次编辑）；备忘里的图片仍留在面板，不会随拖入一起进输入框。
- 会话标题栏旁的 chat-to-memo：可选 Save whole conversation（可见的用户提问与助手回复）或 Save only my prompts（仅你的发送内容）。只采集可见文本，推理块、工具输出和图片不写入； transcript 上限 8000 字符，超出时从最早轮次截断。新备忘会在面板中打开供编辑。
- 悬停在你自己的某条消息上，操作行里除 copy 外还有备忘按钮，可只保存该条提问为新备忘。
导入导出与交互
- 工具栏支持以 Excel（.xlsx） 导入、导出备忘；导入会追加新条目不覆盖已有备忘；导出不含图片二进制（图片仍只存本地）。
- 列表行右键，或聚焦后
Shift+F10，可 Open、Copy、Duplicate、收藏、Delete；删除需二次确认（与编辑器内删除行为一致）。
兼容与实现要点
- 面向 DSH 0.2.x（README 写明在 0.2.1-rc.3、Desktop profile 下开发与测试）。
- 支持 Web GUI 与 Desktop（Electron/Chromium）；依赖常见浏览器 API（含读取压缩 xlsx 时的
DecompressionStream('deflate-raw')）。 - 有 Session 时面板走右侧栏插件 API；无 Session 时由插件在
shell.overlay层渲染，切换按钮挂在会话头conversation.header.leading等区域。仓库已提交编译后的client.js/index.js，安装无需本地 build。
安装与启用¶
插件已发布到 npm。按你使用的 DSH profile 安装（Web 示例如下）。
dsh plugin --profile web add dsh-side-memo
若需要 npm 尚未收录的 commit，或 npm 不可达，可从 GitHub 安装：
dsh plugin --profile web add github:r48n34/dsh-side-memo
Desktop 用户请在 Settings → Plugins 中确认 profile 名称（Desktop 应用通常为 desktop），再执行：
dsh plugin --profile desktop add dsh-side-memo
安装后，Side Memo 图标会出现在 Session 标题栏右侧（包括尚无 Session 的首屏与新 Session 欢迎页）；也可从标题栏右侧工具区或右侧栏的添加/引导入口打开。若图标未出现，重启 DSH 一次以加载新插件包。卸载可在 Settings → Plugins 或使用对应 profile 的 dsh plugin 命令。
典型用法¶
- 点击会话头右侧 Side Memo 图标，打开或关闭面板。
- 点 New 写备忘；内容自动保存，也可在编辑器内新建。
- 在标题下加标签，粘贴或插入图片并按需缩放；用星标置顶、复制图标复制全文；需要时用搜索与标签过滤。
- 用工具栏导入/导出
.xlsx在环境间迁移文本备忘（图片需仍在本机 IndexedDB 中，导出文件不含图片）。 - 写消息时把备忘拖到输入框插入文本。
- 值得留档的对话：点 chat-to-memo，选整段对话或仅自己的 prompts；或只对单条消息用悬停行的备忘按钮。
适用场景与注意¶
适合谁： 需要在 DSH 里长期维护提示词库、检查清单、项目备注，并希望在写消息时快速拖入或把对话摘成备忘的开发者与用户；重视本地、离线、无额外云服务的数据路径时，该插件与 README 中的隐私说明一致（不加密、不同步多设备）。
使用前请知悉：
- 插件随 DSH 客户端加载，权限边界以你安装的包与 DSH 版本为准；安装前请自行审阅 GitHub 仓库 与 MIT 许可证。
- 剪贴板写入仅在用户触发复制等操作时发生（README「Permissions & privacy」一节有说明，资料截断处亦强调无 Host 数据访问）。
- 社区目录 SkillHub 插件页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展方式，Side Memo 是其中一条客户端 UI 扩展。
结尾¶
dsh-side-memo 把可搜索、可标签、可导入导出的备忘面板放进 DSH 右侧，并与输入框、会话头打通，减少在外部工具与 Harness 之间来回拷贝。若要查看简介与链接，可打开 SkillHub 目录页 r48n34/dsh-side-memo；完整安装说明、快捷键与兼容细节以 GitHub README 为准。
