前言¶
在 DSH 里写长文、改稿或对照材料时，常见做法是另开窗口、复制粘贴，或自建一套 Document 工作区。材料一多，参考内容和当前 Markdown 文件之间的对应关系容易丢，长对话里哪几轮和正文相关也要人工翻找。
Sift（@songyanglin/dsh-sift）是维护者 Songyanglin-curious 发布的 DSH 插件，定位是「当前文章参考」：不另建工作区类型和三栏工作台，文章浏览、分栏、文件管理和会话仍用 DSH 原生能力，只在当前打开的文章旁挂参考栏，并按路径持久化文章与 References 的关系。SkillHub 社区目录将其归类为「模型推理」，简介为从混杂内容中筛选、整理有价值部分；与 README 中「粘贴参考、导入长会话并做 User Turn 相关性定位」等能力一致。
这是什么¶
Sift 是 DSH 的轻量插件：在原生文件预览的工具栏上增加「参考」入口，为当前正在编辑或浏览的那篇文章提供并排参考栏，而不是替换 DSH 的整体布局。
- 维护者：Songyanglin-curious（npm 包作者字段为 songyanglin）
- 当前版本（package.json）：
0.3.0 - 许可证：MIT
- 仓库：github.com/Songyanglin-curious/dsh-sift
- 社区目录：skillhub.cn 插件页
README 写明适配 DSH 0.2.0-rc.2。插件以当前 DSH 进程权限运行，安装或使用前应自行查看源码与许可证。
核心功能¶
下列能力均来自项目 README，未在资料中出现的配置项或 API 不在此展开。
-
工具栏「参考」图标
在 DSH 工作区中打开 Markdown 或文本文件后，原生文件工具栏会出现「参考」图标。 -
当前文章并排参考栏
点击图标后，在文件预览旁打开仅属于当前文章的参考栏，与正文同屏对照。 -
剪贴板与自动关联
可直接粘贴剪贴板内容；若尚无参考条目，会自动创建并关联到当前文章。 -
长会话导入与相关性定位
可导入长会话，并对 User Turn 做相关性定位，便于从混杂对话里筛出与写作相关的轮次。 -
按文件路径持久化
文章与 References 的对应关系按文件路径保存，换会话 reopen 同一文件时仍可对上参考。 -
与 dsh-annotations 协作
与独立的@songyanglin/dsh-annotations配合，在文章、参考和对话中使用统一批注。原生预览里选中文字可走 Annotations 进入当前会话；参考栏侧则负责材料与会话关联。
README 用如下结构概括交互关系：
DSH 原生文件预览
├─ 选中文字 → Annotations → 当前会话
└─ 参考图标 → 当前文章并排参考栏
├─ 粘贴 / 添加已有材料
└─ 会话相关性分析
安装与启用¶
已抓取资料（GitHub README、SkillHub 目录页、package.json 片段）未给出 DSH 客户端侧的一行官方安装命令；请勿凭仓库名自行拼接未在文档中出现的 dsh plugin add 类命令。
可核对的事实如下：
- npm 包名：
@songyanglin/dsh-sift，版本0.3.0，发布配置指向https://registry.npmjs.org/。 - SkillHub 页面标注「可安装」，具体在 DSH 中的添加方式以目录页当时说明与 DSH 官方插件文档为准。
安装前建议：阅读仓库 README 与 LICENSE，确认与本地 DSH 版本（README 要求 0.2.0-rc.2）匹配；插件在社区目录独立收录，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
下面步骤对应 README 描述的操作路径，可在本地 DSH 工作区中按序尝试。
- 在工作区中打开一篇 Markdown 或纯文本文章。
- 在文件预览工具栏点击「参考」图标，打开该文章专属的并排参考栏。
- 将外部摘录或剪贴板内容粘贴进参考栏；若无现成参考，插件会自动创建并绑定当前文件路径。
- 若有需要对照的历史对话，导入长会话，使用 User Turn 相关性定位，把与正文相关的轮次找出来再写入或对照参考栏。
- 若已安装
@songyanglin/dsh-annotations，可在正文选中处做批注并带入当前会话，与参考栏中的材料一并使用。
开发或二次构建时，仓库 README 给出的命令为（需 Node.js 24 或更高版本）：
pnpm install
pnpm check
pnpm test
pnpm build
适用场景与注意¶
更适合谁
- 在 DSH 里以文件为中心写稿，需要把网页摘录、笔记、对话片段挂在当前文章旁，而不是再搭一套 Document 工作区的人。
- 需要从长 Agent 会话里按轮次筛内容与文章相关的片段，再整理进参考栏的用户。
使用时注意
- Sift 刻意不创建新的工作区类型、三栏工作台或 Document 区域；若你依赖的是重型文档工作台，应继续用 DSH 原生或其它插件，而不是期待 Sift 替代整套布局。
- 文章与参考的绑定依赖文件路径；移动或重命名文件后，需自行确认关联是否仍符合预期（资料未说明自动迁移行为）。
- 会话相关性分析属于插件提供的能力边界，具体模型与推理依赖 DSH 与插件实现；目录分类为「模型推理」时，仍应把插件当作在本地 DSH 进程中运行的第三方代码对待。
- GitHub 仓库当前星标为 0（以目录线索为准），成熟度需自行评估；遇到问题可在 Issues 反馈。
结尾¶
Sift 把「当前文章的参考材料」和「长会话里相关的 User Turn」收拢到原生文件预览旁的一条链路里，路径级持久化又避免参考与正文脱节。若要查看安装入口与版本信息，可打开 SkillHub 目录页；若要读能力细节与开发说明，以 GitHub 仓库 README 为准。
