前言¶
DeepSeek Harness (DSH) 采用了插件化架构。在开发智能体或进行长对话时，开发者通常需要将当前会话的关键信息或上下文沉淀下来，以便在后续会话中快速引用。dsh-notebook 插件将这一功能直接集成到了 DSH 的官方右侧边栏中，提供了一套轻量级的笔记记录与引用机制。
这是什么¶
dsh-notebook 是一个运行在 Web 环境下的 DSH 插件。它不依赖第三方 UI 包，直接挂载在 DSH 的官方右侧边栏。插件的核心功能是允许用户创建包含标题、正文和图片的笔记条目，并通过点击标题复制正文、输入 @ 符号引用笔记等方式，将这些信息注入到当前的对话流中。
核心功能¶
创建与存储¶
- 基础结构：每条笔记包含单行标题、正文区域和图片缩略条。图片以磁盘文件形式存储，路径位于
$DSH_HOME/storages/notebook-attachments/<noteId>/。 - 写入机制：支持原子写入。如果
$DSH_HOME不可写，系统会自动降级到内存模式运行，此时所有响应都会携带degraded: true标记。 - 内容限制：仅支持图片，拒绝视频格式。图片上传有大小限制（单个约 10MB）和数量限制（单条笔记最多 20 张）。
交互方式¶
- 复制正文：点击笔记的标题，会将正文复制到剪贴板。复制的内容中，图片会转换为
[image: name]格式的文本行，并附带字数提示。 - 引用笔记：在编辑器中输入
@，会弹出笔记列表供选择。选中后，仅笔记的正文内容会被发送给模型。 - 快捷保存：
- 选中文本：在 Composer 中选择文本，会出现悬浮的 “To notebook” 按钮，点击即可将选中内容保存为笔记（标题自动命名为“未命名1”、“未命名2”等）。
- 整条回答：在回答末尾的操作栏中，点击保存图标，可将当前会话的整个回答保存为笔记，标题使用当前会话的标题。
安装与启用¶
插件依赖 DSH 版本 >=0.2.0-rc.2。安装前请确保使用 pnpm 作为包管理器。
dsh plugin --profile web add github:wyzh0117/dsh-notebook
安装后，在右侧边栏的 + 列表中找到该插件并启用。默认情况下，新建会话时侧边栏不会自动打开，需手动开启“Open the notebook for new sessions”选项。
典型用法¶
- 添加笔记：点击侧边栏右上角的
+按钮，输入标题和正文，粘贴图片后按Cmd/Ctrl + Enter或点击 Done 保存。 - 复制内容：在笔记列表中点击某条笔记的标题，将正文内容复制到剪贴板，随后在 Composer 中粘贴使用。
- 引用上下文：在 Composer 输入
@，从弹出的列表中选择一条笔记。模型将仅读取该笔记的正文内容。 - 快速归档：在 Composer 中选中一段代码或文本，点击浮动的保存按钮，将其转化为一条结构化的笔记。
适用场景与限制¶
- 适用场景：需要频繁记录技术细节、代码片段或会话摘要的开发者；需要在多个会话间共享特定上下文的用户。
- 已知限制：
- 无富文本编辑器：仅支持纯文本和图片，不支持 Markdown 或富文本格式。
- 无云同步：数据存储在本地磁盘，不提供云端同步。
- 无版本历史：删除笔记后无法恢复。
- 全局笔记：笔记列表是全局共享的，不属于特定会话。
结语¶
dsh-notebook 在 DSH 官方侧边栏中提供了一个轻量级的笔记记录与引用入口。它通过本地磁盘存储和原子写入机制，为开发者提供了一个无需云同步、数据完全离线的记忆辅助方案。
