dsh-auto-title
给 DeepSeek Harness 的会话自动起名：不再是把你第一句话截断几个字塞进任务栏，而是等第一条助手回复结束后，用「项目｜具体任务」的格式取一个真正能区分会话的标题。
（示意，非真实运行记录）
改前（内置行为，截断首条提问） → 改后（本插件生成）
帮我看看这个 pnpm 报错… → pnpm｜lockfile 供应链校验报错排查
再写一版 → 写作｜把笔记改成一页纸说明
那个 bug 修了吗 → debug｜会话标题事件没触发
为什么需要它
内置的 session-title-llm 行在首条人类消息上就定型标题，内容基本等于把提问截断，于是 20 个会话里有 15 个长得一样，列表没法扫读。本插件换成在首轮对话结束后命名：它能同时看到「你要什么」和「最后做成了什么」，从而给出可分类的名字。
手动重命名（会话行的「…」菜单）
自动命名只管首轮。想给任意一条已有会话重新起名时，点会话行右侧的「…」菜单，里面会多出一行 AI 重命名（排在原生「重命名」之后）：
- 点它 → 读取该会话的首条人类提问与最近一次带文本的助手回复，走一次辅助模型调用，弹出对话框并预填建议标题；
- 标题可编辑，回车或点「应用」提交，Esc / 「取消」放弃；
- 提交走的是原生用户重命名（
sessionTitle.rename，source.kind === 'user'），所以这个标题会被钉住，之后任何自动命名都不会覆盖它。
实现上分两半：客户端 bundle 注册菜单行与 shell.overlay 对话框，宿主注册两个同源 HTTP 路由（POST /dsh-auto-title/title 生成建议、POST /dsh-auto-title/apply 提交），因为菜单行拿不到宿主服务。会话未打开时会被自动 resume 后再改名。
失败会以本地化文案显示在对话框里：没有人类提问（422 empty-session）、会话从未跑过模型且没配 provider/model（409 no-route）、模型没给出可用标题（502 model-empty）。
标题怎么来的
- 会话提交人类消息后（默认只在第一条），标题服务调用本插件；节奏由
automatic决定。 - 插件先等这轮对话的助手回复（带文本的
assistant/message，或turn/end的完成/超长原因；失败或超时则以空字符串继续），最多等waitForReplyMs。 - 把「人类请求 + 助手回复」一起交给一次辅助模型调用（不占用会话正文的上下文预算，也不会打断当前生成）。
- 结果做规范化：去掉引号/空白、折叠换行、去句末标点、按
maxTitleLength截断。 - 以
{ title, messageSeqs: [触发消息 seq], model }交回标题服务；服务负责持久化并把新标题推给界面。
任一步失败（模型报错、超时、输出为空）都会抛出带 code 的错误，标题服务保持上一个标题不变——不会把会话改成空名字。
安装
dsh plugin add https://github.com/sumingwang233/dsh-auto-title
或在桌面端 设置 → 插件市场 → 添加插件，把同一个地址填进去。装完重启 DSH 桌面端（或重连该 profile）使新 bundle 生效。
本地开发时也可以直接从工作副本装：dsh plugin add <本目录绝对路径>。
> 本插件与内置的 session-title-llm 争用同一个槽位，所以它的 cordis.patch.yml 会先禁用内置行再插入自己——安装时你不需要改任何基础 bundle。
它会关掉内置的标题 provider
ctx.sessionTitle 只接受一个 provider（第二个注册会抛错）。内置的 session-title-llm 行在基础 bundle 里，所以本包的 cordis.patch.yml 先把它禁用，再插入自己：
- id: session-title-llm
disabled: true
- insert:
- id: auto-title
name: 'dsh-auto-title'
因此：
- 停用本插件 = 内置标题行为自动恢复，不需要改基础 bundle；
- 若你的 profile 里还有别的会话标题插件，两者会争抢同一个槽位，本插件会安静地不注册（日志 warn），不导致启动失败。
在桌面端使用
重启桌面端后，插件在两个地方出现：
1. 设置侧栏 →「dsh-auto-title」（设置页）
它是设置导航里的一级条目（和「内置插件」「邮件」并列），不在「插件」页里——桌面端这一版没有「插件」页。页面里可以改 enabled、provider、model、language、maxTitleLength、waitForReplyMs、timeoutMs，改完点保存立即生效（下一次命名就用新配置）。页面下方是最近事件日志：每次自动命名、每次手动 AI 重命名、每个失败原因都会记一行，可刷新、清空、一键复制——排查问题或提 issue 时直接贴这段。
日志同时镜像到 <插件目录>/log.jsonl（与 settings.json 同目录），即使设置页打不开也能用 cat 看到；也可以直接请求 GET /dsh-auto-title/log?limit=100。
2. 会话列表每一行的「…」菜单 →「AI 重命名」
点开后会先跑一次辅助模型，把「首条提问 + 最近几条对话」压成候选标题，在弹窗里给你改，确认后才写入。失败时弹窗直接显示原因（没有可用路由、没有人类提问、模型返回空、超时、HTTP 错误码）。
日志里常见的失败原因：
| 日志 | 含义 |
|---|---|
this session has not called a model yet |
会话还没有模型路由，去卡片里填 provider / model |
HTTP 500 + WebRoute |
客户端与主机版本不匹配（本仓库已修；旧 bundle 会这样） |
模型在输出上限（N tokens）内没有写出标题 |
推理占满了预算：加大 maxOutputTokens，或换一个非推理模型 |
no provider / provider disabled |
卡片里关掉了自动命名，或 provider/model 只填了一个 |
配置
运行时配置（推荐，设置卡片写的就是它）：<插件目录>/settings.json（本机即 ~/.dsh/profiles/desktop/node_modules/dsh-auto-title/settings.json；可用环境变量 DSH_AUTO_TITLE_SETTINGS 改到别处）。优先级最高，保存后下一次命名立即生效，无需重启。卡片上的「恢复默认」会把它清空，回到下面的加载期配置。
加载期配置（可选，用于在 profile 里固化默认值）：在 profile 目录的 cordis.patch.yml 里（apply 在最后、能覆盖 bundle 层）追加覆盖行：
- id: auto-title
config:
language: zh
maxTitleLength: 20
waitForReplyMs: 90000
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
false = 只加载不注册（等价于停用，但保留包） |
automatic |
'first-prompt' |
命名节奏：first-prompt = 只在首轮；all-prompts = 每条新消息都重命名（每条多一次小请求） |
provider / model |
'' |
留空 = 用会话自己的路由；填了就必须两个一起填 |
language |
'auto' |
auto / zh / en，决定提示词要求的标题语言 |
maxTitleLength |
24 |
标题最大字符数（含中英文，按字符计） |
maxInputChars |
6000 |
请求 + 回复拼进提示词时的总字符上限，超出按比例截断 |
maxOutputTokens |
512 |
辅助调用输出上限。推理模型会先把预算花在推理上，给小了会「有推理、没标题」，所以留了余量（上限 8192） |
waitForReplyMs |
120000 |
等首条助手回复的预算；到点就用「只有请求」命名 |
timeoutMs |
30000 |
辅助模型调用自身的超时 |
stopWords |
[] |
标题里要去掉的词（大小写不敏感） |
配错类型会在加载时抛 TypeError（例如 maxTitleLength: "24"），行会以错误状态出现而不是静默忽略。取值范围：maxTitleLength 1–80，maxInputChars 1–20000，maxOutputTokens 1–8192，两个毫秒字段 1–600000。
验证
git clone https://github.com/sumingwang233/dsh-auto-title && cd dsh-auto-title
npm test # 49 个用例：core 规则 + host 装配/事件等待/流解析/命名节奏 + 手动改名路由 + 设置存储与配置/日志路由 + 客户端 bundle
真机验证（需要重启后）：
- 设置侧栏出现「dsh-auto-title」，页面能打开，
provider/model能保存； - 会话列表某行「…」→「AI 重命名」，弹窗出现候选标题，应用后列表标题变化；
- 若弹窗报错，同一张卡片下方日志里能看到这次请求的失败原因与细节。
已知边界
- 默认只在首轮命名一次：
automatic: 'first-prompt'下后续大改需求不会自动改名（可手动重命名）。想让它跟着对话演进改名，设automatic: 'all-prompts'——代价是每条新消息多一次小请求。 - 多一次模型调用：每条命中的消息多一次小请求（约几百 token 输入、≤512 token 输出）。不想付这个成本就把
enabled: false或用便宜模型（provider/model）。 - 回复超过
waitForReplyMs才出现时，会退化成「只看请求」命名——仍然是完整主题词，不是原始截断。 - 标题服务对同一个会话可能有并发/重试调用，本插件是纯函数式的（不做去重、不写存储），重复调用只会产生更新的标题。
卸载
桌面端 设置 → 插件市场 → 找到 dsh-auto-title → 卸载，或用 plugin_manager 工具 action: "remove_bundle"、target: "dsh-auto-title"。
从 dsh.profile.bundles 移除后，被禁用的 session-title-llm 重新生效，行为回到原生。
许可
MIT
