从 DSH 统一的 @ 菜单中引用工作区文件、DSH 会话,以及 ChatGPT、Claude、Gemini、DeepSeek、Grok 和 Kimi 的历史对话。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-reference-anything
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Chael-Chael/dsh-reference-anything
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
一个 @,引用万物。
English · 简体中文
📰 新闻 · 🧭 Roadmap · 📦 安装 · 🚀 使用 · 🐛 报告问题
Reference Anything 是 DeepSeek Harness(DSH)的 @ 菜单增强插件。 它把文件、会话、本地 Agent、网页端对话、网盘和本地插件集中到一个可搜索的菜单中,无需切换工具或手动复制内容,即可为当前任务补充所需上下文。
输入 @ 后,既可以用鼠标浏览并点击菜单中的条目,也可以直接用键盘输入文本进行搜索,缩小结果范围。选中文件夹后,按 Tab 进入文件夹继续浏览,按 Enter 插入文件夹引用。
通过同一个 @ 菜单,可以引用:
- 🧩 DSH 命令与 Skills
- 📁 工作区文件和文件夹
- 💬 DSH 历史会话
- 🖥️ 本地 Agent 对话:内置 Claude Code、Codex、Cursor 等 33 种来源格式的扫描和只读解析能力,可通过 Chat Import 导入 DSH;真实验收覆盖范围另行记录。
- ✨ 本插件新增:来自 ChatGPT、Claude、Gemini、DeepSeek、Grok 和 Kimi 这些网页端 Chatbot 的历史对话(重点)
- ☁️ 本插件新增:通过 OpenList 连接的云盘文件
- 🧩 本插件新增:本机已安装和已配置的 DSH 插件,无需再频繁翻找目录
在扩展 @ 的能力之外,我们还支持一些对于 @ 菜单界面的增强:
- 自定义展示分组:按需启用或隐藏
Commands、Skills、文件、DSH 会话、本地 Agent 对话、外部对话、网盘文件和本地插件,并调整分组顺序 - 自定义快捷词:为来源分组、网页端 Provider、本地 Agent 和网盘挂载设置符合自己习惯的快捷词
- 自定义展示数量:分别设置各组折叠时的条目数和候选数量上限
- 两种浏览方式:使用逐组展开/折叠,或切换至 DSH 原生滚动列表
- 图标和命令增强:通过类型图标和平台 Logo 区分不同引用来源
输入 @,即可跨已启用的来源搜索并把选中的引用加入当前任务。不同来源仍保留各自的访问与加载方式:文件通过 DSH 受权限约束的工具读取,DSH 会话沿用原生 session-reference 协议,本地 Agent 对话直接从磁盘流式读取,网盘文件按窗口走网盘自身的 API 取回,外部对话正文则由 Agent 按需读取。
只有「外部对话」这一组通过 OpenCLI 复用用户已登录的 AI 对话窗口来获取历史对话:默认仅在本地保存对话标题,正文由 Agent 按需获取远端内容;也可以切换至离线镜像模式,在本地保存最新的完整正文。「本地 Agent 对话」不需要这一整套——那些记录本来就是你自己磁盘上的文件,这一组直接读取,不开浏览器、不经过 OpenCLI、也不做任何镜像。
[!NOTE] DSH 目前仍处于 Beta 阶段,其底层能力和接口可能随版本迭代而变化,本插件的功能与实现也会相应调整。受 DSH 当前部分限制的影响,现阶段的实现可能尚不完善;我们会持续跟进 DSH 的更新并逐步改进。具体限制和使用注意事项请参阅下方对应章节。
📰 新闻
v0.5.2

新增 oh-my-pi、Copilot VS Code、Copilot CLI 和豆包桌面版引用;修复官方引用开启后的文件/会话分类前缀;教程 GIF 改为远程按需加载。豆包需要本地缓存正文,导入需要 Chat Import 0.26.3 或更新兼容版本。发布说明。
0.5.0 预览 · 功能演示
本轮还升级了本地工具的统一分页与长文本接续读取,正文和工具记录均可搜索;每次读取检查当前来源开关,非本地工具迁移到 external_reference_list/read。完整变更及调用示例见 0.5.0 发布说明。另见 v0.5.1 兼容性修复。
把历史对话直接“搬”进 DSH,无缝接着聊
以前想接着别的本地会话继续聊,要么得来回复制粘贴聊天记录,要么只能把旧对话当成静态背景资料。
现在,在 @ 菜单里找到本地历史会话,你有两种方式处理它:
- 只当参考资料(按
Enter):直接引用该会话; - 接着往下聊(按
Tab):在弹出的菜单中选择导入并确认,就能把整段历史记录直接搬进 DSH,顺着之前的上下文继续对话!(如果觉得每次确认太麻烦,也可以在设置中关闭二次确认,一步到位)
💡 提示:使用导入功能需安装并启用
dsh-chat-import(0.26.3 或更高兼容版本)。

菜单内一键升级配套插件,不用手动折腾
如果提示 dsh-chat-import 版本太旧、用不了“对话导入”或“交接摘要”,不用自己再去后台找安装包手动更新了。
直接在菜单里点击升级提示,即可一键完成更新(需升级至 0.26.3 或更高兼容版本)。升级后如果弹出重启提示,重启一下 DSH 即可生效。

输入 @plugin:,直接让 Agent 帮你检查本地插件
插件报错想让 Agent 帮忙排查,或者想研究某个插件的源码?以前还得自己去电脑深层目录里翻找插件的安装路径,非常劝退。
现在只需输入 @plugin:,搜索插件名称并按 Enter,就能直接把该插件的本地目录喂给 Agent(支持当前 DSH 环境中已安装的所有插件)。

自定义快捷词,直接缩小搜索范围,不用手动翻找
@ 菜单里东西太多,想找历史对话时还得在一堆文件、目录和不同来源里手动翻找?
现在你可以给各个对话来源设置专属快捷词(支持设置多个,用英文逗号分隔),输入时直接按类别过滤,快速锁定搜索范围:
- 按分类合并搜:比如忘了具体在哪聊过,可以给“本地 Agent”和“网页对话”都加上同一个快捷词(如
chat),输入@chat:就能把搜索范围直接缩小到这两类对话中; - 按来源精准搜:明确只想找某一个来源时,直接输入它的专属快捷词(比如
@codex:),即可一步到位只搜 Codex。

不用死记路径,像逛文件夹一样找到目录并引用
想引用某个深层文件夹,但记不住完整路径、也不想手打?
现在 @ 文件菜单支持直接层层浏览了:
- 进入子目录:选中文件夹后按
Tab键; - 返回上一级:点击菜单顶部的导航栏;
- 确认引用:找到目标文件夹后按
Enter,一键插入到当前对话中。

2026-10-12 · v0.4.4 — 新增本地插件来源、可配置的分组与平台快捷词,改进 Picker 图标和文件夹插入行为,并补充
model命令入口。2026-10-06 · v0.4.3 — Reference Anything 现已支持 DSH Desktop!设置页面焕新优化!
2026-09-28 · v0.4.2 — 重要更新 — 修复插件与当前 DSH 接口格式不匹配导致的致命兼容性错误:当前 DSH 在加载插件时要求
agentSearch的严格接口登记信息提供create()数据校验器工厂函数,而 v0.4.1 只提供了校验规则,导致插件在加载阶段就被 DSH 拒绝,搜索功能尚未运行。此版本补齐所需的create()工厂函数,并修复原生菜单中的命令图标尺寸及中英文命令名称展示。2026-09-25 · v0.4.1 — 最近闲下来,重启更新!!🎉🎉 改进本地 Agent 会话标题:读取 Codex 自己的
session_index.jsonl,并支持 Pi/Codex 标题显示;恢复 DSH 原生的@菜单分组标题处理,避免透明叠加和多余的自定义模糊渲染;索引读取限制为 16 MiB,保证资源使用可控。2026-09-03 · v0.4.0 — 适配版本:DSH
>=0.2.0-rc.2。 将 Skills 发现迁移至 DSH RC1 Skills Remote,通过 RC1 Session 快照 API 恢复历史引用授权,并完成针对 DSH0.2.0-rc.2的验证。
🧭 Roadmap
- 支持引用本地其他 Agent 的历史对话
- 支持继续引用的本地 Agent 会话(Continue Session)
- 支持通过 OpenList 引用网盘文件
- 在插件内管理网盘文件(开发中;当前不会修改云端文件)
- 更多的关键词搜索匹配规则,黑名单、白名单等(特别对于file search)
- 支持引用更多 AI 对话平台消息
- 更静默的 AI 对话同步机制
- 支持引用电脑上打开的应用窗口、浏览器窗口
- 增加跨来源全文与语义搜索,展示命中片段并统一排序(P0)
- 降低跨平台来源的配置成本,支持自动检测、断线恢复、多账户隔离和同步状态反馈(P1)
- 支持可选地继续引用的本地 Agent 任务,并带入目标、关键文件和未完成事项(P2)
- 增加来源、时间和引用范围展示、敏感内容过滤及本地缓存清理入口(P2)
- 更多 Idea 欢迎在 Issues 中提出!
📦 安装
当前版本为 v0.5.2,包声明的 DSH SDK 最低版本为 0.2.0-rc.2。
官方桌面端
默认由 Reference Anything 接管原生引用。如果你在 Profile 中显式启用官方 ui-reference,重启 DSH 并重新加载页面后,原生引用交由官方处理,RA 自动隐藏重复的文件、DSH 会话候选;此前插入的 RA 文件和会话引用仍可使用,其他 RA 来源不受影响。
官方文件和会话分组遵循 RA 的显示开关与独立排序,并支持折叠显示条数与展开/收起,包括方向键、Enter 和 Tab 操作;引用插入、复制与预览继续由官方处理。选择“不折叠(原生)”可显示完整列表;遇到不支持的候选格式时也会退回完整列表。
Tab 进入文件目录后,RA 暂停其他来源搜索,菜单只显示文件;返回根级后恢复其他来源。展开/收起操作使用灰色文字。
从 DeepSeek Harness 官网 下载官方桌面端,打开 插件(Plugins)→ 添加插件(Add plugin),输入 dsh-reference-anything 并按提示安装、启用。完成后重启 DSH(如有提示),再打开 设置 → Reference Anything。
桌面端使用独立的插件 Profile;Web Profile 中安装的插件不会自动启用到桌面端。详见官方桌面端说明。
DSH Market
打开 Reference Anything 的 DSH Market 页面,或在已安装的 DSH Market 中搜索 dsh-reference-anything 并安装。尚未安装市场时,桌面端使用 添加插件 安装 dshmarket;Web 用户执行:
dsh plugin --profile web add dshmarket
Web 命令行
dsh plugin --profile web add dsh-reference-anything
安装入口提供的版本以对应渠道为准;本文描述 v0.5.2 功能。
可选:连接网页 AI 对话
仅网页对话需要此步骤。本地来源可直接使用;请先在浏览器登录所需平台。OpenCLI 随插件安装,适配器安装仍需要可用的 npm。
安装 DSH 插件后,打开 DSH 的 Settings → Reference Anything → 可用性检查(如果尚未出现该设置项,请先重启 DSH),点击**「一键安装」**:它会使用随插件安装和升级的 OpenCLI 2.0.0 运行时依赖;随后安装插件包内附带的六个平台适配器,启动或刷新 Browser Bridge,并打开 OpenCLI Browser Bridge 扩展的 Chrome Web Store 安装页。在商店页确认安装后,回到设置页点击「重新检查」;每个仍未通过的检查项旁都会显示对应的恢复操作。
如需使用自定义全局 OpenCLI,可手动安装,并在设置的 OpenCLI 可执行文件中填写其完整路径;默认 opencli 始终使用插件依赖:
npm install --global "@jackwener/opencli@2.0.0"
opencli plugin install file:///C:/path/to/dsh-reference-anything/opencli-plugin
opencli daemon restart
请将示例中的 C:/path/to/dsh-reference-anything 替换为仓库所在路径。浏览器扩展无法由网页静默安装,必须通过 Chrome Web Store(或从 OpenCLI Releases 下载后手动选择 “Load unpacked”)确认安装。如果浏览器阻止自动打开商店,设置页会保留可点击的备用链接。如果 OpenCLI 发现多个浏览器 Profile,可直接在失败的检查项中选择并应用一个已连接的 Profile。OpenCLI 随插件升级;浏览器扩展由浏览器商店单独更新。
🚀 使用
Reference Anything 直接向 DSH 原生 @ 菜单注册八个来源,不会引入一套割裂的搜索界面。设置中可以决定显示哪些分组、调整顺序、分别配置折叠条目数和候选硬上限,并选择插件的展开/折叠模式或 DSH 原生滚动列表。设置页还提供一键切换:可以只把可见 Picker 恢复为 DSH 官方文件/会话列表,而插件、同步服务、本地数据和模型侧工具继续运行;需要时可从同一位置重新启用 Reference Anything @。
- 在输入框键入
@浏览来源,或输入关键词,例如@缓存设计。 - 用鼠标选中条目,或用方向键选择后按
Enter插入引用。工作区文件夹按Tab进入,按Enter引用。 - 写下任务并发送,例如:「参考这段 Codex 对话和这个项目目录,检查之前的方案是否已经实现。」
需要网页对话时,先完成上方连接步骤,再到 设置 → Reference Anything → 网页端 AI 对话同步设置 选择平台、浏览器 Profile、保存方式和历史范围,开始同步。需要网盘时,在设置中连接 OpenList 并添加挂载。
默认使用“按需读取正文”模式:本地只保存标题索引,Agent 需要对话内容时才通过浏览器读取正文。若需要离线读取和正文检索,请选择“在本地保存完整正文”。插件会在加载时检查新版本;可在设置页查看更新日志,安装更新后重启 DSH 即可生效。
功能介绍中的演示图片仅在当前卡片显示时从 GitHub 加载,需要网络连接;图片加载失败不影响阅读文字和翻页。
[!NOTE] DeepSeek 和 Kimi 支持在来源卡片点击 连接账号:首次通过 OpenCLI 读取已登录网页的 token,并使用固定版本
@napi-rs/keyring@2.1.2存入系统密钥库。此后列表、正文和同源附件由 Host 后台读取,不需要浏览器持续开启。token 过期后点击 重新连接;删除已存凭据 会移除密钥库条目,保留历史索引。Windows 使用 Credential Manager,macOS 使用 Keychain,Linux 要求可用且已解锁的 Secret Service;不可用时明确失败,不降级为明文文件。系统密钥库不提供对同一用户下所有恶意程序的绝对隔离。
其他来源或尚未连接 token 的网页对话同步、读取正文时,OpenCLI 可能打开或复用浏览器窗口。请保持窗口可用,直到操作完成;同步速度取决于平台、记录数量和浏览器连接。
常用快捷词
以下为当前默认配置;修改快捷词后,以设置页为准。
| 输入 | 用途 |
|---|---|
@file:README |
搜索工作区文件和文件夹 |
@session: |
浏览 DSH 历史会话 |
@agent: / @codex: |
浏览本地 Agent 历史 / 只看 Codex |
@chat: / @chatgpt:缓存 |
浏览网页对话 / 搜索 ChatGPT 对话 |
@drive: |
浏览已连接的网盘 |
@plugin: |
查找本地 DSH 插件 |
@command: / @skill: |
选择命令 / Skill |
在 通用设置 中可为分组、网页平台、本地 Agent 和网盘挂载设置快捷词。多个词用逗号分隔:文件分组设置为 file,f 后,可用 @f:README。同一个快捷词可分配给多个来源,也支持中文全角冒号 :。
🧩 一个 @ 菜单,多种来源
@ 菜单包含八个分组:Commands、Skills、Files and folders、DSH sessions、Local agent conversations、External conversations、Cloud drive files、All local plugins。网盘分组可逐层浏览通过 OpenList 连接的文件夹和受支持文件;当前仅提供只读访问,连接在设置页中管理。每组默认先显示 6 条,并可分别设置 1–50 的候选硬上限。在展开/折叠模式下,每次展开追加 5 条且菜单保持当前滚动位置,折叠则恢复到配置的紧凑条目数;外部对话的同步入口固定在分组最前面,同步开始、进行和完成时都会原位更新菜单与可见结果。可在 Settings → Reference Anything → 通用设置 中启用或关闭分组、调整顺序,并选择“展开/折叠”或“DSH 原生滚动”。
⌨️ @Commands — DSH 原生命令
输入 @command: 可浏览命令;选择后会把 /command 交回 DSH 原生斜杠命令流程。
🛠️ @Skills — DSH 技能库
输入 @skill: 可浏览 Skills;选择后会插入 /skill 并交给 DSH 原生 Skill 处理。
📁 @Files and folders — 工作区文件与目录
在输入框键入 @file:,通过 DSH 官方 file-reference Remote 浏览文件和文件夹。
功能:
- 使用官方
@path/@"含空格的路径"语法和规范候选服务 - 文件与文件夹均可插入为原生引用;选中文件夹时,按
Tab进入,按Enter插入引用
💬 @DSH sessions — DSH 会话历史
在输入框键入 @session:,通过 DSH 官方 session-reference Remote 浏览 DSH 会话。
选中的会话使用 DSH 规范 dsh-session: mention 和原生 session 外观;快照准备与解析继续由 DSH 官方服务负责,而不是由本插件复制实现。
内置 0.26.3 解析器新增 oh-my-pi(@omp:),默认读取 ~/.omp/agent/sessions;导入需要 Chat Import 0.26.3 或更新版本。
🖥️ @Local agent conversations — 本地 Agent 历史对话
键入 @agent:,即可搜索并引用其他本地 Agent 工具保存的历史对话。
新增 Copilot VS Code(@copilot-vscode:)、Copilot CLI(@copilot-cli:) 和 豆包桌面版(@doubao:)。豆包仅能引用本地已有缓存正文的对话;缺少的对话可先在豆包中打开后再刷新。
全部 33 种来源使用内置的只读扫描器和解析器,代码来自 dsh-chat-import。扫描和引用无需安装 Chat Import。来源开关、附加目录和工作区范围继续生效;设置页显示来源目录、数量和扫描异常。Enter 插入引用,可恢复的图片通过 DSH 附件返回,查看图片需要支持视觉的模型。确认没有正文的会话会隐藏,读取异常的会话仍然保留。本地引用现在保存可读的来源、路径和会话 ID;旧版 URI 协议的本地引用需要重新选择。
发送本地引用时,插件在每条用户消息后附上一个聚合背景。模型通过唯一的 reference 工具读取本地会话:source: "local",id 是可读的 codex:2026/11/13/rollout-….jsonl(<agent>[@<扫描位置>]:<相对路径>[#<会话号>],不含用户名和绝对路径)。图片和工具调用记录是子项:先 list 该 id,再读取子项,图片用 as: "image"。
续读时把不透明的 next 原样放进 args.next;搜索命中的 args 直接交给 read 即从命中处开始。长文本按 Unicode 码点精确续读,不丢字。来源明确提供的历史摘要用 role: "summary",来源限制用英文 notice,原始内容不翻译。
reference-prestep.maxTextBytes 默认将同一 pre-step 批次的新增引用上下文总量限制在 16 KiB,剩余上下文估算可进一步降低它;reference-tool.maxTextBytes 独立限制每次工具文本结果,默认也是 16 KiB。容量未知时只给有界定位与说明,连定位也装不下时明确报错。预览保留最近连续尾段,最新消息过长时给可续读的前缀。图片像素另限 10 MiB。
每次新读取均校验来源开关、允许目录内的真实路径和会话身份。工作目录与当前会话相同的本地会话,模型无需 @ 即可读取;其他会话必须由用户 @。会话继续增长时从头读取不受影响,只有拿旧的 next 续读才报 REVISION_CHANGED。不保存全文快照或跨调用的完整解析缓存。其他来源使用同一个工具,见下文模型侧协议。
导入状态、会话导入和交接摘要通过可选的 Chat Import API 提供。需要时可在设置页安装或升级独立插件;Reference Anything 不会在启动时自动安装。API 不可用时不显示导入状态,也不影响本地扫描和引用读取。Tab 保留已配置的导入、摘要操作及确认流程。
扫描在独立进程中运行,元数据缓存 30 秒。引用解析仍可能先读取完整来源,再返回一页。源码和图标保留 MIT 许可证(见 vendor/chat-import-reader/ 和 images/agents/LICENSE)。维护者可用 npm run vendor:sync -- <已构建的-dsh-chat-import-目录> 同步扫描和解析快照,发布前检查见 vendor README。
支持的来源: Claude Code、Codex、Cursor、Gemini CLI、Antigravity、Reasonix、opencode、mimocode、zcode、Grok Build、OpenClaw、Pi、Hermes、Kimi、Kilo Code、Qoder、ChatGPT 导出、WorkBuddy、Qwen Code、Continue、Cline、Goose、DSH 4、Zed、Crush、Teleagent、Trae Work、Vibe 和 DSH。
功能:
- 自动识别历史对话,并显示每个 Agent 的对话数量
- 可独立启用不同 Agent,也可选择自定义历史目录
- 默认搜索全部已识别对话,也可限制为当前工作区
- 发送时自动预览最近正文;按编号补读正文、关联工具细节和图片
- 支持
@codex:、@claude-code:、@gemini-cli:等 Agent 专属前缀
引用只读,不修改本地记录;导入和交接摘要是通过 Chat Import 提供的独立操作。Claude Code 和 Codex 适配器曾用真实记录验证;其余格式主要通过测试样例验证,实际兼容性可能因工具版本而异。opencode、mimocode 和 zcode 的数据库读取需要 DSH 宿主运行时提供 node:sqlite。
🧩 @Local plugins — 本地已安装和已配置的插件
输入 @plugin: 搜索插件。设置中还可只显示运行中的插件,或隐藏 DeepSeek 官方插件。在 设置 → Reference Anything → 通用设置 中,可用 本地所有的插件 开关立即显示或隐藏该分组,选择会自动保存。默认开启,折叠显示 6 条,候选上限为 50。
列表读取当前 DSH 加载器合成后的插件条目和生命周期状态,并补充 Profile 声明的插件包及带有 DSH bundle/client 元数据的已安装包,排除普通依赖。运行中、已停用和未运行表示宿主插件条目的状态;没有宿主条目的包显示为未运行。选中插件后会插入名称,以及可解析时的真实本地目录引用。文件访问仍使用 DSH 现有的工具和权限。
🌐 @External conversations — 外部对话平台
支持 ChatGPT、Claude、Gemini、DeepSeek、Grok 和 Kimi 的历史对话。
未发布的开发版还新增了 Qwen 国际版、千问国内版、豆包。先在对应来源卡片连接账号,再同步;凭据仅存系统密钥库,较长的 Cookie 组合分段保存。Qwen/千问目前读取普通历史,豆包读取最近一页;项目、归档、旧消息翻页及附件下载尚未完整支持。不完整列表不会把未出现的会话标为远端已删除。旧用户已有的来源启用选择保持不变。
“在本地保存完整正文”可离线读取已同步文本,不代表附件也已离线保存。自动同步和启动时同步默认关闭,可在设置中开启。
按平台过滤:
- 使用
@chatgpt:缓存、@claude:重构的格式过滤特定平台 - 也接受简写:
@gpt:、@ds:等 - 单独输入
@claude则列出该平台最近的会话
搜索能力:
标题匹配:支持模糊搜索对话标题
正文检索:仅在“在本地保存完整正文”模式下可用;标题匹配不足时搜索已同步正文,并在候选行显示匹配片段
平台和账号隔离:按 Provider 和账号作用域分别维护会话历史
@检索只使用最近一次同步缓存的账号范围,不会为搜索连接浏览器;同步识别到账号切换后,只展示新账号记录,旧账号记录仍可在对话管理中查看和清理
引用展示:选中后,草稿中显示带 Provider Logo、可整段删除的 DSH 原生引用;其稳定序列化形式为:
@[ChatGPT·对话标题](dsh-ref:<opaque-base64url>)
打开来源 URL 仅发生在 UI 中,URL 不会注入模型上下文。上下文预算允许时,网页对话引用会附带预览;否则模型按需用 reference 工具读取正文。
☁️ @Cloud drive files — 通过 OpenList 引用网盘文件
键入 @drive:,即可逐层浏览文件夹,并引用通过 OpenList 连接的网盘文件。
常用网盘包括 OneDrive、阿里云盘、百度网盘、夸克、115、123、Dropbox、Google Drive/相册和 Yandex;OpenList 提供的其他网盘也可在同一设置页中配置。
功能:
- 一键启用托管 OpenList,也可连接已有的 OpenList 服务
- 在设置页添加和管理网盘挂载,常用网盘支持快捷登录
- 搜索已建立索引的文件,并在
@菜单中逐层浏览目录 - 在搜索结果中显示网盘、路径和文件类型,方便区分同名文件
- 直接读取文本文件;按需下载文档、表格、演示文稿、PDF 和图片
- 可选择并直接打开下载目录
- 显示挂载状态,并支持启用、停用、重新认证、移除和重建搜索索引
通用提示:
- 分组快捷词用
:分隔,不要用空格:@的候选 token 遇到空格即终止,所以@chatgpt 关键词会在按下空格时关闭菜单。多词搜索请写成@cachedesign或@cache-design。 - 没有类型前缀时,仍同时搜索所有分组
- 命令和 Skills 选择后由 DSH 原生斜杠命令流程处理,原生
/面板仍可继续使用 - 把 Picker 切回 DSH 官方文件/会话列表后,所有插件分组都会隐藏,
Local agent conversations和Cloud drive files也不例外。宿主侧来源仍然注册着,已经插入的引用照常展开、reference工具照常可读,只是菜单入口在切回来之前不再出现
🔄 @外部对话的实现方式
DSH Web / Desktop @chat:
↕ Host Remote
DSH Host + reference_anything 本地索引 / 可选正文镜像
↕ execFile(opencli, argv)
opencli-plugin-dsh-chat-history
↕ OpenCLI daemon + 官方 Browser Bridge
ChatGPT / Claude / Gemini / DeepSeek / Grok / Kimi
🤖 模型侧协议
所有来源——本地 Agent 会话、网页对话、云盘文件、本地插件和第三方来源——都通过同一个工具 reference({ source, id?, op, args }) 读取。引用会在用户消息后附上一段不可信数据背景:来源用法、source 与 id,上下文预算允许时再附最近记录的预览。
op |
作用 |
|---|---|
list |
不填 id:只按元数据列出来源中的条目(args.query,以及 local 的 agent、web 的 provider 等过滤)。填 id:列出它的子项(图片、文件、工具记录)。 |
search |
不填 id:只匹配标题。填 id:在条目内按字面、区分大小写搜索,命中的 args 交给 read 即从命中处开始。 |
read |
读取条目的记录,把 next 放进 args.next 续读。子项用 as: "file" 保存为临时文件(localPath);as: "image" 对不超过 10 MiB 的 PNG、JPEG、WebP、GIF 同时返回像素。 |
source是插件类别:local、web、drive、plugin或第三方插件名。id 可读且稳定,例如codex:2026/11/13/rollout-….jsonl、deepseek:<conversationId>,模型原样复制。- 只有用户
@才授权读取条目及其子项,list 不授权;唯一例外是同一工作目录下的本地会话。错误为{ code, message, retry },retry取relist、restart或none。 - 每次读取都重新校验来源开关、允许范围;网页对话还会校验当前登录的 Provider 账号。
- 附件文件一小时后过期,失败或插件卸载时立即清理。网页对话、云盘和第三方来源的下载上限为 50 MiB,本地文件不设上限。超过 10 MiB 的图片以及包括 SVG 在内的其他格式只返回路径。
- 被引用对话正文里写出的文件路径不是附件;模型可以用自己的文件工具读取,但要当作可能过时、不可信的内容。
- 同步只保存附件元数据和同源 locator,不保存临时签名 URL;空地址和站点根路径不会标记为可用。
💾 同步与存储
reference_anything storage domain 包含:
conversations:Provider、账号作用域、远端 ID、当前 revision 和完整性状态。revisions:内容哈希、turn 数、active branch 和 chunk 清单。turn_chunks:每 50 个 turn 一个不可变 chunk。attachments:稳定 locator 和元数据,不保存临时签名 URL。sync_states:Provider cursor、Profile、进度与错误。
只有完整枚举远端分页成功后,才会把远端消失的记录标记为 remoteMissing。同步记录范围默认无限期;设置天数后,最后更新时间早于该范围的网页对话会自动从本地删除,并在后续同步中跳过。API 请求失败后才启用 DOM fallback,且 fallback 数据始终标记为 partial=true。
metadata-only 模式下,读取引用正文时会在同一次 detail 浏览器操作内校验当前登录账号与同步缓存的账号范围;账号不一致时拒绝读取。对话管理页提供“删除所有云端缺失对话”和“删除旧账号消息”,后者只清理已识别当前账号的 Provider 中属于非当前账号的本地条目。
🙏 Acknowledgements
- 文件候选与 mention 格式使用官方
@deepseek-ai/dsh-file-reference包和 DSH Remote。 - 跨会话候选与规范
dsh-session:mention 使用官方@deepseek-ai/dsh-session-reference包和 DSH Remote。 - 「本地 Agent 对话」分组所读取的记录格式,来自
Nwflower/dsh-chat-import(MIT)——对于本机没有语料可验证的那十二种格式,它的转换器就是格式文档本身。本项目未复制其代码(该项目把记录导入 DSH,本项目只在原地读取),但格式知识确实借用自它。
📄 来源与许可
本项目为 MIT。第三方代码的版权声明、许可证文本、移植来源及固定上游 commit 记录在 NOTICE.md。OpenCLI 作为 Apache-2.0 外部依赖,不被打包进本插件。
链接
同类插件
ranxianglei/billion-context★ 7682
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4419
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 724
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 369
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 317
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 279
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。