前言¶
DeepSeek Harness（DSH）遵循「一切皆插件」的理念，通过插件扩展其功能。会话标题管理往往是智能体开发中容易被忽视的环节，标题混乱会直接影响后续的检索、筛选和复盘。dsh-titlecraft 正是为了解决这一问题而生，它由用户 TyrantG 维护，旨在让 DSH 的会话标题更加短、准、统一。
它是什么¶
这是一款 DSH 会话标题插件。它接管 DSH 原本的标题生成逻辑，支持通过自定义模板、内置语义图标以及可选的 AI 生成与语义精修，来标准化会话标题的格式。
核心功能¶
- 只修改标题：插件仅修改会话标题文本，不会改变消息内容、工作区设置、排序、置顶或归档状态。
- 模板与占位符：内置 7 种标题模板，支持使用
{date}、{type}、{topic}、{icon}等占位符进行自定义格式化。 - 类型管理：支持对标题类型进行新增、删除、启用或停用操作。
- 日期来源：日期可配置，来源包括会话创建时间、最后真人消息、最后完成回合或最后持久活动。
- 语义图标：内置 206 个本地语义图标，智能模式会根据主题从白名单中选择合适的图标。
- 免模型调用优化：如果系统能直接判断出完整的短主题，则不调用模型；如果判断不准，则保留原标题。
- AI 生成与精修：支持在首条真人消息后调用一次模型生成标题，或在回合结束后进行语义精修。
- 保护人工标题：人工设置的标题受保护。任何新回合、配置修改、取消操作或卸载插件都会终止过期任务。
- 原生重命名支持：原生重命名工作台支持 AI 生成摘要和从摘要生成标题。
安装与启用¶
安装或升级后，需要重启 DSH Web。
dsh plugin --profile web add dsh-titlecraft -w
重启后，前往 设置 → 插件 → 插件配置 → 标题工艺 进行配置。安装后，TitleCraft 会接替 DSH 内置的标题 provider。需要注意的是，DSH 同时只能使用一个标题 provider。
典型用法¶
默认的标题格式通常为：
MMDD｜类型｜主题
使用占位符时，必须包含 {topic}。例如，你可以自定义模板为 {date}｜{type}｜{icon}{topic}。
标题规则与限制：
* 主题：主题中会去除项目名称；必须包含 {topic} 占位符。
* 长度：结果不能超过 80 UTF-8 字节。
* 容错：如果结果包含未知占位符、残缺主题或超过字节上限，不会写入；结果不确定时会保留当前标题。
* 图标：图标作为文本的一部分，会影响搜索、复制、分叉和字节上限。插件不下载远程图标或字体。
适用场景与注意¶
这款插件适合希望对大量会话进行统一管理的用户。
注意事项：
* 单 Provider 限制：DSH 同时只能使用一个标题 provider。
* 模型调用成本：开启 AI 生成或精修功能时，模型调用可能产生费用，但不会改变主会话使用的模型或思考强度。
* 固定模型验证：如果选择固定模型组合，必须通过验证后才能保存。
* 权限：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
dsh-titlecraft 提供了一套从模板定义到 AI 辅助生成的完整方案，帮助开发者维护整洁的会话列表。其核心价值在于在保持标题统一性的同时，通过智能判断和本地资源减少不必要的模型调用。
