前言¶
用 DeepSeek Harness 和助手长聊时，有价值的内容往往散在整段回复里：某一句定义、某一段命令、某一处和上文矛盾的表述。常见做法是整段复制到外部笔记，或再开一条对话追问——主对话被拉长，上下文也容易丢。
dsh-marginalia 是 DSH 桌面版插件，在对话页直接选中文字：可以标记颜色、金色划线、把整段收进「学习」笔记，也可以就选中内容在侧栏开一条独立追问，主对话仍留在原页。维护者为 seraphinaDong，社区目录分类为「记忆」。下文介绍其能力与安装方式，事实以 GitHub 仓库 README 为准。
这是什么¶
一句话：在 DeepSeek Harness 对话里给助手回复或自己发出的内容做「旁注」——标记、划线、入库笔记，并对选中片段单独提问，回答写在右侧栏而不是主对话下方。
装好插件后，对话页会出现与「对话」并列的「学习」标签；空白新对话不显示这排标签。思考过程区域不会出现选区浮卡。
对话页：选区浮卡能做什么¶
留在对话里，选中助手的一段回复或自己发的一段话。光标右上方出现白卡片，右键也是同一张。卡片上有五类操作：
| 操作 | 作用 |
|---|---|
| 复制 | 把选区放进剪贴板。 |
| 标记 / 取消标记 | 给选区上色或清除。点「标记」后浮出红、蓝、黄，加号可开调色板；自选颜色最多保留 5 种。颜色只留在原文，不会自动进笔记。 |
| 划线 / 取消划线 | 金色下划线，或去掉。同样只留在原文。 |
| 加入笔记 / 移出笔记 | 整段收进「学习」；原文出现浅灰虚线下划线。再选同一段可移出。 |
| 提问 / 追问 | 就这段发问；已问过的可接着同一条侧栏进程追问。 |
一次标注最多 4000 字；单条对话最多 400 条标注；批注与问题各最多 2000 字。
再选中同一段时，按钮会变成「取消标记」「取消划线」或「移出笔记」。选区与已有标注重叠，或去掉空白后文字相同，都视为同一条；别处完全相同的文字会一并取消。
「学习」页与本地存储¶
「加入笔记」收进的整段，以及提问、追问记录，都列在「学习」页。仅标记或金色划线不会单独出现在列表里。
每条笔记可改摘录、问题、批注，也可删除。摘录保留原文中的加粗、斜体、代码；上方为预览（含落在该段内的标记色与金色划线），下方为可编辑的 Markdown，保存后即生效。复制选区与「复制笔记」都带这份 Markdown。若同一大段拆成多条，可改摘录收成一条，删掉多余项。
「笔记 · 数量」旁可按类别筛选，类别可自行添加；每条笔记选一个类别，未选为未分类。勾选后可全选当前筛出项，批量改类别或删除。「复制笔记」会带上类别，且只复制当前筛出项。
笔记写在本机，按工作区分目录：
- Linux / macOS：
~/.dsh/study-notes/ - Windows：
%USERPROFILE%\.dsh\study-notes\
目录内有 index.json 与对应 Markdown 文件，不会写入当前打开的项目仓库。
就一句话提问与侧栏进程¶
选「提问」，写上例如「这段是什么」，也可先选模型。被选中的那句话不会被划线；问题与摘录记在「学习」里。只要该句仍在对话中，句末会出现小引用符号：
- 合上时只显示符号；
- 点开为贴在该句旁的便利贴，展示你的问题与这条进程最新一条回复（未完成时显示「正在回答…」）；
- 按 Esc 或点「合上」收起。
便利贴内回复最多显示 20000 字。提问不会替换主对话页面；回答写在右侧栏，旁边的「任务管理」仍能看到这条子进程。
一条笔记对应一条侧栏进程；不同句子是并排的多条，互不嵌套。在侧栏继续输入、在主对话对同一句点「追问」、或在已打开的侧栏里再选一段追问，都会接在同一进程里，并保留此前回答。更早那种问完即止、无法续写的进程，需回到主对话重新提问。
模型选择¶
三处可选模型：选区后的提问卡、「学习」页上的提问或追问、已打开子进程输入框上方的「模型」。
- 「跟随当前对话」：新开进程用当前主对话的模型。
- 「沿用当前模型」：本次追问不换模型。
- 点名某一模型：新进程从第一轮即用；已打开进程从下一条回复起切换，正在生成的一条不会中途更换。
列表先列 DeepSeek V4 Pro、DeepSeek Flash，再列桌面配置 profiles/desktop/cordis.patch.yml 中的模型；没有的会提示「没有这个模型」。子进程页不显示软件自带模型菜单，换模型用输入框上方控件。进程未在运行时换模型会提示「这条进程没有在运行，换不了模型。」
安装与启用¶
要求 Node.js 20 及以上，DeepSeek Harness 版本 >=0.2.1-rc.2 且 <0.3。当前 npm 包版本为 0.1.3，按桌面版 0.2.1-rc.2 编写。
从 npm 安装（profile 名一般为 desktop）：
dsh plugin --profile desktop add dsh-marginalia
固定版本示例：
dsh plugin --profile desktop add dsh-marginalia@0.1.3
查看 npm 上最新版本：
npm view dsh-marginalia version
包页面：https://www.npmjs.com/package/dsh-marginalia
也可从本机目录安装（将路径换成插件所在目录）：
dsh plugin --profile desktop add ./path/to/dsh-marginalia
安装或更新后，须完全退出 DeepSeek Harness（含托盘图标）再重新打开，只关窗口不够。
不要把本插件再手动写进 profile 的 cordis.patch.yml：命令行识别 package.json 中的 dsh.bundle.patch 后会自动接上 cordis.patch.yml，重复配置会导致挂两次。
典型用法（可复现流程）¶
- 安装插件并重启 DSH 桌面版。
- 在已有内容的对话里选中助手回复中的一段，在浮卡上点「加入笔记」，切换到「学习」核对摘录与 Markdown。
- 对同一段点「提问」，输入问题；在侧栏查看回复，或在主对话句末点开便利贴预览。
- 需要续问时，在侧栏输入，或对同一句再点「追问」。
- 在「学习」里为笔记设类别，用筛选与「复制笔记」导出当前列表。
标记与划线适合在原文上快速视觉区分；要沉淀可检索内容，以「加入笔记」与提问记录为主。
适用场景与注意¶
适合需要在同一条 DSH 对话里精读、摘录、并对局部片段反复追问的开发者或学习者：主对话保持完整，旁注与追问并行，笔记落在本机 ~/.dsh/study-notes/ 而非项目仓库。
README 写明当前尚无自动整理与导出 PDF。插件以当前 DSH 进程权限运行，安装前建议阅读 源码 与 MIT 许可证，确认符合你的环境与合规要求。DSH 社区插件目录（SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-marginalia 把「划线、笔记、就句追问」收进对话页与「学习」侧栏，减少整段外拷和主对话被侧枝占满的情况。安装用 dsh plugin --profile desktop add dsh-marginalia，详情见 GitHub 与 SkillHub 目录页。
