dsh-auto-rename

dsh plugin --profile web add dsh-auto-rename

<div align="center">

<img src="icon.svg" width="112" height="112" alt="dsh-auto-rename 图标" />

dsh-auto-rename

DeepSeek Harness 的对话自动命名。

自动定名、随对话刷新，重命名弹窗流式给出 AI 建议。







[English](README.md) · 中文

</div>

---

功能

自动定名，随对话刷新。 会话发出第一条人类消息时就生成 AI 标题；之后每来一条新消息，

插件重读最近几条并刷新一次，话题换了标题跟得上。把「随对话自动刷新标题」关掉，就退回到

只看首条消息命名一次。手动重命名会把标题钉住，两种模式都不再自动改写。

改名时给出建议。 对话页顶部有「AI 命名」按钮，弹出的对话框与 DSH 原生重命名窗口长得一样、

手感一样，只多三样东西：

流式候选 · 建议逐条到达（NDJSON），每条配 500ms 从左到右的扫描线揭示

一键填入 · 点 chip 即填入输入框；点「重新生成」换一批

原生手感 · 回车确认、Esc 关闭、输入法组字期间回车不误提交

模型由你挑。 默认跟随当前对话的主模型，也可以钉一个更便宜的小模型。下拉的数据源是宿主的

remote.session.modelCatalog()：它逐个 provider 试列，列不出来的不进目录 —— 所以每一项都是

宿主已认证且真能调用的模型。

推理这条，替你处理好了。 起标题只要三四个词，可推理模型会先思考、和答案抢同一份

max_tokens。所以插件自动做四件事：

能关就关 · 模型自己声明了关闭档就发它（不同网关叫 off 或 none，只认模型真声明的那些）

关不掉就退最低档 · 没有关闭档就选它声明列表里最低的一档。只从模型声明的档位里挑，越界不可能发生 —— 有的网关收到没声明的档位不报错、直接忽略，自己填字符串等于骗界面

推理模型抬上限 · 思考吃光预算时标题静默为空；实测同一个模型把低预算吃到过 2048（思考长度 325–3172 token 且随机），所以推理模型一律抬到 4096（schema 上限）。max_tokens 只是上限，stop 即返回，抬预算不拖慢正常生成，真正的护栏是超时

吃满了重试一次 · 只有撞上 max-tokens 才重试，最多两次，每次另拿一份满额超时；其他失败重跑结果一样，不重试

弹窗里的设置面板会直接说这次属于哪种：已关推理 / 退到最低档 / 非推理模型不发推理参数 /

读不到该模型的能力。换模型后这几句和可选档位立刻跟着变。

留得下审计线索。 provider id dsh-auto-rename 会写进每条 session/title 事件的

source.provider，所以随时能分辨哪些标题是这个插件生成的。

<details>

<summary><b>为什么不扩展原生重命名窗口，而要自建</b></summary>

原生重命名窗口是宿主内部组件，没有任何扩展点：RenameForm 不声明可注入槽位，它需要的

requestSessionRename 只作为 prop 传给侧栏菜单项，整个 bundle 也没有 ctx.provide 它。

所以插件既塞不进建议条，也无法程序化唤起它。只能自建对话框，再逐条抄原生窗口的 CSS 规则，

让两者看起来完全一样。

</details>

安装

dsh plugin add dsh-auto-rename

或从仓库安装：

dsh plugin --profile desktop add <本仓库路径>

本包声明了 dsh.bundle.patch，安装时除了把 dsh-auto-rename 插入 profile 的 bundle 栈，

还会禁用 dsh-base 内置的 session-title-llm 行。第二步是必须的：

SessionTitleService.register() 全局只接受一个 provider，内置行先注册就会让本插件的注册抛错。

装完重启 DSH。client 半边会热更新，host 半边必须重启才生效。

设置

打开「AI 命名」弹窗，点标题行里那个齿轮图标（在关闭键左边），面板就在同一个弹窗内展开。

改动先进草稿，点「保存」才写盘；留空表示用默认值。

字段 · 默认 · 说明

随对话自动刷新标题 · 开 · 开=每条新消息重读最近几条并刷新；关=只用首条消息命名一次。两种都保留建议功能

命名模型 · 跟随主模型 · 只列出宿主已认证、当前能列出的模型

推理档位 · 自动 · 可选档位由这个模型自己声明；自动 = 能关就关，否则最低档

建议条数 · 3 · 每次打开弹窗拉取几条候选（1–5）

输出上限（token） · 256 · 单次生成的上限（8–4096）；模型会思考时这里自动抬到 4096

超时（毫秒） · 60000 · 单个标题的最长等待（1000–600000）。重试另拿一份满额预算，所以最坏总时长是这个数的两倍

标题宽度（中文字数） · 12 · 唯一的长度旋钮（1–400），超出即截断

若宿主没有组合 remote、或列模型失败，模型那一行会退回手填 Provider / Model 两个字段。

两者必须成对填写：只填一个会在启动日志里留一条警告，用到时明确报错，而不是静默不生效。

工作方式

只读你打的字。 两条路径都不看助手回复：自动命名取最近六条人类消息（关掉自动刷新时

只有首条会被排程），建议取最近三条，因此它们概括的是进行中的话题。每条消息在交给模型前按

maxInputBytes（默认 4096）裁剪 —— 官方共享实现在输入超限时直接抛错。

长度按显示宽度算，不按字符数。 1 个中日韩字算 2 个半角单位，其余字符（含空格）算 1 个。

预算 = 标题宽度 × 2，所以默认的 12 等于中文 12 字、或英文含空格 24 个字符，约 3–4 词。

一个旋钮同时管两种文字；英文不单独设词数上限，因为单词长度差异太大，按词数约束没有意义。

官方共享实现仍要求一个 targetWords（只进提示词，不做截断），所以它由同一个预算按

约 6 单位/词折算 —— 12 得到 4。这让模型的目标长度贴着硬截断走，而不是先写长再被裁。

截断不会切坏单词。 切进拉丁词中间会回退到上一个空格，不会出现 sessio 这种残词；

整段没有空格可退时（provider/model 路由、URL）宁可不截 —— 略超宽比残词好。

<details>

<summary><b>为什么必须由本插件来截断</b></summary>

官方调用方给 normalizeSessionTitle 的截断参数传的是 Number.MAX_SAFE_INTEGER，

等于完全不截。宿主确实有一层 maxTitleBytes 上限（80 字节 ≈ 26 个汉字），但它太宽松，

管不住"太长"。所以"别太长"只能由本插件守住，宽度旋钮的实际上限也就落在宿主字节限制之下。

</details>

项目结构

lib/config.js    纯逻辑：配置合并、源消息挑选、标题截断。零 import，可独立测试。
lib/index.js     Host 半边 —— 注册 title provider 与 HTTP 桥。
lib/client.js    Client 半边 —— 顶部按钮、重命名弹窗、弹窗内设置面板。
cordis.patch.yml bundle patch：插入本插件、禁用内置 session-title-llm。
locale/          插件管理器要用的展示元数据（标题、描述）。
test/            自检：逻辑、host apply、client 渲染、字典审计、patch。

两半边通过三条 HTTP 路由通信，都只接受回环来源

（127.0.0.1、::1、::ffff:127.0.0.1），且拒绝 sec-fetch-site: cross-site：

路由 · 用途

POST /dsh-auto-rename/suggest · 以 NDJSON 流式返回 N 条候选标题

POST /dsh-auto-rename/config · 回显当前生效配置 + 该模型的推理能力（含「这次有没有真把推理关掉」），排查用；带上一对 provider/model 时改为只探测那个模型，不写任何东西

POST /dsh-auto-rename/settings · 经宿主 settings 服务写配置，按白名单过滤

写路由在宿主 settings 服务缺席时返回 503，而不是谎报保存成功。

开发

npm run check

六道门禁，都快、都不联网：

1. host 与 config 模块语法检查，外加 client bundle 的解析检查。

2. 纯逻辑自检 —— 配置合并、消息挑选、宽度预算、字节预算。

3. host apply() 冒烟（假上下文）：元数据、降级路径、provider 形状、路由守卫，

以及 Config schema 的精确字段清单；/config 的草稿 route 只探测、不改生效配置。

4. client apply() 冒烟：真渲染顶部入口与设置面板，覆盖模型目录的三种降级。

假上下文复刻了宿主那个受限 facade，包括读 ctx.inject 会抛错这一条；

四种推理状态、换模型后的重探测、以及「关闭档叫 off 还是 none 只由 host 判定」也在这里钉住。

5. 字典审计：代码里用到的每个 key 在 zh、en 两份里都存在。

6. patch 检查：cordis.patch.yml 禁用了内置行、插入了本插件行，且没碰到别的行。

冒烟测试需要 @deepseek-ai/schemastery。本地从已装的 profile 链一份进来：

New-Item -ItemType Junction -Path node_modules\@deepseek-ai\schemastery `
  -Target "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@deepseek-ai\schemastery"

test/stubs/ 里有一个 dsh-session-title-llm 替身，只回显收到的参数，

用来在 DSH 之外验证调用接线，而不必复刻官方 provider。

已知边界

• 槽位改名会静默失效。 顶部按钮依赖 conversation.session.header.actions

（DSH 0.2.1-rc.2 声明）。槽位未被声明时 slots.inject 的回调根本不触发，也不报错 ——

所以宿主升级若改了槽位名，按钮会无声消失。顶部那枚版本徽章记录的是最后一次验证过的宿主版本。

• 设置刻意不放在宿主设置页。 可用的两个槽位都实测过（plugins.bundle.config 与

plugins.item）：在插桩替身里注册成功，真实界面什么都不渲染，且不报错。

所以面板画在弹窗里、读写走 HTTP 桥。

• 提示词就是官方那套。 自动命名与建议共用一条 LLM 调用路径，委托

@deepseek-ai/dsh-session-title-llm 的共享实现，因此提示词、超时、归一化行为与内置 provider

完全一致。只有长度上限是本插件额外加的。

• 建议不写日志。 不会往会话日志写 session/title-llm-request 事件：那是自动命名的一次性

审计记录，而建议可以无限次重新生成，照写会让日志膨胀。

• 4096 这个地板是实测校准值，不是理论值。 它是按同一个模型反复吃满预算的观测史抬上来的；

换到思考更啰嗦的模型要重测。另外「模型声明了关闭档」只代表它会收到那个档

…(truncated)