墨言 elviszhang007/dsh-moyan

墨言（dsh-moyan）

墨言 / MoYan

一个克制、安静的 DeepSeek Harness WebUI 插件：在左下角侧边栏「设置」按钮上方，完整显示一句名言、古诗词或游戏经典台词。

路漫漫其修远兮，吾将上下而求索。
—— 屈原《离骚》

句子自动折行、出处单列一行；整体风格与 Harness 原生的「设置」行保持一致。

特性

- 完整显示：字体与 Harness 主字体相同，颜色用透明度调淡；句子按需折行，出处单独一行，不喧宾夺主；
- 刷新频率可调：每次打开 WebUI 刷新、或每天刷新（跨午夜自动换一句），也可以随时手动「换一句」；
- 回到上一句：面板里的小箭头按钮可回退最近 5 次刷新，防止手快错过想看的句子；
- 近十步去重：最近显示过的 10 句不会被随机换出；
- 语料外置：直接编辑 corpus.txt 即可增删句子，刷新页面即生效，无需重启、无需改代码；
- 明暗主题：样式全部使用 Harness 主题变量，自动跟随亮色/暗色主题；
- 侧边栏收起成窄轨时自动隐藏，不占用空间。

安装

前置要求

- Node.js ≥ 18；
- DeepSeek Harness (DSH) 已安装（全局或本地）
- pnpm（dsh plugin 内部依赖 pnpm 转发安装命令，两种安装方式均需要）；

本插件为「树外插件」（profile 插件），通过 dsh plugin 安装。

安装方式

注意：安装前请确认DSH安装方式以使用下文中所有命令！
- 若为全局安装，请去除 '(pnpm)'。 --> 即 dsh...
- 否则请 去除括号 '()'，仅 保留 'pnpm'。 --> 即 pnpm dsh...

profile 名要选对：桌面版（DeepSeek Harness 应用）启动的是 desktop profile，命令行 dsh web 启动的是 web profile。插件装在哪个 profile，就只在那个 profile 里出现。桌面版用户请把下文的 --profile web 换成 --profile desktop。

从本地目录安装：

(pnpm) dsh plugin --profile web add ./dsh-moyan

从 GitHub 安装（可使用'#'选定版本）：

注意：请将命令中的版本（v0.7.x）改为实际需要的版本，例如 v0.7.0。

(pnpm) dsh plugin --profile web add "git+https://github.com/elviszhang007/dsh-moyan.git#v0.7.x"

从 npm 安装（推荐）：

(pnpm) dsh plugin --profile web add dsh-moyan

安装后请重启 profile（插件集的变化在重启时生效）：桌面版关闭应用后重新打开，命令行则重启 dsh web，然后刷新页面：

(pnpm) dsh web

卸载

卸载流程

按包名移除（profile 名同样要与安装时一致）： (pnpm) dsh plugin --profile web remove dsh-moyan

清理痕迹

插件在浏览器 localStorage 中留下了设置键（dsh-moyan:v1），如需清除，在 WebUI 页面按 F12 打开控制台执行：

localStorage.removeItem("dsh-moyan:v1")

使用

1. 侧边栏底部、「设置」上方会出现一句话，出处附在句后；
2. 鼠标悬停时，出处行尾浮现齿轮按钮，点击打开设置面板；
3. 面板中可以：
- 切换刷新频率（每次打开 / 每天）；
- 点 换一句 换一条（近 10 句不会重复）；
- 点左侧小箭头 回到上一句（最多回退 5 步）；
- 查看当前句的完整出处。

语料库

格式

语料保存在项目根目录的 corpus.txt 中，每行一条：

会当凌绝顶，一览众山小。 | 杜甫《望岳》

- 分隔符用半角 | 或全角 ｜ 均可；
- 以 # 开头的行和空行会被忽略；
- 句子不超过 30 字，出处尽量简短（书名/篇名/作品名即可）；
- 内置 100 余条语料，覆盖古诗词、中外文学作品与游戏台词。

编辑与生效

插件安装到 profile 时会把整个包复制到 %USERPROFILE%\.dsh\profiles\node_modules\dsh-moyan\。编辑该目录下的 corpus.txt，保存后刷新页面即生效（宿主每次请求都会重新读取文件，无需重启 dsh web）。

如果语料文件缺失或解析为空，插件会自动回退到内置语料，保证始终有内容显示。

工作原理

- cordis.patch.yml 向 profile 配置树插入一个 loader 行，宿主机的 client-modules 扫描器据此识别包内的 dsh.client（platform: web）声明，并把 lib/client.js 以 /plugins/dsh-moyan/client.js 提供给页面；
- Node 半通过 ctx.inject(["webServer"]) 注册路由 /plugins/dsh-moyan/corpus.txt，实时读取语料文件（非 web profile 中自动退化为无操作）；
- 浏览器半以官方 client 插件的同一契约（window.__ModuleLoader__.load）注册，UI 挂载到 sidebar.footer.action slot——它位于 sidebar.settings（设置）正上方；
- 所有颜色与字体均取自 Harness 主题变量（--dsw-font-family、--dsw-alias-label-secondary、--dsw-alias-interactive-bg-hover 等），不写死任何配色。

开发与测试

无构建步骤、零运行时依赖——lib/*.js 即交付物。

npm test # 运行测试（或直接 node tests/run-tests.js）
npm run check # 语法检查

测试覆盖：语料格式与查重、语料文件与内置回退的一致性、出处抽查、选句与去重逻辑、随机采样均匀性、宿主路由行为。
修改代码后让改动生效：

dsh plugin --profile web add "D:\path\to\dsh-moyan" # 重新安装/拷贝
重启 dsh web，刷新页面

兼容性

在 DeepSeek Harness 0.2.0-rc.2（桌面版）上开发与验证；0.6.0 适配 0.1.2-rc.1，0.5.x 及更早适配 0.1.0-rc.6。DSH 仍在快速演进，slot 名、主题变量名、图标名与 client 模块契约都可能随版本变化；升级 Harness 后如遇异常，请提 Issue 并注明 DSH 版本与 profile 名。

反馈

欢迎提 Issue 分享语录（格式照 句子 | 出处）、报告问题或建议新功能。

License

MIT