在 DSH 的使用過程中，隨着會話變長，容易遺忘最初的任務目標或當前的代碼變更。dsh-session-intelligence 插件通過調用 DSH 模型，在右側欄固定顯示會話初衷、最近用戶需求摘要、運行狀態以及只讀的 Git 信息。它依賴原作者的 dsh-better-sidebar 插件，需在本地 Web 環境中運行。
核心功能¶
該插件主要提供以下維度的信息展示：
- 初衷摘要（DSH 摘要）：利用 DSH 模型總結首條包含文字的用戶消息，提取主要對象、動作和約束。
- 最近用戶需求（DSH 摘要）：總結最近一條包含文字的用戶消息。後續助手的回覆不會覆蓋此摘要。
- 主題與活動：展示最新會話標題、最近用戶消息時間、最近活動、消息數量以及成功完成的輪次數。
- 運行狀態：顯示當前運行中/空閒狀態、活躍子代理數量以及使用的 agent preset。
- Git 狀態：顯示當前分支、worktree 名稱、HEAD 提交、未提交文件列表以及相對於本地 upstream 引用的領先/落後數量。該部分爲只讀，不會執行 fetch、提交、推送、切分支或文件修改。
安裝與啓用¶
在安裝前，請確保 dsh web 服務正常運行，且已配置模型。
- 安裝依賴插件
dsh-better-sidebar。 - 安裝
dsh-session-intelligence。 - 重啓對應的 DSH Web 服務，並硬刷新頁面（Ctrl+Shift+R 或 Cmd+Shift+R）。
dsh plugin --profile web add dsh-better-sidebar@0.14.0
dsh plugin --profile web add https://github.com/leechengwei/dsh-session-intelligence/releases/download/v0.1.0/dsh-session-intelligence-0.1.0.tgz
首次進入會話時，右側欄會自動展開“會話情報”，首次摘要生成可能需要約 20 秒。若安裝了舊版 @local/dsh-client-ui-session-status，需先移除該插件再安裝本插件，否則會存在路由衝突。
使用注意事項¶
- 環境限制：插件僅面向可信用戶的本機 DSH Web。接口會檢查回環連接，不支持直接 LAN 訪問，切勿經反向代理暴露到公網。
- 隱私與費用：摘要功能會觸發輔助模型請求，複用會話配置的 provider/model，可能產生額外 token 費用。插件不將原始消息寫入側欄接口，不寫摘要磁盤緩存，不主動寫入聊天事件。
- 摘要內容：摘要不是逐字原文，也不是對整段對話進度的總結。當只有一條用戶文字消息時，初衷與最近需求共用一個摘要。摘要可能包含敏感信息，且不承諾自動脫敏或離線處理。
- 刷新機制：摘要約每 30 秒刷新一次，同時也響應窗口聚焦和會話變化。
- Git 限制：Git 文件列表最多顯示 40 條。
技術要求¶
- Node.js：最低要求爲 22。
- DSH 版本：已在 DSH
0.1.1-rc.2上驗證。 - 依賴版本：
dsh-better-sidebar必須啓用，且版本需爲0.14.x。
該插件通過 lib/index.js 作爲 DSH host 插件，lib/client.js 作爲瀏覽器模塊運行，源碼無需構建即可運行。
