TyrantG/dsh-titlecraft

TitleCraft

中文

把 DSH 会话标题整理成短、准、统一的格式。默认标题为：

MMDD｜类型｜主题

快速开始

dsh plugin --profile web add dsh-titlecraft -w

安装或升级后重启 DSH Web，然后前往：

设置 → 插件 → 插件配置 → 标题工艺

TitleCraft 会接替 DSH 内置标题 provider。DSH 同时只能使用一个标题 provider。

主要功能

- 只修改会话标题，不改消息、工作区、排序、置顶或归档状态。
- 内置 7 种标题模板，也可使用 {date}、{type}、{topic}、{icon} 自定义格式。
- 标题类型可以新增、删除、启用或停用。
- 日期可取创建时间、最后真人消息、最后完成回合或最后持久活动。
- 内置 206 个本地语义图标，智能模式会根据主题从白名单中选择。
- 能直接判断出完整短主题时，不调用模型；拿不准就保留原标题。
- 可在首条真人消息后调用一次模型，也可在回合结束后进行语义精修。
- 保护人工标题；新回合、改配置、取消或卸载都会终止过期任务。

标题规则

| 占位符    | 内容                             |
| --------- | -------------------------------- |
| {date}  | 按所选来源和 IANA 时区生成的日期 |
| {type}  | 当前启用的内置或自定义类型       |
| {topic} | 完整、简短的会话主题             |
| {icon}  | 可选的本地图标                   |

{topic} 必须存在。未知占位符、残缺主题和超过 80 UTF-8 字节 的结果不会写入，也不会通过截取开头强行凑标题。主题中会去除项目名称；无法可靠判断时保留当前标题。

图标是标题文本的一部分，会影响搜索、复制、分叉和 80 字节上限。插件不下载远程图标或字体。

模型调用

未指定固定模型时，TitleCraft 会优先寻找名称看起来成本较低的模型，再使用当前会话模型。名称判断不代表真实价格。

- 首条消息模型生成默认关闭。开启后，每个实时会话最多尝试一次。
- 回合结束精修可在真人回合正常完成后更新标题。
- 失败时回退当前模型默认关闭；开启后最多额外尝试一次。

模型调用可能产生费用，但不会改变主会话使用的模型或思考强度。Provider 和 Model 直接从 DSH 查询，固定组合通过验证后才能保存。

原生重命名工作台

当前 DSH 界面支持时，原生“重命名”弹窗会显示两个额外操作：

1. AI 生成摘要：生成一段可编辑摘要，并建议类型和图标。
2. 从摘要生成标题：根据整段摘要压缩出完整短主题，只更新未保存的重命名草稿。

你可以在两步之间修改摘要、类型和图标。最终仍由原生“重命名”按钮提交；TitleCraft 不会绕过它直接保存标题。
如果当前 Workspace 不支持这些控件，设置页会显示提示；自动标题仍可正常工作。

English

Keep DSH session titles short, clear, and consistent. The default format is:

MMDD｜type｜topic

Quick start

dsh plugin --profile web add dsh-titlecraft -w

Restart DSH Web after installing or upgrading, then open:

Settings → Plugins → Plugin configuration → TitleCraft

TitleCraft replaces DSH's built-in title provider. DSH can use only one title provider at a time.

Features

- Changes session titles only. Messages, workspaces, ordering, pinning, and archive state stay untouched.
- Includes 7 presets and custom {date}, {type}, {topic}, and {icon} templates.
- Lets you add, remove, enable, or disable title types.
- Uses session creation, the last human message, the last completed turn, or the last durable activity as the date source.
- Includes 206 local semantic icons; smart mode selects one from an allowlist based on the topic.
- Avoids a model call when a complete short topic can be inferred. If the topic is unclear, the current title stays unchanged.
- Supports one model call after the first human message and semantic refinement after a completed turn.
- Protects manual titles and cancels stale work after new turns, configuration changes, cancellation, or unload.

Title rules
| Token     | 值                                                         |
| --------- | ---------------------------------------------------------- |
| {date}  | 来自所选来源及已配置 IANA 时区的日期                       |
| {type}  | 一个已启用的内置或自定义类型                               |
| {topic} | 一个完整、简洁的主题                                       |
| {icon}  | 一个可选的本地图标                                         |

{topic} 为必填项。未知的 token、不完整的主题以及超过 80 个 UTF-8 字节的标题都会被拒绝。TitleCraft 绝不会通过截取前缀来缩短标题，不会从主题中移除项目名称，并且在结果不确定时保留当前标题。

图标以标题文本的形式存储，因此它们会影响搜索、复制、复刻（fork）以及 80 字节的限制。不会加载任何远程图标或字体。

模型调用

在没有固定路由的情况下，TitleCraft 会首先寻找名称暗示成本较低的模型，然后使用当前会话模型。模型名称并不保证定价。

- 首条消息生成默认关闭，启用后每个实时会话最多运行一次。
- 回合结束优化可以在人类回合成功完成后更新标题。
- 回退到会话模型默认关闭，启用后最多增加一次重试。

模型调用可能会产生提供商费用。它们绝不会更改主会话模型或推理强度。提供商和模型选项直接来自 DSH，并且固定的组合必须经过验证才能保存。

原生重命名工作台

在当前 DSH 界面支持的情况下，原生重命名对话框会包含两个额外操作：

1. AI 生成摘要会创建一个可编辑的摘要，并建议一个类型和图标。
2. 从摘要生成标题会将完整摘要压缩为一个完整的简短主题，并且只更新未保存的重命名草稿。

你可以在两个步骤之间编辑摘要、类型和图标。原生重命名按钮仍然是保存标题的唯一方式。
如果当前工作区不支持这些控件，设置中会显示一条提示；自动标题仍会继续工作。