前言¶
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