Relethe/dsh-brief-session-title

English | 中文

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 提供方，直接调用官方 @deepseek-ai/dsh-session-title-llm 的 generateSessionTitleWithLlm()；JSON 帧、字节/token 上限、超时原因码、tool-call 拒绝、标题归一化、session/title-llm-request 日志事件全部沿用官方实现，差异只有系统提示词——发给模型的那份和写入日志的那份一起换；
• 唯一提供方：bundle patch 关闭官方插件，标题服务本身也拒绝第二个注册，两个生成器不会并存；
• 失败安全：模型报错、超时、输出为空时，自动回落到官方确定性 fallback 标题，会话不会没标题；
• 纯配置可调：输入字节上限、输出 token 上限、超时时间均可配。

兼容性

要求 DSH 0.2.x（@deepseek-ai/dsh-session-title* >= 0.2.0-0）。因为不复制策略代码，官方升级会被自动继承；一旦共享函数签名变化，插件会直接报错，而不是写出不合规的会话日志事件。

安装

本插件是一个 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	省略	同时给出则用独立路由生成标题；省略则复用当前会话主请求的路由

targetWords / targetCjkCharacters 故意不开放：自定义提示词写死了自己的长度规则，官方这两个旋钮在这里没有可配的东西。

注意事项

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

许可

MIT