前言¶
在 DSH 主會話裏跑智能體時，常見兩類打斷：一是想針對某段對話追問，卻得切出去另開窗口或手動複製粘貼；二是智能體彈出「問題彈框」等你作答，整條流程會停在原地。Codex 式側邊聊天解決了前者——在主會話旁開一個繼承配置的獨立聊天，再把結果帶回。heartmove 維護的 dsh-side-chat 在此基礎上，把問題彈框也納入側邊聊天，讓你先想清楚再回答，主會話不必中斷。
這是什麼¶
dsh-side-chat（heartmove/dsh-side-chat）是一個 DSH 網頁端（web profile） 客戶端插件，當前版本 0.2.0，許可證 MIT。它在右側面板提供按主會話隔離的獨立聊天：每個側邊聊天是隱藏的普通 DSH 會話（通過 meta.parentSession 關聯主會話並歸檔，不出現在主會話列表），繼承主會話的工具集、模型、思考難度與權限預設，能感知工作目錄。選中對話內容即可提問，AI 回覆可帶回主會話；當主會話彈出問題彈框時，問題和選項會自動列在側邊面板，可帶入側邊聊天分析後再把答案帶回。
插件信息可在 SkillHub 目錄頁 與 GitHub 倉庫 查閱。SkillHub 是獨立的 DSH 插件社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
選中內容 → 側邊提問¶
選中任意消息文本後，浮出「在側邊聊天中提問」按鈕；若當前會話已有側邊聊天，還會出現「繼續在激活的側邊聊天中提問」。選中的內容自動帶入右側面板輸入框。
繼承主會話配置，可按聊天獨立調整¶
側邊聊天默認繼承主會話的工具集、模型、思考難度、權限預設與工作目錄，可像主會話一樣作用於同一工作區。二級模型菜單（服務商 → 模型 → 思考難度）與權限菜單從主會話復刻，每個側邊聊天可單獨調整。另有「需要時從工作區 / 主會話查信息」開關（默認關閉），開啓後可在需要時讀取工作區文件與主會話記錄。
AI 回覆帶回主會話¶
側邊聊天裏的每條 AI 回覆均可帶回當前主會話（不會立即發送）：
- 鼠標選中回覆片段，在浮出菜單中選擇「直接帶回」或「摘要後帶回」。
- 每條回覆正文下方有「直接帶回」「摘要後帶回」按鈕，一鍵帶回整段或其摘要。
「摘要後帶回」使用側邊聊天繼承的模型先生成摘要再帶回。落地方式可在設置中選擇：寫入輸入框草稿（draft），或注入爲摺疊提示行（context，作爲上下文、不寫草稿、不發送）。
問題彈框不打斷流程¶
主會話彈出「問題彈框」時，側邊面板自動列出問題和各個選項，無需手動選中文字。每個問題可「帶入全部」，每個選項可「帶入」，均支持繼續已有側邊聊天或新建側邊聊天。列表可摺疊 / 展開，可刪除單個或全部（刪除後不再出現）。主會話靜靜等待彈框回答，流程不被打斷。
面板與其他能力¶
- 拖拽左邊緣調整寬度（280–720 px），寬度自動鉗制在窗口約 40% 以內，窗口尺寸變化時重新適配，寬度跨刷新記憶。
- 可收起 / 展開，無關閉按鈕。
- Markdown 回覆、思考過程展示、圖片附件（粘貼 / 拖拽）、發送 / 停止、思考時長顯示，複用主會話同款 UI。
- 側邊聊天列表支持單條刪除與「刪除全部」。
- 界面跟隨 DSH 語言設置（中文 / 英文）。
安裝與啓用¶
環境要求¶
- Node.js ≥ 20
- pnpm
- DSH ≥
0.1.0-rc.6
從 GitHub 安裝¶
官方安裝命令如下：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:heartmove/dsh-side-chat
dsh plugin 將命令轉發到 ~/.dsh/profiles/web/ 下的 pnpm，並把 bundle 對賬進 profile 的 dsh.profile.bundles 層列表。git 安裝拉取源碼後，pnpm 會運行包的 prepare 腳本（tsdown）從 src/ 構建 lib/。
pnpm ≥ 10 首次 add 可能因未白名單 prepare 腳本而失敗，提示「Ignored build scripts」。將 pnpm 打印的包名鍵寫入 ~/.dsh/profiles/web/pnpm-workspace.yaml：
allowBuilds:
dsh-side-chat: true
然後重新執行 add。該白名單表示允許該包在安裝時於本機運行代碼——只放行你信任源碼的包，並建議固定 commit（github:heartmove/dsh-side-chat#<sha>），避免後續推送悄悄改變實際運行的代碼。
安裝完成後重啓 dsh web，在瀏覽器中強制刷新（Ctrl/Cmd+Shift+R）。
從本地 checkout 安裝¶
在包含項目 checkout 的目錄下執行：
npx -p @deepseek-ai/dsh dsh plugin --profile web add ./dsh-side-chat
典型用法¶
選中內容提問¶
- 在主對話中選中某條消息的部分文本。
- 點擊浮出的「在側邊聊天中提問」，或選擇「繼續在激活的側邊聊天中提問」。
- 右側面板打開（或展開），選中文本已帶入輸入框。
- 按需調整模型 / 思考難度、權限，以及「需要時從工作區 / 主會話查信息」開關。
- 發送。回覆流式返回，帶 Markdown 渲染，需要時顯示「思考」摺疊行。
- 拖動面板左邊緣調整寬度，或使用收起 / 展開控件。
默認 sendImmediately 開啓時，選中內容會立即發送，並附加設置的默認提示詞。在設置裏關閉後，選中內容先作爲附件放入輸入框，由你確認編輯後再發送。
帶回主會話¶
- 在側邊聊天中選中 AI 回覆片段，選擇「直接帶回」或「摘要後帶回」；或點擊回覆下方的兩個按鈕一鍵帶回整段。
- 根據
bringMode設置，內容追加進主會話輸入框草稿，或注入爲摺疊提示行。
針對問題彈框¶
- 主會話彈出問題彈框時，面板關閉狀態下彈框標題旁會出現浮動入口，點擊打開面板。
- 對每個問題「帶入全部」，或對每個選項「帶入」，選擇繼續已有或新建側邊聊天。
- 在側邊聊天中讓 AI 分析，把答案帶回主會話，再回答彈框。
設置項¶
打開 DSH 設置 → 側邊聊天（Side chat）：
| 設置項 | 默認值 | 說明 |
|---|---|---|
lookupDefault |
關 | 新建側邊聊天時「需要時從工作區 / 主會話查信息」是否默認開啓 |
sendImmediately |
開 | 選中內容後立即發送，還是先作爲附件放入輸入框 |
defaultPrompt |
空 | sendImmediately 開啓時附加在選中內容後的提示詞 |
bringMode |
draft |
帶回方式：draft 寫入草稿，context 注入摺疊提示行 |
偏好保存在 DSH 設置命名空間 dsh-side-chat 下。
適用場景與注意¶
適合誰： 經常在 DSH 主會話中跑智能體、需要旁路追問對話片段或問題彈框選項的開發者。難任務可把側邊聊天切到更強模型，不影響主會話配置。
安全注意： 插件以當前 dsh 進程的權限運行。git 安裝會拉取源碼並在本機執行 prepare 構建腳本；allowBuilds 白名單即允許該代碼在安裝時運行。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，只安裝你信任的包，並建議固定 commit。
侷限： 僅適用於 DSH web profile，需 DSH ≥ 0.1.0-rc.6。側邊聊天是隱藏會話，依賴 meta.parentSession 與歸檔機制，與主會話列表隔離。
結尾¶
dsh-side-chat 把 Codex 式側邊聊天與問題彈框答疑合在一起：繼承主會話的智能體能力，選中即問、分析完再帶回，主流程不必爲追問或彈框作答而中斷。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。
