前言¶
在 DSH 裏讀模型回答時，遇到術語或公式片段，常見做法是再發一條「這個詞什麼意思」——追問會進入會話日誌、佔用主對話上下文，上下文一長還要往上翻。另一種做法是在外部查資料，但會打斷閱讀節奏。
下面介紹社區插件 dsh-explain-selection（維護者 KLAX54ix，分類：客戶端）：在回答正文裏選中文字，右鍵「解釋」，貼着選區彈出講解卡片；卡片內可繼續選中或點擊術語追問，支持拖拽、指向線與多級嵌套。解釋由宿主通過 ctx.llm 流式生成，不寫進會話日誌、不進入主對話上下文。
這是什麼¶
dsh-explain-selection 是 DeepSeek Harness（DSH）的客戶端插件，當前版本 0.1.1，MIT 許可證。源碼倉庫：https://github.com/KLAX54ix/dsh-explain-selection；社區目錄頁：https://www.skillhub.cn/plugins/KLAX54ix/dsh-explain-selection。
它解決的核心問題是：就地消歧術語，又不把解釋問答當成對話消息。卡片浮在回答上方，切換會話或項目時卡片與進行中的請求一併銷燬；答案緩存僅在內存中，刷新或重啓即失效。
核心功能¶
選中解釋與嵌套追問¶
- 在回答裏選中文字 → 右鍵 → 解釋，卡片貼着選區彈出。
- 解釋裏帶虛線下劃線的術語可點擊，在旁邊開新卡片；也可在卡片正文裏任意選中再解釋，層數不限。
- 每張卡片底部可有淺灰小字，例如
已帶上下文（上下文 172 字）或已帶上下文（父術語「磁化率」+ 上下文 68 字），表示本次解釋實際帶上的消歧信息。
頂層解釋會帶選區前後各 120 字；在卡片裏追問時帶父卡片那段解釋 + 父術語。答案約束爲兩句話以內、最多 80 字；同一句話裏同一詞重複解釋時使用內存緩存，不發請求。
卡片交互¶
| 動作 | 操作 |
|---|---|
| 複製 | 右鍵菜單中的 複製 |
| 移動 | 抓住頭部左側 ⣿ 手柄拖動；拖走後頭部出現 ⤺ 可歸位，或雙擊手柄 |
| 指向線 | 拖動過程中有淡虛線從卡片指回所解釋的文字 |
| 滾動頁面 | 按住卡片不放時滾輪仍可滾動對話 |
| 收起 / 展開 | 頭部 – 收成貼着原文的小膠囊；點膠囊展開 |
| 關閉 | 頭部 ×；關閉父卡片時子卡片一起關閉 |
| 關閉右鍵菜單 | Esc、點擊別處、滾動、縮放窗口 |
頁面滾動或縮放時，未拖走的卡片跟着原文走；被拖走（停靠）的卡片停在用戶放置的位置。收起父卡片時子卡片一起隱藏；展開後回到原位。
與主對話的關係¶
- 解釋不進會話日誌：宿主半體在自有路由裏直接調用模型，不經過 agent loop。
- 不使用默認會話的模型切換邏輯時，插件使用當前默認模型（README 已知限制）。
- 選區跨詞邊界時，插件會說明這不是一個詞、原本屬於哪個詞，不會編造含義。
性能與實現要點¶
插件會查詢模型支持的推理強度檔位並取最便宜的一檔（通常爲 off），避免 DeepSeek 適配器默認 high 推理佔滿 max_tokens 導致卡片截斷；選中文本上限 400 字，輸出上限 256 token。客戶端文案目前硬編碼中文，未接 ctx.locale。
安裝與啓用¶
命令行安裝（非 Desktop 獨佔 profile 時）：
dsh plugin add github:KLAX54ix/dsh-explain-selection
DSH Desktop：desktop profile 由 Electron 應用管理，命令行添加會被拒絕。請在應用內 設置 → 插件 → 添加插件，填寫：
github:KLAX54ix/dsh-explain-selection
安裝後重啓一次應用：index.js 爲宿主半體，僅在啓動時加載；client.js 會自動熱加載。
插件以當前 DSH 進程權限運行，安裝前建議閱讀倉庫源碼與 MIT 許可證。本插件在 DSH developer preview（README 提及 0.2.0-rc.2）期間開發，官方可能有破壞性變更，升級後若失效可在 GitHub 提 issue。
典型用法¶
- 打開一條包含專業術語的回答。
- 選中不懂的詞（例如「臨界指數」）→ 右鍵 → 解釋，等待流式完成（界面可能顯示
正在解釋…）。 - 在卡片內繼續選「磁化率」「冪律」等，或點擊帶虛線下劃線的術語，逐層追問；全程主對話列表不應新增解釋類消息。
- 需要調整位置時拖動手柄；閱讀長回答時可收起卡片爲膠囊，或關閉
×結束本條解釋鏈。
術語是否可點擊，取決於模型是否按約定輸出 [[術語]] 標記；無標記時仍可用「選中 + 右鍵」嵌套。插件未做整段批量解釋；緩存不持久化。
適用場景與注意¶
適合：在 DSH 客戶端/Web 端閱讀長回答、需要快速消歧名詞或公式片段，且希望主對話保持「只有原任務消息」的開發者或重度用戶。
注意：
- 解釋依賴當前默認模型與網絡，線索不足時模型會承認不確定。
- 切換項目或會話後卡片不保留。
- 社區目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本插件爲社區維護的客戶端擴展。
結尾¶
dsh-explain-selection 把「選中 → 解釋 → 卡片內追問」做成不寫入主對話上下文的閱讀輔助，適合在 DSH 裏啃技術回答時使用。目錄頁：https://www.skillhub.cn/plugins/KLAX54ix/dsh-explain-selection；源碼與完整說明：https://github.com/KLAX54ix/dsh-explain-selection。
