前言¶
在 DeepSeek Harness（DSH）里与模型长对话时，常有段落、表格或结论需要稍后回看；仅靠滚动历史或复制到外部笔记，容易打断当前会话，也难在多条会话之间统一查找。社区插件 dsh-bookmark（维护者 vaisramana）面向「记忆」类需求：在对话内选中内容即可书签与高亮，并在右侧栏与全局书签页中管理备注，必要时再引用回输入框。下面介绍其定位、能力与安装用法。
这是什么¶
dsh-bookmark 是 DSH 的浏览器端插件，为 DeepSeek Harness 提供会话内书签、文本/表格高亮、行内备注，以及可折叠的「全部会话」书签视图。数据默认保存在本机 localStorage，不改动会话日志；只有你把书签「引用」进输入框时，才会进入当前对话上下文。
核心功能¶
右键一键书签与高亮¶
在任意消息中选中一段文字、多段落或整张表格（<table>），右键选择 Bookmark。选区会在原位高亮，并出现在当前会话右侧栏的 Bookmark 标签页。
对话内查找¶
使用 ⌘ + F / Ctrl + F，或点击输入区上方的 Find 入口，打开类似 Safari 的浮动查找条；匹配项在当次对话中高亮，用 Enter / Shift + Enter 在匹配之间跳转。
行内备注¶
每条书签卡片带有无边框备注输入框；书签后可立即输入，或稍后点开卡片编辑。在失焦或按 Enter 时自动保存。
非破坏性高亮实现¶
高亮基于浏览器 CSS Custom Highlight API（::highlight(dsh-bm-mark)），通过偏移与上下文恢复定位，不直接改写 React 管理的 Markdown DOM。
右侧栏与输入区入口¶
插件挂在 DSH 原生右侧栏（sidebar.right.pane.tab），也可从输入区旁的 Bookmarks 药丸进入。点击书签可滚动到对话中的对应高亮；也可用 Quote 将 passage 与备注插入输入框。
跨会话书签页¶
左侧栏 Bookmarks、快捷键 Alt + B，或右侧栏 All Sessions › 打开全部会话视图。书签按会话分组，支持按最近时间、会话标题或数量排序，会话块可折叠，支持全文搜索、跨会话跳转定位，以及 Markdown 导出。
安装与启用¶
插件以当前 DSH 进程权限在浏览器中运行；安装前建议在 GitHub 查阅源码；许可证为 MIT。
桌面应用（GUI）¶
在 DSH 中打开 Plugins，从 GitHub 或本地目录安装，仓库标识为：
github:vaisramana/dsh-bookmark
CLI¶
# Install into Desktop profile
dsh plugin --profile desktop add github:vaisramana/dsh-bookmark
# Or install into Web profile
dsh plugin --profile web add github:vaisramana/dsh-bookmark
本地目录¶
在插件源码目录内，可用 file: 安装（README 要求先进入该目录再执行）：
dsh plugin --profile desktop add "file:$PWD"
package.json 中 dsh.client 标明平台为 web，并依赖宿主提供的 UI 与会话相关模块；无额外 npm 运行时依赖。
典型用法¶
- 创建书签：在消息内选中文字或表格 → 右键 → Bookmark。
- 写备注：右侧栏会自动打开并聚焦备注框；
Enter或点击外部保存。 - 定位或引用：点击引用片段或 Locate 平滑滚动到高亮处；Quote 将内容与备注填入输入框。
- 浏览全部会话：左侧 Bookmarks 或
Alt + B（或右侧 All Sessions ›）；点击会话标题可折叠/展开该组书签。
数据与架构要点¶
| 文件 | 职责 |
|---|---|
index.js |
宿主 bundle 入口（无状态逻辑；状态在浏览器本地） |
client.js |
浏览器模块，注册侧栏、composer dock、overlay、面板列表等挂载点 |
cordis.patch.yml |
Profile bundle 补丁 |
locale/*.json |
中英文元数据 |
持久化键名为 localStorage["dsh-bookmark/v1/items"]。插件只使用宿主提供的 react 与 --dsw-alias-* 主题 token。
适用场景与注意¶
适合需要在 DSH 内长期保留「对话片段 + 简短批注」、并在多会话间检索的开发者或重度对话用户。查找与高亮能力依赖浏览器对 CSS Custom Highlight API 的支持；若环境不支持，需以实际表现为准。
DSH 生态主张「一切皆插件」；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-bookmark 把「选中 → 高亮 → 备注 → 跨会话浏览 → 再引用」收拢在 DSH 界面内，减轻对外部笔记的往返切换。目录页：https://www.skillhub.cn/plugins/vaisramana/dsh-bookmark；源码与文档：https://github.com/vaisramana/dsh-bookmark。
