DeepSeek Harness 插件

Chael-Chael/dsh-reference-anything

Star 数 ★ 27 下载量(近 30 天) 3,177 分类 会话与消息 收录于 2026-08-19 npm dsh-reference-anything

从 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 或更高兼容版本)。

Enter 引用会话,Tab 打开操作菜单,确认后展示模拟导入的历史;使用虚构数据。

菜单内一键升级配套插件,不用手动折腾

如果提示 dsh-chat-import 版本太旧、用不了“对话导入”或“交接摘要”,不用自己再去后台找安装包手动更新了。

直接在菜单里点击升级提示,即可一键完成更新(需升级至 0.26.3 或更高兼容版本)。升级后如果弹出重启提示,重启一下 DSH 即可生效。

在菜单中升级 dsh-chat-import,并在设置中查看模拟的重启提示。

输入 @plugin:,直接让 Agent 帮你检查本地插件

插件报错想让 Agent 帮忙排查,或者想研究某个插件的源码?以前还得自己去电脑深层目录里翻找插件的安装路径,非常劝退。

现在只需输入 @plugin:,搜索插件名称并按 Enter,就能直接把该插件的本地目录喂给 Agent(支持当前 DSH 环境中已安装的所有插件)。

在 @plugin: 菜单筛选本地插件,按 Enter 插入插件目录引用。

自定义快捷词,直接缩小搜索范围,不用手动翻找

@ 菜单里东西太多,想找历史对话时还得在一堆文件、目录和不同来源里手动翻找?

现在你可以给各个对话来源设置专属快捷词(支持设置多个,用英文逗号分隔),输入时直接按类别过滤,快速锁定搜索范围:

  • 按分类合并搜:比如忘了具体在哪聊过,可以给“本地 Agent”和“网页对话”都加上同一个快捷词(如 chat),输入 @chat: 就能把搜索范围直接缩小到这两类对话中;
  • 按来源精准搜:明确只想找某一个来源时,直接输入它的专属快捷词(比如 @codex:),即可一步到位只搜 Codex。

在设置中配置共享快捷词,再用共享词和具体来源词搜索会话。

不用死记路径,像逛文件夹一样找到目录并引用

想引用某个深层文件夹,但记不住完整路径、也不想手打?

现在 @ 文件菜单支持直接层层浏览了:

  • 进入子目录:选中文件夹后按 Tab 键;
  • 返回上一级:点击菜单顶部的导航栏;
  • 确认引用:找到目标文件夹后按 Enter,一键插入到当前对话中。

在文件菜单按 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 恢复历史引用授权,并完成针对 DSH 0.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 @。

  1. 在输入框键入 @ 浏览来源,或输入关键词,例如 @缓存设计。
  2. 用鼠标选中条目,或用方向键选择后按 Enter 插入引用。工作区文件夹按 Tab 进入,按 Enter 引用。
  3. 写下任务并发送,例如:「参考这段 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 外部依赖,不被打包进本插件。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。