前言¶
在 DeepSeek Harness(DSH)里,侧栏会堆很多会话。默认标题往往是「新会话」或第一句截断,事后要靠肉眼辨认。你可以手动在「重命名会话」里改名字,但要从长对话里自己提炼几个字,仍然费事。下面介绍社区插件 dsh-ai-session-title(维护者 MaouXY):它不另开界面,而是在 DSH 自带的重命名对话框里加一个按钮,用当前会话的真实对话(以及你在输入框里已有的草稿)让模型生成短标题,填回输入框后仍由你点「重命名」确认。
这是什么¶
dsh-ai-session-title 是 npm 包名,GitHub 仓库为 MaouXY/dsh-ai-session-title。分类上属于 DSH 插件生态里的「模型推理」类能力:核心是在 Web 客户端装饰原生「重命名会话」对话框,通过 host 侧注册的 /ai-title 命令调用 ctx.llm 生成标题。插件版本 0.1.0,许可证 MIT;运行要求 dsh ≥ 0.2.1-rc.3、Node ≥ 20(见仓库 engines 与 README)。
核心功能¶
- 入口在原生重命名框内:侧栏会话
···→「重命名会话」;输入框同一条边框右侧多一个星标按钮,不是新弹窗。 - 生成依据真实上下文:点击后读取该会话对话记录,并把你在输入框里已输入的草稿一并作为参考。
- 模型路由跟会话走:默认按「下一次请求」的路由(
session.requestHeader().config);取不到时回退到最新一条助手消息的路由;也可在 profile 里强制指定provider/model。 - 不会自动改名:生成结果只写回输入框;底部仍是原生「取消 / 重命名」,必须你确认才会生效。
- 可选配置:标题长度上限、超时、输出 token 预算等,可在 profile 的
cordis.patch.yml里为插件 idai-session-title增加config(见下文)。
Host 与 Client 分工在 README 里写得很清楚:Host(index.js)注册命令并流式生成;Client(client.js)监听输入框、远程执行 /ai-title,并用原生 input 事件写回标题。第三方 bundle 不能扩展 RPC,因此走命令通道;生成过程中会话流里会出现 command/run 与 command/done,这是主要的可见反馈。
安装与启用¶
从 npm 安装(推荐)¶
在终端执行(<你的 profile> 换成实际 profile 名):
dsh plugin --profile <你的 profile> add dsh-ai-session-title
然后重启 dsh web 并刷新页面。
自带 dsh 的桌面版应在 App 内 设置 → 插件 安装,不要用上述 CLI——App 运行期间不会让命令行改写它自己的 profile。
其他安装方式¶
- 本地目录:
plugin_manager install_bundle,target设为仓库目录的绝对路径;或由 agent 通过plugin_manager工具安装,装完刷新 Web 界面。 - 插件市场:市场目录来自 awesome-dsh-plugin;收录后可在 插件 → 发现 里搜索安装。社区目录站点(如 SkillHub 上的条目页)用于浏览信息,与 DeepSeek / 幻方无官方从属关系。
安装后若按钮未出现,先确认插件已启用、页面已刷新,且 dsh 版本满足 ^0.2.1-rc.3。
典型用法¶
- 在侧栏打开要命名的会话(避免输入框预填标题与会话列表对不上)。
- 打开「重命名会话」;如需方向性提示,可先在输入框里打几个字的草稿。
- 点击输入框右侧星标按钮,等待命令执行完成(会话流中的 command 记录即反馈)。
- 检查输入框中的生成标题,不满意可继续编辑或再次点击生成。
- 点击「重命名」保存。
思考型模型若把输出预算耗在推理上,可能报 max-tokens 或「模型没有返回可用的标题」;README 建议调大 maxOutputTokens。
可选配置¶
在 profile 的 cordis.patch.yml 里,给 id 为 ai-session-title 的插件条目增加 config,例如:
- id: ai-session-title
name: dsh-ai-session-title
config:
maxOutputTokens: 1024
| 键 | 含义 |
|---|---|
provider / model |
强制指定路由;要么都配、要么都不配 |
timeoutMs |
生成超时,默认 60000 |
maxTitleChars |
标题字符上限,默认 30 |
maxOutputTokens |
单次输出预算,默认 1024 |
适用场景与注意¶
适合谁:经常在 DSH 里开多会话、希望侧栏标题能反映对话主题、又不想离开原生重命名流程的开发者或日常用户。
运行与信任:插件以当前 dsh 进程的权限运行;安装前建议阅读 GitHub 源码 与 MIT 许可证。README 说明运行时不导入任何 @deepseek-ai/* 包,仅依赖 ctx.commands、ctx.llm、ctx.remote 与 DOM;若上游改动服务签名或重命名对话框结构,需要插件发版跟进。
兼容性:DSH 按 engines.dsh(本插件为 ^0.2.1-rc.3)判断能否加载;插件市场卡片也会展示该要求。
结尾¶
dsh-ai-session-title 把「读对话 → 模型写短标题 → 填回重命名框」收成重命名对话框里的一次点击,生成不越权改名,配置项也覆盖超时与 token 等常见调参。更多信息见 SkillHub 目录页 与 GitHub 仓库 README。