前言¶
在 DSH 裏和 agent 對話時，有些句子說完就沉在上下文裏，想回頭找往往要翻聊天記錄或自己記筆記。常見做法是手動維護 Markdown、或讓 agent 寫進某個文件，但前者打斷節奏，後者還要人指定路徑、改文件格式。鯨語（dsh-whale-whispers）是社區維護者 heiyedehen 發佈的客戶端類插件：在輸入框上方的會話區域增加「鯨語」標籤頁，同時給 agent 三個工具，由 agent 按需寫入、讀取、刪除語錄；人在面板上改名、換文件、導出，不必直接改磁盤上的語錄文件。
下面介紹它是什麼、能做什麼、如何安裝與配置，以及語錄文件格式與典型用法。
這是什麼¶
鯨語的定位是：DSH 輸入框上方的語錄標籤頁。agent 可寫、每句可帶上文、可改名、可導出。
- 維護者：heiyedehen（包作者信息：鹿野）
- 分類：客戶端（需帶 Web 客戶端的 DSH）
- 倉庫：heiyedehen/dsh-whale-whispers
- 社區目錄：skillhub.cn 插件頁
- 當前包版本（package.json）：1.3.0，許可證 MIT
Host 側提供 GET /dsh-quotes.json（每次請求現讀文件、不緩存）和三個 agent 工具；Client 側註冊到 conversation.composer.dock 與 settings.section。面板與工具共用同一套 resolveTarget()，看到的是同一份語錄文件。
核心功能¶
給人看：標籤頁與設置¶
會話頭部有 鯨語 標籤頁，設置裏也留一份入口。句子按最新在上展示。面板只在你切到它時讀一次文件，後臺不輪詢；你或 agent 剛寫過，切出去再切回來即爲最新內容。
給 agent：三個工具¶
任何能調工具的 agent 都可以操作語錄，無需人去改文件：
| 工具 | 作用 |
|---|---|
whale_whisper_append |
收一句，寫進今天那一段；重複的自動跳過 |
whale_whisper_list |
讀回最近的句子（查重、看自己收過什麼） |
whale_whisper_remove |
刪掉一句（整句匹配，不會誤傷旁邊那條） |
寫入是原子的（臨時文件 + rename），格式與文件裏原有的一致：- 「句子」（批註）。whale_whisper_append 只會改以 - 開頭的行，手寫的標題、註釋、空行不會被改。
插件不會自動記每一句；工具描述面向「自己覺得站得住的話」。若希望 agent 養成習慣，可在 agent 規矩裏寫例如：
覺得某句話值得留，就調
whale_whisper_append收進鯨語，別問。
或：
說完一句自己想再看一遍的話，順手調
whale_whisper_append。
給人管：面板操作¶
| 想做什麼 | 點在哪兒 |
|---|---|
| 改名字 | 右上角「改名」，回車即存（寫進 quotes.config.json 的 title） |
| 換語錄文件 | 頂部「換文件」，填絕對路徑（寫進 path；文件還不存在也能先存） |
| 刪一句 | 句子右邊的 ✕，再點「刪」確認 |
| 複製全部 | 頂部「複製全部」（Markdown，帶日期/批註/上文） |
| 下載 | 「下載 .md」，文件名跟標題走 |
| 給別人看 | 「匿名版」，只留句子，去掉批註與上文 |
安裝與啓用¶
官方安裝命令如下（裝完需重啓 DSH）：
dsh plugin add dsh-whale-whispers
也可在 Web UI 的插件市場（本地包）中選擇該目錄。
依賴：需要帶 Web 客戶端的 DSH（@deepseek-ai/dsh-client-ui-conversation）。客戶端注入包在 package.json 中列爲 @deepseek-ai/dsh-client-runtime、dsh-client-ui-renderer、dsh-client-ui-layout；若本機 DSH 版本不同，應按 node_modules/@deepseek-ai/ 下實際存在的包調整 dsh.client.inject。
裝了卻看不到時，可按 README 順序排查：注入的客戶端包是否存在；模塊 id 是否爲 dsh-whale-whispers；改 client 半邊後是否刷新頁面；開發者控制台是否有 failed to load module。
配置與語錄文件¶
配置文件或環境變量¶
在以下位置查找 quotes.config.json（先找到先用）：~/.dsh/quotes.config.json，以及 README 中作者示例路徑 D:\dsh work\self\quotes.config.json。兩個字段都可省略，省略則退回插件默認。
示例：
{
"path": "C:/Users/you/quotes.md",
"title": "我的鯨語"
}
也可完全用環境變量繞過配置文件：
DSH_WHALE_WHISPERS_PATH=/home/you/quotes.md
DSH_WHALE_WHISPERS_TITLE=我的鯨語
語錄 Markdown 格式¶
## 寫日期，- 寫句子；句尾可跟 (批註)，面板顯示爲灰色小字。句子下可緊跟一行 ↳ 上文：…，面板顯示爲暗色小字，用於保留語境。
# 我的鯨語
## 2026-11-03
- 「這句話是我想說的。」
- 「這句後面帶個批註。」（爲什麼記它）
↳ 上文：這句話是在什麼情形下說的
典型用法¶
- 安裝並重啓 DSH，確認會話頭部出現「鯨語」標籤頁。
- 按需創建
quotes.config.json或設置DSH_WHALE_WHISPERS_PATH/DSH_WHALE_WHISPERS_TITLE，指向自己的quotes.md。 - 在 agent 系統提示或規矩中加入「值得留就調
whale_whisper_append」類說明；對話中 agent 寫入後，切到鯨語標籤頁查看；需要時用whale_whisper_list查重、whale_whisper_remove刪錯句。 - 在面板上「複製全部」或「下載 .md」做備份；對外分享可用「匿名版」。
適用場景與注意¶
適合：希望在 DSH 會話內集中收藏金句、並願意通過 agent 工具而非手改文件來追加語錄的開發者；需要帶上文、批註的結構化 Markdown 語錄本的用戶。
注意：
- 插件以當前 DSH 進程的權限讀寫語錄路徑；安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認路徑與數據落盤位置符合你的環境。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文事實以倉庫 README 與 package.json 爲準。
結尾¶
鯨語把「隨口說過、想再聽一遍」的句子收進會話頭部的標籤頁，並用三個 agent 工具與同一套文件格式打通讀寫；面板按需讀文件、不後臺輪詢。若要在本地試用，使用 dsh plugin add dsh-whale-whispers 安裝後重啓，並配置自己的語錄路徑即可。
- 目錄頁：https://www.skillhub.cn/plugins/heiyedehen/dsh-whale-whispers
- GitHub：https://github.com/heiyedehen/dsh-whale-whispers
