前言¶

在 DeepSeek Harness（DSH）對話中，AI 輸出常包含大量術語或難以理解的段落。通常的建議是“直接問模型”，但這要求用戶先知道要問什麼，且答案往往再次使用相同的行話。

該插件移除了這個中間步驟：選擇困惑的文本，點擊一次，即可在閱讀位置獲得通俗解釋。 無需提示工程，無需切換標籤頁，無需 API Key。

安裝¶

使用官方命令安裝插件：

dsh plugin --profile web add github:HEArtattaCK2332/dsh-text-explain

安裝後，重啓 Web 配置文件以加載新插件層。

核心功能¶

• 語境感知：選擇文本時，插件會抓取該段落所屬的整條消息作爲上下文。例如，模型能通過看到上下文理解代詞“它”的具體指代。
• 講給誰聽：提供 Plain（通俗）、General（通用）、Pro（專業）三檔解釋深度。切換深度會立即重新解釋當前問題，從生活化類比轉變爲專業術語。
• 新建爲對話：點擊“✦ 新建爲對話”後，插件會將選中文本、原消息上下文及當前對話歷史打包成交接文檔，放入新會話。新會話會回覆“背景已瞭解，等你開口”，不再生成摘要或追問。
• Markdown 渲染：支持渲染表格、鏈接、引用、代碼塊等，基於 React 手寫渲染器，自帶 XSS 防護。
• 聯網與本地讀取：提供“🌐 聯網”與“📄 讀文件”開關，允許模型調用 web_search、web_fetch、search_files 或 read_file 獲取外部信息或讀取本地文檔。

使用步驟¶

1. 在任意對話消息中選擇文本。彈出菜單會自動攜帶整條消息作爲上下文。
2. 點擊 AI 解釋 獲取解釋，或點擊 追問 對選定內容提問。
3. 閱讀流式輸出的回答。輸入後續問題按回車繼續當前線程；點擊 ✕ 關閉窗口。
4. 在彈出菜單底部切換 講給誰聽 的深度，這會立即重新解釋當前問題。
5. 在提問前，根據需要開啓 🌐 聯網 或 📄 讀文件 開關。
6. 當對話值得繼續時，點擊 ✦ 新建爲對話，將當前討論轉移至新會話。

設置與配置¶

• 配置文件位置：插件設置位於 <DSH_HOME>/text-explain/settings.json（默認 ~/.dsh）。
• 保存機制：設置頁面的點擊僅編輯草稿，必須點擊 保存 纔會將配置寫入磁盤。未保存的修改不會生效。
• 默認設置：可在設置頁配置默認解釋深度、新對話落地的工作區以及聯網/讀文件開關的初始狀態。

技術細節與生態¶

• 模型依賴：默認使用 deepseek-official 或 deepseek-v4-flash，不單獨存儲 API Key。
• 無構建步驟：依賴庫極少，無構建過程，代碼輕量。
• OpenAI 兼容協議：插件作爲後端支持 OpenAI chat-completions 協議。可作爲其他應用的後端（如 Obsidian 插件、瀏覽器擴展）。
• 瀏覽器擴展：插件同時提供了瀏覽器擴展版本，不依賴 DSH 主程序即可使用。支持三種深度檔位。

注意事項¶

• 插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
• 設置文件路徑爲 settings.json（注意後綴）。