前言¶
DeepSeek Harness（dsh）是 DeepSeek AI 开源的 agent 框架，核心理念是「一切皆插件」：模型、工具、会话、沙箱和 UI 都可以替换或扩展。官方仓库目前仍处于开发者预览阶段，默认 Web UI 跑在本机 http://127.0.0.1:3080。社区里随后出现了不少插件目录，用来检索带 dsh-plugin 话题的仓库；deepseek-harness-plugin.com 就是其中之一，它是独立站点，与 DeepSeek / 幻方没有官方从属关系。
真正用起来之后，另一个问题会很快出现。Gemini、Claude、ChatGPT 和本地 Harness 各有一套对话界面，提示词散落在不同标签页里，长对话只能靠滚动找回关键回复。voyager 针对的就是这种「少了一点秩序感」的体验：它首先是面向这些聊天页面的浏览器扩展，随后又把同一份提示词库挂到 DeepSeek Harness 的网页界面上。目录页把它放在「会话与消息」分类，并标为精选。
这是什么¶
voyager 由 GitHub 用户 Nagi-ovo 维护，仓库为 Nagi-ovo/voyager，主要语言是 TypeScript，许可证 GPL-3.0。README 把它定位为 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件；提示词管理器还可以用在任意 Web UI，其中明确包括 DeepSeek Harness。
仓库 package.json 与 manifest.json 当前版本为 1.7.1。2026-08-18 打开 GitHub 仓库时星标为 19594，社区目录页显示为 19592，数量接近，以仓库页面为准。目录页记录最近一次推送为 2026-08-16，收录日期为 2026-08-17。README 同时声明：Voyager 是独立项目，与 Google、Anthropic、OpenAI 均无隶属或赞助关系。
它解决的问题可以分成两层。一层是在 Gemini 等官方聊天页上补文件夹、时间线、导出和公式复制；另一层是把同一份提示词库带到自定义站点，包括本机上的 DeepSeek Harness。
和 DeepSeek Harness 的关系¶
这一点需要先说清楚，否则目录页上的安装命令容易被理解成「装进 Cordis 运行时的原生 dsh 插件」。
仓库根目录是浏览器扩展工程：有 manifest.json、Chrome / Firefox / Safari 的 Vite 构建脚本，package.json 里没有 dsh.bundle 字段，也没有 cordis.patch.yml。GitHub 主题同时打了 browser-extension、dsh 和 dsh-plugin。官方文档单独写了一页 DeepSeek Harness，说明对接方式是：先把 Harness 的 Web UI 跑起来，再在扩展弹窗里为 localhost:3080 打开提示词管理器。
因此，voyager 出现在 DSH 社区目录里，依据是它能给 Harness 网页补提示词库，而不是它向 agent 注册了新的工具或技能。目录页给出的命令仍应照原文记录；是否能作为 Cordis 原生插件被 dsh 加载，需要你自己看源码，本文未做安装验证。实际可用、且有官方步骤的路径，是安装浏览器扩展，再按文档把提示词管理器接到 DSH 页面。
核心功能¶
下面按官方 README 与中文文档已经写明的能力来划分。不同站点能用到的功能并不相同。
Gemini 与 AI Studio 共用¶
- 文件夹管理：把对话拖进目录，支持多级结构和拖拽排序；Gemini 上还有账号隔离模式和自定义文件夹颜色。中文文档还写了多选、改名、按 Gem 类型配图标，以及可选的 Google Drive 同步。
- 提示词库：保存、打标签、搜索，并在 Gemini、AI Studio 和自定义网站之间复用。
- 云同步：文件夹和提示词可通过 Google Drive 同步；Safari 还支持 iCloud。这是用户主动开启的功能，不是默认上传。
- 批量删除：一次清理多条对话。
- 公式复制：一键复制 LaTeX 和 MathML（Word）源码。
- 视觉特效：在扩展设置里切换飘雪、电影感雨滴或樱花，效果是全屏覆盖层，不拦截页面点击。
Gemini 专属¶
- 时间线导航：把每条消息映射成侧边节点，可跳转、星标，并管理对话分支。官方文档写明时间线是 Gemini 专属，AI Studio 上没有。
- 对话导出：导出为 JSON、Markdown 或带图片的 PDF。
- Mermaid 渲染：自动渲染流程图、时序图等。
- Markdown 渲染修复：处理 Gemini 注入 HTML 导致的加粗失效。
- Image Refinement：去除 Gemini 生成图片上的无损水印。README 注明该能力改编自开源项目，第三方 MIT 声明保留在
THIRD_PARTY_NOTICES.md。 - Deep Research：提取 Deep Research 对话里的思考过程和研究链接。
- 效率工具：引用回复、拦截发送后强制滚到底部、输入框折叠、为新对话设默认模型、隐藏侧边栏「最近」列表。
README 还提到一件项目方自己记录的事：2026 年 2 月 18 日 Gemini App 曾出现历史对话无法访问的情况，当时 Voyager 用户仍能在文件夹里看到自己保存过的会话。这是仓库自述，不是第三方评测。
Claude 与 ChatGPT¶
这部分由 Voyager 自己的 Plugin Engine 提供，能力比 Gemini 侧少：
- Claude 时间线：侧边栏、星标消息和搜索。
- Claude 用量条：在界面里看会话用量和每周用量。
- 公式复制（与 Gemini 共用同一套）。
- 舒适阅读宽度：可调 Claude 和 ChatGPT 的对话宽度。
- CJK 渲染修复：处理 Claude 上的中日韩字符显示问题。
任意站点，包括 localhost¶
提示词管理器不绑定固定域名。在扩展弹窗里添加网站并授权后，目标页刷新即可出现浮窗。文档给出的例子包括 chatgpt.com、claude.ai，以及 localhost:3080 / 127.0.0.1:3080。官方文档反复强调：自定义站点上只加载提示词管理器，时间线、文件夹不会启动。
企业版 Gemini 也有同样限制：README 写明 Prompt Manager 是目前唯一支持 Gemini for Enterprise 的功能。
安装与启用¶
目录页上的 dsh 命令¶
社区目录页给出的安装命令原文如下，在 DeepSeek Harness 终端中复制即可：
dsh plugin add github:Nagi-ovo/voyager
目录页同时提示：如需可复现安装，可固定 commit 哈希：
dsh plugin add github:Nagi-ovo/voyager#<commit>
请把 <commit> 换成仓库里真实的提交哈希，不要留空。插件会以当前 dsh 进程的权限运行，安装时可能执行代码；装之前应检查源码和许可证。如前一节所述，这条命令对应的是目录页的通用安装入口，voyager 仓库本身是浏览器扩展。要用提示词库对接 Harness，请继续看下面的官方步骤。
按官方文档安装浏览器扩展¶
文档推荐走扩展商店，更新由商店处理。当前文档列出的渠道包括：
- Chrome / Edge / Brave / Opera / Vivaldi：Chrome Web Store（扩展 ID：
iifacdnjakkhjjiengaffnegbndgingi） - Microsoft Edge：Edge Add-ons
- Firefox：AMO（附加组件 ID 为
gemini-voyager@nagi-ovo） - Safari：下载预签名的
Voyager.app，在「Safari 设置 > 扩展」中启用
商店审核慢时，可以从 GitHub Releases 下载 voyager-chrome-vX.Y.Z.zip 或 voyager-firefox-vX.Y.Z.xpi，再按开发者模式加载。README 写明商店状态为 Chrome、Firefox、Safari、Edge 均可安装。
从源码构建时，仓库推荐用 Bun：
bun i
bun run build:chrome # Chrome
bun run build:firefox # Firefox
bun run build:safari # Safari，需 macOS
开发模式对应 bun run dev:chrome、dev:firefox、dev:safari。这些命令来自 README，面向要改源码的人，日常使用不必走这条路。
接到 DeepSeek Harness 网页¶
官方文档给出的步骤如下。
- 先把 DSH 跑起来。文档示例为：
npm i -g @deepseek-ai/dsh
dsh web
DeepSeek Harness 官方仓库另外提供了不全局安装的写法：安装 Node.js 后执行 npx @deepseek-ai/dsh web，默认地址同样是 http://127.0.0.1:3080。两种方式选一种即可。然后用浏览器打开该地址。
-
停留在 DSH 页面时，点击浏览器工具栏里的 Voyager 图标。弹窗顶部会出现「在 localhost:3080 上开启提示词管理器」一类开关，打开并授予访问权限。文档写明此时不用手打地址。
-
刷新页面。右下角会出现提示词管理器浮窗。
文档也允许手动添加：在弹窗的提示词管理器一节输入 localhost:3080 或 127.0.0.1:3080，点「添加网站」，授权后再刷新。
典型用法¶
同一份提示词库¶
文档的核心用法不是给 DSH 单独再建一个库，而是共用一份。Gemini、Claude、ChatGPT 上存过的提示词，打开 Harness 仍然在；在 DSH 里新建的条目，回到 Gemini 也能搜到。标签、收藏和搜索是同一套数据。
隐私文档（更新于 2026-07-17）写明：Voyager 以本地处理为主，不运营用于接收对话或提示词的后端；数据默认放在 chrome.storage.local，可选同步才走 Google Drive 或 Safari iCloud。DSH 指南据此写了「DSH 在本地，Voyager 的库也在本地」。一旦开启云同步，备份会进入你自己的网盘账户，这和「整条链路不出门」不是同一回事。
捕获、归类、调用¶
提示词文档里的操作顺序是：
- 写出可用的 Prompt 后，点输入框旁的浮窗图标存入库中。
- 加上
#代码、#邮件、#学术这类标签。 - 下次打开库，按标签搜索，一点插入。
添加或编辑时需要填写备注名，作为短标题。紧凑列表是默认视图；悬停约 250 毫秒可预览全文。对话输入框里输入 / 再打备注名的一部分，可用鼠标、Tab 或 Enter 选中，发送时替换成完整正文。
自定义其他本地 UI¶
DSH 指南末尾写明：同一办法适用于 Open WebUI、LibreChat 或自己写的本地页面——填地址、授权、刷新。端口如果以后不是 3080，按新端口再加一次即可。文档解释原因是 DSH 仍在开发者预览，默认端口可能变化。
适用场景与注意事项¶
比较适合下面几类用法：
- 同时使用 Gemini / Claude / ChatGPT，又要把提示词带到本机 DeepSeek Harness Web UI。
- 在 Gemini 上需要文件夹、时间线、导出、公式和 Mermaid，而不是只改一处样式。
- 在 Claude 上需要时间线、用量条或中日韩字符修复。
使用前有几条边界需要记住：
- 自定义站点（含 DSH）只有提示词库。 不要预期在
localhost:3080上看到 Gemini 那套文件夹和时间线。 - 它首先是浏览器扩展。 目录页的
dsh plugin add不能替代扩展商店或手动加载；仓库也没有作为 Cordis 插件的清单文件。 - 权限与许可证。 扩展会申请
storage、identity、scripting、activeTab等权限；可选主机权限在你添加自定义网站时才会要。许可证是 GPL-3.0，二次分发需要遵守该协议。目录页对所有条目都有同一句警告：插件以当前 dsh 进程权限运行，安装前应检查源代码仓库和许可证。 - 商标与归属。 Gemini、Claude、ChatGPT 是各自公司的商标。Voyager 与 DeepSeek Harness 官方仓库、社区插件目录都是不同主体。
- 不要和同名 fork 混用。 README 的生态一节列出了面向 DeepSeek 网页版 的 fork，例如 DeepSeek Voyager、DeepSeek Enhancer。那些项目服务的是 chat.deepseek.com 一类页面，不是 Harness 的
localhost:3080。
小结¶
voyager 把分散在多个 AI 聊天页上的提示词收成一份本地库，并允许这份库出现在 DeepSeek Harness 的网页界面里。Gemini 一侧还有文件夹、时间线、导出等完整工具；接到 DSH 时，官方文档只承诺提示词管理器。社区目录把它归入「会话与消息」并给出 dsh plugin add github:Nagi-ovo/voyager，但日常使用仍应按仓库文档安装浏览器扩展，再在 localhost:3080 上打开开关。
- 社区目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/voyager/
- GitHub 仓库：https://github.com/Nagi-ovo/voyager
- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
