前言¶
在 DeepSeek Harness（DSH）里和助手来回对话，经常会出现「这条回复以后还要用」的情况：一段可复用的代码、一条排查思路、或某次对话里的关键结论。常见做法是复制到笔记软件，或靠会话标题和搜索碰运气——前者多一步手工，后者很难精确回到某条消息。
下面介绍 dsh-bookmarks（维护者 penguin-oo）。它是 DSH Web UI 上的书签插件，分类为「记忆」，可在每条已完成的助手回复上打书签、写备注和标签，并在统一面板里跨会话浏览、搜索与导出。
这是什么¶
dsh-bookmarks 为 DSH 提供「按消息收藏助手回复」的能力：在每条 finalized 的助手回复旁增加归档按钮，可附带备注与逗号分隔的标签；所有书签汇总到一个中心面板，支持全文搜索、标签筛选、内联编辑与删除，并可一键导出为 Markdown。
插件当前版本为 0.1.2，采用 MIT 许可证，在 GitHub 上约有 12 个 star。它通过 DSH 的插件机制接入 Web 配置档（web profile），不依赖 DeepSeek 或幻方官方应用商店；社区目录页见 SkillHub。
核心功能¶
单条消息书签¶
每条已完成的助手回复右侧（紧邻 👍/👎 反馈按钮）会出现归档按钮。点击后可内联编辑备注和标签（逗号分隔）。即使不写备注，书签也会保存服务端从实际回复派生的文本预览（snippet），中心面板仍可浏览。
跨会话书签中心¶
侧边栏底部提供中心面板入口，汇总所有会话与工作区中的书签，支持：
- 全文搜索
- 按标签筛选
- 内联编辑与删除
- 点击条目一键跳回对应会话
任意位置按 Alt+B 可切换中心面板显示。侧边栏收起时，可用该快捷键打开面板。
Markdown 导出¶
中心面板支持一键导出，下载文件名为 dsh-bookmarks.md，便于归档或迁入其他笔记工具。
写入安全¶
书签数据通过 DSH storage domain 持久化，采用 per-item compare-and-set 版本号（多标签页安全）、服务端校验，写入策略与官方 message-feedback 的耐久屏障对齐。
安装与启用¶
在已安装 DSH CLI 的环境中执行：
dsh plugin --profile web add dsh-bookmarks
然后重启 DSH Web UI：
dsh web
插件会自动追加到 profile bundle 层，无需额外配置。
若从本地仓库目录安装（开发或自测）：
# 在插件仓库根目录执行
dsh plugin --profile web add file:./
配置项¶
可在 profile patch 层（$DSH_HOME/profiles/web/cordis.patch.yml）覆盖以下限制，均为可选：
| 配置项 | 默认值 | 含义 |
|---|---|---|
maxNoteBytes |
4096 |
单条备注最大 UTF-8 字节数（"" 清空备注；省略字段则保留原值） |
maxSnippetChars |
300 |
服务端派生回复预览的最大字符数 |
maxTags |
8 |
每条书签最多标签数；每个标签 ≤ 32 字符，会 trim 并去重 |
示例：
- id: bookmarks
config:
maxNoteBytes: 2048
maxSnippetChars: 200
maxTags: 5
典型用法¶
- 安装并重启
dsh web后，打开任意会话，等待助手回复完成。 - 在目标回复右侧点击归档按钮，填写备注和标签（如
排查,nginx），保存。 - 按
Alt+B或点击侧边栏底部入口打开书签中心，用搜索或标签筛选定位条目。 - 需要离线归档时，在中心面板一键导出
dsh-bookmarks.md。 - 点击某条书签可跳回其所属会话（当前版本跳转到会话级，尚不能自动滚动到具体消息）。
实现概要¶
插件由一个 npm 包承载两端：
- Host 端（
lib/index.js）：bookmarksRemote 服务（Typert），数据表位于$DSH_HOME/storages/bookmarks.json。put会读取持久化会话日志以校验目标回复并生成 snippet。 - Browser 端（
src/client，打包为lib/client.js）：通过ctx.remote.$mount挂载 Remote，并注册两个 UI 插槽：conversation.chat.assistant-actions（单条消息按钮）与sidebar.footer.action（中心面板开关）。
适用场景与注意¶
适合：
- 长期在 DSH 中调试、写方案，需要把零散的高质量回复沉淀下来
- 多会话并行，希望在一个面板里按标签或关键词找回历史要点
- 需要把书签批量导出为 Markdown 做二次整理
注意：
- 书签存放在单一全局行，适合个人使用，不是多用户共享存储。
- 中心面板跳回的是书签所在会话，暂不支持定位到具体消息。
- 插件以当前
dsh进程权限运行，安装前建议查看 源码 与 MIT 许可证。 - DSH 生态遵循「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结语¶
dsh-bookmarks 把「收藏某条助手回复」做成 DSH 内的一等操作：单条打标、跨会话检索、一键导出，减少复制粘贴和翻找会话的成本。目录页：SkillHub - dsh-bookmarks；源码与文档：GitHub - penguin-oo/dsh-bookmarks。
