前言¶
DeepSeek Harness (DSH) 的側邊欄默認會話標題通常只是模型生成的一句話，難以一眼區分對話的歸屬日期和工作類型。dsh-session-title-pattern 插件通過模型對整段對話進行總結，將標題統一爲「日期｜類型｜主題」的格式。
核心功能¶
該插件由 cq-guojia 維護，基於 MIT 許可證開源。它主要實現以下功能：
- 自動生成格式化標題：默認將標題拆分爲日期、類型和主題三部分。日期取自會話創建時間（本地時區，MMDD 格式）；類型跟隨界面語言（中文 UI 顯示二字，英文 UI 顯示一詞）；主題爲對整段對話的總結。
- 支持自定義標題模板：支持使用
{MMDD}、{YYYY}、{type}、{topic}等佔位符自由組合格式，如{topic}｜{MMDD}。 - 定時重新計算：默認每 10 條消息自動觸發一次標題重新計算。
- 指定標題生成模型：可在設置中指定用於生成標題的模型，或選擇跟隨會話主模型。
- 手動重命名會話：支持通過點擊標題旁的按鈕或輸入
/retitle命令手動修改標題。 - 擴展標題顯示寬度：針對上游樣式限制，注入 CSS 覆蓋最大寬度，使當前會話標題顯示更寬。
安裝與啓用¶
通過官方插件命令安裝即可啓用，無需額外配置：
dsh plugin --profile web add dsh-session-title-pattern
安裝後，插件會隨 DSH 進程自動加載，首次會話會在第一條消息後自動生成標題。
配置¶
插件提供兩種配置方式：設置界面和配置文件。
設置界面¶
在 DSH 的插件詳情頁中，可以配置以下參數：
- Recompute every N messages：標題重新計算的間隔，默認爲 10。設爲 0 則僅在會話創建時計算一次。
- Model for title summaries：用於生成標題的模型，支持選擇特定 Provider 或跟隨主模型。
- Timeout：模型調用的超時時間（毫秒）。
- Title format / Title length limit：標題模板和長度限制。
配置文件¶
對於腳本化或批量部署，可通過 cordis.patch.yml 進行配置：
- id: session-title-pattern
config:
retitleEvery: 10
template: '{MMDD}｜{type}｜{topic}'
maxBytes: 80
工作機制與注意事項¶
- 僅處理頂級會話：插件不會對子會話（forked sessions）進行自動命名。
- 本地回退機制：首次標題生成失敗時，會使用本地回退標題（日期 + 首條消息前 8 個詞/字節）。若標題已存在，後續生成失敗將保留舊標題。
- 顯示寬度限制：上游樣式限制了標題寬度爲 220px，插件通過注入 CSS
[class*="_crumbCurrent"]{max-width:min(640px, 60vw) !important;}擴寬當前會話標題。若上游類名變更，此擴展可能失效。 - 依賴版本：要求 DSH 版本 >= 0.1.7-rc.1。
適用場景¶
適合需要長期維護大量會話、希望快速區分工作類型和時間節點的智能體開發者。插件能顯著提升側邊欄的信息密度和可讀性。
