AI 会话标题

为 DeepSeek Harness（DSH）的会话重命名对话框加一个 AI 生成按钮：读取真实对话内容（以及你已经输入的草稿），让当前会话所用的模型写一个短标题，填进输入框——你确认后按「重命名」，不满意就继续改。

English | 中文

要求：dsh ≥ 0.2.1-rc.3、Node ≥ 20。

效果

• 打开任意会话自带的「重命名会话」对话框（侧栏 ··· → 重命名会话）。
• 输入框内右侧、同一条边框里多一个星标按钮——不是新弹窗，就是原生那个框。
• 点一下：读取该会话的对话记录，连同你已输入的草稿一起作为参考，生成标题并填回输入框。
• 底部仍然是原生的「取消 / 重命名」；生成不会自己改名，必须你点确认。

安装

从 npm 安装（推荐）

dsh plugin --profile <你的 profile> add dsh-ai-session-title

然后重启 dsh web 并刷新页面。

自带 dsh 的桌面版请在 App 内 设置 → 插件 里安装，不要用命令行——App 运行期间不会让 CLI 改写它自己的 profile。

从本仓库安装

plugin_manager install_bundle  target = <本目录的绝对路径>

或者让 agent 用 plugin_manager 工具装。装完刷新 Web 界面。

从插件市场安装

市场读取的是 awesome-dsh-plugin 这份目录，而不是本仓库。目录收录之后，在 插件 → 发现 里搜索安装即可。

工作原理

一个包，两半：

半边	文件	作用
Host	index.js	注册全局命令 /ai-title。读会话事件日志、按下一次请求要用的路由（session.requestHeader().config，取不到时回退到最新一条助手消息）选模型，用 ctx.llm 以 purpose: 'session-title' 流式生成一条，清洗后返回。命令名后面的文本视为用户的草稿标题。
Client	client.js	监听原生对话框的会话名输入框，就地装饰一个星标按钮；点击后调用 ctx.remote.commands.execute(sessionId, '/ai-title <草稿>', [])，把返回的标题用原生 input 事件写回该输入框。

两个实现细节值得说明：

• 为什么装饰 DOM 而不是注册插槽：原生对话框把目标会话存在组件内部 state 里，通过 shell.overlay 渲染，内部没有暴露任何插槽，所以插件拿不到插入点，只能就地装饰它；会话 id 则通过输入框预填的标题在 Workspace Service 的会话列表里反查。
• 为什么走命令：客户端到 host 的 RPC 接口是构建期生成的，第三方 bundle 无法新增方法，命令是唯一稳定的调用通道。代价是每次生成会在会话流里留下一条 command/run + command/done 记录——这也是生成过程中唯一的可见反馈。

配置（可选）

装好之后打开 更多 → 设置，左侧导航里会多出一项 「AI 会话标题」，改完点保存即可：

字段	说明
style	标题结构，决定生成出来的标题长什么样，见下表
datePrefix	是否在标题前加「月-日」前缀，默认关
prompt	自定义结构提示词，只在 style 选“自定义”时生效；留空按“主题”处理
maxTitleChars	标题字符上限，默认 30

四种结构对应四种“以后怎么把会话找回来”的方式：

style	名称	示例	适合
concise	主题	登录超时排查	默认。3~8 字名词短语，侧栏最窄时也能一眼扫过去
descriptive	动作	重构登录状态管理	动词开头，回看时知道这次做了什么
outcome	主题 + 结论	分页错位 · 定位到索引边界	先主题再产出，复盘时最能看出这次值不值
custom	自定义	由提示词决定	用 prompt 描述你自己想要的格式

日期单独是一个开关，不是第五种结构：打开 datePrefix，上面任何一种结构都会多出 10-30 前缀，所以「日期 + 主题」「日期 + 主题 + 结论」都是两次点击的事，不用为每种组合再列一张卡片。

datePrefix 的日期不是模型编的：插件读会话第一条消息的时间，自己补 MM-DD ，并且先从前缀里扣掉 6 个字符再要求模型写正文，所以总长度仍然守得住 maxTitleChars。

不管选哪种结构，硬性要求都不变：只输出一行纯文本，不加引号、前缀或 Markdown，语言跟随对话。结构只换措辞，不会把生成结果弄脏。

早先版本里的 english / dated 两个结构值仍然被接受：english 照旧输出英文标题，dated 等价于「主题 + 打开 datePrefix」，所以旧配置升级后不会挂。

这一页由插件自己注册（settings.section），读写的就是插件自己的配置项 ai-session-title，和下面手写 cordis.patch.yml 完全等价。

少数高级项不放在设置页里，需要时写进 profile 的 cordis.patch.yml：

- id: ai-session-title
  name: dsh-ai-session-title
  config:
    provider: deepseek
    model: deepseek-chat
    maxOutputTokens: 1024

键	含义
provider / model	强制指定路由。要么都配、要么都不配；默认按下一次请求的路由，取不到再用最新一条助手消息的路由。
timeoutMs	生成超时，默认 60000。
maxOutputTokens	单次调用的输出预算，默认 1024。思考型模型如果先思考、把预算耗光才轮到你看到的标题，会报 max-tokens，把它调大即可。

兼容性

engines.dsh 声明为 ^0.2.1-rc.3。DSH 只按 engines.dsh 判断兼容性（没有该字段时才回退到 @deepseek-ai/dsh-* 的 peer 范围），插件市场的卡片上也会显示这个要求。

这个插件在运行时只导入一个 @deepseek-ai/* 包：host 半边用 @deepseek-ai/schemastery 声明 Config（harness 自带），其余只用 ctx.commands / ctx.llm；client 半边只用 ctx.remote 和 DOM API。好处是任何 profile 都不需要额外装依赖就能加载；代价是如果上游改了这些服务的签名或重命名对话框的结构，就需要跟着发新版本。

开发

npm test        # host 半边的冒烟测试，不需要 harness、也不需要模型

client 半边没有构建步骤：client.js 按原样被加载。改完刷新 Web 界面即可（profile 里是 link: 安装，不用重装）。

目录结构

cordis.patch.yml     把行 id `ai-session-title` 插入为本包
index.js             host 半边（命令 + 生成）
client.js            client 半边（就地装饰 + 远程调用）
test/host.smoke.mjs  host 半边冒烟测试（npm test）
locale/*.json        插件展示信息（标题 / 描述）
icon.svg             插件图标
screenshots.json     市场卡片用的截图声明
docs/screenshot.png  截图

常见问题

按钮没出现？ 确认插件已启用、刷新过页面，且 dsh 版本满足 ^0.2.1-rc.3。

报「模型没有返回可用的标题」？ 多数是思考型模型把输出预算全用在推理上，调大 maxOutputTokens。

报「无法确定要命名的会话」？ 说明输入框里的标题在会话列表里匹配不到（例如同名的会话刚被改名）。先在侧栏打开该会话再试一次。

License

MIT，见 LICENSE。