Voyager「引用回覆」功能全解析一鍵將選中文字轉為 Markdown 引用精準追問與糾錯【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager「引用回覆Quote Reply」是 Voyager 為 Gemini 等 AI 對話頁面打造的精準追問利器無需手動複製文字、手打符號只要用滑鼠選中對話中的任意段落點擊懸浮的引用按鈕文字便會以標準 Markdown 引用格式自動插入輸入框。本篇指南將完整講解該功能的三步操作流程、三大核心特性與實戰技巧並深入 src/pages/content/quoteReply/index.ts 等原始碼剖析上下文感知判定、多行引用格式化、LaTeX 公式保留、空輸入偵測與插入策略等底層實現讓你能夠知其然更知其所以然並掌握它的開關設定與可驗證的測試依據。示意圖原圖見 docs/public/assets/quote-reply.png功能介紹選中即引一鍵插入在日常對話中我們經常需要針對 AI 輸出中的某一段具體內容進行追問或反駁。傳統的做法是複製那段話然後在輸入框裡手打符號非常繁瑣。Voyager 將整個流程簡化為三步選中即引在對話頁面無論是你的提問還是 Gemini 的回答中用滑鼠選中任意一段文字。懸浮按鈕選中文字附近會自動浮現一個「引用回覆」按鈕。一鍵插入點擊按鈕選中的文字會自動以標準的 Markdown 引用格式 內容插入到你的輸入框中。插入完成後游標會停留在引用內容之後你可以緊接著輸入追問或修正的內容按下送出即可。從原始碼看handleQuoteClick 是整個流程的核心入口它先從當前選區提取文字再定位輸入框findChatInput完成格式化與插入。插入還考慮了「輸入框摺疊」功能——如果輸入區被摺疊會先呼叫 expandInputCollapseIfNeeded 展開測試用例expands input collapse when using quote reply也明確驗證了這一行為。特性一上下文感知避免誤觸發Voyager 會智能識別對話內容避免在無關區域如輸入框本身、側邊欄、導覽列誤觸發引用按鈕。從 handleSelectionChange 的實現可以看到一系列精細的守衛條件只在主內容區生效若選區所在的元素不在頁面main容器內直接隱藏按鈕排除導覽列、側邊欄等干擾。顯式排除 UI 區域nav、[rolenavigation]、.sidebar、.mat-drawer等元素內的選區一律不觸發。排除輸入框本身選區若落在[contenteditabletrue]內即輸入框不會彈出按鈕避免在打字過程中被誤打擾。僅限對話輪次選區必須落在QUOTEABLE_MESSAGE_SELECTOR.conversation-container與使用者/模型輪次的選取器集合定義於 index.ts之內同時要求選區的共同祖先也在其中防止選區橫跨對話與非對話元素。排除新對話歡迎語Gemini 新對話頁面的歡迎問候語greeting與提示建議雖然也在main內但並非真正的訊息輪次不會觸發引用。對應測試does not show Quote Reply for Gemini new-chat greeting text與does not show Quote Reply for a selection spanning message and greeting在 quoteReply.test.ts 中給出了完整覆蓋。此外選區的偵測採用250ms 防抖SELECTION_DEBOUNCE_MS並同時監聽mouseup與keyup支援鍵盤選取避免拖曳選取過程中頻繁觸發重繪。特性二標準 Markdown 格式Gemini 完美理解引用按鈕使用通用的 Markdown 語法Gemini 可以完美理解這種引用結構從而做出更精準的回應。格式化邏輯位於 handleQuoteClickconst quoteBody selectedText .split(\n) .map((line) ${line}) .join(\n);也就是每一行前面都加上前綴。除了純文字還有兩個值得關注的細節多行支持如果選中了多行文本Voyager 會自動為每一行添加引用符號保持格式整潔測試preserves inline math等用例亦驗證多行結構下內容不失真。LaTeX 公式保留Gemini 對話中的數學公式是以視覺渲染形式呈現的直接取選區文字會遺失 LaTeX 分隔符。Voyager 透過 extractTextWithLatex 將選區內部的.math-inline、.math-block與[data-math]元素替換回$...$/$$...$$原始語法後再取文字因此引用帶有公式的內容時會得到可再度提交的 LaTeX 源碼例如測試中驗證的$U \in [0, 1)$、$$E mc^2$$與獨立的$x^2$。特性三智能輸入框處理與 IME 友好插入「一鍵插入」並非簡單地往輸入框塞字串原始碼針對 Gemini 基於 Quill 的 contenteditable 富文字輸入框與傳統textarea做了兩套路徑並處理了大量邊界情況空輸入判定透過 isChatInputEmpty 判斷輸入框是否為空。它會把ql-blank視為空編輯器的標準標記但若innerText中已有「非 placeholder 的真實文字」即使ql-blank類別因 DOM 更新滯後仍存在也會正確判定為非空。測試treats ql-blank editor as empty even if placeholder text exists與treats stale ql-blank with real user text as non-empty分別驗證了兩種情形。分隔規則引用內容與既有文字之間會自動插入空行——輸入框為空時不加前綴非空時加入\n\n避免引用與正文黏連測試adds a blank line when input has visible text驗證結果為Existing\n\n Hello\n。Firefox 特例由於 Firefox 的 Quill contenteditable 對雙換行會渲染出額外的視覺空行getContenteditableQuoteSeparator 在 Firefox 下改用單換行\n作為分隔測試uses single-line separator for Firefox contenteditable給出確切證據。execCommand 與 Range 雙保險優先使用document.execCommand(insertText)對 Quill 最友好若命令不可用或部分變更則回退到 Range 手動插入文本節點並把游標移動到插入內容之後。測試對「分隔符完全插入」「分隔符插入但內容未變」「僅視覺換行生效」等多種組合都有覆蓋。IME 友好插入時以focusChatInput盡量最小化焦點切換避免輸入框失焦測試does not blur or refocus the contenteditable input after quote insertion驗證了插入後輸入框仍保持焦點讓中文等 IME 輸入法可以在下一次按鍵時立即開始組字。使用技巧追問細節選中 Gemini 回答中不清楚的某個概念點擊引用然後輸入「請詳細解釋一下這個概念」。糾正錯誤選中回答中錯誤的程式碼或事實引用後指出「這裡不對應該是...」。值得一提的是引用送出後Voyager 還會對已發送的引用區塊與輸入框內的引用行進行視覺修飾。renderedQuotes.ts 會將連續的引用行包裝成blockquote classgv-rendered-quote樣式並在輸入框中為引用行標記gv-composer-quote-line等類別整個過程以MutationObserver監聽 DOM 變化80ms 防抖清理時會完整還原原始 DOM測試restores the original DOM on cleanup驗證。這些樣式規則位於 public/contentStyle.css使用--gv-pm-brand主題變數與border-inline-start等邏輯屬性能同時適配深色/淺色主題與 RTL 版面。設定與開關引用回覆預設開啟可透過彈出面板Popup中的「啟用引用回覆」開關控制對應設定項定義如下儲存鍵gvQuoteReplyEnabled常數StorageKeys.QUOTE_REPLY_ENABLED見 src/core/types/common.ts。預設值true在內容腳本初始化src/pages/content/index.tsx與設定備份服務src/core/services/SettingsBackupService.ts中均可確認。設定介面彈出面板的通用設定卡片透過quote-reply-enabled開關列控制見 src/pages/popup/components/GeneralSettingsCard.tsx其狀態由useGeneralPopupSettings讀寫。與高亮功能共用工具列引用與「高亮標記」共用同一個懸浮選取工具列與選區監聽器避免兩個浮動控制互相競爭關閉引用後工具列仍可用於高亮操作測試uses the same selection toolbar for Highlight when Quote Reply is disabled驗證了僅有一個.gv-selection-toolbar且引用按鈕隱藏、高亮按鈕可見。結語Voyager 的「引用回覆」看似只是「選中 → 點擊 → 插入」三步但底層卻是一套嚴謹的工程實現從上下文感知的選區過濾到逐行格式化的多行支援再到 Quill contenteditable、Firefox 換行差異、LaTeX 公式還原與 IME 焦點保護等細節無一不為了讓「精準追問」這件事又快又準。結合 quoteReply.test.ts 與 renderedQuotes.test.ts 兩份測試套件你可以完整追蹤這條功能鏈路的每一環節甚至以此為範本理解 Voyager 其他對話增強功能如高亮、輸入摺疊的設計風格。【免费下载链接】voyagerEnhancement suite for Gemini, AI Studio, Claude ChatGPT — plus a prompt manager for any websites, DeepSeek Harness included. / 面向 Gemini、AI Studio、Claude 与 ChatGPT 的增强套件其中的提示词管理器可用于任意网站如 DeepSeek Harness。项目地址: https://gitcode.com/gh_mirrors/ge/voyager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考