前言¶
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 輔助生成的完整方案，幫助開發者維護整潔的會話列表。其核心價值在於在保持標題統一性的同時，通過智能判斷和本地資源減少不必要的模型調用。
