前言¶
DeepSeek Harness(DSH)的会话会自动累积上下文,但在侧边栏里显示的标题往往只是「对话 X」这类通用名称。当会话数量增多时,快速区分当前在做什么就变得困难。
Title Oil 是一个为 DSH 提供自动命名能力的独立插件。它以「类别 emoji + 对象|目标」的形式整理会话标题,方便在侧边栏区分不同任务。
这是什么¶
Title Oil 是由维护者 ygnstudio 提供的 DSH 插件,分类为「趣味换装」。它通过读取最近的用户消息与 assistant 回复摘要,由命名模型生成符合「类别 + 对象|目标」格式的标题,并在每次用户消息后持续更新,不打断正文回复。
核心功能¶
- 自动命名:每条用户消息后,宿主在后台重新评估标题,不打断正文回复。
- 持续更新:读取最近的用户消息、上一轮 assistant 回复摘要与工具名称,据此生成或调整标题。
- 保持稳定:当前标题仍准确时保持原样;默认跳过「嗯、好、继续」等纯确认消息。
- 手动命名优先:在 DSH 中手动改名后,由宿主固定标题,自动命名不再覆盖。
- 规则可配置:命名模型、参考消息数、中英文长度和分类规则都可在应用内调整,保存后生效。
命名效果¶
以下为示例,实际结果由所选模型生成:
| 会话内容 | 示例标题 |
|---|---|
| 排查支付回调重复发货 | 🧩 支付回调|重复发货修复 |
| 为图像模型评测策划视频 | 🎬 图像模型评测|视频策划 |
| 调整登录表单的布局 | 🎨 登录表单|布局优化 |
| 比较数据库方案 | 🔎 数据库|方案比较 |
内置类别为 🎬 内容制作、🧩 工具开发、🔎 对比调研、🎨 页面设计、📝 方法整理。分类规则可在设置页修改。
安装与启用¶
桌面版(推荐)¶
- 打开 DSH 左侧的 插件 → 添加插件。
- 在安装目标中粘贴:
github:ygnstudio/dsh-plugin-title-oil#v0.5.0
- 点击安装,完成后选择 立即启用。
- 若管理器提示需要重启,完全退出并重新打开 DSH。打开 插件 → 会话标题命名 检查设置页。
使用 dsh web 的用户¶
只对独立的 web profile 使用以下命令;桌面版优先使用插件管理器:
dsh plugin --profile web add github:ygnstudio/dsh-plugin-title-oil#v0.5.0
安装后重启已有的 dsh web 进程并刷新页面。不同 profile 独立安装。
从本地源码安装¶
git clone --branch v0.5.0 https://github.com/ygnstudio/dsh-plugin-title-oil.git
cd dsh-plugin-title-oil
pwd
将 pwd 输出的绝对目录填入 插件 → 添加插件。宿主提供 DSH 依赖,不需要另外构建。
开始使用¶
- 打开 插件 → 会话标题命名,或 设置 → 标题命名。
- 选择用于命名的供应商和模型。默认路由为
deepseek-account / deepseek-flash;如果当前宿主没有此模型,从下拉列表改选可用模型,或选择「跟随会话路由」。 - 调整标题规则与分类,点击 保存修改。
- 新建会话并发送有明确内容的消息,观察侧边栏标题更新。
- 想保留某个标题时,直接在 DSH 中手动重命名会话。
设置项¶
| 设置 | 默认值 | 说明 |
|---|---|---|
| 命名供应商 / 模型 | deepseek-account / deepseek-flash |
可选择已配置路由,或两项一起留空以跟随会话 |
| 参考消息 | 5 条 | 最近的用户消息数,范围 1–20 |
| 中文长度 | 6 字 | 「对象」「目标」每段的期望上限,范围 1–30 |
| 英文长度 | 4 词 | 每段的期望词数,范围 1–20 |
| 跳过纯确认消息 | 开启 | 「嗯、好、继续」等不触发改名 |
| 分类规则 | 5 类 | emoji、名称与描述;删除所有行并保存后恢复内置类别 |
| 输入上限(高级) | 8192 字节 | UTF-8 上下文预算,范围 1024–65536 |
| 输出上限(高级) | 64 tokens | 命名模型最大输出,范围 1–256 |
| 超时(高级) | 30 秒 | 范围 1–120 秒;长输入会优先保留最新意图 |
长度是提示词目标,模型不保证逐字满足。保存失败时保留草稿;并发冲突时可使用「重新载入并替换草稿」读取最新设置。
数据与兼容范围¶
配置默认保存在 ~/.dsh/plugin-data/title-oil/config.overrides.json。设置了 DSH_HOME 时使用其下的 plugin-data/title-oil/。目录 0700、配置 0600,采用原子写入。
配置不包含独立保存的模型 API key;模型调用使用 DSH 中已有的供应商配置。
当前验证基线是 macOS / DSH Desktop 0.2.0-rc.2。其他操作系统、宿主版本及模型服务尚未全面验证。
注意事项¶
- 自动命名会产生独立的模型调用。收费、套餐额度与共享规则由所选供应商决定;跟随会话路由也不代表免计费。
- DSH 同时只能使用一个自动标题提供者。此插件的 bundle 会关闭内置的
session-title-llm并注册自身;已有其他自动命名插件时,请先在管理器中停用冲突项。 - 插件只有 Web/桌面设置界面,不承诺 TUI 可用。
更新与卸载¶
- 更新:备份上述数据目录,按插件管理器提示更换到新版本 tag;若要求先卸载再安装,配置目录会保留。
- 停用或卸载:在插件管理器关闭开关或选择卸载。移除本 bundle 后,内置标题提供者应随其覆盖层解除而恢复;若还有其他配置覆盖,检查标题提供者启用状态。
- Web CLI:
dsh plugin --profile web remove dsh-plugin-title-oil,然后重启对应进程。 - 卸载不会删除用户配置,也不会批量改动已有会话标题。
适用场景¶
Title Oil 适合需要在 DSH 侧边栏快速识别会话用途的开发者或 AI 使用者,尤其是会话数量较多、任务类型多样的情况。它通过「类别 + 对象|目标」的结构化标题,让侧边栏变成更易读的任务清单。
总结¶
Title Oil 为 DeepSeek Harness 提供自动命名能力,以「类别 emoji + 对象|目标」的风格整理会话标题,持续更新并支持手动覆盖。它通过可配置的规则、内置分类与高级参数,适应不同的命名需求。
- 插件目录:https://www.skillhub.cn/plugins/ygnstudio/dsh-plugin-title-oil
- GitHub:https://github.com/ygnstudio/dsh-plugin-title-oil