前言¶
在 DeepSeek Harness(DSH)里开新会话时,标题往往来自「仅用户首条提示」的默认命名逻辑:助手还没回复,上下文不完整,生成出来的名称容易泛化,事后在会话列表里也不太好找。若你更在意「首轮 user + assistant 都落地之后」再定名,并希望在聊天界面里随手改标题,社区插件 dsh-turn-title(维护者 mdalboni)针对的就是这一组问题。下文按安装、界面操作与实现要点说明,事实以 GitHub 仓库 与 SkillHub 目录页 为准。
这是什么¶
dsh-turn-title 是 DSH 的客户端侧插件:在第一轮完整交换(用户提示 + 助手回复完成)之后自动生成会话标题,并在会话头部的操作区增加 Update Title 按钮,用于再次用模型生成标题或手动输入。仓库采用 MIT 许可,当前 package.json 中版本为 1.0.0,要求 DSH >=0.2.1-rc.3,实现为纯 ESM、无额外运行时依赖。
核心功能¶
Turn-1 自动标题¶
插件会替代「只看首条用户提示」的默认定名方式:监听首轮结束事件,在助手第一条回复完成后再调用模型生成标题,以便标题能反映完整上下文。
会话头部按钮¶
在 conversation.session.header.actions 插槽注入 ✎ Update Title(文案会随 DSH 界面语言切换):
- 单击:根据当前会话上下文重新生成标题。
- Shift + 单击(或 Alt + 单击):弹出对话框,手动输入标题。
语言与主题¶
- UI 标签与提示词会与当前 DSH 界面语言对齐(README 列举 English、Portuguese、Chinese 等)。
- 样式使用 DSH 的
--dsw-alias-*CSS 变量,与明/暗主题一致。
安装与启用¶
插件随 web profile 加载;安装方式以 README 为准,不要凭仓库名自行拼接 github:owner/repo 类命令。
通过 DSH Plugin Market(dshmarket)¶
在插件市场里搜索 dsh-turn-title,点击 Install。
通过 DSH CLI¶
dsh plugin --profile web add dsh-turn-title
从本地源码链接(需自行 clone 仓库)¶
git clone https://github.com/mdalboni/dsh-turn-title.git
dsh plugin --profile web add link:./dsh-turn-title
安装后插件在 DSH 进程内运行,权限与当前 DSH 实例一致;启用前建议浏览源码与 LICENSE,确认符合你的环境策略。SkillHub 上该条目星标为 0,不影响功能描述,仅作生态可见度参考。
典型用法¶
- 安装并启用插件后,新建会话,完成第一轮问答;若会话尚未自定义标题,首轮
turn正常结束时应自动出现描述性标题。 - 在会话顶部找到 Update Title:
- 需要刷新 AI 标题时单击;
- 需要固定文案时用 Shift/Alt 单击,在对话框中填写标题。 - 若你维护插件或改动了服务端逻辑,可用仓库自带测试:
node --test test/index.test.js
工作原理(便于对照源码)¶
README 概括的三条路径如下,便于排错或对二次开发:
- Host 事件:监听
session/event,在turn === 1且reason.kind === 'completed'时,若尚无自定义标题,经ctx.llm.stream生成标题,并用ctx.sessionTitle.rename更新。 - HTTP:在
ctx.webServer注册POST /api/session-title/update,接收{ sessionId, title, locale },用于手动改名或触发 AI 更新。 - 客户端插槽:经
ctx.slots.inject向conversation.session.header.actions注入按钮,文案由ctx.locale管理。
适用场景与注意¶
适合:长期在 DSH Web 界面里堆积多会话、依赖标题做检索的开发者;希望首轮就有较准确标题、又不想离开聊天页去改名的场景。
注意:
- 分类为客户端插件,依赖
dsh的 web client 注入(package.json中client.platform为web,并声明注入@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-conversation)。 - 自动与手动改名均经过插件注册的 API 与 DSH 会话能力,与核心 DSH 版本需满足
peerDependencies中的>=0.2.1-rc.3。 - 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系,安装来源以你信任的渠道为准。
结尾¶
dsh-turn-title 把「定标题」的时机推到首轮助手回复完成之后,并在会话头提供一键再生成或手动覆盖。需要安装入口时可查 SkillHub 目录,源码与英文/葡语/中文 README 见 GitHub。