前言¶
DeepSeek Harness(DSH)适合跑长链路智能体任务:多轮推理、工具调用、长上下文会堆出大量消息。真正值得留住的往往只有几句——结论、可复用的代码片段、某种表述方式。常见做法是把内容复制到笔记或文档里,和当前会话脱节,也容易在滚动中漏掉。
下面介绍社区插件 dsh-clipbook(README 里也叫「小夹子」):在每条已完成的助手回复上提供收藏入口,并在会话顶栏集中浏览、检索与管理这些片段。插件由 Hwayn(幻弈)维护,协作者包括肖宇成;许可证为 MIT,桌面端与 Web UI 均可使用。DSH 生态强调「一切皆插件」;SkillHub 目录页 与 GitHub 仓库 为社区来源,与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-clipbook 是面向 DSH 对话的 clipbook:对任意一条已 finalize 的助手消息,点一次即可把该回复的文本及模型、时间、消息 id 写入本地书架;Web 与桌面共用同一份数据,无需再开第三方剪贴板或笔记应用做中转。
分类上在 SkillHub 归入「记忆」类,侧重在会话内保留「值得留的话」,而不是替代完整会话导出或外部知识库。
核心功能¶
依据仓库 README,当前能力包括:
- 夹一下(Clip) — 每条已完成的助手消息操作栏会出现收藏按钮;单击后该条回复进入 clipbook,按钮状态变为「已夹」。
- 小夹子 (N) — 会话顶栏按钮显示当前收藏数量,打开面板后可浏览列表,并支持搜索、单条复制、删除,以及将全部内容导出为 Markdown。
- 设置页 — 与顶栏面板同一套书架,只是另一种入口。
- 一份书架、多端共享 — 收藏写入单一 JSON 文件,同一
DSH_HOME下 Web UI 与桌面应用看到相同集合。
范围与限制(README 明确说明):
- 只保存助手回复的正文文本;推理过程(reasoning)与工具输出不会被收藏。
- 每个
DSH_HOME对应一个书架;这是设计选择,不是按 profile 各存一份。
安装与启用¶
安装命令以 GitHub README 为准。按使用端选择 profile,添加插件名 dsh-clipbook:
dsh plugin --profile desktop add dsh-clipbook # desktop app
dsh plugin --profile web add dsh-clipbook # web UI
安装后重启 DSH。重启完成后,助手消息操作栏应出现「夹一下」,会话顶栏应出现「小夹子」。
插件在 DSH 进程权限下运行;安装前建议浏览 源码与 LICENSE,确认符合你的安全与合规要求。
典型用法¶
经过上面的安装步骤,可按 README 中的对照表操作:
| 目的 | 操作 |
|---|---|
| 保留某条回复 | 在该条回复下方点击「夹一下」(变为「已夹」) |
| 查看全部收藏 | 点击会话顶栏「小夹子 (N)」 |
| 搜索 | 在面板顶部输入框输入关键词 |
| 复制一条 | 使用「复制」 |
| 删除一条 | 使用「拿掉」 |
| 导出全部 | 使用「导出」(以 Markdown 形式打开整本 clipbook) |
数据默认落在:
$DSH_HOME/clipbook/items.json
DSH_HOME 未设置时默认为 ~/.dsh。文件为纯 JSON;删除该文件可清空书架(插件会按需重建)。
适用场景与注意¶
适合谁: 经常在 DSH 里做 Agent 开发、调试或长对话,需要把少量高价值回复留在会话上下文中、并能在 Web 与桌面间同步查看的开发者。
不适合当作: 全量会话归档、工具调用日志备份,或需要收藏用户消息 / 推理链路的场景——当前版本不覆盖这些内容。
运行环境: 构建与开发依赖 Node.js >= 20(见仓库 package.json);日常使用只需通过 dsh plugin 安装并重启 DSH,无需自行 git clone 或本地 build。
结尾¶
dsh-clipbook 把「从长对话里抠出几句有用的话」做成会话内的一键操作和统一书架,减少复制到外部应用的打断。若要查看简介与分类,可打开 SkillHub 插件页;安装命令、数据路径与交互细节以 GitHub 仓库 README 为准。