前言¶
在 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
