会话标题精简Relethe/dsh-brief-session-title

dsh-brief-session-title

DeepSeek Harness（DSH）会话标题精简插件：把「一句完整的话」压成「一个词」，便于回忆。

为什么做这个插件

DSH 的会话标题由官方 session-title-first-prompt-llm 插件生成。它经常输出一句完整的话——"解释一下 JavaScript 闭包到底是什么"这种原样照搬的句子会直接出现在侧边栏里，冗长、不便于扫读和回忆。

问题根源在官方提示词：它的长度约束只有一句 "Aim for about 5 words"——"目标大约是"是软约束，模型容易超；而且它只要求"简洁"，没有告诉模型"简洁成什么样"。目标不够明确，是标题冗长的主要原因。

本插件不动官方任何逻辑，只做一件事：重写系统提示词，用明确规则 + 正反例句，把"简洁"变成可执行的标准。

效果样例

| 会话内容（原句） | 本插件输出 |
|---|---|
| 解释一下JavaScript闭包到底是什么 | JS闭包浅说 |
| 用英语表达中国近代半文言文文法 | 半文言文法表达 |
| 中式微恐2.5D沙盒生存游戏系统PRD | 游戏PRD |
| Fixing Memory Leak in Node | Node memory leak |
| Database Schema Design Review | Schema review |

核心思路：提示词优化

新提示词给了模型四条硬规则：

1. 英语按 PLAIN ENGLISH 原则——平实、直接；
2. 中文按文白相间（literary-vernacular hybrid）原则——文言白话结合，凝练（如"浅说""文法表达"）；
3. 输出中避免动词——动词是"句子"的骨架，去掉动词，句子自然塌缩成词组；
4. 尽力压到 5 个词以内，像一个专业诗人——宁短勿长。

再加上六组正反例句（Incorrect / Correct 对照），让模型直接"抄"出目标风格，而不是猜测"简洁"是什么意思。

特性

- 零侵入：与官方 first-prompt-llm 逻辑完全一致（取第一条人类消息、流式生成、失败回落 fallback），只换提示词；
- 自动接管：与官方插件互斥，装载时自动关闭官方 provider，保证同一时间只有一个标题生成器；
- 失败安全：模型报错、超时、输出为空时，自动回落到官方确定性 fallback 标题，会话不会没标题；
- 纯配置可调：输入字节上限、输出 token 上限、超时时间均可配。

安装

本插件是一个 dsh bundle，直接通过 GitHub 安装即可，无需手动改任何配置：

dsh plugin --profile web add github:Relethe/dsh-brief-session-title

发布到 npm 后，也可以用包名安装：

dsh plugin --profile web add dsh-brief-session-title

本地目录安装（相对路径以你执行命令的目录为基准，绝对路径直接传）：

dsh plugin --profile web add ./dsh-brief-session-title

安装时 dsh plugin 会把参数转发给 pnpm，装完后自动对账：检测到本包声明了 dsh.bundle，就会把它加入 profile 的 bundle 层；bundle 自带的 cordis.patch.yml 随之自动应用（禁用官方标题插件 + 挂载本插件）。

重启 DSH 后，新会话的标题即生效。

配置项

| 键 | 默认 | 说明 |
|---|---|---|
| maxInputBytes | 4096 | 输入 JSON 帧的字节上限，超限直接失败（不截断历史） |
| maxOutputTokens | 64 | 标题请求的输出 token 上限 |
| timeoutMs | 60000 | 单次标题请求超时（毫秒） |
| provider / model | 省略 | 同时给出则用独立路由生成标题；省略则复用当前会话主请求的路由 |

注意事项

- 只影响之后的标题：已存在会话的标题已落盘，不会自动重算；
- 手动改名会钉住：用户在 UI 里手动改过标题后，自动生成不再覆盖（DSH 官方行为）；
- 还原方式：dsh plugin --profile web remove dsh-brief-session-title，官方标题插件自动恢复。

许可

MIT