前言¶
在 DeepSeek Harness(DSH)裏開新會話時,標題往往來自「僅用戶首條提示」的默認命名邏輯:助手還沒回復,上下文不完整,生成出來的名稱容易泛化,事後在會話列表裏也不太好找。若你更在意「首輪 user + assistant 都落地之後」再定名,並希望在聊天界面裏隨手改標題,社區插件 dsh-turn-title(維護者 mdalboni)針對的就是這一組問題。下文按安裝、界面操作與實現要點說明,事實以 GitHub 倉庫 與 SkillHub 目錄頁 爲準。
這是什麼¶
dsh-turn-title 是 DSH 的客戶端側插件:在第一輪完整交換(用戶提示 + 助手回覆完成)之後自動生成會話標題,並在會話頭部的操作區增加 Update Title 按鈕,用於再次用模型生成標題或手動輸入。倉庫採用 MIT 許可,當前 package.json 中版本爲 1.0.0,要求 DSH >=0.2.1-rc.3,實現爲純 ESM、無額外運行時依賴。
核心功能¶
Turn-1 自動標題¶
插件會替代「只看首條用戶提示」的默認定名方式:監聽首輪結束事件,在助手第一條回覆完成後再調用模型生成標題,以便標題能反映完整上下文。
會話頭部按鈕¶
在 conversation.session.header.actions 插槽注入 ✎ Update Title(文案會隨 DSH 界面語言切換):
- 單擊:根據當前會話上下文重新生成標題。
- Shift + 單擊(或 Alt + 單擊):彈出對話框,手動輸入標題。
語言與主題¶
- UI 標籤與提示詞會與當前 DSH 界面語言對齊(README 列舉 English、Portuguese、Chinese 等)。
- 樣式使用 DSH 的
--dsw-alias-*CSS 變量,與明/暗主題一致。
安裝與啓用¶
插件隨 web profile 加載;安裝方式以 README 爲準,不要憑倉庫名自行拼接 github:owner/repo 類命令。
通過 DSH Plugin Market(dshmarket)¶
在插件市場裏搜索 dsh-turn-title,點擊 Install。
通過 DSH CLI¶
dsh plugin --profile web add dsh-turn-title
從本地源碼鏈接(需自行 clone 倉庫)¶
git clone https://github.com/mdalboni/dsh-turn-title.git
dsh plugin --profile web add link:./dsh-turn-title
安裝後插件在 DSH 進程內運行,權限與當前 DSH 實例一致;啓用前建議瀏覽源碼與 LICENSE,確認符合你的環境策略。SkillHub 上該條目星標爲 0,不影響功能描述,僅作生態可見度參考。
典型用法¶
- 安裝並啓用插件後,新建會話,完成第一輪問答;若會話尚未自定義標題,首輪
turn正常結束時應自動出現描述性標題。 - 在會話頂部找到 Update Title:
- 需要刷新 AI 標題時單擊;
- 需要固定文案時用 Shift/Alt 單擊,在對話框中填寫標題。 - 若你維護插件或改動了服務端邏輯,可用倉庫自帶測試:
node --test test/index.test.js
工作原理(便於對照源碼)¶
README 概括的三條路徑如下,便於排錯或對二次開發:
- Host 事件:監聽
session/event,在turn === 1且reason.kind === 'completed'時,若尚無自定義標題,經ctx.llm.stream生成標題,並用ctx.sessionTitle.rename更新。 - HTTP:在
ctx.webServer註冊POST /api/session-title/update,接收{ sessionId, title, locale },用於手動改名或觸發 AI 更新。 - 客戶端插槽:經
ctx.slots.inject向conversation.session.header.actions注入按鈕,文案由ctx.locale管理。
適用場景與注意¶
適合:長期在 DSH Web 界面裏堆積多會話、依賴標題做檢索的開發者;希望首輪就有較準確標題、又不想離開聊天頁去改名的場景。
注意:
- 分類爲客戶端插件,依賴
dsh的 web client 注入(package.json中client.platform爲web,並聲明注入@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-conversation)。 - 自動與手動改名均經過插件註冊的 API 與 DSH 會話能力,與核心 DSH 版本需滿足
peerDependencies中的>=0.2.1-rc.3。 - 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係,安裝來源以你信任的渠道爲準。
結尾¶
dsh-turn-title 把「定標題」的時機推到首輪助手回覆完成之後,並在會話頭提供一鍵再生成或手動覆蓋。需要安裝入口時可查 SkillHub 目錄,源碼與英文/葡語/中文 README 見 GitHub。