GreaterClarity：DSH Web 會話增強插件

DeepSeek Harness（DSH）遵循“一切皆插件”的理念，旨在通過可插拔的方式擴展功能。dsh-greater-clarity 是一個 Web 客戶端插件，主要解決會話信息雜亂、歷史記錄難以快速定位、以及導出內容不規整的問題。它通過在會話頭部提供四個核心入口，幫助開發者更高效地管理對話上下文。

核心功能¶

1. 全局摺疊與展開¶

在會話頭部提供開關，用於控制 AI 的“思考鏈路”與“工具調用”的顯示。
* 摺疊狀態：僅保留每輪對話的最終回答文本。
* 展開狀態：顯示完整的推理過程與工具調用記錄。
* 該開關狀態會持久化保存。

2. 歷史快速定位面板¶

點擊會話頭部的“歷史”按鈕，會在按鈕正下方彈出快速定位面板。
* 功能：支持搜索與點擊跳轉，跳轉後定位到該輸入的第一行。
* 顯示：每條記錄帶有“第 N 輪”的序號徽章。
* 提示：若會話存在未加載完全的更早歷史，面板頂部會顯示“歷史未加載完全”提示。

3. 對話導出¶

提供一鍵導出當前會話爲 Markdown 的功能。
* 生成方式：採用“客戶端直出”策略，直接使用瀏覽器內存中的會話快照生成，響應極快。若快照異常，會自動回退到服務端路徑。
* 內容過濾：
* 僅導出用戶的輸入文本與 AI 的最終回答文本。
* 附件文件以文件名指代。
* 保留代碼塊、表格、列表等結構。
* 文本轉義：
* 用戶輸入：經過嚴格轉義（反斜槓、實體化、行首標記），防止 Markdown 結構注入與裸 HTML 注入。
* AI 回覆：保持原樣不轉義。
* 文件名規則：
* 格式：時間戳_會話標題.md（或 未加載完全歷史對話_時間戳_會話標題.md）。
* 時間戳格式爲點分日期（如 2026.9.15）。

4. 設置與頭像管理¶

通過設置彈窗配置插件行爲。
* 頭像展示：AI 回覆左側顯示頭像，下方附帶輪次標籤。
* 頭像自定義：支持上傳自定義頭像，調整大小（16–128px），或控制顯隱。
* 路徑白名單：上傳的頭像文件路徑必須位於 $DSH_HOME/greater-clarity/ 目錄下，外部路徑會靜默回退。

安裝¶

通過 DSH CLI 安裝到 Web Profile：

dsh plugin --profile web add github:Baisbt/dsh-GreaterClarity-plugin

使用方法¶

導出對話：點擊會話頭部的“導出”按鈕，瀏覽器會自動下載排版清晰的 Markdown 文件。
快速定位：點擊“歷史”按鈕，在彈出的面板中輸入關鍵詞搜索，或點擊列表項跳轉到對應的歷史輸入。
調整設置：點擊“設置”按鈕，上傳本地圖片作爲 AI 頭像，或調整導出按鈕的顯示狀態。

設置與數據持久化¶

插件的數據存儲在宿主目錄下：
* 設置文件：$DSH_HOME/greater-clarity/settings.json
* 頭像文件：$DSH_HOME/greater-clarity/avatar.<ext>

插件提供了三種卸載/停用粒度：
* 臨時停用：在設置彈窗中關閉“啓用 GreaterClarity”開關，刷新後保持停用狀態。
* 軟卸載：在設置彈窗底部點擊“卸載插件…”，會清空 $DSH_HOME/greater-clarity/ 目錄並寫入標記文件，跨重啓生效。
* 徹底移除：運行 dsh plugin --profile web remove @dsh-external/dsh-greater-clarity，從 Profile 組合中移除插件。

已知限制¶

導出路徑限制：受瀏覽器安全限制，導出文件僅支持默認下載目錄，無法自定義路徑。
依賴契約：插件依賴 DSH 當前的穩定契約，包括 webServer、slots、sessionQuery、DOM 屬性（如 data-chat-flow-kind、data-variant="think"）以及 Buttons 注入的 props。DSH 升級後需迴歸驗證。
轉義副作用：用戶輸入經過嚴格轉義後，導出文檔源碼中會出現 \-、\* 等序列與 < 等實體，但不影響渲染顯示。
快照依賴：客戶端直出依賴 chat.order/chat.nodes 結構，若 DSH 升級導致快照結構變更，需迴歸修復。
頭像路徑：設置中的 avatarPath 僅接受 $DSH_HOME/greater-clarity/ 目錄內的圖片。
文件名語義：僅在客戶端直出路徑下，若歷史未加載完全，文件名纔會帶有“未加載完全歷史對話”前綴；服務端兜底路徑則無此前綴。
併發模型：單頁面內 load/save 請求採用序號守衛，僅採納最新響應；多開標籤頁時採用“最後寫贏”策略。

構建與目錄結構¶

插件採用 ESM 架構，分爲 Host（服務端邏輯）與 Client（瀏覽器 UI）。

目錄結構¶

dsh-GreaterClarity-plugin/
├── src/
│   ├── index.ts          # HOST：webServer 路由 + 設置持久化
│   ├── pure/             # 雙端共享純函數（轉義、導出構建、文件名淨化）
│   └── client/           # CLIENT：樣式、DOM 層裝卸、面板組件
├── cordis.patch.yml      # 插件掛載聲明
└── scripts/build.sh      # 構建腳本

構建命令¶

# 構建 Host
bash scripts/build.sh
# 打包 Client
npm run build:client

生態背景¶

該插件由社區開發者 Baisbt 維護。DSH 的官方插件目錄位於 skillhub.cn，與 DeepSeek 或幻方無官方從屬關係。