前言¶

DSH（DeepSeek Harness）的擴展思路是「一切皆插件」。對 Web 客戶端的使用來說，長對話中的提問回溯、內容列寬度調整、Markdown 標題定位，都屬於會影響閱讀效率的細節問題。dsh-chat-tools 是 DSH Web 客戶端插件，package.json 中顯示版本爲 0.1.0，許可證爲 MIT，倉庫路徑爲 Free-corner/dsh-chat-tools，可作爲維護線索。它在右上角增加寬度與位置控件、提問歷史菜單，並在對話區與文件預覽區提供 Markdown 大綱橫條。下面介紹它的功能、安裝方式和典型用法。

這是什麼¶

dsh-chat-tools 是一個 Web 客戶端插件。package.json 中 dsh.client.platform 爲 web，dsh.bundle.patch 爲 ./cordis.patch.yml。它主要提供三類能力：

• 對話內容列寬度按百分比調節，並支持居中或靠左顯示。
• 提問歷史帶序號、按對話順序排列，並支持按鈕或快捷鍵跳轉。
• 對 Markdown 標題生成大綱橫條，覆蓋對話區和 better-sidebar 等文件預覽區。

核心功能¶

對話列寬度與位置¶

在右上角可以做兩個調整：

• 寬度：使用滑塊按百分比調節對話內容列寬度。0% 爲默認寬度，100% 爲佔滿內容區且避開左側大綱區。
• 位置：選擇內容居中或靠左顯示。靠左時自動避開左側大綱區，不會相互覆蓋。

這些設置會自動保存到瀏覽器本地。

提問歷史¶

提問歷史位於右上角「提問歷史」下拉菜單。已覈實的能力包括：

• 每個提問帶序號，按對話順序排列，最新提問在底部。
• 打開菜單時自動定位到最新提問。
• 頂部提供 ↑ 上一個 / ↓ 下一個 按鈕，也可以使用快捷鍵 Ctrl+↑ / Ctrl+↓ 在提問間跳轉。
• 點擊任意歷史條目，會跳轉到對話中的對應位置。
• 菜單左邊緣可拖拽調整寬度，底邊緣可拖拽調整高度；設置會持久化。
• 提問記錄按會話持久化保存，服務重啓後仍在；跨會話按會話 ID 分別保存。
• 早期內容未加載時顯示爲「未加載」。點擊後會分頁加載更早內容，並跳轉到對應位置；資料提到有上限保護，不會拖垮瀏覽器。

Markdown 大綱目錄¶

當內容包含 Markdown 標題時，插件會用大綱橫條展示結構：

• 針對當前回答的 #~###### 標題生成橫條，橫條長度隨標題層級遞減。
• 鼠標移入大綱橫條區域時彈出完整大綱。
• 點擊大綱條目會跳轉到對應標題。
• 在 better-sidebar 等文件預覽的 Markdown 渲染中，大綱橫條顯示在預覽區右邊緣，功能相同。
• 大綱橫條僅在內容包含標題時顯示；無標題內容不打擾。

安裝與啓用¶

手動安裝¶

資料將插件市場安裝狀態標註爲「待收錄」，因此這裏給出手動安裝方式。先執行：

dsh plugin --profile web add dsh-chat-tools

這一步會把 dsh-chat-tools 加入 web profile。

然後在 cordis.patch.yml 中加入：

- insert:
    - id: dsh-chat-tools
      name: 'dsh-chat-tools'

這段配置用於聲明插件條目。

最後重啓 dsh web 生效。

本地開發安裝¶

如果需要在本地開發環境中使用，執行：

pnpm add "file:/path/to/dsh-chat-tools"

之後同樣在 cordis.patch.yml 中加入上面的 dsh-chat-tools 配置，並重啓 dsh web。

典型用法¶

調節對話列¶

1、打開 DSH Web 客戶端。
2、在右上角使用寬度滑塊按百分比調節對話內容列寬度。0% 爲默認寬度，100% 爲佔滿內容區且避開左側大綱區。
3、使用位置選項選擇內容居中或靠左顯示；靠左時自動避開左側大綱區。

瀏覽提問歷史¶

1、打開右上角「提問歷史」下拉菜單。
2、查看帶序號的提問列表，列表按對話順序排列，最新提問在底部。
3、打開菜單後會自動定位到最新提問。
4、使用頂部 ↑ 上一個 / ↓ 下一個 按鈕，或快捷鍵 Ctrl+↑ / Ctrl+↓ 在提問間跳轉。
5、點擊任意歷史條目，跳轉到對話中的對應位置。
6、拖拽菜單左邊緣調整寬度，拖拽底邊緣調整高度；設置會持久化。

使用 Markdown 大綱¶

1、當回答包含 Markdown 標題時，查看對話區中的大綱橫條。
2、鼠標移入大綱橫條區域，彈出完整大綱。
3、點擊大綱條目，跳轉到對應標題。
4、在 better-sidebar 等文件預覽中查看 Markdown 文件時，大綱橫條顯示在預覽區右邊緣，操作方式相同。

適用場景與注意¶

比較適合以下使用方式：

• 使用 DSH Web 客戶端處理較長對話。
• 需要頻繁回溯某一次提問的位置。
• 在文件預覽中瀏覽 Markdown 標題結構。
• 習慣用序號和快捷鍵完成導航。

使用前注意：

• 插件市場狀態在資料中標註爲「待收錄」，本文不展開市場一鍵安裝步驟。
• 手動安裝或本地開發安裝後，都需要重啓 dsh web 生效。
• 寬度、位置、菜單尺寸等設置自動保存到瀏覽器本地。
• 提問歷史按會話 ID 分別保存；早期內容未加載時顯示爲「未加載」，點擊後分頁加載，並帶有上限保護。
• 大綱橫條只在內容包含 Markdown 標題時顯示。
• 插件會運行在當前 dsh 客戶端進程中。安裝前應檢查源碼、依賴和許可證；本插件許可證爲 MIT。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把它理解爲官方應用商店。

結尾¶

dsh-chat-tools 的價值比較集中：把對話列布局、提問歷史跳轉、Markdown 標題定位整理到 Web 客戶端的固定控件裏。它適合日常使用 DSH Web 客戶端、經常瀏覽長對話或 Markdown 文件的開發者。已覈實資料未給出目錄頁 URL；倉庫地址如下：

https://github.com/Free-corner/dsh-chat-tools