# dsh-brief-session-title

[English](README.md) | 中文

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 安装即可，无需手动改任何配置：

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

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

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

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

```bash
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